@ug666/admin-react 0.1.0-beta.0 → 0.1.0-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 UG666
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,80 @@
1
+ import {
2
+ AdminPage2
3
+ } from "./AdminColumnSettings-be5c6tmr.js";
4
+
5
+ // packages/admin-react/src/patterns/AdminListPage.tsx
6
+ import { jsxDEV } from "react/jsx-dev-runtime";
7
+ function AdminListPage2({
8
+ search,
9
+ summary,
10
+ searchId,
11
+ searchHidden = false,
12
+ toolbarStart,
13
+ toolbarEnd,
14
+ children,
15
+ footer,
16
+ ...pageProps
17
+ }) {
18
+ const { title, primaryAction, secondaryActions, ...rest } = pageProps;
19
+ const hasActions = Boolean(primaryAction || secondaryActions || toolbarEnd);
20
+ return /* @__PURE__ */ jsxDEV(AdminPage2, {
21
+ ...rest,
22
+ className: "admin-page--list",
23
+ title,
24
+ visuallyHiddenHeader: true,
25
+ children: [
26
+ search ? /* @__PURE__ */ jsxDEV("div", {
27
+ className: "admin-list-search-panel",
28
+ hidden: searchHidden,
29
+ id: searchId,
30
+ children: /* @__PURE__ */ jsxDEV("div", {
31
+ className: "admin-list-search",
32
+ children: search
33
+ }, undefined, false, undefined, this)
34
+ }, undefined, false, undefined, this) : null,
35
+ /* @__PURE__ */ jsxDEV("div", {
36
+ className: "admin-list-panel",
37
+ children: [
38
+ /* @__PURE__ */ jsxDEV("div", {
39
+ className: "admin-list-header",
40
+ children: [
41
+ /* @__PURE__ */ jsxDEV("h2", {
42
+ className: "admin-list-header__title",
43
+ children: title
44
+ }, undefined, false, undefined, this),
45
+ hasActions ? /* @__PURE__ */ jsxDEV("div", {
46
+ className: "admin-list-header__actions",
47
+ children: [
48
+ secondaryActions,
49
+ primaryAction,
50
+ toolbarEnd ? /* @__PURE__ */ jsxDEV("div", {
51
+ className: "admin-list-header__tools",
52
+ children: toolbarEnd
53
+ }, undefined, false, undefined, this) : null
54
+ ]
55
+ }, undefined, true, undefined, this) : null
56
+ ]
57
+ }, undefined, true, undefined, this),
58
+ summary,
59
+ toolbarStart ? /* @__PURE__ */ jsxDEV("div", {
60
+ className: "admin-list-actions",
61
+ children: /* @__PURE__ */ jsxDEV("div", {
62
+ className: "admin-list-actions__start",
63
+ children: toolbarStart
64
+ }, undefined, false, undefined, this)
65
+ }, undefined, false, undefined, this) : null,
66
+ /* @__PURE__ */ jsxDEV("div", {
67
+ className: "admin-list-content",
68
+ children
69
+ }, undefined, false, undefined, this),
70
+ footer ? /* @__PURE__ */ jsxDEV("div", {
71
+ className: "admin-list-footer",
72
+ children: footer
73
+ }, undefined, false, undefined, this) : null
74
+ ]
75
+ }, undefined, true, undefined, this)
76
+ ]
77
+ }, undefined, true, undefined, this);
78
+ }
79
+
80
+ export { AdminListPage2 };
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  AdminPage2
3
- } from "./index-keve3ryw.js";
3
+ } from "./AdminColumnSettings-be5c6tmr.js";
4
4
 
5
5
  // packages/admin-react/src/patterns/AdminFormPage.tsx
6
6
  import { t } from "@ug666/admin-core/i18n";
