@heyramzi/ui 2.8.0 → 2.9.0

package/src/{tasks → work}/detail/task-thread.svelte

@@ -1,9 +1,8 @@
 <script lang="ts">
 	import type { Snippet } from "svelte";
 	import { PencilSimple, Trash } from "phosphor-svelte";
-	import { cn } from "../../lib/utils.js";
+	import { initial } from "../../lib/initials.js";
 	import { AgentAvatar } from "../../agents/index.js";
-	import { TONE_CLASS } from "../../lib/tone.js";
 	import { Skeleton } from "../../shadcn/skeleton/index.js";
 	import {
 		DEFAULT_TASK_DETAIL_LABELS,
@@ -22,6 +21,8 @@
 		avatar?: Snippet<[TaskComment]>;
 		/** How a timestamp reads. Defaults to a short date. */
 		when?: (comment: TaskComment) => string;
+		/** The locale the default times read in. */
+		locale?: string;
 		/** Returns false to keep the draft. Without it the composer is hidden. */
 		onSend?: (body: string) => void | boolean | Promise<void | boolean>;
 		onEdit?: (comment: TaskComment, body: string) => void | Promise<void>;
@@ -35,8 +36,11 @@
 		labels: labelOverrides,
 		agentAvatar,
 		avatar,
+		locale = "en-GB",
 		when = (comment) =>
-			new Date(comment.createdAt).toLocaleDateString(undefined, { month: "short", day: "numeric" }),
+			new Intl.DateTimeFormat(locale, { month: "short", day: "numeric" }).format(
+				new Date(comment.createdAt),
+			),
 		onSend,
 		onEdit,
 		onDelete,
@@ -79,10 +83,6 @@
 		if (!body || body === comment.body) return;
 		await onEdit?.(comment, body);
 	}
-
-	function initial(name: string): string {
-		return name.trim().charAt(0).toLocaleUpperCase() || "?";
-	}
 </script>
 
 <section aria-label={labels.comments} class="flex flex-col gap-3">
