@aithe/aithe-ui 26.3.1 → 26.3.2

package/dist/styles/i18n/locales/de-DE.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"de-DE.d.ts","sourceRoot":"","sources":["../../../../src/styles/i18n/locales/de-DE.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA+IrC,CAAC"}
+{"version":3,"file":"de-DE.d.ts","sourceRoot":"","sources":["../../../../src/styles/i18n/locales/de-DE.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAkJrC,CAAC"}

package/dist/styles/i18n/locales/de-DE.js

@@ -27,6 +27,9 @@ export const de = {
     'form.formItem.requiredField': 'Feld',
     'form.autoform.submit': 'Absenden',
     'form.autoform.patternMismatch': 'Format stimmt nicht überein',
+    'form.autoView.empty': '--',
+    'form.autoView.yes': 'Ja',
+    'form.autoView.no': 'Nein',
     'feedback.modal.closeAriaLabel': 'Modal schließen',
     'feedback.drawer.closeAriaLabel': 'Drawer schließen',
     'data.tabs.removeTabAriaLabel': 'Tab entfernen',

package/dist/styles/i18n/locales/en-US.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"en-US.d.ts","sourceRoot":"","sources":["../../../../src/styles/i18n/locales/en-US.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAwJrC,CAAC"}
+{"version":3,"file":"en-US.d.ts","sourceRoot":"","sources":["../../../../src/styles/i18n/locales/en-US.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA2JrC,CAAC"}

package/dist/styles/i18n/locales/en-US.js

@@ -27,6 +27,9 @@ export const en = {
     'form.formItem.requiredField': 'Field',
     'form.autoform.submit': 'Submit',
     'form.autoform.patternMismatch': 'Format mismatch',
+    'form.autoView.empty': '--',
+    'form.autoView.yes': 'Yes',
+    'form.autoView.no': 'No',
     'feedback.modal.closeAriaLabel': 'Close modal',
     'feedback.drawer.closeAriaLabel': 'Close drawer',
     'data.tabs.removeTabAriaLabel': 'Remove tab',

package/dist/styles/i18n/locales/es-ES.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"es-ES.d.ts","sourceRoot":"","sources":["../../../../src/styles/i18n/locales/es-ES.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA+IrC,CAAC"}
+{"version":3,"file":"es-ES.d.ts","sourceRoot":"","sources":["../../../../src/styles/i18n/locales/es-ES.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAkJrC,CAAC"}

package/dist/styles/i18n/locales/es-ES.js

@@ -27,6 +27,9 @@ export const es = {
     'form.formItem.requiredField': 'Campo',
     'form.autoform.submit': 'Enviar',
     'form.autoform.patternMismatch': 'El formato no coincide',
+    'form.autoView.empty': '--',
+    'form.autoView.yes': 'Sí',
+    'form.autoView.no': 'No',
     'feedback.modal.closeAriaLabel': 'Cerrar modal',
     'feedback.drawer.closeAriaLabel': 'Cerrar panel',
     'data.tabs.removeTabAriaLabel': 'Eliminar pestaña',

package/dist/styles/i18n/locales/fr-FR.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fr-FR.d.ts","sourceRoot":"","sources":["../../../../src/styles/i18n/locales/fr-FR.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA+IrC,CAAC"}
+{"version":3,"file":"fr-FR.d.ts","sourceRoot":"","sources":["../../../../src/styles/i18n/locales/fr-FR.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAkJrC,CAAC"}

package/dist/styles/i18n/locales/fr-FR.js

@@ -27,6 +27,9 @@ export const fr = {
     'form.formItem.requiredField': 'Champ',
     'form.autoform.submit': 'Soumettre',
     'form.autoform.patternMismatch': 'Le format ne correspond pas',
+    'form.autoView.empty': '--',
+    'form.autoView.yes': 'Oui',
+    'form.autoView.no': 'Non',
     'feedback.modal.closeAriaLabel': 'Fermer la modale',
     'feedback.drawer.closeAriaLabel': 'Fermer le tiroir',
     'data.tabs.removeTabAriaLabel': "Supprimer l'onglet",

package/dist/styles/i18n/locales/ja-JP.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ja-JP.d.ts","sourceRoot":"","sources":["../../../../src/styles/i18n/locales/ja-JP.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA+IrC,CAAC"}
+{"version":3,"file":"ja-JP.d.ts","sourceRoot":"","sources":["../../../../src/styles/i18n/locales/ja-JP.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAkJrC,CAAC"}

package/dist/styles/i18n/locales/ja-JP.js

@@ -27,6 +27,9 @@ export const ja = {
     'form.formItem.requiredField': 'フィールド',
     'form.autoform.submit': '送信',
     'form.autoform.patternMismatch': 'フォーマットが一致しません',
+    'form.autoView.empty': '--',
+    'form.autoView.yes': 'はい',
+    'form.autoView.no': 'いいえ',
     'feedback.modal.closeAriaLabel': 'モーダルを閉じる',
     'feedback.drawer.closeAriaLabel': 'ドロワーを閉じる',
     'data.tabs.removeTabAriaLabel': 'タブを削除',

package/dist/styles/i18n/locales/ko-KR.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ko-KR.d.ts","sourceRoot":"","sources":["../../../../src/styles/i18n/locales/ko-KR.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA+IrC,CAAC"}
+{"version":3,"file":"ko-KR.d.ts","sourceRoot":"","sources":["../../../../src/styles/i18n/locales/ko-KR.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAkJrC,CAAC"}

package/dist/styles/i18n/locales/ko-KR.js

@@ -27,6 +27,9 @@ export const ko = {
     'form.formItem.requiredField': '필드',
     'form.autoform.submit': '제출',
     'form.autoform.patternMismatch': '형식이 일치하지 않습니다',
+    'form.autoView.empty': '--',
+    'form.autoView.yes': '예',
+    'form.autoView.no': '아니오',
     'feedback.modal.closeAriaLabel': '모달 닫기',
     'feedback.drawer.closeAriaLabel': '서랍 닫기',
     'data.tabs.removeTabAriaLabel': '탭 제거',

package/dist/styles/i18n/locales/pt-BR.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pt-BR.d.ts","sourceRoot":"","sources":["../../../../src/styles/i18n/locales/pt-BR.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA+IvC,CAAC"}
+{"version":3,"file":"pt-BR.d.ts","sourceRoot":"","sources":["../../../../src/styles/i18n/locales/pt-BR.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAkJvC,CAAC"}

package/dist/styles/i18n/locales/pt-BR.js

@@ -27,6 +27,9 @@ export const ptBr = {
     'form.formItem.requiredField': 'Campo',
     'form.autoform.submit': 'Enviar',
     'form.autoform.patternMismatch': 'O formato não corresponde',
+    'form.autoView.empty': '--',
+    'form.autoView.yes': 'Sim',
+    'form.autoView.no': 'Não',
     'feedback.modal.closeAriaLabel': 'Fechar modal',
     'feedback.drawer.closeAriaLabel': 'Fechar painel',
     'data.tabs.removeTabAriaLabel': 'Remover aba',

package/dist/styles/i18n/locales/zh-CN.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zh-CN.d.ts","sourceRoot":"","sources":["../../../../src/styles/i18n/locales/zh-CN.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAwJrC,CAAC"}
+{"version":3,"file":"zh-CN.d.ts","sourceRoot":"","sources":["../../../../src/styles/i18n/locales/zh-CN.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA2JrC,CAAC"}

package/dist/styles/i18n/locales/zh-CN.js

@@ -27,6 +27,9 @@ export const zh = {
     'form.formItem.requiredField': '字段',
     'form.autoform.submit': '提交',
     'form.autoform.patternMismatch': '格式不匹配',
+    'form.autoView.empty': '--',
+    'form.autoView.yes': '是',
+    'form.autoView.no': '否',
     'feedback.modal.closeAriaLabel': '关闭弹窗',
     'feedback.drawer.closeAriaLabel': '关闭抽屉',
     'data.tabs.removeTabAriaLabel': '移除标签页',

package/dist/styles/i18n/locales/zh-HK.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zh-HK.d.ts","sourceRoot":"","sources":["../../../../src/styles/i18n/locales/zh-HK.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA+IvC,CAAC"}
+{"version":3,"file":"zh-HK.d.ts","sourceRoot":"","sources":["../../../../src/styles/i18n/locales/zh-HK.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAkJvC,CAAC"}

package/dist/styles/i18n/locales/zh-HK.js

@@ -27,6 +27,9 @@ export const zhHk = {
     'form.formItem.requiredField': '欄位',
     'form.autoform.submit': '提交',
     'form.autoform.patternMismatch': '格式不符',
+    'form.autoView.empty': '--',
+    'form.autoView.yes': '是',
+    'form.autoView.no': '否',
     'feedback.modal.closeAriaLabel': '關閉彈窗',
     'feedback.drawer.closeAriaLabel': '關閉抽屜',
     'data.tabs.removeTabAriaLabel': '移除標籤頁',

package/dist/styles/i18n/locales/zh-TW.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zh-TW.d.ts","sourceRoot":"","sources":["../../../../src/styles/i18n/locales/zh-TW.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA+IvC,CAAC"}
+{"version":3,"file":"zh-TW.d.ts","sourceRoot":"","sources":["../../../../src/styles/i18n/locales/zh-TW.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAkJvC,CAAC"}

package/dist/styles/i18n/locales/zh-TW.js

@@ -27,6 +27,9 @@ export const zhTw = {
     'form.formItem.requiredField': '欄位',
     'form.autoform.submit': '提交',
     'form.autoform.patternMismatch': '格式不符',
+    'form.autoView.empty': '--',
+    'form.autoView.yes': '是',
+    'form.autoView.no': '否',
     'feedback.modal.closeAriaLabel': '關閉彈窗',
     'feedback.drawer.closeAriaLabel': '關閉抽屜',
     'data.tabs.removeTabAriaLabel': '移除標籤頁',

package/docs/api/display/autoview.md

@@ -0,0 +1,277 @@
+# AitheAutoView / AitheAutoView 自动视图
+
+> JSON-driven read-only detail view, the display-only counterpart of `<aithe-autoform>`. Shares the same `FormFieldConfig` model, rendering field values as a structured description list with type-aware read-only renderers.
+> JSON 驱动的只读详情视图，`<aithe-autoform>` 的只读镜像。共用同一份 `FormFieldConfig` 模型，将字段值渲染为结构化描述列表，内置类型感知的只读渲染器。
+
+## Import / 引入
+
+```ts
+import '@aithe/aithe-ui/components/display/autoview';
+```
+
+## Description / 描述
+
+`AitheAutoView` is a thin adapter built on top of `<aithe-desc>`. It parses a `fields` JSON array (same model as autoform) and a `data` object, resolves dependency-based show/hide rules, transforms values per control type, and injects type-aware read-only content into `<aithe-desc-item>` slots.
+
+Built-in renderers cover common control types: `input`/`textarea` (plain text), `select`/`radio` (label lookup), `checkbox` (tag list), `switch` (yes/no badge), `date-picker`/`time-picker` (formatted date), `color-picker` (color chip + hex), `rate`/`slider` (plain number). Custom renderers can be registered via `ViewRegistry`.
+
+`AitheAutoView` 是基于 `<aithe-desc>` 的轻量适配器。解析 `fields` JSON 数组（与 autoform 同模型）和 `data` 对象，解析依赖联动显隐规则，按控件类型转换值，将类型感知的只读内容注入 `<aithe-desc-item>` 的 slot。
+
+内置渲染器覆盖常见控件类型：`input`/`textarea`（纯文本）、`select`/`radio`（label 反查）、`checkbox`（标签组）、`switch`（是/否徽章）、`date-picker`/`time-picker`（格式化日期）、`color-picker`（色块+色值）、`rate`/`slider`（纯数值）。可通过 `ViewRegistry` 注册自定义渲染器。
+
+## Slots / 插槽
+
+| Name      | Description (EN)                                              | Description (CN)                          |
+| --------- | ------------------------------------------------------------- | ----------------------------------------- |
+| title     | Custom title content (passed through to desc).                | 自定义标题内容（透传给 desc）。           |
+| extra     | Extra action content in the header (passed through to desc).  | 头部额外操作内容（透传给 desc）。         |
+
+## Properties / 属性
+
+| Name             | Type                              | Default          | Attribute          | Description (EN)                                                                                                           | Description (CN)                                                                                          |
+| ---------------- | --------------------------------- | ---------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
+| fields           | `string`                          | `'[]'`           | `fields`           | JSON string of field configurations. Same model as autoform's `fields`.                                                   | 字段配置的 JSON 字符串，与 autoform 的 `fields` 模型一致。                                                 |
+| data             | `Object \| string`                | `{}`             | `.data`            | Display data object keyed by field name. Supports object or JSON string.                                                   | 展示数据对象，按字段名取值。支持对象或 JSON 字符串。                                                      |
+| column           | `number`                          | `1`              | `column`           | Number of columns in the grid layout. Passed to desc.                                                                      | 网格列数，透传给 desc。                                                                                    |
+| border           | `boolean`                         | `true`           | `border`           | Whether to show full borders (outer frame + cell separators). Equivalent to `border-style="full"`.                         | 是否显示完整边框（外框+单元格分隔线），等同 `border-style="full"`。                                       |
+| border-style     | `'none' \| 'full' \| 'row'`       | `'none'`         | `border-style`     | Border style: `none` (no borders), `full` (outer + all cell separators), `row` (row separators only). Passed to desc.      | 边框样式：`none`（无边框）、`full`（外框+所有单元格分隔线）、`row`（仅行分隔线），透传给 desc。            |
+| label-background | `'filled' \| 'none'`              | `'filled'`       | `label-background` | Label background style: `filled` (default gray) or `none` (transparent). Passed to desc.                                   | 标签背景样式：`filled`（默认灰底）或 `none`（透明），透传给 desc。                                        |
+| direction        | `'horizontal' \| 'vertical'`      | `'horizontal'`   | `direction`        | Layout direction. Passed to desc.                                                                                          | 布局方向，透传给 desc。                                                                                    |
+| label-width      | `string`                          | `'150px'`        | `label-width`      | Label cell width. Passed to desc.                                                                                          | 标签单元格宽度，透传给 desc。                                                                              |
+| size             | `'sm' \| 'md' \| 'lg'`            | `'md'`           | `size`             | Size preset. Passed to desc.                                                                                               | 尺寸规格，透传给 desc。                                                                                    |
+| title            | `string`                          | `''`             | `title`            | Title text in the header. Passed to desc.                                                                                  | 头部标题文本，透传给 desc。                                                                                |
+| show-title       | `boolean`                         | `true`           | `show-title`       | Whether to show the title header. When false, the header row is hidden even if title or extra slot is set. Passed to desc. | 是否显示标题头。为 false 时隐藏标题行，即使设置了 title 或 extra slot 也不显示，透传给 desc。              |
+| max-rows         | `number`                          | `0`              | `max-rows`         | Max visible rows. 0 means no limit. Passed to desc.                                                                        | 最大可见行数，0 表示不限制，透传给 desc。                                                                  |
+| empty-text       | `string`                          | `''`             | `empty-text`       | Global empty value placeholder. Falls back to i18n key `form.autoView.empty` (default `--`).                               | 全局空值占位文本，回退到 i18n 键 `form.autoView.empty`（默认 `--`）。                                      |
+
+## Methods / 方法
+
+| Name      | Parameters | Return                  | Description (EN)                                          | Description (CN)                          |
+| --------- | ---------- | ----------------------- | --------------------------------------------------------- | ----------------------------------------- |
+| getValues | —          | `Record<string, unknown>` | Returns the values of all visible fields from `data`.   | 返回所有可见字段在 `data` 中的值。        |
+
+## Events / 事件
+
+| Name             | Detail                        | Cancelable | Description (EN)                                                      | Description (CN)                                  |
+| ---------------- | ----------------------------- | ---------- | --------------------------------------------------------------------- | ------------------------------------------------- |
+| `aithe-view-ready` | `{ values }`                | No         | Emitted after initial render with current visible field values.       | 初始渲染完成后触发，携带当前可见字段值。          |
+
+## Supported Field Types / 支持的字段类型
+
+| Type           | Read-only Rendering (EN)                                    | 只读渲染方式 (CN)                |
+| -------------- | ----------------------------------------------------------- | -------------------------------- |
+| input          | Plain text.                                                 | 纯文本。                         |
+| textarea       | Plain text.                                                 | 纯文本。                         |
+| number         | Plain text (supports `filter`).                             | 纯文本（支持 `filter`）。        |
+| select         | Label lookup from `options` by value.                       | 从 `options` 中按值反查 label。  |
+| radio          | Label lookup from `options` by value.                       | 从 `options` 中按值反查 label。  |
+| checkbox       | Tag list (`<aithe-tag>`) from `options` by value array.     | 标签组（`<aithe-tag>`），按值数组反查。 |
+| switch         | Yes/No badge (`<aithe-tag>` with success/default variant).  | 是/否徽章（`<aithe-tag>`，success/default 变体）。 |
+| date-picker    | Formatted date (`date yyyy-MM-dd` filter).                  | 格式化日期（`date yyyy-MM-dd` 过滤器）。 |
+| time-picker    | Formatted date.                                             | 格式化日期。                     |
+| color-picker   | Color chip + hex text.                                      | 色块 + 色值文本。                |
+| rate           | Plain number.                                               | 纯数值。                         |
+| slider         | Plain number.                                               | 纯数值。                         |
+| _(custom)_     | Any type registered via `ViewRegistry`.                     | 通过 `ViewRegistry` 注册的类型。 |
+
+## Field Configuration / 字段配置
+
+Each field in the `fields` JSON array supports the following properties (all extending `FormFieldConfig`):
+
+`fields` JSON 数组中每个字段支持以下属性（均扩展自 `FormFieldConfig`）：
+
+| Property     | Type       | Required | Description (EN)                                                                 | Description (CN)                                              |
+| ------------ | ---------- | -------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------- |
+| name         | `string`   | yes      | Field name, used to look up value in `data`.                                     | 字段名称，用于在 `data` 中取值。                              |
+| type         | `string`   | yes      | Field control type (see table above).                                            | 字段控件类型（见上表）。                                      |
+| label        | `string`   | no       | Label text displayed in the label cell.                                          | 标签单元格中显示的文本。                                      |
+| options      | `array`    | no       | Options for select/radio/checkbox. Each: `{ label, id }`.                        | 选择类控件选项，每项：`{ label, id }`。                       |
+| dft          | `string`   | no       | Default value when field is absent in `data`.                                    | 字段在 `data` 中缺失时的缺省值。                              |
+| filter       | `string`   | no       | Filter expression for value formatting (e.g. `"date yyyy-MM-dd"`, `"amount"`).   | 值过滤器表达式（如 `"date yyyy-MM-dd"`、`"amount"`）。        |
+| emptyText    | `string`   | no       | Per-field empty placeholder; falls back to component's `empty-text`.             | 单字段空值占位文本，回退到组件的 `empty-text`。               |
+| span         | `number`   | no       | Column span in the grid. Default 1.                                              | 网格中占用的列数，默认 1。                                    |
+| rowspan      | `number`   | no       | Row span in the grid. Default 1.                                                 | 网格中占用的行数，默认 1。                                    |
+| align        | `string`   | no       | Content text alignment: `'left'` / `'center'` / `'right'`.                       | 内容文本对齐方式：`'left'` / `'center'` / `'right'`。         |
+| hideLabel    | `boolean`  | no       | Whether to hide the label cell.                                                  | 是否隐藏标签单元格。                                          |
+| dependencies | `string[]` | no       | Names of fields this field depends on (for show/hide rules).                     | 当前字段依赖的字段名称列表（用于显隐规则）。                  |
+| rules        | `FormRule[]` | no     | Dependency rules. Only `show`/`hide` types are honored in read-only mode.        | 依赖联动规则。只读模式下仅生效 `show`/`hide`。                |
+
+## Custom View Registry / 自定义视图注册表
+
+The autoview supports registering custom read-only renderers via the `ViewRegistry` class, mirroring `FormRegistry`. This allows extending the view with any custom rendering logic without modifying the autoview source.
+
+autoview 支持通过 `ViewRegistry` 类注册自定义只读渲染器，与 `FormRegistry` 对称。无需修改 autoview 源码即可扩展视图。
+
+### ViewRegistry Static Methods / ViewRegistry 静态方法
+
+| Method                        | Description (EN)                       | Description (CN)               |
+| ----------------------------- | -------------------------------------- | ------------------------------ |
+| `ViewRegistry.register(def)`  | Register a custom view renderer.       | 注册自定义只读渲染器。         |
+| `ViewRegistry.unregister(type)` | Unregister a view type.              | 注销视图类型。                 |
+| `ViewRegistry.get(type)`      | Get a registered view definition.      | 获取已注册的视图定义。         |
+| `ViewRegistry.has(type)`      | Check if a view type is registered.    | 检查视图类型是否已注册。       |
+| `ViewRegistry.types()`        | Get all registered view type names.    | 获取所有已注册的视图类型名。   |
+
+### ViewControlDefinition / 视图控件定义
+
+| Property | Type                       | Required | Description (EN)                                     | Description (CN)                        |
+| -------- | -------------------------- | -------- | ---------------------------------------------------- | --------------------------------------- |
+| type     | `string`                   | yes      | Unique type name matching the `type` in field config. | 唯一类型名称，匹配字段配置中的 type。   |
+| render   | `(ctx) => TemplateResult`  | yes      | Renderer function returning the read-only template.  | 返回只读模板的渲染函数。                |
+
+### ViewRenderContext / 渲染上下文
+
+| Property   | Type             | Description (EN)                                                                 | Description (CN)                                              |
+| ---------- | ---------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------- |
+| value      | `unknown`        | Transformed value (boolean for switch, number for number, string[] for checkbox). | 转换后的值（switch 为布尔、number 为数值、checkbox 为字符串数组）。 |
+| rawValue   | `string`         | Raw string value as stored in `data`.                                            | `data` 中的原始字符串值。                                     |
+| options    | `FormItemOption[]` | Options for select/radio/checkbox controls.                                    | 选择类控件的选项。                                            |
+| field      | `ViewFieldConfig` | Full field configuration.                                                       | 完整字段配置。                                                |
+| emptyText  | `string`         | Resolved empty placeholder text.                                                 | 解析后的空值占位文本。                                        |
+
+### Register Example / 注册示例
+
+```ts
+import { ViewRegistry } from '@aithe/aithe-ui';
+import { html } from 'lit';
+
+ViewRegistry.register({
+  type: 'status-badge',
+  render: (ctx) => html`
+    <aithe-tag variant=${ctx.value === 'active' ? 'success' : 'default'} size="sm">
+      ${ctx.rawValue || ctx.emptyText}
+    </aithe-tag>
+  `,
+});
+```
+
+Then use it in the fields JSON:
+
+```json
+{
+  "name": "status",
+  "type": "status-badge",
+  "label": "Status"
+}
+```
+
+## Dependency & Visibility / 依赖联动与显隐
+
+The autoview supports field dependency linkage through the same JSON configuration as autoform. When a dependency field's value changes, the dependent field re-evaluates its `show`/`hide` rules to determine visibility.
+
+autoview 支持与 autoform 相同的 JSON 配置实现字段依赖联动。当被依赖字段的值变化时，依赖字段重新计算 `show`/`hide` 规则决定可见性。
+
+> **Note / 注意**: In read-only mode, only `show` and `hide` rule types are honored. `disable`/`enable`/`clear`/`update` rules are ignored.
+> 只读模式下仅生效 `show`/`hide` 规则，`disable`/`enable`/`clear`/`update` 规则被忽略。
+
+### Show/Hide Example / 显隐示例
+
+```json
+[
+  {
+    "name": "hasCar",
+    "label": "Has a car?",
+    "type": "switch"
+  },
+  {
+    "name": "carModel",
+    "label": "Car Model",
+    "type": "input",
+    "dependencies": ["hasCar"],
+    "rules": [{ "type": "show", "condition": "hasCar === true" }]
+  }
+]
+```
+
+## Examples / 示例
+
+### Basic Usage / 基础用法
+
+```html
+<aithe-autoview
+  fields='[
+    {"name":"username","type":"input","label":"Username"},
+    {"name":"email","type":"input","label":"Email","inputType":"email"},
+    {"name":"bio","type":"textarea","label":"Bio","span":2}
+  ]'
+  .data=${{username:"John Doe",email:"john@example.com",bio:"Frontend engineer."}}
+  column="2"
+  border
+></aithe-autoview>
+```
+
+### Selection Display / 选择类展示
+
+```html
+<aithe-autoview
+  fields='[
+    {"name":"role","type":"select","label":"Role","options":[{"label":"Admin","id":"admin"},{"label":"Editor","id":"editor"}]},
+    {"name":"skills","type":"checkbox","label":"Skills","options":[{"label":"TypeScript","id":"ts"},{"label":"Go","id":"go"}]},
+    {"name":"notifications","type":"switch","label":"Notifications"}
+  ]'
+  .data=${{role:"editor",skills:["ts","go"],notifications:true}}
+  column="2"
+  border
+></aithe-autoview>
+```
+
+### Border Styles / 边框样式
+
+```html
+<!-- No border, no label background: clean style -->
+<aithe-autoview border-style="none" label-background="none" column="2"></aithe-autoview>
+
+<!-- Full border with filled labels -->
+<aithe-autoview border-style="full" label-background="filled" column="2"></aithe-autoview>
+
+<!-- Row separators only, no outer frame -->
+<aithe-autoview border-style="row" label-background="none" column="2"></aithe-autoview>
+```
+
+### Hidden Title / 隐藏标题头
+
+Set `show-title="false"` to hide the header row entirely, even when `title` or the `extra` slot is provided. Useful for embedding autoview inside another container that already provides a heading.
+
+设置 `show-title="false"` 可彻底隐藏标题行，即使设置了 `title` 或 `extra` slot 也不显示。适用于将 autoview 嵌入已有标题的容器中。
+
+```html
+<!-- Header row is hidden, title and extra slot are ignored -->
+<aithe-autoview
+  title="Employee Profile"
+  show-title="false"
+  column="2"
+  border
+></aithe-autoview>
+```
+
+### Dependency Visibility / 联动显隐
+
+```html
+<aithe-autoview
+  fields='[
+    {"name":"province","type":"select","label":"Province","options":[{"label":"Beijing","id":"BJ"},{"label":"Shanghai","id":"SH"}]},
+    {"name":"city","type":"select","label":"City","dependencies":["province"],"rules":[{"type":"show","condition":"province !== ''"}]},
+    {"name":"hasCar","type":"switch","label":"Has a car?"},
+    {"name":"carModel","type":"input","label":"Car Model","dependencies":["hasCar"],"rules":[{"type":"show","condition":"hasCar === true"}]}
+  ]'
+  .data=${{province:"BJ",city:"Haidian",hasCar:true,carModel:"Tesla Model 3"}}
+  column="2"
+  border
+></aithe-autoview>
+```
+
+### Empty Values / 空值展示
+
+```html
+<aithe-autoview
+  fields='[
+    {"name":"username","type":"input","label":"Username"},
+    {"name":"role","type":"select","label":"Role","options":[{"label":"Admin","id":"admin"}]},
+    {"name":"active","type":"switch","label":"Active"}
+  ]'
+  .data=${{username:"",role:"",active:false}}
+  column="2"
+  border
+  empty-text="—"
+></aithe-autoview>
+```

package/docs/api/display/desc.md

@@ -1,7 +1,7 @@
 # AitheDesc / AitheDesc 描述列表
 
-> A description list component that displays key-value pairs in a structured table-like layout. Supports border mode, column count, title, extra actions, direction control, colspan, and rowspan.
-> 描述列表组件，以结构化的类表格布局展示键值对。支持边框模式、列数、标题、额外操作、方向控制、列合并和行合并。
+> A description list component that displays key-value pairs in a structured table-like layout. Supports border styles, label background, column count, title, extra actions, direction control, colspan, and rowspan.
+> 描述列表组件，以结构化的类表格布局展示键值对。支持边框样式、标签背景、列数、标题、额外操作、方向控制、列合并和行合并。
 
 ## Import / 引入
 
@@ -12,22 +12,24 @@ import '@aithe/aithe-ui/components/display/desc-item';
 
 ## Description / 描述
 
-`AitheDesc` renders a structured key-value list using CSS Grid layout. It places `<aithe-desc-item>` children into a grid based on the `column` property and each item's `span` and `rowspan`. Supports border mode, vertical/horizontal direction, title, extra slot, and size variants.
+`AitheDesc` renders a structured key-value list using CSS Grid layout. It places `<aithe-desc-item>` children into a grid based on the `column` property and each item's `span` and `rowspan`. Supports border styles (`none`/`full`/`row`), label background (`filled`/`none`), vertical/horizontal direction, title, extra slot, and size variants.
 
-`AitheDesc` 使用 CSS Grid 布局渲染结构化的键值列表。根据 `column` 属性和每个条目的 `span`/`rowspan` 将 `<aithe-desc-item>` 子元素放置到网格中。支持边框模式、垂直/水平方向、标题、额外插槽和尺寸变体。
+`AitheDesc` 使用 CSS Grid 布局渲染结构化的键值列表。根据 `column` 属性和每个条目的 `span`/`rowspan` 将 `<aithe-desc-item>` 子元素放置到网格中。支持边框样式（`none`/`full`/`row`）、标签背景（`filled`/`none`）、垂直/水平方向、标题、额外插槽和尺寸变体。
 
 ## AitheDesc Properties / AitheDesc 属性
 
-| Name      | Type                              | Default      | Attribute  | Description (EN)                                                    | Description (CN)                   |
-| --------- | --------------------------------- | ------------ | ---------- | ------------------------------------------------------------------- | ---------------------------------- |
-| title     | `string`                          | `''`         | `title`    | Title text displayed in the header.                                 | 头部标题文本。                     |
-| column    | `number`                          | `1`          | `column`   | Number of columns for the description layout.                       | 描述布局的列数。                   |
-| border    | `boolean`                         | `false`      | `border`   | Whether to show border.                                             | 是否显示边框。                     |
-| direction | `'horizontal' \| 'vertical'`      | `'horizontal'` | `direction` | Layout direction: label left of content or label above content.     | 布局方向：标签在内容左侧或上方。   |
-| size      | `'sm' \| 'md' \| 'lg'`            | `'md'`       | `size`     | Size of the description list.                                       | 描述列表的尺寸。                   |
-| labelWidth | `string`                         | `''`         | `label-width` | Global label width. Falls back to individual item's label-width.  | 全局标签宽度，item 单独设置时优先。 |
-| showTitle | `boolean`                         | `true`       | `show-title` | Whether to show the title header.                                  | 是否显示标题头。                   |
-| maxRows   | `number`                          | `0`          | `max-rows`  | Maximum visible rows. 0 means no limit.                            | 最大可见行数，0 表示不限制。        |
+| Name             | Type                              | Default        | Attribute          | Description (EN)                                                                                                           | Description (CN)                                                                                          |
+| ---------------- | --------------------------------- | -------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
+| title            | `string`                          | `''`           | `title`            | Title text displayed in the header.                                                                                        | 头部标题文本。                                                                                            |
+| column           | `number`                          | `1`            | `column`           | Number of columns for the description layout.                                                                              | 描述布局的列数。                                                                                          |
+| border           | `boolean`                         | `false`        | `border`           | Whether to show full borders (outer frame + cell separators). Equivalent to `border-style="full"`.                         | 是否显示完整边框（外框+单元格分隔线），等同 `border-style="full"`。                                       |
+| border-style     | `'none' \| 'full' \| 'row'`       | `'none'`       | `border-style`     | Border style: `none` (no borders), `full` (outer + all cell separators), `row` (row separators only, no outer frame or column separators). | 边框样式：`none`（无边框）、`full`（外框+所有单元格分隔线）、`row`（仅行分隔线，无外框和列分隔线）。      |
+| label-background | `'filled' \| 'none'`              | `'filled'`     | `label-background` | Label background style: `filled` (default gray) or `none` (transparent).                                                   | 标签背景样式：`filled`（默认灰底）或 `none`（透明）。                                                      |
+| direction        | `'horizontal' \| 'vertical'`      | `'horizontal'` | `direction`        | Layout direction: label left of content or label above content.                                                            | 布局方向：标签在内容左侧或上方。                                                                          |
+| size             | `'sm' \| 'md' \| 'lg'`            | `'md'`         | `size`             | Size of the description list.                                                                                              | 描述列表的尺寸。                                                                                          |
+| labelWidth       | `string`                          | `'150px'`      | `label-width`      | Global label width. Falls back to individual item's label-width.                                                           | 全局标签宽度，item 单独设置时优先。                                                                       |
+| showTitle        | `boolean`                         | `true`         | `show-title`       | Whether to show the title header.                                                                                          | 是否显示标题头。                                                                                          |
+| maxRows          | `number`                          | `0`            | `max-rows`         | Maximum visible rows. 0 means no limit.                                                                                    | 最大可见行数，0 表示不限制。                                                                              |
 
 ## AitheDescItem Properties / AitheDescItem 属性
 
@@ -102,6 +104,46 @@ import '@aithe/aithe-ui/components/display/desc-item';
 </aithe-desc>
 ```
 
+### Border Styles / 边框样式
+
+`border-style` provides three modes: `none` (no borders), `full` (outer frame + all cell separators), `row` (row separators only).
+
+`border-style` 提供三种模式：`none`（无边框）、`full`（外框+所有单元格分隔线）、`row`（仅行分隔线）。
+
+```html
+<!-- Full border (equivalent to `border`) -->
+<aithe-desc title="Full Border" border-style="full" column="2">
+  <aithe-desc-item label="Name">John Doe</aithe-desc-item>
+  <aithe-desc-item label="Age">30</aithe-desc-item>
+  <aithe-desc-item label="Email">john@example.com</aithe-desc-item>
+  <aithe-desc-item label="Phone">+1 234 5678</aithe-desc-item>
+</aithe-desc>
+
+<!-- Row separators only, no outer frame -->
+<aithe-desc title="Row Separators" border-style="row" column="2">
+  <aithe-desc-item label="Name">John Doe</aithe-desc-item>
+  <aithe-desc-item label="Age">30</aithe-desc-item>
+  <aithe-desc-item label="Email">john@example.com</aithe-desc-item>
+  <aithe-desc-item label="Phone">+1 234 5678</aithe-desc-item>
+</aithe-desc>
+```
+
+### Label Background / 标签背景
+
+`label-background` controls whether the label cell has a gray background (`filled`, default) or is transparent (`none`). Combine with `border-style="row"` for a clean, minimal style.
+
+`label-background` 控制标签单元格是否为灰底（`filled`，默认）或透明（`none`）。配合 `border-style="row"` 可实现简洁风格。
+
+```html
+<!-- No label background + row separators: minimal style -->
+<aithe-desc title="Minimal" border-style="row" label-background="none" column="2">
+  <aithe-desc-item label="Name">John Doe</aithe-desc-item>
+  <aithe-desc-item label="Age">30</aithe-desc-item>
+  <aithe-desc-item label="Email">john@example.com</aithe-desc-item>
+  <aithe-desc-item label="Phone">+1 234 5678</aithe-desc-item>
+</aithe-desc>
+```
+
 ### Column Span / 列合并
 
 ```html

package/docs/api/form/autoform-item.md

@@ -27,7 +27,7 @@
 | message            | `string`                  | `''`      | Validation failure message.                                                                                                                                     | 校验失败提示语。           |
 | options            | `FormItemOption[]`        | `[]`      | Options for select/radio/checkbox.                                                                                                                              | 选择类控件的选项。         |
 | value              | `string`                  | `''`      | Current field value.                                                                                                                                            | 当前字段值。               |
-| inputType          | `string`                  | `'text'`  | Input type attribute for type="input".                                                                                                                          | input 控件的 type 属性。   |
+| inputType          | `string`                  | `'text'`  | Input type attribute for type="input". When set to `password`, a suffix icon button (`eye`/`eyeOff`) is rendered to toggle between masked and plaintext display. | input 控件的 type 属性。设为 `password` 时，后缀渲染图标按钮（`eye`/`eyeOff`）用于在密文与明文之间切换。 |
 | min                | `string`                  | `''`      | Minimum value for number/slider.                                                                                                                                | 数字/滑块最小值。          |
 | max                | `string`                  | `''`      | Maximum value for number/slider.                                                                                                                                | 数字/滑块最大值。          |
 | step               | `string`                  | `''`      | Step value for number/slider/rate.                                                                                                                              | 数字/滑块/评分步长。       |
@@ -98,3 +98,18 @@
   message="Please enter a valid phone number"
 ></aithe-autoform-item>
 ```
+
+### 密码输入（带明文切换）
+
+```html
+<aithe-autoform-item
+  name="password"
+  type="input"
+  inputType="password"
+  label="Password"
+  icon="lock"
+  required
+  placeholder="Enter your password"
+  message="Password is required"
+></aithe-autoform-item>
+```