@stll/folio-core 0.46.0 → 0.47.0

package/dist/docx/parserEnums.d.ts

@@ -7,17 +7,15 @@ import * as v from "valibot";
  * no `as` at the call site.
  */
 declare const narrowEnum: <T extends string>(value: string | null | undefined, schema: v.PicklistSchema<readonly T[], undefined>) => T | undefined;
-declare const ThemeColorSlotSchema: v.PicklistSchema<readonly ["dk1", "lt1", "dk2", "lt2", "accent1", "accent2", "accent3", "accent4", "accent5", "accent6", "hlink", "folHlink", "background1", "text1", "background2", "text2"], undefined>;
-declare const BorderStyleSchema: v.PicklistSchema<readonly ["none", "single", "double", "dotted", "dashed", "thick", "triple", "thinThickSmallGap", "thickThinSmallGap", "thinThickMediumGap", "thickThinMediumGap", "thinThickLargeGap", "thickThinLargeGap", "wave", "doubleWave", "dashSmallGap", "dashDotStroked", "threeDEmboss", "threeDEngrave", "outset", "inset", "nil"], undefined>;
 declare const UnderlineStyleSchema: v.PicklistSchema<readonly ["none", "single", "words", "double", "thick", "dotted", "dottedHeavy", "dash", "dashedHeavy", "dashLong", "dashLongHeavy", "dotDash", "dashDotHeavy", "dotDotDash", "dashDotDotHeavy", "wave", "wavyHeavy", "wavyDouble"], undefined>;
 declare const HighlightColorSchema: v.PicklistSchema<readonly ["black", "blue", "cyan", "darkBlue", "darkCyan", "darkGray", "darkGreen", "darkMagenta", "darkRed", "darkYellow", "green", "lightGray", "magenta", "none", "red", "white", "yellow"], undefined>;
 declare const TextEffectSchema: v.PicklistSchema<readonly ["none", "blinkBackground", "lights", "antsBlack", "antsRed", "shimmer", "sparkle"], undefined>;
 declare const EmphasisMarkSchema: v.PicklistSchema<readonly ["none", "dot", "comma", "circle", "underDot"], undefined>;
 declare const FontThemeSchema: v.PicklistSchema<readonly ["majorAscii", "majorHAnsi", "majorEastAsia", "majorBidi", "minorAscii", "minorHAnsi", "minorEastAsia", "minorBidi"], undefined>;
 declare const FontHintSchema: v.PicklistSchema<readonly ["default", "eastAsia", "cs"], undefined>;
-declare const ParagraphAlignmentSchema: v.PicklistSchema<readonly ["left", "center", "right", "both", "distribute", "mediumKashida", "highKashida", "lowKashida", "thaiDistribute"], undefined>;
+declare const ParagraphAlignmentSchema: v.PicklistSchema<readonly ["start", "center", "end", "both", "mediumKashida", "distribute", "numTab", "highKashida", "lowKashida", "thaiDistribute", "left", "right"], undefined>;
 declare const LineSpacingRuleSchema: v.PicklistSchema<readonly ["auto", "exact", "atLeast"], undefined>;
-declare const TabStopAlignmentSchema: v.PicklistSchema<readonly ["left", "center", "right", "decimal", "bar", "clear", "num"], undefined>;
+declare const TabStopAlignmentSchema: v.PicklistSchema<readonly ["clear", "start", "center", "end", "decimal", "bar", "num", "left", "right"], undefined>;
 declare const TabLeaderSchema: v.PicklistSchema<readonly ["none", "dot", "hyphen", "underscore", "heavy", "middleDot"], undefined>;
 declare const PositionalTabRelativeToSchema: v.PicklistSchema<readonly ["margin", "indent"], undefined>;
 declare const PositionalTabAlignmentSchema: v.PicklistSchema<readonly ["left", "center", "right"], undefined>;
