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

package/docs/i18n/es/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** | [Français](../fr/auto-menu.md) | [Deutsch](../de/auto-menu.md) | [Português (Brasil)](../pt-BR/auto-menu.md) | [Русский](../ru/auto-menu.md)
+
+Barra lateral. Para paneles usa [AutoTabs](auto-tabs.md).
+
+## Comportamiento y props
+
+| Prop | Comportamiento |
+| --- | --- |
+| `items` | `id` único en el árbol. `hidden` y un `canAccess` fallido descartan la entrada. Un `children` que apunta a un ancestro se descarta entero para que un esquema malo no recurse. |
+| `value` | Id de la hoja seleccionada. Si se omite, la selección queda dentro. |
+| `onChange(id, item, path)` | **No se captura.** `path` es la cadena de ids desde la raíz. Un padre con hijos alterna la expansión y no se selecciona. |
+| `collapsible` | Por defecto `false`. Si `collapsed` está controlado, hay que actualizarlo en `onCollapsedChange` o el rail no se mueve. **`onCollapsedChange` no se captura.** |
+| `disabled` | Deshabilita la entrada y sus descendientes. La selección los salta. |
+
+Elegir una hoja no navega por sí solo. La única señal es `onChange`.
+
+## Precondiciones
+
+Importa `style.css` una vez. `AutoConfigProvider` es opcional. Los permisos usan `config.canAccess`.
+
+Importa una vez en la entrada de la aplicación `import "@zeroman.yang/react-auto-components/style.css"`. Si falta la hoja de estilos, el desarrollo avisa con `RAC-CSS-MISSING`.

package/docs/i18n/es/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** | [Français](../fr/auto-search.md) | [Deutsch](../de/auto-search.md) | [Português (Brasil)](../pt-BR/auto-search.md) | [Русский](../ru/auto-search.md)
+
+Formulario de búsqueda. Dibuja un `AutoForm` y emite un `QueryNode` y los valores. Si un callback de campo lanza, valen las reglas de [AutoForm](auto-form.md).
+
+`AutoSearchPanel` y `AutoSearchPanelProps` son alias en desuso de `AutoSearch` y `AutoSearchProps`.
+
+## Comportamiento y props
+
+| Prop | Comportamiento |
+| --- | --- |
+| `onSearch(query, values)` | Obligatorio. **Lanzar o rechazar: el formulario interno lo captura, los valores se quedan y se muestra `error.message`. No hay reset.** |
+| `mode` | Por defecto `"manual"` (botón). `"instant"` busca también en cada cambio. |
+| `columns` | Por defecto `3`. |
+| `more: true` | Oculta el campo hasta abrir "Más". Los campos ocultos no entran en la consulta. |
+
+| `match` | Valor |
+| --- | --- |
+| omitido | `"eq"`, o `"in"` si el valor es un array. |
+| `"contains"` | Subcadena. `ignoreCase: true` ignora mayúsculas. |
+| `"between"` | `[from, to]`. Un escalar avisa `RAC-FIELD-BETWEEN` y no coincide con filas. |
+| `"isNull"` | Coincide con null o undefined. El valor escrito se ignora. |
+| vacío | `undefined`, `null`, `""` y arrays vacíos se omiten, salvo `"isNull"`. |
+
+El reset restaura `defaultValue` y luego busca. `serializeRsql` lanza `RAC-QUERY-FIELD` si el nombre no cumple `/^[\w.]+$/`.
+
+## Precondiciones
+
+Importa `style.css` una vez. `AutoConfigProvider` es opcional.
+
+Importa una vez en la entrada de la aplicación `import "@zeroman.yang/react-auto-components/style.css"`. Si falta la hoja de estilos, el desarrollo avisa con `RAC-CSS-MISSING`.

