@gravity-ui/querieskit 1.0.1

package/build/esm/widgets/TutorialsHistory/TutorialsHistory.stories.js

@@ -0,0 +1,149 @@
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
+import "core-js/modules/es.array.concat.js";
+import "core-js/modules/es.array.filter.js";
+import "core-js/modules/es.array.includes.js";
+import "core-js/modules/es.object.to-string.js";
+import "core-js/modules/es.string.includes.js";
+import React, { useState } from 'react';
+import { TutorialsHistory } from "./TutorialsHistory";
+import { action } from 'storybook/actions';
+import { jsx as _jsx } from "react/jsx-runtime";
+var QUERY = "use test;\n\nSELECT\n    \"test_session\" AS session_id,\n    \"test_task\" AS task_id,\n    SUBSTRING(\"test\", 1, 1) AS truncated_char";
+var filterFields = [{
+  id: 'onlyMine',
+  type: 'switch',
+  title: 'My queries only',
+  initialValue: true
+}, {
+  id: 'range',
+  type: 'rangeDatePicker',
+  title: 'Period'
+}, {
+  id: 'dialect',
+  type: 'checkboxGroup',
+  title: 'Dialect',
+  initialValue: [],
+  items: [{
+    id: 'yql',
+    title: 'YQL'
+  }, {
+    id: 'sql',
+    title: 'SQL'
+  }]
+}];
+var logFilterApply = action('onFilterApply');
+var logFilterReset = action('onFilterReset');
+var BASE_ITEMS = [{
+  id: 1,
+  title: 'Getting started with YQL',
+  query: QUERY,
+  height: 28
+}, {
+  id: 2,
+  title: 'Working with tables',
+  query: QUERY,
+  height: 28
+}, {
+  id: 3,
+  title: 'Window functions',
+  query: QUERY,
+  height: 28
+}];
+var meta = {
+  title: 'Widgets/TutorialsHistory',
+  component: TutorialsHistory,
+  tags: ['autodocs'],
+  parameters: {
+    layout: 'padded'
+  }
+};
+export default meta;
+var DefaultStory = function DefaultStory() {
+  var _useState = useState([].concat(BASE_ITEMS)),
+    _useState2 = _slicedToArray(_useState, 2),
+    items = _useState2[0],
+    setItems = _useState2[1];
+  var _useState3 = useState({
+      value: '',
+      fullSearch: false
+    }),
+    _useState4 = _slicedToArray(_useState3, 2),
+    search = _useState4[0],
+    setSearch = _useState4[1];
+  var handleOnSearch = function handleOnSearch(data) {
+    setSearch(data);
+    if (!data.value) {
+      setItems(BASE_ITEMS);
+      return;
+    }
+    var newItems = BASE_ITEMS.filter(function (item) {
+      var _item$query;
+      if (!('id' in item)) return false;
+      var title = item.title.toLowerCase();
+      var query = (_item$query = item.query) === null || _item$query === void 0 ? void 0 : _item$query.toLowerCase();
+      var searchValue = data.value.toLowerCase();
+      if (data.fullSearch) {
+        return title.includes(searchValue) || (query === null || query === void 0 ? void 0 : query.includes(searchValue));
+      }
+      return title.includes(searchValue);
+    });
+    setItems(newItems);
+  };
+  return /*#__PURE__*/_jsx("div", {
+    style: {
+      width: 300,
+      height: 500
+    },
+    children: /*#__PURE__*/_jsx(TutorialsHistory, {
+      title: "Tutorials",
+      items: items,
+      filter: {
+        fields: filterFields,
+        onApply: logFilterApply,
+        onReset: logFilterReset('reset')
+      },
+      search: {
+        value: search.value,
+        fullSearch: search.fullSearch,
+        hasClear: true,
+        onUpdate: handleOnSearch
+      }
+    })
+  });
+};
+var EmptyStory = function EmptyStory() {
+  var _useState5 = useState({
+      value: '',
+      fullSearch: false
+    }),
+    _useState6 = _slicedToArray(_useState5, 2),
+    search = _useState6[0],
+    setSearch = _useState6[1];
+  return /*#__PURE__*/_jsx("div", {
+    style: {
+      width: 300,
+      height: 500
+    },
+    children: /*#__PURE__*/_jsx(TutorialsHistory, {
+      title: "Tutorials",
+      items: [],
+      search: {
+        value: search.value,
+        fullSearch: search.fullSearch,
+        hasClear: true,
+        onUpdate: setSearch
+      }
+    })
+  });
+};
+export var Default = {
+  render: function render() {
+    return /*#__PURE__*/_jsx(DefaultStory, {});
+  }
+};
+export var Empty = {
+  render: function render() {
+    return /*#__PURE__*/_jsx(EmptyStory, {});
+  }
+};
+// #sourceMappingURL=TutorialsHistory.stories.js.map

