@better-forge/ui 0.1.0 → 0.1.1

package/src/lib/changelog.ts

@@ -1,93 +1,93 @@
-export interface ReleaseItem {
-  title: string
-  summary: string
-}
-
-export interface ReleaseGroup {
-  heading: string
-  items: ReleaseItem[]
-}
-
-export interface ReleaseNotes {
-  version: string
-  date: string
-  groups: ReleaseGroup[]
-}
-
-const RELEASE_HEADING = /^## \[(\d+\.\d+\.\d+)\](?: - (\S+))?\s*$/
-const GROUP_HEADING = /^### (.+?)\s*$/
-const ITEM = /^- (?:\*\*(.+?)\*\*:?\s*)?(.*)$/
-
-function plain(text: string): string {
-  return text.replace(/\[([^\]]+)\]\([^)]*\)/g, '$1').replace(/[`*]/g, '').trim()
-}
-
-function firstSentence(text: string): string {
-  const match = /^(.+?[.!?])(?:\s|$)/.exec(text)
-  return plain(match ? match[1]! : text)
-}
-
-/**
- * Released sections of docs/changelog.md, newest first; each top-level bullet is cut down to its bold title and
- * the first sentence of its text. The Unreleased section and nested bullets are left out.
- */
-export function parseChangelog(markdown: string): ReleaseNotes[] {
-  const releases: ReleaseNotes[] = []
-  let release: ReleaseNotes | null = null
-  let group: ReleaseGroup | null = null
-  for (const line of markdown.split(/\r?\n/)) {
-    const releaseMatch = RELEASE_HEADING.exec(line)
-    if (releaseMatch) {
-      release = { version: releaseMatch[1]!, date: releaseMatch[2] ?? '', groups: [] }
-      releases.push(release)
-      group = null
-    } else if (line.startsWith('## ')) {
-      release = null
-    } else if (release) {
-      const groupMatch = GROUP_HEADING.exec(line)
-      if (groupMatch) {
-        group = { heading: groupMatch[1]!, items: [] }
-        release.groups.push(group)
-        continue
-      }
-      const item = group ? ITEM.exec(line) : null
-      if (item && group) group.items.push({ title: plain(item[1] ?? ''), summary: firstSentence(item[2] ?? '') })
-    }
-  }
-  return releases.map((r) => ({ ...r, groups: r.groups.filter((g) => g.items.length > 0) }))
-}
-
-/** Negative, zero or positive like a sort comparator; plain x.y.z versions only. */
-export function compareVersions(a: string, b: string): number {
-  const left = a.split('.').map(Number)
-  const right = b.split('.').map(Number)
-  for (let i = 0; i < 3; i++) {
-    const diff = (left[i] ?? 0) - (right[i] ?? 0)
-    if (diff !== 0) return diff
-  }
-  return 0
-}
-
-/** Releases after `seen` up to and including `current`, newest first. */
-export function releasesBetween(releases: ReleaseNotes[], seen: string, current: string): ReleaseNotes[] {
-  return releases.filter((r) => compareVersions(r.version, seen) > 0 && compareVersions(r.version, current) <= 0)
-}
-
-export interface ReleaseSummary {
-  version: string
-  added: ReleaseItem[]
-  /** Changed, Removed and any other kind of entry that is not new or a fix. */
-  changed: ReleaseItem[]
-  fixed: ReleaseItem[]
-}
-
-/** One release sorted by the kind of change; fixes are only counted. */
-export function summarizeRelease(release: ReleaseNotes): ReleaseSummary {
-  const summary: ReleaseSummary = { version: release.version, added: [], changed: [], fixed: [] }
-  for (const group of release.groups) {
-    if (group.heading === 'Added') summary.added.push(...group.items)
-    else if (group.heading === 'Fixed') summary.fixed.push(...group.items)
-    else summary.changed.push(...group.items)
-  }
-  return summary
-}
+export interface ReleaseItem {
+  title: string
+  summary: string
+}
+
+export interface ReleaseGroup {
+  heading: string
+  items: ReleaseItem[]
+}
+
+export interface ReleaseNotes {
+  version: string
+  date: string
+  groups: ReleaseGroup[]
+}
+
+const RELEASE_HEADING = /^## \[(\d+\.\d+\.\d+)\](?: - (\S+))?\s*$/
+const GROUP_HEADING = /^### (.+?)\s*$/
+const ITEM = /^- (?:\*\*(.+?)\*\*:?\s*)?(.*)$/
+
+function plain(text: string): string {
+  return text.replace(/\[([^\]]+)\]\([^)]*\)/g, '$1').replace(/[`*]/g, '').trim()
+}
+
+function firstSentence(text: string): string {
+  const match = /^(.+?[.!?])(?:\s|$)/.exec(text)
+  return plain(match ? match[1]! : text)
+}
+
+/**
+ * Released sections of docs/changelog.md, newest first; each top-level bullet is cut down to its bold title and
+ * the first sentence of its text. The Unreleased section and nested bullets are left out.
+ */
+export function parseChangelog(markdown: string): ReleaseNotes[] {
+  const releases: ReleaseNotes[] = []
+  let release: ReleaseNotes | null = null
+  let group: ReleaseGroup | null = null
+  for (const line of markdown.split(/\r?\n/)) {
+    const releaseMatch = RELEASE_HEADING.exec(line)
+    if (releaseMatch) {
+      release = { version: releaseMatch[1]!, date: releaseMatch[2] ?? '', groups: [] }
+      releases.push(release)
+      group = null
+    } else if (line.startsWith('## ')) {
+      release = null
+    } else if (release) {
+      const groupMatch = GROUP_HEADING.exec(line)
+      if (groupMatch) {
+        group = { heading: groupMatch[1]!, items: [] }
+        release.groups.push(group)
+        continue
+      }
+      const item = group ? ITEM.exec(line) : null
+      if (item && group) group.items.push({ title: plain(item[1] ?? ''), summary: firstSentence(item[2] ?? '') })
+    }
+  }
+  return releases.map((r) => ({ ...r, groups: r.groups.filter((g) => g.items.length > 0) }))
+}
+
+/** Negative, zero or positive like a sort comparator; plain x.y.z versions only. */
+export function compareVersions(a: string, b: string): number {
+  const left = a.split('.').map(Number)
+  const right = b.split('.').map(Number)
+  for (let i = 0; i < 3; i++) {
+    const diff = (left[i] ?? 0) - (right[i] ?? 0)
+    if (diff !== 0) return diff
+  }
+  return 0
+}
+
+/** Releases after `seen` up to and including `current`, newest first. */
+export function releasesBetween(releases: ReleaseNotes[], seen: string, current: string): ReleaseNotes[] {
+  return releases.filter((r) => compareVersions(r.version, seen) > 0 && compareVersions(r.version, current) <= 0)
+}
+
+export interface ReleaseSummary {
+  version: string
+  added: ReleaseItem[]
+  /** Changed, Removed and any other kind of entry that is not new or a fix. */
+  changed: ReleaseItem[]
+  fixed: ReleaseItem[]
+}
+
+/** One release sorted by the kind of change; fixes are only counted. */
+export function summarizeRelease(release: ReleaseNotes): ReleaseSummary {
+  const summary: ReleaseSummary = { version: release.version, added: [], changed: [], fixed: [] }
+  for (const group of release.groups) {
+    if (group.heading === 'Added') summary.added.push(...group.items)
+    else if (group.heading === 'Fixed') summary.fixed.push(...group.items)
+    else summary.changed.push(...group.items)
+  }
+  return summary
+}

