Jakob Wennberg
ec27228a8e
Em dashes (—) and en dashes (–) had spread across comments, docs, tests, and a few UI strings, reading as AI-generated boilerplate rather than house style. Replaced each with punctuation matching its context: colon for explanatory clauses, comma for asides, plain hyphen for numeric/legal ranges (e.g. "21-23§"), "to"/"till" for date ranges, parentheses for paired-dash asides. messages/en.json and messages/sv.json were fixed by hand together to keep sv/en in sync. Left untouched where the dash is the functional subject rather than decorative punctuation: date-range-parser.ts's separator regex, charset-repair.ts's CP1252 byte-mapping table (and its test), the SIE encoding mojibake docs, generic-csv.ts's minus-sign normalizer, the agent system-prompt files that already instruct against em dashes, and a golden iXBRL test fixture compared byte-for-byte. Also fixes two bugs surfaced along the way: an off-by-one in ApiKeysPanel's scope-label split (a leftover from an earlier partial pass), and a charset-repair test that had lost the literal en-dash it exists to verify. Regenerated the agent atom seed migration (skills:generate) since 27 SKILL.md files changed. Added a CLAUDE.md rule against em/en dashes, with an explicit carve-out for the functional-dash cases above. Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>
84 lines
2.8 KiB
TypeScript
84 lines
2.8 KiB
TypeScript
/**
|
|
* Minimal XML/XHTML emission helpers for the iXBRL generator.
|
|
*
|
|
* Open decision #3 in the implementation plan (React renderToStaticMarkup vs
|
|
* dedicated builder) is resolved in favour of a dedicated builder: TA §3.2
|
|
* requires *valid XHTML* with only the five XML escape entities, and React's
|
|
* HTML serializer makes no such guarantee (named entities, void-element
|
|
* forms, attribute quirks). A hand-rolled escaper keeps the output auditable
|
|
* byte-for-byte against the official examples.
|
|
*/
|
|
|
|
/** Escape text content using only the five XML entities (TA §3.2.4). */
|
|
export function escapeText(value: string): string {
|
|
return value
|
|
.replace(/&/g, '&')
|
|
.replace(/</g, '<')
|
|
.replace(/>/g, '>')
|
|
}
|
|
|
|
/** Escape an attribute value (double-quoted attributes). */
|
|
export function escapeAttr(value: string): string {
|
|
return value
|
|
.replace(/&/g, '&')
|
|
.replace(/</g, '<')
|
|
.replace(/>/g, '>')
|
|
.replace(/"/g, '"')
|
|
}
|
|
|
|
export type Attrs = Record<string, string | number | null | undefined>
|
|
|
|
export function attrString(attrs: Attrs): string {
|
|
const parts: string[] = []
|
|
for (const [key, value] of Object.entries(attrs)) {
|
|
if (value === null || value === undefined) continue
|
|
parts.push(`${key}="${escapeAttr(String(value))}"`)
|
|
}
|
|
return parts.length > 0 ? ' ' + parts.join(' ') : ''
|
|
}
|
|
|
|
export function el(tag: string, attrs: Attrs, children: string): string {
|
|
return `<${tag}${attrString(attrs)}>${children}</${tag}>`
|
|
}
|
|
|
|
export function selfClosing(tag: string, attrs: Attrs): string {
|
|
return `<${tag}${attrString(attrs)}/>`
|
|
}
|
|
|
|
/**
|
|
* Turn user-authored multi-line text into XHTML paragraphs. Blank lines split
|
|
* paragraphs; single newlines become <br/>. All content is escaped.
|
|
*/
|
|
export function paragraphs(text: string, className?: string): string {
|
|
const classAttr = className ? ` class="${escapeAttr(className)}"` : ''
|
|
return text
|
|
.split(/\r?\n\s*\r?\n/)
|
|
.map((block) => block.trim())
|
|
.filter((block) => block.length > 0)
|
|
.map(
|
|
(block) =>
|
|
`<p${classAttr}>${block
|
|
.split(/\r?\n/)
|
|
.map((line) => escapeText(line))
|
|
.join('<br/>')}</p>`,
|
|
)
|
|
.join('\n')
|
|
}
|
|
|
|
/**
|
|
* Format a whole-SEK amount for ixt:numspacecomma: groups of three digits
|
|
* separated by REGULAR spaces (U+0020; NBSP fails the transform regex).
|
|
* The sign is never part of the transformed text: negative handling lives
|
|
* on the ix:nonFraction `sign` attribute / presentational minus outside.
|
|
*/
|
|
export function formatSekAbs(value: number): string {
|
|
const abs = Math.abs(Math.round(value))
|
|
return abs.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ' ')
|
|
}
|
|
|
|
/** Percent with one decimal for ixt:numspacecomma ("35,5"). */
|
|
export function formatPercentAbs(value: number): string {
|
|
const abs = Math.abs(value)
|
|
return abs.toFixed(1).replace('.', ',')
|
|
}
|