package/build/esm/widgets/TutorialsHistory/TutorialsHistory.stories.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","useState","TutorialsHistory","action","jsx","_jsx","QUERY","filterFields","id","type","title","initialValue","items","logFilterApply","logFilterReset","BASE_ITEMS","query","height","meta","component","tags","parameters","layout","DefaultStory","_useState","concat","_useState2","_slicedToArray","setItems","_useState3","value","fullSearch","_useState4","search","setSearch","handleOnSearch","data","newItems","filter","item","_item$query","toLowerCase","searchValue","includes","style","width","children","fields","onApply","onReset","hasClear","onUpdate","EmptyStory","_useState5","_useState6","Default","render","Empty"],"sources":["TutorialsHistory.stories.tsx"],"sourcesContent":["import React, {useState} from 'react';\nimport type {Meta, StoryObj} from '@storybook/react';\nimport {TutorialsHistory} from './TutorialsHistory';\nimport {QueryHistoryFilterConfig, QueryHistoryItem} from '../../types/history';\nimport {TutorialHistoryRow} from '../../types/tutorial';\nimport {action} from 'storybook/actions';\n\nconst QUERY = `use test;\n\nSELECT\n    \"test_session\" AS session_id,\n    \"test_task\" AS task_id,\n    SUBSTRING(\"test\", 1, 1) AS truncated_char`;\n\nconst filterFields: QueryHistoryFilterConfig['fields'] = [\n    {id: 'onlyMine', type: 'switch', title: 'My queries only', initialValue: true},\n    {id: 'range', type: 'rangeDatePicker', title: 'Period'},\n    {\n        id: 'dialect',\n        type: 'checkboxGroup',\n        title: 'Dialect',\n        initialValue: [],\n        items: [\n            {id: 'yql', title: 'YQL'},\n            {id: 'sql', title: 'SQL'},\n        ],\n    },\n];\n\nconst logFilterApply = action('onFilterApply');\nconst logFilterReset = action('onFilterReset');\n\nconst BASE_ITEMS: QueryHistoryItem<TutorialHistoryRow>[] = [\n    {\n        id: 1,\n        title: 'Getting started with YQL',\n        query: QUERY,\n        height: 28,\n    },\n    {\n        id: 2,\n        title: 'Working with tables',\n        query: QUERY,\n        height: 28,\n    },\n    {\n        id: 3,\n        title: 'Window functions',\n        query: QUERY,\n        height: 28,\n    },\n];\n\nconst meta: Meta<typeof TutorialsHistory> = {\n    title: 'Widgets/TutorialsHistory',\n    component: TutorialsHistory,\n    tags: ['autodocs'],\n    parameters: {\n        layout: 'padded',\n    },\n};\n\nexport default meta;\ntype Story = StoryObj<typeof TutorialsHistory>;\n\nconst DefaultStory = () => {\n    const [items, setItems] = useState([...BASE_ITEMS]);\n    const [search, setSearch] = useState({value: '', fullSearch: false});\n\n    const handleOnSearch = (data: {value: string; fullSearch: boolean}) => {\n        setSearch(data);\n\n        if (!data.value) {\n            setItems(BASE_ITEMS);\n            return;\n        }\n\n        const newItems = BASE_ITEMS.filter((item) => {\n            if (!('id' in item)) return false;\n\n            const title = item.title.toLowerCase();\n            const query = item.query?.toLowerCase();\n            const searchValue = data.value.toLowerCase();\n\n            if (data.fullSearch) {\n                return title.includes(searchValue) || query?.includes(searchValue);\n            }\n\n            return title.includes(searchValue);\n        });\n        setItems(newItems);\n    };\n\n    return (\n        <div style={{width: 300, height: 500}}>\n            <TutorialsHistory\n                title=\"Tutorials\"\n                items={items}\n                filter={{\n                    fields: filterFields,\n                    onApply: logFilterApply,\n                    onReset: logFilterReset('reset'),\n                }}\n                search={{\n                    value: search.value,\n                    fullSearch: search.fullSearch,\n                    hasClear: true,\n                    onUpdate: handleOnSearch,\n                }}\n            />\n        </div>\n    );\n};\n\nconst EmptyStory = () => {\n    const [search, setSearch] = useState({value: '', fullSearch: false});\n\n    return (\n        <div style={{width: 300, height: 500}}>\n            <TutorialsHistory\n                title=\"Tutorials\"\n                items={[]}\n                search={{\n                    value: search.value,\n                    fullSearch: search.fullSearch,\n                    hasClear: true,\n                    onUpdate: setSearch,\n                }}\n            />\n        </div>\n    );\n};\n\nexport const Default: Story = {render: () => <DefaultStory />};\nexport const Empty: Story = {render: () => <EmptyStory />};\n"],"mappings":"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","ignoreList":[]}

