@bitbaum/chatkit 0.9.0 → 0.11.0

package/dist/rich.js

@@ -0,0 +1,100 @@
+const record = (v) => !!v && typeof v === "object" && !Array.isArray(v);
+const str = (v, max = 2000) => typeof v === "string" && !!v.trim() && v.length <= max;
+const list = (v, max) => Array.isArray(v) && v.length > 0 && v.length <= max;
+/** Web images or same-origin assets only; no embedded markup or protocol-relative URLs. */
+export function safeImageSrc(value) {
+    if (!str(value, 4096) || /[\s\\]/.test(value) || [...value].some((c) => c.charCodeAt(0) < 32))
+        return null;
+    if (/^\/(?!\/)/.test(value))
+        return value;
+    try {
+        const url = new URL(value);
+        return ["https:", "http:"].includes(url.protocol) && !url.username && !url.password
+            ? value
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Invalid or oversized blocks are rejected without crashing the answer. */
+export function parseRichBlock(raw) {
+    if (raw.length > 40000)
+        return null;
+    let b;
+    try {
+        b = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (!record(b) || !str(b.title, 200))
+        return null;
+    switch (b.type) {
+        case "callout":
+            return str(b.body) ? { type: b.type, title: b.title, body: b.body } : null;
+        case "gallery":
+            if (!list(b.images, 6) ||
+                !b.images.every((i) => record(i) &&
+                    safeImageSrc(i.src) &&
+                    str(i.alt, 300) &&
+                    (i.caption === undefined || str(i.caption, 500))))
+                return null;
+            return b;
+        case "diagram": {
+            if (!list(b.nodes, 8) ||
+                !b.nodes.every((n) => record(n) &&
+                    str(n.id, 50) &&
+                    str(n.label, 120) &&
+                    (n.detail === undefined || str(n.detail, 300))))
+                return null;
+            const ids = new Set(b.nodes.map((n) => n.id));
+            if (ids.size !== b.nodes.length ||
+                !Array.isArray(b.edges) ||
+                b.edges.length > 16 ||
+                !b.edges.every((e) => record(e) &&
+                    ids.has(e.from) &&
+                    ids.has(e.to) &&
+                    (e.label === undefined || str(e.label, 100))))
+                return null;
+            return b;
+        }
+        case "choices":
+            if (!str(b.submit, 80) ||
+                !list(b.options, 6) ||
+                !b.options.every((o) => record(o) && str(o.label, 200) && str(o.reply, 500)))
+                return null;
+            return b;
+        default:
+            return null;
+    }
+}
+export const RICH_ANSWERS_INSTRUCTION = [
+    "## Visual answers",
+    "Lead with the answer. Use headings, short paragraphs, markdown tables for comparisons, and numbered steps when they help. Keep simple answers simple.",
+    "When useful, insert a fenced chat_ui block containing ONE JSON object at the point it belongs. These are the supported shapes:",
+    '{"type":"gallery","title":"Reference photos","images":[{"src":"/provided-image.jpg","alt":"Describe the image","caption":"What to notice"}]}',
+    '{"type":"diagram","title":"How it connects","nodes":[{"id":"a","label":"Input","detail":"Optional explanation"},{"id":"b","label":"Result"}],"edges":[{"from":"a","to":"b","label":"leads to"}]}',
+    '{"type":"callout","title":"Recommendation","body":"The useful takeaway."}',
+    '{"type":"choices","title":"What would you like next?","options":[{"label":"Explain the first option","reply":"Explain the first option"},{"label":"Compare the alternatives","reply":"Compare the alternatives"}],"submit":"Continue"}',
+    "Use at most 6 images, 8 diagram nodes, 16 edges, or 6 choices per block. Translate titles, labels and submit into the reader's language. A choice sends its reply as a normal message; it never performs an action directly. Never invent image URLs, numbers, sources, tool results or product capabilities. Use only image URLs provided by the person, context or tools; otherwise use a diagram or plain text. Always explain the takeaway in prose too. No HTML, scripts, raw SVG, or decorative images. Preserve domain-specific evidence and authority rules. Put suggested replies last, outside chat_ui blocks.",
+].join("\n");
+/** Copy, share and voice keep the content of a visual, never its wire JSON. */
+export function richAnswerText(text) {
+    return text.replace(/```chat_ui\s*([\s\S]*?)(?:```|$)/g, (_, raw) => {
+        const b = parseRichBlock(raw);
+        if (!b)
+            return "";
+        switch (b.type) {
+            case "callout":
+                return `${b.title}\n${b.body}`;
+            case "gallery":
+                return `${b.title}\n${b.images.map((i) => `${i.alt}${i.caption ? ` — ${i.caption}` : ""}\n${i.src}`).join("\n")}`;
+            case "choices":
+                return `${b.title}\n${b.options.map((o) => `- ${o.label}`).join("\n")}`;
+            case "diagram":
+                return `${b.title}\n${b.nodes.map((n) => `${n.label}${n.detail ? `: ${n.detail}` : ""}`).join("\n")}\n${b.edges.map((e) => `${b.nodes.find((n) => n.id === e.from).label} → ${b.nodes.find((n) => n.id === e.to).label}${e.label ? ` (${e.label})` : ""}`).join("\n")}`;
+        }
+    });
+}
+//# sourceMappingURL=rich.js.map

package/dist/rich.js.map

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

package/dist/speech.d.ts

@@ -0,0 +1,17 @@
+export declare function plainTextForSpeech(markdown: string): string;
+/**
+ * Which voice language to ask for. The fleet's operators write mixed German
+ * and English; a German sentence is detectable cheaply enough by its most
+ * common function words to pick the voice, and the page's language otherwise.
+ */
+export declare function guessSpeechLang(text: string, fallback?: string): string;
+/** Who reads the words. The browser's own voice by default (`useSpeech`); an
+ *  app with a studio voice hands in its own with the same two methods. */
+export type Speaker = {
+    /** Resolves when the text has been read, or cut off. Never rejects. */
+    speak(text: string): Promise<void>;
+    cancel(): void;
+};
+/** The browser's own voice: free, offline, no key. `null` where there is none. */
+export declare function createSynthSpeaker(): Speaker | null;
+//# sourceMappingURL=speech.d.ts.map

package/dist/speech.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"speech.d.ts","sourceRoot":"","sources":["../src/speech.ts"],"names":[],"mappings":"AAWA,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA8B3D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAO,GAAG,MAAM,CAWrE;AAED;0EAC0E;AAC1E,MAAM,MAAM,OAAO,GAAG;IACpB,uEAAuE;IACvE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,IAAI,IAAI,CAAC;CAChB,CAAC;AAEF,kFAAkF;AAClF,wBAAgB,kBAAkB,IAAI,OAAO,GAAG,IAAI,CAuBnD"}

package/dist/speech.js

@@ -0,0 +1,82 @@
+/**
+ * An answer as it should be READ ALOUD.
+ *
+ * Markdown read literally is noise — "hash hash Summary, asterisk asterisk",
+ * a citation "F eight" after every claim — so the text is flattened first.
+ * From loki's `speech-text`, where the play button under every answer first
+ * lived. Pure, so it is tested without a voice.
+ */
+import { richAnswerText } from "./rich.js";
+import { extractReplies } from "./replies.js";
+export function plainTextForSpeech(markdown) {
+    // Suggested replies are buttons, never words: a quick_replies block is
+    // dropped outright rather than announced as "(code)".
+    const prose = richAnswerText(extractReplies(markdown).text);
+    return (prose
+        // Fenced code is not prose; say that it is there rather than reading it.
+        .replace(/```[\s\S]*?```/g, " (code) ")
+        .replace(/`([^`]*)`/g, "$1")
+        // Citations like [F8] or [D1] are for the eye.
+        .replace(/\[(?:[A-Z]{1,2}\d{1,3}(?:,\s*[A-Z]{1,2}\d{1,3})*)\]/g, "")
+        // Links and images: keep the words, drop the URL.
+        .replace(/!\[[^\]]*\]\([^)]*\)/g, "")
+        .replace(/\[([^\]]+)\]\([^)]*\)/g, "$1")
+        .replace(/https?:\/\/\S+/g, "")
+        // Headings, emphasis, quotes, bullets, tasks, rules, tables.
+        .replace(/^\s{0,3}#{1,6}\s+/gm, "")
+        .replace(/^\s*>\s?/gm, "")
+        .replace(/^\s*[-*+]\s+(?:\[[ xX]\]\s+)?/gm, "")
+        .replace(/^\s*\d+[.)]\s+/gm, "")
+        .replace(/^\s*[-*_]{3,}\s*$/gm, "")
+        .replace(/^\s*\|?\s*:?-{2,}:?\s*(\|\s*:?-{2,}:?\s*)*\|?\s*$/gm, "")
+        .replace(/\|/g, " ")
+        .replace(/(\*\*|__)(.*?)\1/g, "$2")
+        .replace(/(\*|_)(.*?)\1/g, "$2")
+        .replace(/~~(.*?)~~/g, "$1")
+        .replace(/[ \t]+/g, " ")
+        .replace(/\s*\n\s*\n\s*/g, "\n")
+        .trim());
+}
+/**
+ * Which voice language to ask for. The fleet's operators write mixed German
+ * and English; a German sentence is detectable cheaply enough by its most
+ * common function words to pick the voice, and the page's language otherwise.
+ */
+export function guessSpeechLang(text, fallback = "en") {
+    const sample = text.toLowerCase().slice(0, 600);
+    const german = (sample.match(/\b(und|nicht|das|ist|ich|mit|für|auf|eine?|der|die|sind|wird|noch|auch)\b/g) ?? []).length;
+    const english = (sample.match(/\b(and|not|the|is|with|for|on|a|an|are|will|also|this|that)\b/g) ?? []).length;
+    if (german > english && german >= 3)
+        return "de";
+    if (english >= 3)
+        return "en";
+    return fallback;
+}
+/** The browser's own voice: free, offline, no key. `null` where there is none. */
+export function createSynthSpeaker() {
+    if (typeof window === "undefined" || !("speechSynthesis" in window))
+        return null;
+    let current = null;
+    return {
+        speak(text) {
+            return new Promise((resolve) => {
+                window.speechSynthesis.cancel();
+                const u = new SpeechSynthesisUtterance(text);
+                u.lang = guessSpeechLang(text, document.documentElement.lang || "en");
+                u.onend = () => {
+                    if (current === u)
+                        current = null;
+                    resolve();
+                };
+                u.onerror = u.onend;
+                current = u;
+                window.speechSynthesis.speak(u);
+            });
+        },
+        cancel() {
+            window.speechSynthesis.cancel();
+            current = null;
+        },
+    };
+}
+//# sourceMappingURL=speech.js.map

package/dist/speech.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speech.js","sourceRoot":"","sources":["../src/speech.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,uEAAuE;IACvE,sDAAsD;IACtD,MAAM,KAAK,GAAG,cAAc,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5D,OAAO,CACL,KAAK;QACH,yEAAyE;SACxE,OAAO,CAAC,iBAAiB,EAAE,UAAU,CAAC;SACtC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC;QAC5B,+CAA+C;SAC9C,OAAO,CAAC,sDAAsD,EAAE,EAAE,CAAC;QACpE,kDAAkD;SACjD,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC;SACpC,OAAO,CAAC,wBAAwB,EAAE,IAAI,CAAC;SACvC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC;QAC/B,6DAA6D;SAC5D,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC;SAClC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;SACzB,OAAO,CAAC,iCAAiC,EAAE,EAAE,CAAC;SAC9C,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;SAC/B,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC;SAClC,OAAO,CAAC,qDAAqD,EAAE,EAAE,CAAC;SAClE,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,mBAAmB,EAAE,IAAI,CAAC;SAClC,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC;SAC/B,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC;SAC3B,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC;SAC/B,IAAI,EAAE,CACV,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,QAAQ,GAAG,IAAI;IAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,CACb,MAAM,CAAC,KAAK,CAAC,4EAA4E,CAAC,IAAI,EAAE,CACjG,CAAC,MAAM,CAAC;IACT,MAAM,OAAO,GAAG,CACd,MAAM,CAAC,KAAK,CAAC,gEAAgE,CAAC,IAAI,EAAE,CACrF,CAAC,MAAM,CAAC;IACT,IAAI,MAAM,GAAG,OAAO,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACjD,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO,QAAQ,CAAC;AAClB,CAAC;AAUD,kFAAkF;AAClF,MAAM,UAAU,kBAAkB;IAChC,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,CAAC,CAAC,iBAAiB,IAAI,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACjF,IAAI,OAAO,GAAoC,IAAI,CAAC;IACpD,OAAO;QACL,KAAK,CAAC,IAAI;YACR,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBACnC,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC;gBAChC,MAAM,CAAC,GAAG,IAAI,wBAAwB,CAAC,IAAI,CAAC,CAAC;gBAC7C,CAAC,CAAC,IAAI,GAAG,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,eAAe,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;gBACtE,CAAC,CAAC,KAAK,GAAG,GAAG,EAAE;oBACb,IAAI,OAAO,KAAK,CAAC;wBAAE,OAAO,GAAG,IAAI,CAAC;oBAClC,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC;gBACF,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC;gBACpB,OAAO,GAAG,CAAC,CAAC;gBACZ,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAClC,CAAC,CAAC,CAAC;QACL,CAAC;QACD,MAAM;YACJ,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC;YAChC,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitbaum/chatkit",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "One chat for every product: a composer with a microphone that always works, a thread that does not fight the reader, messages with copy and retry, and LLM markdown \u2014 the fleet's chat standard as a package.",
   "license": "MIT",
   "author": "Cato",

package/styles.css

@@ -122,6 +122,15 @@
 }
 .ck-input::placeholder {
   color: var(--ck-muted);
+  /* One line, always: an empty box is one row high on every phone, and a
+     long placeholder is cut at the edge rather than wrapped into a second
+     line that the box then clips in half (320px, 2026-10-21). */
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.ck-input:placeholder-shown {
+  overflow: hidden;
 }
 .ck-actions {
   display: flex;
@@ -1057,6 +1066,13 @@ a.ck-source:hover {
 .ck-reply:hover {
   border-color: var(--ck-accent);
 }
+/* The first reply is the recommended next step: the same pill, drawn as the
+   lead — a firmer line and the reading colour — so the eye lands on it. */
+.ck-reply-lead {
+  border-color: var(--ck-line-2);
+  background: var(--ck-raised);
+  font-weight: 500;
+}
 .ck-reply:disabled {
   opacity: 0.5;
   cursor: default;
@@ -1194,6 +1210,110 @@ a.ck-source:hover {
   cursor: not-allowed;
   opacity: 0.45;
 }
+/* An app's own rows under Camera · Photos · Files in the attach sheet. */
+.ck-sheet-extra {
+  display: flex;
+  flex-direction: column;
+  gap: 0.125rem;
+  margin-top: 0.75rem;
+  padding-top: 0.75rem;
+  border-top: 1px solid var(--ck-line);
+}
+
+/* while an answer is read aloud: Stop, a quiet wave, the time so far */
+.ck-player {
+  align-items: center;
+}
+.ck-action-stop {
+  color: var(--ck-fg);
+}
+.ck-player-wave {
+  display: inline-flex;
+  align-items: center;
+  gap: 2px;
+  height: 1rem;
+}
+.ck-player-wave > span {
+  display: block;
+  width: 2px;
+  height: 0.375rem;
+  border-radius: 1px;
+  background: var(--ck-fg-2);
+  animation: ck-wave 1s ease-in-out infinite;
+}
+.ck-player-wave > span:nth-child(2n) {
+  animation-delay: 0.15s;
+}
+.ck-player-wave > span:nth-child(3n) {
+  animation-delay: 0.3s;
+}
+@keyframes ck-wave {
+  50% {
+    height: 1rem;
+  }
+}
+.ck-player-time {
+  font-size: 0.8125rem;
+  font-variant-numeric: tabular-nums;
+  color: var(--ck-fg-2);
+}
+@media (prefers-reduced-motion: reduce) {
+  .ck-player-wave > span {
+    animation: none;
+    height: 0.75rem;
+  }
+}
+
+/* the sources sheet on a touch screen: one row per record */
+.ck-sources-open {
+  cursor: pointer;
+  font: inherit;
+}
+.ck-sources-open > svg {
+  font-size: 1rem;
+}
+.ck-source-list {
+  display: flex;
+  flex-direction: column;
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+.ck-source-row {
+  display: flex;
+  align-items: flex-start;
+  gap: 0.75rem;
+  min-height: var(--ck-target);
+  padding: 0.625rem 0.25rem;
+  border-top: 1px solid var(--ck-line);
+  color: var(--ck-fg);
+  text-decoration: none;
+}
+.ck-source-list > li:first-child .ck-source-row {
+  border-top: 0;
+}
+.ck-source-row .ck-source-id {
+  margin-top: 0.125rem;
+}
+.ck-source-body {
+  display: flex;
+  min-width: 0;
+  flex-direction: column;
+  gap: 0.125rem;
+}
+.ck-source-title {
+  font-weight: 500;
+  overflow-wrap: anywhere;
+}
+.ck-source-detail {
+  font-size: 0.8125rem;
+  color: var(--ck-fg-2);
+  overflow-wrap: anywhere;
+}
+a.ck-source-row:hover .ck-source-title {
+  text-decoration: underline;
+}
+
 @keyframes ck-rise {
   from {
     transform: translateY(1.5rem);
@@ -1205,3 +1325,196 @@ a.ck-source:hover {
     animation: none;
   }
 }
+
+/* Visual answers share the app's palette, with a quiet editorial hierarchy. */
+.ck-rich {
+  box-sizing: border-box;
+  min-width: 0;
+  margin: 1.5rem 0;
+  color: var(--ck-fg);
+  overflow-wrap: anywhere;
+}
+.ck-rich * {
+  box-sizing: border-box;
+  min-width: 0;
+}
+.ck-rich-title {
+  display: block;
+  font-size: 1.05em;
+  font-weight: 650;
+  line-height: 1.4;
+  margin-bottom: 1rem;
+}
+.ck-gallery-grid {
+  display: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 0.75rem;
+}
+.ck-gallery-grid figure {
+  margin: 0;
+}
+.ck-photo {
+  display: flex;
+  flex-direction: column;
+  width: 100%;
+  min-height: var(--ck-target);
+  padding: 0;
+  overflow: hidden;
+  border: 1px solid var(--ck-line);
+  border-radius: var(--ck-radius);
+  background: var(--ck-raised);
+  color: var(--ck-fg);
+  cursor: zoom-in;
+  font: inherit;
+  text-align: start;
+}
+.ck-photo img {
+  display: block;
+  width: 100%;
+  aspect-ratio: 1;
+  object-fit: cover;
+}
+.ck-photo-label {
+  padding: 0.5rem 0.75rem;
+  font-size: 0.875em;
+}
+.ck-gallery-grid figcaption {
+  padding: 0.5rem 0;
+  font-size: 0.875em;
+  color: var(--ck-fg-2);
+}
+.ck-photo-full {
+  display: block;
+  max-width: 100%;
+  max-height: 70dvh;
+  object-fit: contain;
+  margin: auto;
+}
+.ck-callout {
+  padding: 1.25rem;
+  border-inline-start: 3px solid var(--ck-fg);
+  background: var(--ck-raised);
+  border-radius: 0 var(--ck-radius-sm) var(--ck-radius-sm) 0;
+}
+.ck-callout .ck-rich-title {
+  margin-bottom: 0.5rem;
+}
+.ck-rich p {
+  margin: 0.25rem 0 0;
+}
+.ck-diagram {
+  padding: 1.25rem;
+  border: 1px solid var(--ck-line);
+  border-radius: var(--ck-radius);
+  background: var(--ck-raised);
+}
+.ck-md .ck-diagram-nodes {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(min(100%, 11rem), 1fr));
+  gap: 0.75rem;
+  padding: 0;
+  list-style: none;
+  margin: 0;
+}
+.ck-diagram-nodes li {
+  display: flex;
+  align-items: start;
+  gap: 0.75rem;
+  padding: 1rem;
+  background: var(--ck-bg);
+  border: 1px solid var(--ck-line);
+  border-radius: var(--ck-radius-sm);
+}
+.ck-diagram-number {
+  display: grid;
+  place-items: center;
+  flex: 0 0 1.75rem;
+  height: 1.75rem;
+  border-radius: 50%;
+  background: var(--ck-fg);
+  color: var(--ck-bg);
+  font-size: 0.875em;
+}
+.ck-diagram-nodes p {
+  font-size: 0.875em;
+  color: var(--ck-fg-2);
+}
+.ck-md .ck-diagram-edges {
+  padding: 0.75rem 0 0;
+  margin: 0;
+  list-style: none;
+}
+.ck-diagram-edges li {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  flex-wrap: wrap;
+  border-top: 1px solid var(--ck-line);
+  padding: 0.75rem 0;
+}
+.ck-diagram-arrow {
+  color: var(--ck-fg-3);
+}
+.ck-diagram-edges small {
+  flex-basis: 100%;
+  color: var(--ck-fg-2);
+}
+.ck-choice fieldset {
+  border: 0;
+  margin: 0;
+  padding: 0;
+}
+.ck-choice legend {
+  padding: 0;
+}
+.ck-choice-option {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  min-height: var(--ck-target);
+  padding: 0.75rem;
+  border: 1px solid var(--ck-line);
+  border-radius: var(--ck-radius-sm);
+  margin-bottom: 0.5rem;
+  cursor: pointer;
+}
+.ck-choice-option:has(:checked) {
+  border-color: var(--ck-fg);
+  background: var(--ck-raised);
+}
+.ck-choice-option input {
+  flex: 0 0 auto;
+  width: 1.25rem;
+  height: 1.25rem;
+  accent-color: var(--ck-fg);
+}
+.ck-choice-submit {
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  gap: 1rem;
+  width: 100%;
+  min-height: var(--ck-target);
+  border: 0;
+  border-radius: var(--ck-radius);
+  background: var(--ck-fg);
+  color: var(--ck-bg);
+  padding: 0.75rem 1rem;
+  font: inherit;
+  font-weight: 600;
+  cursor: pointer;
+}
+.ck-choice-submit:disabled {
+  opacity: 0.45;
+  cursor: default;
+}
+.ck-rich button:focus-visible,
+.ck-rich input:focus-visible {
+  outline: 2px solid var(--ck-fg);
+  outline-offset: 3px;
+}
+@media (max-width: 480px) {
+  .ck-gallery-grid {
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+  }
+}