UNPKG

open-agreements

Version:

Open-source legal template filling CLI and library

157 lines • 6.81 kB
/** * Shared property builders: RunProps → w:rPr and paragraph formatting → w:pPr * child maps, used by both the body emitters (run.ts / paragraph.ts) and the * styles-part emitter so direct formatting and style definitions can never * drift apart. All children are routed through the ordering tables. */ import { createWmlElement } from '../../primitives/dom-helpers.js'; import { W } from '../../primitives/namespaces.js'; import { appendInOrder, PPR_ORDER, RPR_ORDER } from '../ordering.js'; const ALIGNMENT_TO_JC = { left: 'left', center: 'center', right: 'right', justify: 'both', }; /** * Build the ordered rPr children for a RunProps value. Returns null when no * property is set so callers can omit the rPr container entirely. * * Complex-script twins (bCs/iCs/szCs) and the full rFonts script coverage * (ascii + hAnsi + cs) are always emitted alongside their base properties so * all script ranges agree. * * @conformance ECMA-376 edition 5, Part 1 § 17.3.2.28 */ export function buildRunPropsElement(doc, props, opts) { const children = new Map(); if (props.font !== undefined) { children.set(W.rFonts, createWmlElement(doc, W.rFonts, { 'w:ascii': props.font, 'w:hAnsi': props.font, 'w:cs': props.font, })); } if (props.bold !== undefined) { children.set(W.b, createWmlElement(doc, W.b, props.bold ? undefined : { 'w:val': '0' })); children.set(W.bCs, createWmlElement(doc, W.bCs, props.bold ? undefined : { 'w:val': '0' })); } if (props.italic !== undefined) { children.set(W.i, createWmlElement(doc, W.i, props.italic ? undefined : { 'w:val': '0' })); children.set(W.iCs, createWmlElement(doc, W.iCs, props.italic ? undefined : { 'w:val': '0' })); } if (props.caps !== undefined) { children.set(W.caps, createWmlElement(doc, W.caps, props.caps ? undefined : { 'w:val': '0' })); } if (props.smallCaps !== undefined) { children.set(W.smallCaps, createWmlElement(doc, W.smallCaps, props.smallCaps ? undefined : { 'w:val': '0' })); } if (props.colorHex !== undefined || props.themeColor !== undefined) { const attrs = {}; if (props.colorHex !== undefined) attrs['w:val'] = props.colorHex; if (props.themeColor !== undefined) { attrs['w:themeColor'] = props.themeColor; const fallback = opts?.themeColorValues?.get(props.themeColor); if (fallback !== undefined && attrs['w:val'] === undefined) attrs['w:val'] = fallback; } if (props.themeTint !== undefined) attrs['w:themeTint'] = props.themeTint; if (props.themeShade !== undefined) attrs['w:themeShade'] = props.themeShade; children.set(W.color, createWmlElement(doc, W.color, attrs)); } if (props.sizePt !== undefined) { const halfPoints = String(Math.round(props.sizePt * 2)); children.set(W.sz, createWmlElement(doc, W.sz, { 'w:val': halfPoints })); children.set(W.szCs, createWmlElement(doc, W.szCs, { 'w:val': halfPoints })); } if (props.highlight !== undefined) { children.set(W.highlight, createWmlElement(doc, W.highlight, { 'w:val': props.highlight })); } if (props.underline !== undefined) { children.set(W.u, createWmlElement(doc, W.u, { 'w:val': props.underline })); } if (children.size === 0) return null; const rPr = createWmlElement(doc, W.rPr); appendInOrder(rPr, children, RPR_ORDER); return rPr; } /** * Build the ordered pPr children for a paragraph-formatting subset. Returns * null when nothing is set. The optional extras hook lets phase-specific * callers add already-built children (e.g. a section break sectPr) that * still go through the same ordering discipline. * * @conformance ECMA-376 edition 5, Part 1 § 17.3.1.26 */ export function buildParagraphPropsElement(doc, props, extras) { const children = new Map(); if (props.styleId !== undefined) { children.set(W.pStyle, createWmlElement(doc, W.pStyle, { 'w:val': props.styleId })); } if (props.keepNext) { children.set(W.keepNext, createWmlElement(doc, W.keepNext)); } if (props.keepLines) { children.set(W.keepLines, createWmlElement(doc, W.keepLines)); } if (props.pageBreakBefore) { children.set(W.pageBreakBefore, createWmlElement(doc, W.pageBreakBefore)); } if (props.tabs && props.tabs.length > 0) { const tabs = createWmlElement(doc, W.tabs); for (const stop of props.tabs) { const attrs = { 'w:val': stop.align, 'w:pos': String(stop.posTwips) }; if (stop.leader && stop.leader !== 'none') attrs['w:leader'] = stop.leader; tabs.appendChild(createWmlElement(doc, W.tab, attrs)); } children.set(W.tabs, tabs); } if (props.spacing) { const attrs = {}; if (props.spacing.beforeTwips !== undefined) attrs['w:before'] = String(props.spacing.beforeTwips); if (props.spacing.afterTwips !== undefined) attrs['w:after'] = String(props.spacing.afterTwips); if (props.spacing.lineTwips !== undefined) { attrs['w:line'] = String(props.spacing.lineTwips); attrs['w:lineRule'] = props.spacing.lineRule ?? 'auto'; } if (Object.keys(attrs).length > 0) children.set(W.spacing, createWmlElement(doc, W.spacing, attrs)); } if (props.indent) { const attrs = {}; if (props.indent.leftTwips !== undefined) attrs['w:left'] = String(props.indent.leftTwips); if (props.indent.rightTwips !== undefined) attrs['w:right'] = String(props.indent.rightTwips); if (props.indent.firstLineTwips !== undefined) attrs['w:firstLine'] = String(props.indent.firstLineTwips); if (props.indent.hangingTwips !== undefined) attrs['w:hanging'] = String(props.indent.hangingTwips); if (Object.keys(attrs).length > 0) children.set(W.ind, createWmlElement(doc, W.ind, attrs)); } if (props.alignment !== undefined) { children.set(W.jc, createWmlElement(doc, W.jc, { 'w:val': ALIGNMENT_TO_JC[props.alignment] })); } if (extras) { for (const [name, value] of extras) children.set(name, value); } if (children.size === 0) return null; const pPr = createWmlElement(doc, W.pPr); appendInOrder(pPr, children, PPR_ORDER); return pPr; } /** Paragraph-formatting subset of a StyleSpec, normalized for the builder. */ export function styleParagraphProps(style) { return { ...style.paragraph }; } //# sourceMappingURL=properties.js.map