documents.js 1.57.1 → 1.59.0

package/dist/edit/odg/scaffold.cjs

@@ -0,0 +1,106 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_xml_fragment = require("../../xml/fragment.cjs");
+let odf_js = require("odf.js");
+let document_schema_js = require("document-schema.js");
+//#region src/edit/odg/scaffold.ts
+const CONTENT_NS_PREFIXES = [
+	"office",
+	"style",
+	"text",
+	"table",
+	"draw",
+	"fo",
+	"svg",
+	"xlink"
+];
+const STYLES_NS_PREFIXES = [
+	"office",
+	"style",
+	"text",
+	"table",
+	"draw",
+	"fo",
+	"svg",
+	"xlink"
+];
+const META_NS_PREFIXES = [
+	"office",
+	"meta",
+	"dc"
+];
+const ODF_VERSION = "1.3";
+const PAGE_LAYOUT_NAME = "PM1";
+const MASTER_PAGE_NAME = "Standard";
+function declaration() {
+	return {
+		type: "declaration",
+		attributes: [
+			{
+				name: "version",
+				value: "1.0"
+			},
+			{
+				name: "encoding",
+				value: "UTF-8"
+			},
+			{
+				name: "standalone",
+				value: "yes"
+			}
+		]
+	};
+}
+function buildPageLayout() {
+	return require_xml_fragment.el("style:page-layout", { "style:name": "PM1" }, [require_xml_fragment.el("style:page-layout-properties", {
+		"fo:page-width": `${document_schema_js.PAGE_SIZE_A4.widthPt}pt`,
+		"fo:page-height": `${document_schema_js.PAGE_SIZE_A4.heightPt}pt`
+	})]);
+}
+function buildStylesXml() {
+	return require_xml_fragment.el("office:document-styles", {
+		...(0, odf_js.xmlnsAttributes)([...STYLES_NS_PREFIXES]),
+		"office:version": ODF_VERSION
+	}, [
+		require_xml_fragment.el("office:styles"),
+		require_xml_fragment.el("office:automatic-styles", {}, [buildPageLayout()]),
+		require_xml_fragment.el("office:master-styles", {}, [require_xml_fragment.el("style:master-page", {
+			"style:name": MASTER_PAGE_NAME,
+			"style:page-layout-name": "PM1"
+		})])
+	]);
+}
+function buildContentXml() {
+	return require_xml_fragment.el("office:document-content", {
+		...(0, odf_js.xmlnsAttributes)([...CONTENT_NS_PREFIXES]),
+		"office:version": ODF_VERSION
+	}, [require_xml_fragment.el("office:automatic-styles"), require_xml_fragment.el("office:body", {}, [require_xml_fragment.el("office:drawing")])]);
+}
+function buildMetaXml() {
+	return require_xml_fragment.el("office:document-meta", {
+		...(0, odf_js.xmlnsAttributes)([...META_NS_PREFIXES]),
+		"office:version": ODF_VERSION
+	}, [require_xml_fragment.el("office:meta")]);
+}
+function createEmptyOdgPackage() {
+	const pkg = { parts: {
+		"content.xml": {
+			kind: "xml",
+			nodes: [declaration(), buildContentXml()]
+		},
+		"styles.xml": {
+			kind: "xml",
+			nodes: [declaration(), buildStylesXml()]
+		},
+		"meta.xml": {
+			kind: "xml",
+			nodes: [declaration(), buildMetaXml()]
+		}
+	} };
+	(0, odf_js.setDocumentMediaType)(pkg, odf_js.ODF_MEDIA_TYPES.odg);
+	(0, odf_js.syncManifest)(pkg);
+	return pkg;
+}
+//#endregion
+exports.MASTER_PAGE_NAME = MASTER_PAGE_NAME;
+exports.PAGE_LAYOUT_NAME = PAGE_LAYOUT_NAME;
+exports.createEmptyOdgPackage = createEmptyOdgPackage;

