Files
accounted/lib/articles/currency-scope.ts
T
Jakob Wennberg f5697cfc2f feat(articles): filter the article register by currency (#1229)
Non-SEK article prices became first-class in #1166, so a mixed register needs a
way to look at one currency at a time (user request, christian@odinaero.se
2026-07-25).

- ContextPicker chip far right in the toolbar (convention 8), options = the
  currencies actually present in the register, default "Alla valutor". A
  single-currency register does not render it: a control with one meaningful
  position is noise.
- The scope lives in the URL alongside sort/dir, so a filtered register survives
  opening an article and coming back, and can be linked to. A code that is not
  in the register (last EUR article deleted, hand-edited link) falls back to
  "Alla" instead of hiding every row.
- Search and scope combine, and the no-matches copy names the scope when one is
  active: otherwise "no articles match X" reads as a claim about the whole
  register when it is only true inside the current currency.
- Predicates live in lib/articles/currency-scope.ts with unit tests; blank and
  legacy-null currencies fold into SEK the way the price column already
  displays them.

New strings in both messages/sv.json and messages/en.json. npm test 11369
passed, lint 0 errors, no new tsc errors. Chip screenshotted against the design
system via a temporary sandbox route.

Closes #1189

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-07-27 14:39:13 +02:00

66 lines
2.3 KiB
TypeScript

/**
* Currency scoping for the article register (#1189).
*
* Article prices became first-class in non-SEK currencies (#1166), so a mixed
* register needs a way to look at one currency at a time. The scope is offered
* as a ContextPicker chip and lives in the URL, which means it arrives as
* untrusted text: everything here treats an unknown or stale code as "no
* scope" rather than as a filter that hides every row.
*/
/** Sentinel for "no currency scope". Kept out of the URL when it is the value. */
export const ALL_CURRENCIES = 'all'
/**
* The register's own default. Rows written before multi-currency support, and
* any row with a blank currency, are SEK: pricing in Sweden without saying so
* means kronor.
*/
export const DEFAULT_CURRENCY = 'SEK'
interface CurrencyBearingArticle {
currency?: string | null
}
/** Normalized currency code of one article. */
export function articleCurrency(article: CurrencyBearingArticle): string {
return (article.currency || DEFAULT_CURRENCY).toUpperCase()
}
/**
* The currencies actually present in the register, SEK first and the rest
* alphabetically. Only these may be offered: a picker listing currencies
* nobody priced anything in would filter to an empty table.
*/
export function listArticleCurrencies(articles: CurrencyBearingArticle[]): string[] {
const present = new Set(articles.map(articleCurrency))
return [...present].sort((a, b) => {
if (a === DEFAULT_CURRENCY) return -1
if (b === DEFAULT_CURRENCY) return 1
return a.localeCompare(b)
})
}
/**
* Resolve the scope to apply from the URL parameter. A code that is not in the
* register (last EUR article deleted, hand-edited or shared link) falls back to
* ALL_CURRENCIES: showing everything is recoverable, showing nothing reads as
* data loss.
*/
export function resolveCurrencyScope(
param: string | null | undefined,
availableCurrencies: string[],
): string {
if (!param) return ALL_CURRENCIES
const normalized = param.toUpperCase()
return availableCurrencies.includes(normalized) ? normalized : ALL_CURRENCIES
}
/** True when the article belongs in the given scope. */
export function matchesCurrencyScope(
article: CurrencyBearingArticle,
scope: string,
): boolean {
return scope === ALL_CURRENCIES || articleCurrency(article) === scope
}