@@ -29,9 +27,10 @@ declare const SdtLockSchema: v.PicklistSchema<readonly ["sdtLocked", "contentLoc
 declare const FieldTypeSchema: v.PicklistSchema<readonly ["PAGE", "NUMPAGES", "NUMWORDS", "NUMCHARS", "DATE", "TIME", "CREATEDATE", "SAVEDATE", "PRINTDATE", "AUTHOR", "TITLE", "SUBJECT", "KEYWORDS", "COMMENTS", "FILENAME", "FILESIZE", "TEMPLATE", "DOCPROPERTY", "DOCVARIABLE", "REF", "PAGEREF", "NOTEREF", "HYPERLINK", "TOC", "TOA", "INDEX", "SEQ", "STYLEREF", "AUTONUM", "AUTONUMLGL", "AUTONUMOUT", "LISTNUM", "IF", "MERGEFIELD", "NEXT", "NEXTIF", "ASK", "SET", "QUOTE", "INCLUDETEXT", "INCLUDEPICTURE", "SYMBOL", "ADVANCE", "EDITTIME", "REVNUM", "SECTION", "SECTIONPAGES", "USERADDRESS", "USERNAME", "USERINITIALS", "UNKNOWN"], undefined>;
 declare const StyleTypeSchema: v.PicklistSchema<readonly ["paragraph", "character", "numbering", "table"], undefined>;
 declare const ConditionalStyleTypeSchema: v.PicklistSchema<readonly ["band1Horz", "band1Vert", "band2Horz", "band2Vert", "firstCol", "firstRow", "lastCol", "lastRow", "neCell", "nwCell", "seCell", "swCell", "wholeTable"], undefined>;
+declare const TableAlignmentSchema: v.PicklistSchema<readonly ["center", "end", "left", "right", "start"], undefined>;
 declare const TableWidthTypeSchema: v.PicklistSchema<readonly ["auto", "dxa", "nil", "pct"], undefined>;
 declare const TableRowHeightRuleSchema: v.PicklistSchema<readonly ["auto", "atLeast", "exact"], undefined>;
-declare const TableCellTextDirectionSchema: v.PicklistSchema<readonly ["lr", "lrV", "rl", "rlV", "tb", "tbV", "tbRl", "tbRlV", "btLr"], undefined>;
+declare const TextDirectionSchema: v.PicklistSchema<readonly ["tb", "rl", "lr", "tbV", "rlV", "lrV", "btLr", "lrTb", "lrTbV", "tbLrV", "tbRl", "tbRlV"], undefined>;
 declare const ShadingPatternSchema: v.PicklistSchema<readonly ["clear", "solid", "horzStripe", "vertStripe", "reverseDiagStripe", "diagStripe", "horzCross", "diagCross", "thinHorzStripe", "thinVertStripe", "thinReverseDiagStripe", "thinDiagStripe", "thinHorzCross", "thinDiagCross", "pct5", "pct10", "pct12", "pct15", "pct20", "pct25", "pct30", "pct35", "pct37", "pct40", "pct45", "pct50", "pct55", "pct60", "pct62", "pct65", "pct70", "pct75", "pct80", "pct85", "pct87", "pct90", "pct95", "nil"], undefined>;
 declare const FloatingTableXSpecSchema: v.PicklistSchema<readonly ["left", "center", "right", "inside", "outside"], undefined>;
 declare const FloatingTableYSpecSchema: v.PicklistSchema<readonly ["top", "center", "bottom", "inside", "outside", "inline"], undefined>;
@@ -40,9 +39,8 @@ declare const ImageHorizontalAlignmentSchema: v.PicklistSchema<readonly ["left",
 declare const ImageVerticalRelativeToSchema: v.PicklistSchema<readonly ["insideMargin", "line", "margin", "outsideMargin", "page", "paragraph", "topMargin", "bottomMargin"], undefined>;
 declare const ImageVerticalAlignmentSchema: v.PicklistSchema<readonly ["top", "bottom", "center", "inside", "outside"], undefined>;
 declare const ImageWrapTextSchema: v.PicklistSchema<readonly ["bothSides", "left", "right", "largest"], undefined>;
-declare const ShapeOutlineStyleSchema: v.PicklistSchema<readonly ["solid", "dot", "dash", "lgDash", "dashDot", "lgDashDot", "lgDashDotDot", "sysDot", "sysDash", "sysDashDot", "sysDashDotDot"], undefined>;
 declare const ShapeTypeSchema: v.PicklistSchema<readonly ["rect", "roundRect", "ellipse", "triangle", "rtTriangle", "parallelogram", "trapezoid", "pentagon", "hexagon", "heptagon", "octagon", "decagon", "dodecagon", "star4", "star5", "star6", "star7", "star8", "star10", "star12", "star16", "star24", "star32", "line", "straightConnector1", "bentConnector2", "bentConnector3", "bentConnector4", "bentConnector5", "curvedConnector2", "curvedConnector3", "curvedConnector4", "curvedConnector5", "rightArrow", "leftArrow", "upArrow", "downArrow", "leftRightArrow", "upDownArrow", "quadArrow", "leftRightUpArrow", "bentArrow", "uturnArrow", "leftUpArrow", "bentUpArrow", "curvedRightArrow", "curvedLeftArrow", "curvedUpArrow", "curvedDownArrow", "stripedRightArrow", "notchedRightArrow", "homePlate", "chevron", "rightArrowCallout", "downArrowCallout", "leftArrowCallout", "upArrowCallout", "leftRightArrowCallout", "quadArrowCallout", "circularArrow", "flowChartProcess", "flowChartAlternateProcess", "flowChartDecision", "flowChartInputOutput", "flowChartPredefinedProcess", "flowChartInternalStorage", "flowChartDocument", "flowChartMultidocument", "flowChartTerminator", "flowChartPreparation", "flowChartManualInput", "flowChartManualOperation", "flowChartConnector", "flowChartOffpageConnector", "flowChartPunchedCard", "flowChartPunchedTape", "flowChartSummingJunction", "flowChartOr", "flowChartCollate", "flowChartSort", "flowChartExtract", "flowChartMerge", "flowChartOnlineStorage", "flowChartDelay", "flowChartMagneticTape", "flowChartMagneticDisk", "flowChartMagneticDrum", "flowChartDisplay", "wedgeRectCallout", "wedgeRoundRectCallout", "wedgeEllipseCallout", "cloudCallout", "borderCallout1", "borderCallout2", "borderCallout3", "accentCallout1", "accentCallout2", "accentCallout3", "callout1", "callout2", "callout3", "accentBorderCallout1", "accentBorderCallout2", "accentBorderCallout3", "actionButtonBlank", "actionButtonHome", "actionButtonHelp", "actionButtonInformation", "actionButtonBackPrevious", "actionButtonForwardNext", "actionButtonBeginning", "actionButtonEnd", "actionButtonReturn", "actionButtonDocument", "actionButtonSound", "actionButtonMovie", "irregularSeal1", "irregularSeal2", "frame", "halfFrame", "corner", "diagStripe", "chord", "arc", "bracketPair", "bracePair", "leftBracket", "rightBracket", "leftBrace", "rightBrace", "can", "cube", "bevel", "donut", "noSmoking", "blockArc", "foldedCorner", "smileyFace", "heart", "lightningBolt", "sun", "moon", "cloud", "snip1Rect", "snip2SameRect", "snip2DiagRect", "snipRoundRect", "round1Rect", "round2SameRect", "round2DiagRect", "plaque", "teardrop", "mathPlus", "mathMinus", "mathMultiply", "mathDivide", "mathEqual", "mathNotEqual", "gear6", "gear9", "funnel", "pieWedge", "pie", "leftCircularArrow", "leftRightCircularArrow", "swooshArrow", "textBox"], undefined>;
-declare const NumberFormatSchema: v.PicklistSchema<readonly ["decimal", "upperRoman", "lowerRoman", "upperLetter", "lowerLetter", "ordinal", "cardinalText", "ordinalText", "hex", "chicago", "ideographDigital", "japaneseCounting", "aiueo", "iroha", "decimalFullWidth", "decimalHalfWidth", "japaneseLegal", "japaneseDigitalTenThousand", "decimalEnclosedCircle", "decimalFullWidth2", "aiueoFullWidth", "irohaFullWidth", "decimalZero", "decimalZero3", "decimalZero4", "decimalZero5", "bullet", "ganada", "chosung", "decimalEnclosedFullstop", "decimalEnclosedParen", "decimalEnclosedCircleChinese", "ideographEnclosedCircle", "ideographTraditional", "ideographZodiac", "ideographZodiacTraditional", "taiwaneseCounting", "ideographLegalTraditional", "taiwaneseCountingThousand", "taiwaneseDigital", "chineseCounting", "chineseLegalSimplified", "chineseCountingThousand", "koreanDigital", "koreanCounting", "koreanLegal", "koreanDigital2", "vietnameseCounting", "russianLower", "russianUpper", "none", "numberInDash", "hebrew1", "hebrew2", "arabicAlpha", "arabicAbjad", "hindiVowels", "hindiConsonants", "hindiNumbers", "hindiCounting", "thaiLetters", "thaiNumbers", "thaiCounting"], undefined>;
+declare const NumberFormatSchema: v.PicklistSchema<readonly ["decimal", "upperRoman", "lowerRoman", "upperLetter", "lowerLetter", "ordinal", "cardinalText", "ordinalText", "hex", "chicago", "ideographDigital", "japaneseCounting", "aiueo", "iroha", "decimalFullWidth", "decimalHalfWidth", "japaneseLegal", "japaneseDigitalTenThousand", "decimalEnclosedCircle", "decimalFullWidth2", "aiueoFullWidth", "irohaFullWidth", "decimalZero", "bullet", "ganada", "chosung", "decimalEnclosedFullstop", "decimalEnclosedParen", "decimalEnclosedCircleChinese", "ideographEnclosedCircle", "ideographTraditional", "ideographZodiac", "ideographZodiacTraditional", "taiwaneseCounting", "ideographLegalTraditional", "taiwaneseCountingThousand", "taiwaneseDigital", "chineseCounting", "chineseLegalSimplified", "chineseCountingThousand", "koreanDigital", "koreanCounting", "koreanLegal", "koreanDigital2", "vietnameseCounting", "russianLower", "russianUpper", "none", "numberInDash", "hebrew1", "hebrew2", "arabicAlpha", "arabicAbjad", "hindiVowels", "hindiConsonants", "hindiNumbers", "hindiCounting", "thaiLetters", "thaiNumbers", "thaiCounting", "bahtText", "dollarText", "custom"], undefined>;
 declare const LevelSuffixSchema: v.PicklistSchema<readonly ["tab", "space", "nothing"], undefined>;
 //#endregion
-export { BorderStyleSchema, ConditionalStyleTypeSchema, EmphasisMarkSchema, FieldTypeSchema, FloatingTableXSpecSchema, FloatingTableYSpecSchema, FontHintSchema, FontThemeSchema, FrameWrapSchema, FrameXAlignSchema, FrameYAlignSchema, HighlightColorSchema, ImageHorizontalAlignmentSchema, ImageHorizontalRelativeToSchema, ImageVerticalAlignmentSchema, ImageVerticalRelativeToSchema, ImageWrapTextSchema, LevelSuffixSchema, LineSpacingRuleSchema, NumberFormatSchema, ParagraphAlignmentSchema, PositionalTabAlignmentSchema, PositionalTabLeaderSchema, PositionalTabRelativeToSchema, SdtLockSchema, ShadingPatternSchema, ShapeOutlineStyleSchema, ShapeTypeSchema, StyleTypeSchema, TabLeaderSchema, TabStopAlignmentSchema, TableCellTextDirectionSchema, TableRowHeightRuleSchema, TableWidthTypeSchema, TextEffectSchema, ThemeColorSlotSchema, UnderlineStyleSchema, narrowEnum };
+export { ConditionalStyleTypeSchema, EmphasisMarkSchema, FieldTypeSchema, FloatingTableXSpecSchema, FloatingTableYSpecSchema, FontHintSchema, FontThemeSchema, FrameWrapSchema, FrameXAlignSchema, FrameYAlignSchema, HighlightColorSchema, ImageHorizontalAlignmentSchema, ImageHorizontalRelativeToSchema, ImageVerticalAlignmentSchema, ImageVerticalRelativeToSchema, ImageWrapTextSchema, LevelSuffixSchema, LineSpacingRuleSchema, NumberFormatSchema, ParagraphAlignmentSchema, PositionalTabAlignmentSchema, PositionalTabLeaderSchema, PositionalTabRelativeToSchema, SdtLockSchema, ShadingPatternSchema, ShapeTypeSchema, StyleTypeSchema, TabLeaderSchema, TabStopAlignmentSchema, TableAlignmentSchema, TableRowHeightRuleSchema, TableWidthTypeSchema, TextDirectionSchema, TextEffectSchema, UnderlineStyleSchema, narrowEnum };

package/dist/docx/parserEnums.js

@@ -1,4 +1,4 @@
-import { BORDER_STYLE_VALUES, CONDITIONAL_STYLE_TYPE_VALUES, EMPHASIS_MARK_VALUES, FIELD_TYPE_VALUES, FLOATING_TABLE_X_SPEC_VALUES, FLOATING_TABLE_Y_SPEC_VALUES, FONT_HINT_VALUES, FONT_THEME_VALUES, FRAME_WRAP_VALUES, FRAME_X_ALIGN_VALUES, FRAME_Y_ALIGN_VALUES, HIGHLIGHT_COLOR_VALUES, IMAGE_HORIZONTAL_ALIGNMENT_VALUES, IMAGE_HORIZONTAL_RELATIVE_TO_VALUES, IMAGE_VERTICAL_ALIGNMENT_VALUES, IMAGE_VERTICAL_RELATIVE_TO_VALUES, IMAGE_WRAP_TEXT_VALUES, LEVEL_SUFFIX_VALUES, LINE_SPACING_RULE_VALUES, NUMBER_FORMAT_VALUES, PARAGRAPH_ALIGNMENT_VALUES, POSITIONAL_TAB_ALIGNMENT_VALUES, POSITIONAL_TAB_LEADER_VALUES, POSITIONAL_TAB_RELATIVE_TO_VALUES, SDT_LOCK_VALUES, SHADING_PATTERN_VALUES, SHAPE_OUTLINE_STYLE_VALUES, SHAPE_TYPE_VALUES, STYLE_TYPE_VALUES, TABLE_CELL_TEXT_DIRECTION_VALUES, TABLE_ROW_HEIGHT_RULE_VALUES, TABLE_WIDTH_TYPE_VALUES, TAB_LEADER_VALUES, TAB_STOP_ALIGNMENT_VALUES, TEXT_EFFECT_VALUES, THEME_COLOR_SLOT_VALUES, UNDERLINE_STYLE_VALUES } from "../types/documentEnumValues.js";
+import { CONDITIONAL_STYLE_TYPE_VALUES, EMPHASIS_MARK_VALUES, FIELD_TYPE_VALUES, FLOATING_TABLE_X_SPEC_VALUES, FLOATING_TABLE_Y_SPEC_VALUES, FONT_HINT_VALUES, FONT_THEME_VALUES, FRAME_WRAP_VALUES, FRAME_X_ALIGN_VALUES, FRAME_Y_ALIGN_VALUES, HIGHLIGHT_COLOR_VALUES, IMAGE_HORIZONTAL_ALIGNMENT_VALUES, IMAGE_HORIZONTAL_RELATIVE_TO_VALUES, IMAGE_VERTICAL_ALIGNMENT_VALUES, IMAGE_VERTICAL_RELATIVE_TO_VALUES, IMAGE_WRAP_TEXT_VALUES, LEVEL_SUFFIX_VALUES, LINE_SPACING_RULE_VALUES, NUMBER_FORMAT_VALUES, PARAGRAPH_ALIGNMENT_VALUES, POSITIONAL_TAB_ALIGNMENT_VALUES, POSITIONAL_TAB_LEADER_VALUES, POSITIONAL_TAB_RELATIVE_TO_VALUES, SDT_LOCK_VALUES, SHADING_PATTERN_VALUES, SHAPE_TYPE_VALUES, STYLE_TYPE_VALUES, TABLE_JUSTIFICATION_VALUES, TABLE_ROW_HEIGHT_RULE_VALUES, TABLE_WIDTH_TYPE_VALUES, TAB_LEADER_VALUES, TAB_STOP_ALIGNMENT_VALUES, TEXT_DIRECTION_VALUES, TEXT_EFFECT_VALUES, UNDERLINE_STYLE_VALUES } from "../types/documentEnumValues.js";
 import * as v from "valibot";
 //#region src/docx/parserEnums.ts
 /**
@@ -33,8 +33,6 @@ const narrowEnum = (value, schema) => {
 	const result = v.safeParse(schema, value);
 	return result.success ? result.output : void 0;
 };
-const ThemeColorSlotSchema = v.picklist(THEME_COLOR_SLOT_VALUES);
-const BorderStyleSchema = v.picklist(BORDER_STYLE_VALUES);
 const UnderlineStyleSchema = v.picklist(UNDERLINE_STYLE_VALUES);
 const HighlightColorSchema = v.picklist(HIGHLIGHT_COLOR_VALUES);
 const TextEffectSchema = v.picklist(TEXT_EFFECT_VALUES);
@@ -55,9 +53,10 @@ const SdtLockSchema = v.picklist(SDT_LOCK_VALUES);
 const FieldTypeSchema = v.picklist(FIELD_TYPE_VALUES);
 const StyleTypeSchema = v.picklist(STYLE_TYPE_VALUES);
 const ConditionalStyleTypeSchema = v.picklist(CONDITIONAL_STYLE_TYPE_VALUES);
+const TableAlignmentSchema = v.picklist(TABLE_JUSTIFICATION_VALUES);
 const TableWidthTypeSchema = v.picklist(TABLE_WIDTH_TYPE_VALUES);
 const TableRowHeightRuleSchema = v.picklist(TABLE_ROW_HEIGHT_RULE_VALUES);
-const TableCellTextDirectionSchema = v.picklist(TABLE_CELL_TEXT_DIRECTION_VALUES);
+const TextDirectionSchema = v.picklist(TEXT_DIRECTION_VALUES);
 const ShadingPatternSchema = v.picklist(SHADING_PATTERN_VALUES);
 const FloatingTableXSpecSchema = v.picklist(FLOATING_TABLE_X_SPEC_VALUES);
 const FloatingTableYSpecSchema = v.picklist(FLOATING_TABLE_Y_SPEC_VALUES);
@@ -66,9 +65,8 @@ const ImageHorizontalAlignmentSchema = v.picklist(IMAGE_HORIZONTAL_ALIGNMENT_VAL
 const ImageVerticalRelativeToSchema = v.picklist(IMAGE_VERTICAL_RELATIVE_TO_VALUES);
 const ImageVerticalAlignmentSchema = v.picklist(IMAGE_VERTICAL_ALIGNMENT_VALUES);
 const ImageWrapTextSchema = v.picklist(IMAGE_WRAP_TEXT_VALUES);
-const ShapeOutlineStyleSchema = v.picklist(SHAPE_OUTLINE_STYLE_VALUES);
 const ShapeTypeSchema = v.picklist(SHAPE_TYPE_VALUES);
 const NumberFormatSchema = v.picklist(NUMBER_FORMAT_VALUES);
 const LevelSuffixSchema = v.picklist(LEVEL_SUFFIX_VALUES);
 //#endregion
-export { BorderStyleSchema, ConditionalStyleTypeSchema, EmphasisMarkSchema, FieldTypeSchema, FloatingTableXSpecSchema, FloatingTableYSpecSchema, FontHintSchema, FontThemeSchema, FrameWrapSchema, FrameXAlignSchema, FrameYAlignSchema, HighlightColorSchema, ImageHorizontalAlignmentSchema, ImageHorizontalRelativeToSchema, ImageVerticalAlignmentSchema, ImageVerticalRelativeToSchema, ImageWrapTextSchema, LevelSuffixSchema, LineSpacingRuleSchema, NumberFormatSchema, ParagraphAlignmentSchema, PositionalTabAlignmentSchema, PositionalTabLeaderSchema, PositionalTabRelativeToSchema, SdtLockSchema, ShadingPatternSchema, ShapeOutlineStyleSchema, ShapeTypeSchema, StyleTypeSchema, TabLeaderSchema, TabStopAlignmentSchema, TableCellTextDirectionSchema, TableRowHeightRuleSchema, TableWidthTypeSchema, TextEffectSchema, ThemeColorSlotSchema, UnderlineStyleSchema, narrowEnum };
+export { ConditionalStyleTypeSchema, EmphasisMarkSchema, FieldTypeSchema, FloatingTableXSpecSchema, FloatingTableYSpecSchema, FontHintSchema, FontThemeSchema, FrameWrapSchema, FrameXAlignSchema, FrameYAlignSchema, HighlightColorSchema, ImageHorizontalAlignmentSchema, ImageHorizontalRelativeToSchema, ImageVerticalAlignmentSchema, ImageVerticalRelativeToSchema, ImageWrapTextSchema, LevelSuffixSchema, LineSpacingRuleSchema, NumberFormatSchema, ParagraphAlignmentSchema, PositionalTabAlignmentSchema, PositionalTabLeaderSchema, PositionalTabRelativeToSchema, SdtLockSchema, ShadingPatternSchema, ShapeTypeSchema, StyleTypeSchema, TabLeaderSchema, TabStopAlignmentSchema, TableAlignmentSchema, TableRowHeightRuleSchema, TableWidthTypeSchema, TextDirectionSchema, TextEffectSchema, UnderlineStyleSchema, narrowEnum };

package/dist/docx/preservedRunContent.js

@@ -52,13 +52,23 @@ const preserveRunChild = (element) => ({
 *
 * `w:customXml` and `w:smartTag` are transparent wrappers (ECMA-376 §17.5.1,
 * §17.5.1.9): their content is ordinary inline content, so their `w:t`
-* descendants are on the line. Every other inline child folio captures —
-* `w:permStart`, `w:proofErr` and the custom-XML revision ranges — is an
-* empty marker, and an element folio has never seen contributes nothing on
-* purpose, because guessing at its text would put invented words in a
-* document.
+* descendants are on the line. A `w:hyperlink` and a `w:fldSimple` are here
+* for the same reason and only in one place — inside another link or another
+* field, where folio captures the inner one rather than modelling the nesting.
+* Their runs print like any other; a capture that kept the markup and not the
+* words would take a linked clause off the page.
+*
+* Every other inline child folio captures — `w:permStart`, `w:proofErr` and
+* the custom-XML revision ranges — is an empty marker, and an element folio
+* has never seen contributes nothing on purpose, because guessing at its text
+* would put invented words in a document.
 */
-const VISIBLE_TEXT_INLINE_CHILDREN = /* @__PURE__ */ new Set(["customXml", "smartTag"]);
+const VISIBLE_TEXT_INLINE_CHILDREN = /* @__PURE__ */ new Set([
+	"customXml",
+	"fldSimple",
+	"hyperlink",
+	"smartTag"
+]);
 /**
 * One capture from the shared dispatcher's sink, as a member of the
 * container's own inline union.

package/dist/docx/previewBudget.d.ts

@@ -15,44 +15,65 @@
  * would have stopped the other charging for it without anything failing. The
  * table below is that agreement written once, and a producer builds its image
  * out of the entry the budget matches against.
+ *
+ * An entry says what backs the preview, because that decides what there is to
+ * agree on. A source-backed preview is image data in `src`, recognized by the
+ * strings its producer stamps on it and charged by the character. A
+ * descriptor-backed preview is no picture at all, so it carries none of those
+ * strings: a table that offered them would be offering a cap over nothing and
+ * a prefix nothing can start with.
  */
-declare const VML_PREVIEW_DATA_URL_PREFIX = "data:image/svg+xml;charset=utf-8,";
+type PreviewKindName = "vmlShape" | "wpGroup" | "smartArt";
 declare const PREVIEW_KINDS: {
   /** A VML shape folio renders rather than projects (`v:shape`, `v:rect`, ...). */
   readonly vmlShape: {
+    readonly backing: "source";
     readonly mimeType: "image/svg+xml";
     readonly filename: "vml-shape-preview.svg";
     readonly srcPrefix: "data:image/svg+xml;charset=utf-8,";
     readonly maxPackageCharacters: number;
   };
   /**
-   * A SmartArt diagram: its extent filled with one flat rectangle per shape.
+   * A WordprocessingGroup (`wpg:wgp`) folio renders rather than projects.
    *
-   * A raster rather than a vector because the display list decodes only base64
-   * PNG and JPEG, so a vector preview would be missing from every display-list
-   * backend (PDF among them) while still showing in the DOM. That is what
-   * makes this preview expensive: one of them is 7.3 MB of data URL whatever
-   * the package weighs, because its cost follows the extent the author chose
-   * rather than anything the drawing contains.
+   * The group's shapes, their text and any picture they carry are drawn into
+   * one SVG, so a package with many groups retains as much generated text as a
+   * package of VML shapes does, from a producer bounded per drawing the same
+   * way. It was missing from this table, which is not a preview with a generous
+   * cap but a preview with none: the matcher below never named it, so no
+   * package was ever charged for one.
+   */
+  readonly wpGroup: {
+    readonly backing: "source";
+    readonly mimeType: "image/svg+xml";
+    readonly filename: "wordprocessing-group.svg";
+    readonly srcPrefix: "data:image/svg+xml;charset=utf-8,";
+    readonly maxPackageCharacters: number;
+  };
+  /**
+   * A SmartArt diagram: its extent filled with one flat rectangle per shape.
    *
-   * Across the public corpus, the fifty packages that produce one retain a
-   * median of 7.3 MB and a maximum of 51.3 MB (ten previews, from a package
-   * under a megabyte). The cap is set above that maximum: it refuses no
-   * legitimate file in the corpus while bounding what had no bound at all, and
-   * it is a ceiling rather than a fix. The fix is for the preview to be a
-   * descriptor the renderer rasterizes, which needs the display-list contract
-   * to carry one.
+   * It used to be a raster in `src`, because the display list decoded only
+   * base64 PNG and JPEG and a vector preview would have been missing from
+   * every backend but the DOM. That cost 7.3 MB of data URL per diagram
+   * whatever the package weighed, up to 51.3 MB in one corpus package, because
+   * it followed the extent the author chose rather than anything the drawing
+   * contained. It is a `PreviewDescriptor` now, which both backends draw, and
+   * the bound on it is the shape cap the parse applies to the description.
    */
   readonly smartArt: {
-    readonly mimeType: "image/png";
-    readonly filename: "smartart-preview.png";
-    readonly srcPrefix: "data:image/png;base64,";
-    readonly maxPackageCharacters: number;
+    readonly backing: "descriptor";
   };
 };
-type PreviewKindName = keyof typeof PREVIEW_KINDS;
-/** Per-kind allowances for one package, defaulting to the table's caps. */
-type PreviewBudgetOverrides = Partial<Record<PreviewKindName, number>>;
+/** The kinds a package charges: those whose preview is image data it retains. */
+type SourceBackedKindName = { [Name in PreviewKindName]: (typeof PREVIEW_KINDS)[Name]["backing"] extends "source" ? Name : never; }[PreviewKindName];
+/**
+ * Per-kind allowances for one package, defaulting to the table's caps.
+ *
+ * Only a source-backed kind has an allowance: there is no number that would
+ * change what the budget does to a descriptor.
+ */
+type PreviewBudgetOverrides = Partial<Record<SourceBackedKindName, number>>;
 /**
  * Charge every generated preview in the model against its kind's allowance and
  * drop the `src` of those past it. Dropping leaves the image in place with its
@@ -61,4 +82,4 @@ type PreviewBudgetOverrides = Partial<Record<PreviewKindName, number>>;
  */
 declare const enforcePackagePreviewBudget: (root: unknown, overrides?: PreviewBudgetOverrides) => void;
 //#endregion
-export { PREVIEW_KINDS, PreviewBudgetOverrides, VML_PREVIEW_DATA_URL_PREFIX, enforcePackagePreviewBudget };
+export { PREVIEW_KINDS, PreviewBudgetOverrides, enforcePackagePreviewBudget };

package/dist/docx/previewBudget.js

@@ -1,49 +1,80 @@
 //#region src/docx/previewBudget.ts
-const VML_PREVIEW_DATA_URL_PREFIX = "data:image/svg+xml;charset=utf-8,";
-const MEBIBYTE = 1024 * 1024;
+/** Both SVG producers encode their drawing into the URL rather than base64. */
+const SVG_PREVIEW_DATA_URL_PREFIX = "data:image/svg+xml;charset=utf-8,";
+/**
+* Eight times what a producer may spend on one drawing, which is a package
+* holding a handful of the largest previews folio will build.
+*/
+const SVG_PREVIEW_PACKAGE_CHARACTERS = 8 * (1024 * 1024);
 const PREVIEW_KINDS = {
 	/** A VML shape folio renders rather than projects (`v:shape`, `v:rect`, ...). */
 	vmlShape: {
+		backing: "source",
 		mimeType: "image/svg+xml",
 		filename: "vml-shape-preview.svg",
-		srcPrefix: VML_PREVIEW_DATA_URL_PREFIX,
-		maxPackageCharacters: 8 * MEBIBYTE
+		srcPrefix: SVG_PREVIEW_DATA_URL_PREFIX,
+		maxPackageCharacters: SVG_PREVIEW_PACKAGE_CHARACTERS
 	},
 	/**
-	* A SmartArt diagram: its extent filled with one flat rectangle per shape.
+	* A WordprocessingGroup (`wpg:wgp`) folio renders rather than projects.
 	*
-	* A raster rather than a vector because the display list decodes only base64
-	* PNG and JPEG, so a vector preview would be missing from every display-list
-	* backend (PDF among them) while still showing in the DOM. That is what
-	* makes this preview expensive: one of them is 7.3 MB of data URL whatever
-	* the package weighs, because its cost follows the extent the author chose
-	* rather than anything the drawing contains.
+	* The group's shapes, their text and any picture they carry are drawn into
+	* one SVG, so a package with many groups retains as much generated text as a
+	* package of VML shapes does, from a producer bounded per drawing the same
+	* way. It was missing from this table, which is not a preview with a generous
+	* cap but a preview with none: the matcher below never named it, so no
+	* package was ever charged for one.
+	*/
+	wpGroup: {
+		backing: "source",
+		mimeType: "image/svg+xml",
+		filename: "wordprocessing-group.svg",
+		srcPrefix: SVG_PREVIEW_DATA_URL_PREFIX,
+		maxPackageCharacters: SVG_PREVIEW_PACKAGE_CHARACTERS
+	},
+	/**
+	* A SmartArt diagram: its extent filled with one flat rectangle per shape.
 	*
-	* Across the public corpus, the fifty packages that produce one retain a
-	* median of 7.3 MB and a maximum of 51.3 MB (ten previews, from a package
-	* under a megabyte). The cap is set above that maximum: it refuses no
-	* legitimate file in the corpus while bounding what had no bound at all, and
-	* it is a ceiling rather than a fix. The fix is for the preview to be a
-	* descriptor the renderer rasterizes, which needs the display-list contract
-	* to carry one.
+	* It used to be a raster in `src`, because the display list decoded only
+	* base64 PNG and JPEG and a vector preview would have been missing from
+	* every backend but the DOM. That cost 7.3 MB of data URL per diagram
+	* whatever the package weighed, up to 51.3 MB in one corpus package, because
+	* it followed the extent the author chose rather than anything the drawing
+	* contained. It is a `PreviewDescriptor` now, which both backends draw, and
+	* the bound on it is the shape cap the parse applies to the description.
 	*/
-	smartArt: {
-		mimeType: "image/png",
-		filename: "smartart-preview.png",
-		srcPrefix: "data:image/png;base64,",
-		maxPackageCharacters: 64 * MEBIBYTE
-	}
+	smartArt: { backing: "descriptor" }
 };
 const KIND_NAMES = Object.keys(PREVIEW_KINDS);
 /**
+* Whether a package charges this kind, narrowing the name to a source-backed
+* one: the predicate reads the same field `SourceBackedKindName` selects on.
+*/
+const isSourceBacked = (name) => {
+	const kind = PREVIEW_KINDS[name];
+	switch (kind.backing) {
+		case "source": return true;
+		case "descriptor": return false;
+		default: return kind;
+	}
+};
+const SOURCE_BACKED_KIND_NAMES = KIND_NAMES.filter(isSourceBacked);
+/**
 * The kind a model image was generated as, or `undefined` for one the package
-* actually carries. A generated preview has no relationship behind it, so
-* `rId` is empty; the filename and data-URL prefix name which producer made it.
+* actually carries. A generated preview has no relationship behind it; the
+* filename and data-URL prefix name which producer made it.
+*
+* "No relationship" is read as the one spelling `RelationshipId` leaves: a
+* field that is absent or `undefined`. The walk takes an unvalidated object,
+* so the check stays, but it no longer has a second spelling to accept.
+*
+* Only a source-backed kind can be named this way. A descriptor-backed preview
+* has no `src` to match, so no image the model carries can be charged to it.
 */
 const previewKindOf = (value) => {
-	if (!("type" in value) || value.type !== "image" || !("rId" in value) || value.rId !== "" || !("src" in value) || typeof value.src !== "string" || !("mimeType" in value) || !("filename" in value)) return;
+	if (!("type" in value) || value.type !== "image" || "rId" in value && value.rId !== void 0 || !("src" in value) || typeof value.src !== "string" || !("mimeType" in value) || !("filename" in value)) return;
 	const { src, mimeType, filename } = value;
-	return KIND_NAMES.find((name) => {
+	return SOURCE_BACKED_KIND_NAMES.find((name) => {
 		const kind = PREVIEW_KINDS[name];
 		return mimeType === kind.mimeType && filename === kind.filename && src.startsWith(kind.srcPrefix);
 	});
@@ -55,7 +86,7 @@ const previewKindOf = (value) => {
 * and never touches the preserved XML the package saves from.
 */
 const enforcePackagePreviewBudget = (root, overrides = {}) => {
-	const remaining = new Map(KIND_NAMES.map((name) => [name, Math.max(0, overrides[name] ?? PREVIEW_KINDS[name].maxPackageCharacters)]));
+	const remaining = new Map(SOURCE_BACKED_KIND_NAMES.map((name) => [name, Math.max(0, overrides[name] ?? PREVIEW_KINDS[name].maxPackageCharacters)]));
 	const visited = /* @__PURE__ */ new WeakSet();
 	const visit = (value) => {
 		if (value === null || typeof value !== "object" || visited.has(value)) return;
@@ -85,4 +116,4 @@ const enforcePackagePreviewBudget = (root, overrides = {}) => {
 	visit(root);
 };
 //#endregion
-export { PREVIEW_KINDS, VML_PREVIEW_DATA_URL_PREFIX, enforcePackagePreviewBudget };
+export { PREVIEW_KINDS, enforcePackagePreviewBudget };

package/dist/docx/propertyElementAttributes.d.ts

@@ -0,0 +1,178 @@
+//#region src/docx/propertyElementAttributes.d.ts
+/**
+ * Which attributes of a property element the model has a field for.
+ *
+ * A property element is an attribute bag: `w:ind`, `w:spacing`, `w:framePr`,
+ * `w:tab`, a `w:pBdr` side, `w:shd`. The child dispatcher decides them whole —
+ * a handler either reads the element or hands back its bytes — and that is
+ * exactly as far as it goes. `<w:ind w:leftChars="100"/>` is kept entire
+ * because the reader took nothing from it, and `<w:ind w:left="720"
+ * w:leftChars="100"/>` is modelled and loses the character unit, because the
+ * reader took something. The census measures one attribute at a time, so the
+ * second case reported as surviving.
+ *
+ * The fix is the attribute remainder that `w:p`'s `w:rsid*` attributes already
+ * ride, applied one level down: every attribute with no model field is kept on
+ * the record, decided on the resolved local name, written back by
+ * `serializePreservedAttributes`. The remainder predicate has to be derived
+ * from the model rather than hand-listed, or it is a mirror of the reader and
+ * drifts the first time a field is added — so each table below is
+ * `as const satisfies ModelledAttributes<…>` over the record's own fields, and
+ * a field that gains no entry does not compile.
+ *
+ * The tables live together, in a module with no runtime dependencies, because
+ * three callers consult them: the reader (to compute the remainder), and the
+ * container-survival census (to state a subject attribute beside a modelled
+ * sibling, which is what catches a whole-or-nothing reader at all). The writer
+ * needs no copy: it hands the fragments it is about to emit to
+ * `serializePreservedAttributes`, which drops a remainder entry that would
+ * spell one of them again.
+ *
+ * A field may name more than one attribute. `ParagraphFormatting.indentLeft`
+ * is filled from `w:left` or from the Strict `w:start`, and both have to be
+ * out of the remainder or a save writes the same indent twice under two
+ * spellings.
+ */
+/**
+ * The attributes one record's fields are read from, keyed by field.
+ *
+ * `Record`, never `Partial<Record>`: the key set is the record's own fields,
+ * so a field that has no attribute to name has to say so with an empty list
+ * rather than by being absent.
+ */
+type ModelledAttributes<Field extends string> = Readonly<Record<Field, string | readonly string[]>>;
+/**
+ * `w:ind`. `hangingIndent` is the sign of `indentFirstLine` rather than a
+ * value of its own, so both name the attribute pair that carries it.
+ */
+declare const INDENTATION_ATTRIBUTES: {
+  readonly indentLeft: readonly ["left", "start"];
+  readonly indentRight: readonly ["right", "end"];
+  readonly indentFirstLine: readonly ["firstLine", "hanging"];
+  readonly hangingIndent: "hanging";
+};
+/**
+ * `w:spacing`. `spacingExplicit` records which of the two sides the paragraph
+ * stated itself; it is derived from them and reads no attribute of its own.
+ */
+declare const SPACING_ATTRIBUTES: {
+  readonly spaceBefore: "before";
+  readonly spaceAfter: "after";
+  readonly lineSpacing: "line";
+  readonly lineSpacingRule: "lineRule";
+  readonly beforeAutospacing: "beforeAutospacing";
+  readonly afterAutospacing: "afterAutospacing";
+  readonly spacingExplicit: readonly [];
+};
+declare const FRAME_ATTRIBUTES: {
+  readonly dropCap: "dropCap";
+  readonly lines: "lines";
+  readonly width: "w";
+  readonly height: "h";
+  readonly hSpace: "hSpace";
+  readonly vSpace: "vSpace";
+  readonly hAnchor: "hAnchor";
+  readonly vAnchor: "vAnchor";
+  readonly x: "x";
+  readonly y: "y";
+  readonly xAlign: "xAlign";
+  readonly yAlign: "yAlign";
+  readonly wrap: "wrap";
+};
+declare const TAB_STOP_ATTRIBUTES: {
+  readonly position: "pos";
+  readonly alignment: "val";
+  readonly leader: "leader";
+};
+/**
+ * `CT_Border`. The five art relationship ids are in the relationships
+ * namespace; the remainder decides on the local name, so naming them here
+ * keeps a `r:topLeft` out of it.
+ */
+declare const BORDER_ATTRIBUTES: {
+  readonly style: "val";
+  readonly color: readonly ["color", "themeColor", "themeTint", "themeShade"];
+  readonly size: "sz";
+  readonly space: "space";
+  readonly shadow: "shadow";
+  readonly frame: "frame";
+  readonly artRelationshipId: "id";
+  readonly topLeftArtRelationshipId: "topLeft";
+  readonly topRightArtRelationshipId: "topRight";
+  readonly bottomLeftArtRelationshipId: "bottomLeft";
+  readonly bottomRightArtRelationshipId: "bottomRight";
+};
+/** `CT_Shd`: direct, theme, modifier, and pattern attributes all have model fields. */
+declare const SHADING_ATTRIBUTES: {
+  readonly color: readonly ["color", "themeColor", "themeTint", "themeShade"];
+  readonly fill: readonly ["fill", "themeFill", "themeFillTint", "themeFillShade"];
+  readonly pattern: "val";
+};
+/**
+ * The same tables by the complex type whose attributes they answer for, in
+ * the order the model declares the fields.
+ *
+ * The census reads this: to catch a whole-or-nothing reader it has to state
+ * the subject attribute *beside* one the element models, and which one that
+ * is has to come from the model rather than from a list in the census. The
+ * first entry is the one it picks.
+ */
+declare const PROPERTY_ELEMENT_ATTRIBUTES: {
+  readonly CT_Ind: {
+    readonly indentLeft: readonly ["left", "start"];
+    readonly indentRight: readonly ["right", "end"];
+    readonly indentFirstLine: readonly ["firstLine", "hanging"];
+    readonly hangingIndent: "hanging";
+  };
+  readonly CT_Spacing: {
+    readonly spaceBefore: "before";
+    readonly spaceAfter: "after";
+    readonly lineSpacing: "line";
+    readonly lineSpacingRule: "lineRule";
+    readonly beforeAutospacing: "beforeAutospacing";
+    readonly afterAutospacing: "afterAutospacing";
+    readonly spacingExplicit: readonly [];
+  };
+  readonly CT_FramePr: {
+    readonly dropCap: "dropCap";
+    readonly lines: "lines";
+    readonly width: "w";
+    readonly height: "h";
+    readonly hSpace: "hSpace";
+    readonly vSpace: "vSpace";
+    readonly hAnchor: "hAnchor";
+    readonly vAnchor: "vAnchor";
+    readonly x: "x";
+    readonly y: "y";
+    readonly xAlign: "xAlign";
+    readonly yAlign: "yAlign";
+    readonly wrap: "wrap";
+  };
+  readonly CT_TabStop: {
+    readonly position: "pos";
+    readonly alignment: "val";
+    readonly leader: "leader";
+  };
+  readonly CT_Border: {
+    readonly style: "val";
+    readonly color: readonly ["color", "themeColor", "themeTint", "themeShade"];
+    readonly size: "sz";
+    readonly space: "space";
+    readonly shadow: "shadow";
+    readonly frame: "frame";
+    readonly artRelationshipId: "id";
+    readonly topLeftArtRelationshipId: "topLeft";
+    readonly topRightArtRelationshipId: "topRight";
+    readonly bottomLeftArtRelationshipId: "bottomLeft";
+    readonly bottomRightArtRelationshipId: "bottomRight";
+  };
+  readonly CT_Shd: {
+    readonly color: readonly ["color", "themeColor", "themeTint", "themeShade"];
+    readonly fill: readonly ["fill", "themeFill", "themeFillTint", "themeFillShade"];
+    readonly pattern: "val";
+  };
+};
+/** Every attribute local name a table names, flattened, in field order. */
+declare const modelledAttributeNames: (modelled: ModelledAttributes<string>) => readonly string[];
+//#endregion
+export { BORDER_ATTRIBUTES, FRAME_ATTRIBUTES, INDENTATION_ATTRIBUTES, ModelledAttributes, PROPERTY_ELEMENT_ATTRIBUTES, SHADING_ATTRIBUTES, SPACING_ATTRIBUTES, TAB_STOP_ATTRIBUTES, modelledAttributeNames };