@aithe/aithe-ui 26.3.1 → 26.3.2

package/dist/components/form/autoform-item.js

@@ -97,6 +97,8 @@ let AitheAutoformItem = class AitheAutoformItem extends AitheElement {
         this._ruleDisabled = false;
         /** Options computed by dependency rules. 依赖规则计算的选项。 */
         this._ruleOptions = null;
+        /** Whether the password is visible (only for inputType="password"). 密码是否明文显示（仅 inputType="password" 时生效）。 */
+        this._passwordVisible = false;
         this.pendingClear = false;
         /** Handles input/textarea/number change events. 处理 input/textarea/number 的变更事件。 */
         this.handleInputChange = (ev) => {
@@ -107,6 +109,10 @@ let AitheAutoformItem = class AitheAutoformItem extends AitheElement {
                 this.validate();
             }
         };
+        /** Toggles password visibility (only for inputType="password"). 切换密码明文显示（仅 inputType="password" 时生效）。 */
+        this.togglePasswordVisible = () => {
+            this._passwordVisible = !this._passwordVisible;
+        };
         /** Handles switch toggle change. 处理开关组件的切换事件。 */
         this.handleSwitchChange = (ev) => {
             const target = ev.target;
@@ -369,7 +375,9 @@ let AitheAutoformItem = class AitheAutoformItem extends AitheElement {
         if (this.required && !String(val).trim()) {
             this.errorMsg =
                 this.message ||
-                    t('form.formItem.required', '{label} is required', { label: this.label || this.name || t('form.formItem.requiredField') });
+                    t('form.formItem.required', '{label} is required', {
+                        label: this.label || this.name || t('form.formItem.requiredField'),
+                    });
             return false;
         }
         if (this.pattern && String(val).trim()) {
@@ -414,6 +422,10 @@ let AitheAutoformItem = class AitheAutoformItem extends AitheElement {
         }
         return this.value;
     }
+    /** Resolves the effective input type for password fields based on visibility state. 根据可见状态解析密码字段的有效输入类型。 */
+    resolvePasswordType() {
+        return this._passwordVisible ? 'text' : 'password';
+    }
     /** Renders the appropriate form control based on type. Falls back to input for unknown types. 根据控件类型渲染对应的表单控件，未知类型回退为 input。 */
     renderControl() {
         const ph = this.placeholder || '';
@@ -447,17 +459,32 @@ let AitheAutoformItem = class AitheAutoformItem extends AitheElement {
             });
         }
         switch (this.type) {
-            case 'input':
+            case 'input': {
+                const isPassword = this.inputType === 'password';
+                const effectiveType = isPassword ? this.resolvePasswordType() : this.inputType || 'text';
+                const passwordIconName = this._passwordVisible ? 'eyeOff' : 'eye';
                 return html `
           <aithe-input
-            .type=${this.inputType || 'text'}
+            .type=${effectiveType}
             .placeholder=${ph}
             .value=${this.value}
             ?disabled=${dis}
             name=${this.name}
             @aithe-change=${this.handleInputChange}
-          ></aithe-input>
+          >
+            ${isPassword
+                    ? html `
+                    <aithe-icon
+                      slot="suffix"
+                      name=${passwordIconName}
+                      size="sm"
+                      @click=${this.togglePasswordVisible}
+                    ></aithe-icon>
+                  `
+                    : nothing}
+          </aithe-input>
         `;
+            }
             case 'textarea':
                 return html `
           <aithe-textarea
@@ -755,6 +782,9 @@ __decorate([
 __decorate([
     state()
 ], AitheAutoformItem.prototype, "_ruleOptions", void 0);
+__decorate([
+    state()
+], AitheAutoformItem.prototype, "_passwordVisible", void 0);
 AitheAutoformItem = __decorate([
     customElement('aithe-autoform-item')
 ], AitheAutoformItem);

package/dist/components/form/combobox.d.ts

@@ -41,5 +41,9 @@ export declare class AitheCombobox extends AitheElement {
     private selectOption;
     render(): import("lit-html").TemplateResult<1>;
     private renderOptionList;
+    /** Renders a single option button. 渲染单个选项按钮。 */
+    private renderOption;
+    /** Groups options by their `group` field. 按 group 字段对选项聚合。 */
+    private groupedOptions;
 }
 //# sourceMappingURL=combobox.d.ts.map

package/dist/components/form/combobox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"combobox.d.ts","sourceRoot":"","sources":["../../../src/components/form/combobox.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAYnD;;;;;;;;;;;;;;;GAeG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,kCAAkC;IACN,KAAK,SAAM;IACvC,2EAA2E;IAC/C,KAAK,SAAM;IACvC,2DAA2D;IAC/B,IAAI,SAAM;IACtC,wDAAwD;IAC5B,OAAO,SAAQ;IAC3C,8DAA8D;IACjC,UAAU,UAAQ;IAC/C,iDAAiD;IACL,QAAQ,UAAS;IAC7D,gDAAgD;IACpB,WAAW,SAAM;IAEpC,OAAO,CAAC,IAAI,CAAS;IAE9B,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAoHpB;IAEF,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAK5B,OAAO,KAAK,aAAa,GAOxB;IAED,OAAO,KAAK,eAAe,GAQ1B;IAED,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAIpC;IAEF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAK1B;IAEF,OAAO,CAAC,YAAY;IAMpB,MAAM;IA0BN,OAAO,CAAC,gBAAgB;CAwBzB"}
+{"version":3,"file":"combobox.d.ts","sourceRoot":"","sources":["../../../src/components/form/combobox.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAcnD;;;;;;;;;;;;;;;GAeG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,kCAAkC;IACN,KAAK,SAAM;IACvC,2EAA2E;IAC/C,KAAK,SAAM;IACvC,2DAA2D;IAC/B,IAAI,SAAM;IACtC,wDAAwD;IAC5B,OAAO,SAAQ;IAC3C,8DAA8D;IACjC,UAAU,UAAQ;IAC/C,iDAAiD;IACL,QAAQ,UAAS;IAC7D,gDAAgD;IACpB,WAAW,SAAM;IAEpC,OAAO,CAAC,IAAI,CAAS;IAE9B,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAgIpB;IAEF,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAK5B,OAAO,KAAK,aAAa,GAOxB;IAED,OAAO,KAAK,eAAe,GAQ1B;IAED,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAIpC;IAEF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAK1B;IAEF,OAAO,CAAC,YAAY;IAMpB,MAAM;IA8BN,OAAO,CAAC,gBAAgB;IAyBxB,gDAAgD;IAChD,OAAO,CAAC,YAAY;IAgBpB,8DAA8D;IAC9D,OAAO,CAAC,cAAc;CAevB"}

package/dist/components/form/combobox.js

@@ -171,6 +171,18 @@ let AitheCombobox = class AitheCombobox extends AitheElement {
         padding: var(--aithe-space-3);
         color: var(--aithe-color-text-subtle);
       }
+
+      .group-header {
+        padding: var(--aithe-space-2) var(--aithe-space-3);
+        font-size: var(--aithe-font-size-xs);
+        font-weight: var(--aithe-font-weight-medium);
+        color: var(--aithe-color-text-muted);
+        user-select: none;
+      }
+
+      .group .item {
+        padding-left: var(--aithe-space-6);
+      }
     `,
     ]; }
     connectedCallback() {
@@ -209,8 +221,8 @@ let AitheCombobox = class AitheCombobox extends AitheElement {
       <label class=${classMap({ control: true, disabled: this.disabled })} title=${this.title}>
         ${this.icon
             ? html `
-              <aithe-icon class="value-icon" name=${this.icon} size="16"></aithe-icon>
-            `
+                <aithe-icon class="value-icon" name=${this.icon} size="16"></aithe-icon>
+              `
             : nothing}
         <input
           .value=${this.value}
@@ -222,8 +234,8 @@ let AitheCombobox = class AitheCombobox extends AitheElement {
       </label>
       ${this.open
             ? html `
-            <div class="panel">${this.renderOptionList(options)}</div>
-          `
+              <div class="panel">${this.renderOptionList(options)}</div>
+            `
             : null}
     `;
     }
@@ -235,22 +247,53 @@ let AitheCombobox = class AitheCombobox extends AitheElement {
         `,
             ];
         }
-        return options.map((option) => {
-            const intentClass = option.variant && option.variant !== 'default' ? option.variant : '';
-            const optionIcon = option.icon
+        const hasGroup = options.some((o) => o.group);
+        if (!hasGroup) {
+            return options.map((option) => this.renderOption(option));
+        }
+        return this.groupedOptions(options).map((group) => {
+            const header = group.label
                 ? html `
-            <aithe-icon class="option-icon" name=${option.icon} size="16"></aithe-icon>
+            <div class="group-header" role="presentation">${group.label}</div>
           `
                 : nothing;
+            const items = group.options.map((option) => this.renderOption(option));
             return html `
-        <button class="item ${intentClass}" type="button" @click=${() => this.selectOption(option)}>
-          <span style="display:inline-flex;align-items:center;gap:var(--aithe-space-2);">
-            ${optionIcon}${option.label}
-          </span>
-        </button>
+        <div class="group">${header}${items}</div>
       `;
         });
     }
+    /** Renders a single option button. 渲染单个选项按钮。 */
+    renderOption(option) {
+        const intentClass = option.variant && option.variant !== 'default' ? option.variant : '';
+        const optionIcon = option.icon
+            ? html `
+          <aithe-icon class="option-icon" name=${option.icon} size="16"></aithe-icon>
+        `
+            : nothing;
+        return html `
+      <button class="item ${intentClass}" type="button" @click=${() => this.selectOption(option)}>
+        <span style="display:inline-flex;align-items:center;gap:var(--aithe-space-2);">
+          ${optionIcon}${option.label}
+        </span>
+      </button>
+    `;
+    }
+    /** Groups options by their `group` field. 按 group 字段对选项聚合。 */
+    groupedOptions(options) {
+        const map = new Map();
+        for (const opt of options) {
+            const g = opt.group ?? '';
+            if (!map.has(g))
+                map.set(g, []);
+            map.get(g).push(opt);
+        }
+        const groups = [];
+        for (const [label, opts] of map) {
+            groups.push({ label: label || undefined, options: opts });
+        }
+        return groups;
+    }
 };
 __decorate([
     property({ type: String })

package/dist/components/form/select.d.ts

@@ -70,5 +70,9 @@ export declare class AitheSelect extends AitheAnchoredOverlayElement {
     private readonly handleTriggerKeydown;
     render(): import("lit-html").TemplateResult<1>;
     private renderOptionList;
+    /** Renders a single option button. 渲染单个选项按钮。 */
+    private renderOption;
+    /** Groups filtered options by their `group` field. 按 group 字段对过滤后的选项聚合。 */
+    private get groupedOptions();
 }
 //# sourceMappingURL=select.d.ts.map

package/dist/components/form/select.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../../src/components/form/select.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAC;AAK1C,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAIrD;;;;;;;;;;;;;;;;GAgBG;AACH,qBACa,WAAY,SAAQ,2BAA2B;IAC1D,mDAAmD;IACD,WAAW,SAAM;IACnE,8CAA8C;IACd,OAAO,EAAE,iBAAiB,EAAE,CAAM;IAClE,wCAAwC;IACZ,KAAK,SAAM;IACvC,0EAA0E;IAC9C,KAAK,SAAM;IACvC,oEAAoE;IACxC,IAAI,SAAM;IACtC,oEAAoE;IACxC,WAAW,SAAM;IAC7C,2DAA2D;IAC9B,UAAU,UAAS;IAChD,4DAA4D;IAC/B,SAAS,UAAS;IAC/C,4CAA4C;IACA,QAAQ,UAAS;IAC7D,wCAAwC;IACZ,SAAS,EAAE,cAAc,GAAG,WAAW,CAAkB;IAElE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAc;IAChD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAc;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAmB;IAE/D,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,WAAW,CAAM;IAElC,uGAAuG;IACvG,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAUzD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAoJpB;IAEF,SAAS,KAAK,YAAY,IAAI,WAAW,GAAG,IAAI,CAE/C;IAED,SAAS,KAAK,aAAa,IAAI,WAAW,CAEzC;IAED,iBAAiB,IAAI,IAAI;IAMzB,oBAAoB,IAAI,IAAI;IAM5B,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAwBtD,2EAA2E;IAC3E,OAAO,KAAK,cAAc,GAEzB;IAED,4DAA4D;IAC5D,OAAO,KAAK,eAAe,GAW1B;IAED,6DAA6D;IAC7D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAInC;IAEF,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAIpC;IAEF,kDAAkD;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAMzB;IAEF,qFAAqF;IACrF,OAAO,CAAC,YAAY;IAWpB,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAUzB;IAEF,wEAAwE;IACxE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAiCnC;IAEF,MAAM;IAyEN,OAAO,CAAC,gBAAgB;CA0CzB"}
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../../src/components/form/select.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAC;AAK1C,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAIrD;;;;;;;;;;;;;;;;GAgBG;AACH,qBACa,WAAY,SAAQ,2BAA2B;IAC1D,mDAAmD;IACD,WAAW,SAAM;IACnE,8CAA8C;IACd,OAAO,EAAE,iBAAiB,EAAE,CAAM;IAClE,wCAAwC;IACZ,KAAK,SAAM;IACvC,0EAA0E;IAC9C,KAAK,SAAM;IACvC,oEAAoE;IACxC,IAAI,SAAM;IACtC,oEAAoE;IACxC,WAAW,SAAM;IAC7C,2DAA2D;IAC9B,UAAU,UAAS;IAChD,4DAA4D;IAC/B,SAAS,UAAS;IAC/C,4CAA4C;IACA,QAAQ,UAAS;IAC7D,wCAAwC;IACZ,SAAS,EAAE,cAAc,GAAG,WAAW,CAAkB;IAElE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAc;IAChD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAc;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAmB;IAE/D,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,WAAW,CAAM;IAElC,uGAAuG;IACvG,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAUzD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAgKpB;IAEF,SAAS,KAAK,YAAY,IAAI,WAAW,GAAG,IAAI,CAE/C;IAED,SAAS,KAAK,aAAa,IAAI,WAAW,CAEzC;IAED,iBAAiB,IAAI,IAAI;IAMzB,oBAAoB,IAAI,IAAI;IAM5B,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAwBtD,2EAA2E;IAC3E,OAAO,KAAK,cAAc,GAEzB;IAED,4DAA4D;IAC5D,OAAO,KAAK,eAAe,GAW1B;IAED,6DAA6D;IAC7D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAInC;IAEF,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAIpC;IAEF,kDAAkD;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAMzB;IAEF,qFAAqF;IACrF,OAAO,CAAC,YAAY;IAWpB,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAUzB;IAEF,wEAAwE;IACxE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAiCnC;IAEF,MAAM;IA+EN,OAAO,CAAC,gBAAgB;IA0BxB,gDAAgD;IAChD,OAAO,CAAC,YAAY;IAoCpB,2EAA2E;IAC3E,OAAO,KAAK,cAAc,GAYzB;CACF"}

package/dist/components/form/select.js

@@ -271,6 +271,18 @@ let AitheSelect = class AitheSelect extends AitheAnchoredOverlayElement {
         color: var(--aithe-color-text-muted);
         text-align: center;
       }
+
+      .group-header {
+        padding: var(--aithe-space-2) var(--aithe-space-3);
+        font-size: var(--aithe-font-size-xs);
+        font-weight: var(--aithe-font-weight-medium);
+        color: var(--aithe-color-text-muted);
+        user-select: none;
+      }
+
+      .group .option {
+        padding-left: var(--aithe-space-6);
+      }
     `,
     ]; }
     get panelElement() {
@@ -373,31 +385,31 @@ let AitheSelect = class AitheSelect extends AitheAnchoredOverlayElement {
         <div class="value">
           ${this.icon
             ? html `
-                <aithe-icon class="value-icon" name=${this.icon} size="16"></aithe-icon>
-              `
+                  <aithe-icon class="value-icon" name=${this.icon} size="16"></aithe-icon>
+                `
             : nothing}
           ${valueContent}
         </div>
         <span class="actions">
           ${this.clearable && this.value
             ? html `
-                <button
-                  class="action"
-                  type="button"
-                  aria-label=${t('form.select.clearAriaLabel')}
-                  @click=${this.clearValue}
-                >
-                  ×
-                </button>
-              `
+                  <button
+                    class="action"
+                    type="button"
+                    aria-label=${t('form.select.clearAriaLabel')}
+                    @click=${this.clearValue}
+                  >
+                    ×
+                  </button>
+                `
             : null}
           <span aria-hidden="true">${this.open ? '▴' : '▾'}</span>
         </span>
       </div>
       ${this.open
             ? html `
-            <div class="panel" role="listbox">${this.renderOptionList()}</div>
-          `
+              <div class="panel" role="listbox">${this.renderOptionList()}</div>
+            `
             : null}
     `;
     }
@@ -409,40 +421,72 @@ let AitheSelect = class AitheSelect extends AitheAnchoredOverlayElement {
         `,
             ];
         }