@@ -0,0 +1,64 @@
1
+ // packages/admin-react/src/patterns/AdminTabContextMenu.tsx
2
+ import {
3
+ UGContextMenu,
4
+ UGContextMenuContent,
5
+ UGContextMenuItem,
6
+ UGContextMenuTrigger
7
+ } from "@ug666/ui-react";
8
+ import { useRef } from "react";
9
+ import { jsxDEV } from "react/jsx-dev-runtime";
10
+ function AdminTabContextMenu2({
11
+ tabs,
12
+ onCloseOthers,
13
+ children
14
+ }) {
15
+ const trigger = useRef(null);
16
+ const tabId = useRef(undefined);
17
+ function prepare(event) {
18
+ if (!(event.target instanceof Element))
19
+ return;
20
+ const item = event.target.closest('[data-ug="app-tabs"] [data-ug-slot="item"]');
21
+ const value = item?.dataset.value;
22
+ if (!value || !tabs.some((tab) => tab.id !== value && tab.closable)) {
23
+ event.stopPropagation();
24
+ return;
25
+ }
26
+ tabId.current = value;
27
+ trigger.current = item?.querySelector('[data-ug-slot="trigger"]') ?? null;
28
+ }
29
+ function restoreFocus() {
30
+ const target = trigger.current;
31
+ requestAnimationFrame(() => target?.focus({ preventScroll: true }));
32
+ }
33
+ return /* @__PURE__ */ jsxDEV(UGContextMenu, {
34
+ className: "admin-tab-menu",
35
+ children: [
36
+ /* @__PURE__ */ jsxDEV(UGContextMenuTrigger, {
37
+ className: "admin-tab-menu__trigger",
38
+ onContextMenuCapture: prepare,
39
+ onKeyDownCapture: (event) => {
40
+ if (event.key === "ContextMenu" || event.shiftKey && event.key === "F10")
41
+ prepare(event);
42
+ },
43
+ children
44
+ }, undefined, false, undefined, this),
45
+ /* @__PURE__ */ jsxDEV(UGContextMenuContent, {
46
+ "aria-label": "页签操作",
47
+ children: /* @__PURE__ */ jsxDEV(UGContextMenuItem, {
48
+ onClick: () => {
49
+ if (tabId.current)
50
+ onCloseOthers(tabId.current);
51
+ restoreFocus();
52
+ },
53
+ onKeyDown: (event) => {
54
+ if (event.key === "Escape")
55
+ restoreFocus();
56
+ },
57
+ children: "关闭其他页签"
58
+ }, undefined, false, undefined, this)
59
+ }, undefined, false, undefined, this)
60
+ ]
61
+ }, undefined, true, undefined, this);
62
+ }
63
+
64
+ export { AdminTabContextMenu2 };
@@ -5,6 +5,7 @@ function AdminPage2({
5
5
  className,
6
6
  title,
7
7
  description,
8
+ showDescription = false,
8
9
  badge,
9
10
  meta,
10
11
  primaryAction,
@@ -27,9 +28,12 @@ function AdminPage2({
27
28
  }, undefined, false, undefined, this) : /* @__PURE__ */ jsxDEV(UGPageHeader, {
28
29
  actions,
29
30
  badge,
30
- description,
31
+ description: showDescription ? description : undefined,
31
32
  meta,
32
- title
33
+ title: /* @__PURE__ */ jsxDEV("span", {
34
+ className: "admin-page__title",
35
+ children: title
36
+ }, undefined, false, undefined, this)
33
37
  }, undefined, false, undefined, this),
34
38
  children
35
39
  ]
@@ -0,0 +1,88 @@
1
+ // packages/admin-react/src/patterns/AdminFormDialog.tsx
2
+ import {
3
+ UGButton,
4
+ UGModal,
5
+ UGModalBody,
6
+ UGModalCloseButton,
7
+ UGModalContent,
8
+ UGModalFooter,
9
+ UGModalHeader,
10
+ UGModalTitle
11
+ } from "@ug666/ui-react";
12
+ import { useId } from "react";
13
+ import { jsxDEV } from "react/jsx-dev-runtime";
14
+ function AdminFormDialog2({
15
+ open,
16
+ title,
17
+ submitLabel,
18
+ cancelLabel = "取消",
19
+ loading = false,
20
+ disabled = false,
21
+ closeOnOverlay = true,
22
+ initialFocusSelector,
23
+ size,
24
+ onClose,
25
+ onSubmit,
26
+ children
27
+ }) {
28
+ const formId = useId();
29
+ function handleSubmit(event) {
30
+ event.preventDefault();
31
+ if (!loading && !disabled)
32
+ onSubmit();
33
+ }
34
+ return /* @__PURE__ */ jsxDEV(UGModal, {
35
+ ariaLabel: title,
36
+ closeOnEsc: !loading,
37
+ closeOnOverlay: closeOnOverlay && !loading,
38
+ initialFocusSelector,
39
+ onClose: () => {
40
+ if (!loading)
41
+ onClose();
42
+ },
43
+ open,
44
+ size,
45
+ children: /* @__PURE__ */ jsxDEV(UGModalContent, {
46
+ children: [
47
+ /* @__PURE__ */ jsxDEV(UGModalHeader, {
48
+ children: [
49
+ /* @__PURE__ */ jsxDEV(UGModalTitle, {
50
+ children: title
51
+ }, undefined, false, undefined, this),
52
+ !loading ? /* @__PURE__ */ jsxDEV(UGModalCloseButton, {}, undefined, false, undefined, this) : null
53
+ ]
54
+ }, undefined, true, undefined, this),
55
+ /* @__PURE__ */ jsxDEV(UGModalBody, {
56
+ children: /* @__PURE__ */ jsxDEV("form", {
57
+ className: "admin-section-form",
58
+ id: formId,
59
+ onSubmit: handleSubmit,
60
+ children
61
+ }, undefined, false, undefined, this)
62
+ }, undefined, false, undefined, this),
63
+ /* @__PURE__ */ jsxDEV(UGModalFooter, {
64
+ children: [
65
+ /* @__PURE__ */ jsxDEV(UGButton, {
66
+ disabled: loading,
67
+ onClick: onClose,
68
+ type: "button",
69
+ variant: "text",
70
+ children: cancelLabel
71
+ }, undefined, false, undefined, this),
72
+ /* @__PURE__ */ jsxDEV(UGButton, {
73
+ disabled,
74
+ form: formId,
75
+ loading,
76
+ tone: "primary",
77
+ type: "submit",
78
+ variant: "solid",
79
+ children: submitLabel
80
+ }, undefined, false, undefined, this)
81
+ ]
82
+ }, undefined, true, undefined, this)
83
+ ]
84
+ }, undefined, true, undefined, this)
85
+ }, undefined, false, undefined, this);
86
+ }
87
+
88
+ export { AdminFormDialog2 };
@@ -0,0 +1,177 @@
1
+ // packages/admin-react/src/patterns/AdminColumnSettings.tsx
2
+ import {
3
+ adminColumnPinLabel,
4
+ cycleAdminColumnSide,
5
+ moveAdminColumn,
6
+ orderAdminColumns,
7
+ readAdminColumnLayout,
8
+ writeAdminColumnLayout
9
+ } from "@ug666/admin-core/page/column-layout";
10
+ import {
11
+ UGButton,
12
+ UGCheckbox,
13
+ UGPopover,
14
+ UGPopoverContent,
15
+ UGPopoverTrigger
16
+ } from "@ug666/ui-react";
17
+ import { GripVertical, Pin, Settings2 } from "lucide-react";
18
+ import { useRef, useState } from "react";
19
+ import { jsxDEV } from "react/jsx-dev-runtime";
20
+ function useAdminColumnLayout2(scope) {
21
+ const [layout, setLayout] = useState(() => readAdminColumnLayout(scope, window.localStorage));
22
+ function changeLayout(next) {
23
+ setLayout(next);
24
+ writeAdminColumnLayout(scope, next, window.localStorage);
25
+ }
26
+ return [layout, changeLayout];
27
+ }
28
+ function AdminColumnSettings2({
29
+ columns,
30
+ hidden,
31
+ onChange,
32
+ ariaLabel = "列设置",
33
+ triggerLabel,
34
+ layout,
35
+ onLayoutChange
36
+ }) {
37
+ const dragged = useRef(null);
38
+ const orderedColumns = orderAdminColumns(columns, layout?.order ?? []);
39
+ const order = orderedColumns.map((column) => column.id);
40
+ const visibleCount = columns.filter((column) => column.required || !hidden.includes(column.id)).length;
41
+ function toggle(id, visible) {
42
+ if (!visible && visibleCount <= 1)
43
+ return;
44
+ onChange(visible ? hidden.filter((item) => item !== id) : [...new Set([...hidden, id])]);
45
+ }
46
+ function move(id, target) {
47
+ if (layout && id !== target)
48
+ onLayoutChange?.({ ...layout, order: moveAdminColumn(order, id, target) });
49
+ }
50
+ return /* @__PURE__ */ jsxDEV(UGPopover, {
51
+ children: [
52
+ /* @__PURE__ */ jsxDEV(UGPopoverTrigger, {
53
+ className: "inline-flex",
54
+ children: /* @__PURE__ */ jsxDEV(UGButton, {
55
+ "aria-label": ariaLabel,
56
+ size: triggerLabel ? "default" : "icon",
57
+ title: triggerLabel ? undefined : ariaLabel,
58
+ type: "button",
59
+ variant: "outline",
60
+ children: [
61
+ /* @__PURE__ */ jsxDEV(Settings2, {
62
+ "aria-hidden": "true",
63
+ size: 16
64
+ }, undefined, false, undefined, this),
65
+ triggerLabel
66
+ ]
67
+ }, undefined, true, undefined, this)
68
+ }, undefined, false, undefined, this),
69
+ /* @__PURE__ */ jsxDEV(UGPopoverContent, {
70
+ align: "end",
71
+ className: "admin-column-settings",
72
+ side: "bottom",
73
+ children: [
74
+ /* @__PURE__ */ jsxDEV("div", {
75
+ className: "admin-column-settings__head",
76
+ children: [
77
+ /* @__PURE__ */ jsxDEV("strong", {
78
+ children: "显示列"
79
+ }, undefined, false, undefined, this),
80
+ /* @__PURE__ */ jsxDEV(UGButton, {
81
+ onClick: () => onChange([]),
82
+ size: "sm",
83
+ type: "button",
84
+ variant: "text",
85
+ children: "全部显示"
86
+ }, undefined, false, undefined, this)
87
+ ]
88
+ }, undefined, true, undefined, this),
89
+ /* @__PURE__ */ jsxDEV("div", {
90
+ className: "admin-column-settings__list",
91
+ children: orderedColumns.map((column, index) => {
92
+ const visible = Boolean(column.required) || !hidden.includes(column.id);
93
+ const title = typeof column.header === "string" ? column.header : column.id;
94
+ const side = layout?.fixed[column.id];
95
+ const pinLabel = adminColumnPinLabel(side, title);
96
+ return /* @__PURE__ */ jsxDEV("div", {
97
+ className: "admin-column-settings__row",
98
+ onDragOver: (event) => {
99
+ if (dragged.current)
100
+ event.preventDefault();
101
+ },
102
+ onDrop: (event) => {
103
+ if (!dragged.current)
104
+ return;
105
+ event.preventDefault();
106
+ move(dragged.current, column.id);
107
+ dragged.current = null;
108
+ },
109
+ children: [
110
+ layout && onLayoutChange ? /* @__PURE__ */ jsxDEV(UGButton, {
111
+ "aria-label": `调整${title}的列顺序`,
112
+ "aria-keyshortcuts": "ArrowUp ArrowDown",
113
+ className: "admin-column-settings__grip",
114
+ draggable: true,
115
+ onDragStart: (event) => {
116
+ dragged.current = column.id;
117
+ event.dataTransfer.effectAllowed = "move";
118
+ event.dataTransfer.setData("text/plain", column.id);
119
+ },
120
+ onDragEnd: () => {
121
+ dragged.current = null;
122
+ },
123
+ onKeyDown: (event) => {
124
+ if (event.key !== "ArrowUp" && event.key !== "ArrowDown")
125
+ return;
126
+ event.preventDefault();
127
+ const target = order[index + (event.key === "ArrowUp" ? -1 : 1)];
128
+ if (target)
129
+ move(column.id, target);
130
+ },
131
+ size: "icon-sm",
132
+ title: "拖动或按方向键调整列顺序",
133
+ type: "button",
134
+ variant: "ghost",
135
+ children: /* @__PURE__ */ jsxDEV(GripVertical, {
136
+ "aria-hidden": "true",
137
+ size: 14
138
+ }, undefined, false, undefined, this)
139
+ }, undefined, false, undefined, this) : null,
140
+ /* @__PURE__ */ jsxDEV(UGCheckbox, {
141
+ checked: visible,
142
+ disabled: column.required || visible && visibleCount <= 1,
143
+ label: title,
144
+ onCheckedChange: (checked) => toggle(column.id, checked)
145
+ }, undefined, false, undefined, this),
146
+ layout && onLayoutChange ? /* @__PURE__ */ jsxDEV(UGButton, {
147
+ "aria-label": pinLabel,
148
+ className: "admin-column-settings__pin",
149
+ disabled: !visible,
150
+ onClick: () => onLayoutChange(cycleAdminColumnSide(layout, column.id)),
151
+ size: "sm",
152
+ title: pinLabel,
153
+ tone: side ? "primary" : "neutral",
154
+ type: "button",
155
+ variant: "ghost",
156
+ children: [
157
+ /* @__PURE__ */ jsxDEV(Pin, {
158
+ "aria-hidden": "true",
159
+ size: 14
160
+ }, undefined, false, undefined, this),
161
+ side ? /* @__PURE__ */ jsxDEV("span", {
162
+ "aria-hidden": "true",
163
+ children: side === "left" ? "左" : "右"
164
+ }, undefined, false, undefined, this) : null
165
+ ]
166
+ }, undefined, true, undefined, this) : null
167
+ ]
168
+ }, column.id, true, undefined, this);
169
+ })
170
+ }, undefined, false, undefined, this)
171
+ ]
172
+ }, undefined, true, undefined, this)
173
+ ]
174
+ }, undefined, true, undefined, this);
175
+ }
176
+
177
+ export { useAdminColumnLayout2, AdminColumnSettings2 };
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  AdminPage2
3
- } from "./index-keve3ryw.js";
3
+ } from "./AdminColumnSettings-be5c6tmr.js";
4
4
 