package/dist/edit/odg/scaffold.d.cts

@@ -0,0 +1,7 @@
+import { Package } from "odf.js";
+//#region src/edit/odg/scaffold.d.ts
+declare const PAGE_LAYOUT_NAME = "PM1";
+declare const MASTER_PAGE_NAME = "Standard";
+declare function createEmptyOdgPackage(): Package;
+//#endregion
+export { MASTER_PAGE_NAME, PAGE_LAYOUT_NAME, createEmptyOdgPackage };

package/dist/edit/odg/scaffold.d.ts

@@ -0,0 +1,7 @@
+import { Package } from "odf.js";
+//#region src/edit/odg/scaffold.d.ts
+declare const PAGE_LAYOUT_NAME = "PM1";
+declare const MASTER_PAGE_NAME = "Standard";
+declare function createEmptyOdgPackage(): Package;
+//#endregion
+export { MASTER_PAGE_NAME, PAGE_LAYOUT_NAME, createEmptyOdgPackage };

package/dist/edit/odg/scaffold.js

@@ -0,0 +1,103 @@
+import { PAGE_SIZE_A4 } from "../../model/geometry.js";
+import { el } from "../../xml/fragment.js";
+import { ODF_MEDIA_TYPES, setDocumentMediaType, syncManifest, xmlnsAttributes } from "odf.js";
+//#region src/edit/odg/scaffold.ts
+const CONTENT_NS_PREFIXES = [
+	"office",
+	"style",
+	"text",
+	"table",
+	"draw",
+	"fo",
+	"svg",
+	"xlink"
+];
+const STYLES_NS_PREFIXES = [
+	"office",
+	"style",
+	"text",
+	"table",
+	"draw",
+	"fo",
+	"svg",
+	"xlink"
+];
+const META_NS_PREFIXES = [
+	"office",
+	"meta",
+	"dc"
+];
+const ODF_VERSION = "1.3";
+const PAGE_LAYOUT_NAME = "PM1";
+const MASTER_PAGE_NAME = "Standard";
+function declaration() {
+	return {
+		type: "declaration",
+		attributes: [
+			{
+				name: "version",
+				value: "1.0"
+			},
+			{
+				name: "encoding",
+				value: "UTF-8"
+			},
+			{
+				name: "standalone",
+				value: "yes"
+			}
+		]
+	};
+}
+function buildPageLayout() {
+	return el("style:page-layout", { "style:name": "PM1" }, [el("style:page-layout-properties", {
+		"fo:page-width": `${PAGE_SIZE_A4.widthPt}pt`,
+		"fo:page-height": `${PAGE_SIZE_A4.heightPt}pt`
+	})]);
+}
+function buildStylesXml() {
+	return el("office:document-styles", {
+		...xmlnsAttributes([...STYLES_NS_PREFIXES]),
+		"office:version": ODF_VERSION
+	}, [
+		el("office:styles"),
+		el("office:automatic-styles", {}, [buildPageLayout()]),
+		el("office:master-styles", {}, [el("style:master-page", {
+			"style:name": MASTER_PAGE_NAME,
+			"style:page-layout-name": "PM1"
+		})])
+	]);
+}
+function buildContentXml() {
+	return el("office:document-content", {
+		...xmlnsAttributes([...CONTENT_NS_PREFIXES]),
+		"office:version": ODF_VERSION
+	}, [el("office:automatic-styles"), el("office:body", {}, [el("office:drawing")])]);
+}
+function buildMetaXml() {
+	return el("office:document-meta", {
+		...xmlnsAttributes([...META_NS_PREFIXES]),
+		"office:version": ODF_VERSION
+	}, [el("office:meta")]);
+}
+function createEmptyOdgPackage() {
+	const pkg = { parts: {
+		"content.xml": {
+			kind: "xml",
+			nodes: [declaration(), buildContentXml()]
+		},
+		"styles.xml": {
+			kind: "xml",
+			nodes: [declaration(), buildStylesXml()]
+		},
+		"meta.xml": {
+			kind: "xml",
+			nodes: [declaration(), buildMetaXml()]
+		}
+	} };
+	setDocumentMediaType(pkg, ODF_MEDIA_TYPES.odg);
+	syncManifest(pkg);
+	return pkg;
+}
+//#endregion
+export { MASTER_PAGE_NAME, PAGE_LAYOUT_NAME, createEmptyOdgPackage };

