@makhmudov.kay/az-editor 0.1.0-beta.7 → 0.1.0-beta.8

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Изменения
 
+## 0.1.0-beta.8
+
+- HTML → DOCX сохраняет шрифт знака абзаца и наследуемый шрифт `<br>`. Обратный экспорт сохраняет семейство и размер знака абзаца отдельно от текста. Авторские пустые строки не удаляются.
+- Нормализация абсолютных интервалов учитывает эффективные размеры Word в половинах пункта, знак абзаца и противоположные смещения фрагментов. Тесный интервал нормализуется при импорте; `line-height-metrics-estimated` явно обозначает отсутствие реальных метрик шрифта в конвертере.
+- `AzHtmlEditor.exportHtml()` возвращает эффективный нормализованный HTML с `changed: true` даже без ручной правки. `dirty` по-прежнему обозначает ручные изменения. Интеграции должны вызывать экспорт перед сохранением независимо от `dirty`.
+- Потеря скрытого знака абзаца при HTML-экспорте диагностируется как `hidden-paragraph-mark-lost` уровня `loss`; его скрытый шрифт не активируется молча.
+- `preserve`, авторские разрывы и сетка таблиц сохраняют прежний контракт. Недостающий во входном HTML шрифт пустых строк библиотека не восстанавливает по первому текстовому фрагменту. Различие Word `exact`/`atLeast` всё ещё требует расширения сохраняемого контракта.
+
 ## 0.1.0-beta.7
 
 - Сетка таблицы рассчитывается по ограничениям всех строк одновременно. Пересекающиеся `colspan` больше не зависят от порядка обработки; сохраняются совместимые суммы в неполной сетке, `rowspan` и независимые вложенные таблицы.

package/README.md

@@ -14,10 +14,10 @@ React-библиотека для редактирования DOCX и HTML-до
 npm install @makhmudov.kay/az-editor@beta
 ```
 
-Для воспроизводимой установки версии beta.7:
+Для воспроизводимой установки версии beta.8:
 
 ```sh
