5b5ee8e429
* feat(ui): shared migration primitives (UI migration PR 3) The component kit every page migration (PR 4-8) builds on: - ContextPicker: the one-per-page chip-dropdown context scope (convention 8), right-aligned popover with checks and muted annotations - FyPicker: fiscal-year picker on ContextPicker with the same controlled API and per-company localStorage key as FiscalYearSelector, which it replaces page by page from PR 4 - SplitButton: primary + caret menu, last-used mode persisted per user via ui_state.create_mode (lib/ui-state/client, unit-tested); nav persistence refactored onto the same helper - ConfirmDialog: centered min-460px confirm-up-front dialog (convention 10) with pending state on an awaitable onConfirm - HelpPopover: 17px "?" after the H1 opening an anchored popover (convention 7); PageHeader gets a `help` slot - AttnLine: the one-ochre-sentence attention pattern (convention 6) with optional inline action; new AA-safe --attn token pair - RowStatus: chips-mark-exceptions helper (convention 5) - SlideOver: right review panel, 480px, 18px inset, rounded, veil + Esc (convention 13), with header kicker / body / footer slots - Stagger: .stagger-enter applied to the five target pages' list containers (bookkeeping, transactions, pending, invoices, supplier-invoices); structural loading.tsx added for supplier-invoices, customers, kpi, pending, deadlines No page adopts the new pickers/dialogs yet: that is PR 4-8, one page per PR against this kit. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * fix(ui): FyPicker chip must not double the Rakenskapsar label Real fiscal periods are often named "Rakenskapsar 2026" already; only prefix the label when the period name lacks it. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> --------- Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
163 lines
5.5 KiB
TypeScript
163 lines
5.5 KiB
TypeScript
'use client'
|
|
|
|
import { useEffect, useState } from 'react'
|
|
import { useTranslations } from 'next-intl'
|
|
import { useCompany } from '@/contexts/CompanyContext'
|
|
import { ContextPicker } from '@/components/common/ContextPicker'
|
|
import {
|
|
STORAGE_KEY_PREFIX,
|
|
ALL_YEARS_VALUE,
|
|
} from '@/components/common/FiscalYearSelector'
|
|
import type { FiscalPeriod } from '@/types'
|
|
|
|
interface FyPickerProps {
|
|
/** Current selection. `null` means "all years": no filter applied. */
|
|
value: string | null
|
|
/**
|
|
* Called with the selected period id (or null for "all years") and the
|
|
* matching FiscalPeriod so callers avoid an extra fetch.
|
|
*/
|
|
onChange: (periodId: string | null, period?: FiscalPeriod | null) => void
|
|
/** Include an "Alla räkenskapsår" option that clears the filter. */
|
|
includeAllOption?: boolean
|
|
/** Only show periods that have started (Reports-style filter). */
|
|
hideFuturePeriods?: boolean
|
|
/** Fires once after the initial period load completes. */
|
|
onReady?: () => void
|
|
/** Server-loaded periods for the first render, scoped to initialCompanyId. */
|
|
initialPeriods?: FiscalPeriod[]
|
|
initialCompanyId?: string | null
|
|
className?: string
|
|
}
|
|
|
|
function preparePeriods(periods: FiscalPeriod[], hideFuturePeriods: boolean): FiscalPeriod[] {
|
|
const today = new Date().toISOString().split('T')[0]
|
|
return periods
|
|
.filter((p) => !hideFuturePeriods || p.period_start <= today)
|
|
.sort((a, b) => b.period_start.localeCompare(a.period_start))
|
|
}
|
|
|
|
/**
|
|
* Fiscal-year context picker (UI-migration plan PR 3): the chip-dropdown
|
|
* "Räkenskapsår 2026" with a check on the active choice and closed/locked
|
|
* years annotated. Same controlled API and per-company localStorage
|
|
* persistence as FiscalYearSelector, which it replaces page by page from
|
|
* PR 4 on.
|
|
*/
|
|
export function FyPicker({
|
|
value,
|
|
onChange,
|
|
includeAllOption = true,
|
|
hideFuturePeriods = false,
|
|
onReady,
|
|
initialPeriods,
|
|
initialCompanyId,
|
|
className,
|
|
}: FyPickerProps) {
|
|
const { company } = useCompany()
|
|
const t = useTranslations('fiscal_year')
|
|
const canUseInitial = initialCompanyId === company?.id && initialPeriods !== undefined
|
|
const [periods, setPeriods] = useState<FiscalPeriod[]>(() =>
|
|
canUseInitial ? preparePeriods(initialPeriods, hideFuturePeriods) : [],
|
|
)
|
|
const [loaded, setLoaded] = useState(canUseInitial)
|
|
|
|
useEffect(() => {
|
|
if (!company?.id) {
|
|
onReady?.()
|
|
return
|
|
}
|
|
let cancelled = false
|
|
;(async () => {
|
|
let fetched: FiscalPeriod[]
|
|
if (initialCompanyId === company.id && initialPeriods !== undefined) {
|
|
fetched = preparePeriods(initialPeriods, hideFuturePeriods)
|
|
} else {
|
|
const res = await fetch('/api/bookkeeping/fiscal-periods')
|
|
if (!res.ok) {
|
|
if (!cancelled) {
|
|
setLoaded(true)
|
|
onReady?.()
|
|
}
|
|
return
|
|
}
|
|
const { data } = await res.json()
|
|
fetched = preparePeriods(data || [], hideFuturePeriods)
|
|
}
|
|
if (cancelled) return
|
|
|
|
setPeriods(fetched)
|
|
setLoaded(true)
|
|
|
|
// Restore last selection (same key as FiscalYearSelector so pages keep
|
|
// their scope when the picker swaps in).
|
|
if (value === null && typeof window !== 'undefined') {
|
|
const stored = window.localStorage.getItem(STORAGE_KEY_PREFIX + company.id)
|
|
if (stored === ALL_YEARS_VALUE) {
|
|
if (includeAllOption) onChange(null, null)
|
|
else if (fetched.length > 0) onChange(fetched[0].id, fetched[0])
|
|
} else if (stored && fetched.some((p) => p.id === stored)) {
|
|
onChange(stored, fetched.find((p) => p.id === stored) ?? null)
|
|
} else if (!includeAllOption && fetched.length > 0) {
|
|
onChange(fetched[0].id, fetched[0])
|
|
}
|
|
}
|
|
|
|
onReady?.()
|
|
})()
|
|
return () => {
|
|
cancelled = true
|
|
}
|
|
// onReady is a lifecycle callback: fire once per load, not on parent
|
|
// re-renders that re-create it.
|
|
// eslint-disable-next-line react-hooks/exhaustive-deps
|
|
}, [company?.id, hideFuturePeriods, includeAllOption, initialCompanyId, initialPeriods])
|
|
|
|
const handleChange = (id: string) => {
|
|
const nextId = id === ALL_YEARS_VALUE ? null : id
|
|
if (company?.id && typeof window !== 'undefined') {
|
|
window.localStorage.setItem(STORAGE_KEY_PREFIX + company.id, nextId ?? ALL_YEARS_VALUE)
|
|
}
|
|
onChange(nextId, nextId ? periods.find((p) => p.id === nextId) ?? null : null)
|
|
}
|
|
|
|
const annotationFor = (p: FiscalPeriod) =>
|
|
p.locked_at ? t('badge_locked').toLowerCase() : p.is_closed ? t('badge_closed').toLowerCase() : undefined
|
|
|
|
const selected = value ? periods.find((p) => p.id === value) : null
|
|
// Real period names often already read "Räkenskapsår 2026"; only prefix
|
|
// the label when the name is a bare year/name so the chip never doubles up.
|
|
const chipLabel = (p: FiscalPeriod) =>
|
|
p.name.toLowerCase().includes(t('label').toLowerCase())
|
|
? p.name
|
|
: `${t('label')} ${p.name}`
|
|
const triggerLabel = selected
|
|
? chipLabel(selected)
|
|
: includeAllOption
|
|
? t('all_years')
|
|
: loaded
|
|
? t('placeholder')
|
|
: t('loading')
|
|
|
|
const items = [
|
|
...(includeAllOption ? [{ id: ALL_YEARS_VALUE, label: t('all_years') }] : []),
|
|
...periods.map((p) => ({
|
|
id: p.id,
|
|
label: p.name,
|
|
annotation: annotationFor(p),
|
|
})),
|
|
]
|
|
|
|
return (
|
|
<ContextPicker
|
|
items={items}
|
|
value={value ?? (includeAllOption ? ALL_YEARS_VALUE : null)}
|
|
onChange={handleChange}
|
|
triggerLabel={triggerLabel}
|
|
disabled={!loaded || periods.length === 0}
|
|
ariaLabel={t('label')}
|
|
className={className}
|
|
/>
|
|
)
|
|
}
|