@docx4j/core-ts 0.6.0 → 0.7.0

package/dist/model/text/TextOptions.d.mts

@@ -7,7 +7,10 @@ import type { ImageDescriber } from './TextResult.mjs';
  * another name: the content API's `TextView` (CR-002 phase F) is `getText`'s two views.
  */
 export type TextModelView = 'accepted' | 'original' | 'markup';
-/** The stories `include` adds (REQ-501, REQ-502). */
+/**
+ * The stories `include` adds (REQ-501, REQ-502): `headers`, `footers` and `glossary`. Comments are `comments` (REQ-504, WD 0.91).
+ * `comments` here is deprecated, a spelling of `comments: true` kept because 0.6.0 released it (CR-012 section 29).
+ */
 export type TextInclude = 'headers' | 'footers' | 'comments' | 'glossary';
 /** `fields` (REQ-506). */
 export type TextFields = 'cached' | 'update';
@@ -23,11 +26,36 @@ export type TextTables = 'auto' | 'tsv' | 'grid';
 export type TextMarkupDetail = 'type' | 'author' | 'author_date';
 /** `layout` (REQ-709). */
 export type TextLayout = 'none' | 'indent';
+/**
+ * `drop_caps` (REQ-521): a drop cap's frame paragraph (`w:framePr/@w:dropCap`) joined to the paragraph after it, as the
+ * page reads (`join`), or the two paragraphs as the package holds them (`asis`, Word's text). CR-012 section 24.3.
+ */
+export type TextDropCaps = 'join' | 'asis';
+/**
+ * `small_caps` (REQ-607): a small-caps run written as its stored characters (`asis`), or in capitals as a caps run is
+ * (`upper`, Word's text). CR-012 section 24.
+ */
+export type TextSmallCaps = 'asis' | 'upper';
+/**
+ * `repair` (REQ-207, WD 0.102): how a package Word reads only through a repair, or won't open, is loaded: every refusal kept
+ * (`refuse`), Word's repair followed where the WD states one (`word`), or that and this package's own (`all`). The load's
+ * option (`LoadOptions.repair`, CR-031): a reading of a package already loaded doesn't decide again, and the load's setting
+ * holds. `duplicate_entries`, which REQ-206 says an implementation MAY offer, isn't offered here: `word` reads its `first`
+ * (CR-031 D1).
+ */
+export type TextRepair = 'refuse' | 'word' | 'all';
+/**
+ * `profile` (REQ-1002, WD 0.41): a preset of option values applied before the caller's own, so that an option the caller
+ * sets by name, before or after the profile, overrides it. `word-text` is Word's Save As plain text as the options reach
+ * it (`WORD_TEXT_PROFILE`). CR-012 section 23.1.
+ */
+export type TextProfile = 'word-text';
 /** A boolean option's value: a boolean, or `"true"` / `"false"` as a tool passes it. */
 type Bool = boolean | 'true' | 'false';
 /**
  * The options by the specification's names (WD section 10), every one optional, each absent one at its
- * default. `include` takes a list of story names or a string of them separated by commas or spaces;
+ * default. `include` takes a list of story names or a string of them separated by commas or spaces,
+ * and naming `comments` in it is a deprecated spelling of `comments: true`, refused beside `comments: false`;
  * a boolean takes `"true"` or `"false"` as well; any other value is its name, in any case.
  * `imageDescriber` is the host's (REQ-514), not one of the specification's options.
  */