-npm install --save-exact @makhmudov.kay/az-editor@0.1.0-beta.7
+npm install --save-exact @makhmudov.kay/az-editor@0.1.0-beta.8
 ```
 
 Требуются React и React DOM 19, Node.js `^24.15.0 || >=26.0.0` для установки/сборки,

package/dist/az-editor.js

@@ -719,7 +719,13 @@ function ve(e) {
 	return e.rule === "auto" ? String(e.value / 240) : `${e.value / 20}pt`;
 }
 function ye(e) {
-	return (parseFloat(e["font-size"]) || 12) + Math.abs(Number(e["--az-position"]) || 0) / 2;
+	let t = 0, n = 0;
+	for (let r of e) {
+		if (r["--az-hidden"] === "1") continue;
+		let e = parseFloat(r["font-size"]) || 12, i = (Number(r["--az-position"]) || 0) / 2;
+		t = Math.max(t, e + i), n = Math.max(n, -i);
+	}
+	return t + n;
 }
 //#endregion
 //#region src/library/hujjat/docx-chrome.ts
@@ -947,25 +953,30 @@ async function Te(e, t = {}, n) {
 		parseFloat(s["text-indent"] ?? "0") < 0 && parseFloat(s["margin-left"] ?? "0") >= 0 && (s["padding-left"] = s["margin-left"] ?? "0pt", s["margin-left"] = "0pt");
 		let _ = _e([B(B(b, "pPrDefault"), "pPr"), ...o]);
 		_ && (s["line-height"] = ve(_));
-		let C = Object.assign({}, S, ...i.map((e) => K(B(e, "rPr")))), O = Array.from(e.getElementsByTagNameNS(R, "r")).map((e) => {
-			let t = B(e, "rPr"), n = Object.assign({}, C, ...w(H(t, "rStyle")).map((e) => K(B(e, "rPr"))), K(t));
-			return n["--az-hidden"] === "1" ? 0 : ye(n);
-		}), A = s["line-height"];
-		A && (/^\d*\.?\d+$/.test(A) ? Number(A) < 1 : A.endsWith("pt") && parseFloat(A) < Math.max(ye(C), ...O)) && (t.lineSpacingPolicy === "preserve" ? m("line-height-overlap-risk", "Авторский тесный интервал сохранён; строки могут перекрываться. Фактические метрики шрифта требуют проверки.", "warning", A, A) : (s["line-height"] = /^\d*\.?\d+$/.test(A) ? "1" : "normal", m("line-height-normalized", "Тесный межстрочный интервал нормализован по размерам фрагментов. Проверьте переносы на используемых шрифтах.", "warning", A, s["line-height"]))), _ && _.rule !== "auto" && m("line-rule-lost", "CSS line-height не сохраняет различие правил Word exact и atLeast.", "warning", _.rule, "CSS line-height"), o.some((e) => B(e, "tabs")) && h("tab-stops-removed", "Позиции, типы и заполнители табуляции не поддерживаются HTML-блоком.");
-		let j = [B(B(b, "pPrDefault"), "pPr"), ...o].map((e) => B(e, "widowControl")).filter(Boolean).at(-1);
-		j && M(u, "widow-control-lost", "Правило висячих строк Word не представлено в HTML-контракте.", "loss", {
+		let C = Object.assign({}, S, ...i.map((e) => K(B(e, "rPr")))), O = Object.assign({}, C, K(B(r, "rPr")));
+		O["--az-hidden"] === "1" && (m("hidden-paragraph-mark-lost", "Скрытый знак абзаца нельзя представить в HTML; его отдельный шрифт заменён стилем абзаца.", "loss", "hidden", "visible paragraph style"), O = {
+			...C,
+			"--az-hidden": "0"
+		}), s["font-family"] = O["font-family"], s["font-size"] = O["font-size"];
+		let A = Array.from(e.getElementsByTagNameNS(R, "r")).map((e) => {
+			let t = B(e, "rPr");
+			return Object.assign({}, C, ...w(H(t, "rStyle")).map((e) => K(B(e, "rPr"))), K(t));
+		}), j = s["line-height"];
+		j && (/^\d*\.?\d+$/.test(j) ? Number(j) < 1 : j.endsWith("pt") && parseFloat(j) < ye([O, ...A])) && (t.lineSpacingPolicy === "preserve" ? m("line-height-overlap-risk", "Авторский тесный интервал сохранён; строки могут перекрываться. Фактические метрики шрифта требуют проверки.", "warning", j, j) : (s["line-height"] = /^\d*\.?\d+$/.test(j) ? "1" : "normal", m("line-height-normalized", "Тесный межстрочный интервал нормализован по размерам фрагментов. Проверьте переносы на используемых шрифтах.", "warning", j, s["line-height"]))), j?.endsWith("pt") && t.lineSpacingPolicy !== "preserve" && m("line-height-metrics-estimated", "Проверка интервала использует размеры и смещения фрагментов, а не метрики установленного шрифта. Результат нормализации требует проверки на используемых шрифтах.", "warning", j, s["line-height"]), _ && _.rule !== "auto" && m("line-rule-lost", "CSS line-height не сохраняет различие правил Word exact и atLeast.", "warning", _.rule, "CSS line-height"), o.some((e) => B(e, "tabs")) && h("tab-stops-removed", "Позиции, типы и заполнители табуляции не поддерживаются HTML-блоком.");
+		let N = [B(B(b, "pPrDefault"), "pPr"), ...o].map((e) => B(e, "widowControl")).filter(Boolean).at(-1);
+		N && M(u, "widow-control-lost", "Правило висячих строк Word не представлено в HTML-контракте.", "loss", {
 			stage: "export",
 			location: { ...f },
-			before: U(j),
+			before: U(N),
 			after: null
 		}), k = !0;
-		let N = Array.from(e.children).filter((e) => e !== r).map((e) => P(e, C, n + 1)).join("").split("<div style=\"page-break-before:always\"></div>").map((e, t) => `${t ? "<div style=\"page-break-before:always\"></div>" : ""}<p${de(s)}>${e || "<br>"}</p>`).join("");
+		let F = Array.from(e.children).filter((e) => e !== r).map((e) => P(e, C, n + 1)).join("").split("<div style=\"page-break-before:always\"></div>").map((e, t) => `${t ? "<div style=\"page-break-before:always\"></div>" : ""}<p${de(s)}>${e || "<br>"}</p>`).join("");
 		if (l && l !== "0") {
 			let e = E.get(l), t = z(D.get(H(e, "abstractNumId")), "lvl").find((e) => V(e, "ilvl") === String(d));
-			if (!t) return M(u, "numbering-unsupported", "Не найдена нумерация списка.", "loss"), { html: N };
+			if (!t) return M(u, "numbering-unsupported", "Не найдена нумерация списка.", "loss"), { html: F };
 			let n = H(t, "numFmt");
 			return (!["decimal", "bullet"].includes(n) || d || H(t, "start") && H(t, "start") !== "1" || B(e, "lvlOverride")) && M(u, "numbering-normalized", "Сложная нумерация/начальное число списка заменены обычным HTML-списком.", "loss"), {
-				html: N,
+				html: F,
 				list: {
 					id: l,
 					level: Math.min(d, 8),
@@ -974,7 +985,7 @@ async function Te(e, t = {}, n) {
 			};
 		}
 		return {
-			html: N,
+			html: F,
 			continuation: H(r, "pStyle") === "AzHujjatListContinuation"
 		};
 	}
@@ -1372,38 +1383,62 @@ async function Fe(e, t, n = E(), r) {
 	}
 	function _(e, t) {
 		let n = "";
-		for (let r of e) r.nodeType === 3 ? r.textContent && (n += `<w:r><w:rPr>${g(t)}</w:rPr><w:t xml:space="preserve">${ue(r.textContent)}</w:t></w:r>`) : r instanceof Element && (r.localName === "br" ? n += "<w:r><w:br/></w:r>" : n += _(r.childNodes, Q(r, t)));
+		for (let r of e) r.nodeType === 3 ? r.textContent && (n += `<w:r><w:rPr>${g(t)}</w:rPr><w:t xml:space="preserve">${ue(r.textContent)}</w:t></w:r>`) : r instanceof Element && (r.localName === "br" ? n += `<w:r><w:rPr>${g(Q(r, t))}</w:rPr><w:br/></w:r>` : n += _(r.childNodes, Q(r, t)));
 		return n;
 	}
 	function v(e, r, a, o = i) {
-		let s = "", c = r["text-align"];
+		let s = Array.from(e), c = "", l = r["text-align"];
 		[
 			"left",
 			"right",
 			"center",
 			"justify"
-		].includes(c) && (s += `<w:jc w:val="${c === "justify" ? "both" : c}"/>`);
-		let l = Math.max(o.before ?? 0, Z(r["margin-top"]) ?? 0), u = Math.max(o.after ?? 0, Z(r["margin-bottom"]) ?? (o.cell ? 0 : 120)), d = "", f = r["line-height"];
-		if (f && /^\d*\.?\d+%?$/.test(f)) {
-			let e = parseFloat(f) / (f.endsWith("%") ? 100 : 1), r = n.lineSpacingPolicy === "preserve";
+		].includes(l) && (c += `<w:jc w:val="${l === "justify" ? "both" : l}"/>`);
+		let u = Math.max(o.before ?? 0, Z(r["margin-top"]) ?? 0), d = Math.max(o.after ?? 0, Z(r["margin-bottom"]) ?? (o.cell ? 0 : 120)), f = "", p = r["line-height"];
+		if (p && /^\d*\.?\d+%?$/.test(p)) {
+			let e = parseFloat(p) / (p.endsWith("%") ? 100 : 1), r = n.lineSpacingPolicy === "preserve";
 			e < 1 && M(t, r ? "line-height-overlap-risk" : "line-height-normalized", r ? "Тесный интервал сохранён; проверьте наложение строк." : "Тесный интервал увеличен до одинарного; проверьте переносы.", "warning", {
 				stage: "import",
 				location: { htmlPath: o.htmlPath },
 				before: e,
 				after: r ? e : 1
-			}), d = ` w:line="${Math.round(Math.max(+!r, e) * 240)}" w:lineRule="auto"`;
-		} else X(f) !== void 0 && (d = ` w:line="${Math.max(0, Z(f))}" w:lineRule="atLeast"`);
-		s += `<w:spacing w:before="${Math.max(0, l)}" w:after="${Math.max(0, u)}"${d}/>`;
-		let p = "";
+			}), f = ` w:line="${Math.round(Math.max(+!r, e) * 240)}" w:lineRule="auto"`;
+		} else if (X(p) !== void 0) {
+			let e = [], i = (t) => e.push({
+				...t,
+				"font-size": `${Math.round((X(t["font-size"]) ?? 12) * 2) / 2}pt`
+			}), a = (e, t) => {
+				for (let n of e) if (n.nodeType === 3 && n.textContent) i(t);
+				else if (n instanceof Element) {
+					let e = Q(n, t);
+					n.localName === "br" ? i(e) : a(n.childNodes, e);
+				}
+			};
+			i(r), a(s, r);
+			let c = Z(p) / 20 < ye(e), l = n.lineSpacingPolicy === "normalize";
+			c && M(t, l ? "line-height-normalized" : "line-height-overlap-risk", l ? "Тесный абсолютный интервал заменён естественным одинарным интервалом." : "Тесный абсолютный интервал сохранён; проверьте наложение строк.", "warning", {
+				stage: "import",
+				location: { htmlPath: o.htmlPath },
+				before: p,
+				after: l ? "normal" : p
+			}), l && M(t, "line-height-metrics-estimated", "Проверка интервала использует размеры фрагментов, а не метрики установленного шрифта. Результат требует проверки на используемых шрифтах.", "warning", {
+				stage: "import",
+				location: { htmlPath: o.htmlPath },
+				before: p,
+				after: c ? "normal" : p
+			}), f = c && l ? " w:line=\"240\" w:lineRule=\"auto\"" : ` w:line="${Math.max(0, Z(p))}" w:lineRule="atLeast"`;
+		}
+		c += `<w:spacing w:before="${Math.max(0, u)}" w:after="${Math.max(0, d)}"${f}/>`;
+		let m = "";
 		for (let [e, t] of [
 			["margin-left", "left"],
 			["margin-right", "right"],
 			["text-indent", "firstLine"]
 		]) {
 			let n = t === "left" ? o.left : t === "right" ? o.right : void 0, i = t === "left" || t === "right" ? Math.max(0, Z(r[`padding-${t}`]) ?? 0) : 0, s = Z(r[e]), c = s !== void 0 || i ? (s ?? 0) + i : void 0, l = a ? t === "left" ? 360 : t === "firstLine" ? a.pending ? -180 : 0 : void 0 : void 0, u = c === void 0 && !n && l === void 0 ? void 0 : (c ?? (t === "firstLine" ? l : 0) ?? 0) + (n ?? 0) + (t === "left" ? l ?? 0 : 0);
-			u !== void 0 && (p += t === "firstLine" && u < 0 ? ` w:hanging="${-u}"` : ` w:${t}="${u}"`);
+			u !== void 0 && (m += t === "firstLine" && u < 0 ? ` w:hanging="${-u}"` : ` w:${t}="${u}"`);
 		}
-		p && (s += `<w:ind${p}/>`);
+		m && (c += `<w:ind${m}/>`);
 		for (let [e, t, n] of [
 			[
 				"page-break-before",
@@ -1420,8 +1455,8 @@ async function Fe(e, t, n = E(), r) {
 				"keepNext",
 				"avoid"
 			]
-		]) (r[e] === n || r[e] === "auto") && (s += `<w:${t} w:val="${r[e] === n ? "1" : "0"}"/>`);
-		return a && (a.pending ? s += `<w:numPr><w:ilvl w:val="0"/><w:numId w:val="${a.id}"/></w:numPr>` : s += "<w:pStyle w:val=\"AzHujjatListContinuation\"/>", a.pending = !1), `<w:p><w:pPr>${s}</w:pPr>${_(e, r)}</w:p>`;
+		]) (r[e] === n || r[e] === "auto") && (c += `<w:${t} w:val="${r[e] === n ? "1" : "0"}"/>`);
+		return a && (a.pending ? c += `<w:numPr><w:ilvl w:val="0"/><w:numId w:val="${a.id}"/></w:numPr>` : c += "<w:pStyle w:val=\"AzHujjatListContinuation\"/>", a.pending = !1), `<w:p><w:pPr>${c}<w:rPr>${g(r)}</w:rPr></w:pPr>${_(s, r)}</w:p>`;
 	}
 	function y(e, t) {
 		let n = e.style, r = n.getPropertyValue(`border-${t}-style`) || n.borderStyle, i = n.getPropertyValue(`border-${t}-width`) || n.borderWidth, a = n.getPropertyValue(`border-${t}-color`) || n.borderColor;
@@ -1714,10 +1749,10 @@ async function Re(e) {
 			s,
 			...i.map((e) => B(e, "pPr")),
 			r
-		]), l = Object.assign({}, c, ...i.map((e) => K(B(e, "rPr")))), f = ye(l);
+		]), l = Object.assign({}, c, ...i.map((e) => K(B(e, "rPr")))), f = [Object.assign({}, l, K(B(r, "rPr")))];
 		Array.from(e.getElementsByTagNameNS(R, "r")).forEach((e, t) => {
 			let r = B(e, "rPr"), i = Object.assign({}, l, ...d(H(r, "rStyle")).map((e) => K(B(e, "rPr"))), K(r));
-			i["--az-hidden"] !== "1" && (f = Math.max(f, ye(i)), Number(i["--az-position"]) && M(a, "source-baseline-shift", "Исходный фрагмент смещён по вертикали; сохранён без нормализации.", "warning", {
+			i["--az-hidden"] !== "1" && (f.push(i), Number(i["--az-position"]) && M(a, "source-baseline-shift", "Исходный фрагмент смещён по вертикали; сохранён без нормализации.", "warning", {
 				stage: "import",
 				location: {
 					...n,
@@ -1726,7 +1761,7 @@ async function Re(e) {
 				before: Number(i["--az-position"]) / 2,
 				after: Number(i["--az-position"]) / 2
 			}));
-		}), o && (o.rule === "auto" ? o.value < 240 : o.value / 20 < f) && M(a, "source-tight-spacing", "Авторский тесный интервал сохранён. Проверьте наложение строк на используемых шрифтах.", "warning", {
+		}), o && (o.rule === "auto" ? o.value < 240 : o.value / 20 < ye(f)) && M(a, "source-tight-spacing", "Авторский тесный интервал сохранён. Проверьте наложение строк на используемых шрифтах.", "warning", {
 			stage: "import",
 			location: n,
 			before: `${o.rule}:${o.value}`,
@@ -2090,8 +2125,8 @@ var We = e(function(e, a) {
 	return r(a, () => ({
 		async exportHtml(e = {}) {
 			if (!D.current || w.current.phase !== "ready" || !E.current || !T.current) throw new A("HTML-редактор ещё не готов или занят.");
-			let t = E.current;
-			if (!w.current.dirty) return {
+			let t = E.current, n = t.warnings.some((e) => e.code === "line-height-normalized");
+			if (!w.current.dirty && !n) return {
 				html: _,
 				variables: [...t.variables],
 				warnings: [...t.warnings],
@@ -2099,30 +2134,30 @@ var We = e(function(e, a) {
 				page: structuredClone(v),
 				changed: !1
 			};
-			let n = O.current, r = k.current;
+			let r = O.current, i = k.current;
 			M({
 				phase: "exporting",
 				error: null
 			});
 			try {
-				let i = await T.current.exportHujjat({
+				let n = await T.current.exportHujjat({
 					locale: "uz",
 					allowLossy: !0,
 					layout: y,
 					page: t.page
 				});
-				if (!D.current || n !== O.current || r !== k.current) throw new A("Черновик изменился или закрыт во время экспорта. Повторите экспорт актуального документа.");
-				let a = Ue(t.warnings, i.warnings);
+				if (!D.current || r !== O.current || i !== k.current) throw new A("Черновик изменился или закрыт во время экспорта. Повторите экспорт актуального документа.");
+				let a = Ue(t.warnings, n.warnings);
 				return M({ warnings: a }), N(a, e.allowLossy), {
-					html: i.html,
-					variables: i.variables,
+					html: n.html,
+					variables: n.variables,
 					warnings: a,
-					layout: i.layout,
-					page: i.page,
+					layout: n.layout,
+					page: n.page,
 					changed: !0
 				};
 			} finally {
-				L(n);
+				L(r);
 			}
 		},
 		async acceptImportLoss() {

package/dist/library/AzHtmlEditor.d.ts

@@ -13,6 +13,7 @@ export interface AzHtmlEditorStatus {
     fonts?: AzFontStatus;
 }
 export interface AzHtmlExportResult extends HujjatHtmlResult {
+    /** True when the draft was edited or import normalized its formatting. */
     changed: boolean;
 }
 export interface AzHtmlEditorHandle {

package/dist/library/hujjat/paragraph-format.d.ts

@@ -6,5 +6,8 @@ export interface LineSpacing {
 /** Resolve partial OOXML properties before reducing them to CSS. Values stay in native units. */
 export declare function resolveLineSpacing(properties: (Element | null)[]): LineSpacing | undefined;
 export declare function lineSpacingCss(spacing: LineSpacing): string;
-/** Conservative size check, not a measurement of the installed font's ascent/descent. */
-export declare function runHeightEstimate(css: Css): number;
+/** Nominal em-box envelope in points, not measured font ascent/descent/leading.
+ * Oppositely shifted runs occupy both sides of the baseline; max(run height)
+ * alone underestimates their combined extent. Callers supply point font sizes.
+ */
+export declare function paragraphHeightEstimate(fonts: Css[]): number;

package/docs/integration.ru.md

@@ -1,9 +1,12 @@
 # Интеграция Az Editor в React-приложение
 
-Руководство описывает API `@makhmudov.kay/az-editor` версии `0.1.0-beta.7`.
+Руководство описывает API `@makhmudov.kay/az-editor` версии `0.1.0-beta.8`.
 Поддержка серверного `page`, описанная ниже, добавлена в beta.5.
 Совместимые исправления разрывов и строк таблиц добавлены в beta.6 и описаны ниже.
 Исправление общей сетки таблиц и более строгая диагностика размеров добавлены в beta.7.
+В beta.8 исправлено сохранение шрифта пустых строк и знака абзаца, уточнена нормализация
+интервалов. `exportHtml()` сохраняет результат нормализации и без ручных правок;
+вызывайте его перед сохранением независимо от `status.dirty`.
 Примеры написаны на TypeScript. Для JavaScript удалите аннотации типов и `import type`.
 
 ## Содержание
@@ -71,7 +74,7 @@ npm install @makhmudov.kay/az-editor@beta
 Для фиксации опубликованной версии:
 
 ```sh
