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

package/docs/auto-tabs.md

@@ -0,0 +1,99 @@
+# AutoTabs
+
+**English** | [简体中文](i18n/zh-CN/auto-tabs.md) | [繁體中文](i18n/zh-TW/auto-tabs.md) | [日本語](i18n/ja/auto-tabs.md) | [한국어](i18n/ko/auto-tabs.md) | [Español](i18n/es/auto-tabs.md) | [Français](i18n/fr/auto-tabs.md) | [Deutsch](i18n/de/auto-tabs.md) | [Português (Brasil)](i18n/pt-BR/auto-tabs.md) | [Русский](i18n/ru/auto-tabs.md)
+
+Tab list. Nested tabs are another `AutoTabs` fed by `children`, not a menu. Use [AutoMenu](auto-menu.md) for a sidebar.
+
+## Usage
+
+```tsx
+import { AutoTabs } from "@zeroman.yang/react-auto-components";
+import "@zeroman.yang/react-auto-components/style.css";
+
+<AutoTabs
+  items={[
+    { id: "one", label: "One", content: <p>First</p> },
+    { id: "two", label: "Two", content: <p>Second</p>, disabled: true },
+  ]}
+/>
+```
+
+## Behavior and props
+
+| Prop | Behavior |
+| --- | --- |
+| `items` | Each tab needs a stable `id`. `hidden` (boolean or function) and a failed `canAccess` remove the tab. |
+| `value` | Controlled path of ids from the root. Nested selection is `["parent", "child"]`. |
+| `defaultValue` | Uncontrolled initial path. |
+| `onChange(path, item)` | **Not caught.** If it throws, React reports the error and the last committed path stays when the component is controlled by you. |
+| `mode` | Default `"horizontal"`. `"vertical"` stacks the tab list. |
+| `keepMounted` | Default `true`: inactive panels stay mounted and keep local state. `false` unmounts them. |
+| `onRefresh` | When set, a refresh button is rendered for that tab. **Not caught.** |
+| `loading` | Appends an ellipsis to the tab label. It does not block selection. |
+| `size`, `density` | Override the provider. Tabs read `config.tabs`, then `config.density` / `config.size`. |
+| `disabled` | The tab stays visible and cannot be selected. The default selection skips disabled tabs. |
+| `closable` | With `onClose`, the tab shows a close button. Delete on the focused tab requests the same close. |
+| `onClose(path, item)` | Asks the owner to remove the tab. **Not caught.** Nested groups pass the full path. The owner updates `items`. |
+| `lazy` | Default `false`. `true` mounts a panel on its first visit. |
+
+A nested `children` list replaces `content` for that tab. `defaultActive` is the nested uncontrolled id.
+
+## Dynamic tabs
+
+`useAutoTabsWorkspace` keeps a flat set of pages without a router. Spread `tabsProps` onto `AutoTabs`. `open` adds a page, or activates one that is already open and keeps its draft.
+
+```tsx
+import {
+  AutoTabs,
+  useAutoTabsWorkspace,
+} from "@zeroman.yang/react-auto-components";
+
+const pages = {
+  home: { title: "Home", render: () => <p>Pinned</p> },
+  order: {
+    title: "Order",
+    render: ({ tab, setState }) => (
+      <input
+        aria-label="Draft"
+        value={typeof tab.state === "string" ? tab.state : ""}
+        onChange={(event) => setState(event.target.value)}
+      />
+    ),
+  },
+};
+
+export function Orders() {
+  const workspace = useAutoTabsWorkspace({
+    workspaceId: "orders",
+    pages,
+    defaultTabs: [{ id: "home", page: "home", pinned: true }],
+  });
+  return (
+    <>
+      <button
+        type="button"
+        disabled={!workspace.ready}
+        onClick={() =>
+          workspace.open({
+            id: "order:1",
+            page: "order",
+            title: "Order 1",
+            params: { orderId: "1" },
+          })
+        }
+      >
+        Open order
+      </button>
+      {workspace.ready && <AutoTabs {...workspace.tabsProps} />}
+    </>
+  );
+}
+```
+
+A pinned tab has no close button. Closing the active tab selects the next enabled neighbor. `beforeClose` returning `false`, or throwing, cancels the close. A throw from the close button is shown with `config.notify`. Tabs, the selection, `params`, and `state` are restored from `sessionStorage` after mount. Wait for `ready` before calling `open`. `storage: false` keeps the workspace in memory. `"local"` or a storage adapter chooses another store. The key is `${namespace}:tabs:${workspaceId}`.
+
+`tabsProps` sets `lazy` and `keepMounted`, so a panel mounts on its first visit and then stays mounted. The component does not remove a tab by itself. `onClose` asks the workspace to remove it.
+
+## Preconditions
+
+Import `style.css` once (`RAC-CSS-MISSING` in development). `AutoConfigProvider` is optional.

package/docs/errors.md