@@ -42,6 +70,7 @@ export interface TextOptionsInit {
     field_codes?: Bool;
     fields?: TextFields;
     toc?: Bool;
+    drop_caps?: TextDropCaps;
     placeholders?: Bool;
     bindings?: TextBindings;
     list_labels?: Bool;
@@ -52,12 +81,18 @@ export interface TextOptionsInit {
     alt_text?: Bool;
     metadata?: Bool;
     symbols?: TextSymbols;
+    small_caps?: TextSmallCaps;
+    /** A BCP 47 tag (REQ-607, WD 0.80): the language of last resort for a cased run's capitals. */
+    default_language?: string;
     math?: TextMath;
     tables?: TextTables;
     markup_detail?: TextMarkupDetail;
     page_markers?: Bool;
     layout?: TextLayout;
     warnings?: Bool;
+    repair?: TextRepair;
+    /** A preset applied before the other options, whichever came first (REQ-1002); `word-text` or `word_text`, in any case. */
+    profile?: TextProfile | string | null;
     /** The describer images take their text from (REQ-514); `AltTextDescriber` by default. */
     imageDescriber?: ImageDescriber;
 }
@@ -73,6 +108,19 @@ export declare class TextOptionError extends Docx4JException {
 }
 /** The option names of WD section 10, in its order. docx4j `TextOptions.NAMES`. */
 export declare const TEXT_OPTION_NAMES: readonly string[];
+/**
+ * `profile: word-text`'s values by WD name, in WD order (REQ-1002; docx4j `TextOptions.WORD_TEXT_VALUES`): the accepted
+ * view, hidden text in, headers and footers in, comments in through `comments` alone (WD 0.91), text boxes out, notes and their references in, list labels
+ * (WD 0.75), fields cached, no field codes, the table of contents in, a drop cap apart from its word, placeholders in,
+ * bound values, chunks expanded, symbols as they are, small caps in capitals, tables as tab-separated rows, no page
+ * markers, no indentation, no alt text, no metadata, no charts, SmartArt or embedded packages. `default_language` keeps
+ * its default, since the saving installation's language is not in the file (WD 0.80). What it does not reproduce: the
+ * notes' and comments' forms, CR LF and CR cells, folded hyphens, the one space Word writes after every list label where
+ * the level's suffix is written here (WD 0.79), Word's linear math (`math: unicodemath` is refused here, as in docx4j, so
+ * the preset leaves math as LaTeX; CR-012 section 23.1), and three accidents of Word's own: the partial update a DATE,
+ * TIME or SAVEDATE field triggers on open, the SYMBOL omission, and the stale PAGE number.
+ */
+export declare const WORD_TEXT_PROFILE: Readonly<Record<string, unknown>>;
 /**
  * What a text includes and how it is written: the specification's section 10 options (REQ-1001), as
  * docx4j's `TextOptions` has them. Mutable; `Texts.of` reads it once.
@@ -101,6 +149,8 @@ export declare class TextOptions {
      * included under `field_codes`, and a paragraph with nothing else in it is no paragraph.
      */
     toc: boolean;
+    /** `drop_caps` (REQ-521): `join`, the default, or `asis`. */
+    dropCaps: TextDropCaps;
     placeholders: boolean;
     bindings: TextBindings;
     listLabels: boolean;
@@ -111,6 +161,15 @@ export declare class TextOptions {
     altText: boolean;
     metadata: boolean;
     symbols: TextSymbols;
+    /** `small_caps` (REQ-607): `asis`, the default, or `upper`. */
+    smallCaps: TextSmallCaps;
+    /**
+     * `default_language` (REQ-607, WD 0.80): the language a cased run's capitals are mapped by where the run, its styles and
+     * the document defaults name none. It stands in for Word's editing language, which a library cannot know;
+     * `w:themeFontLang` plays no part. A BCP 47 tag, kept as given; `CaseMapping.DEFAULT_LANGUAGE` (`en-US`) by default.
+     * CR-012 section 24.8.
+     */
+    defaultLanguage: string;
     math: TextMath;
     tables: TextTables;
     markupDetail: TextMarkupDetail;
@@ -122,18 +181,42 @@ export declare class TextOptions {
     pageMarkers: boolean;
     layout: TextLayout;
     warnings: boolean;
+    /**
+     * `repair` (REQ-207): the load's option, accepted here by the WD's name (REQ-1001) and passed by a caller that loads, as the
+     * suite's adapter does, to `LoadOptions.repair`; a reading of a loaded package doesn't use it.
+     */
+    repair: TextRepair;
     /** The describer images take their text from (REQ-514). */
     imageDescriber: ImageDescriber;
+    /** The profile applied (REQ-1002), or undefined. */
+    private profileName;
+    /** The options the caller set by name: a profile does not override them, whichever came first. */
+    private readonly explicit;
     /** Options from the specification's names and values (REQ-1001); those not named keep their defaults. */
     static of(init?: TextOptionsInit | TextOptions): TextOptions;
-    /** Sets one option by its specification name and value; throws `TextOptionError` for one it does not define. */
+    /**
+     * Sets one option by its specification name and value; throws `TextOptionError` for one it does not define. An option set
+     * by name is the caller's: a profile, applied before or after, leaves it (REQ-1002). A member assigned directly is not
+     * recorded so, and a profile applied after the assignment overrides it.
+     */
     set(name: string, value: unknown): this;
+    /**
+     * Applies a profile (REQ-1002): its values for every option the caller has not set by name; an option the caller sets
+     * afterwards overrides it too. Undefined clears the name, leaving the values. See `WORD_TEXT_PROFILE`.
+     */
+    profile(p: TextProfile | undefined): this;
+    /** The profile applied, or undefined. */
+    get profileApplied(): TextProfile | undefined;
+    /** Sets one option without recording it as the caller's (a profile's value). */
+    private apply;
     private setInclude;
+    /** `comments` never stays in `include`: it is the deprecated spelling of `comments: true`, and the caller's option as that is. */
+    private addStories;
     /** Adds stories to `include` (docx4j's builder `include(Include...)`). */
     include(...stories: TextInclude[]): this;
-    /** The stories `include` names; `comments: true` adds `comments`. */
+    /** The stories in scope: those `include` names, and `comments` where `comments` is true. */
     get includes(): ReadonlySet<TextInclude>;
-    /** `comments: true` or `include: comments`. */
+    /** `comments: true`, the one setting (REQ-504, WD 0.91). */
     get comments(): boolean;
     set comments(value: boolean);
     /** A copy, for a reading one level down or a first reading. */

package/dist/model/text/TextOptions.mjs

@@ -4,6 +4,8 @@
 // options through unchanged; docx4j's `of(Map)` and `set(name, value)` take the same.
 import { Docx4JException } from '../../opc/exceptions.mjs';
 import { AltTextDescriber } from './TextResult.mjs';
+import { CaseMapping } from './CaseMapping.mjs';
+import { log } from '../properties/log.mjs';
 /**
  * An option refused (REQ-1001): an unknown name, a value the specification does not define, or a
  * value this package does not implement yet. `statement` names the requirement, `option` the option.
@@ -20,11 +22,38 @@ export class TextOptionError extends Docx4JException {
 /** The option names of WD section 10, in its order. docx4j `TextOptions.NAMES`. */
 export const TEXT_OPTION_NAMES = Object.freeze([
     'view', 'include', 'text_boxes', 'notes', 'note_references', 'comments', 'hidden', 'field_codes',
-    'fields', 'toc', 'placeholders', 'bindings', 'list_labels', 'charts', 'smartart', 'embedded', 'altchunks',
-    'alt_text', 'metadata', 'symbols', 'math', 'tables', 'markup_detail', 'page_markers', 'layout',
-    'warnings',
+    'fields', 'toc', 'drop_caps', 'placeholders', 'bindings', 'list_labels', 'charts', 'smartart', 'embedded', 'altchunks',
+    'alt_text', 'metadata', 'symbols', 'small_caps', 'default_language', 'math', 'tables', 'markup_detail', 'page_markers', 'layout',
+    'warnings', 'repair', 'profile',
 ]);
+/**
+ * `profile: word-text`'s values by WD name, in WD order (REQ-1002; docx4j `TextOptions.WORD_TEXT_VALUES`): the accepted
+ * view, hidden text in, headers and footers in, comments in through `comments` alone (WD 0.91), text boxes out, notes and their references in, list labels
+ * (WD 0.75), fields cached, no field codes, the table of contents in, a drop cap apart from its word, placeholders in,
+ * bound values, chunks expanded, symbols as they are, small caps in capitals, tables as tab-separated rows, no page
+ * markers, no indentation, no alt text, no metadata, no charts, SmartArt or embedded packages. `default_language` keeps
+ * its default, since the saving installation's language is not in the file (WD 0.80). What it does not reproduce: the
+ * notes' and comments' forms, CR LF and CR cells, folded hyphens, the one space Word writes after every list label where
+ * the level's suffix is written here (WD 0.79), Word's linear math (`math: unicodemath` is refused here, as in docx4j, so
+ * the preset leaves math as LaTeX; CR-012 section 23.1), and three accidents of Word's own: the partial update a DATE,
+ * TIME or SAVEDATE field triggers on open, the SYMBOL omission, and the stale PAGE number.
+ */
+export const WORD_TEXT_PROFILE = Object.freeze({
+    view: 'accepted', include: 'headers,footers', text_boxes: false, notes: true, note_references: true,
+    comments: true, hidden: true, field_codes: false, fields: 'cached', toc: true, drop_caps: 'asis', placeholders: true,
+    bindings: 'bound', list_labels: true, charts: false, smartart: false, embedded: false, altchunks: true,
+    alt_text: false, metadata: false, symbols: 'asis', small_caps: 'upper', math: 'latex', tables: 'tsv',
+    page_markers: false, layout: 'none',
+});
 const INCLUDES = ['headers', 'footers', 'comments', 'glossary'];
+/** `include`'s stories: a list of names, or a string of them separated by commas or spaces. */
+function includeItems(value) {
+    const items = Array.isArray(value) ? value
+        : value === undefined || value === null ? [] : String(value).split(/[,\s]+/).filter((s) => s !== '');
+    return items.map((item) => choice('include', item, INCLUDES, 'REQ-501'));
+}
+/** Whether the deprecated spelling's notice has been written: once a process, since a caller's code is what has to change. */
+let includeCommentsNoticed = false;
 /**
  * What a text includes and how it is written: the specification's section 10 options (REQ-1001), as
  * docx4j's `TextOptions` has them. Mutable; `Texts.of` reads it once.
@@ -54,6 +83,8 @@ export class TextOptions {
          * included under `field_codes`, and a paragraph with nothing else in it is no paragraph.
          */
         this.toc = false;
+        /** `drop_caps` (REQ-521): `join`, the default, or `asis`. */
+        this.dropCaps = 'join';
         this.placeholders = true;
         this.bindings = 'bound';
         this.listLabels = false;
@@ -64,6 +95,15 @@ export class TextOptions {
         this.altText = false;
         this.metadata = false;
         this.symbols = 'asis';
+        /** `small_caps` (REQ-607): `asis`, the default, or `upper`. */
+        this.smallCaps = 'asis';
+        /**
+         * `default_language` (REQ-607, WD 0.80): the language a cased run's capitals are mapped by where the run, its styles and
+         * the document defaults name none. It stands in for Word's editing language, which a library cannot know;
+         * `w:themeFontLang` plays no part. A BCP 47 tag, kept as given; `CaseMapping.DEFAULT_LANGUAGE` (`en-US`) by default.
+         * CR-012 section 24.8.
+         */
+        this.defaultLanguage = CaseMapping.DEFAULT_LANGUAGE;
         this.math = 'latex';
         this.tables = 'auto';
         this.markupDetail = 'type';
@@ -75,8 +115,15 @@ export class TextOptions {
         this.pageMarkers = false;
         this.layout = 'none';
         this.warnings = true;
+        /**
+         * `repair` (REQ-207): the load's option, accepted here by the WD's name (REQ-1001) and passed by a caller that loads, as the
+         * suite's adapter does, to `LoadOptions.repair`; a reading of a loaded package doesn't use it.
+         */
+        this.repair = 'refuse';
         /** The describer images take their text from (REQ-514). */
         this.imageDescriber = AltTextDescriber.INSTANCE;
+        /** The options the caller set by name: a profile does not override them, whichever came first. */
+        this.explicit = new Set();
     }
     /** Options from the specification's names and values (REQ-1001); those not named keep their defaults. */
     static of(init) {
@@ -86,6 +133,11 @@ export class TextOptions {
         const o = new TextOptions();
         if (init === undefined || init === null)
             return o;
+        if (init.comments !== undefined && init.include !== undefined && !bool('comments', init.comments, 'REQ-504')
+            && includeItems(init.include).includes('comments')) {
+            throw new TextOptionError(`comments: false and an include naming comments say opposite things; drop comments from include, `
+                + `which is a deprecated spelling of comments: true (WD REQ-504)`, 'comments', 'REQ-504', 'invalid');
+        }
         for (const [name, value] of Object.entries(init)) {
             if (value === undefined)
                 continue;
@@ -96,9 +148,38 @@ export class TextOptions {
         }
         return o;
     }
-    /** Sets one option by its specification name and value; throws `TextOptionError` for one it does not define. */
+    /**
+     * Sets one option by its specification name and value; throws `TextOptionError` for one it does not define. An option set
+     * by name is the caller's: a profile, applied before or after, leaves it (REQ-1002). A member assigned directly is not
+     * recorded so, and a profile applied after the assignment overrides it.
+     */
     set(name, value) {
         const n = (name !== null && name !== void 0 ? name : '').trim();
+        if (n === 'profile')
+            return this.profile(value === undefined || value === null ? undefined : profileOf(value));
+        this.apply(n, name, value);
+        this.explicit.add(n);
+        return this;
+    }
+    /**
+     * Applies a profile (REQ-1002): its values for every option the caller has not set by name; an option the caller sets
+     * afterwards overrides it too. Undefined clears the name, leaving the values. See `WORD_TEXT_PROFILE`.
+     */
+    profile(p) {
+        this.profileName = p;
+        if (p === undefined)
+            return this;
+        for (const [n, value] of Object.entries(WORD_TEXT_PROFILE))
+            if (!this.explicit.has(n))
+                this.apply(n, n, value);
+        return this;
+    }
+    /** The profile applied, or undefined. */
+    get profileApplied() {
+        return this.profileName;
+    }
+    /** Sets one option without recording it as the caller's (a profile's value). */
+    apply(n, name, value) {
         switch (n) {
             case 'view':
                 this.view = viewOf(value);
@@ -130,6 +211,9 @@ export class TextOptions {
             case 'toc':
                 this.toc = bool(n, value, 'REQ-520');
                 break;
+            case 'drop_caps':
+                this.dropCaps = choice(n, value, ['join', 'asis'], 'REQ-521');
+                break;
             case 'placeholders':
                 this.placeholders = bool(n, value, 'REQ-508');
                 break;
@@ -160,6 +244,12 @@ export class TextOptions {
             case 'symbols':
                 this.symbols = choice(n, value, ['asis', 'unicode'], 'REQ-601');
                 break;
+            case 'small_caps':
+                this.smallCaps = choice(n, value, ['asis', 'upper'], 'REQ-607');
+                break;
+            case 'default_language':
+                this.defaultLanguage = languageTag(n, value, 'REQ-607');
+                break;
             case 'math':
                 this.math = choice(n, value, ['latex', 'unicodemath'], 'REQ-604');
                 break;
@@ -178,34 +268,51 @@ export class TextOptions {
             case 'warnings':
                 this.warnings = bool(n, value, 'REQ-801');
                 break;
+            case 'repair':
+                this.repair = choice(n, value, ['refuse', 'word', 'all'], 'REQ-207');
+                break;
+            case 'duplicate_entries':
+                // REQ-206's MAY, not offered (CR-031 D1): one switch, whose word reads the first copy
+                throw new TextOptionError("duplicate_entries isn't offered here: load with repair: 'word', which reads the first entry of each name "
+                    + '(WD REQ-206, REQ-207)', 'duplicate_entries', 'REQ-206', 'not_implemented');
             default:
                 throw new TextOptionError(`Unknown text option '${String(name)}'; the options are ${TEXT_OPTION_NAMES.join(', ')} (WD REQ-1001)`, String(name), 'REQ-1001', 'unknown');
         }
-        return this;
     }
     setInclude(value) {
         this.includeSet.clear();
-        const items = Array.isArray(value) ? value
-            : value === undefined || value === null ? [] : String(value).split(/[,\s]+/).filter((s) => s !== '');
-        for (const item of items)
-            this.includeSet.add(choice('include', item, INCLUDES, 'REQ-501'));
+        this.addStories(includeItems(value));
+    }
+    /** `comments` never stays in `include`: it is the deprecated spelling of `comments: true`, and the caller's option as that is. */
+    addStories(stories) {
+        for (const s of stories) {
+            if (s !== 'comments') {
+                this.includeSet.add(s);
+                continue;
+            }
+            this.commentsOption = true;
+            this.explicit.add('comments');
+            if (!includeCommentsNoticed)
+                log.warn('The text option include: comments is deprecated: use comments: true (WD 0.91, CR-012 section 29)');
+            includeCommentsNoticed = true;
+        }
     }
     /** Adds stories to `include` (docx4j's builder `include(Include...)`). */
     include(...stories) {
-        for (const s of stories)
-            this.includeSet.add(choice('include', s, INCLUDES, 'REQ-501'));
+        this.addStories(stories.map((s) => choice('include', s, INCLUDES, 'REQ-501')));
+        this.explicit.add('include');
         return this;
     }
-    /** The stories `include` names; `comments: true` adds `comments`. */
+    /** The stories in scope: those `include` names, and `comments` where `comments` is true. */
     get includes() {
         const out = new Set(this.includeSet);
         if (this.commentsOption)
             out.add('comments');
         return out;
     }
-    /** `comments: true` or `include: comments`. */
+    /** `comments: true`, the one setting (REQ-504, WD 0.91). */
     get comments() {
-        return this.commentsOption || this.includeSet.has('comments');
+        return this.commentsOption;
     }
     set comments(value) {
         this.commentsOption = value;
@@ -215,18 +322,21 @@ export class TextOptions {
         const o = new TextOptions();
         Object.assign(o, this);
         o.includeSet = new Set(this.includeSet);
+        o.explicit = new Set(this.explicit);
         return o;
     }
     /** The options as the specification names them, with their values, in section 10's order. */
     toMap() {
+        var _a;
         return {
             view: this.view, include: [...this.includeSet], text_boxes: this.textBoxes, notes: this.notes,
             note_references: this.noteReferences, comments: this.commentsOption, hidden: this.hidden,
-            field_codes: this.fieldCodes, fields: this.fields, toc: this.toc, placeholders: this.placeholders,
+            field_codes: this.fieldCodes, fields: this.fields, toc: this.toc, drop_caps: this.dropCaps, placeholders: this.placeholders,
             bindings: this.bindings, list_labels: this.listLabels, charts: this.charts, smartart: this.smartart,
             embedded: this.embedded, altchunks: this.altchunks, alt_text: this.altText, metadata: this.metadata,
-            symbols: this.symbols, math: this.math, tables: this.tables, markup_detail: this.markupDetail,
-            page_markers: this.pageMarkers, layout: this.layout, warnings: this.warnings,
+            symbols: this.symbols, small_caps: this.smallCaps, default_language: this.defaultLanguage, math: this.math, tables: this.tables, markup_detail: this.markupDetail,
+            page_markers: this.pageMarkers, layout: this.layout, warnings: this.warnings, repair: this.repair,
+            profile: (_a = this.profileName) !== null && _a !== void 0 ? _a : null,
         };
     }
     toJSON() {
@@ -251,6 +361,13 @@ export class TextOptions {
         }
     }
 }
+/** A profile's name as the WD writes it (`word-text`), case-insensitively, a hyphen or an underscore. */
+function profileOf(value) {
+    const s = String(value).trim();
+    if (s.toLowerCase().replace(/_/g, '-') === 'word-text')
+        return 'word-text';
+    throw new TextOptionError(`profile: '${s}' is not one of word-text (WD REQ-1002)`, 'profile', 'REQ-1002', 'invalid');
+}
 function viewOf(value) {
     const n = String(value !== null && value !== void 0 ? value : '').trim().toLowerCase();
     if (n === 'current')
@@ -269,6 +386,30 @@ function bool(name, value, statement) {
         return false;
     throw new TextOptionError(`${name}: '${String(value)}' is not true or false (WD REQ-1001)`, name, statement, 'invalid');
 }
+/**
+ * RFC 5646's `Language-Tag` (section 2.1): a `langtag`, a private-use tag or a grandfathered one, case-insensitively. A
+ * tag this grammar accepts is well formed (section 2.2.9); whether its subtags are registered is not asked.
+ */
+const LANGUAGE_TAG = new RegExp('^(?:'
+    + '(?:[a-z]{2,3}(?:-[a-z]{3}){0,3}|[a-z]{4}|[a-z]{5,8})' // language, with up to three extlang
+    + '(?:-[a-z]{4})?' // script
+    + '(?:-(?:[a-z]{2}|[0-9]{3}))?' // region
+    + '(?:-(?:[a-z0-9]{5,8}|[0-9][a-z0-9]{3}))*' // variants
+    + '(?:-[a-wyz0-9](?:-[a-z0-9]{2,8})+)*' // extensions
+    + '(?:-x(?:-[a-z0-9]{1,8})+)?' // private use
+    + '|x(?:-[a-z0-9]{1,8})+'
+    + '|en-GB-oed|i-(?:ami|bnn|default|enochian|hak|klingon|lux|mingo|navajo|pwn|tao|tay|tsu)|sgn-(?:BE-FR|BE-NL|CH-DE)'
+    + ')$', 'i');
+/**
+ * A BCP 47 tag as given, trimmed; one RFC 5646's grammar refuses is refused, so that a mistyped tag cannot select the
+ * default unnoticed (CR-012 section 24.8, D2).
+ */
+function languageTag(name, value, statement) {
+    const s = typeof value === 'string' ? value.trim() : '';
+    if (LANGUAGE_TAG.test(s))
+        return s;
+    throw new TextOptionError(`${name}: '${String(value)}' is not a well-formed BCP 47 language tag, such as en-US or tr-TR (WD ${statement})`, name, statement, 'invalid');
+}
 function choice(name, value, values, statement) {
     const s = String(value !== null && value !== void 0 ? value : '').trim().toLowerCase();
     const found = values.find((v) => v === s);