package/build/esm/widgets/TutorialsHistory/i18n/dicts.d.ts

@@ -0,0 +1,9 @@
+declare const _default: {
+    en: {
+        title_tutorials: string;
+    };
+    ru: {
+        title_tutorials: string;
+    };
+};
+export default _default;

package/build/esm/widgets/TutorialsHistory/i18n/dicts.js

@@ -0,0 +1,7 @@
+import en from "./en.json";
+import ru from "./ru.json";
+export default {
+  en: en,
+  ru: ru
+};
+// #sourceMappingURL=dicts.js.map

package/build/esm/widgets/TutorialsHistory/i18n/dicts.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["en","ru"],"sources":["dicts.ts"],"sourcesContent":["import en from './en.json';\nimport ru from './ru.json';\n\nexport default {en, ru};\n"],"mappings":"AAAA,OAAOA,EAAE;AACT,OAAOC,EAAE;AAET,eAAe;EAACD,EAAE,EAAFA,EAAE;EAAEC,EAAE,EAAFA;AAAE,CAAC","ignoreList":[]}

package/build/esm/widgets/TutorialsHistory/i18n/en.json

@@ -0,0 +1,3 @@
+{
+    "title_tutorials": "Tutorials"
+}

package/build/esm/widgets/TutorialsHistory/i18n/index.d.ts

@@ -0,0 +1,6 @@
+declare const _default: ((key: "title_tutorials", params?: import("@gravity-ui/i18n").Params) => string) & {
+    keysetData: {
+        "qp:tutorials": Record<"title_tutorials", import("@gravity-ui/i18n").KeyData>;
+    };
+};
+export default _default;

package/build/esm/widgets/TutorialsHistory/i18n/index.js

@@ -0,0 +1,4 @@
+import { addI18Keysets } from "../../../i18n";
+import dicts from "./dicts";
+export default addI18Keysets('qp:tutorials', dicts);
+// #sourceMappingURL=index.js.map

package/build/esm/widgets/TutorialsHistory/i18n/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["addI18Keysets","dicts"],"sources":["index.ts"],"sourcesContent":["import {addI18Keysets} from '../../../i18n';\n\nimport dicts from './dicts';\n\nexport default addI18Keysets('qp:tutorials', dicts);\n"],"mappings":"AAAA,SAAQA,aAAa;AAErB,OAAOC,KAAK;AAEZ,eAAeD,aAAa,CAAC,cAAc,EAAEC,KAAK,CAAC","ignoreList":[]}

package/build/esm/widgets/TutorialsHistory/i18n/ru.json

@@ -0,0 +1,3 @@
+{
+    "title_tutorials": "Туториалы"
+}

package/build/esm/widgets/TutorialsHistory/index.d.ts

@@ -0,0 +1,2 @@
+export { TutorialsHistory } from './TutorialsHistory';
+export type { TutorialsHistoryProps } from './TutorialsHistory';

package/build/esm/widgets/TutorialsHistory/index.js

@@ -0,0 +1,2 @@
+export { TutorialsHistory } from "./TutorialsHistory";
+// #sourceMappingURL=index.js.map