5
5
  // packages/admin-react/src/patterns/AdminDetailPage.tsx
6
6
  import { UGCard, UGCardContent, UGCardHeader, UGCardTitle } from "@ug666/ui-react";
@@ -43,7 +43,7 @@ function AdminSearchField2({
43
43
  function AdminSearchForm2({
44
44
  children,
45
45
  expandedContent,
46
- labelWidth = "max-content",
46
+ labelWidth = 0,
47
47
  expandLabel = "展开",
48
48
  collapseLabel = "收起",
49
49
  loading = false,
@@ -101,7 +101,7 @@ function AdminSearchForm2({
101
101
  loading,
102
102
  tone: "primary",
103
103
  type: "submit",
104
- variant: "solid",
104
+ variant: "outline",
105
105
  children: [
106
106
  /* @__PURE__ */ jsxDEV(Search, {
107
107
  "aria-hidden": "true",
@@ -112,8 +112,9 @@ function AdminSearchForm2({
112
112
  }, undefined, true, undefined, this),
113
113
  /* @__PURE__ */ jsxDEV(UGButton, {
114
114
  onClick: onReset,
115
+ tone: "neutral",
115
116
  type: "button",
116
- variant: "default",
117
+ variant: "outline",
117
118
  children: [
118
119
  /* @__PURE__ */ jsxDEV(RotateCcw, {
119
120
  "aria-hidden": "true",
package/dist/index.js CHANGED
@@ -1,28 +1,42 @@
1
+ import {
2
+ useAdminColumnLayout2,
3
+ AdminColumnSettings2
4
+ } from "./AdminColumnSettings-sz4q6vza.js";
1
5
  import {
2
6
  AdminConfirmAction2
3
- } from "./index-aqqcc4wq.js";
7
+ } from "./AdminColumnSettings-aqqcc4wq.js";
4
8
  import {
5
9
  AdminPage2
6
- } from "./index-keve3ryw.js";
10
+ } from "./AdminColumnSettings-be5c6tmr.js";
7
11
  import {
8
12
  AdminDetailPage2
9
- } from "./index-4tstw263.js";
13
+ } from "./AdminColumnSettings-t2b7bfqc.js";
14
+ import {
15
+ AdminFormDialog2
16
+ } from "./AdminColumnSettings-nnrtybx5.js";
10
17
  import {
11
18
  AdminFormPage2
12
- } from "./index-zt432pkz.js";
19
+ } from "./AdminColumnSettings-4cv6a9m2.js";
13
20
  import {
14
21
  AdminListPage2
15
- } from "./index-nyrhj7se.js";
22
+ } from "./AdminColumnSettings-09epsf86.js";
16
23
  import {
17
24
  AdminSearchField2,
18
25
  AdminSearchForm2
19
- } from "./index-3dcgfy6t.js";
26
+ } from "./AdminColumnSettings-tf48jqrt.js";
27
+ import {
28
+ AdminTabContextMenu2
29
+ } from "./AdminColumnSettings-93ajawas.js";
20
30
  export {
31
+ AdminColumnSettings2 as AdminColumnSettings,
21
32
  AdminConfirmAction2 as AdminConfirmAction,
22
33
  AdminDetailPage2 as AdminDetailPage,
34
+ AdminFormDialog2 as AdminFormDialog,
23
35
  AdminFormPage2 as AdminFormPage,
24
36
  AdminListPage2 as AdminListPage,
25
37
  AdminPage2 as AdminPage,
26
38
  AdminSearchField2 as AdminSearchField,
27
- AdminSearchForm2 as AdminSearchForm
39
+ AdminSearchForm2 as AdminSearchForm,
40
+ AdminTabContextMenu2 as AdminTabContextMenu,
41
+ useAdminColumnLayout2 as useAdminColumnLayout
28
42
  };
@@ -0,0 +1,8 @@
1
+ import {
2
+ useAdminColumnLayout2,
3
+ AdminColumnSettings2
4
+ } from "../AdminColumnSettings-sz4q6vza.js";
5
+ export {
6
+ AdminColumnSettings2 as AdminColumnSettings,
7
+ useAdminColumnLayout2 as useAdminColumnLayout
8
+ };
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  AdminConfirmAction2
3
- } from "../index-aqqcc4wq.js";
3
+ } from "../AdminColumnSettings-aqqcc4wq.js";
4
4
  export {
5
5
  AdminConfirmAction2 as AdminConfirmAction
6
6
  };
@@ -1,7 +1,7 @@
1
1
  import {
2
2
  AdminDetailPage2
3
- } from "../index-4tstw263.js";
4
- import"../index-keve3ryw.js";
3
+ } from "../AdminColumnSettings-t2b7bfqc.js";
4
+ import"../AdminColumnSettings-be5c6tmr.js";
5
5
  export {
6
6
  AdminDetailPage2 as AdminDetailPage
7
7
  };
@@ -0,0 +1,6 @@
1
+ import {
2
+ AdminFormDialog2
3
+ } from "../AdminColumnSettings-nnrtybx5.js";
4
+ export {
5
+ AdminFormDialog2 as AdminFormDialog
6
+ };
@@ -1,7 +1,7 @@
1
1
  import {
2
2
  AdminFormPage2
3
- } from "../index-zt432pkz.js";
4
- import"../index-keve3ryw.js";
3
+ } from "../AdminColumnSettings-4cv6a9m2.js";
4
+ import"../AdminColumnSettings-be5c6tmr.js";
5
5
  export {
6
6
  AdminFormPage2 as AdminFormPage
7
7
  };
@@ -1,7 +1,7 @@
1
1
  import {
2
2
  AdminListPage2
3
- } from "../index-nyrhj7se.js";
4
- import"../index-keve3ryw.js";
3
+ } from "../AdminColumnSettings-09epsf86.js";
4
+ import"../AdminColumnSettings-be5c6tmr.js";
5
5
  export {
6
6
  AdminListPage2 as AdminListPage
7
7
  };
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  AdminPage2
3
- } from "../index-keve3ryw.js";
3
+ } from "../AdminColumnSettings-be5c6tmr.js";
4
4
  export {
5
5
  AdminPage2 as AdminPage
6
6
  };
@@ -1,7 +1,7 @@
1
1
  import {
2
2
  AdminSearchField2,
3
3
  AdminSearchForm2
4
- } from "../index-3dcgfy6t.js";
4
+ } from "../AdminColumnSettings-tf48jqrt.js";
5
5
  export {
6
6
  AdminSearchField2 as AdminSearchField,
7
7
  AdminSearchForm2 as AdminSearchForm
@@ -0,0 +1,6 @@
1
+ import {
2
+ AdminTabContextMenu2
3
+ } from "../AdminColumnSettings-93ajawas.js";
4
+ export {
5
+ AdminTabContextMenu2 as AdminTabContextMenu
6
+ };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ug666/admin-react",
3
- "version": "0.1.0-beta.0",
3
+ "version": "0.1.0-beta.2",
4
4
  "description": "UG Admin React 渲染层:AdminPage/AdminListPage/AdminFormPage/AdminDetailPage 等页面壳与组合模式",
5
5
  "type": "module",
6
6
  "exports": {
@@ -10,7 +10,7 @@
10
10
  },
11
11
  "./patterns/*": {
12
12
  "types": "./src/patterns/*.tsx",
13
- "default": "./src/patterns/*.tsx"
13
+ "default": "./dist/patterns/*.js"
14
14
  }
15
15
  },
