@office-open/docx 0.9.2 → 0.9.3

package/dist/{context-CERMOUn0.mjs → context-DeKZoZem.mjs}

@@ -1,6 +1,6 @@
-import { A as stringifyParagraphProperties, D as stringifyChildDispatch, E as tableDesc, F as parseDrawingRun, M as parseMathChildren, O as stringifyParagraphInline, Y as BorderStyle, at as Media, j as stringifyRunProperties, n as sectionPropertiesDesc, ot as createTransformation } from "./document-CeM-U6J3.mjs";
+import { A as stringifyParagraphProperties, D as stringifyChildDispatch, E as tableDesc, F as parseDrawingRun, M as parseMathChildren, O as stringifyParagraphInline, Y as BorderStyle, ct as Media, et as parseFormFieldData, j as stringifyRunProperties, lt as createTransformation, n as sectionPropertiesDesc } from "./document-D8HDkCHs.mjs";
 import { Relationships, convertInchesToTwip, decimalNumber, derivePasswordHash, hexColorValue, toUint8Array, uCharHexNumber, uniqueId, uniqueNumericIdCreator, uniqueUuid } from "@office-open/core";
-import { attr, attrBool, attrNum, children, colorAttr, element, escapeXml, findChild, js2xml, textOf, xml2js } from "@office-open/xml";
+import { attr, attrBool, attrNum, children, colorAttr, escapeXml, findChild, js2xml, textOf, xml2js } from "@office-open/xml";
 import { ChartCollection } from "@office-open/core/chart";
 import { SmartArtCollection } from "@office-open/core/smartart";
 //#region src/parts/paragraph/formatting/alignment.ts
@@ -440,154 +440,6 @@ const RubyAlign = {
 	RIGHT_VERTICAL: "rightVertical"
 };
 //#endregion
