From 61573170f33ab4a55cc4e5bcccd520a640e965bb Mon Sep 17 00:00:00 2001 From: "nekomimi.pet" Date: Mon, 19 Oct 2026 20:25:17 -0400 Subject: [PATCH] web: an about pane beside the wordmark A (?) beside the wordmark opens a pane with a short description (a placeholder for now), the main contributors with their Bluesky handles, thanks to everyone else with a link to the full history on tangled, and the libraries the client is built on with their licences. THIRD_PARTY_NOTICES.md gains a section for the web client's bundled libraries, including Pierre's Apache-2.0 diffs. --- THIRD_PARTY_NOTICES.md | 8 ++ robot-docs/web.md | 2 + web/src/App.svelte | 16 ++++ web/src/lib/About.svelte | 156 +++++++++++++++++++++++++++++++++++++++ 4 files changed, 182 insertions(+) create mode 100644 web/src/lib/About.svelte diff --git a/THIRD_PARTY_NOTICES.md b/THIRD_PARTY_NOTICES.md index 09f109f3..b81d6ae9 100644 --- a/THIRD_PARTY_NOTICES.md +++ b/THIRD_PARTY_NOTICES.md @@ -98,3 +98,11 @@ https://bsky.app/profile/personhood.removal.surgery), colours measured from Pilot's iroshizuku inks. madoromi is distributed under the Mozilla Public License 2.0 (https://mozilla.org/MPL/2.0/); the values are used unmodified and the settings pane credits it with a link. + +## web client libraries + +The browser client in `web/` bundles these libraries, each under its own +licence, which ships in its package: Svelte and Svelte Flow (xyflow), MIT; +Diffs from The Pierre Computer Company (`@pierre/diffs`, https://diffs.com), +Apache License 2.0; Shiki, MIT; KaTeX, MIT; Pele (https://pele.run, by +Obsidian), MIT; marked, MIT. The client's about pane lists them with links. diff --git a/robot-docs/web.md b/robot-docs/web.md index d0a7b790..6089b815 100644 --- a/robot-docs/web.md +++ b/robot-docs/web.md @@ -26,6 +26,8 @@ Markdown (`markdown.ts`) also understands maths and diagrams: `$…$`, `\(…\)` **Notes** (`nodes/NoteNode.svelte`, `anchors.ts`, `notes.ts`, `Tethers.svelte`) are small text boxes on the canvas, saved with the board. Double-click empty canvas or press N for a loose one; the composer's pop-out button moves the draft into a note tied to its chat, for writing at length. Dragging a note's grip onto something ties the note to it: a window, a message or step in a chat (`data-entry`), or a line in a diff (found by the diff's `data-diff` key and the row's number inside Pierre's shadow root); dropping it on empty canvas sets it loose. While the grip is dragged, what it would land on is outlined (`pick` in `anchors.ts`). The target and a quote of it (the diff lines, or the message's first 600 characters) are kept on the note, so what it was about survives scrolling and closing. A dashed line runs from each tied note to its target, measured in screen space every frame while any note is tied, held inside the window and whatever scrolls it. Notes float above windows (`zIndex`). A tied note sends on its own (⌘↵), from its chat's "send N notes" button, or with its review; notes for one session go as one message, each quoting what it was tied to (a note tied to a chat window itself is just a message). Sent notes stay on the board, quieter, until dismissed. +The (?) beside the wordmark opens an about pane (`About.svelte`): a one-line description (a placeholder for now), the main contributors with their Bluesky handles, thanks to everyone else with a link to the full history on tangled, and the libraries the client is built on with their licences, linking `THIRD_PARTY_NOTICES.md`. + Settings (the sliders button at the top right, or ⌘,) is a non-modal pane over the board: the theme (follow the system, the default; light; dark), each mode's colours, and the canvas dots. A mode's colours are three seeds and a contrast, as in the Codex app: accent, background (the ground), foreground (the ink) as hex, with a native picker beside each, and contrast from 0 to 100; accent presets fill the accent for the mode being edited, and a theme copies and pastes as JSON (both modes, or one palette for the mode being edited). `app.css` derives every other token from the seeds with `color-mix` in OKLab (surfaces, chrome, fields, secondary text, hover, dots, shadow tint) and relative `oklch()` (the brand's second stop, and "you" opposite the accent), so any three colours make a whole theme; contrast scales how far each step goes. The colours are [madoromi](https://madoromi.moonwit.ch/)'s (MPL-2.0, credited in the pane and in `THIRD_PARTY_NOTICES.md`): the defaults are its spring, haru, by day (`#f6eff8` paper, `#584a5c` ink, `#6928bd` wisteria) and by night (`#241c26`, `#e1d1e7`, `#ddb3ff`); its four seasons set both modes at once, keeping each mode's contrast, and the accent presets are its spring inks. Preferences live in this browser (`prefs.svelte.ts`, `albedo.prefs.v4`, carrying the theme and dots over from earlier keys). The resolved mode is `data-theme` on `` and its seeds are inline custom properties there; a small script in `index.html` applies both before the first paint, and `prefs` follows system changes while the theme is `system`. The chat view (`chat/`) reads `GET /sessions/{id}/history` (newest page, then `before=` as the reader scrolls up, and `after=` when the stream says something committed) and sends with `PUT /sessions/{id}/inputs/{uuidv7}` `{kind: "message", text}`; images attach by paste, drop or the composer's picture button (`chat/attachments.ts`, the terminal client's scheme: each image leaves an `[Image #n]` marker at the cursor, deleting the marker drops the image, sending renumbers the marked images 1..n in reading order and sends them base64 as `images`, at most 10); a user entry's images show above its bubble from their history references (`/api/sessions/{id}/history/{entry}/image-n`). a send stays on screen as pending until its `input_id` appears in history, and a failed one offers retry with the same id. `transcript.svelte.ts` turns entries into blocks: user bubbles, assistant markdown, and each run of thinking and tool calls between messages folded into one "Worked" line (open while it is the live run). Referenced message text is fetched with the page; tool arguments and output only when their run is opened. Markdown is rendered by `marked` with raw HTML escaped and only http(s)/mailto links (`markdown.ts`), because transcripts carry model and tool text into a page that can reach the daemon. The session list (`sessions.svelte.ts`) follows the collection's stream (`GET /sessions?scope=roots` as server-sent events, `followSessions` in `stream.ts`): each `activity` event patches that session's status and activity in place, so the sidebar, window titles and faces change as the daemon does, and `reset`, `overflow` or `invalidate` reads the list again (once for a burst). While that stream is up the list is also read once a minute in case; while it is down, every 4 s. Both stop while the tab is hidden. diff --git a/web/src/App.svelte b/web/src/App.svelte index e819eded..5d2a75ba 100644 --- a/web/src/App.svelte +++ b/web/src/App.svelte @@ -6,6 +6,7 @@ import Palette, { type Item } from './lib/Palette.svelte'; import { prefs } from './lib/prefs.svelte'; import { busy } from './lib/live.svelte'; + import About from './lib/About.svelte'; import Rail from './lib/Rail.svelte'; import Settings from './lib/Settings.svelte'; import { sessions } from './lib/sessions.svelte'; @@ -17,6 +18,7 @@ let minimap = $state(localStorage.getItem(MINIMAP_KEY) === 'on'); let paletteOpen = $state(false); let settingsOpen = $state(false); + let aboutOpen = $state(false); let search = $state(); $effect(() => localStorage.setItem(RAIL_KEY, railOpen ? 'open' : 'closed')); @@ -46,6 +48,7 @@ { label: 'close board tab', run: () => boards.active && boards.close(boards.active) }, { label: 'delete board', run: () => boards.active && boards.delete(boards.active) }, { label: 'new note', hint: 'N', run: () => boards.board?.noteAt() }, + { label: 'about albedo', run: () => (aboutOpen = true) }, { label: 'fit all windows', hint: '⇧1', run: () => boards.board?.fit() }, { label: 'zoom to 100%', hint: '⇧0', run: () => boards.board?.zoomTo(1) }, { label: 'next window', hint: '⌥→', run: () => boards.board?.step(1) }, @@ -140,6 +143,9 @@ albedo + {#if sessions.link !== 'online'} @@ -186,6 +192,10 @@ (settingsOpen = false)} /> {/if} +{#if aboutOpen} + (aboutOpen = false)} /> +{/if} + {#if paletteOpen} (paletteOpen = false)} /> {/if} @@ -244,6 +254,12 @@ height: 30px; padding: 0; } + .about { + width: 24px; + height: 24px; + margin-left: -4px; + color: var(--faint); + } .end { display: flex; align-items: center; diff --git a/web/src/lib/About.svelte b/web/src/lib/About.svelte new file mode 100644 index 00000000..dcd0476d --- /dev/null +++ b/web/src/lib/About.svelte @@ -0,0 +1,156 @@ + + + + + -- knotmirror 0.0.1