@zhin.js/console-ui 0.0.0-stage → 1.0.0

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.
Files changed (89) hide show
  1. package/CHANGELOG.md +9 -0
  2. package/LICENSE +21 -0
  3. package/README.md +88 -2
  4. package/dist/cn.d.ts +4 -0
  5. package/dist/cn.js +6 -0
  6. package/dist/components/InfoHint.d.ts +12 -0
  7. package/dist/components/InfoHint.js +12 -0
  8. package/dist/components/PageHeader.d.ts +11 -0
  9. package/dist/components/PageHeader.js +8 -0
  10. package/dist/components/PageShell.d.ts +11 -0
  11. package/dist/components/PageShell.js +8 -0
  12. package/dist/components/RefreshControl.d.ts +23 -0
  13. package/dist/components/RefreshControl.js +65 -0
  14. package/dist/components/StatCard.d.ts +27 -0
  15. package/dist/components/StatCard.js +27 -0
  16. package/dist/components/confirm-dialog-model.d.ts +9 -0
  17. package/dist/components/confirm-dialog-model.js +20 -0
  18. package/dist/components/confirm-dialog.d.ts +32 -0
  19. package/dist/components/confirm-dialog.js +71 -0
  20. package/dist/components/empty-state.d.ts +15 -0
  21. package/dist/components/empty-state.js +15 -0
  22. package/dist/components/error-alert.d.ts +15 -0
  23. package/dist/components/error-alert.js +22 -0
  24. package/dist/components/page-chrome.d.ts +41 -0
  25. package/dist/components/page-chrome.js +65 -0
  26. package/dist/components/refresh-control-model.d.ts +9 -0
  27. package/dist/components/refresh-control-model.js +26 -0
  28. package/dist/components/ui/accordion.d.ts +7 -0
  29. package/dist/components/ui/accordion.js +14 -0
  30. package/dist/components/ui/alert.d.ts +8 -0
  31. package/dist/components/ui/alert.js +24 -0
  32. package/dist/components/ui/badge.d.ts +9 -0
  33. package/dist/components/ui/badge.js +29 -0
  34. package/dist/components/ui/button.d.ts +11 -0
  35. package/dist/components/ui/button.js +37 -0
  36. package/dist/components/ui/card.d.ts +11 -0
  37. package/dist/components/ui/card.js +16 -0
  38. package/dist/components/ui/checkbox.d.ts +4 -0
  39. package/dist/components/ui/checkbox.js +9 -0
  40. package/dist/components/ui/dialog.d.ts +24 -0
  41. package/dist/components/ui/dialog.js +26 -0
  42. package/dist/components/ui/dropdown-menu.d.ts +19 -0
  43. package/dist/components/ui/dropdown-menu.js +25 -0
  44. package/dist/components/ui/input.d.ts +3 -0
  45. package/dist/components/ui/input.js +8 -0
  46. package/dist/components/ui/list-item-button.d.ts +10 -0
  47. package/dist/components/ui/list-item-button.js +6 -0
  48. package/dist/components/ui/popover.d.ts +6 -0
  49. package/dist/components/ui/popover.js +9 -0
  50. package/dist/components/ui/radio-group.d.ts +5 -0
  51. package/dist/components/ui/radio-group.js +10 -0
  52. package/dist/components/ui/scroll-area.d.ts +5 -0
  53. package/dist/components/ui/scroll-area.js +13 -0
  54. package/dist/components/ui/searchable-select-model.d.ts +29 -0
  55. package/dist/components/ui/searchable-select-model.js +38 -0
  56. package/dist/components/ui/searchable-select.d.ts +23 -0
  57. package/dist/components/ui/searchable-select.js +84 -0
  58. package/dist/components/ui/select.d.ts +23 -0
  59. package/dist/components/ui/select.js +37 -0
  60. package/dist/components/ui/separator.d.ts +4 -0
  61. package/dist/components/ui/separator.js +11 -0
  62. package/dist/components/ui/sheet.d.ts +27 -0
  63. package/dist/components/ui/sheet.js +26 -0
  64. package/dist/components/ui/skeleton.d.ts +3 -0
  65. package/dist/components/ui/skeleton.js +6 -0
  66. package/dist/components/ui/switch.d.ts +4 -0
  67. package/dist/components/ui/switch.js +8 -0
  68. package/dist/components/ui/table.d.ts +16 -0
  69. package/dist/components/ui/table.js +16 -0
  70. package/dist/components/ui/tabs.d.ts +7 -0
  71. package/dist/components/ui/tabs.js +13 -0
  72. package/dist/components/ui/textarea.d.ts +3 -0
  73. package/dist/components/ui/textarea.js +8 -0
  74. package/dist/components/ui/tooltip.d.ts +7 -0
  75. package/dist/components/ui/tooltip.js +11 -0
  76. package/dist/exports.json +138 -0
  77. package/dist/i18n/index.d.ts +27 -0
  78. package/dist/i18n/index.js +33 -0
  79. package/dist/i18n/messages.d.ts +36 -0
  80. package/dist/i18n/messages.js +72 -0
  81. package/dist/index.d.ts +44 -0
  82. package/dist/index.js +44 -0
  83. package/dist/shared-module.d.ts +28 -0
  84. package/dist/shared-module.js +24 -0
  85. package/dist/styles.css +2316 -0
  86. package/dist/tokens.css +341 -0
  87. package/dist/version.d.ts +6 -0
  88. package/dist/version.js +2 -0
  89. package/package.json +73 -3