16
16
  "files": [
@@ -39,5 +39,10 @@
39
39
  "lucide-react": "*",
40
40
  "react": "^19.0.0",
41
41
  "react-router-dom": "^7.0.0"
42
+ },
43
+ "repository": {
44
+ "type": "git",
45
+ "url": "git+https://github.com/uguang2003/ug-admin.git",
46
+ "directory": "packages/admin-react"
42
47
  }
43
48
  }
package/src/index.ts CHANGED
@@ -1,8 +1,11 @@
1
1
  /** @description: admin-react 公开入口;按子路径导出,构建产物与类型统一从这里收口。 */
2
2
 
3
+ export * from "./patterns/AdminColumnSettings";
3
4
  export * from "./patterns/AdminConfirmAction";
4
5
  export * from "./patterns/AdminDetailPage";
6
+ export * from "./patterns/AdminFormDialog";
5
7
  export * from "./patterns/AdminFormPage";
6
8
  export * from "./patterns/AdminListPage";
7
9
  export * from "./patterns/AdminPage";
8
10
  export * from "./patterns/AdminSearchForm";
11
+ export * from "./patterns/AdminTabContextMenu";
@@ -0,0 +1,168 @@
1
+ import {
2
+ type AdminColumnLayout,
3
+ adminColumnPinLabel,
4
+ cycleAdminColumnSide,
5
+ moveAdminColumn,
6
+ orderAdminColumns,
7
+ readAdminColumnLayout,
8
+ writeAdminColumnLayout,
9
+ } from "@ug666/admin-core/page/column-layout";
10
+ import {
11
+ UGButton,
12
+ UGCheckbox,
13
+ UGPopover,
14
+ UGPopoverContent,
15
+ UGPopoverTrigger,
16
+ } from "@ug666/ui-react";
17
+ import { GripVertical, Pin, Settings2 } from "lucide-react";
18
+ import { type ReactNode, useRef, useState } from "react";
19
+
20
+ export interface AdminColumnSettingsProps {
21
+ /** 可配置的列,按当前顺序展示 */
22
+ columns: readonly { id: string; header?: ReactNode; required?: boolean }[];
23
+ ariaLabel?: string;
24
+ triggerLabel?: string;
25
+ /** 被隐藏的列 id */
26
+ hidden: readonly string[];
27
+ /** 隐藏列变化;至少保留一列 */
28
+ onChange: (hidden: string[]) => void;
29
+ layout?: AdminColumnLayout;
30
+ onLayoutChange?: (layout: AdminColumnLayout) => void;
31
+ }
32
+
33
+ export function useAdminColumnLayout(scope: string) {
34
+ const [layout, setLayout] = useState(() => readAdminColumnLayout(scope, window.localStorage));
35
+ function changeLayout(next: AdminColumnLayout) {
36
+ setLayout(next);
37
+ writeAdminColumnLayout(scope, next, window.localStorage);
38
+ }
39
+ return [layout, changeLayout] as const;
40
+ }
41
+
42
+ /** 列表页的列设置弹层:勾选可见列,并按页面配置调整顺序与固定方向。 */
43
+ export function AdminColumnSettings({
44
+ columns,
45
+ hidden,
46
+ onChange,
47
+ ariaLabel = "列设置",
48
+ triggerLabel,
49
+ layout,
50
+ onLayoutChange,
51
+ }: AdminColumnSettingsProps) {
52
+ const dragged = useRef<string | null>(null);
53
+ const orderedColumns = orderAdminColumns(columns, layout?.order ?? []);
54
+ const order = orderedColumns.map((column) => column.id);
55
+ const visibleCount = columns.filter(
56
+ (column) => column.required || !hidden.includes(column.id),
57
+ ).length;
58
+
59
+ function toggle(id: string, visible: boolean) {
60
+ if (!visible && visibleCount <= 1) return;
61
+ onChange(visible ? hidden.filter((item) => item !== id) : [...new Set([...hidden, id])]);
62
+ }
63
+
64
+ function move(id: string, target: string) {
65
+ if (layout && id !== target)
66
+ onLayoutChange?.({ ...layout, order: moveAdminColumn(order, id, target) });
67
+ }
68
+
69
+ return (
70
+ <UGPopover>
71
+ <UGPopoverTrigger className="inline-flex">
72
+ <UGButton
73
+ aria-label={ariaLabel}
74
+ size={triggerLabel ? "default" : "icon"}
75
+ title={triggerLabel ? undefined : ariaLabel}
76
+ type="button"
77
+ variant="outline"
78
+ >
79
+ <Settings2 aria-hidden="true" size={16} />
80
+ {triggerLabel}
81
+ </UGButton>
82
+ </UGPopoverTrigger>
83
+ <UGPopoverContent align="end" className="admin-column-settings" side="bottom">
84
+ <div className="admin-column-settings__head">
85
+ <strong>显示列</strong>
86
+ <UGButton onClick={() => onChange([])} size="sm" type="button" variant="text">
87
+ 全部显示
88
+ </UGButton>
89
+ </div>
90
+ <div className="admin-column-settings__list">
91
+ {orderedColumns.map((column, index) => {
92
+ const visible = Boolean(column.required) || !hidden.includes(column.id);
93
+ const title = typeof column.header === "string" ? column.header : column.id;
94
+ const side = layout?.fixed[column.id];
95
+ const pinLabel = adminColumnPinLabel(side, title);
96
+ return (
97
+ // biome-ignore lint/a11y/noStaticElementInteractions: 整行接收拖放,键盘通过同一行的排序按钮操作。
98
+ <div
99
+ className="admin-column-settings__row"
100
+ key={column.id}
101
+ onDragOver={(event) => {
102
+ if (dragged.current) event.preventDefault();
103
+ }}
104
+ onDrop={(event) => {
105
+ if (!dragged.current) return;
106
+ event.preventDefault();
107
+ move(dragged.current, column.id);
108
+ dragged.current = null;
109
+ }}
110
+ >
111
+ {layout && onLayoutChange ? (
112
+ <UGButton
113
+ aria-label={`调整${title}的列顺序`}
114
+ aria-keyshortcuts="ArrowUp ArrowDown"
115
+ className="admin-column-settings__grip"
116
+ draggable
117
+ onDragStart={(event) => {
118
+ dragged.current = column.id;
119
+ event.dataTransfer.effectAllowed = "move";
120
+ event.dataTransfer.setData("text/plain", column.id);
121
+ }}
122
+ onDragEnd={() => {
123
+ dragged.current = null;
124
+ }}
125
+ onKeyDown={(event) => {
126
+ if (event.key !== "ArrowUp" && event.key !== "ArrowDown") return;
127
+ event.preventDefault();
128
+ const target = order[index + (event.key === "ArrowUp" ? -1 : 1)];
129
+ if (target) move(column.id, target);
130
+ }}
131
+ size="icon-sm"
132
+ title="拖动或按方向键调整列顺序"
133
+ type="button"
134
+ variant="ghost"
135
+ >
136
+ <GripVertical aria-hidden="true" size={14} />
137
+ </UGButton>
138
+ ) : null}
139
+ <UGCheckbox
140
+ checked={visible}
141
+ disabled={column.required || (visible && visibleCount <= 1)}
142
+ label={title}
143
+ onCheckedChange={(checked) => toggle(column.id, checked)}
144
+ />
145
+ {layout && onLayoutChange ? (
146
+ <UGButton
147
+ aria-label={pinLabel}
148
+ className="admin-column-settings__pin"
149
+ disabled={!visible}
150
+ onClick={() => onLayoutChange(cycleAdminColumnSide(layout, column.id))}
151
+ size="sm"
152
+ title={pinLabel}
153
+ tone={side ? "primary" : "neutral"}
154
+ type="button"
155
+ variant="ghost"
156
+ >
157
+ <Pin aria-hidden="true" size={14} />
158
+ {side ? <span aria-hidden="true">{side === "left" ? "左" : "右"}</span> : null}
159
+ </UGButton>
160
+ ) : null}
161
+ </div>
162
+ );
163
+ })}
164
+ </div>
165
+ </UGPopoverContent>
166
+ </UGPopover>
167
+ );
168
+ }
@@ -0,0 +1,96 @@
1
+ import {
2
+ UGButton,
3
+ UGModal,
4
+ UGModalBody,
5
+ UGModalCloseButton,
6
+ UGModalContent,
7
+ UGModalFooter,
8
+ UGModalHeader,
9
+ UGModalTitle,
10
+ } from "@ug666/ui-react";
11
+ import { type FormEvent, type ReactNode, useId } from "react";
12
+
13
+ export interface AdminFormDialogProps {
14
+ open: boolean;
15
+ title: string;
16
+ /** 提交按钮文案 */
17
+ submitLabel: string;
18
+ /** 取消按钮文案 */
19
+ cancelLabel?: string;
20
+ loading?: boolean;
21
+ disabled?: boolean;
22
+ closeOnOverlay?: boolean;
23
+ initialFocusSelector?: string;
24
+ size?: "sm" | "md" | "lg";
25
+ /** 关闭请求;提交中应自行忽略 */
26
+ onClose: () => void;
27
+ onSubmit: () => void;
28
+ children: ReactNode;
29
+ }
30
+
31
+ /**
32
+ * 列表页的“新增/编辑”弹窗:表单区单列限宽,提交与取消在页脚同一行,
33
+ * 不再把表单摊在列表卡片顶部。
34
+ */
35
+ export function AdminFormDialog({
36
+ open,
37
+ title,
38
+ submitLabel,
39
+ cancelLabel = "取消",
40
+ loading = false,
41
+ disabled = false,
42
+ closeOnOverlay = true,
43
+ initialFocusSelector,
44
+ size,
45
+ onClose,
46
+ onSubmit,
47
+ children,
48
+ }: AdminFormDialogProps) {
49
+ const formId = useId();
50
+
51
+ function handleSubmit(event: FormEvent<HTMLFormElement>) {
52
+ event.preventDefault();
53
+ if (!loading && !disabled) onSubmit();
54
+ }
55
+
56
+ return (
57
+ <UGModal
58
+ ariaLabel={title}
59
+ closeOnEsc={!loading}
60
+ closeOnOverlay={closeOnOverlay && !loading}
61
+ initialFocusSelector={initialFocusSelector}
62
+ onClose={() => {
63
+ if (!loading) onClose();
64
+ }}
65
+ open={open}
66
+ size={size}
67
+ >
68
+ <UGModalContent>
69
+ <UGModalHeader>
70
+ <UGModalTitle>{title}</UGModalTitle>
71
+ {!loading ? <UGModalCloseButton /> : null}
72
+ </UGModalHeader>
73
+ <UGModalBody>
74
+ <form className="admin-section-form" id={formId} onSubmit={handleSubmit}>
75
+ {children}
76
+ </form>
77
+ </UGModalBody>
78
+ <UGModalFooter>
79
+ <UGButton disabled={loading} onClick={onClose} type="button" variant="text">
80
+ {cancelLabel}
81
+ </UGButton>
82
+ <UGButton
83
+ disabled={disabled}
84
+ form={formId}
85
+ loading={loading}
86
+ tone="primary"
87
+ type="submit"
88
+ variant="solid"
89
+ >
90
+ {submitLabel}
91
+ </UGButton>
92
+ </UGModalFooter>
93
+ </UGModalContent>
94
+ </UGModal>
95
+ );
96
+ }
@@ -12,6 +12,10 @@ export interface AdminListPageProps extends Omit<AdminPageProps, "children"> {
12
12
  footer?: ReactNode;
13
13
  }
