@dsh-plus/access-gate 0.3.9 → 0.3.11

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
 		/**
 		* 勾选行：自绘圆角扁平开关（switch），对齐官方 WebUI 无原生 checkbox 的
@@ -335,16 +364,19 @@ ${extra}
 		//#region src/ns.ts
 		/**
 		* settings 命名空间字面量（纯常量，零依赖，浏览器半可安全引入）。
-		* 服务端直接以字面量注册（0.1.2-alpha.2 起 dsh-settings 编译期校验命名空间
-		* 语法，见 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），
+		* 同一字面量两处共用，防止漂移。
 		* @module access-gate/ns
 		*/
 		const SETTINGS_NS = "dsh-plus-access-gate";
 		//#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），
 		* 本文件保留业务字段（白名单 textarea/诊断面板）与保存逻辑。
 		* 配置读写走官方 settingsScope 传输：value 为 schema 解析后的视图，
@@ -394,7 +426,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 [diag, setDiag] = (0, react.useState)(null);
 			const [saving, setSaving] = (0, react.useState)(false);
@@ -413,6 +445,7 @@ ${extra}
 				};
 			}, [snapshot]);
 			const dirty = (0, react.useMemo)(() => value !== void 0 && draft !== null && JSON.stringify(toPatch(draft)) !== JSON.stringify(toPatch(draftFromValue(value))), [value, draft]);
+			if (props.view === "summary") return t("summaryLine");
 			if (value === void 0 || draft === null) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("li", {
 				className: "dag-card",
 				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
@@ -611,6 +644,7 @@ ${extra}
 		const ownZh = {
 			title: "访问控制",
 			description: "Web 访问围栏：与官方登录合并——官方 cookie 为唯一凭据；未认证导航显示启动令牌输入页（PWA 内可用）；可选 IP 附加围栏。",
+			summaryLine: "Web 访问围栏：官方登录合并、启动令牌页与可选 IP 白名单。",
 			enabled: "启用访问围栏",
 			enabledHint: "关闭即完全旁路（等价插件缺席）；启用后未认证流量被拦截到令牌输入页或拒绝。",
 			mergedHint: "登录凭据由官方认证持有（启动令牌换 30 天 cookie）。获取当前令牌：服务器执行 dshctl url，或本机访问 /dsh-plus/gate/launch-url。",
@@ -642,6 +676,7 @@ ${extra}
 		const ownEn = {
 			title: "Access Control",
 			description: "Web access gate merged with official auth: the official cookie is the sole credential; unauthenticated navigations get a launch-token page (works inside the PWA); optional IP fence.",
+			summaryLine: "Web access gate: merged official auth, launch-token page, optional IP allowlist.",
 			enabled: "Enable access gate",
 			enabledHint: "Off means full bypass (as if absent); on, unauthenticated traffic hits the token page or is refused.",
 			mergedHint: "Credentials are owned by official auth (launch token exchange, 30-day cookie). Get the current token: run dshctl url on the server, or visit /dsh-plus/gate/launch-url locally.",
@@ -724,16 +759,17 @@ ${extra}
 			}), "access-gate: locale");
 			const scope = createSettingsScope(c, SETTINGS_NS, "access-gate: 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-access-gate",
+				pkg: "@dsh-plus/access-gate",
+				component: AccessGateCard,
 				inject: () => ({
 					t: c.locale.bind(NS),
 					scope,
 					api
 				})
-			}, AccessGateCard));
+			});
 		}
 		//#endregion
 		exports.apply = apply;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plus/access-gate",
-  "version": "0.3.9",
+  "version": "0.3.11",
   "description": "dsh-plus service+ui plugin: dsh web 全量访问围栏——与官方 browser-auth 合并：官方 cookie 为唯一凭据，可选 IP 附加围栏，未认证导航渲染 token 输入页（PWA 可恢复），loopback 管理通道",
   "type": "module",
   "main": "lib/index.js",
