@zeroman.yang/react-auto-components 0.1.2 → 0.1.3

package/docs/i18n/pt-BR/auto-dialog.md

@@ -0,0 +1,23 @@
+# AutoDialog
+
+[English](../../auto-dialog.md) | [简体中文](../zh-CN/auto-dialog.md) | [繁體中文](../zh-TW/auto-dialog.md) | [日本語](../ja/auto-dialog.md) | [한국어](../ko/auto-dialog.md) | [Español](../es/auto-dialog.md) | [Français](../fr/auto-dialog.md) | [Deutsch](../de/auto-dialog.md) | **Português (Brasil)** | [Русский](../ru/auto-dialog.md)
+
+Diálogo modal, declarativo (`<AutoDialog open>`) ou imperativo (`useAutoDialog().open()`). `fields` desenha um [AutoForm](auto-form.md).
+
+`useAutoDialog()` fora do provedor lança `RAC-DIALOG-PROVIDER`. `<AutoDialog open>` não precisa do provedor.
+
+## Comportamento e props
+
+| Prop | Comportamento |
+| --- | --- |
+| `onSubmit(values)` | Depois da validação. **Rejeitar ou lançar: o diálogo continua aberto, mostra `error.message` e os valores ficam.** Depois do resolve, `beforeClose` ainda corre. |
+| `beforeClose(reason)` | `"submit"`, `"cancel"` ou `"close"`. **`false` deixa aberto. Lançar também deixa aberto e mostra a mensagem.** |
+| `onClose` | Só depois de fechar de verdade. |
+| `draftKey` | Guarda o rascunho em `${namespace}:draft:${draftKey}` até um envio bem-sucedido. Omitido, nada é gravado. |
+| `width` | Padrão `560`. `draggable` é ignorado em tela cheia. |
+
+`close()` de `open()` resolve `false` se `beforeClose` bloquear. Diálogos imperativos empilham.
+
+## Pré-condições
+
+Importe `style.css` uma vez. `AutoConfigProvider` é opcional e não substitui `AutoDialogProvider`. `namespace` entra na chave do rascunho.

package/docs/i18n/pt-BR/auto-form.md

@@ -0,0 +1,35 @@
+# AutoForm
+
+[English](../../auto-form.md) | [简体中文](../zh-CN/auto-form.md) | [繁體中文](../zh-TW/auto-form.md) | [日本語](../ja/auto-form.md) | [한국어](../ko/auto-form.md) | [Español](../es/auto-form.md) | [Français](../fr/auto-form.md) | [Deutsch](../de/auto-form.md) | **Português (Brasil)** | [Русский](../ru/auto-form.md)
+
+Formulário por esquema. `AutoSearch` e `AutoDialog` desenham um `AutoForm`, então estas regras de callback valem para eles.
+
+`Field<T>` é uma união discriminada por `type`. `select` sem `options`, um escalar em `daterange` e `match: "between"` num escalar são erros de TypeScript. `AnyField` e `unsafeField()` são a saída; o modo de desenvolvimento ainda avisa. Códigos em [errors.md](errors.md).
+
+## Comportamento e props
+
+| Prop | Comportamento |
+| --- | --- |
+| `fields` | `readonly Field<T>[]`. Sem `type` é um texto. `name` duplicado lança `RAC-FIELD-DUPLICATE` na montagem. |
+| `value` | Valor controlado. Se diferir do estado interno, o formulário copia e limpa erros. Se o pai ignorar `onChange`, o input volta. |
+| `onSubmit(value)` | Só depois da validação. **Rejeitar ou lançar: os valores ficam, `error.message` aparece e não há reset.** |
+| `columns` | Padrão `2`. `actions` padrão `true`. |
+| Rótulos | `labelPosition` padrão `"top"`. `labelWidth` padrão `"auto"` (medido, teto de 45% do campo). |
+
+## Se um callback lançar
+
+| Callback | Resultado |
+| --- | --- |
+| `onSubmit` | Capturado. O rascunho fica. A mensagem aparece. Sem reset. |
+| `rules` do campo | A mensagem lançada vira o erro daquele campo. As regras seguintes não rodam. |
+| `onChange` do campo | Não capturado. O valor anterior fica. |
+| `upload` | A rejeição aparece sob o input e nada é gravado. `reset()` aborta o sinal e descarta um resultado tardio. |
+| Envio com upload em andamento | `validate()` devolve `false` e não chama `onSubmit`. |
+| `hidden`, `disabled` ou sem acesso | Esse campo não é validado, mesmo se `required`. |
+| `required` vazio | `undefined`, `null`, `""` ou um array vazio bloqueiam o envio. |
+
+`handle.validate()` resolve `true` ou `false`. Não lança.
+
+## Pré-condições
+
+Importe `style.css` uma vez. Em desenvolvimento, a falta de `--auto-text` avisa `RAC-CSS-MISSING`. `AutoConfigProvider` é opcional e não monta diálogos.

package/docs/i18n/pt-BR/auto-menu.md