package/docs/i18n/es/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** | [Français](../fr/auto-table.md) | [Deutsch](../de/auto-table.md) | [Português (Brasil)](../pt-BR/auto-table.md) | [Русский](../ru/auto-table.md)
+
+Tabla local o remota. Pasa exactamente uno de `data`, `dataSource` o `source`; combinar varios es un error de tipo. La búsqueda sigue [AutoSearch](auto-search.md). Alta y edición siguen [AutoDialog](auto-dialog.md) y [AutoForm](auto-form.md).
+
+`exportXlsx` se importa de `@zeroman.yang/react-auto-components/xlsx`. `exceljs` es opcional (`RAC-XLSX-DEP` si falta).
+
+## Comportamiento y props
+
+| Prop | Comportamiento |
+| --- | --- |
+| `id` | Obligatorio. La clave es `${namespace}:table:${id}`. Vacío avisa `RAC-TABLE-ID`. |
+| `rowKey` | Único en las filas cargadas. Falta o duplicado avisa `RAC-TABLE-ROWID`. Lo usan la selección, la expansión y `scrollToRow`. |
+| `dataSource` | **Rechazar: se muestra el mensaje y un botón de reintento. El abort se ignora.** `total` es el recuento filtrado completo, no el largo de la página. |
+| `pageSize` | Por defecto `10`. `pagination` por defecto `true`. `height` por defecto `440`. `"auto"` llena un padre que ya tiene altura. |
+| `onAdd`, `onEdit`, `onDelete` | **Rechazar o lanzar: el diálogo sigue abierto y muestra `error.message`.** Las filas no cambian salvo que tu handler ya las haya cambiado. |
+| `rowActions` | El rechazo de `onClick` se captura y se muestra en la línea de estado durante unos 2,5 segundos. La fila permanece. Si una acción de fila no tiene `onClick` y su `action` no es una clave conocida de `config.rowActions`, al seleccionarla la línea de estado muestra `RAC-ROW-ACTION`. Proporciona `onClick` o registra la clave de `action`. Si existen ambos, prevalece `onClick`. |
+| `component` | Si el `component` de una columna no está registrado en `config.columns` de `AutoConfigProvider`, el desarrollo avisa con `RAC-COLUMN-COMPONENT` y la celda conserva el formato predeterminado. Registra la clave o define `render`, `format` o `sort` en la columna. Las funciones de la columna tienen prioridad. |
+| `source` | `source` es una clave de `config.sources` en `AutoConfigProvider`. Una clave desconocida muestra `RAC-TABLE-SOURCE` con un botón para reintentar. Registra la clave o usa `data` / `dataSource`. Proporciona exactamente una de las tres opciones. |
+| `exportXlsx` | Solo hace falta para xlsx. Si falta, `RAC-TABLE-XLSX`. CSV y JSON van incluidos. |
+
+`handle.export` resuelve aunque el estado muestre un error; no relanza. `"filtered"` remoto recorre todas las páginas. Una página vacía antes de la última lanza `RAC-TABLE-EXPORT-PAGE` y no descarga un archivo parcial.
+
+Un JSON de filtro inválido muestra el texto traducido, avisa `RAC-TABLE-FILTER` y conserva el filtro anterior. `between` debe tener longitud 2. `in` debe ser un array.
+
+`handle.reset()` limpia orden, filtro y selección y devuelve el diseño a las columnas. `scrollToRow` no hace nada si ese id no está cargado.
+
+## Precondiciones
+
+Importa `style.css` una vez. Separa `namespace` si varias apps del mismo origen persisten tablas; el valor por defecto es `"auto"`. Los diálogos de alta y edición no necesitan `AutoDialogProvider`. Solo `useAutoDialog()` lo necesita.

package/docs/i18n/es/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** | [Français](../fr/auto-tabs.md) | [Deutsch](../de/auto-tabs.md) | [Português (Brasil)](../pt-BR/auto-tabs.md) | [Русский](../ru/auto-tabs.md)
+
+Pestañas. Las anidadas son otro `AutoTabs` alimentado por `children`. Para una barra lateral usa [AutoMenu](auto-menu.md).
+
+## Comportamiento y props
+
+| Prop | Comportamiento |
+| --- | --- |
+| `items` | Cada pestaña necesita un `id` estable. `hidden` y un `canAccess` fallido la quitan. |
+| `value` | Ruta controlada de ids desde la raíz. Lo anidado es `["parent", "child"]`. |
+| `onChange(path, item)` | **No se captura.** Si lanza, React informa el error. En modo controlado, la ruta no confirmada se queda en la anterior. |
+| `mode` | Por defecto `"horizontal"`. `"vertical"` apila la lista. |
+| `keepMounted` | Por defecto `true`: los paneles inactivos siguen montados. `false` los desmonta. |
+| `onRefresh` | Si existe, hay un botón de refresco. **No se captura.** |
+| `disabled` | Sigue visible y no se puede elegir. La selección por defecto salta las pestañas deshabilitadas. |
+
+## Precondiciones
+
+Importa `style.css` una vez (`RAC-CSS-MISSING` en desarrollo). `AutoConfigProvider` es opcional.
+
+## Pestañas dinámicas
+
+`useAutoTabsWorkspace` abre y cierra páginas sin un router. Pasa `tabsProps` a `AutoTabs`. Volver a llamar `open` con el mismo id solo selecciona esa pestaña y conserva el borrador. Una pestaña fijada no se cierra. Espera a `ready` antes de `open`. La selección, `params` y `state` se restauran desde `sessionStorage` tras el montaje. Si `beforeClose` devuelve `false` o lanza, no se cierra. El ejemplo está en [DynamicTabsDemo.tsx](../../../test-project/src/examples/DynamicTabsDemo.tsx).

package/docs/i18n/es/errors.md

