@boldare/askdare 0.0.0-stage → 0.1.0-rc.1

package/dist/version.js

@@ -0,0 +1,641 @@
+import { z } from "zod";
+// src/i18n/texts.ts
+/**
+* Every text the widget shows. The keys are public API (ADR-0008): override any of them with
+* `widget.texts`. Plural keys end in a CLDR category (`zero`, `one`, `two`, `few`, `many`, `other`).
+*/
+const EN = {
+	"header.title": "Assistant",
+	"header.newConversation": "Start a new conversation",
+	"header.close": "Close chat",
+	"confirm.newConversation": "Start a new conversation? The current one will be deleted.",
+	"confirm.cancel": "Cancel",
+	"confirm.accept": "Start new",
+	"welcome.label": "Welcome",
+	"welcome.greeting": "Hi! How can I help?",
+	"welcome.online": "Online",
+	"welcome.suggestions": "Suggested questions",
+	"composer.placeholder": "Type your message…",
+	"composer.send": "Send",
+	"composer.attach": "Attach files",
+	"composer.dictate": "Dictate a message",
+	"status.loading": "Loading the conversation…",
+	"status.thinking": "Thinking…",
+	"status.searching": "Searching documents…",
+	"status.tool": "Using {name}…",
+	"status.typing": "The assistant is typing",
+	"message.sources": "Sources",
+	"message.attachments.one": "{count} attachment",
+	"message.attachments.other": "{count} attachments",
+	"attachment.list": "Attachments",
+	"attachment.uploading": "Uploading…",
+	"attachment.remove": "Remove {name}",
+	"attachment.unsupported": "This file type is not supported.",
+	"attachment.tooLarge": "Too large (max {size}).",
+	"attachment.tooMany": "You can attach up to {count} files per message.",
+	"dictation.listening": "Listening…",
+	"dictation.transcribing": "Transcribing…",
+	"dictation.cancel": "Cancel dictation",
+	"dictation.done": "Done",
+	"dictation.empty": "Nothing was recorded. Please try again.",
+	"microphone.blocked": "Microphone access is blocked. Allow it in your browser to dictate.",
+	"microphone.missing": "No microphone was found.",
+	"microphone.failed": "The microphone could not be started.",
+	"disclosure.text": "You’re chatting with an AI assistant. It can make mistakes.",
+	"disclosure.privacy": "Privacy policy",
+	"launcher.label": "Ask us",
+	"launcher.open": "Open chat",
+	"launcher.close": "Close chat",
+	"launcher.unavailable": "The chat couldn’t load. Please try again later.",
+	"error.connection": "Connection problem. Please try again.",
+	"error.history": "Could not load the previous conversation.",
+	"error.updated": "The assistant was updated. Please reload the page.",
+	"error.stalled": "The connection stalled. Please try again.",
+	"error.uploadFailed": "The file could not be uploaded.",
+	"error.transcriptionFailed": "The recording could not be transcribed.",
+	"error.invalid_input": "The request was invalid.",
+	"error.unauthorized": "Authentication is required.",
+	"error.session_expired": "Your session has expired. Please try again.",
+	"error.not_found": "Not found.",
+	"error.content_blocked": "This message cannot be processed.",
+	"error.rate_limited": "Too many messages. Please wait a moment.",
+	"error.budget_exceeded": "The assistant is unavailable for the rest of the day.",
+	"error.internal_error": "Something went wrong. Please try again.",
+	"error.upstream_error": "The assistant is temporarily unavailable. Please try again.",
+	"error.bot_unavailable": "The assistant is currently unavailable.",
+	"error.timeout": "The assistant took too long to respond. Please try again.",
+	"error.conversationTooLong": "This conversation is too long. Please start a new one.",
+	"error.conversationGone": "This conversation is no longer available.",
+	"error.messageLength": "Messages can be up to {max} characters.",
+	"error.attachmentExpired": "An attachment expired or is invalid. Please attach it again.",
+	"error.filesNotAccepted": "This assistant does not accept files.",
+	"error.tooManyFiles": "Attach up to {count} files per message.",
+	"error.fileType.images": "Only images (PNG, JPEG, WebP, GIF) are supported.",
+	"error.fileType.pdf": "Only PDF files are supported.",
+	"error.fileType.both": "Only images (PNG, JPEG, WebP, GIF) and PDF files are supported.",
+	"error.fileTooLarge": "Files can be up to {size}.",
+	"error.pdfPages": "PDFs can have up to {max} pages.",
+	"error.voiceNotAccepted": "This assistant does not accept voice input.",
+	"error.recordingFormat": "This recording format is not supported.",
+	"error.recordingTooLong": "This recording is too long.",
+	"error.dictationBusy": "Another dictation is still being transcribed. Please try again in a moment.",
+	"error.dictationBudget": "Dictation is unavailable for the rest of the day. You can still type."
+};
+/** Plural texts: the base plus a CLDR category, every category overridable. */
+const PLURAL_BASES = ["message.attachments"];
+const PLURAL_FORMS = [
+	"zero",
+	"one",
+	"two",
+	"few",
+	"many",
+	"other"
+];
+const PL = {
+	"header.title": "Asystent",
+	"header.newConversation": "Zacznij nową rozmowę",
+	"header.close": "Zamknij czat",
+	"confirm.newConversation": "Zacząć nową rozmowę? Obecna zostanie usunięta.",
+	"confirm.cancel": "Anuluj",
+	"confirm.accept": "Zacznij nową",
+	"welcome.label": "Powitanie",
+	"welcome.greeting": "Cześć! W czym mogę pomóc?",
+	"welcome.online": "Online",
+	"welcome.suggestions": "Proponowane pytania",
+	"composer.placeholder": "Napisz wiadomość…",
+	"composer.send": "Wyślij",
+	"composer.attach": "Dołącz pliki",
+	"composer.dictate": "Podyktuj wiadomość",
+	"status.loading": "Wczytuję rozmowę…",
+	"status.thinking": "Myślę…",
+	"status.searching": "Przeszukuję dokumenty…",
+	"status.tool": "Korzystam z narzędzia {name}…",
+	"status.typing": "Asystent pisze",
+	"message.sources": "Źródła",
+	"message.attachments.one": "{count} załącznik",
+	"message.attachments.few": "{count} załączniki",
+	"message.attachments.many": "{count} załączników",
+	"message.attachments.other": "{count} załącznika",
+	"attachment.list": "Załączniki",
+	"attachment.uploading": "Wysyłam…",
+	"attachment.remove": "Usuń {name}",
+	"attachment.unsupported": "Ten typ pliku nie jest obsługiwany.",
+	"attachment.tooLarge": "Za duży (maks. {size}).",
+	"attachment.tooMany": "Limit plików w jednej wiadomości: {count}.",
+	"dictation.listening": "Słucham…",
+	"dictation.transcribing": "Przepisuję…",
+	"dictation.cancel": "Anuluj dyktowanie",
+	"dictation.done": "Gotowe",
+	"dictation.empty": "Nic się nie nagrało. Spróbuj ponownie.",
+	"microphone.blocked": "Dostęp do mikrofonu jest zablokowany. Zezwól na niego w przeglądarce.",
+	"microphone.missing": "Nie znaleziono mikrofonu.",
+	"microphone.failed": "Nie udało się włączyć mikrofonu.",
+	"disclosure.text": "Rozmawiasz z asystentem AI. Może popełniać błędy.",
+	"disclosure.privacy": "Polityka prywatności",
+	"launcher.label": "Zapytaj nas",
+	"launcher.open": "Otwórz czat",
+	"launcher.close": "Zamknij czat",
+	"launcher.unavailable": "Nie udało się załadować czatu. Spróbuj ponownie później.",
+	"error.connection": "Problem z połączeniem. Spróbuj ponownie.",
+	"error.history": "Nie udało się wczytać poprzedniej rozmowy.",
+	"error.updated": "Asystent został zaktualizowany. Odśwież stronę.",
+	"error.stalled": "Połączenie zostało przerwane. Spróbuj ponownie.",
+	"error.uploadFailed": "Nie udało się wysłać pliku.",
+	"error.transcriptionFailed": "Nie udało się przepisać nagrania.",
+	"error.invalid_input": "Nieprawidłowe żądanie.",
+	"error.unauthorized": "Wymagane jest uwierzytelnienie.",
+	"error.session_expired": "Sesja wygasła. Spróbuj ponownie.",
+	"error.not_found": "Nie znaleziono.",
+	"error.content_blocked": "Nie możemy przetworzyć tej wiadomości.",
+	"error.rate_limited": "Zbyt wiele wiadomości. Poczekaj chwilę.",
+	"error.budget_exceeded": "Asystent jest niedostępny do końca dnia.",
+	"error.internal_error": "Coś poszło nie tak. Spróbuj ponownie.",
+	"error.upstream_error": "Asystent jest chwilowo niedostępny. Spróbuj ponownie.",
+	"error.bot_unavailable": "Asystent jest obecnie niedostępny.",
+	"error.timeout": "Odpowiedź trwała zbyt długo. Spróbuj ponownie.",
+	"error.conversationTooLong": "Ta rozmowa jest zbyt długa. Zacznij nową.",
+	"error.conversationGone": "Ta rozmowa nie jest już dostępna.",
+	"error.messageLength": "Wiadomość może mieć maksymalnie {max} znaków.",
+	"error.attachmentExpired": "Załącznik wygasł lub jest nieprawidłowy. Dołącz go ponownie.",
+	"error.filesNotAccepted": "Ten asystent nie przyjmuje plików.",
+	"error.tooManyFiles": "Limit plików w jednej wiadomości: {count}.",
+	"error.fileType.images": "Obsługujemy tylko obrazy (PNG, JPEG, WebP, GIF).",
+	"error.fileType.pdf": "Obsługujemy tylko pliki PDF.",
+	"error.fileType.both": "Obsługujemy tylko obrazy (PNG, JPEG, WebP, GIF) i pliki PDF.",
+	"error.fileTooLarge": "Plik może mieć maksymalnie {size}.",
+	"error.pdfPages": "PDF może mieć maksymalnie {max} stron.",
+	"error.voiceNotAccepted": "Ten asystent nie przyjmuje nagrań głosowych.",
+	"error.recordingFormat": "Ten format nagrania nie jest obsługiwany.",
+	"error.recordingTooLong": "To nagranie jest zbyt długie.",
+	"error.dictationBusy": "Poprzednie nagranie jest jeszcze przepisywane. Spróbuj za chwilę.",
+	"error.dictationBudget": "Dyktowanie jest niedostępne do końca dnia. Wiadomość możesz nadal wpisać."
+};
+/** The canonical form of a BCP 47 tag that Intl accepts (plural rules need it), else undefined. */
+function canonicalLocale(tag) {
+	if (tag.length > 35) return void 0;
+	try {
+		return Intl.getCanonicalLocales(tag)[0];
+	} catch {
+		return;
+	}
+}
+/** Languages with a built-in dictionary; any other locale shows English texts. */
+const TEXT_LOCALES = ["en", "pl"];
+const DICTIONARIES = {
+	en: EN,
+	pl: {
+		...EN,
+		...PL
+	}
+};
+/** The dictionary language for a BCP 47 tag: its primary subtag when built in, else English. */
+function textLocale(locale) {
+	const primary = locale.toLowerCase().split("-")[0];
+	return TEXT_LOCALES.includes(primary) ? primary : "en";
+}
+/** Every key `widget.texts` accepts. */
+const TEXT_KEYS = [.../* @__PURE__ */ new Set([...Object.keys(EN), ...PLURAL_BASES.flatMap((base) => PLURAL_FORMS.map((form) => `${base}.${form}`))])];
+/**
+* The full dictionary for a locale with overrides applied. Plural forms beyond `one`/`other`
+* (Polish `few`, `many`) are kept too, so the widget can pick them.
+*/
+function textsFor(locale, overrides = {}) {
+	return {
+		...DICTIONARIES[textLocale(locale)],
+		...overrides
+	};
+}
+// src/theme/presets.ts
+const PRESET_NAMES = [
+	"halo",
+	"aura",
+	"sage",
+	"care"
+];
+const SYSTEM = "system-ui, -apple-system, \"Segoe UI\", Roboto, sans-serif";
+const GEIST = `"Geist Variable", ${SYSTEM}`;
+/**
+* The four built-in looks. Inspirations set the mood only; the designs are original (ADR-0008).
+* Every pair a reader sees is checked for contrast in `contrast.test.ts`.
+*/
+const PRESETS = {
+	/** Clean and friendly: white into ice blue, a frosted orb in rings of light, a bold question. */
+	halo: {
+		light: {
+			accent: "#1f5fe0",
+			onAccent: "#ffffff",
+			background: "#ffffff",
+			surface: "#eef4fd",
+			text: "#0d1526",
+			muted: "#4f5b72",
+			border: "#0d15261a",
+			danger: "#b42318",
+			success: "#067647",
+			userBubble: "#dce9fc",
+			onUserBubble: "#0d1526",
+			backdrop: "radial-gradient(120% 55% at 50% -10%, #d3e4ff 0%, #ffffff00 65%), linear-gradient(180deg, #f3f8ff 0%, #ffffff 55%, #eef5ff 100%)",
+			orb: "radial-gradient(circle at 36% 28%, #ffffff 0%, #eef5ff 14%, #b4d0ff 44%, #5b8ff2 76%, #2a5fd6 100%)",
+			fontFamily: GEIST,
+			headingFamily: GEIST,
+			fontSize: "15px",
+			radius: "18px"
+		},
+		dark: {
+			accent: "#82adff",
+			onAccent: "#06122b",
+			background: "#0a0f1c",
+			surface: "#151d30",
+			text: "#e9eef8",
+			muted: "#a0acc3",
+			border: "#ffffff1c",
+			danger: "#ff9c8f",
+			success: "#5fdc8f",
+			userBubble: "#1d3566",
+			onUserBubble: "#e9eef8",
+			backdrop: "radial-gradient(120% 55% at 50% -10%, #1a2b55 0%, #0a0f1c00 65%), linear-gradient(180deg, #0d1528 0%, #0a0f1c 60%)",
+			orb: "radial-gradient(circle at 36% 28%, #ffffff 0%, #d6e5ff 14%, #86aefc 44%, #3466de 76%, #173c9c 100%)",
+			fontFamily: GEIST,
+			headingFamily: GEIST,
+			fontSize: "15px",
+			radius: "18px"
+		},
+		variants: {
+			avatar: "orb",
+			welcome: "hero",
+			launcher: "orb",
+			bubbles: "filled",
+			surface: "glass",
+			density: "comfortable",
+			composer: "outline"
+		}
+	},
+	/**
+	* Soft glass for AI products: an airy pastel field, a glossy bubble with its reflection, a
+	* two-weight headline. Colors from Boldare's palette: coral, violet and teal.
+	*/
+	aura: {
+		light: {
+			accent: "#6b52e0",
+			onAccent: "#ffffff",
+			background: "#fdfbfd",
+			surface: "#f5f0f7",
+			text: "#242424",
+			muted: "#5f5a68",
+			border: "#2424241a",
+			danger: "#b42318",
+			success: "#067647",
+			userBubble: "#c2386f",
+			onUserBubble: "#ffffff",
+			backdrop: "radial-gradient(60% 45% at 6% 0%, #ffdbe7 0%, #ffdbe700 70%), radial-gradient(55% 40% at 100% 6%, #e4ddff 0%, #e4ddff00 70%), radial-gradient(70% 45% at 60% 106%, #d2f3ec 0%, #d2f3ec00 70%), linear-gradient(#fdfbfd, #fdfbfd)",
+			orb: "radial-gradient(circle at 33% 24%, #ffffff 0%, #ffffffd9 6%, #ffffff00 19%), radial-gradient(circle at 70% 84%, #9df3e6 0%, #9df3e600 44%), radial-gradient(circle at 50% 28%, #ffa3c6 0%, #f28bbb 24%, #b8a1f6 60%, #7dd8d0 100%)",
+			fontFamily: `"Plus Jakarta Sans Variable", ${SYSTEM}`,
+			headingFamily: `"Plus Jakarta Sans Variable", ${SYSTEM}`,
+			fontSize: "15px",
+			radius: "22px"
+		},
+		dark: {
+			accent: "#b9a8ff",
+			onAccent: "#1b1530",
+			background: "#17141c",
+			surface: "#242029",
+			text: "#f4f1f8",
+			muted: "#b8b0c4",
+			border: "#ffffff1c",
+			danger: "#ff9c8f",
+			success: "#5fdc8f",
+			userBubble: "#a52f63",
+			onUserBubble: "#ffffff",
+			backdrop: "radial-gradient(60% 45% at 6% 0%, #4a1f36 0%, #4a1f3600 70%), radial-gradient(55% 40% at 100% 6%, #2c2457 0%, #2c245700 70%), radial-gradient(70% 45% at 60% 106%, #133b37 0%, #133b3700 70%), linear-gradient(#17141c, #17141c)",
+			orb: "radial-gradient(circle at 33% 24%, #ffffff 0%, #ffffffc4 6%, #ffffff00 19%), radial-gradient(circle at 70% 84%, #6fe3d2 0%, #6fe3d200 44%), radial-gradient(circle at 50% 28%, #ff8fb9 0%, #e173aa 24%, #9a83ec 60%, #4fc1b7 100%)",
+			fontFamily: `"Plus Jakarta Sans Variable", ${SYSTEM}`,
+			headingFamily: `"Plus Jakarta Sans Variable", ${SYSTEM}`,
+			fontSize: "15px",
+			radius: "22px"
+		},
+		variants: {
+			avatar: "orb",
+			welcome: "hero",
+			launcher: "orb",
+			bubbles: "filled",
+			surface: "glass",
+			density: "comfortable",
+			composer: "gradient"
+		}
+	},
+	/** A calm companion: sage and mint, light type, a persona card, black pill buttons. */
+	sage: {
+		light: {
+			accent: "#111311",
+			onAccent: "#f5f6f2",
+			background: "#f2f3ef",
+			surface: "#dde8d3",
+			text: "#1a201c",
+			muted: "#535b55",
+			border: "#1a201c17",
+			danger: "#a8261b",
+			success: "#2f6b3a",
+			userBubble: "#ffffff",
+			onUserBubble: "#1a201c",
+			backdrop: "radial-gradient(80% 50% at 85% 0%, #e0ebd6 0%, #e0ebd600 70%), linear-gradient(180deg, #eef0ea 0%, #f2f3ef 50%)",
+			orb: "radial-gradient(circle at 34% 28%, #ffffff 0%, #e6eedf 26%, #a9c29b 62%, #6d8c62 100%)",
+			fontFamily: GEIST,
+			headingFamily: GEIST,
+			fontSize: "15px",
+			radius: "20px"
+		},
+		dark: {
+			accent: "#eef0ea",
+			onAccent: "#121512",
+			background: "#131613",
+			surface: "#26321f",
+			text: "#eceee8",
+			muted: "#a9b3ab",
+			border: "#ffffff1c",
+			danger: "#ff9c8f",
+			success: "#8fd19b",
+			userBubble: "#2a2f2a",
+			onUserBubble: "#eceee8",
+			backdrop: "radial-gradient(80% 50% at 85% 0%, #1f2a1b 0%, #1f2a1b00 70%), linear-gradient(180deg, #171b16 0%, #131613 50%)",
+			orb: "radial-gradient(circle at 34% 28%, #f2f5ee 0%, #c3d3b8 28%, #7c9a70 64%, #3b5137 100%)",
+			fontFamily: GEIST,
+			headingFamily: GEIST,
+			fontSize: "15px",
+			radius: "20px"
+		},
+		variants: {
+			avatar: "orb",
+			welcome: "persona",
+			launcher: "pill",
+			bubbles: "filled",
+			surface: "solid",
+			density: "comfortable",
+			composer: "outline"
+		}
+	},
+	/** Trust first: indigo and lavender, a capability checklist, hyperlegible type, AAA text. */
+	care: {
+		light: {
+			accent: "#3730a3",
+			onAccent: "#ffffff",
+			background: "#ffffff",
+			surface: "#f0eeff",
+			text: "#111827",
+			muted: "#3d4455",
+			border: "#11182726",
+			danger: "#97170e",
+			success: "#05603a",
+			userBubble: "#3730a3",
+			onUserBubble: "#ffffff",
+			backdrop: "none",
+			orb: "radial-gradient(circle at 34% 28%, #ffffff 0%, #d9d4ff 30%, #7b72e8 66%, #3730a3 100%)",
+			fontFamily: `"Atkinson Hyperlegible Next Variable", ${SYSTEM}`,
+			headingFamily: `"Atkinson Hyperlegible Next Variable", ${SYSTEM}`,
+			fontSize: "16px",
+			radius: "14px"
+		},
+		dark: {
+			accent: "#c9d0ff",
+			onAccent: "#0e1020",
+			background: "#0e1020",
+			surface: "#1c1f3a",
+			text: "#f5f6fb",
+			muted: "#ccd0e4",
+			border: "#ffffff26",
+			danger: "#ffc2b8",
+			success: "#86efbd",
+			userBubble: "#3730a3",
+			onUserBubble: "#ffffff",
+			backdrop: "none",
+			orb: "radial-gradient(circle at 34% 28%, #ffffff 0%, #cfc9ff 30%, #7b72e8 66%, #3730a3 100%)",
+			fontFamily: `"Atkinson Hyperlegible Next Variable", ${SYSTEM}`,
+			headingFamily: `"Atkinson Hyperlegible Next Variable", ${SYSTEM}`,
+			fontSize: "16px",
+			radius: "14px"
+		},
+		variants: {
+			avatar: "icon",
+			welcome: "intro",
+			launcher: "pill",
+			bubbles: "filled",
+			surface: "solid",
+			density: "comfortable",
+			composer: "outline"
+		}
+	}
+};
+// src/theme/contrast.ts
+const HEX = /^#([0-9a-f]{6})([0-9a-f]{2})?$/i;
+function channels(hex) {
+	const match = HEX.exec(hex);
+	if (!match?.[1]) throw new TypeError(`Not a hex color: ${hex}`);
+	const value = Number.parseInt(match[1], 16);
+	return [
+		value >> 16 & 255,
+		value >> 8 & 255,
+		value & 255
+	];
+}
+function luminance(hex) {
+	const [red, green, blue] = channels(hex).map((channel) => {
+		const c = channel / 255;
+		return c <= .03928 ? c / 12.92 : ((c + .055) / 1.055) ** 2.4;
+	});
+	return .2126 * red + .7152 * green + .0722 * blue;
+}
+/** WCAG 2.x contrast ratio between two opaque hex colors, from 1 to 21. */
+function contrastRatio(foreground, background) {
+	const [light, dark] = [luminance(foreground), luminance(background)].sort((a, b) => b - a);
+	return (light + .05) / (dark + .05);
+}
+/** Black or white, whichever reads better on the given color. */
+function readableOn(background) {
+	return contrastRatio("#ffffff", background) >= contrastRatio("#0b0b0b", background) ? "#ffffff" : "#0b0b0b";
+}
+/** Every pairing a visitor reads in the widget. */
+const CONTRAST_PAIRS = [
+	{
+		name: "text on panel",
+		foreground: "text",
+		background: "background",
+		kind: "text"
+	},
+	{
+		name: "text in bubbles",
+		foreground: "text",
+		background: "surface",
+		kind: "text"
+	},
+	{
+		name: "secondary text on panel",
+		foreground: "muted",
+		background: "background",
+		kind: "text"
+	},
+	{
+		name: "secondary text in cards",
+		foreground: "muted",
+		background: "surface",
+		kind: "text"
+	},
+	{
+		name: "button labels",
+		foreground: "onAccent",
+		background: "accent",
+		kind: "text"
+	},
+	{
+		name: "own messages",
+		foreground: "onUserBubble",
+		background: "userBubble",
+		kind: "text"
+	},
+	{
+		name: "links in bubbles",
+		foreground: "accent",
+		background: "surface",
+		kind: "text"
+	},
+	{
+		name: "links on panel",
+		foreground: "accent",
+		background: "background",
+		kind: "text"
+	},
+	{
+		name: "errors",
+		foreground: "danger",
+		background: "background",
+		kind: "text"
+	},
+	{
+		name: "checks",
+		foreground: "success",
+		background: "surface",
+		kind: "graphic"
+	}
+];
+/** Pairs below WCAG AA, or AAA for text when `level` is 'AAA'. */
+function contrastFailures(tokens, level = "AA") {
+	return CONTRAST_PAIRS.flatMap((pair) => {
+		const required = pair.kind === "graphic" ? 3 : level === "AAA" ? 7 : 4.5;
+		const ratio = contrastRatio(tokens[pair.foreground], tokens[pair.background]);
+		return ratio >= required ? [] : [{
+			name: pair.name,
+			ratio: Math.round(ratio * 100) / 100,
+			required
+		}];
+	});
+}
+// src/theme/theme.ts
+const color = z.string().regex(/^#[0-9a-fA-F]{6}$/, "must be a hex color like #1f5fe0");
+/**
+* Plain CSS values only: they are written into a stylesheet, and the orb into host pages. No
+* quotes, so no image-set("https://…") or src("…") can make a browser fetch from another origin.
+*/
+const cssValue = z.string().max(600).refine((value) => !/[;{}<>\\"'`]|url\s*\(|@import|expression\s*\(/i.test(value), "must be a plain CSS value (no url(), quotes, braces or semicolons)");
+const tokensSchema = z.object({
+	accent: color,
+	onAccent: color,
+	background: color,
+	surface: color,
+	text: color,
+	muted: color,
+	border: z.string().regex(/^#[0-9a-fA-F]{6}([0-9a-fA-F]{2})?$/, "must be a hex color, alpha allowed"),
+	danger: color,
+	success: color,
+	userBubble: color,
+	onUserBubble: color,
+	backdrop: cssValue,
+	orb: cssValue,
+	fontFamily: z.string().max(200).regex(/^[\w\s"',.-]+$/, "must be a font-family list"),
+	headingFamily: z.string().max(200).regex(/^[\w\s"',.-]+$/, "must be a font-family list"),
+	fontSize: z.string().regex(/^(1[3-9]|20)px$/, "must be 13px to 20px"),
+	radius: z.string().regex(/^([0-9]|[12][0-9]|3[0-2])px$/, "must be 0px to 32px")
+}).partial().strict();
+const variantsSchema = z.object({
+	avatar: z.enum([
+		"orb",
+		"icon",
+		"initials",
+		"none"
+	]),
+	welcome: z.enum([
+		"hero",
+		"persona",
+		"intro"
+	]),
+	launcher: z.enum([
+		"orb",
+		"circle",
+		"pill"
+	]),
+	bubbles: z.enum(["filled", "plain"]),
+	surface: z.enum(["solid", "glass"]),
+	density: z.enum(["comfortable", "compact"]),
+	composer: z.enum(["outline", "gradient"])
+}).partial().strict();
+const themeDefinitionSchema = z.object({
+	extends: z.enum(PRESET_NAMES).optional(),
+	accent: color.optional(),
+	tokens: tokensSchema.optional(),
+	dark: tokensSchema.optional(),
+	variants: variantsSchema.optional()
+}).strict();
+/** Validates a theme once, so several bots can share it. Throws on invalid values. */
+function defineTheme(definition) {
+	const parsed = themeDefinitionSchema.safeParse(definition);
+	if (!parsed.success) {
+		const issues = parsed.error.issues.map((issue) => `${issue.path.join(".") || "(root)"} ${issue.message}`).join("; ");
+		throw new TypeError(`[askdare] Invalid theme: ${issues}`);
+	}
+	return Object.freeze(parsed.data);
+}
+function withAccent(tokens, accent) {
+	if (!accent) return tokens;
+	const on = readableOn(accent);
+	return {
+		...tokens,
+		accent,
+		onAccent: on,
+		userBubble: accent,
+		onUserBubble: on
+	};
+}
+/** Preset plus overrides, for both schemes. */
+function resolveTheme(theme, colorScheme) {
+	const definition = typeof theme === "string" ? { extends: theme } : theme ?? {};
+	const name = definition.extends ?? "aura";
+	const preset = PRESETS[name];
+	const light = {
+		...withAccent(preset.light, definition.accent),
+		...definition.tokens
+	};
+	const dark = {
+		...withAccent(preset.dark, definition.dark?.accent ?? definition.accent),
+		...definition.tokens,
+		...definition.dark
+	};
+	return Object.freeze({
+		preset: name,
+		colorScheme,
+		light: Object.freeze(light),
+		dark: Object.freeze(dark),
+		variants: Object.freeze({
+			...preset.variants,
+			...definition.variants
+		})
+	});
+}
+/** Readable-contrast problems of a customized theme, for a development warning. */
+function themeWarnings(theme) {
+	return (theme.colorScheme === "auto" ? ["light", "dark"] : [theme.colorScheme]).flatMap((scheme) => contrastFailures(theme[scheme]).map((failure) => `${scheme}: ${failure.name} has contrast ${failure.ratio}:1, needs ${failure.required}:1`));
+}
+// src/protocol/version.ts
+/**
+* Version of the SSE wire protocol between the askdare server and its clients.
+* Bumped on any breaking change to event names or payloads (ADR-0006).
+*/
+const PROTOCOL_VERSION = 1;
+/** Response header carrying {@link PROTOCOL_VERSION} on every streaming response. */
+const PROTOCOL_HEADER = "x-askdare-protocol";
+export { themeDefinitionSchema as a, TEXT_KEYS as c, textLocale as d, textsFor as f, resolveTheme as i, TEXT_LOCALES as l, PROTOCOL_VERSION as n, themeWarnings as o, defineTheme as r, PRESET_NAMES as s, PROTOCOL_HEADER as t, canonicalLocale as u };

package/docs/attachments.md

@@ -0,0 +1,41 @@
+# Attachments
+
+Visitors can attach images and PDFs to their messages. The model sees images and reads PDFs (their text and page images).
+
+## Turn it on
+
+```ts
+defineBot({
+  // …
+  attachments: {}, // images and PDFs, up to 4 MB, 3 per message
+});
+```
+
+| Option | Default | Meaning |
+| --- | --- | --- |
+| `images` | `true` | PNG, JPEG, WebP and GIF |
+| `pdf` | `true` | PDF documents |
+| `maxBytes` | `4_000_000` | Largest file. 4 MB fits Vercel's 4.5 MB request body limit; raise it only on hosts without one |
+| `maxPerMessage` | `3` | Files per message (up to 10) |
+| `maxPdfPages` | `50` | Longest PDF accepted |
+
+Uploads are limited per visitor and per IP per hour (`limits.uploadsPerVisitorPerHour`, default 20; `limits.uploadsPerIpPerHour`, default 60) and per bot per day (`limits.uploadsPerDay`, default 500). Files that are uploaded but never sent cost no tokens, but they take up storage in your OpenAI project until they expire.
+
+## What the widget does
+
+- A paperclip button opens the file picker. Files can also be pasted or dropped onto the chat.
+- Images are downsized to 2048 px on the long edge and re-encoded as JPEG in the browser. That keeps uploads small, drops EXIF data such as the GPS position, and converts HEIC photos where the browser can decode them.
+- Each file is uploaded as soon as it is chosen; the message is sent once every upload has finished.
+
+## What the server does
+
+- Detects the type from the file's bytes, never from its name or Content-Type. SVG, animated GIFs and anything else are refused.
+- Uploads the file to OpenAI with purpose `user_data`. Files expire after 30 days, and are deleted earlier when the visitor deletes the conversation.
+- Returns an encrypted handle instead of the OpenAI file ID. Handles are bound to the bot and the visitor and expire after 1 hour.
+- Reserves tokens for the files before the turn: about 1,500 per image and 2,000 per PDF page. Pages are counted from the file itself, including compressed object streams; a PDF whose pages can't be counted is charged as if it had `maxPdfPages` pages. When the bot has tools, the reservation covers every model call the turn may make, because each call reads the files again.
+
+After a page reload the conversation shows how many files a message had, not the files themselves: OpenAI does not let you download `user_data` files.
+
+## Privacy
+
+Uploaded files are stored by OpenAI under your project until they expire or are deleted. Mention this in your privacy policy, and keep attachments off for bots that don't need them.