@@ -0,0 +1,72 @@
1
+ /**
2
+ * Built-in UI copy of `@zhin.js/console-ui` (ADR 0063 决策 1 第 5 条).
3
+ * Keys are stable ids; values use `{0}`, `{1}` … placeholders.
4
+ * The zh-CN / en strings are the ones the Console used before the components moved here.
5
+ */
6
+ export const CONSOLE_UI_LOCALES = Object.freeze(['zh-CN', 'en']);
7
+ export const DEFAULT_CONSOLE_UI_LOCALE = 'zh-CN';
8
+ const zhCN = {
9
+ 'dialog.close': '关闭',
10
+ 'confirm.cancel': '取消',
11
+ 'confirm.confirm': '确认',
12
+ 'confirm.processing': '处理中...',
13
+ 'confirm.failed': '操作失败,请重试或取消。',
14
+ 'confirm.notCompleted': '操作未完成:{0}',
15
+ 'confirm.typeToConfirm': '请输入 {0} 以确认:',
16
+ 'empty.noData': '暂无数据',
17
+ 'error.retry': '重试',
18
+ 'error.technicalDetail': '技术详情',
19
+ 'select.searchPlaceholder': '搜索…',
20
+ 'select.noMatch': '没有匹配的选项',
21
+ 'refresh.updatedAt': '更新于 {0}',
22
+ 'refresh.notYet': '尚未更新',
23
+ 'refresh.refresh': '刷新',
24
+ 'refresh.refreshing': '刷新中…',
25
+ 'refresh.interval': '自动刷新间隔',
26
+ 'refresh.manual': '手动刷新',
27
+ 'refresh.auto': '{0}s 自动',
28
+ };
29
+ const en = {
30
+ 'dialog.close': 'Close',
31
+ 'confirm.cancel': 'Cancel',
32
+ 'confirm.confirm': 'Confirm',
33
+ 'confirm.processing': 'Processing…',
34
+ 'confirm.failed': 'The action failed. Try again or cancel.',
35
+ 'confirm.notCompleted': 'Not completed: {0}',
36
+ 'confirm.typeToConfirm': 'Type {0} to confirm:',
37
+ 'empty.noData': 'No data',
38
+ 'error.retry': 'Retry',
39
+ 'error.technicalDetail': 'Technical details',
40
+ 'select.searchPlaceholder': 'Search…',
41
+ 'select.noMatch': 'No matching options',
42
+ 'refresh.updatedAt': 'Updated {0}',
43
+ 'refresh.notYet': 'Not updated yet',
44
+ 'refresh.refresh': 'Refresh',
45
+ 'refresh.refreshing': 'Refreshing…',
46
+ 'refresh.interval': 'Auto refresh interval',
47
+ 'refresh.manual': 'Manual refresh',
48
+ 'refresh.auto': '{0}s auto',
49
+ };
50
+ export const CONSOLE_UI_MESSAGES = Object.freeze({
51
+ 'zh-CN': Object.freeze({ ...zhCN }),
52
+ en: Object.freeze({ ...en }),
53
+ });
54
+ /** Maps any BCP 47 tag onto a built-in locale: `zh*` → zh-CN, `en*` → en, otherwise the default. */
55
+ export function resolveConsoleUiLocale(locale) {
56
+ if (!locale)
57
+ return DEFAULT_CONSOLE_UI_LOCALE;
58
+ const lower = locale.toLowerCase();
59
+ if (lower.startsWith('zh'))
60
+ return 'zh-CN';
61
+ if (lower.startsWith('en'))
62
+ return 'en';
63
+ return DEFAULT_CONSOLE_UI_LOCALE;
64
+ }
65
+ export function formatConsoleUiMessage(template, values) {
66
+ if (!values || values.length === 0)
67
+ return template;
68
+ return template.replace(/\{(\d+)\}/gu, (match, index) => {
69
+ const value = values[Number(index)];
70
+ return value === undefined ? match : String(value);
71
+ });
72
+ }
@@ -0,0 +1,44 @@
1
+ /**
2
+ * @zhin.js/console-ui — the one component library of the Zhin Console and plugin pages (ADR 0063).
3
+ * Styles ship precompiled: import `@zhin.js/console-ui/styles.css` (tokens + components) once, or
4
+ * `@zhin.js/console-ui/tokens.css` for the tokens alone.
5
+ */
6
+ export { cn, type ClassValue } from './cn.js';
7
+ export { CONSOLE_UI_VERSION } from './version.js';
8
+ export { CONSOLE_UI_MODULE_ID, CONSOLE_SHARED_MODULE_VERSIONS_KEY, CONSOLE_SHARED_MODULE_ISSUE_EVENT, CONSOLE_SHARED_MODULE_ISSUES_KEY, registerConsoleUiSharedModule, type ConsoleSharedModuleIssue, } from './shared-module.js';
9
+ export * from './i18n/index.js';
10
+ export * from './components/ui/accordion.js';
11
+ export * from './components/ui/alert.js';
12
+ export * from './components/ui/badge.js';
13
+ export * from './components/ui/button.js';
14
+ export * from './components/ui/card.js';
15
+ export * from './components/ui/checkbox.js';
16
+ export * from './components/ui/dialog.js';
17
+ export * from './components/ui/dropdown-menu.js';
18
+ export * from './components/ui/input.js';
19
+ export * from './components/ui/list-item-button.js';
20
+ export * from './components/ui/popover.js';
21
+ export * from './components/ui/radio-group.js';
22
+ export * from './components/ui/scroll-area.js';
23
+ export * from './components/ui/searchable-select.js';
24
+ export { groupSelectOptions, navigableValues, optionMatches, optionSearchText, type SearchableSelectGroup, } from './components/ui/searchable-select-model.js';
25
+ export * from './components/ui/select.js';
26
+ export * from './components/ui/separator.js';
27
+ export * from './components/ui/sheet.js';
28
+ export * from './components/ui/skeleton.js';
29
+ export * from './components/ui/switch.js';
30
+ export * from './components/ui/table.js';
31
+ export * from './components/ui/tabs.js';
32
+ export * from './components/ui/textarea.js';
33
+ export * from './components/ui/tooltip.js';
34
+ export * from './components/PageShell.js';
35
+ export * from './components/PageHeader.js';
36
+ export * from './components/confirm-dialog.js';
37
+ export { canSubmitConfirm, confirmErrorMessage, confirmTextMatches } from './components/confirm-dialog-model.js';
38
+ export * from './components/StatCard.js';
39
+ export * from './components/empty-state.js';
40
+ export * from './components/error-alert.js';
41
+ export * from './components/InfoHint.js';
42
+ export * from './components/RefreshControl.js';
43
+ export { DEFAULT_REFRESH_INTERVALS, formatRefreshTime, refreshIntervalOptions, } from './components/refresh-control-model.js';
44
+ export * from './components/page-chrome.js';
package/dist/index.js ADDED
@@ -0,0 +1,44 @@
1
+ /**
2
+ * @zhin.js/console-ui — the one component library of the Zhin Console and plugin pages (ADR 0063).
3
+ * Styles ship precompiled: import `@zhin.js/console-ui/styles.css` (tokens + components) once, or
4
+ * `@zhin.js/console-ui/tokens.css` for the tokens alone.
5
+ */
6
+ export { cn } from './cn.js';
7
+ export { CONSOLE_UI_VERSION } from './version.js';
8
+ export { CONSOLE_UI_MODULE_ID, CONSOLE_SHARED_MODULE_VERSIONS_KEY, CONSOLE_SHARED_MODULE_ISSUE_EVENT, CONSOLE_SHARED_MODULE_ISSUES_KEY, registerConsoleUiSharedModule, } from './shared-module.js';
9
+ export * from './i18n/index.js';
10
+ export * from './components/ui/accordion.js';
11
+ export * from './components/ui/alert.js';
12
+ export * from './components/ui/badge.js';
13
+ export * from './components/ui/button.js';
14
+ export * from './components/ui/card.js';
15
+ export * from './components/ui/checkbox.js';
16
+ export * from './components/ui/dialog.js';
17
+ export * from './components/ui/dropdown-menu.js';
18
+ export * from './components/ui/input.js';
19
+ export * from './components/ui/list-item-button.js';
20
+ export * from './components/ui/popover.js';
21
+ export * from './components/ui/radio-group.js';
22
+ export * from './components/ui/scroll-area.js';
23
+ export * from './components/ui/searchable-select.js';
24
+ export { groupSelectOptions, navigableValues, optionMatches, optionSearchText, } from './components/ui/searchable-select-model.js';
25
+ export * from './components/ui/select.js';
26
+ export * from './components/ui/separator.js';
27
+ export * from './components/ui/sheet.js';
28
+ export * from './components/ui/skeleton.js';
29
+ export * from './components/ui/switch.js';
30
+ export * from './components/ui/table.js';
31
+ export * from './components/ui/tabs.js';
32
+ export * from './components/ui/textarea.js';
33
+ export * from './components/ui/tooltip.js';
34
+ export * from './components/PageShell.js';
35
+ export * from './components/PageHeader.js';
36
+ export * from './components/confirm-dialog.js';
37
+ export { canSubmitConfirm, confirmErrorMessage, confirmTextMatches } from './components/confirm-dialog-model.js';
38
+ export * from './components/StatCard.js';
39
+ export * from './components/empty-state.js';
40
+ export * from './components/error-alert.js';
41
+ export * from './components/InfoHint.js';
42
+ export * from './components/RefreshControl.js';
43
+ export { DEFAULT_REFRESH_INTERVALS, formatRefreshTime, refreshIntervalOptions, } from './components/refresh-control-model.js';
44
+ export * from './components/page-chrome.js';
@@ -0,0 +1,28 @@
1
+ /** Module id under which the Console shares this package with plugin pages (ADR 0063 D3). */
2
+ export declare const CONSOLE_UI_MODULE_ID = "@zhin.js/console-ui";
3
+ /**
4
+ * Global the Console fills with the versions of the modules it shares
5
+ * (`Map<moduleId, version>`), next to `__ZHIN_CONSOLE_SHARED_MODULES__`.
6
+ * `@zhin.js/pagemanager` reads the same key in its generated proxy modules.
7
+ */
8
+ export declare const CONSOLE_SHARED_MODULE_VERSIONS_KEY = "__ZHIN_CONSOLE_SHARED_MODULE_VERSIONS__";
9
+ /** Event the proxy modules dispatch on `globalThis` when a plugin page's peer range is not met. */
10
+ export declare const CONSOLE_SHARED_MODULE_ISSUE_EVENT = "zhin:console-shared-module-issue";
11
+ /** Global array the proxy modules append those issues to (for a page or the shell to show). */
12
+ export declare const CONSOLE_SHARED_MODULE_ISSUES_KEY = "__ZHIN_CONSOLE_SHARED_MODULE_ISSUES__";
13
+ export interface ConsoleSharedModuleIssue {
14
+ /** `major`: incompatible (the page does not load); `minor`: older than the range asks for; `range`: outside the range otherwise; `export`: named exports missing; `unversioned`: the Console did not register a version. */
15
+ readonly kind: 'major' | 'minor' | 'range' | 'export' | 'unversioned';
16
+ readonly module: string;
17
+ readonly hostVersion?: string;
18
+ readonly range?: string;
19
+ /** Package that declared the range (the plugin). */
20
+ readonly consumer?: string;
21
+ readonly missingExports?: readonly string[];
22
+ readonly message: string;
23
+ }
24
+ /**
25
+ * Registers this package (module namespace and version) in the Console's shared-module tables.
26
+ * Call it once in the Console entry before plugin entries load.
27
+ */
28
+ export declare function registerConsoleUiSharedModule(moduleNamespace: unknown, sharedModules: Map<string, unknown>, target?: Record<string, unknown>): void;
@@ -0,0 +1,24 @@
1
+ import { CONSOLE_UI_VERSION } from './version.js';
2
+ /** Module id under which the Console shares this package with plugin pages (ADR 0063 D3). */
3
+ export const CONSOLE_UI_MODULE_ID = '@zhin.js/console-ui';
4
+ /**
5
+ * Global the Console fills with the versions of the modules it shares
6
+ * (`Map<moduleId, version>`), next to `__ZHIN_CONSOLE_SHARED_MODULES__`.
7
+ * `@zhin.js/pagemanager` reads the same key in its generated proxy modules.
8
+ */
9
+ export const CONSOLE_SHARED_MODULE_VERSIONS_KEY = '__ZHIN_CONSOLE_SHARED_MODULE_VERSIONS__';
10
+ /** Event the proxy modules dispatch on `globalThis` when a plugin page's peer range is not met. */
11
+ export const CONSOLE_SHARED_MODULE_ISSUE_EVENT = 'zhin:console-shared-module-issue';
12
+ /** Global array the proxy modules append those issues to (for a page or the shell to show). */
13
+ export const CONSOLE_SHARED_MODULE_ISSUES_KEY = '__ZHIN_CONSOLE_SHARED_MODULE_ISSUES__';
14
+ /**
15
+ * Registers this package (module namespace and version) in the Console's shared-module tables.
16
+ * Call it once in the Console entry before plugin entries load.
17
+ */
18
+ export function registerConsoleUiSharedModule(moduleNamespace, sharedModules, target = globalThis) {
19
+ sharedModules.set(CONSOLE_UI_MODULE_ID, moduleNamespace);
20
+ const existing = target[CONSOLE_SHARED_MODULE_VERSIONS_KEY];
21
+ const versions = existing instanceof Map ? existing : new Map();
22
+ versions.set(CONSOLE_UI_MODULE_ID, CONSOLE_UI_VERSION);
23
+ target[CONSOLE_SHARED_MODULE_VERSIONS_KEY] = versions;
24
+ }