package/dist/edit/odg/style.cjs

@@ -0,0 +1,83 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_xml_fragment = require("../../xml/fragment.cjs");
+const require_xml_edit = require("../../xml/edit.cjs");
+const require_edit_odt_automatic_styles = require("../odt/automatic-styles.cjs");
+let ooxml_js = require("ooxml.js");
+let odf_js = require("odf.js");
+//#region src/edit/odg/style.ts
+const GRAPHIC_STYLE_PREFIX = "gr";
+function graphicPropertyAttrs(init) {
+	const attrs = {};
+	if (init.fill === void 0) attrs["draw:fill"] = "none";
+	else {
+		attrs["draw:fill"] = "solid";
+		attrs["draw:fill-color"] = (0, odf_js.formatOdfColor)(init.fill);
+	}
+	if (init.stroke === void 0) attrs["draw:stroke"] = "none";
+	else {
+		attrs["svg:stroke-color"] = (0, odf_js.formatOdfColor)(init.stroke.color);
+		attrs["svg:stroke-width"] = (0, odf_js.formatOdfLength)(init.stroke.widthPt);
+	}
+	return attrs;
+}
+function buildGraphicStyle(pkg, init) {
+	const automaticStyles = require_edit_odt_automatic_styles.ensureAutomaticStyles(pkg);
+	const name = require_edit_odt_automatic_styles.nextStyleName(automaticStyles, "style:style", GRAPHIC_STYLE_PREFIX);
+	automaticStyles.children.push(require_xml_fragment.el("style:style", {
+		"style:name": name,
+		"style:family": "graphic"
+	}, [require_xml_fragment.el("style:graphic-properties", graphicPropertyAttrs(init))]));
+	return name;
+}
+function findAutomaticStylesReadOnly(pkg) {
+	const part = pkg.parts["content.xml"];
+	const root = part?.kind === "xml" ? part.nodes.find((n) => n.type === "element") : void 0;
+	if (root === void 0) return;
+	for (const child of root.children) if (child.type === "element" && child.tag === "office:automatic-styles") return child;
+}
+function findGraphicStyle(pkg, element) {
+	const styleName = (0, ooxml_js.attr)(element, "draw:style-name");
+	if (styleName === void 0) return;
+	return findAutomaticStylesReadOnly(pkg)?.children.find((c) => c.type === "element" && c.tag === "style:style" && (0, ooxml_js.attr)(c, "style:name") === styleName);
+}
+function graphicProperties(pkg, element) {
+	return findGraphicStyle(pkg, element)?.children.find((c) => c.type === "element" && c.tag === "style:graphic-properties");
+}
+function readGraphicFill(pkg, element) {
+	const props = graphicProperties(pkg, element);
+	if (props === void 0 || (0, ooxml_js.attr)(props, "draw:fill") === "none") return;
+	const value = (0, ooxml_js.attr)(props, "draw:fill-color");
+	return value === void 0 ? void 0 : (0, odf_js.parseOdfColor)(value);
+}
+function readGraphicStroke(pkg, element) {
+	const props = graphicProperties(pkg, element);
+	if (props === void 0 || (0, ooxml_js.attr)(props, "draw:stroke") === "none") return;
+	const colorValue = (0, ooxml_js.attr)(props, "svg:stroke-color");
+	const widthValue = (0, ooxml_js.attr)(props, "svg:stroke-width");
+	const color = colorValue === void 0 ? void 0 : (0, odf_js.parseOdfColor)(colorValue);
+	const widthPt = widthValue === void 0 ? void 0 : (0, odf_js.parseOdfLength)(widthValue);
+	return color === void 0 || widthPt === void 0 ? void 0 : {
+		color,
+		widthPt
+	};
+}
+function setGraphicFill(pkg, element, fill) {
+	const name = buildGraphicStyle(pkg, {
+		fill,
+		stroke: readGraphicStroke(pkg, element)
+	});
+	require_xml_edit.setAttr(element, "draw:style-name", name);
+}
+function setGraphicStroke(pkg, element, stroke) {
+	const name = buildGraphicStyle(pkg, {
+		fill: readGraphicFill(pkg, element),
+		stroke
+	});
+	require_xml_edit.setAttr(element, "draw:style-name", name);
+}
+//#endregion
+exports.buildGraphicStyle = buildGraphicStyle;
+exports.readGraphicFill = readGraphicFill;
+exports.readGraphicStroke = readGraphicStroke;
+exports.setGraphicFill = setGraphicFill;
+exports.setGraphicStroke = setGraphicStroke;