@@ -31,7 +31,7 @@
     }
   },
   "dependencies": {
-    "@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,6 @@
 /**
- * 「访问控制」配置卡片：注册进 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），
  * 本文件保留业务字段（白名单 textarea/诊断面板）与保存逻辑。
  * 配置读写走官方 settingsScope 传输：value 为 schema 解析后的视图，
@@ -18,12 +19,13 @@ import {
   CheckRow,
   IDLE_STATUS,
   type NamespaceSettingsApi,
+  type PluginConfigViewProps,
   type Scope,
 } from '@dsh-plus/shared/client'
 import { type ReactElement, useEffect, useMemo, useState, useSyncExternalStore } from 'react'
 import type { DictKey, Translate } from './i18n.ts'
 
-export interface CardProps {
+export interface CardProps extends PluginConfigViewProps {
   t: Translate
   scope: Scope
   api: NamespaceSettingsApi
@@ -99,14 +101,15 @@ function verdictLabel(t: Translate, diag: Diag): string {
   return t('diagBlock')
 }
 
-export function AccessGateCard(props: CardProps): ReactElement | null {
+export function AccessGateCard(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 [diag, setDiag] = useState<Diag | null>(null)
   const [saving, setSaving] = useState(false)
@@ -141,6 +144,9 @@ export function AccessGateCard(props: CardProps): ReactElement | null {
     [value, draft],
   )
 
+  // 插件页 summary 视图只出一行简介（hooks 已全部落定，可安全提前返回）。
+  if (props.view === 'summary') return t('summaryLine')
+
   if (value === undefined || draft === null) {
     return (
       <li className="dag-card">

package/src/client/client.ts

@@ -1,21 +1,22 @@
 /**
- * 浏览器半入口：注册 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 槽位：key 必须是卡片编辑的 settings 命名空间
- * （即服务端注册的同一字面量，见 ../ns.ts），
- * 官方配置页按此 key 与 Host 已注册命名空间配对分发。
  * 配置读写经 ctx.remote.settings 直连（0.1.2-alpha.1 起 connection.api.settings
  * 已移除；不复用 settingsScope 服务——非 loopback 页面下它固定 memory 模式无数据）。
+ * 卡片 key/rowId 约定见 @dsh-plus/shared/client/config-slots。
  * @module @dsh-plus/access-gate/client
  */
 import type { Context } from '@deepseek-ai/cordis'
 import {
   createNamespaceApi,
   createSettingsScope,
+  injectPluginConfigCard,
   type PluginClientContext,
 } from '@dsh-plus/shared/client'
 import { SETTINGS_NS } from '../ns.ts'
@@ -43,15 +44,11 @@ export function apply(ctx: Context): void {
   c.effect(() => c.locale.register(NS, { zh, en }), 'access-gate: locale')
   const scope = createSettingsScope(c, SETTINGS_NS, 'access-gate: 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 }),
-      },
-      AccessGateCard,
-    ),
-  )
+  injectPluginConfigCard(c.slots, {
+    ns: SETTINGS_NS,
+    rowId: 'dsh-plus-access-gate',
+    pkg: '@dsh-plus/access-gate',
+    component: AccessGateCard,
+    inject: () => ({ t: c.locale.bind(NS), scope, api }),
+  })
 }

package/src/client/i18n.ts

@@ -11,6 +11,7 @@ const ownZh = {
   title: '访问控制',
   description:
     'Web 访问围栏：与官方登录合并——官方 cookie 为唯一凭据；未认证导航显示启动令牌输入页（PWA 内可用）；可选 IP 附加围栏。',
+  summaryLine: 'Web 访问围栏：官方登录合并、启动令牌页与可选 IP 白名单。',
   enabled: '启用访问围栏',
   enabledHint: '关闭即完全旁路（等价插件缺席）；启用后未认证流量被拦截到令牌输入页或拒绝。',
   mergedHint:
@@ -48,6 +49,7 @@ const ownEn = {
   title: 'Access Control',
   description:
     'Web access gate merged with official auth: the official cookie is the sole credential; unauthenticated navigations get a launch-token page (works inside the PWA); optional IP fence.',
+  summaryLine: 'Web access gate: merged official auth, launch-token page, optional IP allowlist.',
   enabled: 'Enable access gate',
   enabledHint:
     'Off means full bypass (as if absent); on, unauthenticated traffic hits the token page or is refused.',

package/src/ns.ts

@@ -1,8 +1,10 @@
 /**
  * settings 命名空间字面量（纯常量，零依赖，浏览器半可安全引入）。
- * 服务端直接以字面量注册（0.1.2-alpha.2 起 dsh-settings 编译期校验命名空间
- * 语法，见 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），
+ * 同一字面量两处共用，防止漂移。
  * @module access-gate/ns
  */
 export const SETTINGS_NS = 'dsh-plus-access-gate'