@linxin666/dsh-pet 0.4.9 → 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.
Files changed (53) hide show
  1. package/README.i18n.yaml +2 -2
  2. package/README.md +1 -1
  3. package/README.zh.md +4 -4
  4. package/lib/client.js +1092 -348
  5. package/lib/client.js.map +1 -1
  6. package/lib/types/client/PetPreview.d.ts +12 -0
  7. package/lib/types/client/PetPreview.d.ts.map +1 -0
  8. package/lib/types/client/PetPreview.js +32 -0
  9. package/lib/types/client/PetSettingsCard.d.ts +30 -2
  10. package/lib/types/client/PetSettingsCard.d.ts.map +1 -1
  11. package/lib/types/client/PetSettingsCard.js +48 -8
  12. package/lib/types/client/PluginSettingsCard.d.ts +131 -17
  13. package/lib/types/client/PluginSettingsCard.d.ts.map +1 -1
  14. package/lib/types/client/PluginSettingsCard.js +158 -37
  15. package/lib/types/client/RangeBubble.d.ts +47 -0
  16. package/lib/types/client/RangeBubble.d.ts.map +1 -0
  17. package/lib/types/client/RangeBubble.js +107 -0
  18. package/lib/types/client/SegmentGroup.d.ts +29 -0
  19. package/lib/types/client/SegmentGroup.d.ts.map +1 -0
  20. package/lib/types/client/SegmentGroup.js +81 -0
  21. package/lib/types/client/index.d.ts.map +1 -1
  22. package/lib/types/client/index.js +9 -28
  23. package/lib/types/client/locales.d.ts +36 -44
  24. package/lib/types/client/locales.d.ts.map +1 -1
  25. package/lib/types/client/locales.js +36 -44
  26. package/lib/types/client/settings-form.d.ts +79 -41
  27. package/lib/types/client/settings-form.d.ts.map +1 -1
  28. package/lib/types/client/settings-form.js +96 -36
  29. package/lib/types/client/settings-registration.d.ts +15 -0
  30. package/lib/types/client/settings-registration.d.ts.map +1 -0
  31. package/lib/types/client/settings-registration.js +24 -0
  32. package/lib/types/client/web-extension-contract.d.ts +32 -0
  33. package/lib/types/client/web-extension-contract.d.ts.map +1 -0
  34. package/lib/types/client/web-extension-contract.js +6 -0
  35. package/lib/types/client/web-extension-page.d.ts +51 -0
  36. package/lib/types/client/web-extension-page.d.ts.map +1 -0
  37. package/lib/types/client/web-extension-page.js +122 -0
  38. package/package.json +1 -1
  39. package/src/client/PetPreview.tsx +51 -0
  40. package/src/client/PetSettingsCard.test.tsx +28 -22
  41. package/src/client/PetSettingsCard.tsx +201 -110
  42. package/src/client/PluginSettingsCard.tsx +369 -108
  43. package/src/client/RangeBubble.tsx +163 -0
  44. package/src/client/SegmentGroup.tsx +92 -0
  45. package/src/client/index.ts +9 -27
  46. package/src/client/locales.ts +36 -44
  47. package/src/client/settings-card.module.css +493 -91
  48. package/src/client/settings-form.ts +116 -49
  49. package/src/client/settings-registration.test.ts +79 -0
  50. package/src/client/settings-registration.ts +34 -0
  51. package/src/client/settings-section.module.css +182 -0
  52. package/src/client/web-extension-contract.ts +35 -0
  53. 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
+ }