add locale configuration for docx export

allows setting the default language in generated .docx files

Author: Ovgodd

packages/xl-docx-exporter/src/docx/docxExporter.ts

@@ -187,10 +187,22 @@ export class DOCXExporter<
     ];
   }
 
-  protected async createDefaultDocumentOptions(): Promise<DocumentOptions> {
-    const externalStyles = (await import("./template/word/styles.xml?raw"))
+  protected async createDefaultDocumentOptions(
+    locale?: string,
+  ): Promise<DocumentOptions> {
+    let externalStyles = (await import("./template/word/styles.xml?raw"))
       .default;
 
+    // Replace the default language in styles.xml with the provided locale.
+    // If not provided, default to en-US.
+    const resolvedLocale = (locale && locale.trim()) || "en-US";
+    // Replace w:lang w:val="..." with the desired locale, leaving other attributes intact
+    // This targets the run default language defined in styles.xml
+    externalStyles = externalStyles.replace(
+      /(<w:lang\b[^>]*\bw:val=")([^"]+)("[^>]*\/>)/g,
+      `$1${resolvedLocale}$3`,
+    );
+
     const bullets = ["•"]; //, "◦", "▪"]; (these don't look great, just use solid bullet for now)
     return {
       numbering: {
@@ -247,6 +259,11 @@ export class DOCXExporter<
     options: {
       sectionOptions: Omit<ISectionOptions, "children">;
       documentOptions: DocumentOptions;
+      /**
+       * The document locale in OOXML format (e.g. en-US, fr-FR, de-DE).
+       * If omitted, defaults to en-US.
+       */
+      locale?: string;
     } = {
       sectionOptions: {},
       documentOptions: {},
@@ -276,13 +293,18 @@ export class DOCXExporter<
     options: {
       sectionOptions: Omit<ISectionOptions, "children">;
       documentOptions: DocumentOptions;
+      /**
+       * The document locale in OOXML format (e.g. en-US, fr-FR, de-DE).
+       * If omitted, defaults to en-US.
+       */
+      locale?: string;
     } = {
       sectionOptions: {},
       documentOptions: {},
     },
   ) {
     const doc = new Document({
-      ...(await this.createDefaultDocumentOptions()),
+      ...(await this.createDefaultDocumentOptions(options.locale)),
       ...options.documentOptions,
       sections: [
         {