package/dist/edit/odg/style.d.cts

@@ -0,0 +1,14 @@
+import { Color, ContentStroke } from "document-schema.js";
+import { Package, XmlElement } from "odf.js";
+//#region src/edit/odg/style.d.ts
+interface GraphicStyleInit {
+  readonly fill?: Color;
+  readonly stroke?: ContentStroke;
+}
+declare function buildGraphicStyle(pkg: Package, init: GraphicStyleInit): string;
+declare function readGraphicFill(pkg: Package, element: XmlElement): Color | undefined;
+declare function readGraphicStroke(pkg: Package, element: XmlElement): ContentStroke | undefined;
+declare function setGraphicFill(pkg: Package, element: XmlElement, fill: Color | undefined): void;
+declare function setGraphicStroke(pkg: Package, element: XmlElement, stroke: ContentStroke | undefined): void;
+//#endregion
+export { GraphicStyleInit, buildGraphicStyle, readGraphicFill, readGraphicStroke, setGraphicFill, setGraphicStroke };

package/dist/edit/odg/style.d.ts

@@ -0,0 +1,14 @@
+import { Color, ContentStroke } from "document-schema.js";
+import { Package, XmlElement } from "odf.js";
+//#region src/edit/odg/style.d.ts
+interface GraphicStyleInit {
+  readonly fill?: Color;
+  readonly stroke?: ContentStroke;
+}
+declare function buildGraphicStyle(pkg: Package, init: GraphicStyleInit): string;
+declare function readGraphicFill(pkg: Package, element: XmlElement): Color | undefined;
+declare function readGraphicStroke(pkg: Package, element: XmlElement): ContentStroke | undefined;
+declare function setGraphicFill(pkg: Package, element: XmlElement, fill: Color | undefined): void;
+declare function setGraphicStroke(pkg: Package, element: XmlElement, stroke: ContentStroke | undefined): void;
+//#endregion
+export { GraphicStyleInit, buildGraphicStyle, readGraphicFill, readGraphicStroke, setGraphicFill, setGraphicStroke };

package/dist/edit/odg/style.js