@@ -0,0 +1,110 @@
+# Códigos de error
+
+[English](../../errors.md) | [简体中文](../zh-CN/errors.md) | [繁體中文](../zh-TW/errors.md) | [日本語](../ja/errors.md) | [한국어](../ko/errors.md) | **Español** | [Français](../fr/errors.md) | [Deutsch](../de/errors.md) | [Português (Brasil)](../pt-BR/errors.md) | [Русский](../ru/errors.md)
+
+Los fallos de desarrollo lanzan `RacError` o llaman a `console.warn` en desarrollo. El texto siempre es 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-…
+```
+
+Las frases de la interfaz siguen en `config.t`. `userKey` es la frase fuente en inglés que el anfitrión traduce. La consola y la excepción quedan en inglés.
+
+## RAC-FIELD-OPTIONS
+
+`type` es `select`, `select-v2`, `radio`, `checkbox` o `cascader`, y falta `options` o es un array vacío.
+
+Arreglo: Pasa `options` como array o `(values) => Option[]`. `autocomplete` puede omitirlas: es un texto con sugerencias opcionales.
+
+## RAC-FIELD-RANGE
+
+`daterange` o `datetimerange` no tiene un valor de dos elementos.
+
+Arreglo: Tipa el campo como `[start, end]`. `dateValue` por defecto es `"string"` (`YYYY-MM-DD`). `"timestamp"` guarda milisegundos locales. `null` deja el extremo abierto. Un escalar es un error de TypeScript. Un array en el modelo compila; en desarrollo se avisa si la longitud real no es 2.
+
+## RAC-FIELD-BETWEEN
+
+`match: "between"` no es `[from, to]`.
+
+Arreglo: Guarda una tupla de dos. Un escalar no coincide con ninguna fila. En `Field<T>` también es un error de tipo.
+
+## RAC-FIELD-CUSTOM
+
+`type: "custom"` no tiene `render` ni `component`.
+
+Arreglo: Pasa `render(context)` o `component` con una clave de `config.fields`.
+
+## RAC-FIELD-DUPLICATE
+
+Dos campos comparten `name`. `defaults` lo lanza al montar.
+
+Arreglo: Nombres únicos. `title`, `tip`, `append` y `button` no tienen nombre y no se comprueban.
+
+## RAC-CSS-MISSING
+
+En desarrollo `--auto-text` no está en `:root`. Sin la hoja de estilos la página se ve rota y el DOM no dice por qué.
+
+Arreglo: Una vez: `import "@zeroman.yang/react-auto-components/style.css"`.
+
+## RAC-TABLE-XLSX
+
+`export("xlsx")` sin `exportXlsx`.
+
+Arreglo: Importa `{ exportXlsx }` desde `@zeroman.yang/react-auto-components/xlsx` y pásalo. La UI muestra la frase traducida.
+
+## RAC-XLSX-DEP
+
+No se pudo cargar `exceljs`. Es una `optionalDependency`.
+
+Arreglo: `pnpm add exceljs`. CSV y JSON no lo necesitan.
+
+## RAC-TABLE-EXPORT-PAGE
+
+Una página remota llegó vacía antes de la última. No se guarda un archivo parcial.
+
+Arreglo: Devuelve un `total` estable y las filas de ese `pageIndex`.
+
+## RAC-TABLE-ROWID
+
+`rowKey` falta o se repite en las filas cargadas.
+
+Arreglo: Cada fila necesita un string estable y único. Selección, expansión y `scrollToRow` lo usan.
+
+## RAC-TABLE-ID
+
+`id` está vacío. La clave sería `${namespace}:table:`.
+
+Arreglo: Pasa un id estable por tabla.
+
+## RAC-COLUMN-COMPONENT
+
+Si el `component` de una columna no está registrado en `config.columns` de `AutoConfigProvider`, el desarrollo avisa con `RAC-COLUMN-COMPONENT` y la celda conserva el formato predeterminado. Registra la clave o define `render`, `format` o `sort` en la columna. Las funciones de la columna tienen prioridad.
+
+## RAC-ROW-ACTION
+
+Si una acción de fila no tiene `onClick` y su `action` no es una clave conocida de `config.rowActions`, al seleccionarla la línea de estado muestra `RAC-ROW-ACTION`. Proporciona `onClick` o registra la clave de `action`. Si existen ambos, prevalece `onClick`.
+
+## RAC-TABLE-SOURCE
+
+`source` es una clave de `config.sources` en `AutoConfigProvider`. Una clave desconocida muestra `RAC-TABLE-SOURCE` con un botón para reintentar. Registra la clave o usa `data` / `dataSource`. Proporciona exactamente una de las tres opciones.
+
+## RAC-TABLE-FILTER
+
+El JSON del filtro no es una consulta. Se muestra el texto traducido y se conserva el filtro anterior.
+
+Arreglo: Grupo: `{ kind: "group", operator, children }`. Condición: `{ kind: "condition", field, operator, value }`. `between` es `[from, to]`. `in` es un array.
+
+## RAC-QUERY-FIELD
+
+`serializeRsql` rechazó un nombre que no cumple `/^[\\w.]+$/`.
+
+Arreglo: Solo letras, dígitos, guion bajo y puntos.
+
+## RAC-DIALOG-PROVIDER
+
+`useAutoDialog()` fuera de `AutoDialogProvider`.
+
+Arreglo: Envuelve el árbol en `<AutoDialogProvider>`. `AutoConfigProvider` no da diálogos y es opcional. `<AutoDialog open>` no usa este hook.

package/docs/i18n/fr/README.md

@@ -12,10 +12,14 @@ Une bibliothèque de composants autonome et pilotée par schéma pour React 19,
 
 ## État du projet
 
-La version actuelle est 0.1.1 et les API peuvent encore évoluer. React 19 est requis. Le paquet fournit ESM et des déclarations TypeScript. Les textes d'interface intégrés sont en chinois par défaut et peuvent être traduits via AutoConfigProvider.config.t.
+La version actuelle est 0.1.3 et les API peuvent encore évoluer. React 19 est requis. Le paquet fournit ESM et des déclarations TypeScript. Les textes d'interface intégrés sont en anglais par défaut et peuvent être traduits via AutoConfigProvider.config.t.
 
 Installez-le avec `pnpm add @zeroman.yang/react-auto-components` (npm et yarn conviennent aussi). Les peer dependencies sont React 19 et react-dom 19. Importez la feuille de style une fois : `import "@zeroman.yang/react-auto-components/style.css"`.
 
+Importez une fois au point d’entrée de l’application `import "@zeroman.yang/react-auto-components/style.css"`. Sans feuille de styles, le mode développement signale `RAC-CSS-MISSING`.
+
+Pour l’export XLSX, `RAC-TABLE-XLSX` indique que l’adaptateur `exportXlsx` manque ; `RAC-XLSX-DEP` indique que la dépendance facultative `exceljs` n’a pas pu être chargée. Importez et transmettez l’adaptateur depuis `@zeroman.yang/react-auto-components/xlsx` ; installez si nécessaire avec `pnpm add exceljs`. CSV et JSON n’en ont pas besoin.
+
 - [Démo en direct (GitHub Pages)](https://zeroman.github.io/react-auto-components/)
 - [Contribuer](https://github.com/Zeroman/react-auto-components/blob/main/docs/i18n/fr/CONTRIBUTING.md)
 - [Journal des modifications](https://github.com/Zeroman/react-auto-components/blob/main/docs/i18n/fr/CHANGELOG.md)
@@ -85,7 +89,7 @@ Le callback t reçoit une clé de message et un texte de repli. Conservez les es
 | Composant | Fonctionnalités |
 | --- | --- |
 | AutoForm | Types de champ natifs, options virtualisées, sélection en cascade, adaptateurs de téléversement, rendu personnalisé, champs dépendants, visibilité conditionnelle, validation asynchrone, état contrôlé et conservation des saisies après un échec |
-| AutoSearchPanel | Conditions simples/avancées, recherche manuelle/instantanée, réinitialisation, étiquettes de tri, AST de requête partagé et sérialisation RSQL |
+| AutoSearch | Conditions simples/avancées, recherche manuelle/instantanée, réinitialisation, étiquettes de tri, AST de requête partagé et sérialisation RSQL |
 | AutoTable | Données locales/distantes, tri multicolonne, filtres de colonne, pagination, sélection stable, virtualisation, dépliage d’arbres/de détails, synthèses, cellules fusionnées, CRUD, menus contextuels et copie |
 | AutoDialog | API déclaratives/impératives, fournisseurs isolés, brouillons, protection contre la fermeture, gestion du focus, déplacement par glisser, plein écran et envoi asynchrone |
 | AutoTabs | Dispositions horizontales/verticales, imbrication, autorisations, onglets désactivés, conservation de l’état des panneaux et actualisation |
@@ -201,3 +205,5 @@ Les formulaires prennent en charge `resetLabel`, `extraActions` et `onReset` ; l
 AutoChat fournit une mise en page de conversation légère avec suivi du streaming, chargement de l'historique et un composer. Fournissez du contenu React ou renderMessage pour le rendu des messages ; aucune dépendance d'exécution supplémentaire n'est requise.
 
 [AutoChat API](auto-chat.md)
+
+Ce que fait le composant si un rappel lève une exception : [AutoForm](auto-form.md), [AutoSearch](auto-search.md), [AutoTable](auto-table.md), [AutoDialog](auto-dialog.md), [AutoTabs](auto-tabs.md), [AutoMenu](auto-menu.md). Codes d'erreur développeur : [errors.md](errors.md).

package/docs/i18n/fr/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** | [Deutsch](../de/auto-dialog.md) | [Português (Brasil)](../pt-BR/auto-dialog.md) | [Русский](../ru/auto-dialog.md)
+
+Boîte modale, déclarative (`<AutoDialog open>`) ou impérative (`useAutoDialog().open()`). `fields` dessine un [AutoForm](auto-form.md).
+
+`useAutoDialog()` hors du fournisseur lance `RAC-DIALOG-PROVIDER`. `<AutoDialog open>` n'a pas besoin du fournisseur.
+
+## Comportement et props
+
+| Prop | Comportement |
+| --- | --- |
+| `onSubmit(values)` | Après validation. **Rejeter ou lancer : la boîte reste ouverte, montre `error.message`, les valeurs restent.** Après résolution, `beforeClose` court encore. |
+| `beforeClose(reason)` | `"submit"`, `"cancel"` ou `"close"`. **`false` laisse ouvert. Lancer laisse aussi ouvert et montre le message.** |
+| `onClose` | Seulement après une vraie fermeture. |
+| `draftKey` | Persiste le brouillon dans `${namespace}:draft:${draftKey}` jusqu'à un envoi réussi. Omis : rien n'est stocké. |
+| `width` | Défaut `560`. `draggable` est ignoré en plein écran. |
+
+`close()` de `open()` résout `false` si `beforeClose` bloque. Les boîtes impératives s'empilent.
+
+## Préconditions
+
+Importez `style.css` une fois. `AutoConfigProvider` est optionnel et ne remplace pas `AutoDialogProvider`. `namespace` entre dans la clé du brouillon.

package/docs/i18n/fr/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** | [Deutsch](../de/auto-form.md) | [Português (Brasil)](../pt-BR/auto-form.md) | [Русский](../ru/auto-form.md)
+
+Formulaire piloté par un schéma. `AutoSearch` et `AutoDialog` dessinent un `AutoForm`, donc ces règles s'appliquent aussi à eux.
+
+`Field<T>` est une union discriminée par `type`. Un `select` sans `options`, un scalaire sur `daterange` et `match: "between"` sur un scalaire sont des erreurs TypeScript. `AnyField` et `unsafeField()` sont la sortie de secours ; le mode développement avertit encore. Codes dans [errors.md](errors.md).
+
+## Comportement et props
+
+| Prop | Comportement |
+| --- | --- |
+| `fields` | `readonly Field<T>[]`. Sans `type`, c'est un texte. Un `name` en double lance `RAC-FIELD-DUPLICATE` au montage. |
+| `value` | Valeur contrôlée. Si elle diffère de l'état interne, le formulaire la copie et efface les erreurs. Si le parent ignore `onChange`, la saisie revient en arrière. |
+| `onSubmit(value)` | Uniquement après validation. **Rejeter ou lancer : les valeurs restent, `error.message` s'affiche, pas de reset.** |
+| `columns` | Défaut `2`. `actions` défaut `true`. |
+| Étiquettes | `labelPosition` défaut `"top"`. `labelWidth` défaut `"auto"` (mesuré, plafond 45 % du champ). |
+
+## Si un rappel lance
+
+| Rappel | Résultat |
+| --- | --- |
+| `onSubmit` | Capturé. Le brouillon reste. Le message s'affiche. Pas de reset. |
+| `rules` du champ | Le message lancé devient l'erreur de ce champ. Les règles suivantes ne courent pas. |
+| `onChange` du champ | Non capturé. La valeur précédente reste. |
+| `upload` | Le rejet s'affiche sous le champ et aucune valeur n'est stockée. `reset()` annule le signal et ignore un résultat tardif. |
+| Envoi pendant un téléversement | `validate()` renvoie `false` et n'appelle pas `onSubmit`. |
+| `hidden`, `disabled` ou accès refusé | Ce champ n'est pas validé, même s'il est `required`. |
+| `required` vide | `undefined`, `null`, `""` ou un tableau vide bloquent l'envoi. |
+
+`handle.validate()` résout `true` ou `false`. Il ne lance pas.
+
+## Préconditions
+
+Importez `style.css` une fois. En développement, l'absence de `--auto-text` avertit `RAC-CSS-MISSING`. `AutoConfigProvider` est optionnel et ne fournit pas les boîtes de dialogue.

package/docs/i18n/fr/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** | [Deutsch](../de/auto-menu.md) | [Português (Brasil)](../pt-BR/auto-menu.md) | [Русский](../ru/auto-menu.md)
+
+Barre latérale. Pour des panneaux, [AutoTabs](auto-tabs.md).
+
+## Comportement et props
+
+| Prop | Comportement |
+| --- | --- |
+| `items` | `id` unique dans l'arbre. `hidden` et un `canAccess` refusé écartent l'entrée. Un `children` qui pointe vers un ancêtre est écarté en entier pour qu'un mauvais schéma ne parte pas en récursion. |
+| `value` | Id de la feuille choisie. Omis : la sélection reste interne. |
+| `onChange(id, item, path)` | **Non capturé.** `path` est la chaîne d'ids de la racine à la feuille. Un parent avec enfants bascule l'expansion et n'est pas sélectionné. |
+| `collapsible` | Défaut `false`. Si `collapsed` est contrôlé, mettez-le à jour dans `onCollapsedChange` sinon le rail ne bouge pas. **`onCollapsedChange` n'est pas capturé.** |
+| `disabled` | Désactive l'entrée et ses descendants. La sélection les saute. |
+
+Choisir une feuille ne navigue pas tout seul. Le seul signal est `onChange`.
+
+## Préconditions
+
+Importez `style.css` une fois. `AutoConfigProvider` est optionnel. Les permissions passent par `config.canAccess`.
+
+Importez une fois au point d’entrée de l’application `import "@zeroman.yang/react-auto-components/style.css"`. Sans feuille de styles, le mode développement signale `RAC-CSS-MISSING`.

package/docs/i18n/fr/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** | [Deutsch](../de/auto-search.md) | [Português (Brasil)](../pt-BR/auto-search.md) | [Русский](../ru/auto-search.md)
+
+Formulaire de recherche. Il dessine un `AutoForm` et émet un `QueryNode` plus les valeurs. Un rappel de champ qui lance suit [AutoForm](auto-form.md).
+
+`AutoSearchPanel` et `AutoSearchPanelProps` sont des alias dépréciés de `AutoSearch` et `AutoSearchProps`.
+
+## Comportement et props
+
+| Prop | Comportement |
+| --- | --- |
+| `onSearch(query, values)` | Obligatoire. **Lancer ou rejeter : le formulaire interne capture, les valeurs restent, `error.message` s'affiche. Pas de reset.** |
+| `mode` | Défaut `"manual"` (bouton). `"instant"` cherche aussi à chaque changement. |
+| `columns` | Défaut `3`. |
+| `more: true` | Cache le champ jusqu'à « Plus ». Les champs cachés ne vont pas dans la requête. |
+
+| `match` | Valeur |
+| --- | --- |
+| omis | `"eq"`, ou `"in"` si la valeur est un tableau. |
+| `"contains"` | Sous-chaîne. `ignoreCase: true` ignore la casse. |
+| `"between"` | `[from, to]`. Un scalaire avertit `RAC-FIELD-BETWEEN` et ne correspond à aucune ligne. |
+| `"isNull"` | Correspond à null ou undefined. La valeur saisie est ignorée. |
+| vide | `undefined`, `null`, `""` et les tableaux vides sont omis, sauf `"isNull"`. |
+
+Reset restaure `defaultValue` puis cherche. `serializeRsql` lance `RAC-QUERY-FIELD` si le nom n'est pas `/^[\w.]+$/`.
+
+## Préconditions
+
+Importez `style.css` une fois. `AutoConfigProvider` est optionnel.
+
+Importez une fois au point d’entrée de l’application `import "@zeroman.yang/react-auto-components/style.css"`. Sans feuille de styles, le mode développement signale `RAC-CSS-MISSING`.

package/docs/i18n/fr/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** | [Deutsch](../de/auto-table.md) | [Português (Brasil)](../pt-BR/auto-table.md) | [Русский](../ru/auto-table.md)
+
+Tableau local ou distant. Fournissez exactement un de `data`, `dataSource` ou `source` ; en combiner plusieurs est une erreur de type. La recherche suit [AutoSearch](auto-search.md). Ajout et édition suivent [AutoDialog](auto-dialog.md) et [AutoForm](auto-form.md).
+
+`exportXlsx` vient de `@zeroman.yang/react-auto-components/xlsx`. `exceljs` est optionnel (`RAC-XLSX-DEP` s'il manque).
+
+## Comportement et props
+
+| Prop | Comportement |
+| --- | --- |
+| `id` | Obligatoire. La clé est `${namespace}:table:${id}`. Vide : `RAC-TABLE-ID`. |
+| `rowKey` | Unique sur les lignes chargées. Manquant ou doublon : `RAC-TABLE-ROWID`. Sélection, expansion et `scrollToRow` l'utilisent. |
+| `dataSource` | **Rejeter : message et bouton réessayer. L'abandon est ignoré.** `total` est le compte filtré complet, pas la longueur de la page. |
+| `pageSize` | Défaut `10`. `pagination` défaut `true`. `height` défaut `440`. `"auto"` remplit un parent qui a déjà une hauteur. |
+| `onAdd`, `onEdit`, `onDelete` | **Rejeter ou lancer : la boîte reste ouverte et montre `error.message`.** Les lignes ne changent que si votre handler les a déjà changées. |
+| `rowActions` | Le rejet de `onClick` est intercepté et affiché dans la ligne d’état pendant environ 2,5 secondes. La ligne reste présente. Si une action de ligne n’a pas de `onClick` et que son `action` n’est pas une clé connue de `config.rowActions`, sa sélection affiche `RAC-ROW-ACTION` dans la ligne d’état. Fournissez `onClick` ou enregistrez la clé d’`action`. Si les deux existent, `onClick` est prioritaire. |
+| `component` | Si le `component` d’une colonne ne figure pas dans `config.columns` d’`AutoConfigProvider`, le mode développement signale `RAC-COLUMN-COMPONENT` et la cellule garde le format par défaut. Enregistrez la clé ou définissez `render`, `format` ou `sort` sur la colonne. Les fonctions de la colonne sont prioritaires. |
+| `source` | `source` désigne une clé de `config.sources` dans `AutoConfigProvider`. Une clé inconnue affiche `RAC-TABLE-SOURCE` avec un bouton de nouvelle tentative. Enregistrez cette clé ou utilisez `data` / `dataSource`. Fournissez exactement une des trois options. |
+| `exportXlsx` | Nécessaire seulement pour xlsx. Absent : `RAC-TABLE-XLSX`. CSV et JSON sont intégrés. |
+
+`handle.export` résout même si l'état montre une erreur ; il ne relance pas. `"filtered"` distant parcourt toutes les pages. Une page vide avant la dernière lance `RAC-TABLE-EXPORT-PAGE` et ne télécharge pas de fichier partiel.
+
+Un JSON de filtre invalide montre le texte traduit, avertit `RAC-TABLE-FILTER` et garde le filtre précédent. `between` a la longueur 2. `in` est un tableau.
+
+`handle.reset()` efface tri, filtre et sélection et remet la disposition sur les colonnes. `scrollToRow` ne fait rien si l'id n'est pas chargé.
+
+## Préconditions
+
+Importez `style.css` une fois. Séparez `namespace` si plusieurs applications sur la même origine persistent des tableaux ; le défaut est `"auto"`. Les boîtes d'ajout et d'édition n'ont pas besoin de `AutoDialogProvider`. Seul `useAutoDialog()` en a besoin.

package/docs/i18n/fr/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** | [Deutsch](../de/auto-tabs.md) | [Português (Brasil)](../pt-BR/auto-tabs.md) | [Русский](../ru/auto-tabs.md)
+
+Onglets. L'imbrication est un autre `AutoTabs` nourri par `children`. Pour une barre latérale, [AutoMenu](auto-menu.md).
+
+## Comportement et props
+
+| Prop | Comportement |
+| --- | --- |
+| `items` | Chaque onglet a un `id` stable. `hidden` et un `canAccess` refusé le retirent. |
+| `value` | Chemin contrôlé d'ids depuis la racine. L'imbrication est `["parent", "child"]`. |
+| `onChange(path, item)` | **Non capturé.** S'il lance, React signale l'erreur. En mode contrôlé, le chemin non validé reste le précédent. |
+| `mode` | Défaut `"horizontal"`. `"vertical"` empile la liste. |
+| `keepMounted` | Défaut `true` : les panneaux inactifs restent montés. `false` les démonte. |
+| `onRefresh` | S'il est défini, un bouton d'actualisation apparaît. **Non capturé.** |
+| `disabled` | Reste visible et ne peut pas être choisi. La sélection par défaut saute les onglets désactivés. |
+
+## Préconditions
+
+Importez `style.css` une fois (`RAC-CSS-MISSING` en développement). `AutoConfigProvider` est optionnel.
+
+## Onglets dynamiques
+
+`useAutoTabsWorkspace` ouvre et ferme des pages sans routeur. Passez `tabsProps` à `AutoTabs`. Rappeler `open` avec le même id sélectionne seulement cet onglet et garde le brouillon. Un onglet épinglé ne se ferme pas. Attendez `ready` avant `open`. La sélection, `params` et `state` reviennent de `sessionStorage` après le montage. Si `beforeClose` renvoie `false` ou lance, la fermeture est annulée. L'exemple est dans [DynamicTabsDemo.tsx](../../../test-project/src/examples/DynamicTabsDemo.tsx).

package/docs/i18n/fr/errors.md

@@ -0,0 +1,110 @@
+# Codes d'erreur
+
+[English](../../errors.md) | [简体中文](../zh-CN/errors.md) | [繁體中文](../zh-TW/errors.md) | [日本語](../ja/errors.md) | [한국어](../ko/errors.md) | [Español](../es/errors.md) | **Français** | [Deutsch](../de/errors.md) | [Português (Brasil)](../pt-BR/errors.md) | [Русский](../ru/errors.md)
+
+Les échecs développeur lancent `RacError` ou appellent `console.warn` en développement. Le texte est toujours en anglais.
+
+```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-…
+```
+
+Le texte d'interface reste sur `config.t`. `userKey` est la phrase source en anglais, traduite par l'hôte. La console et l'exception restent en anglais.
+
+## RAC-FIELD-OPTIONS
+
+`type` vaut `select`, `select-v2`, `radio`, `checkbox` ou `cascader`, et `options` manque ou est vide.
+
+Correctif: Passez `options` en tableau ou `(values) => Option[]`. `autocomplete` peut les omettre.
+
+## RAC-FIELD-RANGE
+
+`daterange` ou `datetimerange` n'a pas une valeur à deux éléments.
+
+Correctif: Typez le champ en `[start, end]`. `dateValue` vaut `"string"` par défaut. `"timestamp"` stocke des millisecondes locales. `null` laisse le bout ouvert. Un scalaire est une erreur TypeScript. Un tableau dans le modèle compile ; le mode dev avertit si la longueur réelle n'est pas 2.
+
+## RAC-FIELD-BETWEEN
+
+`match: "between"` n'est pas `[from, to]`.
+
+Correctif: Stockez une paire. Un scalaire ne correspond à aucune ligne. C'est aussi une erreur de type sur `Field<T>`.
+
+## RAC-FIELD-CUSTOM
+
+`type: "custom"` n'a ni `render` ni `component`.
+
+Correctif: Passez `render(context)` ou une clé `component` de `config.fields`.
+
+## RAC-FIELD-DUPLICATE
+
+Deux champs ont le même `name`. `defaults` le lance au montage.
+
+Correctif: Des noms uniques. `title`, `tip`, `append` et `button` n'ont pas de nom.
+
+## RAC-CSS-MISSING
+
+En développement, `--auto-text` est absent de `:root`. Sans feuille de style la page est cassée et le DOM ne l'explique pas.
+
+Correctif: Une fois : `import "@zeroman.yang/react-auto-components/style.css"`.
+
+## RAC-TABLE-XLSX
+
+`export("xlsx")` sans `exportXlsx`.
+
+Correctif: Importez `{ exportXlsx }` depuis `@zeroman.yang/react-auto-components/xlsx`. L'UI affiche la phrase traduite.
+
+## RAC-XLSX-DEP
+
+`exceljs` n'a pas pu être chargé. C'est une `optionalDependency`.
+
+Correctif: `pnpm add exceljs`. CSV et JSON n'en ont pas besoin.
+
+## RAC-TABLE-EXPORT-PAGE
+
+Une page distante est vide avant la dernière. Aucun fichier partiel n'est enregistré.
+
+Correctif: Renvoyez un `total` stable et les lignes de ce `pageIndex`.
+
+## RAC-TABLE-ROWID
+
+`rowKey` manque ou se répète sur les lignes chargées.
+
+Correctif: Chaque ligne a une chaîne stable et unique.
+
+## RAC-TABLE-ID
+
+`id` est vide. La clé serait `${namespace}:table:`.
+
+Correctif: Passez un id stable par tableau.
+
+## RAC-COLUMN-COMPONENT
+
+Si le `component` d’une colonne ne figure pas dans `config.columns` d’`AutoConfigProvider`, le mode développement signale `RAC-COLUMN-COMPONENT` et la cellule garde le format par défaut. Enregistrez la clé ou définissez `render`, `format` ou `sort` sur la colonne. Les fonctions de la colonne sont prioritaires.
+
+## RAC-ROW-ACTION
+
+Si une action de ligne n’a pas de `onClick` et que son `action` n’est pas une clé connue de `config.rowActions`, sa sélection affiche `RAC-ROW-ACTION` dans la ligne d’état. Fournissez `onClick` ou enregistrez la clé d’`action`. Si les deux existent, `onClick` est prioritaire.
+
+## RAC-TABLE-SOURCE
+
+`source` désigne une clé de `config.sources` dans `AutoConfigProvider`. Une clé inconnue affiche `RAC-TABLE-SOURCE` avec un bouton de nouvelle tentative. Enregistrez cette clé ou utilisez `data` / `dataSource`. Fournissez exactement une des trois options.
+
+## RAC-TABLE-FILTER
+
+Le JSON du filtre n'est pas une requête. Le texte traduit s'affiche et l'ancien filtre reste.
+
+Correctif: Groupe `{ kind: "group", operator, children }`. Condition `{ kind: "condition", field, operator, value }`. `between` vaut `[from, to]`.
+
+## RAC-QUERY-FIELD
+
+`serializeRsql` refuse un nom hors `/^[\\w.]+$/`.
+
+Correctif: Lettres, chiffres, underscore et points seulement.
+
+## RAC-DIALOG-PROVIDER
+
+`useAutoDialog()` hors de `AutoDialogProvider`.
+
+Correctif: Enveloppez l'arbre avec `<AutoDialogProvider>`. `AutoConfigProvider` ne fournit pas les boîtes de dialogue et reste optionnel. `<AutoDialog open>` n'utilise pas ce hook.

package/docs/i18n/ja/README.md

@@ -12,10 +12,14 @@ React 19 向けのスタンドアローンなスキーマ駆動コンポーネ
 
 ## プロジェクトの状況
 
-現在のバージョンは 0.1.1 であり、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 dependency は 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 出力で `exportXlsx` アダプターがない場合は `RAC-TABLE-XLSX`、任意依存の `exceljs` を読み込めない場合は `RAC-XLSX-DEP` です。`@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/ja/CONTRIBUTING.md)
 - [変更履歴](https://github.com/Zeroman/react-auto-components/blob/main/docs/i18n/ja/CHANGELOG.md)
@@ -85,7 +89,7 @@ t コールバックはメッセージキーとフォールバックを受け取
 | コンポーネント | 機能 |
 | --- | --- |
 | AutoForm | ネイティブフィールド型、選択肢の仮想化、連動選択、アップロードアダプター、カスタムレンダリング、依存フィールド、条件付き表示、非同期バリデーション、制御された状態、失敗後の入力保持 |
-| AutoSearchPanel | 基本／詳細条件、手動／即時検索、リセット、ソートタグ、共有クエリ AST、RSQL シリアライズ |
+| AutoSearch | 基本／詳細条件、手動／即時検索、リセット、ソートタグ、共有クエリ AST、RSQL シリアライズ |
 | AutoTable | ローカル／リモートデータ、複数列ソート、列フィルター、ページネーション、安定した選択状態、仮想化、ツリー／詳細の展開、集計、セル結合、CRUD、コンテキストメニュー、コピー |
 | AutoDialog | 宣言的／命令的 API、分離されたプロバイダー、下書き、閉じる操作のガード、フォーカス管理、ドラッグ、全画面表示、非同期送信 |
 | AutoTabs | 横／縦レイアウト、入れ子、権限、タブの無効化、パネル状態の保持、更新 |
@@ -201,3 +205,5 @@ pnpm test:e2e
 AutoChat は、ストリーミング追従、履歴の読み込み、コンポーザーを備えた軽量な会話レイアウトを提供します。メッセージの表示には React コンテンツか renderMessage を指定でき、追加のランタイム依存関係は不要です。
 
 [AutoChat API](auto-chat.md)
+
+コールバックが throw したあとコンポーネントがどう扱うかは、振る舞いの契約を見てください：[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/ja/auto-dialog.md

@@ -0,0 +1,23 @@
+# AutoDialog
+
+[English](../../auto-dialog.md) | [简体中文](../zh-CN/auto-dialog.md) | [繁體中文](../zh-TW/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) | [Русский](../ru/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` は全画面中は無視します。 |
+
+`open()` の `close()` は、`beforeClose` が止めたとき `false` を resolve します。命令的ダイアログは重ねられます。
+
+## 前提
+
+`style.css` を一度。`AutoConfigProvider` は任意で、`AutoDialogProvider` の代わりにはなりません。`namespace` は `draftKey` のキーに入ります。