@stll/folio-core 0.29.0 → 0.31.0

package/dist/utils/horizontalScale.d.ts

@@ -0,0 +1,28 @@
+//#region src/utils/horizontalScale.d.ts
+/**
+ * Normalize OOXML `w:w` horizontal text scale percentages.
+ *
+ * The OOXML value is bounded from 0% through 600%. Missing or malformed
+ * values use the document default (100%) and stay absent in the model.
+ */
+declare function normalizeHorizontalScalePercent(horizontalScale: number | null | undefined): number | undefined;
+/**
+ * Parse the lexical forms accepted by OOXML `ST_TextScale`.
+ *
+ * Decimal values use the XML Schema integer grammar; percent values use the
+ * unsigned decimal grammar defined by `ST_TextScalePercent`. Surrounding
+ * whitespace is ignored, but an empty value or partial numeric prefix is not.
+ */
+declare function parseHorizontalScalePercent(horizontalScale: string | null | undefined): number | undefined;
+declare function getHorizontalScaleFactor(horizontalScale: number | null | undefined): number;
+/**
+ * Quantize an in-range model value for OOXML's integer-only representation.
+ *
+ * Imported documents use strict integer normalization. Serialization also
+ * tolerates finite floating-point residue produced by editing calculations,
+ * preserving the existing integer-attribute contract without emitting an
+ * invalid fractional value.
+ */
+declare function roundHorizontalScalePercentForSerialization(horizontalScale: number | null | undefined): number | undefined;
+//#endregion
+export { getHorizontalScaleFactor, normalizeHorizontalScalePercent, parseHorizontalScalePercent, roundHorizontalScalePercentForSerialization };

package/dist/utils/horizontalScale.js

@@ -0,0 +1,42 @@
+//#region src/utils/horizontalScale.ts
+/**
+* Normalize OOXML `w:w` horizontal text scale percentages.
+*
+* The OOXML value is bounded from 0% through 600%. Missing or malformed
+* values use the document default (100%) and stay absent in the model.
+*/
+function normalizeHorizontalScalePercent(horizontalScale) {
+	if (horizontalScale === null || horizontalScale === void 0 || !Number.isFinite(horizontalScale) || !Number.isInteger(horizontalScale) || horizontalScale < 0 || horizontalScale > 600) return;
+	return horizontalScale;
+}
+/**
+* Parse the lexical forms accepted by OOXML `ST_TextScale`.
+*
+* Decimal values use the XML Schema integer grammar; percent values use the
+* unsigned decimal grammar defined by `ST_TextScalePercent`. Surrounding
+* whitespace is ignored, but an empty value or partial numeric prefix is not.
+*/
+function parseHorizontalScalePercent(horizontalScale) {
+	if (horizontalScale === null || horizontalScale === void 0) return;
+	const lexicalValue = horizontalScale.trim();
+	if (!/^(?:[+-]?\d+|\d+%)$/u.test(lexicalValue)) return;
+	const numericValue = lexicalValue.endsWith("%") ? lexicalValue.slice(0, -1) : lexicalValue;
+	return normalizeHorizontalScalePercent(Number(numericValue));
+}
+function getHorizontalScaleFactor(horizontalScale) {
+	return (normalizeHorizontalScalePercent(horizontalScale) ?? 100) / 100;
+}
+/**
+* Quantize an in-range model value for OOXML's integer-only representation.
+*
+* Imported documents use strict integer normalization. Serialization also
+* tolerates finite floating-point residue produced by editing calculations,
+* preserving the existing integer-attribute contract without emitting an
+* invalid fractional value.
+*/
+function roundHorizontalScalePercentForSerialization(horizontalScale) {
+	if (horizontalScale === null || horizontalScale === void 0 || !Number.isFinite(horizontalScale) || horizontalScale < 0 || horizontalScale > 600) return;
+	return Math.round(horizontalScale);
+}
+//#endregion
+export { getHorizontalScaleFactor, normalizeHorizontalScalePercent, parseHorizontalScalePercent, roundHorizontalScalePercentForSerialization };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/folio-core",
-  "version": "0.29.0",
+  "version": "0.31.0",
   "description": "Headless, framework-neutral core of folio: the OOXML (.docx) parser, document model, ProseMirror integration, and page-layout engine. No React.",
   "keywords": [
     "document-model",
@@ -113,7 +113,7 @@
     "perf": "bun scripts/profile-editor.ts"
   },
   "dependencies": {
-    "@stll/docx-core": "^0.17.2",
+    "@stll/docx-core": "^0.17.3",
     "@stll/docx-utils": "^0.1.0",
     "@stll/template-conditions": "^0.1.0",
     "better-result": "3.0.1",