@done-coding/admin-core 0.24.0 → 0.25.0

package/es/index.mjs

@@ -43,42 +43,43 @@ import { default as default40 } from "./components/app-layout/AppSidebar.vue.mjs
 import { default as default41 } from "./components/app-layout/AppTheme.vue.mjs";
 import { default as default42 } from "./components/misc/AutoRefresh.vue.mjs";
 import { default as default43 } from "./components/misc/AutoRefreshGroup.vue.mjs";
+import { default as default44 } from "./components/display/BadgeMark.vue.mjs";
 import { CORE_VIEWPORT_DECOR_ZINDEX_ABOVE, CORE_VIEWPORT_DECOR_ZINDEX_BELOW } from "./components/app-layout/viewport.mjs";
-import { default as default44, default as default45 } from "./components/modal/ModalConfirm.vue.mjs";
+import { default as default45, default as default46 } from "./components/modal/ModalConfirm.vue.mjs";
 import { DC_SLOT_ATTR, SlotRegion, parseSlotRegion } from "./config/slot-region.mjs";
-import { default as default46 } from "./components/data-view/DataGridView.vue.mjs";
+import { default as default47 } from "./components/data-view/DataGridView.vue.mjs";
 import { EXPORT_MAX_LIMIT, OPERATE_COLUMN_PROP, exportCSV, pickExportColumns } from "./utils/export.mjs";
 import { FORM_CONFIG_SELECT_ALL_VALUE, getConfirmPasswordRule, passwordRule, setFormComponentType } from "./helpers/form.mjs";
 import { FORM_ITEM_CHANGE_LOADING, NEST_LAYOUT_TIERS, ceilToTier, generateFormData, getBlurSubmit, getChangeSubmit, getDatePickerShortcuts, getEnterSubmit, getPlaceholder, getVModelSugar, parseFormData, resolveFormLayout, resolveLayoutSpan, setInputComponent, setSelectComponent, stringifyFormData, swiftFormItemConfig } from "./components/form/utils.mjs";
-import { default as default47 } from "./components/form/FormActiveFilter.vue.mjs";
-import { default as default48 } from "./components/form/FormItemNestForm.vue.mjs";
-import { default as default49 } from "./components/form/FormItemNestFormList.vue.mjs";
-import { default as default50 } from "./components/form/FormMain.vue.mjs";
-import { default as default51 } from "./components/form/FormSearch.vue.mjs";
-import { default as default52 } from "./components/form/FormShadowCloneDispatch.vue.mjs";
-import { default as default53 } from "./components/form/FormSortSwitch.vue.mjs";
-import { default as default54 } from "./components/form/FormSortSwitchGroup.vue.mjs";
-import { default as default55 } from "./components/form/FormSubmitPanel.vue.mjs";
-import { default as default56 } from "./components/form/FormUpload.vue.mjs";
-import { default as default57 } from "./components/form/FormUploadAudio.vue.mjs";
-import { default as default58 } from "./components/form/FormUploadImage.vue.mjs";
-import { default as default59 } from "./components/form/FormUploadVideo.vue.mjs";
-import { default as default60 } from "./components/form/FormVerifyImage.vue.mjs";
-import { default as default61 } from "./components/data-view/InfiniteListView.vue.mjs";
-import { default as default62, default as default63 } from "./components/list-layout/ListLayout.vue.mjs";
-import { default as default64 } from "./components/modal/ModalVideoPreview.vue.mjs";
-import { default as default65 } from "./components/panel/PanelEditSwitch.vue.mjs";
-import { default as default66 } from "./components/panel/PanelItem.vue.mjs";
-import { default as default67 } from "./components/panel/PanelItemNestForm.vue.mjs";
-import { default as default68 } from "./components/panel/PanelMain.vue.mjs";
+import { default as default48 } from "./components/form/FormActiveFilter.vue.mjs";
+import { default as default49 } from "./components/form/FormItemNestForm.vue.mjs";
+import { default as default50 } from "./components/form/FormItemNestFormList.vue.mjs";
+import { default as default51 } from "./components/form/FormMain.vue.mjs";
+import { default as default52 } from "./components/form/FormSearch.vue.mjs";
+import { default as default53 } from "./components/form/FormShadowCloneDispatch.vue.mjs";
+import { default as default54 } from "./components/form/FormSortSwitch.vue.mjs";
+import { default as default55 } from "./components/form/FormSortSwitchGroup.vue.mjs";
+import { default as default56 } from "./components/form/FormSubmitPanel.vue.mjs";
+import { default as default57 } from "./components/form/FormUpload.vue.mjs";
+import { default as default58 } from "./components/form/FormUploadAudio.vue.mjs";
+import { default as default59 } from "./components/form/FormUploadImage.vue.mjs";
+import { default as default60 } from "./components/form/FormUploadVideo.vue.mjs";
+import { default as default61 } from "./components/form/FormVerifyImage.vue.mjs";
+import { default as default62 } from "./components/data-view/InfiniteListView.vue.mjs";
+import { default as default63, default as default64 } from "./components/list-layout/ListLayout.vue.mjs";
+import { default as default65 } from "./components/modal/ModalVideoPreview.vue.mjs";
+import { default as default66 } from "./components/panel/PanelEditSwitch.vue.mjs";
+import { default as default67 } from "./components/panel/PanelItem.vue.mjs";
+import { default as default68 } from "./components/panel/PanelItemNestForm.vue.mjs";
+import { default as default69 } from "./components/panel/PanelMain.vue.mjs";
 import { ROUTE_MODULE_LEVEL, TabsMainReplaceQueryKey } from "./config/route.mjs";