14
14
 
15
+ /**
16
+ * 列表页模式:筛选区独立,标题与主操作在列表卡头,工具栏、表格与分页在同一卡内。
17
+ * 页面级标题只保留给读屏(h1),可见标题由卡片头承担,避免与面包屑、页签重复。
18
+ */
15
19
  export function AdminListPage({
16
20
  search,
17
21
  summary,
@@ -23,24 +27,31 @@ export function AdminListPage({
23
27
  footer,
24
28
  ...pageProps
25
29
  }: AdminListPageProps) {
26
- const { primaryAction, secondaryActions, ...headerProps } = pageProps;
30
+ const { title, primaryAction, secondaryActions, ...rest } = pageProps;
31
+ const hasActions = Boolean(primaryAction || secondaryActions || toolbarEnd);
32
+
27
33
  return (
28
- <AdminPage {...headerProps} visuallyHiddenHeader className="admin-page--list">
34
+ <AdminPage {...rest} className="admin-page--list" title={title} visuallyHiddenHeader>
35
+ {search ? (
36
+ <div className="admin-list-search-panel" hidden={searchHidden} id={searchId}>
37
+ <div className="admin-list-search">{search}</div>
38
+ </div>
39
+ ) : null}
29
40
  <div className="admin-list-panel">
30
- {search ? (
31
- <div id={searchId} className="admin-list-search" hidden={searchHidden}>
32
- {search}
33
- </div>
34
- ) : null}
35
- {summary}
36
- {primaryAction || secondaryActions || toolbarStart || toolbarEnd ? (
37
- <div className="admin-list-actions">
38
- <div className="admin-list-actions__start">
39
- {primaryAction}
41
+ <div className="admin-list-header">
42
+ <h2 className="admin-list-header__title">{title}</h2>
43
+ {hasActions ? (
44
+ <div className="admin-list-header__actions">
40
45
  {secondaryActions}
41
- {toolbarStart}
46
+ {primaryAction}
47
+ {toolbarEnd ? <div className="admin-list-header__tools">{toolbarEnd}</div> : null}
42
48
  </div>
43
- <div className="admin-list-actions__end">{toolbarEnd}</div>
49
+ ) : null}
50
+ </div>
51
+ {summary}
52
+ {toolbarStart ? (
53
+ <div className="admin-list-actions">
54
+ <div className="admin-list-actions__start">{toolbarStart}</div>
44
55
  </div>
45
56
  ) : null}
46
57
  <div className="admin-list-content">{children}</div>
@@ -4,7 +4,10 @@ import type { ReactNode } from "react";
4
4
  export interface AdminPageProps {
5
5
  className?: string;
6
6
  title: ReactNode;
7
+ /** 页面说明文案;默认不渲染(管理台标题行只保留标题与操作),需要时显式开启 */
7
8
  description?: ReactNode;
9
+ /** 是否在页头渲染 description,默认 false */
10
+ showDescription?: boolean;
8
11
  badge?: ReactNode;
9
12
  meta?: ReactNode;
10
13
  primaryAction?: ReactNode;
@@ -17,6 +20,7 @@ export function AdminPage({
17
20
  className,
18
21
  title,
19
22
  description,
23
+ showDescription = false,
20
24
  badge,
21
25
  meta,
22
26
  primaryAction,
@@ -40,9 +44,9 @@ export function AdminPage({
40
44
  <UGPageHeader
41
45
  actions={actions}
42
46
  badge={badge}
43
- description={description}
47
+ description={showDescription ? description : undefined}
44
48
  meta={meta}
45
- title={title}
49
+ title={<span className="admin-page__title">{title}</span>}
46
50
  />
47
51
  )}
48
52
  {children}
@@ -60,7 +60,7 @@ export interface AdminSearchFormProps {
60
60
  export function AdminSearchForm({
61
61
  children,
62
62
  expandedContent,
63
- labelWidth = "max-content",
63
+ labelWidth = 0,
64
64
  expandLabel = "展开",
65
65
  collapseLabel = "收起",
66
66
  loading = false,
@@ -110,11 +110,11 @@ export function AdminSearchForm({
110
110
  {expanded ? collapseLabel : expandLabel}
111
111
  </UGButton>
112
112
  ) : null}
113
- <UGButton loading={loading} tone="primary" type="submit" variant="solid">
113
+ <UGButton loading={loading} tone="primary" type="submit" variant="outline">
114
114
  <Search aria-hidden="true" size={16} />
115
115
  查询
116
116
  </UGButton>
117
- <UGButton onClick={onReset} type="button" variant="default">
117
+ <UGButton onClick={onReset} tone="neutral" type="button" variant="outline">
118
118
  <RotateCcw aria-hidden="true" size={16} />
119
119
  重置
120
120
  </UGButton>
@@ -0,0 +1,67 @@
1
+ /** @description: 在 UG 页签条上提供关闭其他页签的菜单。 */
2
+ import type { AdminAppTab } from "@ug666/admin-core/routing/app-tabs";
3
+ import {
4
+ UGContextMenu,
5
+ UGContextMenuContent,
6
+ UGContextMenuItem,
7
+ UGContextMenuTrigger,
8
+ } from "@ug666/ui-react";
9
+ import { type ReactNode, useRef } from "react";
10
+
11
+ export function AdminTabContextMenu({
12
+ tabs,
13
+ onCloseOthers,
14
+ children,
15
+ }: {
16
+ tabs: readonly AdminAppTab[];
17
+ onCloseOthers: (tabId: string) => void;
18
+ children: ReactNode;
19
+ }) {
20
+ const trigger = useRef<HTMLElement | null>(null);
21
+ const tabId = useRef<string | undefined>(undefined);
22
+
23
+ function prepare(event: React.SyntheticEvent) {
24
+ if (!(event.target instanceof Element)) return;
25
+ const item = event.target.closest<HTMLElement>('[data-ug="app-tabs"] [data-ug-slot="item"]');
26
+ const value = item?.dataset.value;
27
+ if (!value || !tabs.some((tab) => tab.id !== value && tab.closable)) {
28
+ event.stopPropagation();
29
+ return;
30
+ }
31
+ tabId.current = value;
32
+ trigger.current = item?.querySelector<HTMLElement>('[data-ug-slot="trigger"]') ?? null;
33
+ }
34
+
35
+ function restoreFocus() {
36
+ const target = trigger.current;
37
+ requestAnimationFrame(() => target?.focus({ preventScroll: true }));
38
+ }
39
+
40
+ return (
41
+ <UGContextMenu className="admin-tab-menu">
42
+ <UGContextMenuTrigger
43
+ className="admin-tab-menu__trigger"
44
+ onContextMenuCapture={prepare}
45
+ onKeyDownCapture={(event) => {
46
+ if (event.key === "ContextMenu" || (event.shiftKey && event.key === "F10"))
47
+ prepare(event);
48
+ }}
49
+ >
50
+ {children}
51
+ </UGContextMenuTrigger>
52
+ <UGContextMenuContent aria-label="页签操作">
53
+ <UGContextMenuItem
54
+ onClick={() => {
55
+ if (tabId.current) onCloseOthers(tabId.current);
56
+ restoreFocus();
57
+ }}
58
+ onKeyDown={(event) => {
59
+ if (event.key === "Escape") restoreFocus();
60
+ }}
61
+ >
62
+ 关闭其他页签
63
+ </UGContextMenuItem>
64
+ </UGContextMenuContent>
65
+ </UGContextMenu>
66
+ );
67
+ }
@@ -1,63 +0,0 @@
1
- import {
2
- AdminPage2
3
- } from "./index-keve3ryw.js";
4
-
5
- // packages/admin-react/src/patterns/AdminListPage.tsx
6
- import { jsxDEV } from "react/jsx-dev-runtime";
7
- function AdminListPage2({
8
- search,
9
- summary,
10
- searchId,
11
- searchHidden = false,
12
- toolbarStart,
13
- toolbarEnd,
14
- children,
15
- footer,
16
- ...pageProps
17
- }) {
18
- const { primaryAction, secondaryActions, ...headerProps } = pageProps;
19
- return /* @__PURE__ */ jsxDEV(AdminPage2, {
20
- ...headerProps,
21
- visuallyHiddenHeader: true,
22
- className: "admin-page--list",
23
- children: /* @__PURE__ */ jsxDEV("div", {
24
- className: "admin-list-panel",
25
- children: [
26
- search ? /* @__PURE__ */ jsxDEV("div", {
27
- id: searchId,
28
- className: "admin-list-search",
29
- hidden: searchHidden,
30
- children: search
31
- }, undefined, false, undefined, this) : null,
32
- summary,
33
- primaryAction || secondaryActions || toolbarStart || toolbarEnd ? /* @__PURE__ */ jsxDEV("div", {
34
- className: "admin-list-actions",
35
- children: [
36
- /* @__PURE__ */ jsxDEV("div", {
37
- className: "admin-list-actions__start",
38
- children: [
39
- primaryAction,
40
- secondaryActions,
41
- toolbarStart
42
- ]
43
- }, undefined, true, undefined, this),
44
- /* @__PURE__ */ jsxDEV("div", {
45
- className: "admin-list-actions__end",
46
- children: toolbarEnd
47
- }, undefined, false, undefined, this)
48
- ]
49
- }, undefined, true, undefined, this) : null,
50
- /* @__PURE__ */ jsxDEV("div", {
51
- className: "admin-list-content",
52
- children
53
- }, undefined, false, undefined, this),
54
- footer ? /* @__PURE__ */ jsxDEV("div", {
55
- className: "admin-list-footer",
56
- children: footer
57
- }, undefined, false, undefined, this) : null
58
- ]
59
- }, undefined, true, undefined, this)
60
- }, undefined, false, undefined, this);
61
- }
62
-
63
- export { AdminListPage2 };