@@ -0,0 +1,23 @@
+# AutoMenu
+
+[English](../../auto-menu.md) | [简体中文](../zh-CN/auto-menu.md) | [繁體中文](../zh-TW/auto-menu.md) | [日本語](../ja/auto-menu.md) | [한국어](../ko/auto-menu.md) | [Español](../es/auto-menu.md) | [Français](../fr/auto-menu.md) | [Deutsch](../de/auto-menu.md) | **Português (Brasil)** | [Русский](../ru/auto-menu.md)
+
+Barra lateral. Para painéis, [AutoTabs](auto-tabs.md).
+
+## Comportamento e props
+
+| Prop | Comportamento |
+| --- | --- |
+| `items` | `id` único na árvore. `hidden` e um `canAccess` que falha descartam o item. Um `children` que aponta para um ancestral é descartado por inteiro para um esquema ruim não recursar. |
+| `value` | Id da folha selecionada. Omitido, a seleção fica interna. |
+| `onChange(id, item, path)` | **Não é capturado.** `path` é a cadeia de ids da raiz até a folha. Um pai com filhos só alterna a expansão e não é selecionado. |
+| `collapsible` | Padrão `false`. Se `collapsed` for controlado, atualize-o em `onCollapsedChange` ou o trilho não se move. **`onCollapsedChange` não é capturado.** |
+| `disabled` | Desabilita o item e os descendentes. A seleção os pula. |
+
+Escolher uma folha não navega sozinho. O único sinal é `onChange`.
+
+## Pré-condições
+
+Importe `style.css` uma vez. `AutoConfigProvider` é opcional. Permissões usam `config.canAccess`.
+
+Importe uma vez na entrada do aplicativo `import "@zeroman.yang/react-auto-components/style.css"`. Sem a folha de estilos, o modo de desenvolvimento avisa com `RAC-CSS-MISSING`.

package/docs/i18n/pt-BR/auto-search.md

@@ -0,0 +1,32 @@
+# AutoSearch
+
+[English](../../auto-search.md) | [简体中文](../zh-CN/auto-search.md) | [繁體中文](../zh-TW/auto-search.md) | [日本語](../ja/auto-search.md) | [한국어](../ko/auto-search.md) | [Español](../es/auto-search.md) | [Français](../fr/auto-search.md) | [Deutsch](../de/auto-search.md) | **Português (Brasil)** | [Русский](../ru/auto-search.md)
+
+Formulário de busca. Desenha um `AutoForm` e emite um `QueryNode` e os valores. Se um callback de campo lançar, valem as regras de [AutoForm](auto-form.md).
+
+`AutoSearchPanel` e `AutoSearchPanelProps` são aliases obsoletos de `AutoSearch` e `AutoSearchProps`.
+
+## Comportamento e props
+
+| Prop | Comportamento |
+| --- | --- |
+| `onSearch(query, values)` | Obrigatório. **Lançar ou rejeitar: o formulário interno captura, os valores ficam e `error.message` aparece. Sem reset.** |
+| `mode` | Padrão `"manual"` (botão). `"instant"` busca também a cada mudança. |
+| `columns` | Padrão `3`. |
+| `more: true` | Esconde o campo até abrir "Mais". Campos ocultos não entram na consulta. |
+
+| `match` | Valor |
+| --- | --- |
+| omitido | `"eq"`, ou `"in"` se o valor for um array. |
+| `"contains"` | Substring. `ignoreCase: true` ignora maiúsculas. |
+| `"between"` | `[from, to]`. Um escalar avisa `RAC-FIELD-BETWEEN` e não casa com linhas. |
+| `"isNull"` | Casa com null ou undefined. O valor digitado é ignorado. |
+| vazio | `undefined`, `null`, `""` e arrays vazios são omitidos, salvo `"isNull"`. |
+
+O reset restaura `defaultValue` e então busca. `serializeRsql` lança `RAC-QUERY-FIELD` se o nome não cumprir `/^[\w.]+$/`.
+
+## Pré-condições
+
+Importe `style.css` uma vez. `AutoConfigProvider` é opcional.
+
+Importe uma vez na entrada do aplicativo `import "@zeroman.yang/react-auto-components/style.css"`. Sem a folha de estilos, o modo de desenvolvimento avisa com `RAC-CSS-MISSING`.

package/docs/i18n/pt-BR/auto-table.md

@@ -0,0 +1,31 @@
+# AutoTable
+
+[English](../../auto-table.md) | [简体中文](../zh-CN/auto-table.md) | [繁體中文](../zh-TW/auto-table.md) | [日本語](../ja/auto-table.md) | [한국어](../ko/auto-table.md) | [Español](../es/auto-table.md) | [Français](../fr/auto-table.md) | [Deutsch](../de/auto-table.md) | **Português (Brasil)** | [Русский](../ru/auto-table.md)
+
+Tabela local ou remota. Passe exatamente um de `data`, `dataSource` ou `source`; combinar vários é um erro de tipo. A busca segue [AutoSearch](auto-search.md). Inclusão e edição seguem [AutoDialog](auto-dialog.md) e [AutoForm](auto-form.md).
+
+`exportXlsx` vem de `@zeroman.yang/react-auto-components/xlsx`. `exceljs` é opcional (`RAC-XLSX-DEP` se faltar).
+
+## Comportamento e props
+
+| Prop | Comportamento |
+| --- | --- |
+| `id` | Obrigatório. A chave é `${namespace}:table:${id}`. Vazio avisa `RAC-TABLE-ID`. |
+| `rowKey` | Único nas linhas carregadas. Ausente ou duplicado: `RAC-TABLE-ROWID`. Seleção, expansão e `scrollToRow` usam isso. |
+| `dataSource` | **Rejeitar: mostra a mensagem e um botão de tentar de novo. O abort é ignorado.** `total` é a contagem filtrada inteira, não o tamanho da página. |
+| `pageSize` | Padrão `10`. `pagination` padrão `true`. `height` padrão `440`. `"auto"` preenche um pai que já tem altura. |
+| `onAdd`, `onEdit`, `onDelete` | **Rejeitar ou lançar: o diálogo continua aberto e mostra `error.message`.** As linhas só mudam se o seu handler já as tiver mudado. |
+| `rowActions` | A rejeição de `onClick` é capturada e exibida na linha de status por cerca de 2,5 segundos. A linha permanece. Se uma ação de linha não tiver `onClick` e seu `action` não for uma chave conhecida de `config.rowActions`, ao selecioná-la a linha de status mostra `RAC-ROW-ACTION`. Forneça `onClick` ou registre a chave de `action`. Se ambos existirem, `onClick` tem prioridade. |
+| `component` | Se o `component` de uma coluna não estiver registrado em `config.columns` do `AutoConfigProvider`, o modo de desenvolvimento avisa com `RAC-COLUMN-COMPONENT` e a célula mantém o formato padrão. Registre a chave ou defina `render`, `format` ou `sort` na coluna. As funções da coluna têm prioridade. |
+| `source` | `source` é uma chave de `config.sources` no `AutoConfigProvider`. Uma chave desconhecida mostra `RAC-TABLE-SOURCE` com um botão para tentar novamente. Registre a chave ou use `data` / `dataSource`. Forneça exatamente uma das três opções. |
+| `exportXlsx` | Só é necessário para xlsx. Se faltar, `RAC-TABLE-XLSX`. CSV e JSON são internos. |
+
+`handle.export` resolve mesmo se o status mostrar um erro; não relança. `"filtered"` remoto percorre todas as páginas. Uma página vazia antes da última lança `RAC-TABLE-EXPORT-PAGE` e não baixa um arquivo parcial.
+
+JSON de filtro inválido mostra o texto traduzido, avisa `RAC-TABLE-FILTER` e mantém o filtro anterior. `between` tem comprimento 2. `in` é um array.
+
+`handle.reset()` limpa ordenação, filtro e seleção e devolve o layout às colunas. `scrollToRow` não faz nada se o id não estiver carregado.
+
+## Pré-condições
+
+Importe `style.css` uma vez. Separe `namespace` se vários apps na mesma origem persistem tabelas; o padrão é `"auto"`. Os diálogos internos de inclusão e edição não precisam de `AutoDialogProvider`. Só `useAutoDialog()` precisa.