-npm install --save-exact @makhmudov.kay/az-editor@0.1.0-beta.7
+npm install --save-exact @makhmudov.kay/az-editor@0.1.0-beta.8
 ```
 
 Тег `beta` может указывать на более новую версию. Сохраняйте lockfile и проверяйте
@@ -271,9 +274,10 @@ type HtmlResult = {
 };
 ```
 
-- Без правок возвращается исходный `initialHtml`, `changed: false`. Повторной очистки строки нет.
-- После правок возвращается преобразованный HTML, `changed: true`.
-- `dirty`/`changed` отражают факт правок, а не сравнение строк; undo до исходного вида не гарантирует `dirty: false`.
+- Без правок и без нормализации интервалов при импорте возвращается исходный `initialHtml`, `changed: false`. Повторной очистки строки нет.
+- После правок **или нормализации интервала при импорте** возвращается преобразованный HTML, `changed: true`. Нормализация сохраняется и без ручного ввода текста.
+- `dirty` отражает ручные правки; `changed` учитывает также нормализацию. Это не сравнение строк; undo до исходного вида не гарантирует `dirty: false`.
+- При сохранении всегда вызывайте `exportHtml()`, даже если `dirty: false`. Потери преобразования по-прежнему требуют `allowLossy: true`; принятие потерь при открытии само по себе не разрешает их сохранить.
 - Экспорт не сбрасывает `dirty` и не подтверждает запись на сервере.
 - Повторный одновременный экспорт, экспорт до готовности, после закрытия или из изменившегося во время операции черновика отклоняется.
 