@@ -132,14 +132,7 @@
 						<div class="flex h-6 items-center gap-2">
 							<span class="truncate text-[13px] font-medium">{comment.author}</span>
 							{#if comment.agent}
-								<span
-									class={cn(
-										"inline-flex h-5 items-center rounded-sm border px-1.5 text-xs font-medium",
-										TONE_CLASS.accent,
-									)}
-								>
-									{labels.ai}
-								</span>
+								<span class="sr-only">{labels.ai}</span>
 							{/if}
 							<span class="text-xs text-muted-foreground tabular-nums">{when(comment)}</span>
 							{#if comment.edited}

package/src/work/docs/doc-editor-page.svelte

@@ -0,0 +1,194 @@
+<script lang="ts">
+	// =========================
+	// IMPORTS
+	// =========================
+	import type { Editor } from "@tiptap/core";
+	import { FileText } from "phosphor-svelte";
+	import type { Snippet } from "svelte";
+	import OnThisPage from "../../components/docs/on-this-page.svelte";
+	import { ScrollSpy } from "../../components/docs/scroll-spy.svelte.js";
+	import RichEditor from "../../editor/editor.svelte";
+	import { docLabels, type DocLabels } from "./labels.js";
+	import { outlineOfDoc, type OutlineHeading } from "./outline.js";
+
+	// =========================
+	// TYPES
+	// =========================
+	interface Props {
+		/** The title, edited in place. */
+		title: string;
+		/** The body as Tiptap JSON. Read once: wrap the page in `{#key doc.id}` to swap documents. */
+		content?: Record<string, unknown> | null;
+		onchange?: (json: Record<string, unknown>) => void;
+		ontitle?: (title: string) => void;
+		/** Focus the title on open: a doc that was just created. */
+		autofocusTitle?: boolean;
+		/** Parent icon, parent title › this doc. */
+		breadcrumb?: Snippet;
+		/** Sits beside the breadcrumb: the star, the `…` menu. */
+		menu?: Snippet;
+		/** Right side of the bar, before the actions: the "Edited" chip. */
+		meta?: Snippet;
+		/** Right side of the bar: copy link, subscribe. */
+		actions?: Snippet;
+		/** The tile above the title. Defaults to a document glyph. */
+		icon?: Snippet;
+		/** A heading's link was copied; show the toast here. */
+		oncopylink?: (url: string, id: string) => void;
+		labels?: Partial<DocLabels>;
+		/** The live editor, to focus it or read it. */
+		instance?: Editor | null;
+	}
+
+	// =========================
+	// PROPS
+	// =========================
+	let {
+		title = $bindable(""),
+		content = null,
+		onchange,
+		ontitle,
+		autofocusTitle = false,
+		breadcrumb,
+		menu,
+		meta,
+		actions,
+		icon,
+		oncopylink,
+		labels: labelOverrides,
+		instance = $bindable(null),
+	}: Props = $props();
+
+	// =========================
+	// STATE
+	// =========================
+	let scroller = $state<HTMLElement | null>(null);
+	let titleField = $state<HTMLTextAreaElement | null>(null);
+	let outline = $state<OutlineHeading[]>(outlineOfDoc(untrackedContent()));
+	const spy = new ScrollSpy();
+
+	// =========================
+	// DERIVED
+	// =========================
+	let t = $derived(docLabels(labelOverrides));
+
+	// =========================
+	// EFFECTS
+	// =========================
+	$effect(() => spy.attach(scroller, outline));
+
+	$effect(() => {
+		if (autofocusTitle) titleField?.focus();
+	});
+
+	// =========================
+	// FUNCTIONS
+	// =========================
+	// The first outline reads the prop once; later ones come from the editor's own changes.
+	function untrackedContent() {
+		return content;
+	}
+
+	function handleChange(json: Record<string, unknown>) {
+		outline = outlineOfDoc(json);
+		onchange?.(json);
+	}
+
+	function onTitleKey(event: KeyboardEvent) {
+		if (event.key === "Enter" || (event.key === "ArrowDown" && !event.shiftKey)) {
+			event.preventDefault();
+			instance?.commands.focus("start");
+		}
+	}
+</script>
+
+<!-- =========================== -->
+<!-- MARKUP -->
+<!-- =========================== -->
+<div class="@container/doc flex h-full min-h-0 flex-col bg-background text-foreground">
+	<header
+		class="flex h-11 shrink-0 items-center gap-2 border-b border-border/70 px-3 @2xl/doc:px-4"
+	>
+		<div class="flex min-w-0 flex-1 items-center gap-1 text-[13px]">
+			{#if breadcrumb}{@render breadcrumb()}{/if}
+			{#if menu}{@render menu()}{/if}
+		</div>
+		<div class="flex shrink-0 items-center gap-1">
+			{#if meta}{@render meta()}{/if}
+			{#if actions}{@render actions()}{/if}
+		</div>
+	</header>
+
+	<div class="relative min-h-0 flex-1">
+		{#if outline.length > 0}
+			<!-- Wide: ticks in the left gutter, centred on the pane. -->
+			<div class="absolute top-1/2 left-1 z-20 hidden -translate-y-1/2 @4xl/doc:block">
+				<OnThisPage
+					variant="ticks"
+					items={outline}
+					active={spy.active}
+					label={t.outline}
+					onselect={(id) => spy.jump(id)}
+				/>
+			</div>
+			<!-- Narrow: the strip the reading pages use, since a phone has no gutter. -->
+			<div
+				class="absolute inset-x-0 top-0 z-20 border-b border-border/70 bg-background/95 backdrop-blur @4xl/doc:hidden"
+			>
+				<OnThisPage
+					variant="bar"
+					items={outline}
+					active={spy.active}
+					label={t.outline}
+					onselect={(id) => spy.jump(id)}
+				/>
+			</div>
+		{/if}
+
+		<div bind:this={scroller} class="thin-scrollbar h-full overflow-y-auto">
+			<div
+				class="mx-auto w-full max-w-[56rem] px-5 pb-40 @2xl/doc:px-8 {outline.length > 0
+					? 'pt-[3.75rem] @4xl/doc:pt-14'
+					: 'pt-8 @2xl/doc:pt-14'}"
+			>
+				<div
+					class="mb-4 flex size-12 items-center justify-center rounded-xl border border-border bg-muted/40 text-muted-foreground"
+				>
+					{#if icon}{@render icon()}{:else}<FileText size={22} aria-hidden="true" />{/if}
+				</div>
+
+				<textarea
+					bind:this={titleField}
+					bind:value={title}
+					oninput={() => ontitle?.(title)}
+					onkeydown={onTitleKey}
+					rows="1"
+					spellcheck="false"
+					aria-label={t.titlePlaceholder}
+					placeholder={t.titlePlaceholder}
+					class="doc-title mb-6 block w-full resize-none border-0 bg-transparent p-0 font-heading text-2xl leading-8 font-semibold tracking-tight text-foreground caret-brand outline-none focus-visible:shadow-none placeholder:text-muted-foreground/45"
+				></textarea>
+
+				<RichEditor
+					{content}
+					onchange={handleChange}
+					variant="page"
+					preset="full"
+					placeholder=""
+					minHeight="20rem"
+					copyLinkLabel={t.copyLink}
+					{oncopylink}
+					bind:instance
+				/>
+			</div>
+		</div>
+	</div>
+</div>
+
+<style>
+	/* The title grows with its text, so a long one wraps instead of scrolling sideways. */
+	.doc-title {
+		field-sizing: content;
+		text-wrap: balance;
+	}
+</style>

package/src/work/docs/doc-menu.svelte

@@ -0,0 +1,333 @@
+<script lang="ts">
+	// =========================
+	// IMPORTS
+	// =========================
+	import {
+		ArrowsOutCardinal,
+		CaretLeft,
+		CaretRight,
+		ClockCounterClockwise,
+		Alarm,
+		Clipboard,
+		CopySimple,
+		DotsThree,
+		FileDashed,
+		PencilSimple,
+		Star,
+		Trash,
+	} from "phosphor-svelte";
+	import type { Component, Snippet } from "svelte";
+	import {
+		AlertDialog,
+		AlertDialogAction,
+		AlertDialogCancel,
+		AlertDialogContent,
+		AlertDialogDescription,
+		AlertDialogFooter,
+		AlertDialogHeader,
+		AlertDialogTitle,
+	} from "../../shadcn/alert-dialog/index.js";
+	import { buttonVariants } from "../../shadcn/button/index.js";
+	import {
+		Command,
+		CommandEmpty,
+		CommandGroup,
+		CommandInput,
+		CommandItem,
+		CommandList,
+		CommandSeparator,
+		CommandShortcut,
+	} from "../../shadcn/command/index.js";
+	import { Popover, PopoverContent, PopoverTrigger } from "../../shadcn/popover/index.js";
+	import { docLabels, type DocLabels } from "./labels.js";
+	import {
+		copyOptions,
+		deleteName,
+		filterMenu,
+		menuItems,
+		shortcutLabel,
+		shortcutTarget,
+		type CopyKind,
+		type MenuId,
+	} from "./menu.js";
+
+	// =========================
+	// TYPES
+	// =========================
+	interface Props {
+		/** The doc's title. An empty one reads "Untitled" in the delete confirm. */
+		title: string;
+		/** The doc's address; "Copy URL" and "title as link" need it. */
+		url?: string;
+		/** The doc as Tiptap JSON; "Copy content as Markdown" needs it. */
+		content?: unknown;
+		favorited?: boolean;
+		/** Every item is a callback. One that isn't passed doesn't show. */
+		onmove?: () => void;
+		onduplicate?: () => void;
+		onrename?: () => void;
+		ontemplate?: () => void;
+		onfavorite?: () => void;
+		/** Passing it shows Copy. It runs after the text is on the clipboard, for a toast. */
+		oncopy?: (kind: CopyKind, text: string) => void;
+		onremind?: () => void;
+		onhistory?: () => void;
+		/** Passing it shows Delete, behind a confirm that names the doc. */
+		ondelete?: () => void;
+		/** One line under the confirm title: "and its 3 sub-pages". */
+		deleteDetail?: string;
+		/** Fire items from the keyboard (⇧R) while no field has focus. */
+		shortcuts?: boolean;
+		open?: boolean;
+		labels?: Partial<DocLabels>;
+		/** Replaces the round `…` button. Spread `props` on the element. */
+		trigger?: Snippet<[Record<string, unknown>]>;
+	}
+
+	// =========================
+	// PROPS
+	// =========================
+	let {
+		title,
+		url,
+		content,
+		favorited = false,
+		onmove,
+		onduplicate,
+		onrename,
+		ontemplate,
+		onfavorite,
+		oncopy,
+		onremind,
+		onhistory,
+		ondelete,
+		deleteDetail,
+		shortcuts = true,
+		open = $bindable(false),
+		labels: labelOverrides,
+		trigger,
+	}: Props = $props();
+
+	// =========================
+	// STATE
+	// =========================
+	let query = $state("");
+	let page = $state<"root" | "copy">("root");
+	let confirming = $state(false);
+
+	// =========================
+	// DERIVED
+	// =========================
+	let t = $derived(docLabels(labelOverrides));
+	let all = $derived(
+		menuItems(
+			{
+				move: !!onmove,
+				duplicate: !!onduplicate,
+				rename: !!onrename,
+				template: !!ontemplate,
+				favorite: !!onfavorite,
+				copy: !!oncopy,
+				remind: !!onremind,
+				history: !!onhistory,
+				delete: !!ondelete,
+			},
+			t,
+			{ favorited },
+		),
+	);
+	let visible = $derived(filterMenu(all, query));
+	// Groups keep their order; a hairline sits between the ones that still have an item.
+	let groups = $derived.by(() => {
+		const byGroup = new Map<number, typeof visible>();
+		for (const item of visible) byGroup.set(item.group, [...(byGroup.get(item.group) ?? []), item]);
+		return [...byGroup.entries()].toSorted((a, b) => a[0] - b[0]).map(([, items]) => items);
+	});
+	// Built only while the copy list is showing: the Markdown of a long doc isn't free.
+	let copies = $derived(
+		page === "copy" ? filterMenu(copyOptions({ title, url, content }, t), query) : [],
+	);
+	let confirmName = $derived(deleteName(title, t));
+
+	const ICONS: Record<MenuId, Component<{ class?: string }>> = {
+		move: ArrowsOutCardinal,
+		duplicate: CopySimple,
+		rename: PencilSimple,
+		template: FileDashed,
+		favorite: Star,
+		copy: Clipboard,
+		remind: Alarm,
+		history: ClockCounterClockwise,
+		delete: Trash,
+	};
+
+	// =========================
+	// FUNCTIONS
+	// =========================
+	function reset() {
+		query = "";
+		page = "root";
+	}
+
+	function fire(id: MenuId) {
+		const run: Partial<Record<MenuId, (() => void) | undefined>> = {
+			move: onmove,
+			duplicate: onduplicate,
+			rename: onrename,
+			template: ontemplate,
+			favorite: onfavorite,
+			remind: onremind,
+			history: onhistory,
+		};
+		if (id === "copy") {
+			query = "";
+			page = "copy";
+			return;
+		}
+		open = false;
+		if (id === "delete") confirming = true;
+		else run[id]?.();
+	}
+
+	async function copy(kind: CopyKind, text: string) {
+		open = false;
+		// A blocked clipboard still reports, so the host can say the copy didn't land.
+		await navigator.clipboard.writeText(text).catch(() => {});
+		oncopy?.(kind, text);
+	}
+
+	function onWindowKey(event: KeyboardEvent) {
+		if (!shortcuts || event.defaultPrevented || event.repeat) return;
+		const target = event.target as HTMLElement | null;
+		if (target?.closest("input, textarea, select, [contenteditable='true'], [role='dialog']"))
+			return;
+		const id = shortcutTarget(event, all);
+		if (!id) return;
+		event.preventDefault();
+		fire(id);
+	}
+
+	function onListKey(event: KeyboardEvent) {
+		if (page !== "copy") return;
+		const empty = query === "";
+		if (event.key === "ArrowLeft" || (event.key === "Backspace" && empty)) {
+			if (event.key === "ArrowLeft" && !empty) return;
+			event.preventDefault();
+			reset();
+		}
+	}
+</script>
+
+<svelte:window onkeydown={onWindowKey} />
+
+<!-- =========================== -->
+<!-- MARKUP -->
+<!-- =========================== -->
+<Popover
+	bind:open
+	onOpenChange={(next) => {
+		// Reset as it opens, not as it closes: a reset mid-fade flashes the root list.
+		if (next) reset();
+	}}
+>
+	<PopoverTrigger aria-label={t.menu}>
+		{#snippet child({ props })}
+			{#if trigger}
+				{@render trigger(props)}
+			{:else}
+				<button
+					{...props}
+					type="button"
+					class="t-press inline-flex size-7 items-center justify-center rounded-md text-muted-foreground transition-colors duration-[var(--duration-fast)] ease-[var(--ease-smooth-out)] outline-none hover:bg-foreground/6 hover:text-foreground focus-visible:ring-3 focus-visible:ring-ring/50 aria-expanded:bg-foreground/6 aria-expanded:text-foreground any-pointer-coarse:size-10"
+				>
+					<DotsThree size={18} weight="bold" aria-hidden="true" />
+				</button>
+			{/if}
+		{/snippet}
+	</PopoverTrigger>
+	<PopoverContent align="start" sideOffset={6} class="w-64 gap-0 overflow-hidden p-0">
+		<Command shouldFilter={false} onkeydown={onListKey} class="rounded-xl">
+			<CommandInput
+				bind:value={query}
+				placeholder={page === "copy" ? t.copy : t.filter}
+				aria-label={t.filter}
+			/>
+			<CommandList class="max-h-[22rem] p-1.5">
+				{#if page === "root"}
+					{#each groups as items, i (i)}
+						{#if i > 0 && !query}<CommandSeparator class="my-1.5" />{/if}
+						<CommandGroup class="p-0">
+							{#each items as item (item.id)}
+								{@const Icon = ICONS[item.id]}
+								<CommandItem
+									value={item.id}
+									onSelect={() => fire(item.id)}
+									class={item.danger ? "text-destructive data-selected:text-destructive" : ""}
+								>
+									<Icon
+										class={item.id === "favorite" && favorited
+											? "text-brand"
+											: item.danger
+												? ""
+												: "text-muted-foreground"}
+									/>
+									<span class="flex-1 truncate">{item.label}</span>
+									{#if item.shortcut}
+										<CommandShortcut class="text-xs tracking-normal"
+											>{shortcutLabel(item.shortcut)}</CommandShortcut
+										>
+									{:else if item.submenu}
+										<CaretRight size={12} class="text-muted-foreground" aria-hidden="true" />
+									{/if}
+								</CommandItem>
+							{/each}
+						</CommandGroup>
+					{/each}
+					{#if visible.length === 0}
+						<CommandEmpty class="py-6 text-center text-[13px] text-muted-foreground">
+							{t.noResults}
+						</CommandEmpty>
+					{/if}
+				{:else}
+					<CommandGroup class="p-0">
+						{#if !query}
+							<CommandItem value="__back" onSelect={reset} class="text-muted-foreground">
+								<CaretLeft size={14} aria-hidden="true" />
+								<span>{t.back}</span>
+							</CommandItem>
+							<CommandSeparator class="my-1.5" />
+						{/if}
+						{#each copies as option (option.kind)}
+							<CommandItem value={option.kind} onSelect={() => copy(option.kind, option.text)}>
+								<span class="truncate">{option.label}</span>
+							</CommandItem>
+						{/each}
+					</CommandGroup>
+					{#if copies.length === 0}
+						<CommandEmpty class="py-6 text-center text-[13px] text-muted-foreground">
+							{t.noResults}
+						</CommandEmpty>
+					{/if}
+				{/if}
+			</CommandList>
+		</Command>
+	</PopoverContent>
+</Popover>
+
+<AlertDialog bind:open={confirming}>
+	<AlertDialogContent class="sm:max-w-sm">
+		<AlertDialogHeader>
+			<AlertDialogTitle>{t.deleteTitle(confirmName)}</AlertDialogTitle>
+			<AlertDialogDescription>{deleteDetail ?? t.deleteDetail}</AlertDialogDescription>
+		</AlertDialogHeader>
+		<AlertDialogFooter>
+			<AlertDialogCancel>{t.cancel}</AlertDialogCancel>
+			<AlertDialogAction
+				class={buttonVariants({ variant: "destructive" })}
+				onclick={() => ondelete?.()}
+			>
+				{t.delete}
+			</AlertDialogAction>
+		</AlertDialogFooter>
+	</AlertDialogContent>
+</AlertDialog>