@meith/web 0.16.0

package/src/view/forum-jump.ts

@@ -0,0 +1,60 @@
+import { buildTree, type ForumNode, keepVisibleSubtrees } from '@meith/forums'
+import type { Translator } from '@meith/i18n'
+import type { ForumJumpModel, ForumJumpOption } from '@meith/theme-kit'
+
+import { untranslated } from './time'
+
+export interface ForumJumpRow {
+  readonly id: number
+  readonly parentId: number | null
+  readonly displayOrder: number
+  readonly type: string
+  readonly title: string
+  readonly slug: string
+}
+
+export interface ForumJumpInput {
+  readonly rows: readonly ForumJumpRow[]
+  readonly visibleForumIds: ReadonlySet<number>
+  readonly currentForumId?: number | null
+  readonly action?: string
+  readonly field?: string
+  readonly t?: Translator
+}
+
+export const JUMP_ACTION = '/jump'
+export const JUMP_FIELD = 'forum'
+
+export function parseJumpTarget(raw: string | readonly string[] | undefined): number | null {
+  const first = Array.isArray(raw) ? raw[0] : (raw as string | undefined)
+  if (first === undefined || !/^\d+$/.test(first)) return null
+  return Number(first)
+}
+
+export function buildForumJumpModel(input: ForumJumpInput): ForumJumpModel {
+  const t = input.t ?? untranslated()
+  const visible = keepVisibleSubtrees(input.rows, (row) => input.visibleForumIds.has(row.id))
+
+  const forums: ForumJumpOption[] = []
+
+  const walk = (node: ForumNode<ForumJumpRow>, depth: number): void => {
+    forums.push({
+      value: String(node.id),
+      label: node.title,
+      depth,
+      isCategory: node.type === 'category',
+      isSelected: node.id === (input.currentForumId ?? null),
+    })
+    for (const child of node.children) walk(child, depth + 1)
+  }
+
+  for (const root of buildTree(visible)) walk(root, 0)
+
+  return {
+    action: input.action ?? JUMP_ACTION,
+    field: input.field ?? JUMP_FIELD,
+    forums,
+    submitLabel: t.t('forumJump.go'),
+    label: t.t('forumJump.label'),
+  }
+}

package/src/view/forum-notice.ts

@@ -0,0 +1,24 @@
+import type { Translator } from '@meith/i18n'
+
+import { inlineOutcomeNotice } from './inline-moderation'
+import { untranslated } from './time'
+
+export interface ForumNoticeQuery {
+  readonly posted?: string | undefined
+  readonly thread?: string | undefined
+  readonly did?: string | undefined
+  readonly n?: string | undefined
+  readonly refused?: string | undefined
+  readonly gone?: string | undefined
+  readonly skipped?: string | undefined
+}
+
+export function forumNotice(
+  query: ForumNoticeQuery,
+  t: Translator = untranslated(),
+): string | null {
+  if (query.posted === 'moderated') return t.t('forum.threadHeld')
+  if (query.thread === 'deleted') return t.t('forum.threadDeleted')
+
+  return inlineOutcomeNotice(query)
+}

package/src/view/inline-moderation.ts