@@ -1032,12 +1036,21 @@ CSS ограничен шрифтом/цветом, базовым оформл
 пустую страницу. Автоматическая пагинация по-прежнему зависит от шрифтов и геометрии.
 
 Без `page.paragraph_spacing` абзацы внутри ячеек не получают дополнительный отступ 6pt после текста;
-явный `margin-bottom` сохраняется. Значение `line-height` в абсолютных единицах
-задаёт минимальную, а не жёсткую высоту строки (`atLeast`), чтобы крупный текст
-не перекрывал соседнюю строку. Числа и проценты задают множитель обычной строки.
-По умолчанию множитель меньше 1 приводится к 1. При DOCX → HTML интервал ниже размера шрифта
-нормализуется, включая крупные фрагменты внутри абзаца; это отмечается
-предупреждением `line-height-normalized`. Достаточные интервалы сохраняются.
+явный `margin-bottom` сохраняется. Абсолютный HTML `line-height` задаёт минимальную
+высоту строки (`atLeast`), если политика не нормализовала его. Числа и проценты
+задают множитель обычной строки. По умолчанию (`normalize`) множитель меньше 1
+приводится к 1; тесный абсолютный интервал при HTML → DOCX сразу заменяется
+естественным одинарным (`auto:240`). При DOCX → HTML он становится `normal`.
+`line-height-normalized` сообщает исходное и эффективное значения и адрес абзаца.
+После сохранения эффективного результата повторное открытие не нормализует его снова.
+
+Оценка учитывает размер знака абзаца, видимые фрагменты и обе стороны смещений
+базовой линии. При явно заданном небольшом размере знака абзаца размер по умолчанию
+не должен увеличивать оценку. Это оценка по размерам, **не измерение метрик шрифтов**:
+конвертер не получает ascent/descent/leading установленных шрифтов. Для абсолютных
+интервалов в `normalize` возвращается `line-height-metrics-estimated`, даже если
+интервал оставлен без изменения. Проверяйте реальные шрифты и начертания в редакторе
+и PDF; эта диагностика не гарантирует отсутствие пересечений всех глифов.
 
 С `layout.lineSpacingPolicy: 'preserve'` численные интервалы сохраняются с предупреждением
 о наложении. `exact` и `atLeast` неразличимы в CSS; `line-rule-lost` отмечает эту потерю