@@ -0,0 +1,78 @@
+import { el } from "../../xml/fragment.js";
+import { setAttr } from "../../xml/edit.js";
+import { ensureAutomaticStyles, nextStyleName } from "../odt/automatic-styles.js";
+import { attr } from "ooxml.js";
+import { formatOdfColor, formatOdfLength, parseOdfColor, parseOdfLength } from "odf.js";
+//#region src/edit/odg/style.ts
+const GRAPHIC_STYLE_PREFIX = "gr";
+function graphicPropertyAttrs(init) {
+	const attrs = {};
+	if (init.fill === void 0) attrs["draw:fill"] = "none";
+	else {
+		attrs["draw:fill"] = "solid";
+		attrs["draw:fill-color"] = formatOdfColor(init.fill);
+	}
+	if (init.stroke === void 0) attrs["draw:stroke"] = "none";
+	else {
+		attrs["svg:stroke-color"] = formatOdfColor(init.stroke.color);
+		attrs["svg:stroke-width"] = formatOdfLength(init.stroke.widthPt);
+	}
+	return attrs;
+}
+function buildGraphicStyle(pkg, init) {
+	const automaticStyles = ensureAutomaticStyles(pkg);
+	const name = nextStyleName(automaticStyles, "style:style", GRAPHIC_STYLE_PREFIX);
+	automaticStyles.children.push(el("style:style", {
+		"style:name": name,
+		"style:family": "graphic"
+	}, [el("style:graphic-properties", graphicPropertyAttrs(init))]));
+	return name;
+}
+function findAutomaticStylesReadOnly(pkg) {
+	const part = pkg.parts["content.xml"];
+	const root = part?.kind === "xml" ? part.nodes.find((n) => n.type === "element") : void 0;
+	if (root === void 0) return;
+	for (const child of root.children) if (child.type === "element" && child.tag === "office:automatic-styles") return child;
+}
+function findGraphicStyle(pkg, element) {
+	const styleName = attr(element, "draw:style-name");
+	if (styleName === void 0) return;
+	return findAutomaticStylesReadOnly(pkg)?.children.find((c) => c.type === "element" && c.tag === "style:style" && attr(c, "style:name") === styleName);
+}
+function graphicProperties(pkg, element) {
+	return findGraphicStyle(pkg, element)?.children.find((c) => c.type === "element" && c.tag === "style:graphic-properties");
+}
+function readGraphicFill(pkg, element) {
+	const props = graphicProperties(pkg, element);
+	if (props === void 0 || attr(props, "draw:fill") === "none") return;
+	const value = attr(props, "draw:fill-color");
+	return value === void 0 ? void 0 : parseOdfColor(value);
+}
+function readGraphicStroke(pkg, element) {
+	const props = graphicProperties(pkg, element);
+	if (props === void 0 || attr(props, "draw:stroke") === "none") return;
+	const colorValue = attr(props, "svg:stroke-color");
+	const widthValue = attr(props, "svg:stroke-width");
+	const color = colorValue === void 0 ? void 0 : parseOdfColor(colorValue);
+	const widthPt = widthValue === void 0 ? void 0 : parseOdfLength(widthValue);
+	return color === void 0 || widthPt === void 0 ? void 0 : {
+		color,
+		widthPt
+	};
+}
+function setGraphicFill(pkg, element, fill) {
+	const name = buildGraphicStyle(pkg, {
+		fill,
+		stroke: readGraphicStroke(pkg, element)
+	});
+	setAttr(element, "draw:style-name", name);
+}
+function setGraphicStroke(pkg, element, stroke) {
+	const name = buildGraphicStyle(pkg, {
+		fill: readGraphicFill(pkg, element),
+		stroke
+	});
+	setAttr(element, "draw:style-name", name);
+}
+//#endregion
+export { buildGraphicStyle, readGraphicFill, readGraphicStroke, setGraphicFill, setGraphicStroke };

package/dist/edit/odg/svg-path.cjs