@@ -0,0 +1,118 @@
+# Error codes
+
+**English** | [简体中文](i18n/zh-CN/errors.md) | [繁體中文](i18n/zh-TW/errors.md) | [日本語](i18n/ja/errors.md) | [한국어](i18n/ko/errors.md) | [Español](i18n/es/errors.md) | [Français](i18n/fr/errors.md) | [Deutsch](i18n/de/errors.md) | [Português (Brasil)](i18n/pt-BR/errors.md) | [Русский](i18n/ru/errors.md)
+
+Developer failures throw `RacError` or call `console.warn` in development. The message is always:
+
+```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-…
+```
+
+User-visible sentences stay on `config.t`. A `RacError` may carry `userKey`, the English source string the host translates. The console and the exception stay English.
+
+## RAC-FIELD-OPTIONS
+
+`type` is `select`, `select-v2`, `radio`, `checkbox`, or `cascader`, and `options` is missing or an empty array.
+
+Fix: pass `options` as an array or as `(values) => Option[]`. `autocomplete` may omit options; it is a text box with optional suggestions.
+
+## RAC-FIELD-RANGE
+
+`type` is `daterange` or `datetimerange`, and the model field or the current value is not a two-item array.
+
+Fix: type the field as `[start, end]` (`Pair`, or `[string, string]`, or `[number, number]` for timestamps). `dateValue` defaults to `"string"` (`YYYY-MM-DD`). `"timestamp"` stores epoch milliseconds. `null` is an open end.
+
+A scalar string or number is a TypeScript error (`RAC-FIELD-RANGE` in the message). An array-typed model compiles; development mode warns when a real value does not have length 2.
+
+## RAC-FIELD-BETWEEN
+
+`match: "between"` is set and the model field or the current value is not `[from, to]`.
+
+Fix: store a two-item tuple. A scalar does not match rows. The same rule is a TypeScript error on `Field<T>`.
+
+## RAC-FIELD-CUSTOM
+
+`type: "custom"` has neither `render` nor `component`.
+
+Fix: pass `render(context)` or `component` set to a key in `AutoConfigProvider` `config.fields`.
+
+## RAC-FIELD-DUPLICATE
+
+Two fields share a `name`. Thrown from `defaults` while the form mounts.
+
+Fix: unique names. `title`, `tip`, `append`, and `button` have no name and are skipped.
+
+## RAC-CSS-MISSING
+
+Development mode did not find `--auto-text` on `:root`. The stylesheet sets that variable. Without it the page looks unstyled and the DOM does not say why.
+
+Fix: `import "@zeroman.yang/react-auto-components/style.css"` once in the app entry.
+
+## RAC-TABLE-XLSX
+
+`export("xlsx")` ran and `exportXlsx` was not passed.
+
+Fix: `import { exportXlsx } from "@zeroman.yang/react-auto-components/xlsx"` and pass `exportXlsx={exportXlsx}`. The UI still shows the translated "Configure the XLSX export adapter".
+
+## RAC-XLSX-DEP
+
+The xlsx adapter could not load `exceljs`. It is an `optionalDependency`, so a normal install can skip it.
+
+Fix: `pnpm add exceljs`. CSV and JSON do not need it.
+
+## RAC-TABLE-EXPORT-PAGE
+
+A remote export page was empty before the last page, so the file was not saved.
+
+Fix: return a stable `total` and the rows for that `pageIndex`. The UI shows the translated "Export data is incomplete. Try again."
+
+## RAC-TABLE-ROWID
+
+`rowKey` was missing or repeated on a loaded row. Development warning.
+
+Fix: every row needs a stable unique string. Selection, expansion, and `scrollToRow` use it.
+
+## RAC-TABLE-ID
+
+`AutoTable` `id` is empty, so settings would be stored at `${namespace}:table:`. Development warning.
+
+Fix: pass a stable id per table.
+
+## RAC-COLUMN-COMPONENT
+
+A column `component` is not in `config.columns`. Development warning. The cell keeps the default format.
+
+Fix: add that key to `AutoConfigProvider` `config.columns`, or set `render`, `format`, or `sort` on the column. A function on the column wins over the registry.
+
+## RAC-ROW-ACTION
+
+A row action has neither `onClick` nor a known `action` key. The status shows this message when the item is chosen.
+
+Fix: pass `onClick`, or `action` set to a key in `config.rowActions`. `onClick` wins when both are set.
+
+## RAC-TABLE-SOURCE
+
+`AutoTable` `source` is not in `config.sources`. The table shows this message and a retry button.
+
+Fix: add that key to `config.sources`, or pass `data` / `dataSource` instead. Pass only one of the three.
+
+## RAC-TABLE-FILTER
+
+The settings filter JSON is not a query. The translated "Invalid filter" stays on screen and the previous filter is kept.
+
+Fix: a group is `{ kind: "group", operator: "and" | "or", children }`. A condition is `{ kind: "condition", field, operator, value }` where `field` is a column key. `between` value is `[from, to]`. `in` value is an array.
+
+## RAC-QUERY-FIELD
+
+`serializeRsql` refused a field name that is not `/^[\w.]+$/`.
+
+Fix: letters, digits, underscore, and dots only. Rename the column or map it before serializing.
+
+## RAC-DIALOG-PROVIDER
+
+`useAutoDialog()` ran outside `AutoDialogProvider`.
+
+Fix: wrap that tree in `<AutoDialogProvider>`. `AutoConfigProvider` does not provide dialogs and is optional. The declarative `<AutoDialog open>` does not use this hook.

package/docs/i18n/de/README.md

@@ -12,10 +12,14 @@ Eine eigenständige, schema-getriebene Komponentenbibliothek für React 19 – m
 
 ## Projektstatus
 
