@lotics/xlsx 0.1.0

package/src/xml_entities.ts

@@ -0,0 +1,23 @@
+/**
+ * XML entity decoding for parsers that run with `processEntities: false`.
+ *
+ * fast-xml-parser's entity processing mangles some binary edge cases in
+ * spreadsheet content (formula text, inline strings), so we opted out
+ * globally. That means every attribute or text value we read still carries
+ * literal `&`, `"`, etc. — they must be decoded before being stored
+ * in the model or the writer will re-escape and produce `"`
+ * (double-encoded), which Excel renders as literal garbage (e.g.
+ * `&quot-&quot` where a numFmt's zero section should render a dash).
+ *
+ * Apply to any attribute or text value that may contain `&` — that is,
+ * every user-visible or round-tripped string: formatCode, defined names,
+ * headers/footers, data validation prompts, filter values, etc.
+ */
+export function decodeXmlEntities(text: string): string {
+  return text
+    .replace(/&lt;/g, "<")
+    .replace(/&gt;/g, ">")
+    .replace(/&quot;/g, '"')
+    .replace(/&apos;/g, "'")
+    .replace(/&amp;/g, "&");
+}