-import { default as default69 } from "./components/slot-layout/SlotLayoutFlowAside.vue.mjs";
+import { default as default70 } from "./components/slot-layout/SlotLayoutFlowAside.vue.mjs";
 import { TABLE_COLUMN_KEY_OPERATE, TABLE_COLUMN_KEY_SELECTION } from "./components/table/constants.mjs";
-import { default as default70 } from "./components/table/TableMain.vue.mjs";
-import { default as default71 } from "./components/table/TableSkeleton.vue.mjs";
-import { default as default72 } from "./components/table/TableToolbar.vue.mjs";
-import { default as default73 } from "./components/modal/VideoPreviewTrigger.vue.mjs";
-import { default as default74 } from "./components/view-layout/ViewLayout.vue.mjs";
+import { default as default71 } from "./components/table/TableMain.vue.mjs";
+import { default as default72 } from "./components/table/TableSkeleton.vue.mjs";
+import { default as default73 } from "./components/table/TableToolbar.vue.mjs";
+import { default as default74 } from "./components/modal/VideoPreviewTrigger.vue.mjs";
+import { default as default75 } from "./components/view-layout/ViewLayout.vue.mjs";
 import { buildRhythmCss, useCoreThemeApply } from "./hooks/use-theme-apply.mjs";
 import { checkLogin } from "./router/guard/login.mjs";
 import { checkPermission } from "./router/guard/permission.mjs";
@@ -139,83 +140,84 @@ export {
   BODY_CONTENT_VIEWPORT_HEIGHT,
   BODY_CONTENT_VIEWPORT_INSET,
   BODY_CONTENT_VIEWPORT_RECT,
+  default44 as BadgeMark,
   default4 as BooleanTag,
   CORE_BRIDGE_KEY,
   CORE_VIEWPORT_DECOR_ZINDEX_ABOVE,
   CORE_VIEWPORT_DECOR_ZINDEX_BELOW,
-  default44 as ConfirmModal,
+  default45 as ConfirmModal,
   DC_SLOT_ATTR,
-  default46 as DataGridView,
+  default47 as DataGridView,
   default5 as DetailModal,
   EXPORT_MAX_LIMIT,
   FORM_CONFIG_SELECT_ALL_VALUE,
   FORM_ITEM_CHANGE_LOADING,
   FORM_NEST_REGISTRY_KEY,
-  default47 as FormActiveFilter,
+  default48 as FormActiveFilter,
   default7 as FormInput,
   default8 as FormInputShadowClone,
-  default48 as FormItemNestForm,
-  default49 as FormItemNestFormList,
-  default50 as FormMain,
+  default49 as FormItemNestForm,
+  default50 as FormItemNestFormList,
+  default51 as FormMain,
   default9 as FormModal,
   default11 as FormRadioGroup,
-  default51 as FormSearch,
+  default52 as FormSearch,
   default12 as FormSelect,
   default13 as FormSelectShadowClone,
-  default52 as FormShadowCloneDispatch,
-  default53 as FormSortSwitch,
-  default54 as FormSortSwitchGroup,
+  default53 as FormShadowCloneDispatch,
+  default54 as FormSortSwitch,
+  default55 as FormSortSwitchGroup,
   default14 as FormSubmitBtn,
-  default55 as FormSubmitPanel,
+  default56 as FormSubmitPanel,
   default15 as FormTree,
-  default56 as FormUpload,
-  default57 as FormUploadAudio,
-  default58 as FormUploadImage,
-  default59 as FormUploadVideo,
+  default57 as FormUpload,
+  default58 as FormUploadAudio,
+  default59 as FormUploadImage,
+  default60 as FormUploadVideo,
   default16 as FormVerifyCode,
-  default60 as FormVerifyImage,
+  default61 as FormVerifyImage,
   GLOBAL_MODAL_REMOTE_KEY,
   default17 as HeightProvider,
   default18 as ImagePreviewTrigger,
-  default61 as InfiniteListView,
-  default62 as ListLayout,
-  default63 as ListPage,
+  default62 as InfiniteListView,
+  default63 as ListLayout,
+  default64 as ListPage,
   default19 as MenuItemSub,
   default20 as MenuTree,
-  default45 as ModalConfirm,
+  default46 as ModalConfirm,
   default6 as ModalDetail,
   default10 as ModalForm,
   default21 as ModalImagePreview,
   default22 as ModalPorter,
   default23 as ModalShelf,
-  default64 as ModalVideoPreview,
+  default65 as ModalVideoPreview,
   NEST_LAYOUT_SCALE_KEY,
   NEST_LAYOUT_TIERS,
   OPERATE_COLUMN_PROP,
-  default65 as PanelEditSwitch,
-  default66 as PanelItem,
-  default67 as PanelItemNestForm,
+  default66 as PanelEditSwitch,
+  default67 as PanelItem,
+  default68 as PanelItemNestForm,
   default24 as PanelItemNestPanel,
-  default68 as PanelMain,
+  default69 as PanelMain,
   ROUTE_MODULE_LEVEL,
   SCOPE_VIEWPORT_MAX_HEIGHT,
   default25 as SelectModule,
   default26 as ShadowClone,
-  default69 as SlotLayoutFlowAside,
+  default70 as SlotLayoutFlowAside,
   default27 as SlotLayoutTemplate,
   SlotRegion,
   TABLE_COLUMN_KEY_OPERATE,
   TABLE_COLUMN_KEY_SELECTION,
   TABS_MAIN_VISUAL_LEVEL,
   default28 as TableEmpty,
-  default70 as TableMain,
-  default71 as TableSkeleton,
-  default72 as TableToolbar,
+  default71 as TableMain,
+  default72 as TableSkeleton,
+  default73 as TableToolbar,
   default29 as TabsMain,
   TabsMainReplaceQueryKey,
   default30 as TriggerAutoImport,
-  default73 as VideoPreviewTrigger,
-  default74 as ViewLayout,
+  default74 as VideoPreviewTrigger,
+  default75 as ViewLayout,
   default31 as WatchSize,
   buildRhythmCss,
   ceilToTier,

package/es/store/app.mjs

@@ -62,12 +62,22 @@ function createAppStore(deps) {
         return ((_a = pageLayout.value) == null ? void 0 : _a.bodyShimPadding) ?? bridge.APP_LAYOUT_BODY_CONFIG.shimPadding;
       }
     );