package/docs/i18n/pt-BR/auto-tabs.md

@@ -0,0 +1,25 @@
+# AutoTabs
+
+[English](../../auto-tabs.md) | [简体中文](../zh-CN/auto-tabs.md) | [繁體中文](../zh-TW/auto-tabs.md) | [日本語](../ja/auto-tabs.md) | [한국어](../ko/auto-tabs.md) | [Español](../es/auto-tabs.md) | [Français](../fr/auto-tabs.md) | [Deutsch](../de/auto-tabs.md) | **Português (Brasil)** | [Русский](../ru/auto-tabs.md)
+
+Abas. As aninhadas são outro `AutoTabs` alimentado por `children`. Para uma barra lateral, [AutoMenu](auto-menu.md).
+
+## Comportamento e props
+
+| Prop | Comportamento |
+| --- | --- |
+| `items` | Cada aba precisa de um `id` estável. `hidden` e um `canAccess` que falha removem a aba. |
+| `value` | Caminho controlado de ids a partir da raiz. O aninhado é `["parent", "child"]`. |
+| `onChange(path, item)` | **Não é capturado.** Se lançar, o React reporta o erro. No modo controlado, o caminho ainda não confirmado fica no anterior. |
+| `mode` | Padrão `"horizontal"`. `"vertical"` empilha a lista. |
+| `keepMounted` | Padrão `true`: painéis inativos continuam montados. `false` desmonta. |
+| `onRefresh` | Se existir, há um botão de atualizar. **Não é capturado.** |
+| `disabled` | Continua visível e não pode ser escolhida. A seleção padrão pula abas desabilitadas. |
+
+## Pré-condições
+
+Importe `style.css` uma vez (`RAC-CSS-MISSING` em desenvolvimento). `AutoConfigProvider` é opcional.
+
+## Abas dinâmicas
+
+`useAutoTabsWorkspace` abre e fecha páginas sem um router. Passe `tabsProps` para `AutoTabs`. Chamar `open` de novo com o mesmo id só seleciona essa aba e mantém o rascunho. Uma aba fixada não fecha. Espere `ready` antes de `open`. A seleção, `params` e `state` voltam do `sessionStorage` após a montagem. Se `beforeClose` retornar `false` ou lançar, o fechamento é cancelado. O exemplo está em [DynamicTabsDemo.tsx](../../../test-project/src/examples/DynamicTabsDemo.tsx).

package/docs/i18n/pt-BR/errors.md