@@ -1046,9 +1059,33 @@ CSS ограничен шрифтом/цветом, базовым оформл
 Табуляция, `widowControl` и численное смещение `w:position` дают `loss` при экспорте в HTML;
 при прямом сохранении DOCX эти свойства не нормализуются.
 
-`AzHtmlEditor.exportHtml()` без правок возвращает исходный HTML. Нормализованный
-HTML появляется после редактирования. Для окончательного PDF также нужны
-совпадающие шрифты, поля страницы и правила CSS на сервере.
+`AzHtmlEditor.exportHtml()` возвращает нормализованный HTML с `changed: true`,
+даже если пользователь ещё не печатал. `dirty` в таком случае остаётся `false`.
+При низкоуровневом `importHujjatTemplate()` нормализуется `result.document`;
+поле `result.html` содержит очищенный вход, а не обратный экспорт модели.
+Для получения эффективного HTML используйте `exportHujjatDocx(result.document, …)`.
+Для окончательного PDF нужны совпадающие шрифты, поля страницы и правила CSS на сервере.
+
+Шрифт абзаца и шрифт его текста — разные данные. Импорт сохраняет свойства шрифта
+абзаца на знаке абзаца, а `<br>` получает свойства своего HTML-контейнера.
+Экспорт сохраняет семейство и размер знака абзаца в стилях `<p>`, отдельно от `<span>`.
+Скрытый знак абзаца не представим в текущем HTML: `hidden-paragraph-mark-lost`
+уровня `loss` сообщает замену его отдельного шрифта обычным стилем абзаца.
+Строгий экспорт требует принять эту потерю, прямой DOCX остаётся без такой подмены.
+Например, для строк и четырёх завершающих переносов размером 10 pt передавайте:
+
+```html
+<p style="font-family:freesans;font-size:10pt;line-height:1.1583333333333334">
+  Текст<br><br><br><br>
+</p>
+```
+
+Если 10 pt задан только на `<span>Текст</span>`, завершающие `<br>` вне него и знак
+абзаца наследуют размер самого `<p>` или документа (по умолчанию 12 pt).
+Библиотека не копирует стиль первого фрагмента на весь абзац: в Word эти стили могут
+различаться намеренно. Восстанавливающий оформление импортёр должен передать фактические
+свойства абзаца и переносов из источника. Служебные и авторские пустые строки нельзя
+удалять ради желаемого количества страниц.
 
 ### Лимиты и оформление
 

