@dsh-plus/notify-email 0.1.25 → 0.1.27

package/lib/client.js

@@ -72,6 +72,35 @@ window.__ModuleLoader__.load({
 			});
 		}
 		//#endregion
+		//#region ../shared/src/client/config-slots.ts
+		/** dsh-plus 聚合 bundle 的包名（各插件 row 均经其补丁层插入 profile）。 */
+		const DSH_PLUS_BUNDLE = "@dsh-plus/bundle-main";
+		/**
+		* 把一张配置卡片同时注册进 legacy 与新版三个槽位。
+		* 任一槽位在当前 dsh 版本未声明时对应 inject 挂起等待，版本不命中即 no-op。
+		*/
+		function injectPluginConfigCard(slots, reg) {
+			const base = {
+				locale: reg.ns,
+				inject: reg.inject
+			};
+			slots.inject("settings.plugin.item", () => slots.register({
+				name: "settings.plugin.item",
+				key: reg.ns,
+				...base
+			}, reg.component));
+			slots.inject("plugins.row.config", () => slots.register({
+				name: "plugins.row.config",
+				key: `${DSH_PLUS_BUNDLE}#${reg.rowId}`,
+				...base
+			}, reg.component));
+			slots.inject("plugins.bundle.config", () => slots.register({
+				name: "plugins.bundle.config",
+				key: reg.pkg,
+				...base
+			}, reg.component));
+		}
+		//#endregion
 		//#region ../shared/src/client/fields.tsx
 		function TextField(props) {
 			const p = props.prefix ?? "dshp";
@@ -370,11 +399,11 @@ ${extra}
 		//#region src/ns.ts
 		/**
 		* settings 命名空间字面量（纯常量，零依赖，浏览器半可安全引入）。
-		* 服务端直接以字面量注册（0.1.2-alpha.2 起编译期校验命名空间语法，见
-		* config.ts），浏览器半将其作为 settings.plugin.item keyed 槽位的 key ——
+		* 服务端直接以字面量注册（0.1.2-alpha.2 起 dsh-settings 对命名空间做编译期
+		* 语法校验，见 config.ts）；浏览器半把它作为配置卡片的注册键
+		* （legacy settings.plugin.item keyed 槽位按「卡片编辑的 settings 命名空间」
+		* 分发；0.1.6-alpha.2 起改挂插件页 row/bundle config，见 shared/config-slots），
 		* 同一字面量两处共用，防止漂移。
-		* 契约：该槽位按「卡片编辑的 settings 命名空间」作 key 分发，
-		* 官方配置页只渲染 key 命中 Host 已注册命名空间的卡片。
 		* @module notify-email/ns
 		*/
 		const SETTINGS_NS = "dsh-plus-notify-email";
@@ -395,7 +424,9 @@ ${extra}
 		//#endregion
 		//#region src/client/card.tsx
 		/**
-		* 「邮件通知」配置卡片：注册进 settings.plugin.item 插槽（官方插件配置页）。
+		* 「邮件通知」配置卡片：经 injectPluginConfigCard 注册（legacy settings.plugin.item
+		* 与 0.1.6-alpha.2 插件页 plugins.row.config / plugins.bundle.config，view 分发
+		* summary/page）。
 		* 外壳与基础控件走 @dsh-plus/shared/client 套件（CardChrome/TextField/CheckRow），
 		* 本文件只保留业务字段与保存/测试逻辑。交互对齐官方卡片：折叠/展开、
 		* staged draft、未保存标记、保存/放弃；另加「发送测试邮件」。
@@ -453,7 +484,7 @@ ${extra}
 			const { t, scope, api } = props;
 			const snapshot = (0, react.useSyncExternalStore)((listener) => scope.subscribe(listener), () => scope.getSnapshot());
 			const value = snapshot.value;
-			const [open, setOpen] = (0, react.useState)(false);
+			const [open, setOpen] = (0, react.useState)(props.view === "page");
 			const [draft, setDraft] = (0, react.useState)(null);
 			const [passConfigured, setPassConfigured] = (0, react.useState)(false);
 			const [saving, setSaving] = (0, react.useState)(false);
@@ -476,6 +507,7 @@ ${extra}
 			}, [api, snapshot]);
 			const dirty = (0, react.useMemo)(() => value !== void 0 && draft !== null && JSON.stringify(toPatch(draft)) !== JSON.stringify(toPatch(draftFromValue(value))), [value, draft]);
 			const invalid = (0, react.useMemo)(() => draft !== null && (!isPositiveInt(draft.port) || !isPositiveInt(draft.idleDebounceMs) || !isPositiveInt(draft.maxBodyChars) || Number(draft.maxBodyChars) < 200), [draft]);
+			if (props.view === "summary") return t("summaryLine");
 			if (value === void 0 || draft === null) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("li", {
 				className: "dne-card",
 				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
@@ -711,6 +743,7 @@ ${extra}
 		const ownZh = {
 			title: "邮件通知",
 			description: "任务结束、等待决策或出错时向指定邮箱发送邮件。",
+			summaryLine: "任务结束、等待决策或出错时向指定邮箱发送邮件。",
 			enabled: "启用通知",
 			host: "SMTP 服务器",
 			hostHint: "如 smtp.qq.com、smtp.163.com。",
@@ -748,6 +781,7 @@ ${extra}
 		const ownEn = {
 			title: "Email notifications",
 			description: "Email a mailbox when a task finishes, awaits a decision, or fails.",
+			summaryLine: "Email a mailbox when a task finishes, awaits a decision, or fails.",
 			enabled: "Enable notifications",
 			host: "SMTP host",
 			hostHint: "e.g. smtp.qq.com, smtp.gmail.com.",
@@ -806,16 +840,17 @@ ${extra}
 			}), "notify-email: locale");
 			const scope = createSettingsScope(c, SETTINGS_NS, "notify-email: settings scope");
 			const api = createNamespaceApi(c.get("remote").settings, SETTINGS_NS);
-			c.slots.inject("settings.plugin.item", () => c.slots.register({
-				name: "settings.plugin.item",
-				key: SETTINGS_NS,
-				locale: NS,
+			injectPluginConfigCard(c.slots, {
+				ns: SETTINGS_NS,
+				rowId: "dsh-plus-notify-email",
+				pkg: "@dsh-plus/notify-email",
+				component: NotifyEmailCard,
 				inject: () => ({
 					t: c.locale.bind(NS),
 					scope,
 					api
 				})
-			}, NotifyEmailCard));
+			});
 		}
 		//#endregion
 		exports.apply = apply;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plus/notify-email",
-  "version": "0.1.25",
+  "version": "0.1.27",
   "description": "dsh-plus service+ui plugin: 任务结束/等待决策/出错时向指定邮箱发送邮件通知",
   "type": "module",
   "main": "lib/index.js",
@@ -32,7 +32,7 @@
   },
   "dependencies": {
     "nodemailer": "9.0.6",
-    "@dsh-plus/shared": "0.1.18"
+    "@dsh-plus/shared": "0.1.20"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",

package/src/client/card.tsx

@@ -1,5 +1,7 @@
 /**
- * 「邮件通知」配置卡片：注册进 settings.plugin.item 插槽（官方插件配置页）。
+ * 「邮件通知」配置卡片：经 injectPluginConfigCard 注册（legacy settings.plugin.item
+ * 与 0.1.6-alpha.2 插件页 plugins.row.config / plugins.bundle.config，view 分发
+ * summary/page）。
  * 外壳与基础控件走 @dsh-plus/shared/client 套件（CardChrome/TextField/CheckRow），
  * 本文件只保留业务字段与保存/测试逻辑。交互对齐官方卡片：折叠/展开、
  * staged draft、未保存标记、保存/放弃；另加「发送测试邮件」。
@@ -16,6 +18,7 @@ import {
   CheckRow,
   IDLE_STATUS,
   type NamespaceSettingsApi,
+  type PluginConfigViewProps,
   type Scope,
   TextField,
 } from '@dsh-plus/shared/client'
@@ -24,7 +27,7 @@ import { SETTINGS_NS } from '../ns.ts'
 import { sendTest } from './api.ts'
 import type { Translate } from './i18n.ts'
 
-export interface CardProps {
+export interface CardProps extends PluginConfigViewProps {
   t: Translate
   scope: Scope
   api: NamespaceSettingsApi
@@ -113,14 +116,15 @@ function toPatch(draft: Draft): Record<string, unknown> {
 
 const TRIGGER_KEYS = ['onComplete', 'onError', 'onAborted', 'onQuestion', 'onPlanReview'] as const
 
-export function NotifyEmailCard(props: CardProps): ReactElement | null {
+export function NotifyEmailCard(props: CardProps): ReactElement | string | null {
   const { t, scope, api } = props
   const snapshot = useSyncExternalStore(
     (listener: () => void) => scope.subscribe(listener),
     () => scope.getSnapshot(),
   )
   const value = snapshot.value as ConfigValue | undefined
-  const [open, setOpen] = useState(false)
+  // 0.1.6-alpha.2 插件页 page 视图为表单落地页，默认展开；旧槽位无 view，保持折叠。
+  const [open, setOpen] = useState(props.view === 'page')
   const [draft, setDraft] = useState<Draft | null>(null)
   const [passConfigured, setPassConfigured] = useState(false)
   const [saving, setSaving] = useState(false)
@@ -170,6 +174,9 @@ export function NotifyEmailCard(props: CardProps): ReactElement | null {
     [draft],
   )
 
+  // 插件页 summary 视图只出一行简介（hooks 已全部落定，可安全提前返回）。
+  if (props.view === 'summary') return t('summaryLine')
+
   if (value === undefined || draft === null) {
     return (
       <li className="dne-card">

package/src/client/client.ts

@@ -1,16 +1,16 @@
 /**
- * 浏览器半入口：注册 locale 字典 + 向 settings.plugin.item 插槽注册「邮件通知」卡片。
+ * 浏览器半入口：注册 locale 字典 + 注册「邮件通知」卡片
+ * （injectPluginConfigCard 三槽位：legacy settings.plugin.item 与 0.1.6-alpha.2
+ * 独立插件页的 plugins.row.config / plugins.bundle.config）。
  * 构建产物为 window.__ModuleLoader__.load({id, factory}) 形式的 CJS factory
  * （包装见 tsdown.config.ts）；样式沿用官方 data-plugin-css 约定，HMR 据此卸载。
  *
  * 类型说明：浏览器半只用到 slots/locale/remote 的很窄一面，
  * scope 与基础控件走 @dsh-plus/shared/client 套件（收编自本插件原实现）。
- * 该插槽为 keyed 槽位（0.1.2-alpha.2 复核不变）：key 必须是卡片编辑的 settings
- * 命名空间（即服务端注册的同一字面量，见 ../ns.ts），
- * 官方配置页按此 key 与 Host 已注册命名空间配对分发。
  * 配置读写经 ctx.remote.settings 直连（0.1.2-alpha.1 起 connection.api.settings
  * 已移除；不复用 settingsScope 服务——非 loopback 页面下它固定 memory 模式无数据）；
  * 自定义端点仅剩「发送测试邮件」（api.ts）。
+ * 卡片 key/rowId 约定见 @dsh-plus/shared/client/config-slots。
  * @module @dsh-plus/notify-email/client
  */
 import type { Context } from '@deepseek-ai/cordis'
@@ -19,6 +19,7 @@ import {
   createNamespaceApi,
   createSettingsScope,
   injectCardStyle,
+  injectPluginConfigCard,
   type PluginClientContext,
 } from '@dsh-plus/shared/client'
 import { SETTINGS_NS } from '../ns.ts'
@@ -45,15 +46,11 @@ export function apply(ctx: Context): void {
   c.effect(() => c.locale.register(NS, { zh, en }), 'notify-email: locale')
   const scope = createSettingsScope(c, SETTINGS_NS, 'notify-email: settings scope')
   const api = createNamespaceApi(c.get('remote').settings, SETTINGS_NS)
-  c.slots.inject('settings.plugin.item', () =>
-    c.slots.register(
-      {
-        name: 'settings.plugin.item',
-        key: SETTINGS_NS,
-        locale: NS,
-        inject: () => ({ t: c.locale.bind(NS), scope, api }),
-      },
-      NotifyEmailCard,
-    ),
-  )
+  injectPluginConfigCard(c.slots, {
+    ns: SETTINGS_NS,
+    rowId: 'dsh-plus-notify-email',
+    pkg: '@dsh-plus/notify-email',
+    component: NotifyEmailCard,
+    inject: () => ({ t: c.locale.bind(NS), scope, api }),
+  })
 }

package/src/client/i18n.ts

@@ -10,6 +10,7 @@ export const NS = 'dsh-plus-notify-email'
 const ownZh = {
   title: '邮件通知',
   description: '任务结束、等待决策或出错时向指定邮箱发送邮件。',
+  summaryLine: '任务结束、等待决策或出错时向指定邮箱发送邮件。',
   enabled: '启用通知',
   host: 'SMTP 服务器',
   hostHint: '如 smtp.qq.com、smtp.163.com。',
@@ -48,6 +49,7 @@ const ownZh = {
 const ownEn = {
   title: 'Email notifications',
   description: 'Email a mailbox when a task finishes, awaits a decision, or fails.',
+  summaryLine: 'Email a mailbox when a task finishes, awaits a decision, or fails.',
   enabled: 'Enable notifications',
   host: 'SMTP host',
   hostHint: 'e.g. smtp.qq.com, smtp.gmail.com.',

package/src/ns.ts

@@ -1,10 +1,10 @@
 /**
  * settings 命名空间字面量（纯常量，零依赖，浏览器半可安全引入）。
- * 服务端直接以字面量注册（0.1.2-alpha.2 起编译期校验命名空间语法，见
- * config.ts），浏览器半将其作为 settings.plugin.item keyed 槽位的 key ——
+ * 服务端直接以字面量注册（0.1.2-alpha.2 起 dsh-settings 对命名空间做编译期
+ * 语法校验，见 config.ts）；浏览器半把它作为配置卡片的注册键
+ * （legacy settings.plugin.item keyed 槽位按「卡片编辑的 settings 命名空间」
+ * 分发；0.1.6-alpha.2 起改挂插件页 row/bundle config，见 shared/config-slots），
  * 同一字面量两处共用，防止漂移。
- * 契约：该槽位按「卡片编辑的 settings 命名空间」作 key 分发，
- * 官方配置页只渲染 key 命中 Host 已注册命名空间的卡片。
  * @module notify-email/ns
  */
 export const SETTINGS_NS = 'dsh-plus-notify-email'