@kernhq/module-tracker 0.10.0 → 0.11.0

package/src/client/components/CommentComposer.svelte

@@ -0,0 +1,219 @@
+<script lang="ts">
+import { Button, Icon, IconButton, rankCandidates, Spinner, toast, uploadFile } from '@kernhq/ui'
+import { type MentionCandidate, RichTextEditor } from '@kernhq/ui/editor'
+import { getTrackerCatalogue } from '../context.svelte.js'
+import { t } from '../i18n.js'
+import type { RichDoc } from '../index.js'
+import { isEmptyDoc } from '../richtext.js'
+
+/**
+ * Writing a comment: text, `@` mentions, and files.
+ *
+ * The same `@` machinery chat uses (`$lib/mentions`), so a mention here is a real mention node the
+ * server turns into a notification, not the characters `@Ada` sitting in a sentence.
+ *
+ * Files upload as you pick them and are attached to the comment once it exists — a comment id has
+ * to exist before an attachment can point at it, so the parent posts the comment and then hands
+ * the ids over.
+ */
+interface Props {
+  initial?: RichDoc | null
+  placeholder?: string
+  submitLabel?: string
+  /** editing an existing comment cannot add files: they attach at creation */
+  allowFiles?: boolean
+  busy?: boolean
+  /** the workspace the files belong to */
+  workspaceId: string
+  oncancel?: () => void
+  onsubmit: (body: RichDoc, fileIds: string[], internal: boolean) => void
+}
+let {
+  initial = null,
+  placeholder = t('comment_placeholder'),
+  submitLabel = t('comment_send'),
+  allowFiles = true,
+  busy = false,
+  workspaceId,
+  oncancel,
+  onsubmit,
+}: Props = $props()
+
+const cat = getTrackerCatalogue()
+
+// The starting draft only: later prop changes must not overwrite what is being typed.
+let body = $state<RichDoc | null>(initial ?? null)
+let internal = $state(false)
+let fileInput = $state<HTMLInputElement | null>(null)
+
+let uploads = $state<Array<{ id: string; name: string; ratio: number | null; fileId: string | null }>>([])
+
+/*
+ * Mentions are nodes in the document now, not a list kept beside a string. The editor inserts a
+ * real `mention` node when someone is picked, so there is nothing left to reconcile on save and
+ * no way for a hand-typed "@Ada" to be mistaken for one.
+ */
+const people = $derived(cat.people.map((p) => ({ id: p.id, name: p.name, avatarUrl: p.avatarUrl ?? null })))
+/* `rankCandidates` is the ranking chat uses, and it wants a lowercased query and a `name`; the
+   editor speaks `label`. Bridge here rather than forking either. */
+const mentionSource = (query: string): MentionCandidate[] =>
+  rankCandidates(people, query.toLowerCase()).map((p) => ({
+    id: p.id,
+    label: p.name,
+    avatarUrl: p.avatarUrl ?? null,
+  }))
+
+const ready = $derived(uploads.every((u) => u.fileId !== null))
+const empty = $derived(isEmptyDoc(body))
+
+async function addFiles(list: FileList | null) {
+  if (!list?.length) return
+  for (const file of Array.from(list)) {
+    const id = crypto.randomUUID()
+    uploads = [...uploads, { id, name: file.name, ratio: 0, fileId: null }]
+    try {
+      const uploaded = await uploadFile({
+        workspaceId,
+        file,
+        name: file.name,
+        mimeType: file.type || undefined,
+        onProgress: ({ ratio }) => {
+          uploads = uploads.map((u) => (u.id === id ? { ...u, ratio } : u))
+        },
+      })
+      uploads = uploads.map((u) => (u.id === id ? { ...u, ratio: 1, fileId: uploaded.id } : u))
+    } catch (err) {
+      // Drop the row rather than leave a file that looks attached and is not.
+      uploads = uploads.filter((u) => u.id !== id)
+      toast.error(err instanceof Error ? err.message : t('attachment_failed'))
+    }
+  }
+}
+
+function submit() {
+  if (empty || busy || !ready) return
+  onsubmit(
+    // A state proxy cannot survive `structuredClone` on the way to the API — snapshot it first.
+    $state.snapshot(body) as RichDoc,
+    uploads.map((u) => u.fileId).filter((id): id is string => Boolean(id)),
+    internal,
+  )
+  body = null
+  uploads = []
+  internal = false
+}
+</script>
+
+<div class="composer">
+  <RichTextEditor
+    bind:value={body}
+    minRows={2}
+    {placeholder}
+    label={placeholder}
+    {mentionSource}
+    data-testid="comment-input"
+    onsubmit={submit}
+    onescape={oncancel}
+  />
+
+  {#if uploads.length}
+    <ul class="uploads">
+      {#each uploads as file (file.id)}
+        <li>
+          {#if file.fileId}
+            <Icon name="paperclip" size={12} strokeWidth={1.8} />
+          {:else}
+            <Spinner size={12} />
+          {/if}
+          <span class="uname">{file.name}</span>
+          <IconButton
+            icon="x"
+            size={22}
+            label={t('attachment_remove')}
+            onclick={() => (uploads = uploads.filter((u) => u.id !== file.id))}
+          />
+        </li>
+      {/each}
+    </ul>
+  {/if}
+
+  <div class="actions">
+    {#if allowFiles}
+      <input
+        bind:this={fileInput}
+        type="file"
+        multiple
+        hidden
+        onchange={(e) => {
+          void addFiles(e.currentTarget.files)
+          e.currentTarget.value = ''
+        }}
+      />
+      <IconButton
+        icon="paperclip"
+        size={26}
+        label={t('attach_file')}
+        onclick={() => fileInput?.click()}
+      />
+      <label class="internal">
+        <input type="checkbox" bind:checked={internal} />
+        <span title={t('comment_internal_hint')}>{t('comment_internal')}</span>
+      </label>
+    {/if}
+    <span class="hint">{t('comment_hint')}</span>
+    {#if oncancel}
+      <Button size="sm" variant="ghost" onclick={oncancel}>{t('common.cancel')}</Button>
+    {/if}
+    <Button size="sm" disabled={empty || busy || !ready} onclick={submit}>{submitLabel}</Button>
+  </div>
+</div>
+
+<style>
+.composer {
+  position: relative;
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+.uploads {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+.uploads li {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  padding: 2px 6px;
+  border-radius: var(--kern-r-sm);
+  background: var(--kern-surface-active);
+  font-size: 12px;
+}
+.uname {
+  max-width: 160px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.actions {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+.internal {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  font-size: 12px;
+  color: var(--kern-ink-350);
+  cursor: pointer;
+}
+.hint {
+  flex: 1;
+  font-size: 11px;
+  color: var(--kern-ink-350);
+}
+</style>

package/src/client/components/CommentThread.svelte

@@ -0,0 +1,389 @@
+<script lang="ts">
+import {
+  Avatar,
+  DropdownMenu,
+  EmojiPicker,
+  Icon,
+  IconButton,
+  type MenuItem,
+  QUICK_REACTIONS,
+  relativeTime,
+  session,
+} from '@kernhq/ui'
+import { getTrackerCatalogue } from '../context.svelte.js'
+import { t } from '../i18n.js'
+import type { Attachment, Comment as IssueComment } from '../index.js'
+import { renderDoc } from '../richtext.js'
+import CommentComposer from './CommentComposer.svelte'
+
+/**
+ * One comment and its replies.
+ *
+ * The server has carried threading, mentions, an internal flag, edit and delete since the model
+ * existed; the panel used three of the five procedures. Everything a comment can do is reachable
+ * here.
+ */
+interface Props {
+  workspaceId: string
+  comment: IssueComment
+  replies: IssueComment[]
+  attachments: Attachment[]
+  canComment: boolean
+  onreact: (commentId: string, emoji: string) => void
+  onedit: (commentId: string, body: unknown) => void
+  ondelete: (commentId: string) => void
+  onreply: (parentId: string, body: unknown, fileIds: string[]) => void
+  onremoveAttachment: (attachmentId: string) => void
+}
+let {
+  workspaceId,
+  comment,
+  replies,
+  attachments,
+  canComment,
+  onreact,
+  onedit,
+  ondelete,
+  onreply,
+  onremoveAttachment,
+}: Props = $props()
+
+const cat = getTrackerCatalogue()
+
+let editing = $state(false)
+let replying = $state(false)
+let confirmingDelete = $state(false)
+let pickerOpen = $state(false)
+let pickerTrigger = $state<HTMLElement | null>(null)
+
+const person = $derived(cat.person(comment.authorId))
+/** Only the author edits or deletes their own comment; anything else is somebody else's words. */
+const mine = $derived(Boolean(session.user && comment.authorId === session.user.id))
+
+const menu = $derived<MenuItem[]>([
+  { type: 'item', id: 'edit', label: t('common.edit'), icon: 'pencil', onSelect: () => (editing = true) },
+  {
+    type: 'item',
+    id: 'delete',
+    label: t('common.delete'),
+    icon: 'trash-2',
+    danger: true,
+    onSelect: () => (confirmingDelete = true),
+  },
+])
+
+/** Whether I am one of the people behind this reaction, so it can render as mine. */
+const reacted = (userIds: readonly string[]) => (session.user ? userIds.includes(session.user.id) : false)
+</script>
+
+<article class="thread" class:internal={comment.internal}>
+  <Avatar name={person?.name} src={person?.avatarUrl} id={person?.id} size={28} />
+  <div class="tbody">
+    <div class="thead">
+      <span class="author">{person?.name ?? ''}</span>
+      <time datetime={comment.createdAt}>{relativeTime(comment.createdAt)}</time>
+      {#if comment.editedAt}
+        <span class="tag">{t('comment_edited')}</span>
+      {/if}
+      {#if comment.internal}
+        <span class="tag internal-tag" title={t('comment_internal_hint')}>
+          <Icon name="lock" size={11} strokeWidth={1.8} />
+          {t('comment_internal')}
+        </span>
+      {/if}
+      {#if mine}
+        <span class="spacer"></span>
+        <DropdownMenu items={menu} align="end">
+          {#snippet trigger(props)}
+            <IconButton {...props} icon="ellipsis" size={26} label={t('comment_actions')} />
+          {/snippet}
+        </DropdownMenu>
+      {/if}
+    </div>
+
+    {#if editing}
+      <CommentComposer
+        {workspaceId}
+        initial={comment.body}
+        placeholder={t('comment_edit_placeholder')}
+        submitLabel={t('common.save')}
+        allowFiles={false}
+        oncancel={() => (editing = false)}
+        onsubmit={(body) => {
+          onedit(comment.id, body)
+          editing = false
+        }}
+      />
+    {:else if confirmingDelete}
+      <!-- Inline rather than window.confirm: it says what happens and can be dismissed with Escape. -->
+      <div class="confirm" role="alertdialog" aria-label={t('comment_delete_title')}>
+        <p>{t('comment_delete_body')}</p>
+        <div class="row">
+          <button type="button" class="danger" onclick={() => ondelete(comment.id)}>
+            {t('common.delete')}
+          </button>
+          <button type="button" onclick={() => (confirmingDelete = false)}>{t('common.cancel')}</button>
+        </div>
+      </div>
+    {:else}
+      <div class="kern-prose tprose">{@html renderDoc(comment.body)}</div>
+    {/if}
+
+    {#if attachments.length}
+      <ul class="files">
+        {#each attachments as file (file.id)}
+          <li>
+            <Icon name="paperclip" size={12} strokeWidth={1.8} />
+            <span class="fname">{file.name}</span>
+            {#if mine}
+              <IconButton
+                icon="x"
+                size={22}
+                label={t('attachment_remove')}
+                onclick={() => onremoveAttachment(file.id)}
+              />
+            {/if}
+          </li>
+        {/each}
+      </ul>
+    {/if}
+
+    <div class="reactions">
+      {#each comment.reactions as reaction (reaction.emoji)}
+        <button
+          type="button"
+          class="reaction"
+          class:mine={reacted(reaction.userIds)}
+          onclick={() => onreact(comment.id, reaction.emoji)}
+        >
+          {reaction.emoji}
+          {reaction.count}
+        </button>
+      {/each}
+      <div class="picker-anchor">
+        <button
+          type="button"
+          class="reaction add"
+          aria-label={t('add_reaction')}
+          bind:this={pickerTrigger}
+          onclick={() => (pickerOpen = !pickerOpen)}
+        >
+          <Icon name="smile" size={13} strokeWidth={1.6} />
+        </button>
+        {#if pickerOpen}
+          <EmojiPicker
+            trigger={pickerTrigger}
+            onclose={() => (pickerOpen = false)}
+            onpick={(emoji) => {
+              onreact(comment.id, emoji)
+              pickerOpen = false
+            }}
+          />
+        {/if}
+      </div>
+      {#each QUICK_REACTIONS.slice(0, 3) as emoji (emoji)}
+        <button
+          type="button"
+          class="reaction quick"
+          onclick={() => onreact(comment.id, emoji)}
+          aria-label={emoji}
+        >
+          {emoji}
+        </button>
+      {/each}
+      {#if canComment}
+        <button type="button" class="reply-btn" onclick={() => (replying = !replying)}>
+          {t('comment_reply')}
+        </button>
+      {/if}
+    </div>
+
+    {#if replies.length}
+      <ul class="replies">
+        {#each replies as reply (reply.id)}
+          {@const author = cat.person(reply.authorId)}
+          <li>
+            <Avatar name={author?.name} src={author?.avatarUrl} id={author?.id} size={22} />
+            <div>
+              <div class="thead">
+                <span class="author">{author?.name ?? ''}</span>
+                <time datetime={reply.createdAt}>{relativeTime(reply.createdAt)}</time>
+              </div>
+              <div class="kern-prose tprose">{@html renderDoc(reply.body)}</div>
+            </div>
+          </li>
+        {/each}
+      </ul>
+    {/if}
+
+    {#if replying}
+      <CommentComposer
+        {workspaceId}
+        placeholder={t('comment_reply_placeholder')}
+        submitLabel={t('comment_reply')}
+        oncancel={() => (replying = false)}
+        onsubmit={(body, fileIds) => {
+          onreply(comment.id, body, fileIds)
+          replying = false
+        }}
+      />
+    {/if}
+  </div>
+</article>
+
+<style>
+.thread {
+  display: grid;
+  grid-template-columns: 28px 1fr;
+  gap: 10px;
+  padding: 10px 0;
+}
+.thread.internal {
+  border-inline-start: 2px solid var(--kern-warning);
+  padding-inline-start: 10px;
+  margin-inline-start: -12px;
+}
+.thead {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  font-size: 12px;
+  color: var(--kern-ink-350);
+}
+.author {
+  font-weight: 600;
+  color: var(--kern-ink-900);
+}
+.spacer {
+  flex: 1;
+}
+.tag {
+  display: inline-flex;
+  align-items: center;
+  gap: 3px;
+  font-size: 11px;
+}
+.internal-tag {
+  color: var(--kern-warning);
+}
+/* Size only — everything else now comes from `@kernhq/ui/styles/prose.css`, the same sheet the
+   editor's writing surface uses, so a comment reads exactly as it was written. */
+.tprose {
+  font-size: 13px;
+  margin-top: 3px;
+}
+.files {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  margin: 6px 0 0;
+  padding: 0;
+  list-style: none;
+}
+.files li {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  padding: 2px 6px;
+  border-radius: var(--kern-r-sm);
+  background: var(--kern-surface-active);
+  font-size: 12px;
+}
+.fname {
+  max-width: 180px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.reactions {
+  display: flex;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: 4px;
+  margin-top: 6px;
+}
+.picker-anchor {
+  position: relative;
+}
+.reaction {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  padding: 1px 6px;
+  border: 1px solid var(--kern-border);
+  border-radius: 999px;
+  background: none;
+  color: inherit;
+  font: inherit;
+  font-size: 12px;
+  cursor: pointer;
+}
+.reaction.mine {
+  border-color: var(--kern-accent);
+  background: var(--kern-info-tint);
+}
+.reaction.quick,
+.reaction.add {
+  border-color: transparent;
+  opacity: 0;
+}
+.thread:hover .reaction.quick,
+.thread:hover .reaction.add,
+.reaction.add:focus-visible,
+.reaction.quick:focus-visible {
+  opacity: 1;
+}
+.reply-btn {
+  border: 0;
+  background: none;
+  color: var(--kern-ink-350);
+  font: inherit;
+  font-size: 12px;
+  cursor: pointer;
+  padding: 1px 4px;
+}
+.reply-btn:hover {
+  color: var(--kern-ink-900);
+}
+.replies {
+  list-style: none;
+  margin: 8px 0 0;
+  padding: 0 0 0 4px;
+  border-inline-start: 1px solid var(--kern-border);
+}
+.replies li {
+  display: grid;
+  grid-template-columns: 22px 1fr;
+  gap: 8px;
+  padding: 6px 0 6px 8px;
+}
+.confirm {
+  margin-top: 6px;
+  padding: 8px 10px;
+  border: 1px solid var(--kern-border);
+  border-radius: var(--kern-r-sm);
+  background: var(--kern-shell);
+  font-size: 13px;
+}
+.confirm p {
+  margin: 0 0 8px;
+}
+.confirm .row {
+  display: flex;
+  gap: 8px;
+}
+.confirm button {
+  padding: 3px 10px;
+  border: 1px solid var(--kern-border);
+  border-radius: var(--kern-r-sm);
+  background: var(--kern-surface);
+  color: inherit;
+  font: inherit;
+  font-size: 12px;
+  cursor: pointer;
+}
+.confirm .danger {
+  border-color: var(--kern-danger);
+  color: var(--kern-danger);
+}
+</style>