@@ -0,0 +1,87 @@
+import type { InlineTool } from '@meith/moderation'
+import type { SelectionModel } from '@meith/theme-kit'
+
+export const INLINE_FORM_ID = 'inline-moderation'
+
+export interface InlineToolAvailability {
+  readonly approve: boolean
+  readonly lock: boolean
+  readonly stick: boolean
+  readonly move: boolean
+  readonly delete: boolean
+  readonly restore: boolean
+}
+
+export const NO_INLINE_TOOLS: InlineToolAvailability = {
+  approve: false,
+  lock: false,
+  stick: false,
+  move: false,
+  delete: false,
+  restore: false,
+}
+
+export function anyInlineTool(available: InlineToolAvailability): boolean {
+  return (
+    available.approve ||
+    available.lock ||
+    available.stick ||
+    available.move ||
+    available.delete ||
+    available.restore
+  )
+}
+
+export function selectionFor(
+  kind: 'thread' | 'post',
+  id: number,
+  label: string,
+  offered: boolean,
+): SelectionModel | null {
+  if (!offered) return null
+  return {
+    name: 'item',
+    value: `${kind}:${id}`,
+    formId: INLINE_FORM_ID,
+    label: `Select ${label} for moderation`,
+  }
+}
+
+export function inlineOutcomeNotice(query: {
+  readonly did?: string | undefined
+  readonly n?: string | undefined
+  readonly refused?: string | undefined
+  readonly gone?: string | undefined
+  readonly skipped?: string | undefined
+}): string | null {
+  const tool = query.did
+  if (tool === undefined) return null
+  const applied = count(query.n)
+  const parts = [`${applied} ${applied === 1 ? 'item' : 'items'} ${PAST_TENSE[tool] ?? tool}.`]
+
+  const refused = count(query.refused)
+  if (refused > 0) parts.push(`${refused} refused — you cannot do that there.`)
+  const gone = count(query.gone)
+  if (gone > 0) parts.push(`${gone} no longer available.`)
+  const skipped = count(query.skipped)
+  if (skipped > 0) parts.push(`${skipped} already in that state.`)
+
+  return parts.join(' ')
+}
+
+function count(value: string | undefined): number {
+  if (value === undefined || !/^\d+$/.test(value)) return 0
+  const n = Number(value)
+  return Number.isSafeInteger(n) ? n : 0
+}
+
+const PAST_TENSE: Readonly<Record<string, string>> = {
+  approve: 'approved',
+  delete: 'deleted',
+  restore: 'restored',
+  lock: 'locked',
+  unlock: 'unlocked',
+  stick: 'pinned',
+  unstick: 'unpinned',
+  move: 'moved',
+} satisfies Readonly<Record<InlineTool, string>>

package/src/view/install-copy.ts

@@ -0,0 +1,95 @@
+import type { Translator } from '@meith/i18n'
+
+import { copyFor, patternCopy, splitAround } from './copy'
+import { untranslated } from './time'
+
+export function installFormCopy(
+  reservedUsernames: readonly string[],
+  t: Translator = untranslated(),
+): Readonly<Record<string, string>> {
+  const [urlFromEnvLead, urlFromEnvTail] = splitAround(t, 'install.urlFromEnv', 'name')
+  const [mailFromEnvLead, mailFromEnvTail] = splitAround(t, 'install.mailFromEnv', 'name')
+  const [testNoteLead, testNoteTail] = splitAround(t, 'install.mail.testNote', 'before')
+  return {
+    ...copyFor(
+      [
+        'install.board.title',
+        'install.board.hint',
+        'install.boardName.label',
+        'install.boardName.hint',
+        'install.boardUrl.label',
+        'install.boardUrl.hint',
+        'install.account.title',
+        'install.account.hint',
+        'install.username.label',
+        'install.email.label',
+        'install.email.hint',
+        'install.password.label',
+        'install.password.hint',
+        'install.mail.title',
+        'install.mail.envHint',
+        'install.mail.optionalHint',
+        'install.mail.testNoteBefore',
+        'install.mail.how',
+        'install.mail.skip',
+        'install.mail.needs',
+        'install.mail.serverDetails',
+        'install.mailFrom.label',
+        'install.mailFrom.hint',
+        'install.mailUsername.label',
+        'install.mailUsername.hint',
+        'install.mailSecret.label',
+        'install.mailSecret.hint',
+        'install.mailHost.label',
+        'install.mailHost.hint',
+        'install.mailPort.label',
+        'install.mailSecurity.label',
+        'install.mailSecurity.default',
+        'install.mailSecurity.starttls',
+        'install.mailSecurity.tls',
+        'install.mailSecurity.none',
+        'install.mailEndpoint.label',
+        'install.mailEndpoint.hint',
+        'install.submit.installing',
+        'install.submit.tryAgain',
+        'install.submit.install',
+        'install.submit.pendingNote',
+        'install.submit.idleNote',
+        'install.steps.howFar',
+        'install.steps.what',
+        'install.steps.done',
+        'install.steps.failed',
+        'install.steps.notRun',
+        'install.outcome.oneAnswer',
+        'install.outcome.passwords',
+        'install.field.boardName',
+        'install.field.boardUrl',
+        'install.field.username',
+        'install.field.email',
+        'install.field.password',
+        'install.field.mailPreset',
+        'install.field.mailFrom',
+        'install.field.mailUsername',
+        'install.field.mailSecret',
+        'install.field.mailHost',
+        'install.field.mailPort',
+        'install.field.mailSecurity',
+        'install.field.mailEndpoint',
+      ],
+      t,
+    ),
+    ...patternCopy(
+      ['install.steps.count', 'install.outcome.didNotFinish', 'install.outcome.answers'],
+      t,
+    ),
+    'install.username.hint': t.t('install.username.hint', {
+      names: reservedUsernames.join(', '),
+    }),
+    'install.urlFromEnvLead': urlFromEnvLead,
+    'install.urlFromEnvTail': urlFromEnvTail,
+    'install.mailFromEnvLead': mailFromEnvLead,
+    'install.mailFromEnvTail': mailFromEnvTail,
+    'install.mail.testNoteLead': testNoteLead,
+    'install.mail.testNoteTail': testNoteTail,
+  }
+}