@@ -0,0 +1,110 @@
+# Códigos de erro
+
+[English](../../errors.md) | [简体中文](../zh-CN/errors.md) | [繁體中文](../zh-TW/errors.md) | [日本語](../ja/errors.md) | [한국어](../ko/errors.md) | [Español](../es/errors.md) | [Français](../fr/errors.md) | [Deutsch](../de/errors.md) | **Português (Brasil)** | [Русский](../ru/errors.md)
+
+Falhas de desenvolvimento lançam `RacError` ou chamam `console.warn` em desenvolvimento. O texto é sempre inglês.
+
+```text
+[Component] what is wrong.
+Fix: what to change.
+Code: RAC-…
+Docs: https://github.com/Zeroman/react-auto-components/blob/main/docs/errors.md#rac-…
+```
+
+O texto da interface continua em `config.t`. `userKey` é a frase-fonte em inglês que o hospedeiro traduz. O console e a exceção ficam em inglês.
+
+## RAC-FIELD-OPTIONS
+
+`type` é `select`, `select-v2`, `radio`, `checkbox` ou `cascader`, e `options` falta ou está vazio.
+
+Correção: Passe `options` como array ou `(values) => Option[]`. `autocomplete` pode omitir.
+
+## RAC-FIELD-RANGE
+
+`daterange` ou `datetimerange` não tem um valor de dois itens.
+
+Correção: Tipifique o campo como `[start, end]`. `dateValue` padrão é `"string"`. `"timestamp"` guarda milissegundos locais. `null` deixa a ponta aberta. Um escalar é erro de TypeScript. Um array no modelo compila; em desenvolvimento há aviso se o comprimento real não for 2.
+
+## RAC-FIELD-BETWEEN
+
+`match: "between"` não é `[from, to]`.
+
+Correção: Guarde um par. Um escalar não casa com nenhuma linha. Em `Field<T>` também é erro de tipo.
+
+## RAC-FIELD-CUSTOM
+
+`type: "custom"` não tem `render` nem `component`.
+
+Correção: Passe `render(context)` ou uma chave `component` de `config.fields`.
+
+## RAC-FIELD-DUPLICATE
+
+Dois campos compartilham `name`. `defaults` lança na montagem.
+
+Correção: Nomes únicos. `title`, `tip`, `append` e `button` não têm nome.
+
+## RAC-CSS-MISSING
+
+Em desenvolvimento `--auto-text` não está em `:root`. Sem a folha de estilo a página quebra e o DOM não explica.
+
+Correção: Uma vez: `import "@zeroman.yang/react-auto-components/style.css"`.
+
+## RAC-TABLE-XLSX
+
+`export("xlsx")` sem `exportXlsx`.
+
+Correção: Importe `{ exportXlsx }` de `@zeroman.yang/react-auto-components/xlsx`. A UI mostra a frase traduzida.
+
+## RAC-XLSX-DEP
+
+`exceljs` não carregou. É uma `optionalDependency`.
+
+Correção: `pnpm add exceljs`. CSV e JSON não precisam.
+
+## RAC-TABLE-EXPORT-PAGE
+
+Uma página remota veio vazia antes da última. Nenhum arquivo parcial é salvo.
+
+Correção: Devolva um `total` estável e as linhas daquele `pageIndex`.
+
+## RAC-TABLE-ROWID
+
+`rowKey` falta ou se repete nas linhas carregadas.
+
+Correção: Cada linha precisa de uma string estável e única.
+
+## RAC-TABLE-ID
+
+`id` está vazio. A chave seria `${namespace}:table:`.
+
+Correção: Passe um id estável por tabela.
+
+## RAC-COLUMN-COMPONENT
+
+Se o `component` de uma coluna não estiver registrado em `config.columns` do `AutoConfigProvider`, o modo de desenvolvimento avisa com `RAC-COLUMN-COMPONENT` e a célula mantém o formato padrão. Registre a chave ou defina `render`, `format` ou `sort` na coluna. As funções da coluna têm prioridade.
+
+## RAC-ROW-ACTION
+
+Se uma ação de linha não tiver `onClick` e seu `action` não for uma chave conhecida de `config.rowActions`, ao selecioná-la a linha de status mostra `RAC-ROW-ACTION`. Forneça `onClick` ou registre a chave de `action`. Se ambos existirem, `onClick` tem prioridade.
+
+## RAC-TABLE-SOURCE
+
+`source` é uma chave de `config.sources` no `AutoConfigProvider`. Uma chave desconhecida mostra `RAC-TABLE-SOURCE` com um botão para tentar novamente. Registre a chave ou use `data` / `dataSource`. Forneça exatamente uma das três opções.
+
+## RAC-TABLE-FILTER
+
+O JSON do filtro não é uma consulta. O texto traduzido aparece e o filtro anterior fica.
+
+Correção: Grupo `{ kind: "group", operator, children }`. Condição `{ kind: "condition", field, operator, value }`. `between` é `[from, to]`.
+
+## RAC-QUERY-FIELD
+
+`serializeRsql` recusou um nome fora de `/^[\\w.]+$/`.
+
+Correção: Só letras, dígitos, sublinhado e pontos.
+
+## RAC-DIALOG-PROVIDER
+
+`useAutoDialog()` fora de `AutoDialogProvider`.
+
+Correção: Envolva a árvore com `<AutoDialogProvider>`. `AutoConfigProvider` não fornece diálogos e é opcional. `<AutoDialog open>` não usa este hook.

package/docs/i18n/ru/README.md

@@ -12,10 +12,14 @@
 
 ## Состояние проекта
 
-Текущая версия — 0.1.2, и API могут ещё измениться. Требуется React 19. Пакет предоставляет ESM и декларации TypeScript. Встроенный текст интерфейса по умолчанию на китайском языке и может быть переведён через AutoConfigProvider.config.t.
+Текущая версия — 0.1.3, и API могут ещё измениться. Требуется React 19. Пакет предоставляет ESM и декларации TypeScript. Встроенный текст интерфейса по умолчанию на английском языке и может быть переведён через AutoConfigProvider.config.t.
 
 Установите пакет командой `pnpm add @zeroman.yang/react-auto-components` (npm и yarn подходят так же). Peer dependencies: React 19 и react-dom 19. Один раз импортируйте таблицу стилей: `import "@zeroman.yang/react-auto-components/style.css"`.
 