-        return this.filteredOptions.map((option, index) => {
-            const intentClass = option.variant && option.variant !== 'default' ? option.variant : '';
-            const optionIcon = option.icon
+        const hasGroup = this.filteredOptions.some((o) => o.group);
+        if (!hasGroup) {
+            return this.filteredOptions.map((option, index) => this.renderOption(option, index));
+        }
+        let flatIndex = 0;
+        return this.groupedOptions.map((group) => {
+            const header = group.label
                 ? html `
-            <aithe-icon class="option-icon" name=${option.icon} size="20"></aithe-icon>
+            <div class="group-header" role="presentation">${group.label}</div>
           `
                 : nothing;
+            const items = group.options.map((option) => this.renderOption(option, flatIndex++));
             return html `
-        <button
-          class=${classMap({
-                option: true,
-                active: index === this.activeIndex,
-                [intentClass]: Boolean(intentClass),
-            })}
-          ?disabled=${option.disabled}
-          type="button"
-          @click=${() => this.selectOption(option)}
-          @mouseenter=${() => (this.activeIndex = index)}
-        >
-          ${optionIcon}
-          <span style="display:grid;gap:2px;flex:1;min-width:0;">
-            <span style="overflow:hidden;text-overflow:ellipsis;white-space:nowrap;">
-              ${option.label}
-            </span>
-            ${option.description
-                ? html `
-                  <span class="desc">${option.description}</span>
-                `
-                : null}
-          </span>
-        </button>
+        <div class="group">${header}${items}</div>
       `;
         });
     }
+    /** Renders a single option button. 渲染单个选项按钮。 */
+    renderOption(option, index) {
+        const intentClass = option.variant && option.variant !== 'default' ? option.variant : '';
+        const optionIcon = option.icon
+            ? html `
+          <aithe-icon class="option-icon" name=${option.icon} size="20"></aithe-icon>
+        `
+            : nothing;
+        return html `
+      <button
+        class=${classMap({
+            option: true,
+            active: index === this.activeIndex,
+            [intentClass]: Boolean(intentClass),
+        })}
+        ?disabled=${option.disabled}
+        type="button"
+        @click=${() => this.selectOption(option)}
+        @mouseenter=${() => (this.activeIndex = index)}
+      >
+        ${optionIcon}
+        <span style="display:grid;gap:2px;flex:1;min-width:0;">
+          <span style="overflow:hidden;text-overflow:ellipsis;white-space:nowrap;">
+            ${option.label}
+          </span>
+          ${option.description
+            ? html `
+                  <span class="desc">${option.description}</span>
+                `
+            : null}
+        </span>
+      </button>
+    `;
+    }
+    /** Groups filtered options by their `group` field. 按 group 字段对过滤后的选项聚合。 */
+    get groupedOptions() {
+        const map = new Map();
+        for (const opt of this.filteredOptions) {
+            const g = opt.group ?? '';
+            if (!map.has(g))
+                map.set(g, []);
+            map.get(g).push(opt);
+        }
+        const groups = [];
+        for (const [label, opts] of map) {
+            groups.push({ label: label || undefined, options: opts });
+        }
+        return groups;
+    }
 };
 __decorate([
     property({ type: String, attribute: 'options' })

package/dist/components/navigation/sub-menu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sub-menu.d.ts","sourceRoot":"","sources":["../../../src/components/navigation/sub-menu.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;;;;;;;GAgBG;AACH,qBACa,YAAa,SAAQ,YAAY;IAC5C,sDAAsD;IAC1B,IAAI,SAAM;IACtC,2DAA2D;IAC/B,KAAK,SAAM;IACvC,0DAA0D;IAC9B,IAAI,SAAM;IACtC,iDAAiD;IACL,QAAQ,UAAS;IAC7D,0DAA0D;IACd,IAAI,UAAS;IACzD,6DAA6D;IAC7B,MAAM,UAAS;IAC/C,4EAA4E;IAC5C,QAAQ,EAAE,YAAY,GAAG,UAAU,CAAc;IACjF,wMAAwM;IACxK,SAAS,UAAS;IAElD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA4FpB;IAEF,iBAAiB,IAAI,IAAI;IAIzB,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAuBtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAMrB;IAEF,MAAM;CAqDP"}
+{"version":3,"file":"sub-menu.d.ts","sourceRoot":"","sources":["../../../src/components/navigation/sub-menu.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;;;;;;;GAgBG;AACH,qBACa,YAAa,SAAQ,YAAY;IAC5C,sDAAsD;IAC1B,IAAI,SAAM;IACtC,2DAA2D;IAC/B,KAAK,SAAM;IACvC,0DAA0D;IAC9B,IAAI,SAAM;IACtC,iDAAiD;IACL,QAAQ,UAAS;IAC7D,0DAA0D;IACd,IAAI,UAAS;IACzD,6DAA6D;IAC7B,MAAM,UAAS;IAC/C,4EAA4E;IAC5C,QAAQ,EAAE,YAAY,GAAG,UAAU,CAAc;IACjF,wMAAwM;IACxK,SAAS,UAAS;IAElD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA2FpB;IAEF,iBAAiB,IAAI,IAAI;IAIzB,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAuBtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAMrB;IAEF,MAAM;CAqDP"}

package/dist/components/navigation/sub-menu.js

@@ -96,7 +96,6 @@ let AitheSubMenu = class AitheSubMenu extends AitheElement {
 
       .toggle.active {
         color: var(--aithe-color-text);
-        background: var(--aithe-color-surface-muted);
       }
 
       .toggle.active .toggle-icon {

package/dist/core/autoform/autoview.d.ts

@@ -0,0 +1,86 @@
+/**
+ * @file Auto-view registry & renderer types / 只读视图注册表与渲染器类型
+ * @description Defines the extension point for custom read-only field renderers.
+ *              Zero Lit dependency — pure types and a static registry, mirroring FormRegistry.
+ *              定义自定义只读字段渲染器的扩展点。
+ *              零 Lit 依赖 — 仅类型与静态注册表，与 FormRegistry 对称。
+ */
+import type { TemplateResult } from 'lit';
+import type { FormFieldConfig, FormItemOption } from './types';
+/**
+ * Extended field configuration for read-only views.
+ * 只读视图的扩展字段配置。
+ * @description Extends FormFieldConfig with optional display-only properties.
+ *             All extra fields are optional, so a plain FormFieldConfig can be used directly.
+ *             在 FormFieldConfig 基础上追加可选的展示属性，
+ *             全部可选，因此可直接传入纯 FormFieldConfig。
+ */
+export interface ViewFieldConfig extends FormFieldConfig {
+    /** Filter expression for formatting the value, e.g. "amount" / "date yyyy-MM-dd" / "empty". 值过滤器表达式。 */
+    filter?: string;
+    /** Placeholder text for empty values; falls back to the component's empty-text. 空值占位文本，回退到组件的全局 empty-text。 */
+    emptyText?: string;
+    /** Column span in the grid layout. Default 1. 网格中占用的列数，默认 1。 */
+    span?: number;
+    /** Row span in the grid layout. Default 1. 网格中占用的行数，默认 1。 */
+    rowspan?: number;
+    /** Content text alignment. 内容文本对齐方式。 */
+    align?: 'left' | 'center' | 'right';
+    /** Whether to hide the label cell. 是否隐藏标签单元格。 */
+    hideLabel?: boolean;
+}
+/**
+ * Context passed to a read-only view renderer.
+ * 传递给只读视图渲染器的上下文。
+ */
+export interface ViewRenderContext {
+    /** Transformed value (boolean for switch, number for number, string[] for checkbox, etc.). 转换后的值。 */
+    value: unknown;
+    /** Raw string value as stored in data. 原始字符串值。 */
+    rawValue: string;
+    /** Options for select/radio/checkbox controls. 选择类控件的选项。 */
+    options: FormItemOption[];
+    /** Full field configuration. 完整字段配置。 */
+    field: ViewFieldConfig;
+    /** Resolved empty placeholder text. 解析后的空值占位文本。 */
+    emptyText: string;
+}
+/**
+ * Read-only view renderer function. Returns a TemplateResult to be injected into a desc-item slot.
+ * 只读视图渲染函数，返回 TemplateResult 注入 desc-item 的 slot。
+ */
+export type ViewRenderer = (ctx: ViewRenderContext) => TemplateResult;
+/**
+ * Read-only view control type definition.
+ * 只读视图控件类型定义。
+ */
+export interface ViewControlDefinition {
+    /** Control type matching the `type` field in ViewFieldConfig. 匹配 ViewFieldConfig 中 type 字段的控件类型。 */
+    type: string;
+    /** Renderer function. 渲染函数。 */
+    render: ViewRenderer;
+}
+/**
+ * Read-only view control type registry. Allows registering custom renderers
+ * to extend autoview with arbitrary display logic for specific field types.
+ * 只读视图控件类型注册表。允许注册自定义渲染器，
+ * 以特定字段类型的任意展示逻辑扩展 autoview。
+ */
+export declare class ViewRegistry {
+    private static readonly _views;
+    /**
+     * Register a custom read-only renderer.
+     * 注册自定义只读渲染器。
+     * @throws Error if the type is already registered. 类型已注册时抛错。
+     */
+    static register(definition: ViewControlDefinition): void;
+    /** Unregister a view type. Returns whether the type existed. 注销视图类型，返回类型是否存在。 */
+    static unregister(type: string): boolean;
+    /** Get a view definition by type. 按 type 获取视图定义。 */
+    static get(type: string): ViewControlDefinition | undefined;
+    /** Check whether a view type is registered. 检查视图类型是否已注册。 */
+    static has(type: string): boolean;
+    /** List all registered view type names. 列出所有已注册的视图类型名。 */
+    static types(): string[];
+}
+//# sourceMappingURL=autoview.d.ts.map

package/dist/core/autoform/autoview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoview.d.ts","sourceRoot":"","sources":["../../../src/core/autoform/autoview.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAC;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE/D;;;;;;;GAOG;AACH,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,wGAAwG;IACxG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+GAA+G;IAC/G,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,qGAAqG;IACrG,KAAK,EAAE,OAAO,CAAC;IACf,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,wCAAwC;IACxC,KAAK,EAAE,eAAe,CAAC;IACvB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,iBAAiB,KAAK,cAAc,CAAC;AAEtE;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,oGAAoG;IACpG,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAA4C;IAE1E;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,qBAAqB,GAAG,IAAI;IAUxD,iFAAiF;IACjF,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIxC,oDAAoD;IACpD,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAI3D,4DAA4D;IAC5D,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,0DAA0D;IAC1D,MAAM,CAAC,KAAK,IAAI,MAAM,EAAE;CAGzB"}

package/dist/core/autoform/autoview.js

@@ -0,0 +1,37 @@
+/**
+ * Read-only view control type registry. Allows registering custom renderers
+ * to extend autoview with arbitrary display logic for specific field types.
+ * 只读视图控件类型注册表。允许注册自定义渲染器，
+ * 以特定字段类型的任意展示逻辑扩展 autoview。
+ */
+export class ViewRegistry {
+    static { this._views = new Map(); }
+    /**
+     * Register a custom read-only renderer.
+     * 注册自定义只读渲染器。
+     * @throws Error if the type is already registered. 类型已注册时抛错。
+     */
+    static register(definition) {
+        if (ViewRegistry._views.has(definition.type)) {
+            throw new Error(`[ViewRegistry] View type "${definition.type}" is already registered. ` +
+                `Call ViewRegistry.unregister() first if you want to replace it.`);
+        }
+        ViewRegistry._views.set(definition.type, definition);
+    }
+    /** Unregister a view type. Returns whether the type existed. 注销视图类型，返回类型是否存在。 */
+    static unregister(type) {
+        return ViewRegistry._views.delete(type);
+    }
+    /** Get a view definition by type. 按 type 获取视图定义。 */
+    static get(type) {
+        return ViewRegistry._views.get(type);
+    }
+    /** Check whether a view type is registered. 检查视图类型是否已注册。 */
+    static has(type) {
+        return ViewRegistry._views.has(type);
+    }
+    /** List all registered view type names. 列出所有已注册的视图类型名。 */
+    static types() {
+        return Array.from(ViewRegistry._views.keys());
+    }
+}

package/dist/core/autoform/index.d.ts

@@ -8,4 +8,6 @@ export { FormRuleEngine, FormRegistry } from './autoform';
 export type { FormDependencyState, FormControlRenderer, FormControlContext, FormControlDefinition, } from './autoform';
 export { FormCondition } from './condition';
 export type { FormRule, FormRuleType, FormFieldConfig, FormItemOption } from './types';
+export { ViewRegistry } from './autoview';
+export type { ViewFieldConfig, ViewRenderContext, ViewRenderer, ViewControlDefinition, } from './autoview';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/autoform/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/autoform/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1D,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/autoform/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1D,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEvF,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/core/autoform/index.js

@@ -6,3 +6,4 @@
  */
 export { FormRuleEngine, FormRegistry } from './autoform';
 export { FormCondition } from './condition';
+export { ViewRegistry } from './autoview';

package/dist/core/datahub/__tests__/force-options.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @file DataHubCore forceDedup / forceCache 选项测试
+ * @description 验证当 URL 不以 query/list/get 结尾时，
+ *              forceDedup 和 forceCache 选项能强制启用去重和缓存，
+ *              且不会被幂等守卫拦截。
+ */
+export {};
+//# sourceMappingURL=force-options.test.d.ts.map

package/dist/core/datahub/__tests__/force-options.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"force-options.test.d.ts","sourceRoot":"","sources":["../../../../src/core/datahub/__tests__/force-options.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}