-Die aktuelle Version ist 0.1.2, und die APIs können sich noch ändern. React 19 wird vorausgesetzt. Das Paket stellt ESM- und TypeScript-Deklarationen bereit. Der eingebaute Oberflächentext ist standardmäßig Chinesisch und kann über AutoConfigProvider.config.t übersetzt werden.
+Die aktuelle Version ist 0.1.3, und die APIs können sich noch ändern. React 19 wird vorausgesetzt. Das Paket stellt ESM- und TypeScript-Deklarationen bereit. Der eingebaute Oberflächentext ist standardmäßig Englisch und kann über AutoConfigProvider.config.t übersetzt werden.
 
 Installation mit `pnpm add @zeroman.yang/react-auto-components` (npm und yarn funktionieren ebenso). Peer Dependencies sind React 19 und react-dom 19. Importieren Sie das Stylesheet einmal: `import "@zeroman.yang/react-auto-components/style.css"`.
 
+Importiere einmal im App-Einstieg `import "@zeroman.yang/react-auto-components/style.css"`. Ohne Stylesheet erscheint in der Entwicklung `RAC-CSS-MISSING`.
+
+Beim XLSX-Export bedeutet `RAC-TABLE-XLSX`, dass der Adapter `exportXlsx` fehlt; `RAC-XLSX-DEP` bedeutet, dass die optionale Abhängigkeit `exceljs` nicht geladen werden konnte. Importiere und übergib den Adapter aus `@zeroman.yang/react-auto-components/xlsx`; installiere bei Bedarf mit `pnpm add exceljs`. CSV und JSON benötigen ihn nicht.
+
 - [Live-Demo (GitHub Pages)](https://zeroman.github.io/react-auto-components/)
 - [Mitwirken](https://github.com/Zeroman/react-auto-components/blob/main/docs/i18n/de/CONTRIBUTING.md)
 - [Änderungsprotokoll](https://github.com/Zeroman/react-auto-components/blob/main/docs/i18n/de/CHANGELOG.md)
@@ -85,7 +89,7 @@ Der t-Callback erhält einen Nachrichtenschlüssel und einen Fallback-Text. Numm
 | Komponente | Funktionen |
 | --- | --- |
 | AutoForm | Native Feldtypen, virtualisierte Optionen, kaskadierende Auswahl, Upload-Adapter, benutzerdefinierte Darstellung, abhängige Felder, bedingte Sichtbarkeit, asynchrone Validierung, kontrollierter Zustand, Erhalt von Eingaben nach Fehlern |
-| AutoSearchPanel | Einfache/erweiterte Bedingungen, manuelle/sofortige Suche, Zurücksetzen, Sortier-Tags, gemeinsamer Abfrage-AST und RSQL-Serialisierung |
+| AutoSearch | Einfache/erweiterte Bedingungen, manuelle/sofortige Suche, Zurücksetzen, Sortier-Tags, gemeinsamer Abfrage-AST und RSQL-Serialisierung |
 | AutoTable | Lokale/entfernte Daten, Mehrspaltensortierung, Spaltenfilter, Paginierung, stabile Auswahl, Virtualisierung, Aufklappen von Bäumen/Details, Zusammenfassungen, verbundene Zellen, CRUD, Kontextmenüs und Kopieren |
 | AutoDialog | Deklarative/imperative APIs, isolierte Provider, Entwürfe, Schließschutz, Fokusverwaltung, Ziehen, Vollbild und asynchrones Absenden |
 | AutoTabs | Horizontale/vertikale Layouts, Verschachtelung, Berechtigungen, deaktivierte Tabs, Erhalt des Panelzustands und Aktualisierung |
@@ -201,3 +205,5 @@ Formulare unterstützen `resetLabel`, `extraActions` und `onReset`; Suchpanels u
 AutoChat bietet ein leichtgewichtiges Unterhaltungs-Layout mit Stream-Follow, Verlaufsladen und einem Eingabebereich. Für das Rendern der Nachrichten übergibst du React-Inhalte oder renderMessage; zusätzliche Laufzeit-Abhängigkeiten sind nicht erforderlich.
 
 [AutoChat API](auto-chat.md)
+
+Was die Komponente tut, wenn ein Callback wirft: [AutoForm](auto-form.md), [AutoSearch](auto-search.md), [AutoTable](auto-table.md), [AutoDialog](auto-dialog.md), [AutoTabs](auto-tabs.md), [AutoMenu](auto-menu.md). Fehlercodes für Entwickler: [errors.md](errors.md).

package/docs/i18n/de/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** | [Português (Brasil)](../pt-BR/auto-dialog.md) | [Русский](../ru/auto-dialog.md)
+
+Modaldialog, deklarativ (`<AutoDialog open>`) oder imperativ (`useAutoDialog().open()`). `fields` zeichnet ein [AutoForm](auto-form.md).
+
+`useAutoDialog()` außerhalb des Providers wirft `RAC-DIALOG-PROVIDER`. `<AutoDialog open>` braucht den Provider nicht.
+
+## Verhalten und Props
+
+| Prop | Verhalten |
+| --- | --- |
+| `onSubmit(values)` | Nach der Prüfung. **Ablehnen oder werfen: der Dialog bleibt offen, zeigt `error.message`, Werte bleiben.** Nach resolve läuft `beforeClose` noch. |
+| `beforeClose(reason)` | `"submit"`, `"cancel"` oder `"close"`. **`false` lässt ihn offen. Werfen lässt ihn ebenfalls offen und zeigt die Meldung.** |
+| `onClose` | Nur nachdem wirklich geschlossen wurde. |
+| `draftKey` | Speichert den Entwurf unter `${namespace}:draft:${draftKey}`, bis das Absenden gelingt. Weggelassen wird nichts gespeichert. |
+| `width` | Standard `560`. `draggable` wird im Vollbild ignoriert. |
+
+`close()` von `open()` resolved `false`, wenn `beforeClose` das Schließen blockiert. Imperative Dialoge stapeln sich.
+
+## Voraussetzungen
+
+`style.css` einmal importieren. `AutoConfigProvider` ist optional und ersetzt `AutoDialogProvider` nicht. `namespace` gehört zum Entwurfsschlüssel.

package/docs/i18n/de/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** | [Português (Brasil)](../pt-BR/auto-form.md) | [Русский](../ru/auto-form.md)
+
+Schema-Formular. `AutoSearch` und `AutoDialog` zeichnen ein `AutoForm`, deshalb gelten diese Callback-Regeln auch dort.
+
+`Field<T>` ist eine nach `type` unterschiedene Union. `select` ohne `options`, ein Skalar bei `daterange` und `match: "between"` auf einem Skalar sind TypeScript-Fehler. `AnyField` und `unsafeField()` sind der Ausweg; der Entwicklungsmodus warnt weiter. Codes in [errors.md](errors.md).
+
+## Verhalten und Props
+
+| Prop | Verhalten |
+| --- | --- |
+| `fields` | `readonly Field<T>[]`. Ohne `type` ist es ein Textfeld. Ein doppelter `name` wirft beim Einhängen `RAC-FIELD-DUPLICATE`. |
+| `value` | Kontrollierter Wert. Weicht er vom inneren Zustand ab, kopiert das Formular ihn und löscht Fehler. Ignoriert der Parent `onChange`, springt die Eingabe zurück. |
+| `onSubmit(value)` | Nur nach bestandener Prüfung. **Ablehnen oder werfen: Werte bleiben, `error.message` wird gezeigt, kein Reset.** |
+| `columns` | Standard `2`. `actions` Standard `true`. |
+| Beschriftung | `labelPosition` Standard `"top"`. `labelWidth` Standard `"auto"` (gemessen, höchstens 45 % der Feldbreite). |
+
+## Wenn ein Callback wirft
+
+| Callback | Ergebnis |
+| --- | --- |
+| `onSubmit` | Gefangen. Entwurf bleibt. Meldung wird gezeigt. Kein Reset. |
+| Feld-`rules` | Die geworfene Meldung wird der Feldfehler. Spätere Regeln laufen nicht. |
+| Feld-`onChange` | Nicht gefangen. Der vorige Wert bleibt. |
+| `upload` | Ablehnung steht unter dem Feld, nichts wird gespeichert. `reset()` bricht das Signal ab und verwirft ein spätes Ergebnis. |
+| Absenden während eines Uploads | `validate()` liefert `false` und ruft `onSubmit` nicht auf. |
+| `hidden`, `disabled` oder ohne Zugriff | Dieses Feld wird nicht geprüft, auch wenn es `required` ist. |
+| Leeres `required` | `undefined`, `null`, `""` oder ein leeres Array blockieren das Absenden. |
+
+`handle.validate()` resolved `true` oder `false`. Es wirft nicht.
+
+## Voraussetzungen
+
+`style.css` einmal importieren. Fehlt `--auto-text`, warnt die Entwicklung mit `RAC-CSS-MISSING`. `AutoConfigProvider` ist optional und mountet keine Dialoge.

package/docs/i18n/de/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** | [Português (Brasil)](../pt-BR/auto-menu.md) | [Русский](../ru/auto-menu.md)
+
+Seitenleiste. Für Panels [AutoTabs](auto-tabs.md).
+
+## Verhalten und Props
+
+| Prop | Verhalten |
+| --- | --- |
+| `items` | `id` ist im Baum eindeutig. `hidden` und ein gescheitertes `canAccess` verwerfen den Eintrag. Ein `children`, das auf einen Vorfahren zeigt, wird ganz verworfen, damit ein schlechtes Schema nicht rekursiert. |
+| `value` | Id des gewählten Blatts. Weggelassen bleibt die Auswahl intern. |
+| `onChange(id, item, path)` | **Nicht gefangen.** `path` ist die id-Kette von der Wurzel zum Blatt. Ein Elternteil mit Kindern schaltet nur die Aufklappung um und wird nicht gewählt. |
+| `collapsible` | Standard `false`. Ist `collapsed` kontrolliert, musst du es in `onCollapsedChange` selbst setzen, sonst bewegt sich die Leiste nicht. **`onCollapsedChange` wird nicht gefangen.** |
+| `disabled` | Deaktiviert den Eintrag und seine Nachkommen. Die Auswahl überspringt sie. |
+
+Ein Blatt zu wählen navigiert nicht von selbst. Das einzige Signal ist `onChange`.
+
+## Voraussetzungen
+
+`style.css` einmal importieren. `AutoConfigProvider` ist optional. Rechte laufen über `config.canAccess`.
+
+Importiere einmal im App-Einstieg `import "@zeroman.yang/react-auto-components/style.css"`. Ohne Stylesheet erscheint in der Entwicklung `RAC-CSS-MISSING`.

package/docs/i18n/de/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** | [Português (Brasil)](../pt-BR/auto-search.md) | [Русский](../ru/auto-search.md)
+
+Suchformular. Es zeichnet ein `AutoForm` und gibt einen `QueryNode` plus die Werte aus. Wirft ein Feld-Callback, gelten die Regeln von [AutoForm](auto-form.md).
+
+`AutoSearchPanel` und `AutoSearchPanelProps` sind veraltete Aliase von `AutoSearch` und `AutoSearchProps`.
+
+## Verhalten und Props
+
+| Prop | Verhalten |
+| --- | --- |
+| `onSearch(query, values)` | Pflicht. **Werfen oder ablehnen: das innere Formular fängt es, Werte bleiben, `error.message` wird gezeigt. Kein Reset.** |
+| `mode` | Standard `"manual"` (Schaltfläche). `"instant"` sucht auch bei jeder Änderung. |
+| `columns` | Standard `3`. |
+| `more: true` | Versteckt das Feld, bis „Mehr“ geöffnet wird. Versteckte Felder fehlen in der Abfrage. |
+
+| `match` | Wert |
+| --- | --- |
+| weggelassen | `"eq"`, oder `"in"` wenn der Wert ein Array ist. |
+| `"contains"` | Teilstring. `ignoreCase: true` ignoriert Großschreibung. |
+| `"between"` | `[from, to]`. Ein Skalar warnt `RAC-FIELD-BETWEEN` und trifft keine Zeile. |
+| `"isNull"` | Trifft null oder undefined. Der eingegebene Wert wird ignoriert. |
+| leer | `undefined`, `null`, `""` und leere Arrays entfallen, außer `"isNull"`. |
+
+Reset stellt `defaultValue` wieder her und sucht dann. `serializeRsql` wirft `RAC-QUERY-FIELD`, wenn der Name nicht `/^[\w.]+$/` ist.
+
+## Voraussetzungen
+
+`style.css` einmal importieren. `AutoConfigProvider` ist optional.
+
+Importiere einmal im App-Einstieg `import "@zeroman.yang/react-auto-components/style.css"`. Ohne Stylesheet erscheint in der Entwicklung `RAC-CSS-MISSING`.

package/docs/i18n/de/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** | [Português (Brasil)](../pt-BR/auto-table.md) | [Русский](../ru/auto-table.md)
+
+Lokale oder entfernte Tabelle. Übergib genau eine Variante: `data`, `dataSource` oder `source`. Mehrere zugleich sind ein Typfehler. Suche folgt [AutoSearch](auto-search.md). Anlegen und Bearbeiten folgen [AutoDialog](auto-dialog.md) und [AutoForm](auto-form.md).
+
+`exportXlsx` kommt aus `@zeroman.yang/react-auto-components/xlsx`. `exceljs` ist optional (`RAC-XLSX-DEP`, wenn es fehlt).
+
+## Verhalten und Props
+
+| Prop | Verhalten |
+| --- | --- |
+| `id` | Pflicht. Schlüssel ist `${namespace}:table:${id}`. Leer warnt `RAC-TABLE-ID`. |
+| `rowKey` | Eindeutig in den geladenen Zeilen. Fehlend oder doppelt: `RAC-TABLE-ROWID`. Auswahl, Aufklappen und `scrollToRow` nutzen ihn. |
+| `dataSource` | **Ablehnen: Meldung und Wiederholen-Schaltfläche. Abbruch wird ignoriert.** `total` ist die gesamte gefilterte Anzahl, nicht die Seitenlänge. |
+| `pageSize` | Standard `10`. `pagination` Standard `true`. `height` Standard `440`. `"auto"` füllt einen Elternteil, der schon eine Höhe hat. |
+| `onAdd`, `onEdit`, `onDelete` | **Ablehnen oder werfen: der Dialog bleibt offen und zeigt `error.message`.** Zeilen ändern sich nur, wenn dein Handler sie schon geändert hat. |
+| `rowActions` | Eine Ablehnung von `onClick` wird abgefangen und etwa 2,5 Sekunden in der Statuszeile angezeigt. Die Zeile bleibt erhalten. Fehlt einer Zeilenaktion `onClick` und ist `action` kein bekannter Schlüssel in `config.rowActions`, zeigt die Statuszeile beim Auswählen `RAC-ROW-ACTION`. Übergib `onClick` oder registriere den Schlüssel für `action`. Sind beide gesetzt, hat `onClick` Vorrang. |
+| `component` | Ist der Spaltenwert `component` nicht in `AutoConfigProvider` unter `config.columns` registriert, erscheint in der Entwicklung `RAC-COLUMN-COMPONENT`; die Zelle verwendet das Standardformat. Registriere den Schlüssel oder setze `render`, `format` oder `sort` auf der Spalte. Funktionen auf der Spalte haben Vorrang. |
+| `source` | `source` bezeichnet einen Schlüssel in `AutoConfigProvider` unter `config.sources`. Ein unbekannter Schlüssel zeigt `RAC-TABLE-SOURCE` mit einer Schaltfläche zum Wiederholen. Registriere ihn oder verwende `data` / `dataSource`. Übergib genau eine der drei Varianten. |
+| `exportXlsx` | Nur für xlsx nötig. Fehlt er, `RAC-TABLE-XLSX`. CSV und JSON sind eingebaut. |
+
+`handle.export` resolved auch wenn der Status einen Fehler zeigt; er wirft nicht erneut. Entferntes `"filtered"` geht alle Seiten durch. Eine leere Seite vor der letzten wirft `RAC-TABLE-EXPORT-PAGE` und lädt keine halbe Datei herunter.
+
+Ungültiges Filter-JSON zeigt den übersetzten Text, warnt `RAC-TABLE-FILTER` und behält den vorigen Filter. `between` hat die Länge 2. `in` ist ein Array.
+
+`handle.reset()` löscht Sortierung, Filter und Auswahl und setzt das Layout auf die Spalten zurück. `scrollToRow` tut nichts, wenn die id nicht geladen ist.
+
+## Voraussetzungen
+
+`style.css` einmal importieren. Trenne `namespace`, wenn mehrere Apps derselben Origin Tabellen speichern; Standard ist `"auto"`. Die eingebauten Dialoge zum Anlegen und Bearbeiten brauchen kein `AutoDialogProvider`. Nur `useAutoDialog()` braucht es.

package/docs/i18n/de/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** | [Português (Brasil)](../pt-BR/auto-tabs.md) | [Русский](../ru/auto-tabs.md)
+
+Reiter. Verschachtelte Reiter sind ein weiteres `AutoTabs` aus `children`. Für eine Seitenleiste [AutoMenu](auto-menu.md).
+
+## Verhalten und Props
+
+| Prop | Verhalten |
+| --- | --- |
+| `items` | Jeder Reiter braucht eine stabile `id`. `hidden` und ein gescheitertes `canAccess` entfernen ihn. |
+| `value` | Kontrollierter id-Pfad von der Wurzel. Verschachtelt ist `["parent", "child"]`. |
+| `onChange(path, item)` | **Nicht gefangen.** Wirft er, meldet React den Fehler. Im kontrollierten Modus bleibt der noch nicht übernommene Pfad beim vorigen. |
+| `mode` | Standard `"horizontal"`. `"vertical"` stapelt die Liste. |
+| `keepMounted` | Standard `true`: inaktive Panels bleiben eingehängt. `false` hängt sie aus. |
+| `onRefresh` | Wenn gesetzt, gibt es eine Aktualisieren-Schaltfläche. **Nicht gefangen.** |
+| `disabled` | Bleibt sichtbar und ist nicht wählbar. Die Standardauswahl überspringt deaktivierte Reiter. |
+
+## Voraussetzungen
+
+`style.css` einmal importieren (`RAC-CSS-MISSING` in der Entwicklung). `AutoConfigProvider` ist optional.
+
+## Dynamische Tabs
+
+`useAutoTabsWorkspace` öffnet und schließt Seiten ohne Router. Geben Sie `tabsProps` an `AutoTabs` weiter. `open` mit derselben id wählt nur diesen Tab und behält den Entwurf. Ein angehefteter Tab lässt sich nicht schließen. Warten Sie auf `ready`, bevor Sie `open` aufrufen. Auswahl, `params` und `state` kommen nach dem Mount aus `sessionStorage` zurück. Gibt `beforeClose` `false` zurück oder wirft es, bleibt der Tab offen. Das Beispiel steht in [DynamicTabsDemo.tsx](../../../test-project/src/examples/DynamicTabsDemo.tsx).

package/docs/i18n/de/errors.md

@@ -0,0 +1,110 @@
+# Fehlercodes
+
+[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** | [Português (Brasil)](../pt-BR/errors.md) | [Русский](../ru/errors.md)
+
+Entwicklerfehler werfen `RacError` oder rufen in der Entwicklung `console.warn` auf. Der Text ist immer Englisch.
+
+```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-…
+```
+
+Oberflächentext bleibt bei `config.t`. `userKey` ist der englische Quellsatz, den der Host übersetzt. Konsole und Ausnahme bleiben Englisch.
+
+## RAC-FIELD-OPTIONS
+
+`type` ist `select`, `select-v2`, `radio`, `checkbox` oder `cascader`, und `options` fehlt oder ist leer.
+
+Korrektur: Übergib `options` als Array oder `(values) => Option[]`. `autocomplete` darf sie weglassen.
+
+## RAC-FIELD-RANGE
+
+`daterange` oder `datetimerange` hat keinen Zwei-Element-Wert.
+
+Korrektur: Typisiere das Feld als `[start, end]`. `dateValue` ist standardmäßig `"string"`. `"timestamp"` speichert lokale Millisekunden. `null` lässt das Ende offen. Ein Skalar ist ein TypeScript-Fehler. Ein Array im Modell kompiliert; die Entwicklung warnt, wenn die echte Länge nicht 2 ist.
+
+## RAC-FIELD-BETWEEN
+
+`match: "between"` ist nicht `[from, to]`.
+
+Korrektur: Speichere ein Paar. Ein Skalar trifft keine Zeile. Auf `Field<T>` ist das ebenfalls ein Typfehler.
+
+## RAC-FIELD-CUSTOM
+
+`type: "custom"` hat weder `render` noch `component`.
+
+Korrektur: Übergib `render(context)` oder einen `component`-Schlüssel aus `config.fields`.
+
+## RAC-FIELD-DUPLICATE
+
+Zwei Felder teilen sich `name`. `defaults` wirft beim Einhängen.
+
+Korrektur: Eindeutige Namen. `title`, `tip`, `append` und `button` haben keinen Namen.
+
+## RAC-CSS-MISSING
+
+In der Entwicklung fehlt `--auto-text` auf `:root`. Ohne Stylesheet wirkt die Seite kaputt, und das DOM sagt nicht warum.
+
+Korrektur: Einmal: `import "@zeroman.yang/react-auto-components/style.css"`.
+
+## RAC-TABLE-XLSX
+
+`export("xlsx")` ohne `exportXlsx`.
+
+Korrektur: Importiere `{ exportXlsx }` aus `@zeroman.yang/react-auto-components/xlsx`. Die Oberfläche zeigt den übersetzten Satz.
+
+## RAC-XLSX-DEP
+
+`exceljs` ließ sich nicht laden. Es ist eine `optionalDependency`.
+
+Korrektur: `pnpm add exceljs`. CSV und JSON brauchen es nicht.
+
+## RAC-TABLE-EXPORT-PAGE
+
+Eine entfernte Seite war vor der letzten leer. Es wird keine halbe Datei gespeichert.
+
+Korrektur: Gib ein stabiles `total` und die Zeilen dieser `pageIndex` zurück.
+
+## RAC-TABLE-ROWID
+
+`rowKey` fehlt oder wiederholt sich in den geladenen Zeilen.
+
+Korrektur: Jede Zeile braucht einen stabilen eindeutigen String.
+
+## RAC-TABLE-ID
+
+`id` ist leer. Der Schlüssel wäre `${namespace}:table:`.
+
+Korrektur: Gib pro Tabelle eine stabile id.
+
+## RAC-COLUMN-COMPONENT
+
+Ist der Spaltenwert `component` nicht in `AutoConfigProvider` unter `config.columns` registriert, erscheint in der Entwicklung `RAC-COLUMN-COMPONENT`; die Zelle verwendet das Standardformat. Registriere den Schlüssel oder setze `render`, `format` oder `sort` auf der Spalte. Funktionen auf der Spalte haben Vorrang.
+
+## RAC-ROW-ACTION
+
+Fehlt einer Zeilenaktion `onClick` und ist `action` kein bekannter Schlüssel in `config.rowActions`, zeigt die Statuszeile beim Auswählen `RAC-ROW-ACTION`. Übergib `onClick` oder registriere den Schlüssel für `action`. Sind beide gesetzt, hat `onClick` Vorrang.
+
+## RAC-TABLE-SOURCE
+
+`source` bezeichnet einen Schlüssel in `AutoConfigProvider` unter `config.sources`. Ein unbekannter Schlüssel zeigt `RAC-TABLE-SOURCE` mit einer Schaltfläche zum Wiederholen. Registriere ihn oder verwende `data` / `dataSource`. Übergib genau eine der drei Varianten.
+
+## RAC-TABLE-FILTER
+
+Das Filter-JSON ist keine Abfrage. Der übersetzte Text erscheint, der vorige Filter bleibt.
+
+Korrektur: Gruppe `{ kind: "group", operator, children }`. Bedingung `{ kind: "condition", field, operator, value }`. `between` ist `[from, to]`.
+
+## RAC-QUERY-FIELD
+
+`serializeRsql` lehnt einen Namen außerhalb `/^[\\w.]+$/` ab.
+
+Korrektur: Nur Buchstaben, Ziffern, Unterstrich und Punkte.
+
+## RAC-DIALOG-PROVIDER
+
+`useAutoDialog()` außerhalb von `AutoDialogProvider`.
+
+Korrektur: Umschließe den Baum mit `<AutoDialogProvider>`. `AutoConfigProvider` liefert keine Dialoge und ist optional. `<AutoDialog open>` nutzt diesen Hook nicht.

package/docs/i18n/es/README.md

@@ -12,10 +12,14 @@ Una biblioteca de componentes independiente y basada en esquemas para React 19,
 
 ## Estado del proyecto
 
-La versión actual es 0.1.2 y las API aún pueden cambiar. Se requiere React 19. El paquete proporciona declaraciones ESM y de TypeScript. El texto integrado de la interfaz tiene el chino como idioma predeterminado y puede traducirse mediante AutoConfigProvider.config.t.
+La versión actual es 0.1.3 y las API aún pueden cambiar. Se requiere React 19. El paquete proporciona declaraciones ESM y de TypeScript. El texto integrado de la interfaz tiene el inglés como idioma predeterminado y puede traducirse mediante AutoConfigProvider.config.t.
 
 Instálalo con `pnpm add @zeroman.yang/react-auto-components` (npm y yarn funcionan igual). Las peer dependencies son React 19 y react-dom 19. Importa la hoja de estilos una vez: `import "@zeroman.yang/react-auto-components/style.css"`.
 
+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`.
+
+En la exportación XLSX, `RAC-TABLE-XLSX` indica que falta el adaptador `exportXlsx`; `RAC-XLSX-DEP` indica que no se pudo cargar la dependencia opcional `exceljs`. Importa y pasa el adaptador desde `@zeroman.yang/react-auto-components/xlsx`; instala con `pnpm add exceljs` cuando sea necesario. CSV y JSON no lo necesitan.
+
 - [Demo en vivo (GitHub Pages)](https://zeroman.github.io/react-auto-components/)
 - [Contribuir](https://github.com/Zeroman/react-auto-components/blob/main/docs/i18n/es/CONTRIBUTING.md)
 - [Registro de cambios](https://github.com/Zeroman/react-auto-components/blob/main/docs/i18n/es/CHANGELOG.md)
@@ -85,7 +89,7 @@ La función de devolución de llamada t recibe una clave de mensaje y un texto a
 | Componente | Capacidades |
 | --- | --- |
 | AutoForm | Tipos de campo nativos, opciones virtualizadas, selección en cascada, adaptadores de carga, renderizado personalizado, campos dependientes, visibilidad condicional, validación asíncrona, estado controlado y conservación de los datos introducidos tras errores |
-| AutoSearchPanel | Condiciones básicas/avanzadas, búsqueda manual/instantánea, restablecimiento, etiquetas de ordenación, un AST de consulta compartido y serialización RSQL |
+| AutoSearch | Condiciones básicas/avanzadas, búsqueda manual/instantánea, restablecimiento, etiquetas de ordenación, un AST de consulta compartido y serialización RSQL |
 | AutoTable | Datos locales/remotos, ordenación por varias columnas, filtros de columna, paginación, selección estable, virtualización, expansión de árboles/detalles, resúmenes, celdas combinadas, CRUD, menús contextuales y copia |
 | AutoDialog | API declarativas/imperativas, proveedores aislados, borradores, protección de cierre, gestión del foco, arrastre, pantalla completa y envío asíncrono |
 | AutoTabs | Diseños horizontales/verticales, anidamiento, permisos, pestañas deshabilitadas, conservación del estado de los paneles y actualización |
@@ -201,3 +205,5 @@ Los formularios admiten `resetLabel`, `extraActions` y `onReset`; los paneles de
 AutoChat proporciona una disposición de conversación ligera con seguimiento automático del streaming, carga del historial y un área de redacción. Usa contenido de React o renderMessage para renderizar los mensajes; no se necesitan dependencias adicionales en tiempo de ejecución.
 
 [AutoChat API](auto-chat.md)
+
+Qué hace el componente si un callback lanza: [AutoForm](auto-form.md), [AutoSearch](auto-search.md), [AutoTable](auto-table.md), [AutoDialog](auto-dialog.md), [AutoTabs](auto-tabs.md), [AutoMenu](auto-menu.md). Códigos de error para desarrolladores: [errors.md](errors.md).

package/docs/i18n/es/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** | [Français](../fr/auto-dialog.md) | [Deutsch](../de/auto-dialog.md) | [Português (Brasil)](../pt-BR/auto-dialog.md) | [Русский](../ru/auto-dialog.md)
+
+Diálogo modal, declarativo (`<AutoDialog open>`) o imperativo (`useAutoDialog().open()`). `fields` dibuja un [AutoForm](auto-form.md).
+
+`useAutoDialog()` fuera del proveedor lanza `RAC-DIALOG-PROVIDER`. `<AutoDialog open>` no necesita el proveedor.
+
+## Comportamiento y props
+
+| Prop | Comportamiento |
+| --- | --- |
+| `onSubmit(values)` | Tras validar. **Rechazar o lanzar: el diálogo sigue abierto, muestra `error.message` y los valores se quedan.** Después de resolver sigue corriendo `beforeClose`. |
+| `beforeClose(reason)` | `"submit"`, `"cancel"` o `"close"`. **`false` lo deja abierto. Lanzar también lo deja abierto y muestra el mensaje.** |
+| `onClose` | Solo después de cerrar de verdad. |
+| `draftKey` | Guarda el borrador en `${namespace}:draft:${draftKey}` hasta un envío correcto. Si se omite, no se guarda nada. |
+| `width` | Por defecto `560`. `draggable` se ignora a pantalla completa. |
+
+`close()` de `open()` resuelve `false` si `beforeClose` bloquea el cierre. Los diálogos imperativos se apilan.
+
+## Precondiciones
+
+Importa `style.css` una vez. `AutoConfigProvider` es opcional y no sustituye a `AutoDialogProvider`. `namespace` forma parte de la clave del borrador.

package/docs/i18n/es/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** | [Français](../fr/auto-form.md) | [Deutsch](../de/auto-form.md) | [Português (Brasil)](../pt-BR/auto-form.md) | [Русский](../ru/auto-form.md)
+
+Formulario por esquema. `AutoSearch` y `AutoDialog` dibujan un `AutoForm`, así que estas reglas de callbacks también valen para ellos.
+
+`Field<T>` es una unión discriminada por `type`. Un `select` sin `options`, un escalar en `daterange` y `match: "between"` sobre un escalar son errores de TypeScript. `AnyField` y `unsafeField()` son la salida; el modo desarrollo sigue avisando. Códigos en [errors.md](errors.md).
+
+## Comportamiento y props
+
+| Prop | Comportamiento |
+| --- | --- |
+| `fields` | `readonly Field<T>[]`. Sin `type` es un texto. Un `name` duplicado lanza `RAC-FIELD-DUPLICATE` al montar. |
+| `value` | Valor controlado. Si difiere del estado interno, el formulario lo copia y limpia errores. Si el padre ignora `onChange`, el input vuelve atrás. |
+| `onSubmit(value)` | Solo tras validar. **Rechazar o lanzar: los valores se quedan, se muestra `error.message` y no hay reset.** |
+| `columns` | Por defecto `2`. `actions` por defecto `true`. |
+| Etiquetas | `labelPosition` por defecto `"top"`. `labelWidth` por defecto `"auto"` (medido, tope 45% del campo). |
+
+## Si un callback lanza
+
+| Callback | Resultado |
+| --- | --- |
+| `onSubmit` | Se captura. El borrador se queda. Se muestra el mensaje. No hay reset. |
+| `rules` del campo | El mensaje lanzado pasa a ser el error de ese campo. Las reglas siguientes no corren. |
+| `onChange` del campo | No se captura. Queda el valor anterior. |
+| `upload` | El rechazo se ve bajo el input y no se guarda valor. `reset()` aborta la señal y tira un resultado tardío. |
+| Envío con una subida en curso | `validate()` devuelve `false` y no llama a `onSubmit`. |
+| `hidden`, `disabled` o sin acceso | Ese campo no se valida, aunque sea `required`. |
+| `required` vacío | `undefined`, `null`, `""` o un array vacío bloquean el envío. |
+
+`handle.validate()` resuelve `true` o `false`. No lanza.
+
+## Precondiciones
+
+Importa `style.css` una vez. En desarrollo, si falta `--auto-text`, avisa `RAC-CSS-MISSING`. `AutoConfigProvider` es opcional y no monta diálogos.