abstract-document 20.2.1 → 20.2.3

package/src/abstract-document-xml/abstract-doc-of-xml/creator.ts

@@ -4,7 +4,10 @@ import {
   AbstractDoc,
   DefaultStyles,
   Group,
+  HyperLink,
   Image,
+  LineBreak,
+  LinkTarget,
   Markdown,
   PageBreak,
   Paragraph,
@@ -18,7 +21,17 @@ import {
   ImageResource,
 } from "../../abstract-document/index.js";
 import type { ImageCellProps, ImageParagraphProps, ImageRowProps } from "./custom-elements.js";
-import { TextRow, TextCell, TextParagraph, ImageCell, ImageParagraph, ImageRow } from "./custom-elements.js";
+import {
+  TextRow,
+  TextCell,
+  TextParagraph,
+  HyperLinkRow,
+  HyperLinkCell,
+  HyperLinkParagraph,
+  ImageCell,
+  ImageParagraph,
+  ImageRow,
+} from "./custom-elements.js";
 
 export type ADCreatorFn = (props?: Record<string, unknown>, children?: ReadonlyArray<unknown>) => unknown;
 
@@ -30,7 +43,14 @@ export const creators: (styleNames: Record<string, string>) => Record<string, AD
     TextRow: (props) => TextRow({ ...props, text: requireText(props) }, styleNames),
     TextCell: (props) => TextCell({ ...props, text: requireText(props) }, styleNames),
     TextParagraph: (props) => TextParagraph({ ...props, text: requireText(props) }, styleNames),
+    HyperLinkRow: (props) => HyperLinkRow({ ...props, text: requireText(props), target: requireTarget(props, "HyperLinkRow") }, styleNames),
+    HyperLinkParagraph: (props) =>
+      HyperLinkParagraph({ ...props, text: requireText(props), target: requireTarget(props, "HyperLinkParagraph") }, styleNames),
+    HyperLinkCell: (props) => HyperLinkCell({ ...props, text: requireText(props), target: requireTarget(props, "HyperLinkCell") }, styleNames),
     TextRun: (props) => TextRun.create({ ...props, text: requireText(props) }),
+    HyperLink: (props) => HyperLink.create({ ...props, text: requireText(props), target: requireTarget(props, "HyperLink") }),
+    LinkTarget: (props) => LinkTarget.create({ name: requireName(props) }),
+    LineBreak: (props) => LineBreak.create(props),
     ImageRow: ((props: Record<string, unknown>) => ImageRow(imageProps(props) as unknown as ImageRowProps, styleNames)) as ADCreatorFn,
     ImageCell: ((props: Record<string, unknown>) => ImageCell(imageProps(props) as unknown as ImageCellProps, styleNames)) as ADCreatorFn,
     ImageParagraph: ((props: Record<string, unknown>) =>
@@ -346,6 +366,22 @@ function requireText(props: Record<string, unknown> | undefined): string {
   return typeof text === "string" ? text : "";
 }
 
+function requireTarget(props: Record<string, unknown> | undefined, element: string): string {
+  const target = props?.["target"];
+  if (typeof target !== "string") {
+    throw new Error(`<${element}> requires a "target" attribute`);
+  }
+  return target;
+}
+
+function requireName(props: Record<string, unknown> | undefined): string {
+  const name = props?.["name"];
+  if (typeof name !== "string") {
+    throw new Error('<LinkTarget> requires a "name" attribute');
+  }
+  return name;
+}
+
 const validFieldTypes: ReadonlyArray<TextField.FieldType> = ["Date", "PageNumber", "TotalPages", "PageNumberOf"];
 
 function requireFieldType(props: Record<string, unknown> | undefined): TextField.FieldType {

package/src/abstract-document-xml/abstract-doc-of-xml/custom-elements.tsx

@@ -1,6 +1,6 @@
 import type { ImageProps } from "../../abstract-document/atoms/image.js";
 import type { TextStyle, ParagraphStyle, TableCellStyle } from "../../abstract-document/index.js";
-import { TextRun, Paragraph, TableCell, TableRow, Image } from "../../abstract-document/index.js";
+import { TextRun, Paragraph, TableCell, TableRow, Image, HyperLink } from "../../abstract-document/index.js";
 import type { ParagraphProps } from "../../abstract-document/section-elements/paragraph.js";
 //dummy2
 
@@ -87,6 +87,47 @@ export function TextParagraph(props: TextParagraphProps, styleNameTypes: Record<
   return Paragraph.create({ style, styleName: styleNames.ParagraphStyle }, [textRun]);
 }
 
+export type HyperLinkParagraphProps = TextParagraphProps & {
+  readonly target: string;
+};
+
+export function HyperLinkParagraph(props: HyperLinkParagraphProps, styleNameTypes: Record<string, string>): Paragraph.Paragraph {
+  const { text, target, textStyle, style } = props;
+  const styleNames = extractStyleNames(props.styleNames, styleNameTypes);
+  const hyperLink = HyperLink.create({
+    text,
+    target,
+    style: textStyle ? { ...textStyle, type: "TextStyle" } : undefined,
+    styleName: styleNames.TextStyle,
+  });
+  return Paragraph.create({ style, styleName: styleNames.ParagraphStyle }, [hyperLink]);
+}
+
+export type HyperLinkCellProps = Omit<HyperLinkParagraphProps, "style"> & {
+  readonly columnSpan?: number;
+  readonly rowSpan?: number;
+  readonly style?: TableCellStyle.TableCellStyle;
+  readonly paragraphStyle?: ParagraphStyle.ParagraphStyle;
+};
+
+export function HyperLinkCell(props: HyperLinkCellProps, styleNameTypes: Record<string, string>): TableCell.TableCell {
+  const { paragraphStyle, style, columnSpan, rowSpan } = props;
+  const styleNames = extractStyleNames(props.styleNames, styleNameTypes);
+  const paragraph = HyperLinkParagraph(
+    { ...props, style: paragraphStyle ? { ...paragraphStyle, type: "ParagraphStyle" } : undefined },
+    styleNameTypes
+  );
+  return TableCell.create({ columnSpan, rowSpan, style, styleName: styleNames.TableCellStyle }, [paragraph]);
+}
+
+export type HyperLinkRowProps = Omit<HyperLinkCellProps, "style"> & {
+  readonly cellStyle?: TableCellStyle.TableCellStyle;
+};
+
+export function HyperLinkRow(props: HyperLinkRowProps, styleNameTypes: Record<string, string>): TableRow.TableRow {
+  return TableRow.create({}, [HyperLinkCell({ ...props, style: props.cellStyle }, styleNameTypes)]);
+}
+
 export type ImageRowProps = Omit<ImageCellProps, "style"> & {
   readonly cellStyle?: TableCellStyle.TableCellStyle;
 };

package/src/abstract-document-xml/xsd-template/custom-elements.ts

@@ -68,6 +68,64 @@ export const textParagraph = `<xs:complexType name="TextParagraph">
 </xs:complexType>`;
 export const textParagraphElement = `<xs:element name="TextParagraph" type="TextParagraph" maxOccurs="unbounded" />`;
 
+export const hyperLinkParagraph = `<xs:complexType name="HyperLinkParagraph">
+	<xs:annotation>
+		<xs:documentation>Shortcut to create \\<Paragraph> \\<HyperLink text="..." target="..." /> \\</Paragraph></xs:documentation>
+	</xs:annotation>
+	<xs:choice minOccurs="0" maxOccurs="1">
+		<xs:element name="style" type="ParagraphStyle" />
+	</xs:choice>
+	<xs:choice minOccurs="0" maxOccurs="1">
+		<xs:element name="textStyle" type="TextStyle" />
+	</xs:choice>
+	<xs:attribute name="styleNames" type="xs:string" />
+	<xs:attribute name="target" type="xs:string" use="required" />
+	<xs:attribute name="text" type="xs:string" use="required" />
+</xs:complexType>`;
+export const hyperLinkParagraphElement = `<xs:element name="HyperLinkParagraph" type="HyperLinkParagraph" maxOccurs="unbounded" />`;
+
+export const hyperLinkCell = `<xs:complexType name="HyperLinkCell">
+	<xs:annotation>
+		<xs:documentation>Shortcut to create a \\<TableCell> \\<Paragraph> \\<HyperLink text="..." target="..." /> \\</Paragraph> \\</TableCell></xs:documentation>
+	</xs:annotation>
+	<xs:choice minOccurs="0" maxOccurs="1">
+		<xs:element name="style" type="TableCellStyle" />
+	</xs:choice>
+	<xs:choice minOccurs="0" maxOccurs="1">
+		<xs:element name="paragraphStyle" type="ParagraphStyle" />
+	</xs:choice>
+	<xs:choice minOccurs="0" maxOccurs="1">
+		<xs:element name="textStyle" type="TextStyle" />
+	</xs:choice>
+	<xs:attribute name="styleNames" type="xs:string" />
+	<xs:attribute name="target" type="xs:string" use="required" />
+	<xs:attribute name="columnSpan" type="xs:integer" />
+	<xs:attribute name="rowSpan" type="xs:integer" />
+	<xs:attribute name="text" type="xs:string" use="required" />
+</xs:complexType>`;
+export const hyperLinkCellElement = `<xs:element name="HyperLinkCell" type="HyperLinkCell" minOccurs="0" maxOccurs="unbounded" />`;
+
+export const hyperLinkRow = `<xs:complexType name="HyperLinkRow">
+	<xs:annotation>
+		<xs:documentation>Shortcut to create a \\<TableRow> \\<TableCell> \\<Paragraph> \\<HyperLink text="..." target="..." /> \\</Paragraph> \\</TableCell> \\</TableRow></xs:documentation>
+	</xs:annotation>
+	<xs:choice minOccurs="0" maxOccurs="1">
+		<xs:element name="cellStyle" type="TableCellStyle" />
+	</xs:choice>
+	<xs:choice minOccurs="0" maxOccurs="1">
+		<xs:element name="paragraphStyle" type="ParagraphStyle" />
+	</xs:choice>
+	<xs:choice minOccurs="0" maxOccurs="1">
+		<xs:element name="textStyle" type="TextStyle" />
+	</xs:choice>
+	<xs:attribute name="styleNames" type="xs:string" />
+	<xs:attribute name="target" type="xs:string" use="required" />
+	<xs:attribute name="columnSpan" type="xs:integer" />
+	<xs:attribute name="rowSpan" type="xs:integer" />
+	<xs:attribute name="text" type="xs:string" use="required" />
+</xs:complexType>`;
+export const hyperLinkRowElement = `<xs:element name="HyperLinkRow" type="HyperLinkRow" maxOccurs="unbounded" />`;
+
 export const imageRow = `<xs:complexType name="ImageRow">
 	<xs:annotation>
 		<xs:documentation>Shortcut to create a \\<TableRow> \\<TableCell> \\<Paragraph> \\<Image src text="..." /> \\</Paragraph> \\</TableCell> \\</TableRow></xs:documentation>

package/src/abstract-document-xml/xsd-template/elements.ts

@@ -16,6 +16,7 @@ export const section = `<xs:complexType name="Section">
 		<xs:element name="PageBreak" type="PageBreak" minOccurs="0" />
 		<xs:element name="Paragraph" type="Paragraph" minOccurs="0" />
 		${Custom.textParagraphElement}
+		${Custom.hyperLinkParagraphElement}
 		${Custom.imageParagraphElement}
 		<xs:element name="Markdown" type="Markdown" minOccurs="0" />
 		<xs:element name="page" type="page" minOccurs="0" maxOccurs="1"></xs:element>
@@ -38,6 +39,7 @@ const sectionElementBody = `<xs:element name="Table" type="Table" minOccurs="0"
 	<xs:element name="PageBreak" type="PageBreak" minOccurs="0" />
 	<xs:element name="Paragraph" type="Paragraph" minOccurs="0" />
 	${Custom.textParagraphElement}
+	${Custom.hyperLinkParagraphElement}
 	${Custom.imageParagraphElement}
 <xs:element name="Markdown" type="Markdown" minOccurs="0" />`;
 
@@ -61,6 +63,7 @@ export const group = `<xs:complexType name="Group">
 		<xs:element name="PageBreak" type="PageBreak" minOccurs="0" />
 		<xs:element name="Paragraph" type="Paragraph" minOccurs="0" />
 		${Custom.textParagraphElement}
+		${Custom.hyperLinkParagraphElement}
 		${Custom.imageParagraphElement}
 		<xs:element name="style" type="GroupStyle" minOccurs="0" />
 	</xs:choice>
@@ -75,6 +78,7 @@ export const table = `<xs:complexType name="Table">
 			<xs:choice minOccurs="1">
 				<xs:element name="TableRow" type="TableRow"  maxOccurs="unbounded" />
 				${Custom.textRowElement}
+				${Custom.hyperLinkRowElement}
 				${Custom.imageRowElement}
 			</xs:choice>
 		</xs:sequence>
@@ -96,6 +100,7 @@ export const headerRows = `<xs:complexType name="headerRows">
 		<xs:choice minOccurs="1" maxOccurs="unbounded">
 			<xs:element name="TableRow" type="TableRow"/>
 			${Custom.textRowElement}
+			${Custom.hyperLinkRowElement}
 			${Custom.imageRowElement}
 		</xs:choice>
 	</xs:sequence>
@@ -105,6 +110,7 @@ export const tableRow = `<xs:complexType name="TableRow">
 	<xs:choice maxOccurs="unbounded">
 		<xs:element name="TableCell" type="TableCell" minOccurs="0" maxOccurs="unbounded" />
 		${Custom.textCellElement}
+		${Custom.hyperLinkCellElement}
 		${Custom.imageCellElement}
 	</xs:choice>
 </xs:complexType>`;
@@ -117,6 +123,7 @@ export const tableCell = `<xs:complexType name="TableCell">
 		<xs:element name="PageBreak" type="PageBreak" minOccurs="0" maxOccurs="unbounded" />
 		<xs:element name="Paragraph" type="Paragraph" minOccurs="0" maxOccurs="unbounded" />
 		${Custom.textParagraphElement}
+		${Custom.hyperLinkParagraphElement}
 		${Custom.imageParagraphElement}
 		<xs:element name="Markdown" type="Markdown" minOccurs="0" maxOccurs="unbounded" />
 	</xs:choice>
@@ -141,7 +148,8 @@ export const paragraph = `<xs:complexType name="Paragraph">
 		<xs:element name="Image" type="Image" minOccurs="0" maxOccurs="unbounded"></xs:element>
 		<xs:element name="HyperLink" type="HyperLink" minOccurs="0" maxOccurs="unbounded"></xs:element>
 		<xs:element name="LinkTarget" type="LinkTarget" minOccurs="0" maxOccurs="unbounded"></xs:element>
-		<xs:element name="TocSeperator" type="TocSeperator" minOccurs="0" maxOccurs="unbounded"></xs:element>
+		<xs:element name="LineBreak" type="LineBreak" minOccurs="0" maxOccurs="unbounded"></xs:element>
+		<xs:element name="TocSeparator" type="TocSeparator" minOccurs="0" maxOccurs="unbounded"></xs:element>
 		<xs:element name="style" type="ParagraphStyle" minOccurs="0" maxOccurs="1"></xs:element>
 	</xs:choice>
 	<xs:attribute name="styleName" type="xs:string" >
@@ -160,16 +168,23 @@ export const hyperLink = `<xs:complexType name="HyperLink">
 			<xs:documentation>Refrence to a TextStyle that is defined in \\<AbstractDoc> \\<StyleNames> \\<StyleName name="..." /> \\</StyleNames> \\</AbstractDoc></xs:documentation>
 		</xs:annotation>
 	</xs:attribute>
-	<xs:attribute name="target" type="xs:string" />
+	<xs:attribute name="target" type="xs:string" use="required" />
 	<xs:attribute name="text" type="xs:string" />
 </xs:complexType>`;
 
-export const tocSeparator = `<xs:complexType name="TocSeperator">
+export const tocSeparator = `<xs:complexType name="TocSeparator">
 	<xs:attribute name="width" type="xs:decimal" />
 </xs:complexType>`;
 
 export const linkTarget = `<xs:complexType name="LinkTarget">
-	<xs:attribute name="name" type="xs:string" />
+	<xs:attribute name="name" type="xs:string" use="required" />
+</xs:complexType>`;
+
+export const lineBreak = `<xs:complexType name="LineBreak">
+	<xs:choice minOccurs="0" maxOccurs="1">
+		<xs:element name="style" type="TextStyle" />
+	</xs:choice>
+	<xs:attribute name="styleName" type="xs:string" />
 </xs:complexType>`;
 
 export const textRun = `<xs:complexType name="TextRun">

package/src/abstract-document-xml/xsd-template/styles.ts

@@ -255,6 +255,15 @@ export const textStyle = `<xs:complexType name="TextStyle">
 	<xs:attribute name="indent" type="xs:decimal" />
 	<xs:attribute name="color" type="xs:string" />
 	<xs:attribute name="fontFamily" type="xs:string" />
+	<xs:attribute name="transform">
+		<xs:simpleType>
+			<xs:restriction base="xs:string">
+				<xs:enumeration value="normal" />
+				<xs:enumeration value="uppercase" />
+				<xs:enumeration value="lowercase" />
+			</xs:restriction>
+		</xs:simpleType>
+	</xs:attribute>
 	<xs:attribute name="baseline">
 		<xs:simpleType>
 			<xs:restriction base="xs:string">

package/src/abstract-document-xml/xsd-template/xsd-template.ts

@@ -14,6 +14,7 @@ ${Elements.image}
 ${Elements.textField}
 ${Elements.textRun}
 ${Elements.hyperLink}
+${Elements.lineBreak}
 ${Elements.tocSeparator}
 ${Elements.linkTarget}
 ${Styles.position}
@@ -33,6 +34,9 @@ ${Elements.tableCell}
 ${CustomElements.textRow}
 ${CustomElements.textCell}
 ${CustomElements.textParagraph}
+${CustomElements.hyperLinkParagraph}
+${CustomElements.hyperLinkCell}
+${CustomElements.hyperLinkRow}
 ${CustomElements.imageRow}
 ${CustomElements.imageCell}
 ${CustomElements.imageParagraph}`;