package/src/view/legal.ts

@@ -0,0 +1,58 @@
+import type { Translator } from '@meith/i18n'
+import type { LinkModel } from '@meith/theme-kit'
+
+import { untranslated } from './time'
+
+export type LegalSlug = 'terms' | 'privacy' | 'rules'
+
+export interface LegalPage {
+  readonly slug: LegalSlug
+  readonly settingKey: 'legal.terms' | 'legal.privacy' | 'legal.rules'
+  readonly titleKey: string
+  readonly href: string
+  readonly footerLabelKey: string
+}
+
+export const LEGAL_PAGES: readonly LegalPage[] = [
+  {
+    slug: 'terms',
+    settingKey: 'legal.terms',
+    titleKey: 'legal.page.terms.title',
+    href: '/terms',
+    footerLabelKey: 'legal.page.terms.footer',
+  },
+  {
+    slug: 'privacy',
+    settingKey: 'legal.privacy',
+    titleKey: 'legal.page.privacy.title',
+    href: '/privacy',
+    footerLabelKey: 'legal.page.privacy.footer',
+  },
+  {
+    slug: 'rules',
+    settingKey: 'legal.rules',
+    titleKey: 'legal.page.rules.title',
+    href: '/rules',
+    footerLabelKey: 'legal.page.rules.footer',
+  },
+]
+
+export const TERMS_PAGE: LegalPage = LEGAL_PAGES[0]!
+
+export function legalPage(slug: string): LegalPage | null {
+  return LEGAL_PAGES.find((page) => page.slug === slug) ?? null
+}
+
+export function isPublished(body: string): boolean {
+  return body.trim() !== ''
+}
+
+export function buildLegalLinks(
+  bodyOf: (page: LegalPage) => string,
+  t: Translator = untranslated(),
+): readonly LinkModel[] {
+  return LEGAL_PAGES.filter((page) => isPublished(bodyOf(page))).map((page) => ({
+    label: t.t(page.footerLabelKey),
+    href: page.href,
+  }))
+}

package/src/view/locale.ts

@@ -0,0 +1,40 @@
+import { AUTOMATIC_LOCALE } from '@meith/accounts'
+import { type Locale, negotiateLocale, normaliseLocale, parseAcceptLanguage } from '@meith/i18n'
+
+export interface ResolvedLocale {
+  readonly locale: Locale
+  readonly isAutomatic: boolean
+}
+
+export function resolveLocale(input: {
+  readonly stored?: string | null | undefined
+  readonly accepted?: string | null | undefined
+  readonly boardDefault?: string | null | undefined
+  readonly supported: readonly Locale[]
+}): ResolvedLocale {
+  const fallback = normaliseLocale(input.boardDefault) ?? 'en'
+  const stored = input.stored ?? null
+
+  if (stored !== null && stored !== AUTOMATIC_LOCALE) {
+    const chosen = normaliseLocale(stored)
+    if (chosen !== null) {
+      return {
+        locale: negotiateLocale({
+          requested: [chosen],
+          supported: input.supported,
+          fallback,
+        }),
+        isAutomatic: false,
+      }
+    }
+  }
+
+  return {
+    locale: negotiateLocale({
+      requested: parseAcceptLanguage(input.accepted).map((entry) => entry.locale),
+      supported: input.supported,
+      fallback,
+    }),
+    isAutomatic: true,
+  }
+}

package/src/view/marketplace-panel.ts

