@linxin666/dsh-pet 0.4.10 → 0.4.11
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/README.i18n.yaml +2 -2
- package/README.md +1 -1
- package/README.zh.md +4 -4
- package/lib/client.js +1092 -348
- package/lib/client.js.map +1 -1
- package/lib/types/client/PetPreview.d.ts +12 -0
- package/lib/types/client/PetPreview.d.ts.map +1 -0
- package/lib/types/client/PetPreview.js +32 -0
- package/lib/types/client/PetSettingsCard.d.ts +30 -2
- package/lib/types/client/PetSettingsCard.d.ts.map +1 -1
- package/lib/types/client/PetSettingsCard.js +48 -8
- package/lib/types/client/PluginSettingsCard.d.ts +131 -17
- package/lib/types/client/PluginSettingsCard.d.ts.map +1 -1
- package/lib/types/client/PluginSettingsCard.js +158 -37
- package/lib/types/client/RangeBubble.d.ts +47 -0
- package/lib/types/client/RangeBubble.d.ts.map +1 -0
- package/lib/types/client/RangeBubble.js +107 -0
- package/lib/types/client/SegmentGroup.d.ts +29 -0
- package/lib/types/client/SegmentGroup.d.ts.map +1 -0
- package/lib/types/client/SegmentGroup.js +81 -0
- package/lib/types/client/index.d.ts.map +1 -1
- package/lib/types/client/index.js +9 -28
- package/lib/types/client/locales.d.ts +36 -44
- package/lib/types/client/locales.d.ts.map +1 -1
- package/lib/types/client/locales.js +36 -44
- package/lib/types/client/settings-form.d.ts +79 -41
- package/lib/types/client/settings-form.d.ts.map +1 -1
- package/lib/types/client/settings-form.js +96 -36
- package/lib/types/client/settings-registration.d.ts +15 -0
- package/lib/types/client/settings-registration.d.ts.map +1 -0
- package/lib/types/client/settings-registration.js +24 -0
- package/lib/types/client/web-extension-contract.d.ts +32 -0
- package/lib/types/client/web-extension-contract.d.ts.map +1 -0
- package/lib/types/client/web-extension-contract.js +6 -0
- package/lib/types/client/web-extension-page.d.ts +51 -0
- package/lib/types/client/web-extension-page.d.ts.map +1 -0
- package/lib/types/client/web-extension-page.js +122 -0
- package/package.json +1 -1
- package/src/client/PetPreview.tsx +51 -0
- package/src/client/PetSettingsCard.test.tsx +28 -22
- package/src/client/PetSettingsCard.tsx +201 -110
- package/src/client/PluginSettingsCard.tsx +369 -108
- package/src/client/RangeBubble.tsx +163 -0
- package/src/client/SegmentGroup.tsx +92 -0
- package/src/client/index.ts +9 -27
- package/src/client/locales.ts +36 -44
- package/src/client/settings-card.module.css +493 -91
- package/src/client/settings-form.ts +116 -49
- package/src/client/settings-registration.test.ts +79 -0
- package/src/client/settings-registration.ts +34 -0
- package/src/client/settings-section.module.css +182 -0
- package/src/client/web-extension-contract.ts +35 -0
- package/src/client/web-extension-page.ts +150 -0
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* One settings page's seat in either the Web Extensions parent or the legacy
|
|
3
|
+
* first-level settings navigation.
|
|
4
|
+
*
|
|
5
|
+
* The parent supplies the page contract; a child does not know which slot the
|
|
6
|
+
* parent uses internally. While `webUiExtensions` is live the page is handed
|
|
7
|
+
* to its service, which owns keyed mounting and disposal. Without the parent,
|
|
8
|
+
* the same component registers as its original first-level settings section,
|
|
9
|
+
* so a standalone install keeps a working entry.
|
|
10
|
+
*/
|
|
11
|
+
|
|
12
|
+
/** The parent service face this helper consumes. */
|
|
13
|
+
export interface WebExtensionPageService {
|
|
14
|
+
readonly sectionId: string
|
|
15
|
+
registerPage(page: WebExtensionPageSeat): () => void
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
/** Seat-independent page contribution. */
|
|
19
|
+
export interface WebExtensionPageSeat {
|
|
20
|
+
key: string
|
|
21
|
+
order: number
|
|
22
|
+
locale: string
|
|
23
|
+
label(): string
|
|
24
|
+
inject(): object
|
|
25
|
+
component: unknown
|
|
26
|
+
children?: Record<string, { kind: 'keyed' | 'list'; scope: 'root' }>
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
/** The slot-registry slice used for the standalone fallback. */
|
|
30
|
+
export interface WebExtensionPageSlots {
|
|
31
|
+
register(options: never, component: never): unknown
|
|
32
|
+
spec?(key: string): unknown
|
|
33
|
+
entries?(key: string): readonly { component?: unknown; options: Record<string, unknown> }[]
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
/** The context slice needed by the migration. */
|
|
37
|
+
export interface WebExtensionPageContext {
|
|
38
|
+
slots: WebExtensionPageSlots
|
|
39
|
+
get?(name: string): unknown
|
|
40
|
+
on?(event: string, listener: () => void): unknown
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
const SETTINGS_SECTION = 'settings.section'
|
|
44
|
+
const WEB_EXTENSION_SLOT = 'web-ui.extension'
|
|
45
|
+
|
|
46
|
+
function serviceOf(ctx: WebExtensionPageContext): WebExtensionPageService | undefined {
|
|
47
|
+
if (typeof ctx.get !== 'function') return undefined
|
|
48
|
+
try {
|
|
49
|
+
const candidate = ctx.get('webUiExtensions') as Partial<WebExtensionPageService> | undefined
|
|
50
|
+
return candidate !== null
|
|
51
|
+
&& typeof candidate === 'object'
|
|
52
|
+
&& typeof candidate.sectionId === 'string'
|
|
53
|
+
&& typeof candidate.registerPage === 'function'
|
|
54
|
+
? candidate as WebExtensionPageService
|
|
55
|
+
: undefined
|
|
56
|
+
} catch {
|
|
57
|
+
return undefined
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
function warn(seat: string, error: unknown): void {
|
|
62
|
+
try {
|
|
63
|
+
console.warn(`[dsh-web-settings] page "${seat}" could not be mounted`, error)
|
|
64
|
+
} catch {
|
|
65
|
+
// A restricted console must not drop the remaining entry.
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
/**
|
|
70
|
+
* Keep exactly one reachable page contribution while the parent loads or
|
|
71
|
+
* unloads. The parent service owns integrated mounting; only the fallback uses
|
|
72
|
+
* this plugin's own slot registry. Slot disposal is synchronous, so the latch
|
|
73
|
+
* prevents a move from recursively registering a duplicate.
|
|
74
|
+
*/
|
|
75
|
+
export function installWebExtensionPage(
|
|
76
|
+
ctx: WebExtensionPageContext,
|
|
77
|
+
page: WebExtensionPageSeat,
|
|
78
|
+
): () => void {
|
|
79
|
+
let dispose: (() => void) | undefined
|
|
80
|
+
let current: 'integrated' | 'legacy' | undefined
|
|
81
|
+
let reconciling = false
|
|
82
|
+
let disposed = false
|
|
83
|
+
|
|
84
|
+
const present = (seat: 'integrated' | 'legacy'): boolean => {
|
|
85
|
+
if (typeof ctx.slots.entries !== 'function') return current === seat
|
|
86
|
+
const slot = seat === 'integrated' ? WEB_EXTENSION_SLOT : SETTINGS_SECTION
|
|
87
|
+
return ctx.slots.entries(slot).some(entry =>
|
|
88
|
+
entry.component === page.component
|
|
89
|
+
&& (seat === 'integrated' ? entry.options.key : entry.options.id) === page.key)
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
const registerSeat = (seat: 'integrated' | 'legacy'): (() => void) => {
|
|
93
|
+
if (seat === 'integrated') {
|
|
94
|
+
const service = serviceOf(ctx)
|
|
95
|
+
if (service === undefined) throw new Error('webUiExtensions service is unavailable')
|
|
96
|
+
return service.registerPage(page)
|
|
97
|
+
}
|
|
98
|
+
return ctx.slots.register({
|
|
99
|
+
name: SETTINGS_SECTION,
|
|
100
|
+
id: page.key,
|
|
101
|
+
order: page.order,
|
|
102
|
+
label: page.label,
|
|
103
|
+
locale: page.locale,
|
|
104
|
+
inject: page.inject as never,
|
|
105
|
+
...(page.children === undefined ? {} : { children: page.children }),
|
|
106
|
+
} as never, page.component as never) as () => void
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
const reconcile = (): void => {
|
|
110
|
+
if (disposed || reconciling) return
|
|
111
|
+
const target: 'integrated' | 'legacy' = serviceOf(ctx) === undefined ? 'legacy' : 'integrated'
|
|
112
|
+
if (current === target && present(target)) return
|
|
113
|
+
const slot = target === 'integrated' ? WEB_EXTENSION_SLOT : SETTINGS_SECTION
|
|
114
|
+
if (typeof ctx.slots.spec === 'function' && ctx.slots.spec(slot) === undefined) return
|
|
115
|
+
reconciling = true
|
|
116
|
+
const previous = current
|
|
117
|
+
const disposePrevious = dispose
|
|
118
|
+
current = undefined
|
|
119
|
+
dispose = undefined
|
|
120
|
+
disposePrevious?.()
|
|
121
|
+
try {
|
|
122
|
+
dispose = registerSeat(target)
|
|
123
|
+
current = target
|
|
124
|
+
} catch (error) {
|
|
125
|
+
warn(target, error)
|
|
126
|
+
if (previous !== undefined && previous !== target) {
|
|
127
|
+
try {
|
|
128
|
+
dispose = registerSeat(previous)
|
|
129
|
+
current = previous
|
|
130
|
+
} catch (restoreError) {
|
|
131
|
+
warn(previous, restoreError)
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
} finally {
|
|
135
|
+
reconciling = false
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
if (typeof ctx.on === 'function') {
|
|
140
|
+
try { ctx.on('slots/changed', reconcile) } catch { /* the initial entry remains usable */ }
|
|
141
|
+
}
|
|
142
|
+
reconcile()
|
|
143
|
+
return () => {
|
|
144
|
+
if (disposed) return
|
|
145
|
+
disposed = true
|
|
146
|
+
dispose?.()
|
|
147
|
+
dispose = undefined
|
|
148
|
+
current = undefined
|
|
149
|
+
}
|
|
150
|
+
}
|