+Один раз импортируйте в точке входа приложения `import "@zeroman.yang/react-auto-components/style.css"`. Без таблицы стилей в режиме разработки появляется предупреждение `RAC-CSS-MISSING`.
+
+При экспорте XLSX код `RAC-TABLE-XLSX` означает отсутствие адаптера `exportXlsx`, а `RAC-XLSX-DEP` — невозможность загрузить необязательную зависимость `exceljs`. Импортируйте и передайте адаптер из `@zeroman.yang/react-auto-components/xlsx`; при необходимости выполните `pnpm add exceljs`. Для CSV и JSON он не нужен.
+
 - [Онлайн-демо (GitHub Pages)](https://zeroman.github.io/react-auto-components/)
 - [Участие в разработке](https://github.com/Zeroman/react-auto-components/blob/main/docs/i18n/ru/CONTRIBUTING.md)
 - [История изменений](https://github.com/Zeroman/react-auto-components/blob/main/docs/i18n/ru/CHANGELOG.md)
@@ -85,7 +89,7 @@ export function App() {
 | Компонент | Возможности |
 | --- | --- |
 | AutoForm | Нативные типы полей, виртуализация вариантов выбора, каскадный выбор, адаптеры загрузки файлов, пользовательский рендеринг, зависимые поля, условная видимость, асинхронная валидация, управляемое состояние, сохранение ввода после ошибок |
-| AutoSearchPanel | Простые/расширенные условия, ручной/мгновенный поиск, сброс, метки сортировки, общее AST запросов и сериализация RSQL |
+| AutoSearch | Простые/расширенные условия, ручной/мгновенный поиск, сброс, метки сортировки, общее AST запросов и сериализация RSQL |
 | AutoTable | Локальные/удалённые данные, сортировка по нескольким столбцам, фильтры столбцов, пагинация, стабильное выделение, виртуализация, раскрытие дерева/подробностей, итоги, объединённые ячейки, CRUD, контекстные меню и копирование |
 | AutoDialog | Декларативный/императивный API, изолированные провайдеры, черновики, проверки перед закрытием, управление фокусом, перетаскивание, полноэкранный режим и асинхронная отправка |
 | AutoTabs | Горизонтальная/вертикальная компоновка, вложенность, разрешения, отключённые вкладки, сохранение состояния панелей и обновление |
@@ -201,3 +205,5 @@ pnpm test:e2e
 AutoChat предоставляет лёгкую компоновку диалога с отслеживанием потокового вывода, загрузкой истории и полем ввода. Для отображения сообщений передайте содержимое React или renderMessage; дополнительные runtime-зависимости не требуются.
 
 [AutoChat API](auto-chat.md)
+
+Что делает компонент, если колбэк бросает исключение: [AutoForm](auto-form.md), [AutoSearch](auto-search.md), [AutoTable](auto-table.md), [AutoDialog](auto-dialog.md), [AutoTabs](auto-tabs.md), [AutoMenu](auto-menu.md). Коды ошибок для разработчиков: [errors.md](errors.md).

package/docs/i18n/ru/auto-dialog.md

@@ -0,0 +1,23 @@
+# AutoDialog
+
+[English](../../auto-dialog.md) | [简体中文](../zh-CN/auto-dialog.md) | [繁體中文](../zh-TW/auto-dialog.md) | [日本語](../ja/auto-dialog.md) | [한국어](../ko/auto-dialog.md) | [Español](../es/auto-dialog.md) | [Français](../fr/auto-dialog.md) | [Deutsch](../de/auto-dialog.md) | [Português (Brasil)](../pt-BR/auto-dialog.md) | **Русский**
+
+Модальный диалог, декларативный (`<AutoDialog open>`) или императивный (`useAutoDialog().open()`). `fields` рисует [AutoForm](auto-form.md).
+
+`useAutoDialog()` вне провайдера бросает `RAC-DIALOG-PROVIDER`. `<AutoDialog open>` провайдер не нужен.
+
+## Поведение и свойства
+
+| Свойство | Поведение |
+| --- | --- |
+| `onSubmit(values)` | После проверки. **Reject или throw: диалог остается открытым, показывает `error.message`, значения остаются.** После resolve все еще выполняется `beforeClose`. |
+| `beforeClose(reason)` | `"submit"`, `"cancel"` или `"close"`. **`false` оставляет открытым. Throw тоже оставляет открытым и показывает сообщение.** |
+| `onClose` | Только после настоящего закрытия. |
+| `draftKey` | Хранит черновик в `${namespace}:draft:${draftKey}` до успешной отправки. Если опустить, ничего не сохраняется. |
+| `width` | По умолчанию `560`. `draggable` в полноэкранном режиме игнорируется. |
+
+`close()` у `open()` резолвится в `false`, если `beforeClose` блокирует закрытие. Императивные диалоги складываются в стопку.
+
+## Предусловия
+
+Импортируйте `style.css` один раз. `AutoConfigProvider` необязателен и не заменяет `AutoDialogProvider`. `namespace` входит в ключ черновика.

package/docs/i18n/ru/auto-form.md

@@ -0,0 +1,35 @@
+# AutoForm
+
+[English](../../auto-form.md) | [简体中文](../zh-CN/auto-form.md) | [繁體中文](../zh-TW/auto-form.md) | [日本語](../ja/auto-form.md) | [한국어](../ko/auto-form.md) | [Español](../es/auto-form.md) | [Français](../fr/auto-form.md) | [Deutsch](../de/auto-form.md) | [Português (Brasil)](../pt-BR/auto-form.md) | **Русский**
+
+Форма по схеме. `AutoSearch` и `AutoDialog` рисуют `AutoForm`, поэтому эти правила колбэков относятся и к ним.
+
+`Field<T>` — размеченное объединение по `type`. `select` без `options`, скаляр у `daterange` и `match: "between"` на скаляре — ошибки TypeScript. `AnyField` и `unsafeField()` — запасной выход; режим разработки все равно предупреждает. Коды в [errors.md](errors.md).
+
+## Поведение и свойства
+
+| Свойство | Поведение |
+| --- | --- |
+| `fields` | `readonly Field<T>[]`. Без `type` это текстовое поле. Повторяющийся `name` бросает `RAC-FIELD-DUPLICATE` при монтировании. |
+| `value` | Управляемое значение. Если оно отличается от внутреннего состояния, форма копирует его и очищает ошибки. Если родитель игнорирует `onChange`, ввод откатывается. |
+| `onSubmit(value)` | Только после проверки. **Отклонение или throw: значения остаются, показывается `error.message`, сброса нет.** |
+| `columns` | По умолчанию `2`. `actions` по умолчанию `true`. |
+| Подписи | `labelPosition` по умолчанию `"top"`. `labelWidth` по умолчанию `"auto"` (измеряется, не больше 45% ширины поля). |
+
+## Если колбэк бросает
+
+| Колбэк | Результат |
+| --- | --- |
+| `onSubmit` | Перехватывается. Черновик остается. Сообщение показывается. Сброса нет. |
+| `rules` поля | Брошенный текст становится ошибкой этого поля. Следующие правила не выполняются. |
+| `onChange` поля | Не перехватывается. Остается прежнее значение. |
+| `upload` | Отказ виден под полем, значение не сохраняется. `reset()` прерывает сигнал и отбрасывает поздний результат. |
+| Отправка во время загрузки | `validate()` возвращает `false` и не вызывает `onSubmit`. |
+| `hidden`, `disabled` или нет доступа | Поле не проверяется, даже если оно `required`. |
+| Пустой `required` | `undefined`, `null`, `""` или пустой массив блокируют отправку. |
+
+`handle.validate()` резолвится в `true` или `false`. Не бросает.
+
+## Предусловия
+
+Импортируйте `style.css` один раз. В разработке отсутствие `--auto-text` предупреждает `RAC-CSS-MISSING`. `AutoConfigProvider` необязателен и не монтирует диалоги.

package/docs/i18n/ru/auto-menu.md

@@ -0,0 +1,23 @@
+# AutoMenu
+
+[English](../../auto-menu.md) | [简体中文](../zh-CN/auto-menu.md) | [繁體中文](../zh-TW/auto-menu.md) | [日本語](../ja/auto-menu.md) | [한국어](../ko/auto-menu.md) | [Español](../es/auto-menu.md) | [Français](../fr/auto-menu.md) | [Deutsch](../de/auto-menu.md) | [Português (Brasil)](../pt-BR/auto-menu.md) | **Русский**
+
+Боковая панель. Для панелей с содержимым используйте [AutoTabs](auto-tabs.md).
+
+## Поведение и свойства
+
+| Свойство | Поведение |
+| --- | --- |
+| `items` | `id` уникален в дереве. `hidden` и неудачный `canAccess` отбрасывают пункт. `children`, который указывает на предка, отбрасывается целиком, чтобы плохая схема не ушла в рекурсию. |
+| `value` | Id выбранного листа. Если опустить, выбор хранится внутри. |
+| `onChange(id, item, path)` | **Не перехватывается.** `path` — цепочка id от корня до листа. Родитель с детьми только переключает раскрытие и не выбирается. |
+| `collapsible` | По умолчанию `false`. Если `collapsed` управляемый, обновите его в `onCollapsedChange`, иначе рельс не сдвинется. **`onCollapsedChange` не перехватывается.** |
+| `disabled` | Отключает пункт и потомков. Выбор их пропускает. |
+
+Выбор листа сам по себе не переходит по маршруту. Единственный сигнал — `onChange`.
+
+## Предусловия
+
+Импортируйте `style.css` один раз. `AutoConfigProvider` необязателен. Права идут через `config.canAccess`.
+
+Один раз импортируйте в точке входа приложения `import "@zeroman.yang/react-auto-components/style.css"`. Без таблицы стилей в режиме разработки появляется предупреждение `RAC-CSS-MISSING`.

package/docs/i18n/ru/auto-search.md

@@ -0,0 +1,32 @@
+# AutoSearch
+
+[English](../../auto-search.md) | [简体中文](../zh-CN/auto-search.md) | [繁體中文](../zh-TW/auto-search.md) | [日本語](../ja/auto-search.md) | [한국어](../ko/auto-search.md) | [Español](../es/auto-search.md) | [Français](../fr/auto-search.md) | [Deutsch](../de/auto-search.md) | [Português (Brasil)](../pt-BR/auto-search.md) | **Русский**
+
+Форма поиска. Рисует `AutoForm` и отдает `QueryNode` вместе со значениями. Если колбэк поля бросает, действуют правила [AutoForm](auto-form.md).
+
+`AutoSearchPanel` и `AutoSearchPanelProps` — устаревшие псевдонимы `AutoSearch` и `AutoSearchProps`.
+
+## Поведение и свойства
+
+| Свойство | Поведение |
+| --- | --- |
+| `onSearch(query, values)` | Обязателен. **Throw или reject: внутренняя форма перехватывает, значения остаются, показывается `error.message`. Сброса нет.** |
+| `mode` | По умолчанию `"manual"` (кнопка). `"instant"` ищет еще и при каждом изменении. |
+| `columns` | По умолчанию `3`. |
+| `more: true` | Прячет поле, пока не открыто «Еще». Скрытые поля не попадают в запрос. |
+
+| `match` | Значение |
+| --- | --- |
+| не задан | `"eq"`, или `"in"`, если значение — массив. |
+| `"contains"` | Подстрока. `ignoreCase: true` не различает регистр. |
+| `"between"` | `[from, to]`. Скаляр предупреждает `RAC-FIELD-BETWEEN` и не совпадает со строками. |
+| `"isNull"` | Совпадает с null или undefined. Введенное значение игнорируется. |
+| пусто | `undefined`, `null`, `""` и пустые массивы опускаются, кроме `"isNull"`. |
+
+Сброс возвращает `defaultValue` и затем ищет. `serializeRsql` бросает `RAC-QUERY-FIELD`, если имя не подходит под `/^[\w.]+$/`.
+
+## Предусловия
+
+Импортируйте `style.css` один раз. `AutoConfigProvider` необязателен.
+
+Один раз импортируйте в точке входа приложения `import "@zeroman.yang/react-auto-components/style.css"`. Без таблицы стилей в режиме разработки появляется предупреждение `RAC-CSS-MISSING`.

package/docs/i18n/ru/auto-table.md

@@ -0,0 +1,31 @@
+# AutoTable
+
+[English](../../auto-table.md) | [简体中文](../zh-CN/auto-table.md) | [繁體中文](../zh-TW/auto-table.md) | [日本語](../ja/auto-table.md) | [한국어](../ko/auto-table.md) | [Español](../es/auto-table.md) | [Français](../fr/auto-table.md) | [Deutsch](../de/auto-table.md) | [Português (Brasil)](../pt-BR/auto-table.md) | **Русский**
+
+Локальная или удаленная таблица. Передайте ровно один из `data`, `dataSource` или `source`; несколько одновременно — ошибка типа. Поиск следует [AutoSearch](auto-search.md). Добавление и правка следуют [AutoDialog](auto-dialog.md) и [AutoForm](auto-form.md).
+
+`exportXlsx` импортируется из `@zeroman.yang/react-auto-components/xlsx`. `exceljs` необязателен (`RAC-XLSX-DEP`, если его нет).
+
+## Поведение и свойства
+
+| Свойство | Поведение |
+| --- | --- |
+| `id` | Обязателен. Ключ — `${namespace}:table:${id}`. Пустой id предупреждает `RAC-TABLE-ID`. |
+| `rowKey` | Уникален среди загруженных строк. Отсутствие или повтор: `RAC-TABLE-ROWID`. Выбор, раскрытие и `scrollToRow` используют его. |
+| `dataSource` | **Reject: сообщение и кнопка повтора. Abort игнорируется.** `total` — полное число после фильтра, не длина страницы. |
+| `pageSize` | По умолчанию `10`. `pagination` по умолчанию `true`. `height` по умолчанию `440`. `"auto"` заполняет родителя, у которого уже есть высота. |
+| `onAdd`, `onEdit`, `onDelete` | **Reject или throw: диалог остается открытым и показывает `error.message`.** Строки не меняются, если обработчик сам их еще не изменил. |
+| `rowActions` | Отклонение `onClick` перехватывается и показывается в строке состояния примерно 2,5 секунды. Строка остаётся. Если у действия строки нет `onClick`, а `action` не является известным ключом `config.rowActions`, при выборе действия в строке состояния появляется `RAC-ROW-ACTION`. Передайте `onClick` или зарегистрируйте ключ `action`. Если указаны оба, приоритет у `onClick`. |
+| `component` | Если `component` столбца не зарегистрирован в `config.columns` у `AutoConfigProvider`, в режиме разработки появляется предупреждение `RAC-COLUMN-COMPONENT`, а ячейка использует стандартный формат. Зарегистрируйте ключ или задайте `render`, `format` либо `sort` в столбце. Функции столбца имеют приоритет. |
+| `source` | `source` — ключ в `config.sources` у `AutoConfigProvider`. Неизвестный ключ вызывает `RAC-TABLE-SOURCE` с кнопкой повтора. Зарегистрируйте ключ или используйте `data` / `dataSource`. Укажите ровно один из трёх вариантов. |
+| `exportXlsx` | Нужен только для xlsx. Если его нет, `RAC-TABLE-XLSX`. CSV и JSON встроены. |
+
+`handle.export` резолвится, даже если в статусе ошибка; повторно не бросает. Удаленный `"filtered"` обходит все страницы. Пустая страница до последней бросает `RAC-TABLE-EXPORT-PAGE` и не скачивает частичный файл.
+
+Неверный JSON фильтра показывает перевод, предупреждает `RAC-TABLE-FILTER` и сохраняет прежний фильтр. `between` имеет длину 2. `in` — массив.
+
+`handle.reset()` очищает сортировку, фильтр и выбор и возвращает раскладку к колонкам. `scrollToRow` ничего не делает, если этот id не загружен.
+
+## Предусловия
+
+Импортируйте `style.css` один раз. Разделяйте `namespace`, если несколько приложений на одном origin хранят таблицы; по умолчанию `"auto"`. Встроенным диалогам добавления и правки `AutoDialogProvider` не нужен. Он нужен только `useAutoDialog()`.

package/docs/i18n/ru/auto-tabs.md

@@ -0,0 +1,25 @@
+# AutoTabs
+
+[English](../../auto-tabs.md) | [简体中文](../zh-CN/auto-tabs.md) | [繁體中文](../zh-TW/auto-tabs.md) | [日本語](../ja/auto-tabs.md) | [한국어](../ko/auto-tabs.md) | [Español](../es/auto-tabs.md) | [Français](../fr/auto-tabs.md) | [Deutsch](../de/auto-tabs.md) | [Português (Brasil)](../pt-BR/auto-tabs.md) | **Русский**
+
+Вкладки. Вложенные — это еще один `AutoTabs` из `children`. Для боковой панели используйте [AutoMenu](auto-menu.md).
+
+## Поведение и свойства
+
+| Свойство | Поведение |
+| --- | --- |
+| `items` | У каждой вкладки стабильный `id`. `hidden` и неудачный `canAccess` убирают вкладку. |
+| `value` | Управляемый путь id от корня. Вложенный путь — `["parent", "child"]`. |
+| `onChange(path, item)` | **Не перехватывается.** Если бросает, React сообщает об ошибке. В управляемом режиме еще не зафиксированный путь остается прежним. |
+| `mode` | По умолчанию `"horizontal"`. `"vertical"` ставит список вертикально. |
+| `keepMounted` | По умолчанию `true`: неактивные панели остаются смонтированными. `false` размонтирует их. |
+| `onRefresh` | Если задан, у вкладки есть кнопка обновления. **Не перехватывается.** |
+| `disabled` | Остается видимой и не выбирается. Выбор по умолчанию пропускает отключенные вкладки. |
+
+## Предусловия
+
+Импортируйте `style.css` один раз (`RAC-CSS-MISSING` в разработке). `AutoConfigProvider` необязателен.
+
+## Динамические вкладки
+
+`useAutoTabsWorkspace` открывает и закрывает страницы без роутера. Передайте `tabsProps` в `AutoTabs`. Повторный `open` с тем же id только выбирает вкладку и сохраняет черновик. Закреплённую вкладку закрыть нельзя. Дождитесь `ready`, прежде чем вызывать `open`. Выбор, `params` и `state` восстанавливаются из `sessionStorage` после монтирования. Если `beforeClose` вернёт `false` или бросит ошибку, закрытие отменяется. Пример: [DynamicTabsDemo.tsx](../../../test-project/src/examples/DynamicTabsDemo.tsx).

package/docs/i18n/ru/errors.md

@@ -0,0 +1,110 @@
+# Коды ошибок
+
+[English](../../errors.md) | [简体中文](../zh-CN/errors.md) | [繁體中文](../zh-TW/errors.md) | [日本語](../ja/errors.md) | [한국어](../ko/errors.md) | [Español](../es/errors.md) | [Français](../fr/errors.md) | [Deutsch](../de/errors.md) | [Português (Brasil)](../pt-BR/errors.md) | **Русский**
+
+Сбои для разработчика бросают `RacError` или вызывают `console.warn` в режиме разработки. Текст всегда на английском.
+
+```text
+[Component] what is wrong.
+Fix: what to change.
+Code: RAC-…
+Docs: https://github.com/Zeroman/react-auto-components/blob/main/docs/errors.md#rac-…
+```
+
+Текст интерфейса остается в `config.t`. `userKey` — исходная английская фраза, которую хост переводит. Консоль и исключение остаются на английском.
+
+## RAC-FIELD-OPTIONS
+
+`type` равен `select`, `select-v2`, `radio`, `checkbox` или `cascader`, а `options` нет или массив пуст.
+
+Исправление: Передайте `options` массивом или `(values) => Option[]`. `autocomplete` может обойтись без них.
+
+## RAC-FIELD-RANGE
+
+`daterange` или `datetimerange` не имеет значения из двух элементов.
+
+Исправление: Типизируйте поле как `[start, end]`. `dateValue` по умолчанию `"string"`. `"timestamp"` хранит локальные миллисекунды. `null` оставляет конец открытым. Скаляр — ошибка TypeScript. Массив в модели компилируется; в разработке будет предупреждение, если реальная длина не 2.
+
+## RAC-FIELD-BETWEEN
+
+`match: "between"` — это не `[from, to]`.
+
+Исправление: Храните пару. Скаляр не совпадает ни с одной строкой. На `Field<T>` это тоже ошибка типа.
+
+## RAC-FIELD-CUSTOM
+
+`type: "custom"` без `render` и без `component`.
+
+Исправление: Передайте `render(context)` или ключ `component` из `config.fields`.
+
+## RAC-FIELD-DUPLICATE
+
+Два поля с одним `name`. `defaults` бросает это при монтировании.
+
+Исправление: Имена уникальны. У `title`, `tip`, `append` и `button` имени нет.
+
+## RAC-CSS-MISSING
+
+В разработке на `:root` нет `--auto-text`. Без таблицы стилей страница разъезжается, и DOM не объясняет почему.
+
+Исправление: Один раз: `import "@zeroman.yang/react-auto-components/style.css"`.
+
+## RAC-TABLE-XLSX
+
+`export("xlsx")` без `exportXlsx`.
+
+Исправление: Импортируйте `{ exportXlsx }` из `@zeroman.yang/react-auto-components/xlsx`. Интерфейс покажет переведенную фразу.
+
+## RAC-XLSX-DEP
+
+`exceljs` не загрузился. Это `optionalDependency`.
+
+Исправление: `pnpm add exceljs`. CSV и JSON его не требуют.
+
+## RAC-TABLE-EXPORT-PAGE
+
+Удаленная страница пуста до последней. Частичный файл не сохраняется.
+
+Исправление: Верните стабильный `total` и строки этого `pageIndex`.
+
+## RAC-TABLE-ROWID
+
+`rowKey` отсутствует или повторяется в загруженных строках.
+
+Исправление: У каждой строки должна быть стабильная уникальная строка.
+
+## RAC-TABLE-ID
+
+`id` пуст. Ключ был бы `${namespace}:table:`.
+
+Исправление: Передайте стабильный id каждой таблице.
+
+## RAC-COLUMN-COMPONENT
+
+Если `component` столбца не зарегистрирован в `config.columns` у `AutoConfigProvider`, в режиме разработки появляется предупреждение `RAC-COLUMN-COMPONENT`, а ячейка использует стандартный формат. Зарегистрируйте ключ или задайте `render`, `format` либо `sort` в столбце. Функции столбца имеют приоритет.
+
+## RAC-ROW-ACTION
+
+Если у действия строки нет `onClick`, а `action` не является известным ключом `config.rowActions`, при выборе действия в строке состояния появляется `RAC-ROW-ACTION`. Передайте `onClick` или зарегистрируйте ключ `action`. Если указаны оба, приоритет у `onClick`.
+
+## RAC-TABLE-SOURCE
+
+`source` — ключ в `config.sources` у `AutoConfigProvider`. Неизвестный ключ вызывает `RAC-TABLE-SOURCE` с кнопкой повтора. Зарегистрируйте ключ или используйте `data` / `dataSource`. Укажите ровно один из трёх вариантов.
+
+## RAC-TABLE-FILTER
+
+JSON фильтра — не запрос. Показывается перевод, прежний фильтр остается.
+
+Исправление: Группа `{ kind: "group", operator, children }`. Условие `{ kind: "condition", field, operator, value }`. `between` — это `[from, to]`.
+
+## RAC-QUERY-FIELD
+
+`serializeRsql` отклонил имя вне `/^[\\w.]+$/`.
+
+Исправление: Только буквы, цифры, подчеркивание и точки.
+
+## RAC-DIALOG-PROVIDER
+
+`useAutoDialog()` вне `AutoDialogProvider`.
+
+Исправление: Оберните дерево в `<AutoDialogProvider>`. `AutoConfigProvider` диалогов не дает и необязателен. `<AutoDialog open>` этот хук не использует.