package/src/lib/dateFormat.ts

@@ -1,90 +1,90 @@
-import { safeLocalStorage } from '@better-forge/contracts'
-import { useSyncExternalStore } from 'react'
-import { storageKey } from '../config'
-
-/** Admin date and time display, chosen per browser in Settings. */
-export type DateFormat = 'dmy' | 'dmyDash' | 'mdy' | 'ymd' | 'ymdDot'
-export type TimeFormat = '24h' | '12h'
-export interface DatePrefs { date: DateFormat; time: TimeFormat }
-
-interface DatePattern { label: string; full: (y: number, m: string, d: string) => string; dayMonth: (m: string, d: string) => string }
-
-const DATE_PATTERNS: Record<DateFormat, DatePattern> = {
-  dmy: { label: 'dd.mm.yyyy', full: (y, m, d) => `${d}.${m}.${y}`, dayMonth: (m, d) => `${d}.${m}` },
-  dmyDash: { label: 'dd-mm-yyyy', full: (y, m, d) => `${d}-${m}-${y}`, dayMonth: (m, d) => `${d}-${m}` },
-  mdy: { label: 'mm/dd/yyyy', full: (y, m, d) => `${m}/${d}/${y}`, dayMonth: (m, d) => `${m}/${d}` },
-  ymd: { label: 'yyyy-mm-dd', full: (y, m, d) => `${y}-${m}-${d}`, dayMonth: (m, d) => `${m}-${d}` },
-  ymdDot: { label: 'yyyy.mm.dd', full: (y, m, d) => `${y}.${m}.${d}`, dayMonth: (m, d) => `${m}.${d}` },
-}
-
-export const DATE_FORMATS = (Object.keys(DATE_PATTERNS) as DateFormat[]).map((value) => ({ value, label: DATE_PATTERNS[value].label }))
-export const TIME_FORMATS: ReadonlyArray<{ value: TimeFormat; label: string }> = [
-  { value: '24h', label: '24-hour' },
-  { value: '12h', label: '12-hour' },
-]
-
-const DEFAULTS: DatePrefs = { date: 'dmy', time: '24h' }
-
-function load(): DatePrefs {
-  try {
-    const raw = JSON.parse(safeLocalStorage.get(storageKey('date-format')) ?? 'null') as Partial<DatePrefs> | null
-    return {
-      date: DATE_FORMATS.some((f) => f.value === raw?.date) ? raw!.date! : DEFAULTS.date,
-      time: TIME_FORMATS.some((f) => f.value === raw?.time) ? raw!.time! : DEFAULTS.time,
-    }
-  } catch {
-    return DEFAULTS
-  }
-}
-
-let prefs: DatePrefs | null = null
-const listeners = new Set<() => void>()
-
-export function getDatePrefs(): DatePrefs { return (prefs ??= load()) }
-
-export function setDatePrefs(next: DatePrefs): void {
-  prefs = next
-  safeLocalStorage.set(storageKey('date-format'), JSON.stringify(next))
-  listeners.forEach((listener) => listener())
-}
-
-function subscribe(listener: () => void): () => void {
-  listeners.add(listener)
-  return () => { listeners.delete(listener) }
-}
-
-export function useDatePrefs(): DatePrefs {
-  return useSyncExternalStore(subscribe, getDatePrefs)
-}
-
-const pad = (n: number): string => String(n).padStart(2, '0')
-
-/** `utc` formats the UTC calendar day instead of the local one (for UTC-bucketed data). */
-export function formatDate(ms: number, utc = false): string {
-  const d = new Date(ms)
-  return DATE_PATTERNS[getDatePrefs().date].full(
-    utc ? d.getUTCFullYear() : d.getFullYear(),
-    pad((utc ? d.getUTCMonth() : d.getMonth()) + 1),
-    pad(utc ? d.getUTCDate() : d.getDate()),
-  )
-}
-
-export function formatDayMonth(ms: number): string {
-  const d = new Date(ms)
-  return DATE_PATTERNS[getDatePrefs().date].dayMonth(pad(d.getMonth() + 1), pad(d.getDate()))
-}
-
-export function formatClock(ms: number, seconds = false): string {
-  const d = new Date(ms)
-  const mm = pad(d.getMinutes())
-  const ss = seconds ? `:${pad(d.getSeconds())}` : ''
-  if (getDatePrefs().time === '12h') {
-    const h = d.getHours()
-    return `${h % 12 || 12}:${mm}${ss} ${h < 12 ? 'AM' : 'PM'}`
-  }
-  return `${pad(d.getHours())}:${mm}${ss}`
-}
-
-export function formatDateTime(ms: number, seconds = false): string {
-  return `${formatDate(ms)} ${formatClock(ms, seconds)}`
-}
+import { safeLocalStorage } from '@better-forge/contracts'
+import { useSyncExternalStore } from 'react'
+import { storageKey } from '../config'
+
+/** Admin date and time display, chosen per browser in Settings. */
+export type DateFormat = 'dmy' | 'dmyDash' | 'mdy' | 'ymd' | 'ymdDot'
+export type TimeFormat = '24h' | '12h'
+export interface DatePrefs { date: DateFormat; time: TimeFormat }
+
+interface DatePattern { label: string; full: (y: number, m: string, d: string) => string; dayMonth: (m: string, d: string) => string }
+
+const DATE_PATTERNS: Record<DateFormat, DatePattern> = {
+  dmy: { label: 'dd.mm.yyyy', full: (y, m, d) => `${d}.${m}.${y}`, dayMonth: (m, d) => `${d}.${m}` },
+  dmyDash: { label: 'dd-mm-yyyy', full: (y, m, d) => `${d}-${m}-${y}`, dayMonth: (m, d) => `${d}-${m}` },
+  mdy: { label: 'mm/dd/yyyy', full: (y, m, d) => `${m}/${d}/${y}`, dayMonth: (m, d) => `${m}/${d}` },
+  ymd: { label: 'yyyy-mm-dd', full: (y, m, d) => `${y}-${m}-${d}`, dayMonth: (m, d) => `${m}-${d}` },
+  ymdDot: { label: 'yyyy.mm.dd', full: (y, m, d) => `${y}.${m}.${d}`, dayMonth: (m, d) => `${m}.${d}` },
+}
+
+export const DATE_FORMATS = (Object.keys(DATE_PATTERNS) as DateFormat[]).map((value) => ({ value, label: DATE_PATTERNS[value].label }))
+export const TIME_FORMATS: ReadonlyArray<{ value: TimeFormat; label: string }> = [
+  { value: '24h', label: '24-hour' },
+  { value: '12h', label: '12-hour' },
+]
+
+const DEFAULTS: DatePrefs = { date: 'dmy', time: '24h' }
+
+function load(): DatePrefs {
+  try {
+    const raw = JSON.parse(safeLocalStorage.get(storageKey('date-format')) ?? 'null') as Partial<DatePrefs> | null
+    return {
+      date: DATE_FORMATS.some((f) => f.value === raw?.date) ? raw!.date! : DEFAULTS.date,
+      time: TIME_FORMATS.some((f) => f.value === raw?.time) ? raw!.time! : DEFAULTS.time,
+    }
+  } catch {
+    return DEFAULTS
+  }
+}
+
+let prefs: DatePrefs | null = null
+const listeners = new Set<() => void>()
+
+export function getDatePrefs(): DatePrefs { return (prefs ??= load()) }
+
+export function setDatePrefs(next: DatePrefs): void {
+  prefs = next
+  safeLocalStorage.set(storageKey('date-format'), JSON.stringify(next))
+  listeners.forEach((listener) => listener())
+}
+
+function subscribe(listener: () => void): () => void {
+  listeners.add(listener)
+  return () => { listeners.delete(listener) }
+}
+
+export function useDatePrefs(): DatePrefs {
+  return useSyncExternalStore(subscribe, getDatePrefs)
+}
+
+const pad = (n: number): string => String(n).padStart(2, '0')
+
+/** `utc` formats the UTC calendar day instead of the local one (for UTC-bucketed data). */
+export function formatDate(ms: number, utc = false): string {
+  const d = new Date(ms)
+  return DATE_PATTERNS[getDatePrefs().date].full(
+    utc ? d.getUTCFullYear() : d.getFullYear(),
+    pad((utc ? d.getUTCMonth() : d.getMonth()) + 1),
+    pad(utc ? d.getUTCDate() : d.getDate()),
+  )
+}
+
+export function formatDayMonth(ms: number): string {
+  const d = new Date(ms)
+  return DATE_PATTERNS[getDatePrefs().date].dayMonth(pad(d.getMonth() + 1), pad(d.getDate()))
+}
+
+export function formatClock(ms: number, seconds = false): string {
+  const d = new Date(ms)
+  const mm = pad(d.getMinutes())
+  const ss = seconds ? `:${pad(d.getSeconds())}` : ''
+  if (getDatePrefs().time === '12h') {
+    const h = d.getHours()
+    return `${h % 12 || 12}:${mm}${ss} ${h < 12 ? 'AM' : 'PM'}`
+  }
+  return `${pad(d.getHours())}:${mm}${ss}`
+}
+
+export function formatDateTime(ms: number, seconds = false): string {
+  return `${formatDate(ms)} ${formatClock(ms, seconds)}`
+}

package/src/navigation.ts

@@ -1,6 +1,6 @@
-/** Full-page navigation, kept in one object so tests can observe it (jsdom cannot navigate). */
-export const navigation = {
-  assign(url: string): void {
-    window.location.assign(url)
-  },
-}
+/** Full-page navigation, kept in one object so tests can observe it (jsdom cannot navigate). */
+export const navigation = {
+  assign(url: string): void {
+    window.location.assign(url)
+  },
+}