abstract-document 20.0.3 → 20.1.0

package/src/abstract-document-exporters/pdf/textRunRow.ts

@@ -8,17 +8,25 @@ type LongWordSplit = {
   readonly width: number;
 };
 
-export function rowsSplit(rows: ReadonlyArray<ReadonlyArray<AD.Atom.Atom>>, availableWidth: number, desiredSizes: Map<{}, AD.Size.Size>, alignment: PdfKitAlignment, pdf: PDFKit.PDFDocument, resources: AD.Resources.Resources, defaultStyle: AD.TextStyle.TextStyle): ReadonlyArray<ReadonlyArray<AD.Atom.Atom>> {
+export function rowsSplit(
+  rows: ReadonlyArray<ReadonlyArray<AD.Atom.Atom>>,
+  availableWidth: number,
+  desiredSizes: Map<object, AD.Size.Size>,
+  alignment: PdfKitAlignment,
+  pdf: PDFKit.PDFDocument,
+  resources: AD.Resources.Resources,
+  defaultStyle: AD.TextStyle.TextStyle
+): ReadonlyArray<ReadonlyArray<AD.Atom.Atom>> {
   const newRows: Array<ReadonlyArray<AD.Atom.Atom>> = [];
 
-  for(const row of rows) {
-    if(row.length < 1) {
+  for (const row of rows) {
+    if (row.length < 1) {
       newRows.push(row);
       continue;
     }
-    
+
     const width = row.reduce((a, b) => a + getDesiredSize(b, desiredSizes).width, 0);
-    if(width < availableWidth) {
+    if (width < availableWidth) {
       newRows.push(row);
       continue;
     }
@@ -28,45 +36,41 @@ export function rowsSplit(rows: ReadonlyArray<ReadonlyArray<AD.Atom.Atom>>, avai
     let currentWidth = 0;
     let lastWasSpace = false;
 
-    for(let i = 0; i < row.length; i++) {
+    for (let i = 0; i < row.length; i++) {
       const atom = row[i];
       const size = getDesiredSize(atom, desiredSizes);
       const width = size.width;
       const height = size.height;
 
-      if(atom.type !== "TextRun") {
+      if (atom.type !== "TextRun") {
         currentRow.push(atom);
         currentWidth += width;
         continue;
       }
 
-      
-      const isSpace = atom.text.replaceAll(/[\p{Zs}]/ug, "").length === 0;
+      const isSpace = atom.text.replaceAll(/[\p{Zs}]/gu, "").length === 0;
       const lastSpace = lastWasSpace;
       lastWasSpace = isSpace;
 
       //if the next atom is a space, we need to split this row early if it doesnt fit
       const nextAtom = row[i + 1];
-      const nextWidthIfSpace = 
-        !isSpace
-        && nextAtom
-        && nextAtom.type === "TextRun"
-        && nextAtom.text.replaceAll(/[\p{Zs}]/ug, "").length === 0
+      const nextWidthIfSpace =
+        !isSpace && nextAtom?.type === "TextRun" && nextAtom.text.replaceAll(/[\p{Zs}]/gu, "").length === 0
           ? getDesiredSize(nextAtom, desiredSizes).width
           : 0;
 
-      if(isSpace && currentWidth === 0 && i !== 0 && (alignment === "left" || alignment === "justify")) {
+      if (isSpace && currentWidth === 0 && i !== 0 && (alignment === "left" || alignment === "justify")) {
         continue;
       }
-      
-      if((currentWidth + width + nextWidthIfSpace) < availableWidth) {
+
+      if (currentWidth + width + nextWidthIfSpace < availableWidth) {
         currentRow.push(atom);
         currentWidth += width;
         continue;
       }
 
       //was it a space??
-      if(isSpace) {
+      if (isSpace) {
         newRows.push(currentRow);
         currentRow = [];
         currentWidth = 0;
@@ -76,10 +80,10 @@ export function rowsSplit(rows: ReadonlyArray<ReadonlyArray<AD.Atom.Atom>>, avai
       //it is now longer than the remaning size
       const remSize = availableWidth - (currentWidth + nextWidthIfSpace);
       const splittedWord = splitWord(atom, remSize, availableWidth, pdf, resources, defaultStyle);
-      if(splittedWord.length > 0) {
+      if (splittedWord.length > 0) {
         const heightPerRow = height / splittedWord.length;
         const [first, ...rest] = splittedWord;
-        if(!first && !rest) {
+        if (!first && !rest) {
           continue;
         }
         //add the first to the current row
@@ -88,7 +92,7 @@ export function rowsSplit(rows: ReadonlyArray<ReadonlyArray<AD.Atom.Atom>>, avai
         currentRow.push(newFirstRowAtom);
 
         //then add new rows
-        for(const part of rest ?? []) {
+        for (const part of rest ?? []) {
           newRows.push(currentRow);
           const newAtom = { ...atom, text: part.text };
           desiredSizes.set(newAtom, { width: part.width, height: heightPerRow });
@@ -98,11 +102,11 @@ export function rowsSplit(rows: ReadonlyArray<ReadonlyArray<AD.Atom.Atom>>, avai
         continue;
       }
 
-      newRows.push((lastSpace && (alignment === "right" || alignment === "justify")) ? currentRow.slice(0, -1) : currentRow);
+      newRows.push(lastSpace && (alignment === "right" || alignment === "justify") ? currentRow.slice(0, -1) : currentRow);
       currentRow = [atom];
       currentWidth = width;
     }
-    newRows.push((lastWasSpace && (alignment === "right" || alignment === "justify")) ? currentRow.slice(0, -1) : currentRow);
+    newRows.push(lastWasSpace && (alignment === "right" || alignment === "justify") ? currentRow.slice(0, -1) : currentRow);
   }
   return newRows;
 }
@@ -110,27 +114,34 @@ export function rowsSplit(rows: ReadonlyArray<ReadonlyArray<AD.Atom.Atom>>, avai
 /*
   the first entry fits inside the current row
 */
-function splitWord(word: AD.TextRun.TextRun, firstRowRemainingWidth: number, rowWidth: number, pdf: PDFKit.PDFDocument, resources: AD.Resources.Resources, defaultStyle: AD.TextStyle.TextStyle): ReadonlyArray<LongWordSplit> {
+function splitWord(
+  word: AD.TextRun.TextRun,
+  firstRowRemainingWidth: number,
+  rowWidth: number,
+  pdf: PDFKit.PDFDocument,
+  resources: AD.Resources.Resources,
+  defaultStyle: AD.TextStyle.TextStyle
+): ReadonlyArray<LongWordSplit> {
   const strings: Array<LongWordSplit> = [];
   const totalWidth = stringWidth(word, pdf, word.text, resources, defaultStyle);
-  if(totalWidth < rowWidth) {
+  if (totalWidth < rowWidth) {
     return [];
   }
 
   let currentString = "";
   let atFirstRow = true;
-  for(const char of word.text) {
+  for (const char of word.text) {
     const remWidth = atFirstRow ? firstRowRemainingWidth : rowWidth;
     const newString = currentString + char;
     const newWidth = stringWidth(word, pdf, newString, resources, defaultStyle);
-    if(newWidth < remWidth) {
+    if (newWidth < remWidth) {
       currentString = newString;
       continue;
     }
 
     strings.push({
       text: currentString,
-      width: newWidth
+      width: newWidth,
     });
 
     //reset
@@ -139,19 +150,26 @@ function splitWord(word: AD.TextRun.TextRun, firstRowRemainingWidth: number, row
   }
 
   //add any remainder
-  if(currentString !== "") {
+  if (currentString !== "") {
     const newWidth = stringWidth(word, pdf, currentString, resources, defaultStyle);
     strings.push({
       text: currentString,
-      width: newWidth
+      width: newWidth,
     });
   }
 
   return strings;
 }
 
-export function rowsCombineTextRuns(resources: AD.Resources.Resources, pdf: PDFKit.PDFDocument, rows: ReadonlyArray<ReadonlyArray<AD.Atom.Atom>>, desiredSizes: Map<{}, AD.Size.Size>, alignment: PdfKitAlignment, defaultStyle: AD.TextStyle.TextStyle): { newDesiredSizes: Map<{}, AD.Size.Size>; combinedRows: ReadonlyArray<ReadonlyArray<AD.Atom.Atom>> } {
-  if(alignment === "justify") {
+export function rowsCombineTextRuns(
+  resources: AD.Resources.Resources,
+  pdf: PDFKit.PDFDocument,
+  rows: ReadonlyArray<ReadonlyArray<AD.Atom.Atom>>,
+  desiredSizes: Map<object, AD.Size.Size>,
+  alignment: PdfKitAlignment,
+  defaultStyle: AD.TextStyle.TextStyle
+): { newDesiredSizes: Map<object, AD.Size.Size>; combinedRows: ReadonlyArray<ReadonlyArray<AD.Atom.Atom>> } {
+  if (alignment === "justify") {
     return { combinedRows: rows, newDesiredSizes: desiredSizes };
   }
 
@@ -161,31 +179,34 @@ export function rowsCombineTextRuns(resources: AD.Resources.Resources, pdf: PDFK
   let currentStyle: string = "";
 
   const newRows: Array<ReadonlyArray<AD.Atom.Atom>> = [];
-  for(const row of rows) {
+  for (const row of rows) {
     const newRow: Array<AD.Atom.Atom> = [];
     let isFirst = true;
 
-    for(let i = 0; i < row.length; i++) {
+    for (let i = 0; i < row.length; i++) {
       const atom = row[i];
       const isLast = i === row.length - 1;
       const measurement = getDesiredSize(atom, desiredSizes);
 
-      if(atom.type !== "TextRun") {
-        if(current !== undefined) {
+      if (atom.type !== "TextRun") {
+        if (current !== undefined) {
           const newTextRun = {
             ...current,
-            text: currentString
+            text: currentString,
           };
-          if(isFirst && alignment === "left") {
-            while(currentString.startsWith(" ")) {
+          if (isFirst && alignment === "left") {
+            while (currentString.startsWith(" ")) {
               currentString = currentString.slice(1);
             }
             isFirst = false;
-          } else if(isFirst) {
+          } else if (isFirst) {
             isFirst = false;
           }
           newRow.push(newTextRun);
-          desiredSizes.set(newTextRun, { width: stringWidth(current, pdf, currentString, resources, defaultStyle), height: currentHeight });
+          desiredSizes.set(newTextRun, {
+            width: stringWidth(current, pdf, currentString, resources, defaultStyle),
+            height: currentHeight,
+          });
           currentString = "";
           currentStyle = "";
           currentHeight = 0;
@@ -195,35 +216,33 @@ export function rowsCombineTextRuns(resources: AD.Resources.Resources, pdf: PDFK
         continue;
       }
 
-      const style = JSON.stringify(AD.Resources.getNestedStyle(
-        defaultStyle,
-        atom.style,
-        "TextStyle",
-        atom.styleName,
-        resources,
-        atom.nestedStyleNames || []
-      ));
+      const style = JSON.stringify(
+        AD.Resources.getNestedStyle(defaultStyle, atom.style, "TextStyle", atom.styleName, resources, atom.nestedStyleNames ?? [])
+      );
 
-      if(current === undefined) {
+      if (current === undefined) {
         currentString = atom.text;
         current = atom;
         currentHeight = Math.max(measurement.height, currentHeight);
         currentStyle = style;
-      } else if(style !== currentStyle) {
+      } else if (style !== currentStyle) {
         const newTextRun = {
           ...current,
-          text: currentString
+          text: currentString,
         };
-        if(isFirst && alignment === "left") {
-          while(currentString.startsWith(" ")) {
+        if (isFirst && alignment === "left") {
+          while (currentString.startsWith(" ")) {
             currentString = currentString.slice(1);
           }
           isFirst = false;
-        } else if(isFirst) {
+        } else if (isFirst) {
           isFirst = false;
         }
         newRow.push(newTextRun);
-        desiredSizes.set(newTextRun, { width: stringWidth(current, pdf, currentString, resources, defaultStyle), height: currentHeight });
+        desiredSizes.set(newTextRun, {
+          width: stringWidth(current, pdf, currentString, resources, defaultStyle),
+          height: currentHeight,
+        });
         currentString = atom.text;
         currentHeight = Math.max(measurement.height, currentHeight);
         current = atom;
@@ -233,16 +252,16 @@ export function rowsCombineTextRuns(resources: AD.Resources.Resources, pdf: PDFK
         currentHeight = Math.max(measurement.height, currentHeight);
       }
 
-      if(isLast) {
-        if(current) {
+      if (isLast) {
+        if (current) {
           //does the last contain spaces at the end?
-          if(alignment === "right") {
-            while(currentString.endsWith(" ")) {
+          if (alignment === "right") {
+            while (currentString.endsWith(" ")) {
               currentString = currentString.slice(0, -1);
             }
           }
-          if(isFirst && alignment === "left") {
-            while(currentString.startsWith(" ")) {
+          if (isFirst && alignment === "left") {
+            while (currentString.startsWith(" ")) {
               currentString = currentString.slice(1);
             }
             isFirst = false;
@@ -251,9 +270,12 @@ export function rowsCombineTextRuns(resources: AD.Resources.Resources, pdf: PDFK
           const newTextRun: AD.Atom.Atom = {
             ...current,
             text: currentString,
-          }
+          };
           newRow.push(newTextRun);
-          desiredSizes.set(newTextRun, { width: stringWidth(current, pdf, currentString, resources, defaultStyle), height: currentHeight });
+          desiredSizes.set(newTextRun, {
+            width: stringWidth(current, pdf, currentString, resources, defaultStyle),
+            height: currentHeight,
+          });
         }
       }
     }
@@ -273,25 +295,26 @@ function stringWidth(
   resources: AD.Resources.Resources,
   defaultStyle: AD.TextStyle.TextStyle
 ): number {
-  const style = AD.Resources.getNestedStyle(
-    defaultStyle,
-    textRun.style,
-    "TextStyle",
-    textRun.styleName,
-    resources,
-    textRun.nestedStyleNames || []
-  ) as AD.TextStyle.TextStyle ?? defaultStyle;
+  const style =
+    (AD.Resources.getNestedStyle(
+      defaultStyle,
+      textRun.style,
+      "TextStyle",
+      textRun.styleName,
+      resources,
+      textRun.nestedStyleNames ?? []
+    ) as AD.TextStyle.TextStyle) ?? defaultStyle;
 
   const font = getFontNameStyle(style);
   const fontSize = AD.TextStyle.calculateFontSize(style, 10);
   pdf
     .font(font)
     .fontSize(fontSize)
-    .fillColor(style.color || "black");
+    .fillColor(style.color ?? "black");
 
   const textOptions = {
-    underline: style.underline || false,
-    indent: style.indent || 0,
+    underline: style.underline ?? false,
+    indent: style.indent ?? 0,
     lineBreak: false,
     ...(style.characterSpacing !== undefined ? { characterSpacing: style.characterSpacing } : {}),
     ...(style.lineGap !== undefined ? { lineGap: style.lineGap } : {}),
@@ -299,10 +322,10 @@ function stringWidth(
   return pdf.widthOfString(text, textOptions);
 }
 
-function getDesiredSize(element: {}, desiredSizes: Map<{}, AD.Size.Size>): AD.Size.Size {
+function getDesiredSize(element: object, desiredSizes: Map<object, AD.Size.Size>): AD.Size.Size {
   const size = desiredSizes.get(element);
   if (size) {
     return size;
   }
   throw new Error("Could not find size for element!");
-}
+}

package/src/abstract-document-exporters/pdf/update-refs.ts

@@ -1,5 +1,5 @@
 import type * as AD from "../../abstract-document/index.js";
-import type { Page } from "./paginate.js";
+import type { Page } from "./page.js";
 
 export function updatePageRefs(pages: ReadonlyArray<Page>): Array<Page> {
   return pages.map((page) => updateRefsOnPage(page, pages));
@@ -23,18 +23,14 @@ function updateRefsInElements(
   pages: ReadonlyArray<Page>
 ): ReadonlyArray<AD.SectionElement.SectionElement> {
   const updatedElements = new Array<AD.SectionElement.SectionElement>();
-  for (let element of elements) {
+  for (const element of elements) {
     const updatedElement = updateRefsInElement(element, page, pages);
     updatedElements.push(updatedElement);
   }
   return updatedElements;
 }
 
-function updateRefsInElement(
-  element: AD.SectionElement.SectionElement,
-  page: Page,
-  pages: ReadonlyArray<Page>
-): AD.SectionElement.SectionElement {
+function updateRefsInElement(element: AD.SectionElement.SectionElement, page: Page, pages: ReadonlyArray<Page>): AD.SectionElement.SectionElement {
   switch (element.type) {
     case "Paragraph":
       return updateRefsInParagraph(element, page, pages);
@@ -47,11 +43,7 @@ function updateRefsInElement(
   }
 }
 
-function updateRefsInParagraph(
-  paragraph: AD.Paragraph.Paragraph,
-  page: Page,
-  pages: ReadonlyArray<Page>
-): AD.SectionElement.SectionElement {
+function updateRefsInParagraph(paragraph: AD.Paragraph.Paragraph, page: Page, pages: ReadonlyArray<Page>): AD.SectionElement.SectionElement {
   const updatedChildren = paragraph.children.map((atom) => updateRefInAtom(atom, page, pages));
   return {
     ...paragraph,
@@ -59,11 +51,7 @@ function updateRefsInParagraph(
   };
 }
 
-function updateRefsInTable(
-  table: AD.Table.Table,
-  page: Page,
-  pages: ReadonlyArray<Page>
-): AD.SectionElement.SectionElement {
+function updateRefsInTable(table: AD.Table.Table, page: Page, pages: ReadonlyArray<Page>): AD.SectionElement.SectionElement {
   const updatedChildren = table.children.map((row) => updateRefsInTableRow(row, page, pages));
   return {
     ...table,
@@ -79,11 +67,7 @@ function updateRefsInTableRow(row: AD.TableRow.TableRow, page: Page, pages: Read
   };
 }
 
-function updateRefsInTableCell(
-  cell: AD.TableCell.TableCell,
-  page: Page,
-  pages: ReadonlyArray<Page>
-): AD.TableCell.TableCell {
+function updateRefsInTableCell(cell: AD.TableCell.TableCell, page: Page, pages: ReadonlyArray<Page>): AD.TableCell.TableCell {
   const updatedChildren = cell.children.map((element) => updateRefsInElement(element, page, pages));
   return {
     ...cell,
@@ -91,11 +75,7 @@ function updateRefsInTableCell(
   };
 }
 
-function updateRefsInGroup(
-  group: AD.Group.Group,
-  page: Page,
-  pages: ReadonlyArray<Page>
-): AD.SectionElement.SectionElement {
+function updateRefsInGroup(group: AD.Group.Group, page: Page, pages: ReadonlyArray<Page>): AD.SectionElement.SectionElement {
   const updatedChildren = group.children.map((element) => updateRefsInElement(element, page, pages));
   return {
     ...group,
@@ -111,11 +91,7 @@ function updateRefInAtom(atom: AD.Atom.Atom, page: Page, pages: ReadonlyArray<Pa
   }
 }
 
-function updateRefInTextField(
-  textField: AD.TextField.TextField,
-  page: Page,
-  pages: ReadonlyArray<Page>
-): AD.TextField.TextField {
+function updateRefInTextField(textField: AD.TextField.TextField, page: Page, pages: ReadonlyArray<Page>): AD.TextField.TextField {
   switch (textField.fieldType) {
     case "PageNumber":
       return {
@@ -127,7 +103,7 @@ function updateRefInTextField(
         ...textField,
         text: pages.length.toString(),
       };
-    case "PageNumberOf":
+    case "PageNumberOf": {
       const targetPage = pages.find((p) => p.namedDestionations.some((dest) => dest === textField.target));
       if (targetPage) {
         return {
@@ -137,6 +113,7 @@ function updateRefInTextField(
       } else {
         return textField;
       }
+    }
     default:
       return textField;
   }

package/src/abstract-document-exporters/shared/get_resources.ts

@@ -1,14 +1,14 @@
 import { exhaustiveCheck } from "ts-exhaustive-check";
 import type { AbstractDoc } from "../../abstract-document/abstract-doc.js";
+import type { Section } from "../../abstract-document/page/section.js";
 import type { Resources } from "../../abstract-document/resources.js";
 import { mergeResources } from "../../abstract-document/resources.js";
 import type { Group } from "../../abstract-document/section-elements/group.js";
-import type { Table } from "../../abstract-document/section-elements/table.js";
-import type { SectionElement } from "../../abstract-document/section-elements/section-element.js";
 import type { Paragraph } from "../../abstract-document/section-elements/paragraph.js";
-import type { Section } from "../../abstract-document/page/section.js";
-import type { TableRow } from "../../abstract-document/table/table-row.js";
+import type { SectionElement } from "../../abstract-document/section-elements/section-element.js";
+import type { Table } from "../../abstract-document/section-elements/table.js";
 import type { TableCell } from "../../abstract-document/table/table-cell.js";
+import type { TableRow } from "../../abstract-document/table/table-row.js";
 
 export function getResources(doc: AbstractDoc): Resources {
   const resources = doc.children.map((s) => getResourcesSection(s));

package/src/abstract-document-jsx/index.ts

@@ -17,52 +17,64 @@ import {
   PageBreak as PageBreak1,
   LineBreak as LineBreak1,
 } from "../abstract-document/index.js";
+import type { SectionElement as SectionElement1, Atom as Atom1 } from "../abstract-document/index.js";
 
 export interface ChildrenProp {
   readonly children?: Child;
 }
 export type Child = React.JSX.Element | Children;
-export interface Children extends ReadonlyArray<Child> {}
+export type Children = ReadonlyArray<Child>;
 
+// These factories build a real AD tree, structurally incompatible with React.JSX.Element (the fake
+// type this JSX pragma requires). Every cast below just bridges the two via `unknown`; there's no real type fix.
 export const AbstractDoc = (props?: AbstractDoc1.AbstractDocProps & ChildrenProp): React.JSX.Element =>
-  AbstractDoc1.create(props, props && (props.children as any)) as any;
+  AbstractDoc1.create(props, props && (props.children as unknown as ReadonlyArray<Section1.Section>)) as unknown as React.JSX.Element;
 export const Section = (props?: Section1.SectionProps & ChildrenProp): React.JSX.Element =>
-  Section1.create(props, props && (props.children as any)) as any;
+  Section1.create(props, props && (props.children as unknown as ReadonlyArray<SectionElement1.SectionElement>)) as unknown as React.JSX.Element;
 export const Group = (props: Group1.GroupProps & ChildrenProp): React.JSX.Element =>
-  Group1.create(props, props && (props.children as any)) as any;
+  Group1.create(props, props && (props.children as unknown as ReadonlyArray<SectionElement1.SectionElement>)) as unknown as React.JSX.Element;
 export const Paragraph = (props: Paragraph1.ParagraphProps & ChildrenProp): React.JSX.Element =>
-  Paragraph1.create(props, props && (props.children as any)) as any;
+  Paragraph1.create(props, props && (props.children as unknown as ReadonlyArray<Atom1.Atom>)) as unknown as React.JSX.Element;
 export const Table = (props: Table1.TableProps & ChildrenProp): React.JSX.Element =>
-  Table1.create(props, props && (props.children as any)) as any;
+  Table1.create(props, props && (props.children as unknown as ReadonlyArray<TableRow1.TableRow>)) as unknown as React.JSX.Element;
 export const TableRow = (props: TableRow1.TableRowProps & ChildrenProp): React.JSX.Element =>
-  TableRow1.create(props, props && (props.children as any)) as any;
+  TableRow1.create(props, props && (props.children as unknown as ReadonlyArray<TableCell1.TableCell>)) as unknown as React.JSX.Element;
 export const TableCell = (props: TableCell1.TableCellProps & ChildrenProp): React.JSX.Element =>
-  TableCell1.create(props, props && (props.children as any)) as any;
-export const HyperLink = (props: HyperLink1.HyperLinkProps): React.JSX.Element => HyperLink1.create(props) as any;
-export const LinkTarget = (props: LinkTarget1.LinkTargetProps): React.JSX.Element => LinkTarget1.create(props) as any;
-export const Image = (props: Image1.ImageProps): React.JSX.Element => Image1.create(props) as any;
+  TableCell1.create(props, props && (props.children as unknown as ReadonlyArray<SectionElement1.SectionElement>)) as unknown as React.JSX.Element;
+export const HyperLink = (props: HyperLink1.HyperLinkProps): React.JSX.Element => HyperLink1.create(props) as unknown as React.JSX.Element;
+export const LinkTarget = (props: LinkTarget1.LinkTargetProps): React.JSX.Element => LinkTarget1.create(props) as unknown as React.JSX.Element;
+export const Image = (props: Image1.ImageProps): React.JSX.Element => Image1.create(props) as unknown as React.JSX.Element;
 export const TocSeparator = (props: TocSeparator1.TocSeparatorProps): React.JSX.Element =>
-  TocSeparator1.create(props) as any;
-export const Markdown = (props: Markdown1.MarkdownProps): React.JSX.Element => Markdown1.create(props) as any;
-export const TextField = (props: TextField1.TextFieldProps): React.JSX.Element => TextField1.create(props) as any;
-export const TextRun = (props: TextRun1.TextRunProps): React.JSX.Element => TextRun1.create(props) as any;
-export const PageBreak = (props: PageBreak1.PageBreakProps): React.JSX.Element => PageBreak1.create(props) as any;
-export const LineBreak = (props: LineBreak1.LineBreakProps): React.JSX.Element => LineBreak1.create(props) as any;
+  TocSeparator1.create(props) as unknown as React.JSX.Element;
+export const Markdown = (props: Markdown1.MarkdownProps): React.JSX.Element => Markdown1.create(props) as unknown as React.JSX.Element;
+export const TextField = (props: TextField1.TextFieldProps): React.JSX.Element => TextField1.create(props) as unknown as React.JSX.Element;
+export const TextRun = (props: TextRun1.TextRunProps): React.JSX.Element => TextRun1.create(props) as unknown as React.JSX.Element;
+export const PageBreak = (props: PageBreak1.PageBreakProps): React.JSX.Element => PageBreak1.create(props) as unknown as React.JSX.Element;
+export const LineBreak = (props: LineBreak1.LineBreakProps): React.JSX.Element => LineBreak1.create(props) as unknown as React.JSX.Element;
 
-export function render(element: any): any {
-  if (typeof element.type !== "function") {
-    return element;
+// Shape actually accessed when walking the fake element tree at runtime; `type`'s props param and
+// `props` itself are a genuinely arbitrary bag of component props, not a fixed structural type.
+interface FakeElement {
+  readonly type: string | ((props: Record<string, unknown>) => unknown);
+  readonly props?: { readonly children?: unknown; readonly [key: string]: unknown };
+}
+
+// oxlint-disable-next-line typescript/no-explicit-any -- callers assign the result to whichever AD model type they expect at that call site; narrowing this would break every caller
+export function render(element: unknown): any {
+  const el = element as FakeElement;
+  if (typeof el.type !== "function") {
+    return el;
   }
-  const props = element.props || {};
-  const children = renderChildren(element);
-  return (element.type as any)({ ...props, children });
+  const props = el.props ?? {};
+  const children = renderChildren(el);
+  return el.type({ ...props, children });
 }
 
-function renderChildren(element: React.ReactElement<any>): any {
-  if (!element.props || !element.props.children) {
+function renderChildren(element: FakeElement): Array<unknown> {
+  if (!element.props?.children) {
     return [];
   } else if (Array.isArray(element.props.children)) {
-    return element.props.children.flatMap((c: any) => {
+    return element.props.children.flatMap((c: unknown) => {
       if (!c) {
         return [];
       }