@snack-uikit/code-editor 0.4.7 → 0.5.1-preview-d4775873.0

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# 0.5.0 (2025-02-07)
+
+
+### Features
+
+* **PDS-1445:** support json schema for yaml, json languages ([a709fe5](https://git.sbercloud.tech/sbercloud-ui/tokens-design-system/snack-uikit/commits/a709fe5e061917c5017de1bd1b6f01c15f4b3002))
+
+
+
+
+
 ## 0.4.7 (2025-01-23)
 
 ### Only dependencies have been changed

package/README.md

@@ -12,6 +12,7 @@
 ### Props
 | name | type | default value | description |
 |------|------|---------------|-------------|
+| jsonSchema* | `JsonSchema` | - | Схема для валидации |
 | themeName | `string` | - | Название текущей темы. Значение не важно, важно что смена значения запускает пересчет стилей. |
 | hasBackground | `boolean` | true | Включение/отключение псевдобекграунда |
 | defaultValue | `string` | - | Default value of the current model |
@@ -35,6 +36,21 @@
 | onMount | `OnMount` | - | Signature: function(editor: monaco.editor.IStandaloneCodeEditor, monaco: Monaco) => void An event is emitted when the editor is mounted It gets the editor instance as a first argument and the monaco instance as a second Defaults to "noop" |
 | onChange | `OnChange` | - | Signature: function(value: string \| undefined, ev: monaco.editor.IModelContentChangedEvent) => void An event is emitted when the content of the current model is changed |
 | onValidate | `OnValidate` | - | Signature: function(markers: monaco.editor.IMarker[]) => void An event is emitted when the content of the current model is changed and the current model markers are ready Defaults to "noop" |
+| hoverDescription | `HoverDescription` | - |  |
 
 
 [//]: DOCUMENTATION_SECTION_END
+
+### Поддержка YAML
+Для обеспечения полноценной работы YAML Monaco Editor необходимо подключить `yaml.worker`. Это можно сделать следующими способами: с использованием [`window.MonacoEnvironment`](https://www.npmjs.com/package/monaco-yaml#usage) или с помощью плагина [`MonacoWebpackPlugin`](https://www.npmjs.com/package/monaco-yaml#using-monaco-webpack-loader-plugin) . Подробнее с `monaco-yaml` можно ознакомиться [тут]((https://www.npmjs.com/package/monaco-yaml))
+
+### Как редактор загружает worker?
+Плагин создает новые точки входа каждого build-in воркера и для каждого дабавленного отдельно. Плагин создат глобальную переменную, используя которую редкатор будет загружать нужный воркер на основе текущего `language`.
+
+Чтобы управлять конфигурацией загрузчика Monaco Editor, добавьте
+```typescript
+import * as monaco from 'monaco-editor';
+import { loader } from '@snack-uikit/code-editor';
+loader.config({ monaco });
+```
+Это позволяет динамически настраивать пути и другие параметры при инициализации редактора.

package/dist/cjs/components/CodeEditor.d.ts

@@ -1,5 +1,5 @@
-import { EditorProps } from '@monaco-editor/react';
 import { WithSupportProps } from '@snack-uikit/utils';
+import { EditorBaseProps, EditorWithJsonSchemaProps } from './types';
 export type CodeEditorProps = WithSupportProps<{
     /**
      * Название текущей темы. Значение не важно, важно что смена значения запускает пересчет стилей.
@@ -9,5 +9,5 @@ export type CodeEditorProps = WithSupportProps<{
      * Включение/отключение псевдобекграунда
      */
     hasBackground?: boolean;
-}> & EditorProps;
-export declare function CodeEditor({ themeName, className, theme, options, loading, hasBackground, onMount, ...props }: CodeEditorProps): import("react/jsx-runtime").JSX.Element;
+}> & (EditorBaseProps | EditorWithJsonSchemaProps);
+export declare function CodeEditor({ themeName, className, theme, options, loading, hasBackground, onMount, language, hoverDescription, ...props }: CodeEditorProps): import("react/jsx-runtime").JSX.Element;

package/dist/cjs/components/CodeEditor.js

@@ -36,11 +36,18 @@ function CodeEditor(_a) {
       options,
       loading,
       hasBackground = true,
-      onMount
+      onMount,
+      language,
+      hoverDescription
     } = _a,
-    props = __rest(_a, ["themeName", "className", "theme", "options", "loading", "hasBackground", "onMount"]);
+    props = __rest(_a, ["themeName", "className", "theme", "options", "loading", "hasBackground", "onMount", "language", "hoverDescription"]);
   const monaco = (0, react_1.useMonaco)();
   const [wrapperElement, setWrapperElement] = (0, react_2.useState)(null);
+  const {
+    jsonSchemaProps,
+    jsonSchemaOptions
+  } = (0, hooks_1.useApplyJsonSchema)(language, 'jsonSchema' in props ? props.jsonSchema : undefined);
+  (0, hooks_1.useHoverProvider)(language, hoverDescription);
   const onEditorMount = (0, react_2.useCallback)((editor, monaco) => {
     var _a;
     monaco && (0, utils_1.isBrowser)() && ((_a = document === null || document === void 0 ? void 0 : document.fonts) === null || _a === void 0 ? void 0 : _a.ready.finally(monaco.editor.remeasureFonts));
@@ -101,23 +108,24 @@ function CodeEditor(_a) {
   monaco === null || monaco === void 0 ? void 0 : monaco.editor.defineTheme('snack', Object.assign(Object.assign({}, themeDataWithoutBase), {
     base: 'vs'
   }));
-  const mergedOptions = (0, react_2.useMemo)(() => Object.assign(Object.assign(Object.assign({}, constants_1.CODE_EDITOR_OPTIONS), (themeValues === null || themeValues === void 0 ? void 0 : themeValues.mono) ? {
+  const mergedOptions = (0, react_2.useMemo)(() => Object.assign(Object.assign(Object.assign(Object.assign({}, constants_1.CODE_EDITOR_OPTIONS), jsonSchemaOptions), (themeValues === null || themeValues === void 0 ? void 0 : themeValues.mono) ? {
     fontSize: Number.parseFloat(themeValues.mono.body.s['font-size']),
     fontWeight: themeValues.mono.body.s['font-weight'],
     fontFamily: themeValues.mono.body.s['font-family']
-  } : constants_1.DEFAULT_THEME_OPTIONS.mono.s), options), [options, themeValues === null || themeValues === void 0 ? void 0 : themeValues.mono]);
+  } : constants_1.DEFAULT_THEME_OPTIONS.mono.s), options), [options, themeValues === null || themeValues === void 0 ? void 0 : themeValues.mono, jsonSchemaOptions]);
   return (0, jsx_runtime_1.jsx)("div", Object.assign({
     className: className
   }, (0, utils_1.extractSupportProps)(props), {
     ref: setWrapperElement,
-    children: (0, jsx_runtime_1.jsx)(react_1.Editor, Object.assign({}, props, {
+    children: (0, jsx_runtime_1.jsx)(react_1.Editor, Object.assign({}, props, jsonSchemaProps, {
       theme: theme !== null && theme !== void 0 ? theme : dark ? 'snackDark' : 'snack',
       className: (0, classnames_1.default)({
         [styles_module_scss_1.default.editor]: hasBackground
       }),
       loading: loading !== null && loading !== void 0 ? loading : (0, jsx_runtime_1.jsx)(loaders_1.Spinner, {}),
       options: mergedOptions,
-      onMount: onEditorMount
+      onMount: onEditorMount,
+      language: language
     }))
   }));
 }

package/dist/cjs/components/constants.d.ts

@@ -99,3 +99,9 @@ export declare const CODE_EDITOR_OPTIONS: {
         indentation: boolean;
     };
 };
+export declare const YAML_CODE_EDITOR_OPTIONS: {
+    quickSuggestions: {
+        strings: boolean;
+    };
+};
+export declare const DEFAULT_SCHEMA_URI = "schema://editor-schema";

package/dist/cjs/components/constants.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.CODE_EDITOR_OPTIONS = exports.THEME_VARS = exports.DEFAULT_THEME_OPTIONS = exports.DEFAULT_THEME_VALUES = void 0;
+exports.DEFAULT_SCHEMA_URI = exports.YAML_CODE_EDITOR_OPTIONS = exports.CODE_EDITOR_OPTIONS = exports.THEME_VARS = exports.DEFAULT_THEME_OPTIONS = exports.DEFAULT_THEME_VALUES = void 0;
 exports.DEFAULT_THEME_VALUES = {
   semanticTokenColors: {
     enumMember: {
@@ -113,4 +113,10 @@ exports.CODE_EDITOR_OPTIONS = {
   guides: {
     indentation: false
   }
-};
+};
+exports.YAML_CODE_EDITOR_OPTIONS = {
+  quickSuggestions: {
+    strings: true
+  }
+};
+exports.DEFAULT_SCHEMA_URI = 'schema://editor-schema';

package/dist/cjs/components/hooks.d.ts

@@ -1,3 +1,4 @@
+import { HoverDescription, JsonSchema } from './types';
 type UseCalculatedThemeValuesProps = {
     stylesOriginNode: HTMLDivElement | null;
     themeName?: string;
@@ -41,4 +42,11 @@ export declare function useCalculatedThemeValues({ stylesOriginNode, themeName }
         };
     };
 } | undefined;
+export declare function useApplyJsonSchema(language?: string, jsonSchema?: JsonSchema): {
+    jsonSchemaProps: {
+        path: string | undefined;
+    };
+    jsonSchemaOptions: import("monaco-editor").editor.IStandaloneEditorConstructionOptions | undefined;
+};
+export declare function useHoverProvider(language?: string, hoverDescription?: HoverDescription): void;
 export {};

package/dist/cjs/components/hooks.js

@@ -4,9 +4,14 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.useCalculatedThemeValues = useCalculatedThemeValues;
-const react_1 = require("react");
+exports.useApplyJsonSchema = useApplyJsonSchema;
+exports.useHoverProvider = useHoverProvider;
+const react_1 = require("@monaco-editor/react");
+const monaco_yaml_1 = require("monaco-yaml");
+const react_2 = require("react");
 const utils_1 = require("@snack-uikit/utils");
 const constants_1 = require("./constants");
+const utils_2 = require("./utils");
 function getThemeVars(styles) {
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   return function mapComputedTree(tree) {
@@ -25,16 +30,105 @@ function useCalculatedThemeValues(_ref) {
     stylesOriginNode,
     themeName
   } = _ref;
-  const [values, setValues] = (0, react_1.useState)(undefined);
+  const [values, setValues] = (0, react_2.useState)(undefined);
   const {
     themeClassName
   } = (0, utils_1.useThemeContext)();
   const trigger = themeName !== null && themeName !== void 0 ? themeName : themeClassName;
-  (0, react_1.useEffect)(() => {
+  (0, react_2.useEffect)(() => {
     if (stylesOriginNode) {
       const styles = getComputedStyle(stylesOriginNode);
       setValues(getThemeVars(styles)(constants_1.THEME_VARS));
     }
   }, [stylesOriginNode, trigger]);
   return values;
+}
+function useApplyJsonSchema(language, jsonSchema) {
+  const monaco = (0, react_1.useMonaco)();
+  const [jsonSchemaOptions, setJsonSchemaOptions] = (0, react_2.useState)({});
+  const modelPath = jsonSchema === null || jsonSchema === void 0 ? void 0 : jsonSchema.fileMatch;
+  const preparedJsonSchema = (0, react_2.useMemo)(() => (0, utils_2.getJsonSchema)(jsonSchema), [jsonSchema]);
+  const configureYamlLanguage = (0, react_2.useCallback)(() => {
+    if (!monaco || !preparedJsonSchema) {
+      return;
+    }
+    const model = (0, monaco_yaml_1.configureMonacoYaml)(monaco, {
+      enableSchemaRequest: true,
+      schemas: [preparedJsonSchema]
+    });
+    return {
+      options: constants_1.YAML_CODE_EDITOR_OPTIONS,
+      dispose: model.dispose
+    };
+  }, [monaco, preparedJsonSchema]);
+  const configureJsonLanguage = (0, react_2.useCallback)(() => {
+    if (!monaco || !preparedJsonSchema) {
+      return;
+    }
+    monaco.languages.json.jsonDefaults.setDiagnosticsOptions({
+      validate: true,
+      schemas: [preparedJsonSchema]
+    });
+  }, [monaco, preparedJsonSchema]);
+  const configureJsonSchema = (0, react_2.useCallback)(() => {
+    switch (language) {
+      case 'yaml':
+        return configureYamlLanguage();
+      case 'json':
+        return configureJsonLanguage();
+      default:
+        break;
+    }
+  }, [language, configureYamlLanguage, configureJsonLanguage]);
+  (0, react_2.useEffect)(() => {
+    var _a;
+    const jsonSchemaSettings = configureJsonSchema();
+    setJsonSchemaOptions((_a = jsonSchemaSettings === null || jsonSchemaSettings === void 0 ? void 0 : jsonSchemaSettings.options) !== null && _a !== void 0 ? _a : {});
+    return () => {
+      var _a;
+      setJsonSchemaOptions({});
+      (_a = jsonSchemaSettings === null || jsonSchemaSettings === void 0 ? void 0 : jsonSchemaSettings.dispose) === null || _a === void 0 ? void 0 : _a.call(jsonSchemaSettings);
+    };
+  }, [configureJsonSchema]);
+  return (0, react_2.useMemo)(() => ({
+    jsonSchemaProps: {
+      path: modelPath
+    },
+    jsonSchemaOptions
+  }), [jsonSchemaOptions, modelPath]);
+}
+function useHoverProvider(language, hoverDescription) {
+  const monaco = (0, react_1.useMonaco)();
+  const configureHoverProvider = (0, react_2.useCallback)(() => {
+    if (!monaco || !language || !hoverDescription) {
+      return;
+    }
+    return monaco.languages.registerHoverProvider(language, {
+      provideHover: (model, position) => {
+        var _a;
+        const wordInfo = model.getWordAtPosition(position);
+        const hoveredDescription = hoverDescription[(_a = wordInfo === null || wordInfo === void 0 ? void 0 : wordInfo.word) !== null && _a !== void 0 ? _a : ''];
+        if (wordInfo && hoveredDescription) {
+          const {
+            startColumn,
+            endColumn
+          } = wordInfo;
+          return {
+            range: new monaco.Range(position.lineNumber, startColumn, position.lineNumber, endColumn),
+            contents: [{
+              value: hoveredDescription
+            }]
+          };
+        }
+        return null;
+      }
+    });
+  }, [monaco, language, hoverDescription]);
+  (0, react_2.useEffect)(() => {
+    var _a;
+    const {
+      dispose
+    } = (_a = configureHoverProvider()) !== null && _a !== void 0 ? _a : {};
+    return dispose;
+  }, [configureHoverProvider]);
 }

package/dist/cjs/components/index.d.ts

@@ -1 +1,2 @@
 export * from './CodeEditor';
+export * from './types';

package/dist/cjs/components/index.js

@@ -22,4 +22,5 @@ var __exportStar = void 0 && (void 0).__exportStar || function (m, exports) {
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-__exportStar(require("./CodeEditor"), exports);
+__exportStar(require("./CodeEditor"), exports);
+__exportStar(require("./types"), exports);

package/dist/cjs/components/types.d.ts

@@ -0,0 +1,32 @@
+import { EditorProps as MonacoEditorProps } from '@monaco-editor/react';
+import { JSONSchema } from 'monaco-yaml';
+export type HoverDescription = {
+    [word: string]: string;
+};
+export type EditorBaseProps = MonacoEditorProps & {
+    hoverDescription?: HoverDescription;
+};
+export type SupportedSchemaLanguage = 'json' | 'yaml';
+export type JsonSchema = {
+    uri?: string;
+    schema: JSONSchema;
+    fileMatch: string;
+};
+export type WithJsonSchema = {
+    /**
+     * Схема для валидации
+     */
+    jsonSchema: JsonSchema;
+    path?: never;
+};
+type WithoutJsonSchema = Pick<MonacoEditorProps, 'path'>;
+export type EditorWithJsonSchemaProps = Omit<EditorBaseProps, 'language' | 'path'> & {
+    language: SupportedSchemaLanguage;
+} & (WithJsonSchema | WithoutJsonSchema);
+export type Dispose = {
+    dispose?: () => void;
+};
+export type ConfigureJsonSchemaReturn = ({
+    options?: MonacoEditorProps['options'];
+} & Dispose) | undefined;
+export {};

package/dist/cjs/components/types.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/dist/cjs/components/utils.d.ts

@@ -1,3 +1,6 @@
+import { SchemasSettings } from 'monaco-yaml';
+import { JsonSchema } from './types';
 export declare function rgb2hsl(HTMLcolor: string): number[];
 export declare function isDark(color: string): boolean;
 export declare function initLoaderConfig(): void;
+export declare const getJsonSchema: (jsonSchema?: JsonSchema) => SchemasSettings | undefined;

package/dist/cjs/components/utils.js

@@ -8,11 +8,13 @@ var __importDefault = void 0 && (void 0).__importDefault || function (mod) {
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+exports.getJsonSchema = void 0;
 exports.rgb2hsl = rgb2hsl;
 exports.isDark = isDark;
 exports.initLoaderConfig = initLoaderConfig;
 const react_1 = require("@monaco-editor/react");
 const chroma_js_1 = __importDefault(require("chroma-js"));
+const constants_1 = require("./constants");
 function rgb2hsl(HTMLcolor) {
   const [r, g, b] = chroma_js_1.default.valid(HTMLcolor) ? (0, chroma_js_1.default)(HTMLcolor).rgb().map(c => c / 255) : [0, 0, 0];
   const max = Math.max(r, g, b),
@@ -53,4 +55,9 @@ function initLoaderConfig() {
   // eslint-disable-next-line @typescript-eslint/ban-ts-comment
   // @ts-ignore
   window['__snack-code-editor-loader-config__'] && react_1.loader.config(window['__snack-code-editor-loader-config__']);
-}
+}
+const getJsonSchema = jsonSchema => jsonSchema && Object.assign(Object.assign({}, jsonSchema), {
+  uri: (jsonSchema === null || jsonSchema === void 0 ? void 0 : jsonSchema.uri) || constants_1.DEFAULT_SCHEMA_URI,
+  fileMatch: [jsonSchema.fileMatch]
+});
+exports.getJsonSchema = getJsonSchema;

package/dist/cjs/index.d.ts

@@ -2,5 +2,5 @@
   Monaco loader defines the way how monaco will be loaded.
   @see https://github.com/suren-atoyan/monaco-react/tree/master?tab=readme-ov-file#loader-config
  */
-export { loader } from '@monaco-editor/react';
+export { loader, useMonaco } from '@monaco-editor/react';
 export * from './components';

package/dist/cjs/index.js

@@ -22,7 +22,7 @@ var __exportStar = void 0 && (void 0).__exportStar || function (m, exports) {
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.loader = void 0;
+exports.useMonaco = exports.loader = void 0;
 /**
   Monaco loader defines the way how monaco will be loaded.
   @see https://github.com/suren-atoyan/monaco-react/tree/master?tab=readme-ov-file#loader-config
@@ -34,4 +34,10 @@ Object.defineProperty(exports, "loader", {
     return react_1.loader;
   }
 });
+Object.defineProperty(exports, "useMonaco", {
+  enumerable: true,
+  get: function () {
+    return react_1.useMonaco;
+  }
+});
 __exportStar(require("./components"), exports);

package/dist/esm/components/CodeEditor.d.ts

@@ -1,5 +1,5 @@
-import { EditorProps } from '@monaco-editor/react';
 import { WithSupportProps } from '@snack-uikit/utils';
+import { EditorBaseProps, EditorWithJsonSchemaProps } from './types';
 export type CodeEditorProps = WithSupportProps<{
     /**
      * Название текущей темы. Значение не важно, важно что смена значения запускает пересчет стилей.
@@ -9,5 +9,5 @@ export type CodeEditorProps = WithSupportProps<{
      * Включение/отключение псевдобекграунда
      */
     hasBackground?: boolean;
-}> & EditorProps;
-export declare function CodeEditor({ themeName, className, theme, options, loading, hasBackground, onMount, ...props }: CodeEditorProps): import("react/jsx-runtime").JSX.Element;
+}> & (EditorBaseProps | EditorWithJsonSchemaProps);
+export declare function CodeEditor({ themeName, className, theme, options, loading, hasBackground, onMount, language, hoverDescription, ...props }: CodeEditorProps): import("react/jsx-runtime").JSX.Element;

package/dist/esm/components/CodeEditor.js

@@ -16,14 +16,16 @@ import { useCallback, useMemo, useState } from 'react';
 import { Spinner } from '@snack-uikit/loaders';
 import { extractSupportProps, isBrowser } from '@snack-uikit/utils';
 import { CODE_EDITOR_OPTIONS, DEFAULT_THEME_OPTIONS, DEFAULT_THEME_VALUES } from './constants';
-import { useCalculatedThemeValues } from './hooks';
+import { useApplyJsonSchema, useCalculatedThemeValues, useHoverProvider } from './hooks';
 import styles from './styles.module.css';
 import { initLoaderConfig, isDark } from './utils';
 initLoaderConfig();
 export function CodeEditor(_a) {
-    var { themeName, className, theme, options, loading, hasBackground = true, onMount } = _a, props = __rest(_a, ["themeName", "className", "theme", "options", "loading", "hasBackground", "onMount"]);
+    var { themeName, className, theme, options, loading, hasBackground = true, onMount, language, hoverDescription } = _a, props = __rest(_a, ["themeName", "className", "theme", "options", "loading", "hasBackground", "onMount", "language", "hoverDescription"]);
     const monaco = useMonaco();
     const [wrapperElement, setWrapperElement] = useState(null);
+    const { jsonSchemaProps, jsonSchemaOptions } = useApplyJsonSchema(language, 'jsonSchema' in props ? props.jsonSchema : undefined);
+    useHoverProvider(language, hoverDescription);
     const onEditorMount = useCallback((editor, monaco) => {
         var _a;
         monaco && isBrowser() && ((_a = document === null || document === void 0 ? void 0 : document.fonts) === null || _a === void 0 ? void 0 : _a.ready.finally(monaco.editor.remeasureFonts));
@@ -79,12 +81,12 @@ export function CodeEditor(_a) {
     const dark = useMemo(() => { var _a; return isDark((_a = themeValues === null || themeValues === void 0 ? void 0 : themeValues.sys.available.complementary) !== null && _a !== void 0 ? _a : ''); }, [themeValues === null || themeValues === void 0 ? void 0 : themeValues.sys.available.complementary]);
     monaco === null || monaco === void 0 ? void 0 : monaco.editor.defineTheme('snackDark', Object.assign(Object.assign({}, themeDataWithoutBase), { base: 'vs-dark' }));
     monaco === null || monaco === void 0 ? void 0 : monaco.editor.defineTheme('snack', Object.assign(Object.assign({}, themeDataWithoutBase), { base: 'vs' }));
-    const mergedOptions = useMemo(() => (Object.assign(Object.assign(Object.assign({}, CODE_EDITOR_OPTIONS), ((themeValues === null || themeValues === void 0 ? void 0 : themeValues.mono)
+    const mergedOptions = useMemo(() => (Object.assign(Object.assign(Object.assign(Object.assign({}, CODE_EDITOR_OPTIONS), jsonSchemaOptions), ((themeValues === null || themeValues === void 0 ? void 0 : themeValues.mono)
         ? {
             fontSize: Number.parseFloat(themeValues.mono.body.s['font-size']),
             fontWeight: themeValues.mono.body.s['font-weight'],
             fontFamily: themeValues.mono.body.s['font-family'],
         }
-        : DEFAULT_THEME_OPTIONS.mono.s)), options)), [options, themeValues === null || themeValues === void 0 ? void 0 : themeValues.mono]);
-    return (_jsx("div", Object.assign({ className: className }, extractSupportProps(props), { ref: setWrapperElement, children: _jsx(Editor, Object.assign({}, props, { theme: theme !== null && theme !== void 0 ? theme : (dark ? 'snackDark' : 'snack'), className: cn({ [styles.editor]: hasBackground }), loading: loading !== null && loading !== void 0 ? loading : _jsx(Spinner, {}), options: mergedOptions, onMount: onEditorMount })) })));
+        : DEFAULT_THEME_OPTIONS.mono.s)), options)), [options, themeValues === null || themeValues === void 0 ? void 0 : themeValues.mono, jsonSchemaOptions]);
+    return (_jsx("div", Object.assign({ className: className }, extractSupportProps(props), { ref: setWrapperElement, children: _jsx(Editor, Object.assign({}, props, jsonSchemaProps, { theme: theme !== null && theme !== void 0 ? theme : (dark ? 'snackDark' : 'snack'), className: cn({ [styles.editor]: hasBackground }), loading: loading !== null && loading !== void 0 ? loading : _jsx(Spinner, {}), options: mergedOptions, onMount: onEditorMount, language: language })) })));
 }

package/dist/esm/components/constants.d.ts

@@ -99,3 +99,9 @@ export declare const CODE_EDITOR_OPTIONS: {
         indentation: boolean;
     };
 };
+export declare const YAML_CODE_EDITOR_OPTIONS: {
+    quickSuggestions: {
+        strings: boolean;
+    };
+};
+export declare const DEFAULT_SCHEMA_URI = "schema://editor-schema";

package/dist/esm/components/constants.js

@@ -95,3 +95,9 @@ export const CODE_EDITOR_OPTIONS = {
         indentation: false,
     },
 };
+export const YAML_CODE_EDITOR_OPTIONS = {
+    quickSuggestions: {
+        strings: true,
+    },
+};
+export const DEFAULT_SCHEMA_URI = 'schema://editor-schema';

package/dist/esm/components/hooks.d.ts

@@ -1,3 +1,4 @@
+import { HoverDescription, JsonSchema } from './types';
 type UseCalculatedThemeValuesProps = {
     stylesOriginNode: HTMLDivElement | null;
     themeName?: string;
@@ -41,4 +42,11 @@ export declare function useCalculatedThemeValues({ stylesOriginNode, themeName }
         };
     };
 } | undefined;
+export declare function useApplyJsonSchema(language?: string, jsonSchema?: JsonSchema): {
+    jsonSchemaProps: {
+        path: string | undefined;
+    };
+    jsonSchemaOptions: import("monaco-editor").editor.IStandaloneEditorConstructionOptions | undefined;
+};
+export declare function useHoverProvider(language?: string, hoverDescription?: HoverDescription): void;
 export {};

package/dist/esm/components/hooks.js

@@ -1,6 +1,9 @@
-import { useEffect, useState } from 'react';
+import { useMonaco } from '@monaco-editor/react';
+import { configureMonacoYaml } from 'monaco-yaml';
+import { useCallback, useEffect, useMemo, useState } from 'react';
 import { useThemeContext } from '@snack-uikit/utils';
-import { THEME_VARS } from './constants';
+import { THEME_VARS, YAML_CODE_EDITOR_OPTIONS } from './constants';
+import { getJsonSchema } from './utils';
 function getThemeVars(styles) {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     return function mapComputedTree(tree) {
@@ -26,3 +29,83 @@ export function useCalculatedThemeValues({ stylesOriginNode, themeName }) {
     }, [stylesOriginNode, trigger]);
     return values;
 }
+export function useApplyJsonSchema(language, jsonSchema) {
+    const monaco = useMonaco();
+    const [jsonSchemaOptions, setJsonSchemaOptions] = useState({});
+    const modelPath = jsonSchema === null || jsonSchema === void 0 ? void 0 : jsonSchema.fileMatch;
+    const preparedJsonSchema = useMemo(() => getJsonSchema(jsonSchema), [jsonSchema]);
+    const configureYamlLanguage = useCallback(() => {
+        if (!monaco || !preparedJsonSchema) {
+            return;
+        }
+        const model = configureMonacoYaml(monaco, {
+            enableSchemaRequest: true,
+            schemas: [preparedJsonSchema],
+        });
+        return {
+            options: YAML_CODE_EDITOR_OPTIONS,
+            dispose: model.dispose,
+        };
+    }, [monaco, preparedJsonSchema]);
+    const configureJsonLanguage = useCallback(() => {
+        if (!monaco || !preparedJsonSchema) {
+            return;
+        }
+        monaco.languages.json.jsonDefaults.setDiagnosticsOptions({
+            validate: true,
+            schemas: [preparedJsonSchema],
+        });
+    }, [monaco, preparedJsonSchema]);
+    const configureJsonSchema = useCallback(() => {
+        switch (language) {
+            case 'yaml':
+                return configureYamlLanguage();
+            case 'json':
+                return configureJsonLanguage();
+            default:
+                break;
+        }
+    }, [language, configureYamlLanguage, configureJsonLanguage]);
+    useEffect(() => {
+        var _a;
+        const jsonSchemaSettings = configureJsonSchema();
+        setJsonSchemaOptions((_a = jsonSchemaSettings === null || jsonSchemaSettings === void 0 ? void 0 : jsonSchemaSettings.options) !== null && _a !== void 0 ? _a : {});
+        return () => {
+            var _a;
+            setJsonSchemaOptions({});
+            (_a = jsonSchemaSettings === null || jsonSchemaSettings === void 0 ? void 0 : jsonSchemaSettings.dispose) === null || _a === void 0 ? void 0 : _a.call(jsonSchemaSettings);
+        };
+    }, [configureJsonSchema]);
+    return useMemo(() => ({
+        jsonSchemaProps: { path: modelPath },
+        jsonSchemaOptions,
+    }), [jsonSchemaOptions, modelPath]);
+}
+export function useHoverProvider(language, hoverDescription) {
+    const monaco = useMonaco();
+    const configureHoverProvider = useCallback(() => {
+        if (!monaco || !language || !hoverDescription) {
+            return;
+        }
+        return monaco.languages.registerHoverProvider(language, {
+            provideHover: (model, position) => {
+                var _a;
+                const wordInfo = model.getWordAtPosition(position);
+                const hoveredDescription = hoverDescription[(_a = wordInfo === null || wordInfo === void 0 ? void 0 : wordInfo.word) !== null && _a !== void 0 ? _a : ''];
+                if (wordInfo && hoveredDescription) {
+                    const { startColumn, endColumn } = wordInfo;
+                    return {
+                        range: new monaco.Range(position.lineNumber, startColumn, position.lineNumber, endColumn),
+                        contents: [{ value: hoveredDescription }],
+                    };
+                }
+                return null;
+            },
+        });
+    }, [monaco, language, hoverDescription]);
+    useEffect(() => {
+        var _a;
+        const { dispose } = (_a = configureHoverProvider()) !== null && _a !== void 0 ? _a : {};
+        return dispose;
+    }, [configureHoverProvider]);
+}

package/dist/esm/components/index.d.ts

@@ -1 +1,2 @@
 export * from './CodeEditor';
+export * from './types';

package/dist/esm/components/index.js

@@ -1 +1,2 @@
 export * from './CodeEditor';
+export * from './types';

package/dist/esm/components/types.d.ts

@@ -0,0 +1,32 @@
+import { EditorProps as MonacoEditorProps } from '@monaco-editor/react';
+import { JSONSchema } from 'monaco-yaml';
+export type HoverDescription = {
+    [word: string]: string;
+};
+export type EditorBaseProps = MonacoEditorProps & {
+    hoverDescription?: HoverDescription;
+};
+export type SupportedSchemaLanguage = 'json' | 'yaml';
+export type JsonSchema = {
+    uri?: string;
+    schema: JSONSchema;
+    fileMatch: string;
+};
+export type WithJsonSchema = {
+    /**
+     * Схема для валидации
+     */
+    jsonSchema: JsonSchema;
+    path?: never;
+};
+type WithoutJsonSchema = Pick<MonacoEditorProps, 'path'>;
+export type EditorWithJsonSchemaProps = Omit<EditorBaseProps, 'language' | 'path'> & {
+    language: SupportedSchemaLanguage;
+} & (WithJsonSchema | WithoutJsonSchema);
+export type Dispose = {
+    dispose?: () => void;
+};
+export type ConfigureJsonSchemaReturn = ({
+    options?: MonacoEditorProps['options'];
+} & Dispose) | undefined;
+export {};

package/dist/esm/components/types.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/components/utils.d.ts

@@ -1,3 +1,6 @@
+import { SchemasSettings } from 'monaco-yaml';
+import { JsonSchema } from './types';
 export declare function rgb2hsl(HTMLcolor: string): number[];
 export declare function isDark(color: string): boolean;
 export declare function initLoaderConfig(): void;
+export declare const getJsonSchema: (jsonSchema?: JsonSchema) => SchemasSettings | undefined;

package/dist/esm/components/utils.js

@@ -1,5 +1,6 @@
 import { loader } from '@monaco-editor/react';
 import chroma from 'chroma-js';
+import { DEFAULT_SCHEMA_URI } from './constants';
 export function rgb2hsl(HTMLcolor) {
     const [r, g, b] = chroma.valid(HTMLcolor)
         ? chroma(HTMLcolor)
@@ -45,3 +46,4 @@ export function initLoaderConfig() {
     // @ts-ignore
     window['__snack-code-editor-loader-config__'] && loader.config(window['__snack-code-editor-loader-config__']);
 }
+export const getJsonSchema = (jsonSchema) => jsonSchema && Object.assign(Object.assign({}, jsonSchema), { uri: (jsonSchema === null || jsonSchema === void 0 ? void 0 : jsonSchema.uri) || DEFAULT_SCHEMA_URI, fileMatch: [jsonSchema.fileMatch] });

package/dist/esm/index.d.ts

@@ -2,5 +2,5 @@
   Monaco loader defines the way how monaco will be loaded.
   @see https://github.com/suren-atoyan/monaco-react/tree/master?tab=readme-ov-file#loader-config
  */
-export { loader } from '@monaco-editor/react';
+export { loader, useMonaco } from '@monaco-editor/react';
 export * from './components';

package/dist/esm/index.js

@@ -2,5 +2,5 @@
   Monaco loader defines the way how monaco will be loaded.
   @see https://github.com/suren-atoyan/monaco-react/tree/master?tab=readme-ov-file#loader-config
  */
-export { loader } from '@monaco-editor/react';
+export { loader, useMonaco } from '@monaco-editor/react';
 export * from './components';

package/package.json

@@ -4,7 +4,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.4.7",
+  "version": "0.5.1-preview-d4775873.0",
   "sideEffects": [
     "*.css",
     "*.woff",
@@ -40,10 +40,11 @@
     "@snack-uikit/loaders": "0.9.1",
     "@snack-uikit/utils": "3.7.0",
     "chroma-js": "3.1.2",
-    "classnames": "2.5.1"
+    "classnames": "2.5.1",
+    "monaco-yaml": "5.2.3"
   },
   "devDependencies": {
     "@types/chroma-js": "2.4.4"
   },
-  "gitHead": "3528e78aec23804dca44d311947c1dcd4ed3792b"
+  "gitHead": "1db3ab2954a7d659a5bd2cb7a8403d5500cecd31"
 }

package/src/components/CodeEditor.tsx

@@ -1,4 +1,4 @@
-import { Editor, EditorProps, OnMount, useMonaco } from '@monaco-editor/react';
+import { Editor, OnMount, useMonaco } from '@monaco-editor/react';
 import cn from 'classnames';
 import { useCallback, useMemo, useState } from 'react';
 
@@ -6,8 +6,9 @@ import { Spinner } from '@snack-uikit/loaders';
 import { extractSupportProps, isBrowser, WithSupportProps } from '@snack-uikit/utils';
 
 import { CODE_EDITOR_OPTIONS, DEFAULT_THEME_OPTIONS, DEFAULT_THEME_VALUES } from './constants';
-import { useCalculatedThemeValues } from './hooks';
+import { useApplyJsonSchema, useCalculatedThemeValues, useHoverProvider } from './hooks';
 import styles from './styles.module.scss';
+import { EditorBaseProps, EditorWithJsonSchemaProps } from './types';
 import { initLoaderConfig, isDark } from './utils';
 
 initLoaderConfig();
@@ -22,7 +23,7 @@ export type CodeEditorProps = WithSupportProps<{
    */
   hasBackground?: boolean;
 }> &
-  EditorProps;
+  (EditorBaseProps | EditorWithJsonSchemaProps);
 
 export function CodeEditor({
   themeName,
@@ -32,11 +33,20 @@ export function CodeEditor({
   loading,
   hasBackground = true,
   onMount,
+  language,
+  hoverDescription,
   ...props
 }: CodeEditorProps) {
   const monaco = useMonaco();
   const [wrapperElement, setWrapperElement] = useState<HTMLDivElement | null>(null);
 
+  const { jsonSchemaProps, jsonSchemaOptions } = useApplyJsonSchema(
+    language,
+    'jsonSchema' in props ? props.jsonSchema : undefined,
+  );
+
+  useHoverProvider(language, hoverDescription);
+
   const onEditorMount = useCallback<OnMount>(
     (editor, monaco) => {
       monaco && isBrowser() && document?.fonts?.ready.finally(monaco.editor.remeasureFonts);
@@ -111,6 +121,7 @@ export function CodeEditor({
   const mergedOptions = useMemo(
     () => ({
       ...CODE_EDITOR_OPTIONS,
+      ...jsonSchemaOptions,
       ...(themeValues?.mono
         ? {
             fontSize: Number.parseFloat(themeValues.mono.body.s['font-size']),
@@ -120,18 +131,20 @@ export function CodeEditor({
         : DEFAULT_THEME_OPTIONS.mono.s),
       ...options,
     }),
-    [options, themeValues?.mono],
+    [options, themeValues?.mono, jsonSchemaOptions],
   );
 
   return (
     <div className={className} {...extractSupportProps(props)} ref={setWrapperElement}>
       <Editor
         {...props}
+        {...jsonSchemaProps}
         theme={theme ?? (dark ? 'snackDark' : 'snack')}
         className={cn({ [styles.editor]: hasBackground })}
         loading={loading ?? <Spinner />}
         options={mergedOptions}
         onMount={onEditorMount}
+        language={language}
       />
     </div>
   );

package/src/components/constants.ts

@@ -98,3 +98,11 @@ export const CODE_EDITOR_OPTIONS = {
     indentation: false,
   },
 };
+
+export const YAML_CODE_EDITOR_OPTIONS = {
+  quickSuggestions: {
+    strings: true,
+  },
+};
+
+export const DEFAULT_SCHEMA_URI = 'schema://editor-schema';

package/src/components/hooks.ts

@@ -1,8 +1,12 @@
-import { useEffect, useState } from 'react';
+import { EditorProps as MonacoEditorProps, useMonaco } from '@monaco-editor/react';
+import { configureMonacoYaml, SchemasSettings } from 'monaco-yaml';
+import { useCallback, useEffect, useMemo, useState } from 'react';
 
 import { useThemeContext } from '@snack-uikit/utils';
 
-import { THEME_VARS } from './constants';
+import { THEME_VARS, YAML_CODE_EDITOR_OPTIONS } from './constants';
+import { ConfigureJsonSchemaReturn, Dispose, HoverDescription, JsonSchema } from './types';
+import { getJsonSchema } from './utils';
 
 function getThemeVars(styles: CSSStyleDeclaration) {
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -42,3 +46,100 @@ export function useCalculatedThemeValues({ stylesOriginNode, themeName }: UseCal
 
   return values;
 }
+
+export function useApplyJsonSchema(language?: string, jsonSchema?: JsonSchema) {
+  const monaco = useMonaco();
+
+  const [jsonSchemaOptions, setJsonSchemaOptions] = useState<MonacoEditorProps['options']>({});
+  const modelPath = jsonSchema?.fileMatch;
+
+  const preparedJsonSchema: SchemasSettings | undefined = useMemo(() => getJsonSchema(jsonSchema), [jsonSchema]);
+
+  const configureYamlLanguage = useCallback((): ConfigureJsonSchemaReturn => {
+    if (!monaco || !preparedJsonSchema) {
+      return;
+    }
+
+    const model = configureMonacoYaml(monaco, {
+      enableSchemaRequest: true,
+      schemas: [preparedJsonSchema],
+    });
+
+    return {
+      options: YAML_CODE_EDITOR_OPTIONS,
+      dispose: model.dispose,
+    };
+  }, [monaco, preparedJsonSchema]);
+
+  const configureJsonLanguage = useCallback((): ConfigureJsonSchemaReturn => {
+    if (!monaco || !preparedJsonSchema) {
+      return;
+    }
+
+    monaco.languages.json.jsonDefaults.setDiagnosticsOptions({
+      validate: true,
+      schemas: [preparedJsonSchema],
+    });
+  }, [monaco, preparedJsonSchema]);
+
+  const configureJsonSchema = useCallback(() => {
+    switch (language) {
+      case 'yaml':
+        return configureYamlLanguage();
+      case 'json':
+        return configureJsonLanguage();
+      default:
+        break;
+    }
+  }, [language, configureYamlLanguage, configureJsonLanguage]);
+
+  useEffect(() => {
+    const jsonSchemaSettings = configureJsonSchema();
+    setJsonSchemaOptions(jsonSchemaSettings?.options ?? {});
+
+    return () => {
+      setJsonSchemaOptions({});
+      jsonSchemaSettings?.dispose?.();
+    };
+  }, [configureJsonSchema]);
+
+  return useMemo(
+    () => ({
+      jsonSchemaProps: { path: modelPath } satisfies MonacoEditorProps,
+      jsonSchemaOptions,
+    }),
+    [jsonSchemaOptions, modelPath],
+  );
+}
+
+export function useHoverProvider(language?: string, hoverDescription?: HoverDescription) {
+  const monaco = useMonaco();
+
+  const configureHoverProvider = useCallback((): Dispose | undefined => {
+    if (!monaco || !language || !hoverDescription) {
+      return;
+    }
+
+    return monaco.languages.registerHoverProvider(language, {
+      provideHover: (model, position) => {
+        const wordInfo = model.getWordAtPosition(position);
+        const hoveredDescription = hoverDescription[wordInfo?.word ?? ''];
+
+        if (wordInfo && hoveredDescription) {
+          const { startColumn, endColumn } = wordInfo;
+
+          return {
+            range: new monaco.Range(position.lineNumber, startColumn, position.lineNumber, endColumn),
+            contents: [{ value: hoveredDescription }],
+          };
+        }
+        return null;
+      },
+    });
+  }, [monaco, language, hoverDescription]);
+
+  useEffect(() => {
+    const { dispose } = configureHoverProvider() ?? {};
+    return dispose;
+  }, [configureHoverProvider]);
+}

package/src/components/index.ts

@@ -1 +1,2 @@
 export * from './CodeEditor';
+export * from './types';

package/src/components/types.ts

@@ -0,0 +1,42 @@
+import { EditorProps as MonacoEditorProps } from '@monaco-editor/react';
+import { JSONSchema } from 'monaco-yaml';
+
+export type HoverDescription = {
+  [word: string]: string;
+};
+
+export type EditorBaseProps = MonacoEditorProps & {
+  hoverDescription?: HoverDescription;
+};
+
+export type SupportedSchemaLanguage = 'json' | 'yaml';
+
+export type JsonSchema = {
+  uri?: string;
+  schema: JSONSchema;
+  fileMatch: string;
+};
+
+export type WithJsonSchema = {
+  /**
+   * Схема для валидации
+   */
+  jsonSchema: JsonSchema;
+  path?: never;
+};
+
+type WithoutJsonSchema = Pick<MonacoEditorProps, 'path'>;
+
+export type EditorWithJsonSchemaProps = Omit<EditorBaseProps, 'language' | 'path'> & {
+  language: SupportedSchemaLanguage;
+} & (WithJsonSchema | WithoutJsonSchema);
+
+export type Dispose = {
+  dispose?: () => void;
+};
+
+export type ConfigureJsonSchemaReturn =
+  | ({
+      options?: MonacoEditorProps['options'];
+    } & Dispose)
+  | undefined;

package/src/components/utils.ts

@@ -1,5 +1,9 @@
 import { loader } from '@monaco-editor/react';
 import chroma from 'chroma-js';
+import { SchemasSettings } from 'monaco-yaml';
+
+import { DEFAULT_SCHEMA_URI } from './constants';
+import { JsonSchema } from './types';
 
 export function rgb2hsl(HTMLcolor: string) {
   const [r, g, b] = chroma.valid(HTMLcolor)
@@ -60,3 +64,6 @@ export function initLoaderConfig() {
   // @ts-ignore
   window['__snack-code-editor-loader-config__'] && loader.config(window['__snack-code-editor-loader-config__']);
 }
+
+export const getJsonSchema = (jsonSchema?: JsonSchema): SchemasSettings | undefined =>
+  jsonSchema && { ...jsonSchema, uri: jsonSchema?.uri || DEFAULT_SCHEMA_URI, fileMatch: [jsonSchema.fileMatch] };

package/src/index.ts

@@ -2,5 +2,5 @@
   Monaco loader defines the way how monaco will be loaded.
   @see https://github.com/suren-atoyan/monaco-react/tree/master?tab=readme-ov-file#loader-config
  */
-export { loader } from '@monaco-editor/react';
+export { loader, useMonaco } from '@monaco-editor/react';
 export * from './components';