+    const viewportConfigEffective = computed(
+      () => {
+        var _a;
+        return ((_a = pageLayout.value) == null ? void 0 : _a.noViewportPadding) ? { paddingTop: 0, paddingRight: 0, paddingBottom: 0, paddingLeft: 0 } : bridge.APP_LAYOUT_VIEWPORT_CONFIG;
+      }
+    );
     const viewportPadding = computed(() => ({
-      top: `${bridge.APP_LAYOUT_VIEWPORT_CONFIG.paddingTop}px`,
-      right: `${bridge.APP_LAYOUT_VIEWPORT_CONFIG.paddingRight}px`,
-      bottom: `${bridge.APP_LAYOUT_VIEWPORT_CONFIG.paddingBottom}px`,
-      left: `${bridge.APP_LAYOUT_VIEWPORT_CONFIG.paddingLeft}px`
+      top: `${viewportConfigEffective.value.paddingTop}px`,
+      right: `${viewportConfigEffective.value.paddingRight}px`,
+      bottom: `${viewportConfigEffective.value.paddingBottom}px`,
+      left: `${viewportConfigEffective.value.paddingLeft}px`
     }));
+    const noAnimation = computed(() => {
+      var _a;
+      return ((_a = pageLayout.value) == null ? void 0 : _a.noAnimation) ?? false;
+    });
     const gapV = computed(() => bridge.APP_LAYOUT_GAP_CONFIG.size);
     const gpx = computed(() => `${gapV.value}px`);
     const headerStyle = computed(() => {
@@ -194,6 +204,8 @@ function createAppStore(deps) {
       bodyShimPadding,
       bodyShimStyle,
       viewportPadding,
+      viewportConfigEffective,
+      noAnimation,
       // 折叠态读 bridge 真相（架构反转，名字保留向后兼容）；aside 对称新增。
       // sidebar 侧经 sidebarCollapsedEffective 单点（分组形态闸为 false，见其注释）。
       sidebarIsCollapse: sidebarCollapsedEffective,

package/es/style.css

@@ -63,6 +63,13 @@
   justify-content: flex-end;
   gap: 8px;
 }
+.badge-mark[data-v-12868883] .el-badge__content.is-fixed {
+  right: 0;
+  transform: translateY(-50%) translateX(calc(100% + 2px));
+}
+.badge-mark_middle[data-v-12868883] .el-badge__content.is-fixed {
+  top: 50%;
+}
 .form-item-tip[data-v-8b508d64] {
   text-align: left;
   line-height: 1.5;
@@ -220,7 +227,7 @@
   height: 100%;
   background-color: #f4f4f4;
 }
-.tabs-main-bar[data-v-9d365b46] {
+.tabs-main-bar[data-v-1f3b9f99] {
   position: relative;
   display: flex;
   align-items: center;
@@ -230,37 +237,37 @@
   /* ============ Variant: indicator-compact —— 紧凑 1px 下划线 ============ */
   /* ============ Variant: plain —— 无装饰(active 加粗 + primary 字色) ============ */
 }
-.tabs-main-bar-item[data-v-9d365b46] {
+.tabs-main-bar-item[data-v-1f3b9f99] {
   border: none;
   background: transparent;
   cursor: pointer;
   color: var(--el-text-color-regular);
   transition: background 0.2s, color 0.2s, box-shadow 0.2s;
 }
-.tabs-main-bar-indicator[data-v-9d365b46] {
+.tabs-main-bar-indicator[data-v-1f3b9f99] {
   position: absolute;
   left: 0;
   background: var(--dc-core-primary-color);
   transition: transform 0.2s, width 0.2s;
 }
-.tabs-main-bar--l1 .tabs-main-bar-item[data-v-9d365b46] {
+.tabs-main-bar--l1 .tabs-main-bar-item[data-v-1f3b9f99] {
   font-size: 16px;
 }
-.tabs-main-bar--l2 .tabs-main-bar-item[data-v-9d365b46] {
+.tabs-main-bar--l2 .tabs-main-bar-item[data-v-1f3b9f99] {
   font-size: 14px;
 }
-.tabs-main-bar--l3 .tabs-main-bar-item[data-v-9d365b46] {
+.tabs-main-bar--l3 .tabs-main-bar-item[data-v-1f3b9f99] {
   font-size: 12px;
 }
-.tabs-main-bar--l4 .tabs-main-bar-item[data-v-9d365b46] {
+.tabs-main-bar--l4 .tabs-main-bar-item[data-v-1f3b9f99] {
   font-size: 12px;
 }
-.tabs-main-bar--variant-card[data-v-9d365b46] {
+.tabs-main-bar--variant-card[data-v-1f3b9f99] {
   position: relative;
   overflow: hidden;
   gap: 2px;
 }
-.tabs-main-bar--variant-card .tabs-main-bar-item[data-v-9d365b46] {
+.tabs-main-bar--variant-card .tabs-main-bar-item[data-v-1f3b9f99] {
   position: relative;
   padding: 8px 20px;
   line-height: 1.4;
@@ -268,17 +275,17 @@
   border-bottom: 0;
   border-radius: 6px 6px 0 0;
 }
-.tabs-main-bar--variant-card .tabs-main-bar-item[data-v-9d365b46]:hover:not(.tabs-main-bar-item_active) {
+.tabs-main-bar--variant-card .tabs-main-bar-item[data-v-1f3b9f99]:hover:not(.tabs-main-bar-item_active) {
   color: var(--dc-core-primary-color);
 }
-.tabs-main-bar--variant-card .tabs-main-bar-item_active[data-v-9d365b46] {
+.tabs-main-bar--variant-card .tabs-main-bar-item_active[data-v-1f3b9f99] {
   color: var(--dc-core-primary-color);
   border-color: var(--el-border-color-light);
   /* active item 两侧各延伸 100vw 灰线,共同模拟"全宽 separator 在 active item 处中断"
            active item 自身宽度内无线 → 视觉打通下方 content,完全 bg 无关 */
 }
-.tabs-main-bar--variant-card .tabs-main-bar-item_active[data-v-9d365b46]::before,
-.tabs-main-bar--variant-card .tabs-main-bar-item_active[data-v-9d365b46]::after {
+.tabs-main-bar--variant-card .tabs-main-bar-item_active[data-v-1f3b9f99]::before,
+.tabs-main-bar--variant-card .tabs-main-bar-item_active[data-v-1f3b9f99]::after {
   content: "";
   position: absolute;
   bottom: 0;
@@ -286,58 +293,58 @@
   height: 1px;
   background: var(--el-border-color-light);
 }
-.tabs-main-bar--variant-card .tabs-main-bar-item_active[data-v-9d365b46]::before {
+.tabs-main-bar--variant-card .tabs-main-bar-item_active[data-v-1f3b9f99]::before {
   right: 100%;
   /* 从 active item 左缘向左延伸 */
 }
-.tabs-main-bar--variant-card .tabs-main-bar-item_active[data-v-9d365b46]::after {
+.tabs-main-bar--variant-card .tabs-main-bar-item_active[data-v-1f3b9f99]::after {
   left: 100%;
   /* 从 active item 右缘向右延伸 */
 }
-.tabs-main-bar--variant-indicator .tabs-main-bar-item[data-v-9d365b46] {
+.tabs-main-bar--variant-indicator .tabs-main-bar-item[data-v-1f3b9f99] {
   padding: 8px 16px;
 }
-.tabs-main-bar--variant-indicator .tabs-main-bar-item_active[data-v-9d365b46] {
+.tabs-main-bar--variant-indicator .tabs-main-bar-item_active[data-v-1f3b9f99] {
   color: var(--dc-core-primary-color);
 }
-.tabs-main-bar--variant-indicator .tabs-main-bar-indicator[data-v-9d365b46] {
+.tabs-main-bar--variant-indicator .tabs-main-bar-indicator[data-v-1f3b9f99] {
   bottom: 0;
   height: 2px;
 }
-.tabs-main-bar--variant-indicator-compact .tabs-main-bar-item[data-v-9d365b46] {
+.tabs-main-bar--variant-indicator-compact .tabs-main-bar-item[data-v-1f3b9f99] {
   padding: 6px 10px;
 }
-.tabs-main-bar--variant-indicator-compact .tabs-main-bar-item_active[data-v-9d365b46] {
+.tabs-main-bar--variant-indicator-compact .tabs-main-bar-item_active[data-v-1f3b9f99] {
   color: var(--dc-core-primary-color);
 }
-.tabs-main-bar--variant-indicator-compact .tabs-main-bar-indicator[data-v-9d365b46] {
+.tabs-main-bar--variant-indicator-compact .tabs-main-bar-indicator[data-v-1f3b9f99] {
   bottom: 0;
   height: 1px;
 }
-.tabs-main-bar--variant-plain .tabs-main-bar-item[data-v-9d365b46] {
+.tabs-main-bar--variant-plain .tabs-main-bar-item[data-v-1f3b9f99] {
   padding: 4px 8px;
 }
-.tabs-main-bar--variant-plain .tabs-main-bar-item_active[data-v-9d365b46] {
+.tabs-main-bar--variant-plain .tabs-main-bar-item_active[data-v-1f3b9f99] {
   color: var(--dc-core-primary-color);
   font-weight: 600;
 }
-.dc-tabs-tile--nav-absolute[data-v-d9f0f521],
-.dc-tabs-tile--nav-fixed[data-v-d9f0f521] {
+.dc-tabs-tile--nav-absolute[data-v-acb4bb13],
+.dc-tabs-tile--nav-fixed[data-v-acb4bb13] {
   position: relative;
 }
-.dc-tabs-tile--nav-sticky[data-v-d9f0f521] {
+.dc-tabs-tile--nav-sticky[data-v-acb4bb13] {
   display: flex;
   flex-direction: column;
 }
-.dc-tabs-tile__scroll[data-v-d9f0f521] {
+.dc-tabs-tile__scroll[data-v-acb4bb13] {
   display: flex;
   flex-direction: column;
   gap: 12px;
 }
-.dc-tabs-tile__card[data-v-d9f0f521] {
+.dc-tabs-tile__card[data-v-acb4bb13] {
   width: 100%;
 }
-.dc-tabs-tile__nav[data-v-d9f0f521] {
+.dc-tabs-tile__nav[data-v-acb4bb13] {
   z-index: 2;
   max-height: 60%;
   overflow: auto;
@@ -442,7 +449,7 @@
   height: 100%;
   padding: 0 20px;
 }
-.app-header[data-v-c78820aa] {
+.app-header[data-v-40b13903] {
   transition-duration: 0.3s;
   transition-property: height;
   transition-timing-function: linear;
@@ -450,13 +457,13 @@
   box-shadow: var(--dc-core-shadow, var(--el-box-shadow));
   z-index: 1;
 }
-.app-header-module[data-v-c78820aa] {
+.app-header-module[data-v-40b13903] {
   display: flex;
   flex: 1;
   height: 100%;
   overflow-x: auto;
 }
-.app-header-module-item[data-v-c78820aa] {
+.app-header-module-item[data-v-40b13903] {
   display: flex;
   justify-content: center;
   align-items: center;
@@ -464,24 +471,24 @@
   white-space: nowrap;
   height: 100%;
 }
-.app-header-module-item[data-v-c78820aa]:hover,
-.app-header-module-item_active[data-v-c78820aa] {
-  color: var(--v8834c284);
+.app-header-module-item[data-v-40b13903]:hover,
+.app-header-module-item_active[data-v-40b13903] {
+  color: var(--v05959ac0);
 }
-.app-header-module-item_active[data-v-c78820aa] {
+.app-header-module-item_active[data-v-40b13903] {
   position: relative;
 }
-.app-header-module-item_active[data-v-c78820aa]::before {
+.app-header-module-item_active[data-v-40b13903]::before {
   content: "";
   position: absolute;
   left: 50%;
   top: 0;
   width: 100%;
   height: 3px;
-  background-color: var(--v8834c284);
+  background-color: var(--v05959ac0);
   transform: translateX(-50%);
 }
-.app-header-shim[data-v-c78820aa] {
+.app-header-shim[data-v-40b13903] {
   width: 100%;
   height: 100%;
   display: flex;
@@ -491,10 +498,10 @@
   font-size: 18px;
   font-weight: bold;
 }
-.app-header-module-item__icon[data-v-c78820aa] {
+.app-header-module-item__icon[data-v-40b13903] {
   margin-right: 8px;
 }
-.app-header-right[data-v-c78820aa] {
+.app-header-right[data-v-40b13903] {
   padding-left: 80px;
   display: flex;
   align-items: center;
@@ -593,13 +600,21 @@
 .dc-modal-video-preview__overlay {
   background: var(--el-overlay-color-dark, rgba(0, 0, 0, 0.7));
 }
-.app-layout[data-v-b45bcdfd] {
+.app-layout[data-v-b68520cd] {
   position: relative;
 }
-.app-layout_noLogin[data-v-b45bcdfd] .app-body,
-.app-layout_noLogin[data-v-b45bcdfd] .app-sidebar,
-.app-layout_noLogin[data-v-b45bcdfd] .app-header,
-.app-layout_noLogin[data-v-b45bcdfd] .app-footer {
+.app-layout_noLogin[data-v-b68520cd] .app-body,
+.app-layout_noAnimation[data-v-b68520cd] .app-body,
+.app-layout_noLogin[data-v-b68520cd] .app-sidebar,
+.app-layout_noAnimation[data-v-b68520cd] .app-sidebar,
+.app-layout_noLogin[data-v-b68520cd] .app-aside,
+.app-layout_noAnimation[data-v-b68520cd] .app-aside,
+.app-layout_noLogin[data-v-b68520cd] .app-header,
+.app-layout_noAnimation[data-v-b68520cd] .app-header,
+.app-layout_noLogin[data-v-b68520cd] .app-footer,
+.app-layout_noAnimation[data-v-b68520cd] .app-footer,
+.app-layout_noLogin[data-v-b68520cd] .app-collapse-toggle,
+.app-layout_noAnimation[data-v-b68520cd] .app-collapse-toggle {
   transition: none !important;
 }
 .app-page[data-v-2359c6df] {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@done-coding/admin-core",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "description": "内部前端库",
   "private": false,
   "main": "es/index.mjs",
@@ -83,5 +83,5 @@
   "dependencies": {
     "@tanstack/vue-virtual": "^3.13.35"
   },
-  "gitHead": "90ee71f640f4bea4039dd6e886c205815126a2f5"
+  "gitHead": "bb7ff7c309925c6b9738383a60e3a62a80ee99b4"
 }

package/src/bridge/README.md

@@ -1,5 +1,5 @@
 # bridge 模块（接线中枢）
 
-`createCoreBridge(options)` 产出 `CoreBridge` 单例——认证 / 布局 / 主题 / 路由派生的总接线口，经 `app.use(bridge)` 全局注入（`CORE_BRIDGE_KEY`）。
+`createCoreBridge(options)` 产出 `CoreBridge` 单例——认证 / 布局 / 主题 / 徽标 / 路由派生的总接线口，经 `app.use(bridge)` 全局注入（`CORE_BRIDGE_KEY`）。
 
 > 详情见 [docs/README.md](./docs/README.md)（导出面 / 接线范式 / 认证与请求接线）

package/src/bridge/docs/README.md

@@ -9,7 +9,8 @@ core 的「实例化中枢」：`createCoreBridge(options)` 产出 `CoreBridge`
 | 符号 | 职责 |
 | --- | --- |
 | `createCoreBridge` | 工厂：传入 `CoreBridgeInitOptions`（配置 schema + auth facade + 存储 + 主题初值等），产出 `CoreBridge` |
-| `CoreBridge` | 实例接口：`update()` 响应式更新 8 组配置视图 + `theme` 模块 + `layout` 折叠模块 + auth/api/路由派生方法 |
+| `CoreBridge` | 实例接口：`update()` 响应式更新 8 组配置视图 + `theme` 模块 + `layout` 折叠模块 + `badge` 徽标注册表 + auth/api/路由派生方法 |
+| `BadgeEntry` / `CoreBadgeModule` | 徽标注册表契约（见下「徽标注册表」章节） |
 | `CoreBridgeRegisterOptions` | 注册选项类型（配置键 → 默认值/访问器） |
 | `AppConfig` / `AppEnvInfo` | 配置 schema 顶层类型 |
 | `AppLayout*Config`（Header/Footer/Sidebar/Aside/Body/Viewport/Gap） | 布局 7 组配置视图类型（`update` 改它们即响应式生效） |
@@ -19,7 +20,7 @@ core 的「实例化中枢」：`createCoreBridge(options)` 产出 `CoreBridge`
 | `UserInfoAccess` / `UserInfoFieldAccessor` / `UserInfoPermissionAccessor` | userInfo 字段/权限访问器契约 |
 | `AppBaseInfo` 等类型别名 | 各配置视图的便捷类型 |
 
-**模块拆分**（规则 12：按耦合度独立文件）：`theme/`（createBridgeThemeHook：风格 map + setStyle/setDark + 响应式 + 持久化）、`layout.ts`（折叠）、`plugin.ts`（插件注册）、`config-hook.ts`、`route.ts`（路由派生）、`state.ts`（useState 工厂）、`storage.ts`（命名空间存储）。
+**模块拆分**（规则 12：按耦合度独立文件）：`theme/`（createBridgeThemeHook：风格 map + setStyle/setDark + 响应式 + 持久化）、`layout.ts`（折叠）、`badge.ts`（徽标注册表）、`plugin.ts`（插件注册）、`config-hook.ts`、`route.ts`（路由派生）、`state.ts`（useState 工厂）、`storage.ts`（命名空间存储）。
 
 ## 快速上手（接线范式）
 
@@ -49,6 +50,101 @@ appCoreBridge.theme.setStyle("studio-stage");
 appCoreBridge.theme.setDark(true);
 ```
 
+## 徽标注册表（`bridge.badge`）
+
+一张扁平的 `key → 标记` 表；菜单项与 `ActionBtn` 按 key 查表渲染**绝对定位角标**（跟在文案右侧，**不压字**，且[MUST] 不改变宿主尺寸）。
+
+**分工**：core **只负责展示**——聚合、归属、清标、数据来源全部在 app。
+
+### 契约
+
+```ts
+type BadgeEntry = {
+  /** 展示截止的绝对时间（epoch ms）；缺省或 0 = 永久展示 */
+  expireAt?: number;
+  /** 面向 agent / AI 对话的语义描述（core 不消费，纯透传；自由文本） */
+  description?: string;
+} & (
+  | { kind: "count";   value: number; max?: number }   // 数字角标
+  | { kind: "new" }        // 新上线
+  | { kind: "updated" }    // 更新
+  | { kind: "beta" }       // 内测：能用，不稳定
+  | { kind: "wip" }        // 开发：不可用（可用性由 app 自行处置）
+  | { kind: "custom";  text: string; type?: BadgeProps["type"] }
+);
+```
+
+内置五档的文案与语义色由 core 统一定，保证跨 app 一致；`custom` 只在内置档不够用时用。
+
+`custom.type` 取 element-plus 的语义色档（`primary` / `success` / `warning` / `danger` / `info`），随主题亮暗自适配。[MUST NOT] 传色值字面量——规则 14，写死色切主题不响应。
+
+### API
+
+| 成员 | 用途 |
+| --- | --- |
+| `marks` | 全部标记（响应式只读；内部 `shallowRef`，每次操作产新对象） |
+| `setAll(map)` | **整体替换** —— 轮询主路径，服务端本轮撤下的标随之消失 |
+| `set(key, entry)` | 单点写入 / 覆盖 |
+| `remove(key)` | 单点移除 |
+
+⚠️ [MUST NOT] 用 `bridge.update()` 维护徽标：它是 `Object.assign` **浅合并**，轮询场景下服务端已撤下的标会永远留在表里。徽标独立走 `bridge.badge`。
+
+### 两条失效路径（正交，可共存）
+
+| 标记有无 `expireAt` | 怎么消失 | 谁负责 |
+| --- | --- | --- |
+| **有**（如随版本写死到某日的 NEW） | core 内部 60s tick 到点自动落 | core，app 不用管 |
+| **无**（如服务端来的待办数 / Beta 标） | app 下一轮 `setAll` 刷掉 | app 的轮询节奏决定 |
+
+`expireAt` **不是必填**——它是给「没有轮询通道」的静态标准备的兜底；有轮询的场景压根不用填。
+
+### key 约定
+
+| 消费点 | key 取值 |
+| --- | --- |
+| 菜单项（AppSidebar 菜单树 / AppHeader 模块条） | **路由 `path`**，无需另配 |
+| `ActionBtn` | 显式 `badgeKey`（按钮没有 path） |
+| `TabsMain` 的 tab 标题（tab-bar / tile 卡片 / tile 角落 nav 三处同步） | `TabsMainItem.badgeKey`。[MUST NOT] 复用 `item.key`——那是**局部唯一**（v-model 值 + 槽名），跨页会串标 |
+
+### `description`：让这张表可被 agent 读
+
+`description` 是 **core 完全不消费**的纯透传字段，供应用层做「本期上了什么功能」这类 AI 对话时，让模型知道某个 key 指向什么、怎么用、什么时候还不该用。
+
+配合已有的 `kind`（= 变更类别，与 [Keep a Changelog](https://keepachangelog.com/) 的 Added / Changed 词汇同构）+ `expireAt`（时效），这张表本身就是一份**机器可读的功能公告**——业界的 Beamer / Headway / LaunchNotes 变更日志、Pendo / Appcues 功能采纳平台，维护的都是同构的 `{类别, 描述, 时效, 受众}` 条目。
+
+```ts
+bridge.badge.set("order.export", {
+  kind: "beta",
+  description:
+    "批量导出订单为 Excel。适合按月对账；单次超 10 万行会超时，内测期不建议用于生产对账。",
+});
+```
+
+**约定：core 内给 agent 读的描述统一挂在 `description` 字段名上；形状按任务定。**
+
+| 场景 | 类型 | 为什么 |
+| --- | --- | --- |
+| **选型**（主题 preset，35 套里挑一套） | `CoreConfigDescription` 的 `{suitable, unsuitable}` 正反 facets | 闭集选型；`unsuitable` 可做**无需 LLM 的廉价预筛**，也强迫作者写清排除条件 |
+| **讲解**（徽标，说明某功能是什么） | 自由文本 `string` | 对齐 MCP / OpenAI function calling / JSON Schema 的 tool `description` 范式（均单 string，约定把「何时用 / 何时不该用」写在同一段）。讲解场景不做排除，拆正反会让「新功能的不宜选场景是什么」无从填起 |
+
+[MUST NOT] 为「统一」立一个只含 `description` 的空壳基类让两边继承——形状本就不同，继承收益为零；且 agent 侧读描述最终都是拼进 prompt 的文本，形状差异几乎零成本。
+
+⚠️ **边界**：重内容（图文步骤 / 深链 / 视频 / 前置条件）[SHOULD] 走 app 自己的知识库、用**同一 key 关联**，[MUST NOT] 往 `description` 堆——否则 `BadgeEntry` 会从「一个标」膨胀成 CMS 条目，core 被迫维护一个自己不消费的复杂 schema。
+
+> 产品提醒：AI 主动推销「本期新功能」极易变成打扰（Clippy 陷阱）。要做 [SHOULD] 守低风险、可逆、ambient（不抢焦点）、用户始终在控制位。
+
+### 已知限制（[MUST] 知悉，非缺陷）
+
+- **时钟源是客户端**：用户机器时间不准或被改，`expireAt` 判定会偏。徽标是装饰，未做服务端对时。
+- **到期最多滞留 60s**：tick 粒度，非实时。全 app 共享一个定时器，非每标一个。
+- **不做冒泡聚合**：core [MUST NOT] 把子级的标上卷到父级菜单，见下。
+
+### 为什么不做冒泡聚合
+
+聚合要求 core 知道「一个 entry 归属哪个路由」，而真实系统里这个归属是多对多且有例外——弹窗里的按钮、全局工具栏按钮、一个入口同时挂在两个模块下。core 一旦定义归属模型，就是在替业务定信息架构，属越权。
+
+需要「一级模块上有引导点」的效果：**app 自己算完，直接往父级 path 写一条 entry**，同样达到效果且归属规则完全可控。
+
 ## 布局配置里的行为开关
 
 布局 8 组配置多为几何数值（宽高 / 间距 / 配色），少数是**行为开关**——需要单独知道语义：

package/src/components/app-layout/README.md

@@ -10,7 +10,7 @@
 | `AppLayout` | 应用布局总控：bridge/appStore/userStore 三注入 + 5 内容锚 + 内置默认经典布局 shell | `bridge`（必填）`appStore`（必填）`userStore`（必填）`watermarkContent` `sidebarAboveHeader` | [README-AppLayout.md](./docs/README-AppLayout.md) |
 | `AppPage` | 页面主体容器：撑满视口 + 四向悬浮 fixed 插槽 | `fullViewport` `fullMode` `gap` `topBg`/`bottomBg`/`leftBg`/`rightBg` `nextViewportMaxHeight` | [README-AppPage.md](./docs/README-AppPage.md) |
 | `AppBody` | 内容主体：内置 RouterView + KeepAlive + 面包屑 affix + #footer 槽 | `menuFlatList` | [README-AppBody.md](./docs/README-AppBody.md) |
-| `AppHeader` | 顶栏积木：#left 品牌 + 路由模块菜单 + #right 操作区 | `menus` `menuFlatList`（必填）`show`（未消费） | [README-AppHeader.md](./docs/README-AppHeader.md) |
+| `AppHeader` | 顶栏积木：#left 品牌 + 路由模块菜单（按 path 查 bridge.badge 显徽标）+ #right 操作区 | `menus` `menuFlatList`（必填）`show`（未消费） | [README-AppHeader.md](./docs/README-AppHeader.md) |
 | `AppSidebar` | 侧边栏积木：折叠把手 + MenuTree 菜单（树形/分组双形态）+ #top/#bottom 高度自撑 | `show` `menus`（必填）`menuFlatList`（必填）`aboveHeader`；菜单形态读 bridge `APP_LAYOUT_SIDEBAR_CONFIG.menuGroupMode`（分组态无折叠把手） | [README-AppSidebar.md](./docs/README-AppSidebar.md) |
 | `AppAside` | 右侧补充区积木（对称 AppSidebar），无内置内容 | `show` | [README-AppAside.md](./docs/README-AppAside.md) |
 | `AppBreadcrumb` | 面包屑积木：menuFlatList 匹配 route.matched 出链 | `height`（必填）`menuFlatList`（必填） | [README-AppBreadcrumb.md](./docs/README-AppBreadcrumb.md) |