-//#region src/parts/paragraph/run/form-field.ts
-/**
-* Form field module for WordprocessingML documents.
-*
-* Form fields allow creating interactive controls (checkboxes, dropdown lists,
-* text inputs) within a document. Each form field is wrapped in a field code
-* region delimited by fldChar elements (begin/separate/end), with ffData
-* attached to the begin fldChar.
-*
-* Reference: ISO/IEC 29500-4, wml.xsd, CT_FFData, CT_FFCheckBox, CT_FFDDList, CT_FFTextInput
-*
-* @module
-*/
-/**
-* Text input field type (ST_FFTextType).
-*
-* ## XSD Schema
-* ```xml
-* <xsd:simpleType name="ST_FFTextType">
-*   <xsd:restriction base="xsd:string">
-*     <xsd:enumeration value="regular"/>
-*     <xsd:enumeration value="number"/>
-*     <xsd:enumeration value="date"/>
-*     <xsd:enumeration value="currentTime"/>
-*     <xsd:enumeration value="currentDate"/>
-*     <xsd:enumeration value="calculated"/>
-*   </xsd:restriction>
-* </xsd:simpleType>
-* ```
-*/
-const FormFieldTextType = {
-	/** Regular text input */
-	REGULAR: "regular",
-	/** Numeric input */
-	NUMBER: "number",
-	/** Date input */
-	DATE: "date",
-	/** Current time */
-	CURRENT_TIME: "currentTime",
-	/** Current date */
-	CURRENT_DATE: "currentDate",
-	/** Calculated value */
-	CALCULATED: "calculated"
-};
-/** Build a w:val-style element with a single attribute. */
-const valElement = (name, val) => `<${name} w:val="${val}"/>`;
-/**
-* Creates a help or status text element.
-*/
-const createFormFieldText = (name, options) => `<${name} w:type="${options.type}" w:val="${options.value}"/>`;
-/**
-* Creates a checkbox form field element (w:checkBox).
-*/
-const createCheckBox = (options) => {
-	const children = [];
-	if (options.size !== void 0) children.push(valElement("w:size", options.size));
-	else if (options.sizeAuto !== void 0) children.push(`<w:sizeAuto/>`);
-	if (options.default !== void 0) children.push(`<w:default/>`);
-	if (options.checked !== void 0) children.push(`<w:checked/>`);
-	return element("w:checkBox", void 0, children);
-};
-/**
-* Creates a dropdown list form field element (w:ddList).
-*/
-const createDropDownList = (options) => {
-	const children = [];
-	if (options.result !== void 0) children.push(valElement("w:result", options.result));
-	if (options.default !== void 0) children.push(valElement("w:default", options.default));
-	for (const entry of options.entries) children.push(valElement("w:listEntry", entry));
-	return element("w:ddList", void 0, children);
-};
-/**
-* Creates a text input form field element (w:textInput).
-*/
-const createTextInput = (options) => {
-	const children = [];
-	if (options.type !== void 0) children.push(valElement("w:type", options.type));
-	if (options.default !== void 0) children.push(valElement("w:default", options.default));
-	if (options.maxLength !== void 0) children.push(valElement("w:maxLength", options.maxLength));
-	if (options.format !== void 0) children.push(valElement("w:format", options.format));
-	return element("w:textInput", void 0, children);
-};
-/**
-* Creates a form field data element (w:ffData).
-*
-* This element contains the definition for an interactive form field
-* (checkbox, dropdown list, or text input) within a document.
-*
-* ## XSD Schema
-* ```xml
-* <xsd:complexType name="CT_FFData">
-*   <xsd:choice maxOccurs="unbounded">
-*     <xsd:element name="name" type="CT_FFName"/>
-*     <xsd:element name="label" type="CT_DecimalNumber"/>
-*     <xsd:element name="tabIndex" type="CT_UnsignedDecimalNumber"/>
-*     <xsd:element name="enabled" type="CT_OnOff"/>
-*     <xsd:element name="calcOnExit" type="CT_OnOff"/>
-*     <xsd:element name="entryMacro" type="CT_MacroName"/>
-*     <xsd:element name="exitMacro" type="CT_MacroName"/>
-*     <xsd:element name="helpText" type="CT_FFHelpText"/>
-*     <xsd:element name="statusText" type="CT_FFStatusText"/>
-*     <xsd:choice>
-*       <xsd:element name="checkBox" type="CT_FFCheckBox"/>
-*       <xsd:element name="ddList" type="CT_FFDDList"/>
-*       <xsd:element name="textInput" type="CT_FFTextInput"/>
-*     </xsd:choice>
-*   </xsd:choice>
-* </xsd:complexType>
-* ```
-*
-* @example
-* ```typescript
-* // Checkbox
-* createFormFieldData({
-*   name: "Check1",
-*   checkBox: { checked: true, sizeAuto: true },
-* });
-*
-* // Dropdown
-* createFormFieldData({
-*   name: "DropDown1",
-*   dropDownList: { entries: ["Option A", "Option B", "Option C"], result: 0 },
-* });
-*
-* // Text input
-* createFormFieldData({
-*   name: "Text1",
-*   textInput: { type: "regular", default: "Enter text here" },
-* });
-* ```
-*/
-const createFormFieldData = (options) => {
-	const children = [];
-	if (options.name !== void 0) children.push(valElement("w:name", options.name));
-	if (options.label !== void 0) children.push(valElement("w:label", options.label));
-	if (options.tabIndex !== void 0) children.push(valElement("w:tabIndex", options.tabIndex));
-	if (options.enabled !== void 0) children.push(`<w:enabled/>`);
-	if (options.calcOnExit !== void 0) children.push(`<w:calcOnExit/>`);
-	if (options.entryMacro !== void 0) children.push(valElement("w:entryMacro", options.entryMacro));
-	if (options.exitMacro !== void 0) children.push(valElement("w:exitMacro", options.exitMacro));
-	if (options.helpText) children.push(createFormFieldText("w:helpText", options.helpText));
-	if (options.statusText) children.push(createFormFieldText("w:statusText", options.statusText));
-	if (options.checkBox) children.push(createCheckBox(options.checkBox));
-	else if (options.dropDownList) children.push(createDropDownList(options.dropDownList));
-	else if (options.textInput) children.push(createTextInput(options.textInput));
-	return element("w:ffData", void 0, children);
-};
-//#endregion
 //#region src/parts/paragraph/run/proof-error.ts
 /**
 * Proof error types for WordprocessingML documents.
@@ -3554,6 +3406,18 @@ function parseParagraphProperties(el, ctx) {
 	return opts;
 }
 /**
+* Concatenate `<w:t>` text in a run element.
+*
+* Used to capture a textInput form field's current value from the result run
+* (the runs between the `separate` and `end` fldChars). Only `<w:t>` is read —
+* `<w:tab>`/`<w:br>` in results are ignored as rare for user-entered text.
+*/
+function collectRunText(el) {
+	let text = "";
+	for (const c of el.elements ?? []) if (c.name === "w:t") text += textOf(c);
+	return text;
+}
+/**
 * Parse a w:p element into ParagraphOptions.
 */
 function parseParagraph(el, ctx) {
@@ -3561,9 +3425,35 @@ function parseParagraph(el, ctx) {
 	const pPr = findChild(el, "w:pPr");
 	if (pPr) Object.assign(opts, parseParagraphProperties(pPr, ctx));
 	const childList = [];
+	let pendingFormField = null;
+	let collectingResult = false;
 	for (const child of el.elements ?? []) switch (child.name) {
 		case "w:pPr": break;
 		case "w:r": {
+			const fldCharEl = findChild(child, "w:fldChar");
+			if (fldCharEl) {
+				const fctype = attr(fldCharEl, "w:fldCharType");
+				if (fctype === "begin") {
+					const ffDataEl = findChild(fldCharEl, "w:ffData");
+					if (ffDataEl) pendingFormField = parseFormFieldData(ffDataEl);
+				} else if (fctype === "separate") collectingResult = true;
+				else if (fctype === "end" && pendingFormField) {
+					childList.push({ formField: pendingFormField });
+					pendingFormField = null;
+					collectingResult = false;
+				}
+				break;
+			}
+			if (pendingFormField) {
+				if (collectingResult && pendingFormField.textInput) {
+					const text = collectRunText(child);
+					if (text) {
+						const ti = pendingFormField.textInput;
+						ti.value = (ti.value ?? "") + text;
+					}
+				}
+				break;
+			}
 			const drawingEl = findChild(child, "w:drawing");
 			if (drawingEl) {
 				const drawingChild = parseDrawingRun(drawingEl, ctx);
@@ -3873,6 +3763,22 @@ function parseSdtProperties(el) {
 		if (gallery) opts.docPartList.gallery = attr(gallery, "w:val");
 		const category = findChild(dp, "w:docPartCategory");
 		if (category) opts.docPartList.category = attr(category, "w:val");
+	} else if (findChild(el, "w14:checkbox")) {
+		const cb = findChild(el, "w14:checkbox");
+		const cbObj = {};
+		const checked = findChild(cb, "w14:checked");
+		if (checked) cbObj.checked = attrBool(checked, "w14:val") ?? true;
+		const checkedState = findChild(cb, "w14:checkedState");
+		if (checkedState) cbObj.checkedState = {
+			val: attr(checkedState, "w14:val") ?? "",
+			font: attr(checkedState, "w14:font")
+		};
+		const uncheckedState = findChild(cb, "w14:uncheckedState");
+		if (uncheckedState) cbObj.uncheckedState = {
+			val: attr(uncheckedState, "w14:val") ?? "",
+			font: attr(uncheckedState, "w14:font")
+		};
+		opts.checkbox = cbObj;
 	}
 	return opts;
 }
@@ -4714,6 +4620,28 @@ function sdtDocPartXml(name, options) {
 function onOffAttr(name, val) {
 	return val ? `<${name}/>` : `<${name} w:val="0"/>`;
 }
+const W14_NS = "xmlns:w14=\"http://schemas.microsoft.com/office/word/2010/wordml\"";
+/** Default symbol font for checkbox content controls (CT_SdtCheckboxSymbol). */
+const CHECKBOX_FONT = "MS Gothic";
+const DEFAULT_CHECKED = {
+	val: "2612",
+	font: CHECKBOX_FONT
+};
+const DEFAULT_UNCHECKED = {
+	val: "2610",
+	font: CHECKBOX_FONT
+};
+/**
+* Build a w14:checkbox element (Word 2010+ content control checkbox).
+*
+* Lives in the w14 extension namespace; emitted with an inline xmlns:w14 so it
+* is valid wherever w:sdtPr appears. validate.ts tolerates the w14 namespace.
+*/
+function sdtCheckboxXml(opts) {
+	const checked = opts.checkedState ?? DEFAULT_CHECKED;
+	const unchecked = opts.uncheckedState ?? DEFAULT_UNCHECKED;
+	return `<w14:checkbox ${W14_NS}>${(opts.checked ? "<w14:checked/>" : "<w14:checked w14:val=\"0\"/>") + `<w14:checkedState w14:val="${escapeXml$1(checked.val)}" w14:font="${escapeXml$1(checked.font ?? CHECKBOX_FONT)}"/><w14:uncheckedState w14:val="${escapeXml$1(unchecked.val)}" w14:font="${escapeXml$1(unchecked.font ?? CHECKBOX_FONT)}"/>`}</w14:checkbox>`;
+}
 function stringifySdtPr(opts) {
 	const parts = [];
 	if (opts.alias !== void 0) parts.push(`<w:alias w:val="${escapeXml$1(opts.alias)}"/>`);
@@ -4740,6 +4668,7 @@ function stringifySdtPr(opts) {
 	} else if (opts.citation) parts.push("<w:citation/>");
 	else if (opts.group) parts.push("<w:group/>");
 	else if (opts.bibliography) parts.push("<w:bibliography/>");
+	else if (opts.checkbox) parts.push(sdtCheckboxXml(opts.checkbox));
 	return parts.length ? `<w:sdtPr>${parts.join("")}</w:sdtPr>` : "<w:sdtPr/>";
 }
 /** Parse w:sdtPr element into SdtPropertiesOptions. */
@@ -4843,6 +4772,23 @@ function parseSdtPr(el) {
 	else if (findChild(el, "w:citation")) opts.citation = true;
 	else if (findChild(el, "w:group")) opts.group = true;
 	else if (findChild(el, "w:bibliography")) opts.bibliography = true;
+	else if (findChild(el, "w14:checkbox")) {
+		const cb = findChild(el, "w14:checkbox");
+		const cbObj = {};
+		const checked = findChild(cb, "w14:checked");
+		if (checked) cbObj.checked = attrBool(checked, "w14:val") ?? true;
+		const checkedState = findChild(cb, "w14:checkedState");
+		if (checkedState) cbObj.checkedState = {
+			val: attr(checkedState, "w14:val") ?? "",
+			font: attr(checkedState, "w14:font")
+		};
+		const uncheckedState = findChild(cb, "w14:uncheckedState");
+		if (uncheckedState) cbObj.uncheckedState = {
+			val: attr(uncheckedState, "w14:val") ?? "",
+			font: attr(uncheckedState, "w14:font")
+		};
+		opts.checkbox = cbObj;
+	}
 	return opts;
 }
 /** Parse w:customXmlPr element into CustomXmlPrOptions. */
@@ -4889,7 +4835,13 @@ const sdtBlockDesc = {
 		const parts = ["<w:sdt>"];
 		parts.push(stringifySdtPr(opts.properties));
 		parts.push("<w:sdtEndPr/>");
-		if (opts.children && opts.children.length > 0) {
+		if (opts.properties.checkbox) {
+			const cb = opts.properties.checkbox;
+			const symbol = cb.checked ?? false ? cb.checkedState ?? DEFAULT_CHECKED : cb.uncheckedState ?? DEFAULT_UNCHECKED;
+			const font = escapeXml$1(symbol.font ?? CHECKBOX_FONT);
+			const char = escapeXml$1(String.fromCodePoint(parseInt(symbol.val, 16)));
+			parts.push(`<w:sdtContent><w:p><w:r><w:rPr><w:rFonts w:ascii="${font}" w:hAnsi="${font}"/></w:rPr><w:t>${char}</w:t></w:r></w:p></w:sdtContent>`);
+		} else if (opts.children && opts.children.length > 0) {
 			const contentParts = [];
 			for (const child of opts.children) contentParts.push(ctx.stringifyChild(child, ctx));
 			const contentBody = contentParts.join("");
@@ -5579,6 +5531,6 @@ var DocxReadContext = class {
 	}
 };
 //#endregion
-export { RelativeVerticalPosition as $, footnotesDesc as A, settingsDesc as B, fontTableDesc as C, EditGroupType as D, AltChunkCollection as E, stringifyTableOfContents as F, Numbering as G, buildNumberingCache as H, parseToc as I, LevelSuffix as J, parseNumberingDefinitions as K, SdtDateMappingType as L, parseParagraphProperties as M, stringifyBodyChild as N, parseSdtBlock as O, stringifyDocumentXml as P, RelativeHorizontalPosition as Q, SdtLock as R, bibliographyDesc as S, SubDocCollection as T, buildStyleCache as U, Styles as V, parseStyleDefinitions as W, TableLayoutType as X, TABLE_BORDERS_NONE as Y, OverlapType as Z, commentsDesc as _, AlignmentType as _t, framesetXml as a, PositionalTabAlignment as at, DocPartType as b, corePropertiesDesc as c, EmphasisMarkType as ct, sdtBlockDesc as d, HighlightColor as dt, TableAnchorType as et, setBodyParseChild as f, TextEffect as ft, contentTypesDesc as g, HeadingLevel as gt, buildContentTypes as h, TextboxTightWrapType as ht, frameXml as i, RubyAlign as it, parseParagraph as j, endnotesDesc as k, altChunkDesc as l, UnderlineType as lt, relationshipsDesc as m, TextAlignmentType as mt, DocxWriteContext as n, FormFieldTextType as nt, webSettingsDesc as o, PositionalTabLeader as ot, subDocDesc as p, PageNumber as pt, LevelFormat as q, TargetScreenSize as r, createFormFieldData as rt, customPropertiesDesc as s, PositionalTabRelativeTo as st, DocxReadContext as t, ProofErrorType as tt, customXmlBlockDesc as u, createImageData as ut, DocPartBehavior as v, CharacterSet as w, glossaryDesc as x, DocPartGallery as y, StyleLevel as z };
+export { RelativeVerticalPosition as $, footnotesDesc as A, settingsDesc as B, fontTableDesc as C, EditGroupType as D, AltChunkCollection as E, stringifyTableOfContents as F, Numbering as G, buildNumberingCache as H, parseToc as I, LevelSuffix as J, parseNumberingDefinitions as K, SdtDateMappingType as L, parseParagraphProperties as M, stringifyBodyChild as N, parseSdtBlock as O, stringifyDocumentXml as P, RelativeHorizontalPosition as Q, SdtLock as R, bibliographyDesc as S, SubDocCollection as T, buildStyleCache as U, Styles as V, parseStyleDefinitions as W, TableLayoutType as X, TABLE_BORDERS_NONE as Y, OverlapType as Z, commentsDesc as _, framesetXml as a, PositionalTabRelativeTo as at, DocPartType as b, corePropertiesDesc as c, createImageData as ct, sdtBlockDesc as d, PageNumber as dt, TableAnchorType as et, setBodyParseChild as f, TextAlignmentType as ft, contentTypesDesc as g, buildContentTypes as h, AlignmentType as ht, frameXml as i, PositionalTabLeader as it, parseParagraph as j, endnotesDesc as k, altChunkDesc as l, HighlightColor as lt, relationshipsDesc as m, HeadingLevel as mt, DocxWriteContext as n, RubyAlign as nt, webSettingsDesc as o, EmphasisMarkType as ot, subDocDesc as p, TextboxTightWrapType as pt, LevelFormat as q, TargetScreenSize as r, PositionalTabAlignment as rt, customPropertiesDesc as s, UnderlineType as st, DocxReadContext as t, ProofErrorType as tt, customXmlBlockDesc as u, TextEffect as ut, DocPartBehavior as v, CharacterSet as w, glossaryDesc as x, DocPartGallery as y, StyleLevel as z };
 
-//# sourceMappingURL=context-CERMOUn0.mjs.map
+//# sourceMappingURL=context-DeKZoZem.mjs.map