@@ -0,0 +1,30 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/edit/odg/svg-path.ts
+const PATH_NUMBER_DECIMALS = 6;
+const PATH_NUMBER_SCALE = 10 ** PATH_NUMBER_DECIMALS;
+function formatPathNumber(value) {
+	if (!Number.isFinite(value)) throw new Error(`cannot format a non-finite path coordinate: ${value}`);
+	const rounded = Math.round(value * PATH_NUMBER_SCALE) / PATH_NUMBER_SCALE;
+	if (rounded === 0) return "0";
+	return rounded.toFixed(PATH_NUMBER_DECIMALS).replace(/0+$/, "").replace(/\.$/, "");
+}
+function formatPathPoint(point) {
+	return `${formatPathNumber(point.xPt)} ${formatPathNumber(point.yPt)}`;
+}
+function buildSvgPathData(subpaths) {
+	const commands = [];
+	for (const subpath of subpaths) {
+		commands.push(`M${formatPathPoint(subpath.start)}`);
+		for (const segment of subpath.segments) if (segment.kind === "line") commands.push(`L${formatPathPoint(segment.to)}`);
+		else commands.push(`C${formatPathPoint(segment.control1)} ${formatPathPoint(segment.control2)} ${formatPathPoint(segment.to)}`);
+		if (subpath.closed) commands.push("Z");
+	}
+	return commands.join(" ");
+}
+function buildSvgViewBox(widthPt, heightPt) {
+	return `0 0 ${formatPathNumber(widthPt)} ${formatPathNumber(heightPt)}`;
+}
+//#endregion
+exports.buildSvgPathData = buildSvgPathData;
+exports.buildSvgViewBox = buildSvgViewBox;
+exports.formatPathNumber = formatPathNumber;

package/dist/edit/odg/svg-path.d.cts

@@ -0,0 +1,7 @@
+import { ContentSubpath } from "document-schema.js";
+//#region src/edit/odg/svg-path.d.ts
+declare function formatPathNumber(value: number): string;
+declare function buildSvgPathData(subpaths: readonly ContentSubpath[]): string;
+declare function buildSvgViewBox(widthPt: number, heightPt: number): string;
+//#endregion
+export { buildSvgPathData, buildSvgViewBox, formatPathNumber };

package/dist/edit/odg/svg-path.d.ts

@@ -0,0 +1,7 @@
+import { ContentSubpath } from "document-schema.js";
+//#region src/edit/odg/svg-path.d.ts
+declare function formatPathNumber(value: number): string;
+declare function buildSvgPathData(subpaths: readonly ContentSubpath[]): string;
+declare function buildSvgViewBox(widthPt: number, heightPt: number): string;
+//#endregion
+export { buildSvgPathData, buildSvgViewBox, formatPathNumber };

package/dist/edit/odg/svg-path.js

@@ -0,0 +1,27 @@
+//#region src/edit/odg/svg-path.ts
+const PATH_NUMBER_DECIMALS = 6;
+const PATH_NUMBER_SCALE = 10 ** PATH_NUMBER_DECIMALS;
+function formatPathNumber(value) {
+	if (!Number.isFinite(value)) throw new Error(`cannot format a non-finite path coordinate: ${value}`);
+	const rounded = Math.round(value * PATH_NUMBER_SCALE) / PATH_NUMBER_SCALE;
+	if (rounded === 0) return "0";
+	return rounded.toFixed(PATH_NUMBER_DECIMALS).replace(/0+$/, "").replace(/\.$/, "");
+}
+function formatPathPoint(point) {
+	return `${formatPathNumber(point.xPt)} ${formatPathNumber(point.yPt)}`;
+}
+function buildSvgPathData(subpaths) {
+	const commands = [];
+	for (const subpath of subpaths) {
+		commands.push(`M${formatPathPoint(subpath.start)}`);
+		for (const segment of subpath.segments) if (segment.kind === "line") commands.push(`L${formatPathPoint(segment.to)}`);
+		else commands.push(`C${formatPathPoint(segment.control1)} ${formatPathPoint(segment.control2)} ${formatPathPoint(segment.to)}`);
+		if (subpath.closed) commands.push("Z");
+	}
+	return commands.join(" ");
+}
+function buildSvgViewBox(widthPt, heightPt) {
+	return `0 0 ${formatPathNumber(widthPt)} ${formatPathNumber(heightPt)}`;
+}
+//#endregion
+export { buildSvgPathData, buildSvgViewBox, formatPathNumber };