@@ -0,0 +1,51 @@
+import type { Translator } from '@meith/i18n'
+import type { ListingStatus } from '@meith/marketplace'
+
+import type { ViewTab } from '@/components/shell/view-tabs'
+
+export type StatusTone = 'active' | 'muted' | 'warning' | 'destructive'
+
+export interface StatusBadge {
+  readonly label: string
+  readonly tone: StatusTone
+}
+
+const STATUS_KEYS: Readonly<Record<ListingStatus, string>> = {
+  active: 'adminMarketplace.status.active',
+  'installed-disabled': 'adminMarketplace.status.installedDisabled',
+  'not-installed': 'adminMarketplace.status.notInstalled',
+  'update-available': 'adminMarketplace.status.updateAvailable',
+  incompatible: 'adminMarketplace.status.incompatible',
+}
+
+const STATUS_TONES: Readonly<Record<ListingStatus, StatusTone>> = {
+  active: 'active',
+  'installed-disabled': 'muted',
+  'not-installed': 'muted',
+  'update-available': 'warning',
+  incompatible: 'destructive',
+}
+
+export function statusBadge(status: ListingStatus, t: Translator): StatusBadge {
+  return { label: t.t(STATUS_KEYS[status]), tone: STATUS_TONES[status] }
+}
+
+export function catalogTabs(input: {
+  readonly installedHref: string
+  readonly browseHref: string
+  readonly current: 'installed' | 'browse'
+  readonly t: Translator
+}): readonly ViewTab[] {
+  return [
+    {
+      href: input.installedHref,
+      label: input.t.t('adminMarketplace.tab.installed'),
+      isCurrent: input.current === 'installed',
+    },
+    {
+      href: input.browseHref,
+      label: input.t.t('adminMarketplace.tab.browse'),
+      isCurrent: input.current === 'browse',
+    },
+  ]
+}

package/src/view/member-identity.ts

@@ -0,0 +1,23 @@
+export interface MemberIdentity {
+  readonly groupId: number
+  readonly title: string
+  readonly nameClass: string | null
+  readonly badge: {
+    readonly src: string
+    readonly darkSrc: string | null
+    readonly alt: string
+  } | null
+  readonly reputation: number
+}
+
+export function nameClassOf(
+  identities: ReadonlyMap<number, MemberIdentity> | undefined,
+  userId: number | null,
+): string | null {
+  if (identities === undefined || userId === null) return null
+  return identities.get(userId)?.nameClass ?? null
+}
+
+export function distinctUserIds(ids: readonly (number | null)[]): readonly number[] {
+  return [...new Set(ids.filter((id): id is number => id !== null))]
+}

package/src/view/member-profile.ts

@@ -0,0 +1,65 @@
+import type { MemberProfileRecord } from '@meith/accounts'
+import type { Translator } from '@meith/i18n'
+import type { MemberProfileModel } from '@meith/theme-kit'
+
+import { count } from './count'
+import { formatDate, formatTime, untranslated } from './time'
+
+export function memberHref(userId: number): string {
+  return `/member/${userId}`
+}
+
+export function buildMemberProfileView(
+  profile: MemberProfileRecord,
+  now: Date,
+  options: {
+    readonly canWarn?: boolean
+    readonly t?: Translator
+    readonly customFields?: readonly { readonly label: string; readonly value: string }[]
+    readonly canMessage?: boolean
+    readonly avatarUrl?: string | null
+    readonly nameClass?: string | null
+  } = {},
+): MemberProfileModel {
+  const {
+    canWarn = false,
+    canMessage = false,
+    t = untranslated(),
+    customFields = [],
+    avatarUrl = null,
+    nameClass = null,
+  } = options
+  return {
+    user: {
+      userId: profile.id,
+      username: profile.username,
+      profileHref: memberHref(profile.id),
+      nameClass,
+    },
+    avatarUrl,
+    title: profile.title,
+    joinedAt: formatDate(profile.createdAt, t),
+    lastVisitAt: profile.lastActiveAt === null ? null : formatTime(profile.lastActiveAt, now, t),
+    postCount: count(profile.postCount, t),
+    signatureHtml: null,
+    fields: [
+      profile.location === null ? null : { label: 'Location', value: profile.location },
+      profile.website === null ? null : { label: 'Website', value: profile.website },
+      profile.bio === null ? null : { label: 'About', value: profile.bio },
+      ...customFields,
+    ].filter((field): field is { label: string; value: string } => field !== null),
+    actions: [
+      ...(canMessage
+        ? [
+            {
+              label: t.t('profile.sendMessage'),
+              href: `/messages/compose?to=${encodeURIComponent(profile.username)}`,
+            },
+          ]
+        : []),
+      ...(canWarn
+        ? [{ label: t.t('profile.warnMember'), href: `/moderation/warn?user=${profile.id}` }]
+        : []),
+    ],
+  }
+}