@escapenavigator/utils 1.10.144 → 1.10.146

package/dist/email-builder/strip-html.d.ts

@@ -22,8 +22,7 @@
  *   - не сохраняем формат (bold/italic): Maily-`variable`-нода рендерит
  *     значение как plain text, теги внутри значения остаются буквальными.
  *     Если когда-то понадобится rich-text-подстановка — отдельная история
- *     (надо конвертить HTML в TipTap-ноды и инлайнить в doc, см.
- *     `convertLegacyHtmlToEmailContent`).
+ *     (надо конвертить HTML в TipTap-ноды и инлайнить в doc).
  *   - не сохраняем переносы строк: Maily-render не превращает `\n` в
  *     `<br>` (он эмитит весь текст одним `Fragment`), так что переносы
  *     визуально не видны. Лучше один параграф, чем «странные» дыры.

package/dist/email-builder/strip-html.js

@@ -25,8 +25,7 @@ exports.stripHtml = stripHtml;
  *   - не сохраняем формат (bold/italic): Maily-`variable`-нода рендерит
  *     значение как plain text, теги внутри значения остаются буквальными.
  *     Если когда-то понадобится rich-text-подстановка — отдельная история
- *     (надо конвертить HTML в TipTap-ноды и инлайнить в doc, см.
- *     `convertLegacyHtmlToEmailContent`).
+ *     (надо конвертить HTML в TipTap-ноды и инлайнить в doc).
  *   - не сохраняем переносы строк: Maily-render не превращает `\n` в
  *     `<br>` (он эмитит весь текст одним `Fragment`), так что переносы
  *     визуально не видны. Лучше один параграф, чем «странные» дыры.

package/dist/quill-clipboard-matchers.d.ts

@@ -23,17 +23,20 @@
 import Delta from 'quill-delta';
 export type ClipboardMatcher = [number | string, (node: Node, delta: Delta) => Delta];
 /**
- * Гарантированно убирает неразрывные пробелы из Quill-HTML: и литеральные
- * сущности (` `/` `/` `), и сам символ U+00A0. Применяется
- * на `onChange` КАЖДОГО редактора — это финальная страховка поверх
- * clipboard-matcher'ов (которые ловят только вставку): что бы ни оказалось
- * в редакторе (вставка, набор двойных пробелов, загрузка легаси-контента),
- * наружу уходит текст без nbsp.
+ * Убирает неразрывные пробелы из Quill-HTML: и литеральные сущности
+ * (` `/` `/` `), и сам символ U+00A0.
  *
- * Зачем: nbsp (1) запрещает перенос строки — длинные абзацы вылезают за
- * контейнер письма и рвутся посреди слова, (2) ломает разбор Handlebars
- * `{{#if X}}` на стороне рендера (`transformText`) и валидатор
- * `IsIfIncorrect`, которым нужен обычный пробел после `#if`.
+ * ВАЖНО: не вешать на `onChange` контролируемого ReactQuill. Редактор
+ * сравнивает `value`-проп со своей внутренней сериализацией (она хранит
+ * ` `); если на каждый change подсовывать очищенное значение, оно
+ * никогда не совпадёт — ReactQuill бесконечно вызывает `setEditorContents`
+ * → `onChange` → `setState` и страница виснет («Maximum update depth»).
+ *
+ * Правильные места: (1) нормализация при ЗАГРУЗКЕ/сохранении (см.
+ * `normalizeIfTags`, `sanitizeQuillHtml`), (2) clipboard-matcher на вставку
+ * (`normalizeWhitespaceInDelta` ниже), (3) рендер письма (`transformText`).
+ * nbsp вреден тем, что запрещает перенос строки (абзацы рвутся посреди
+ * слова) и ломает разбор `{{#if X}}` (нужен обычный пробел после `#if`).
  */
 export declare function stripNonBreakingSpaces(html?: string | null): string;
 /**

package/dist/quill-clipboard-matchers.js

@@ -31,17 +31,20 @@ exports.getStripColorClipboardMatchers = getStripColorClipboardMatchers;
 exports.getNormalizeWhitespaceClipboardMatchers = getNormalizeWhitespaceClipboardMatchers;
 const quill_delta_1 = __importDefault(require("quill-delta"));
 /**
- * Гарантированно убирает неразрывные пробелы из Quill-HTML: и литеральные
- * сущности (` `/` `/` `), и сам символ U+00A0. Применяется
- * на `onChange` КАЖДОГО редактора — это финальная страховка поверх
- * clipboard-matcher'ов (которые ловят только вставку): что бы ни оказалось
- * в редакторе (вставка, набор двойных пробелов, загрузка легаси-контента),
- * наружу уходит текст без nbsp.
+ * Убирает неразрывные пробелы из Quill-HTML: и литеральные сущности
+ * (` `/` `/` `), и сам символ U+00A0.
  *
- * Зачем: nbsp (1) запрещает перенос строки — длинные абзацы вылезают за
- * контейнер письма и рвутся посреди слова, (2) ломает разбор Handlebars
- * `{{#if X}}` на стороне рендера (`transformText`) и валидатор
- * `IsIfIncorrect`, которым нужен обычный пробел после `#if`.
+ * ВАЖНО: не вешать на `onChange` контролируемого ReactQuill. Редактор
+ * сравнивает `value`-проп со своей внутренней сериализацией (она хранит
+ * ` `); если на каждый change подсовывать очищенное значение, оно
+ * никогда не совпадёт — ReactQuill бесконечно вызывает `setEditorContents`
+ * → `onChange` → `setState` и страница виснет («Maximum update depth»).
+ *
+ * Правильные места: (1) нормализация при ЗАГРУЗКЕ/сохранении (см.
+ * `normalizeIfTags`, `sanitizeQuillHtml`), (2) clipboard-matcher на вставку
+ * (`normalizeWhitespaceInDelta` ниже), (3) рендер письма (`transformText`).
+ * nbsp вреден тем, что запрещает перенос строки (абзацы рвутся посреди
+ * слова) и ломает разбор `{{#if X}}` (нужен обычный пробел после `#if`).
  */
 function stripNonBreakingSpaces(html) {
     if (!html)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@escapenavigator/utils",
-  "version": "1.10.144",
+  "version": "1.10.146",
   "publishConfig": {
     "access": "public"
   },
@@ -14,12 +14,11 @@
     "test": "jest"
   },
   "dependencies": {
-    "@escapenavigator/types": "^1.10.140",
+    "@escapenavigator/types": "^1.10.142",
     "axios": "^0.21.4",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.13.2",
     "i18next": "^21.6.4",
-    "node-html-parser": "^7.1.0",
     "quill-delta": "^5.1.0"
   },
   "devDependencies": {
@@ -28,5 +27,5 @@
     "ts-jest": "^29.1.1",
     "typescript": "^5.6"
   },
-  "gitHead": "3a47865b15ba6211c53a0b9892ae0e618ada4c25"
+  "gitHead": "022977230155bf802f8c3f349fb49a42ad7fd5a9"
 }