package/docs/layout-metadata-v1.ru.md

@@ -80,16 +80,23 @@ export function isLayoutV1(value: unknown): value is AzLayoutMetadataV1 {
 
 | Политика | Поведение |
 | --- | --- |
-| `normalize` (по умолчанию) | Множитель меньше 1 увеличивается до 1. При DOCX → HTML тесный абсолютный интервал становится `normal` с предупреждением. Проверяются размеры всех видимых фрагментов и численное вертикальное смещение. |
+| `normalize` (по умолчанию) | Множитель меньше 1 увеличивается до 1. Тесный абсолютный HTML-интервал становится `auto:240` уже при импорте, при DOCX → HTML — `normal`. Проверяются размер знака абзаца, размеры видимых фрагментов и обе стороны численных смещений базовой линии. |
 | `preserve` | Сохраняет представимые численные значения, включая множители 124/240 и 158/240. Возвращает предупреждение о риске наложения. |
 
 Проверка размера фрагментов — оценка, а не измерение ascent/descent всех шрифтов.
+Для абсолютного интервала в `normalize` возвращается адресное предупреждение
+`line-height-metrics-estimated`, включая случаи без изменения значения.
 Большие буквы, формулы, разные начертания и смещения требуют проверки на реальных данных.
-Абсолютный HTML `line-height` импортируется как Word `atLeast`. По CSS невозможно узнать,
+Абсолютный HTML `line-height`, оставленный без нормализации, импортируется как Word `atLeast`. По CSS невозможно узнать,
 был ли в исходнике `exact`; при DOCX → HTML это различие отмечено `line-rule-lost`.
 Численное `w:position` не сохраняется в действующем HTML-контракте: `baseline-shift-lost`
 имеет уровень `loss`. `w:spacing` сохраняется как `letter-spacing`.
 
+`AzHtmlEditor.exportHtml()` сериализует нормализацию даже без ручной правки:
+`changed: true`, при этом `status.dirty` остаётся `false`. Всегда вызывайте экспорт
+перед сохранением. При повторном открытии сохранённого эффективного HTML нормализация
+не повторяется; `preserve` по-прежнему не увеличивает интервалы молча.
+
 ## Диагностика и шрифты
 
 `HujjatWarning` сохраняет `code`, `message`, `severity`. Дополнительные поля:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@makhmudov.kay/az-editor",
-  "version": "0.1.0-beta.7",
+  "version": "0.1.0-beta.8",
   "type": "module",
   "types": "./dist/library/index.d.ts",
   "sideEffects": [