package/build/esm/widgets/TutorialsHistory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["TutorialsHistory"],"sources":["index.ts"],"sourcesContent":["export {TutorialsHistory} from './TutorialsHistory';\nexport type {TutorialsHistoryProps} from './TutorialsHistory';\n"],"mappings":"AAAA,SAAQA,gBAAgB","ignoreList":[]}

package/build/esm/widgets/index.d.ts

@@ -0,0 +1,4 @@
+export { QueriesHistory } from './QueriesHistory';
+export type { QueriesHistoryProps } from './QueriesHistory';
+export { TutorialsHistory } from './TutorialsHistory';
+export type { TutorialsHistoryProps } from './TutorialsHistory';

package/build/esm/widgets/index.js

@@ -0,0 +1,3 @@
+export { QueriesHistory } from "./QueriesHistory";
+export { TutorialsHistory } from "./TutorialsHistory";
+// #sourceMappingURL=index.js.map

package/build/esm/widgets/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["QueriesHistory","TutorialsHistory"],"sources":["index.ts"],"sourcesContent":["export {QueriesHistory} from './QueriesHistory';\nexport type {QueriesHistoryProps} from './QueriesHistory';\nexport {TutorialsHistory} from './TutorialsHistory';\nexport type {TutorialsHistoryProps} from './TutorialsHistory';\n"],"mappings":"AAAA,SAAQA,cAAc;AAEtB,SAAQC,gBAAgB","ignoreList":[]}

package/commitlint.config.cjs

@@ -0,0 +1,6 @@
+module.exports = {
+    extends: ['@commitlint/config-conventional'],
+    rules: {
+        'subject-case': [0],
+    },
+};

package/eslint.config.mjs

@@ -0,0 +1,53 @@
+// eslint.config.mjs
+import baseConfig from "@gravity-ui/eslint-config";
+import prettierConfig from "@gravity-ui/eslint-config/prettier";
+import reactConfig from "@gravity-ui/eslint-config/react";
+import typescriptEslint from "@typescript-eslint/eslint-plugin";
+
+export default [
+    {
+        ignores: [
+            "build/**",
+            "storybook-static/**",
+            "node_modules/**",
+            "dist/**",
+            "*.config.mjs",
+        ],
+    },
+    ...baseConfig,
+    ...prettierConfig,
+    ...reactConfig,
+    {
+        settings: {
+            "import/resolver": {
+                typescript: true,
+                node: true
+            }
+        },
+        plugins: {
+            "@typescript-eslint": typescriptEslint,
+        },
+        rules: {
+            curly: "off",
+            "@typescript-eslint/explicit-member-accessibility": [
+                "error",
+                {
+                    accessibility: "explicit",
+                    overrides: {
+                        accessors: "explicit",
+                        constructors: "no-public",
+                        methods: "explicit",
+                        properties: "off",
+                        parameterProperties: "explicit",
+                    },
+                },
+            ],
+        },
+    },
+    {
+        files: ["src/stories/**/*.{ts,tsx}"],
+        rules: {
+            "import/no-extraneous-dependencies": "off",
+        },
+    },
+];

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@gravity-ui/querieskit",
+  "version": "1.0.1",
+  "description": "Query page component library",
+  "main": "build/index.js",
+  "scripts": {
+    "build": "app-builder build",
+    "lint": "eslint",
+    "lint:all": "eslint \"./src/**/*.{js,jsx,ts,tsx}\"",
+    "storybook": "storybook dev -p 6006 --no-open",
+    "build-storybook": "sb build",
+    "test": "echo \"No tests\" && exit 0",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gravity-ui/querieskit"
+  },
+  "keywords": [
+    "queries"
+  ],
+  "license": "MIT",
+  "homepage": "https://gravity-ui.com/ru/libraries/querieskit",
+  "devDependencies": {
+    "@commitlint/config-conventional": "^20.5.3",
+    "@gravity-ui/app-builder": "^0.49.0",
+    "@gravity-ui/date-utils": "^2.7.1",
+    "@gravity-ui/eslint-config": "^4.3.2",
+    "@gravity-ui/icons": "^2.20.0",
+    "@gravity-ui/prettier-config": "^1.1.1",
+    "@gravity-ui/tsconfig": "^1.0.0",
+    "@gravity-ui/uikit": "^7.45.1",
+    "@storybook/react": "^10.5.0",
+    "@storybook/react-vite": "^10.5.0",
+    "@types/react": "^19.2.17",
+    "@types/react-dom": "^19.2.3",
+    "@typescript-eslint/eslint-plugin": "^8.64.0",
+    "@typescript-eslint/parser": "^8.64.0",
+    "eslint": "^9.39.5",
+    "eslint-import-resolver-typescript": "^4.4.5",
+    "prettier": "^3.9.5",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
+    "storybook": "^10.5.0",
+    "typescript": "^6.0.3",
+    "vite": "^8.1.5",
+    "vite-plugin-svgr": "^5.2.0"
+  },
+  "peerDependencies": {
+    "@gravity-ui/icons": ">=2.0.0",
+    "@gravity-ui/uikit": ">=7.0.0",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "dependencies": {
+    "@gravity-ui/date-components": "^3.4.2",
+    "@gravity-ui/i18n": "^1.8.0",
+    "@gravity-ui/illustrations": "^2.1.1",
+    "@gravity-ui/react-data-table": "^2.2.1",
+    "@gravity-ui/unipika": "^5.6.3",
+    "bem-cn-lite": "^4.1.0",
+    "monaco-editor": "^0.56.0"
+  }
+}

