fix(YfmHtmlBlock): deprecate local sanitize utils (#1050)

Author: makhnatkin

demo/src/components/Playground.tsx

@@ -1,7 +1,7 @@
 import {type CSSProperties, memo, useCallback, useEffect, useMemo, useState} from 'react';
 
 import type {EmbeddingMode} from '@diplodoc/html-extension';
-import {defaultOptions} from '@diplodoc/transform/lib/sanitize';
+import {htmlBlockDefaultSanitizer} from '@diplodoc/html-extension';
 import {
     type DirectiveSyntaxValue,
     type FileUploadHandler,
@@ -28,7 +28,6 @@ import {FoldingHeading} from '@gravity-ui/markdown-editor/extensions/additional/
 import {Math} from '@gravity-ui/markdown-editor/extensions/additional/Math/index.js';
 import {Mermaid} from '@gravity-ui/markdown-editor/extensions/additional/Mermaid/index.js';
 import {YfmHtmlBlock} from '@gravity-ui/markdown-editor/extensions/additional/YfmHtmlBlock/index.js';
-import {getSanitizeYfmHtmlBlock} from '@gravity-ui/markdown-editor/extensions/additional/YfmHtmlBlock/utils.js';
 import {Button, DropdownMenu} from '@gravity-ui/uikit';
 
 import {getPlugins} from '../defaults/md-plugins';
@@ -211,7 +210,7 @@ export const Playground = memo<PlaygroundProps>((props) => {
                         .use(FoldingHeading)
                         .use(YfmHtmlBlock, {
                             useConfig: useYfmHtmlBlockStyles,
-                            sanitize: getSanitizeYfmHtmlBlock({options: defaultOptions}),
+                            sanitize: htmlBlockDefaultSanitizer,
                             autoSave: {
                                 enabled:
                                     storyAdditionalControls?.yfmHtmlBlockAutoSaveEnabled ?? true,

packages/editor/src/extensions/additional/YfmHtmlBlock/utils.ts

@@ -1,8 +1,8 @@
+// MAJOR: delete this file, use `htmlBlockDefaultSanitizer` from `@diplodoc/html-extension`
 import type {SanitizeOptions} from '@diplodoc/transform/lib/sanitize.js';
 
 import {getSanitize} from 'src/utils/getSanitize';
 
-// MAJOR: use `import {sanitize} from '@diplodoc/transform/lib/sanitize.js'`
 const diplodocSanitize = getSanitize('YfmHtmlBlock');
 
 // yfmHtmlBlock additional css properties white list
@@ -88,6 +88,9 @@ const yfmHtmlBlockAllowedAttributes = {
     style: [],
 };
 
+/**
+ * @deprecated Use `htmlBlockDefaultSanitizer` from `@diplodoc/html-extension` instead.
+ */
 export const getYfmHtmlBlockOptions = (defaultOptions: SanitizeOptions): SanitizeOptions => {
     type AllowedAttributesType = Record<
         string,
@@ -112,10 +115,16 @@ export const getYfmHtmlBlockOptions = (defaultOptions: SanitizeOptions): Sanitiz
     };
 };
 
+/**
+ * @deprecated Use `htmlBlockDefaultSanitizer` from `@diplodoc/html-extension` instead.
+ */
 export interface GetSanitizeYfmHtmlBlockArgs {
     options: SanitizeOptions;
     sanitize?: (html: string, options?: SanitizeOptions) => string;
 }
+/**
+ * @deprecated Use `htmlBlockDefaultSanitizer` from `@diplodoc/html-extension` instead.
+ */
 export const getSanitizeYfmHtmlBlock =
     ({options, sanitize = diplodocSanitize}: GetSanitizeYfmHtmlBlockArgs) =>
     (content: string) =>

pnpm-lock.yaml

@@ -19,7 +19,7 @@ catalogs:
     '@diplodoc/cut-extension': ^1.1.0
     '@diplodoc/file-extension': ^0.2.1
     '@diplodoc/folding-headings-extension': ^0.1.2
-    '@diplodoc/html-extension': ^2.9.1
+    '@diplodoc/html-extension': ^2.9.3
     '@diplodoc/latex-extension': ^1.4.1
     '@diplodoc/mermaid-extension': ^2.0.0
     '@diplodoc/quote-link-extension': 0.1.3