package/plans/i18n-rules.md

@@ -0,0 +1,116 @@
+# Правила работы с i18n
+
+Подробные правила именования кейсетов и ключей для агентов, работающих с локализацией в `@gravity-ui/querieskit`. Краткая выжимка — в разделе [`## i18n`](../AGENTS.md) файла `AGENTS.md`, здесь — полный справочник с примерами.
+
+## Техническая структура
+
+Каждый виджет хранит свою локализацию в подпапке `i18n/`:
+
+```text
+widgets/
+  WidgetName/
+    i18n/
+      en.json
+      ru.json
+      dicts.ts
+      index.ts
+```
+
+- [`dicts.ts`](../src/widgets/QueriesHistory/i18n/dicts.ts:1) — собирает словари по языкам: `export default {en, ru}`.
+- [`index.ts`](../src/widgets/QueriesHistory/i18n/index.ts:1) — регистрирует кейсет через [`addI18Keysets`](../src/i18n/index.ts:11) и экспортирует типизированную функцию `t`:
+
+  ```ts
+  import {addI18Keysets} from '../../../i18n';
+
+  import dicts from './dicts';
+
+  export default addI18Keysets('qp:widget-name', dicts);
+  ```
+
+- Имя кейсета всегда начинается с префикса `qp:` (namespace библиотеки) — тип `addI18Keysets` требует `` `qp:${string}` ``.
+- В компоненте используется как `i18n('key_name')`, см. [`QueriesHistory.tsx`](../src/widgets/QueriesHistory/QueriesHistory.tsx:41).
+- `modules` и `components`, у которых есть собственный переиспользуемый сценарий, также могут заводить свою папку `i18n/` по этой же схеме — правило применяется на всех трёх уровнях (`components` / `modules` / `widgets`).
+
+## Кейсеты
+
+Кейсеты делятся на 4 типа:
+
+1. **Общие для всей системы** — используются во многих разделах, часто повторяются. Например: `common`, `common.units`, `common.actions`.
+2. **Общие для раздела** — часто повторяются на страницах одного раздела. Например: `queries.common`.
+3. **Специфичные для страниц раздела**. Например: `queries.editor`.
+4. **Для переиспользуемых компонентов**. Например: `queries.status-icon`.
+
+В контексте `qp:` namespace эквивалент раздела — виджет/модуль/компонент, например `qp:queries-history`, `qp:queries-history.history-list`.
+
+### Рекомендации по кейсетам
+
+- Для каждого кейсета обязательно указывать его контекст (для чего он и где используется — в комментарии рядом с регистрацией или в PR/документации).
+- Не злоупотреблять гранулярностью: не создавать кейсет на несколько ключей без необходимости — объединять с существующим кейсетом раздела/виджета.
+- Для секций или попапов одного раздела не заводить несколько кейсетов — использовать общий кейсет раздела.
+- Называть кейсеты как можно короче: не `queries.history.filters`, а `queries.filters`.
+- Для переиспользуемых компонентов не начинать нейминг со слова `component.` — начинать с раздела/сущности, к которой относится компонент: не `component.queries.status-icon`, а `queries.status-icon`.
+
+## Ключи
+
+Формат: `<контекст-элемента>_<содержание-текста>`.
+
+- Контекст стараться брать из готового списка ниже; если не подходит — придумать свой короткий и понятный; если контекст определить не получается — не писать его вовсе.
+- Не использовать контекст `label_`.
+- Содержание текста в имени должно однозначно и лаконично отражать смысл (для длинных фраз — краткое описание сути, а не дословный текст).
+
+### Примеры
+
+| Текст | Ключ |
+|---|---|
+| Нотификация, заголовок: «Не удалось выполнить запрос» | `alert_query-execution-error` |
+| Нотификация, сообщение: «Запрос выполняется дольше обычного, результат появится позже» | `alert_query-long-running` |
+| «История запросов будет очищена через 30 дней после создания» | `alert_history-retention-notice` |
+| Описание секции про сохранение и повторный запуск сценариев запросов | `context_reuse-saved-queries` |
+| Активное действие «Повторить запрос» | `action_query-rerun` |
+
+### Рекомендуемые контексты
+
+- `context` — контекстная информация: подсказки, абзацы с пояснением назначения раздела/элемента.
+- `alert` — обратная связь системы: нотификации по завершению запроса к серверу, предупреждения в обзоре ресурса (например, скорая блокировка аккаунта).
+- `action` — действия пользователя: кнопки, ссылки, пункты действий в таблице, действия в правом верхнем углу обзора ресурсов.
+- `field` — названия полей ресурса: колонки таблиц, формы редактирования, обзор.
+- `title` — заголовок секции, страницы, попапа, компонента подтверждения (confirm), пункт меню.
+- `confirm` — призыв к действию, например описание подтверждения операции.
+- `value` — значения radio/switch, статус или другое переводимое значение поля.
+
+## Технические префиксы
+
+- **`raw_`** — если нужно избежать прогона текста через типограф.
+- **`md_`** — если нужно выделить текст жирным/курсивом или добавить ссылку. Текст прогоняется через YFM и превращается в HTML-теги; на стороне компонента нужно подключать через `Yfm`-компонент. Атрибуты ссылки задаются так:
+
+  ```json
+  {
+      "md_query-syntax-help": "Подробнее о синтаксисе смотрите в [документации](https://example.com/docs/query-syntax){target=_blank rel=\"noreferrer noopener\"}"
+  }
+  ```
+
+- **Не использовать HTML-разметку в тексте напрямую** — для форматирования есть только `md_` + YFM.
+
+## Допустимые символы
+
+Каждый текст проверяется на отсутствие неразрешённых символов:
+
+```ts
+/**
+ * [\u0400-\u04ff] – Кириллица
+ * \u00a0 – Неразрывный пробел
+ */
+export const SAFE_SYMBOLS_REGEX = /^[a-z0-9\u0400-\u04ff[\](){}<>!@#$%^&*~_\-−–—+='"`«»„”‘’“?.,:;|\\/ ₽™®©№\u00a0]*$/i;
+```
+
+Перед добавлением новых строк в `en.json`/`ru.json` проверять их на соответствие этому регулярному выражению.
+
+## Чек-лист при добавлении новых текстов
+
+1. Определить, в какой кейсет должен попасть ключ (существующий кейсет виджета/модуля/компонента или общий — не плодить новые без необходимости).
+2. Подобрать короткий контекст ключа из списка (`context`, `alert`, `action`, `field`, `title`, `confirm`, `value`) либо не указывать его, если не подходит.
+3. Сформулировать лаконичное однозначное содержание в имени ключа (kebab-case после `_`).
+4. Добавить перевод в `en.json` и `ru.json` одновременно.
+5. Проверить текст на допустимые символы (`SAFE_SYMBOLS_REGEX`).
+6. Если нужна разметка (ссылка/жирный/курсив) — использовать `md_`-префикс и YFM, не HTML.
+7. Если нужно отключить типограф — использовать `raw_`-префикс.