@tbox.cn/app-module-member 0.8.6 → 0.9.0

package/dist/{chunk-T4SYPQA5.js → chunk-EPQEF43P.js}

@@ -1,5 +1,6 @@
 // src/server/index.ts
 import { loadModuleSkills, withCardEmissionHint, withEarlyExecution } from "@tbox.cn/app-sdk/server";
+import { MEMBER_SNAPSHOT_SERVICE } from "@tbox.cn/app-contracts-mall";
 
 // src/server/cards/member-info/meta.ts
 import { memberInfoCardDataSchema } from "@tbox.cn/app-contracts-mall";
@@ -1550,6 +1551,21 @@ var serverModule = {
       ctx.cardActions.register(action);
     }
     ctx.services.register("member.subject-binding", createSubjectBinding(ctx));
+    ctx.services.register(
+      MEMBER_SNAPSHOT_SERVICE,
+      async (reqCtx) => {
+        const [account, benefits, enrollment] = await Promise.all([
+          resolveMemberAccountPort(reqCtx, ctx),
+          resolveMemberBenefitsPort(reqCtx, ctx),
+          resolveMemberEnrollmentPort(reqCtx, ctx).catch(() => null)
+        ]);
+        return {
+          getAccount: (userId) => account.getAccount(userId),
+          queryPoints: (userId) => benefits.queryPoints(userId),
+          ...enrollment?.enrollUrl ? { enrollUrl: enrollment.enrollUrl } : {}
+        };
+      }
+    );
   }
 };
 

package/dist/{chunk-KEBILLQ5.js → chunk-QWGRWD5C.js}

@@ -1,5 +1,5 @@
 // src/client/index.ts
-import "./member-QFCIYILN.css";
+import "./member-372B74DY.css";
 
 // src/client/cards/member-info/index.tsx
 import { CalendarBlank, Phone, Tag, UserCircle } from "@phosphor-icons/react";
@@ -696,11 +696,6 @@ var member_enrollment_cta_default = MemberEnrollmentCtaCard;
 import { useRef as useRef5, useState as useState6 } from "react";
 import { ArrowSquareOut as ArrowSquareOut2, WarningCircle as WarningCircle3 } from "@phosphor-icons/react";
 import { sendCardAction as sendCardAction5 } from "@tbox.cn/app-sdk/client";
-
-// src/client/assets/login-mascot.jpg
-var login_mascot_default = "./login-mascot-5D4X6YZ7.jpg";
-
-// src/client/cards/member-login-cta/index.tsx
 import { jsx as jsx8, jsxs as jsxs7 } from "react/jsx-runtime";
 function MemberLoginCtaCard(props) {
   const { data, cardId, isHistory } = props;
@@ -721,7 +716,7 @@ function MemberLoginCtaCard(props) {
         /* @__PURE__ */ jsx8("path", { d: "M40 122 c12,-8 20,2 11,9" })
       ] }),
       /* @__PURE__ */ jsx8("span", { className: "member-login-cta__ground", "aria-hidden": "true" }),
-      /* @__PURE__ */ jsx8("img", { className: "member-login-cta__mascot", src: login_mascot_default, alt: "" }),
+      /* @__PURE__ */ jsx8("span", { className: "member-login-cta__mascot", "aria-hidden": "true" }),
       /* @__PURE__ */ jsx8("span", { className: "member-login-cta__grain", "aria-hidden": "true" })
     ] }),
     /* @__PURE__ */ jsx8("svg", { className: "member-login-cta__tear", viewBox: "0 0 390 16", preserveAspectRatio: "none", "aria-hidden": "true", children: /* @__PURE__ */ jsx8("path", { d: "M0,16 L390,16 L390,6 L358,10 L330,4 L298,11 L266,5 L236,12 L204,6 L174,12 L144,6 L112,13 L82,7 L52,14 L24,8 L0,12 Z" }) }),

package/dist/client/index.js

@@ -1,6 +1,6 @@
 import {
   clientModule
-} from "../chunk-KEBILLQ5.js";
+} from "../chunk-QWGRWD5C.js";
 export {
   clientModule
 };

package/dist/index.js

@@ -7,10 +7,10 @@ import {
   resolveMemberEnrollmentPort,
   resolveMemberProfilePort,
   serverModule
-} from "./chunk-T4SYPQA5.js";
+} from "./chunk-EPQEF43P.js";
 import {
   clientModule
-} from "./chunk-KEBILLQ5.js";
+} from "./chunk-QWGRWD5C.js";
 export {
   InMemoryMemberService,
   clientModule,

package/dist/{member-QFCIYILN.css → member-372B74DY.css}

@@ -1,6 +1,6 @@
 /* ============================================================
  * module-member 客户端域样式（0.4.0 D1/D2；头注二轮评审修正）。
- * 视觉源：mall-vis 双演示（MembershipMessageCard/MembershipInviteBanner 金系）；域色矩阵对照 docs/mall/visual.md。
+ * 视觉源：mall-vis 双演示（MembershipMessageCard/MembershipInviteBanner 金系）；域色矩阵对照 docs/reference/templates.md（视觉体系与域色矩阵）。
  * 基线（D2）：本仓库统一 750 设计稿 2x——源码 px 经 rootValue 100 转 rem，渲染折半（375 下 1px 源码 = 0.5px 物理）。
  *   POC membership 源按 web 物理 px 直觉作稿（如 avatar 76px——该值在 POC 同款 rootValue 100 管线下渲染折半为 38px，
  *   非设计意图），故本文件按 750 稿基线恢复意图：关键尺寸 ×2 于源值（76→152），其余（卡距/字阶 24/26/34/44）按
@@ -13,7 +13,7 @@
 
 /* ===== 域变量 ===== */
 .member-card {
-  --member-accent: #b45f06;
+  --member-accent: var(--tbox-domain-member-accent, #b45f06);
   --member-accent-strong: #b45f06;
   --member-label: #a3925f;
   --member-accent-soft: #fff6e0;
@@ -23,9 +23,9 @@
   --member-warning-light: var(--tbox-warning-light, #fff4e0);
   --member-muted: var(--tbox-text-secondary, #82745e);
   --member-faint: var(--tbox-text-muted, #a69a83);
-  --member-border: #ecdec2;
+  --member-border: var(--tbox-domain-member-border, #ecdec2);
   --member-bg-subtle: #fff8eb;
-  --member-surface: #fffdf8;
+  --member-surface: var(--tbox-domain-member-surface, #fffdf8);
   --member-accent-deep: #8c6a2f;
   --member-accent-deep-bg: #f9f1df;
   --member-accent-border: #ecdec2;
@@ -1597,8 +1597,14 @@
   bottom: 4PX;
   z-index: 2;
   width: 132PX;
-  height: auto;
+  aspect-ratio: 200 / 194; /* 资产契约 200×194，等比缩放 */
   transform: translateX(-50%);
+  /* 素材变量链（主题品牌资产轨 A1 级联修复）：元素只消费不声明（声明会截断主题覆写继承），
+     兜底 = 中立渐变（零品牌资产——B2），主题包经 html[data-theme] 段覆写 --tbox-asset-member-mascot */
+  background-image: var(--tbox-asset-member-mascot, linear-gradient(135deg, #fff8eb, #fffdf8));
+  background-size: contain;
+  background-repeat: no-repeat;
+  background-position: center bottom;
   /* 顶部淡入：图片上沿伸进天光区，不化开就是一条横切的硬边 */
   -webkit-mask-image: linear-gradient(180deg, rgba(0, 0, 0, 0) 0%, #000 22%, #000 100%);
   mask-image: linear-gradient(180deg, rgba(0, 0, 0, 0) 0%, #000 22%, #000 100%);

package/dist/server/index.d.ts

@@ -103,19 +103,19 @@ declare const memberCards: {
             labelRef: zod.ZodString;
             name: zod.ZodString;
         }, "strip", zod.ZodTypeAny, {
-            name: string;
             labelRef: string;
-        }, {
             name: string;
+        }, {
             labelRef: string;
+            name: string;
         }>, "many">;
     }, "strip", zod.ZodTypeAny, {
         userId: string;
-        state: "unknown" | "active" | "not_enrolled" | "closed";
         authState: "authenticated" | "unauthenticated";
+        state: "unknown" | "active" | "not_enrolled" | "closed";
         labels: {
-            name: string;
             labelRef: string;
+            name: string;
         }[];
         displayName?: string | undefined;
         avatarUrl?: string | undefined;
@@ -124,11 +124,11 @@ declare const memberCards: {
         registeredAt?: string | undefined;
     }, {
         userId: string;
-        state: "unknown" | "active" | "not_enrolled" | "closed";
         authState: "authenticated" | "unauthenticated";
+        state: "unknown" | "active" | "not_enrolled" | "closed";
         labels: {
-            name: string;
             labelRef: string;
+            name: string;
         }[];
         displayName?: string | undefined;
         avatarUrl?: string | undefined;
@@ -185,14 +185,14 @@ declare const memberCards: {
                 text: zod.ZodOptional<zod.ZodString>;
             }, "strip", zod.ZodTypeAny, {
                 kind: "toast" | "miniapp" | "dialog";
+                title?: string | undefined;
                 url?: string | undefined;
                 text?: string | undefined;
-                title?: string | undefined;
             }, {
                 kind: "toast" | "miniapp" | "dialog";
+                title?: string | undefined;
                 url?: string | undefined;
                 text?: string | undefined;
-                title?: string | undefined;
             }>>;
         }, "strip", zod.ZodTypeAny, {
             name: string;
@@ -200,9 +200,9 @@ declare const memberCards: {
             description?: string | undefined;
             action?: {
                 kind: "toast" | "miniapp" | "dialog";
+                title?: string | undefined;
                 url?: string | undefined;
                 text?: string | undefined;
-                title?: string | undefined;
             } | undefined;
             iconUrl?: string | undefined;
         }, {
@@ -211,9 +211,9 @@ declare const memberCards: {
             description?: string | undefined;
             action?: {
                 kind: "toast" | "miniapp" | "dialog";
+                title?: string | undefined;
                 url?: string | undefined;
                 text?: string | undefined;
-                title?: string | undefined;
             } | undefined;
             iconUrl?: string | undefined;
         }>, "many">>;
@@ -228,8 +228,8 @@ declare const memberCards: {
             query: string;
         }>, "many">>;
     }, "strip", zod.ZodTypeAny, {
-        status: "unknown" | "active" | "inactive" | "frozen" | "expired";
         userId: string;
+        status: "unknown" | "active" | "inactive" | "frozen" | "expired";
         cardRef: string;
         cardDisplay: string;
         availablePoints: number;
@@ -254,9 +254,9 @@ declare const memberCards: {
             description?: string | undefined;
             action?: {
                 kind: "toast" | "miniapp" | "dialog";
+                title?: string | undefined;
                 url?: string | undefined;
                 text?: string | undefined;
-                title?: string | undefined;
             } | undefined;
             iconUrl?: string | undefined;
         }[] | undefined;
@@ -265,8 +265,8 @@ declare const memberCards: {
             query: string;
         }[] | undefined;
     }, {
-        status: "unknown" | "active" | "inactive" | "frozen" | "expired";
         userId: string;
+        status: "unknown" | "active" | "inactive" | "frozen" | "expired";
         cardRef: string;
         cardDisplay: string;
         availablePoints: number;
@@ -291,9 +291,9 @@ declare const memberCards: {
             description?: string | undefined;
             action?: {
                 kind: "toast" | "miniapp" | "dialog";
+                title?: string | undefined;
                 url?: string | undefined;
                 text?: string | undefined;
-                title?: string | undefined;
             } | undefined;
             iconUrl?: string | undefined;
         }[] | undefined;
@@ -313,42 +313,42 @@ declare const memberCards: {
             usedAt: zod.ZodOptional<zod.ZodString>;
             description: zod.ZodOptional<zod.ZodString>;
         }, "strip", zod.ZodTypeAny, {
-            title: string;
             usageRecordRef: string;
+            title: string;
             amount: string;
-            description?: string | undefined;
             usedAt?: string | undefined;
+            description?: string | undefined;
         }, {
-            title: string;
             usageRecordRef: string;
+            title: string;
             amount: string;
-            description?: string | undefined;
             usedAt?: string | undefined;
+            description?: string | undefined;
         }>, "many">;
         total: zod.ZodNumber;
     }, "strip", zod.ZodTypeAny, {
         userId: string;
-        total: number;
+        balance: number;
         items: {
-            title: string;
             usageRecordRef: string;
+            title: string;
             amount: string;
-            description?: string | undefined;
             usedAt?: string | undefined;
+            description?: string | undefined;
         }[];
-        balance: number;
+        total: number;
         membershipLabel?: string | undefined;
     }, {
         userId: string;
-        total: number;
+        balance: number;
         items: {
-            title: string;
             usageRecordRef: string;
+            title: string;
             amount: string;
-            description?: string | undefined;
             usedAt?: string | undefined;
+            description?: string | undefined;
         }[];
-        balance: number;
+        total: number;
         membershipLabel?: string | undefined;
     }>>;
     readonly 'member-enrollment-form': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
@@ -390,15 +390,15 @@ declare const memberCards: {
             required: zod.ZodBoolean;
             url: zod.ZodOptional<zod.ZodString>;
         }, "strip", zod.ZodTypeAny, {
+            title: string;
             required: boolean;
             version: string;
-            title: string;
             consentId: string;
             url?: string | undefined;
         }, {
+            title: string;
             required: boolean;
             version: string;
-            title: string;
             consentId: string;
             url?: string | undefined;
         }>, "many">;
@@ -415,12 +415,11 @@ declare const memberCards: {
         manualNotice: zod.ZodOptional<zod.ZodString>;
     }, "strip", zod.ZodTypeAny, {
         userId: string;
+        state: "unknown" | "active" | "not_enrolled" | "closed";
         authorization: {
             status: "required" | "unavailable" | "authorized";
             mobileMasked?: string | undefined;
         };
-        state: "unknown" | "active" | "not_enrolled" | "closed";
-        formVersion: string;
         fields: {
             type: "date" | "text" | "tel" | "select";
             required: boolean;
@@ -431,22 +430,22 @@ declare const memberCards: {
             prefill?: string | undefined;
             placeholder?: string | undefined;
         }[];
+        formVersion: string;
         consents: {
+            title: string;
             required: boolean;
             version: string;
-            title: string;
             consentId: string;
             url?: string | undefined;
         }[];
         manualNotice?: string | undefined;
     }, {
         userId: string;
+        state: "unknown" | "active" | "not_enrolled" | "closed";
         authorization: {
             status: "required" | "unavailable" | "authorized";
             mobileMasked?: string | undefined;
         };
-        state: "unknown" | "active" | "not_enrolled" | "closed";
-        formVersion: string;
         fields: {
             type: "date" | "text" | "tel" | "select";
             required: boolean;
@@ -457,10 +456,11 @@ declare const memberCards: {
             prefill?: string | undefined;
             placeholder?: string | undefined;
         }[];
+        formVersion: string;
         consents: {
+            title: string;
             required: boolean;
             version: string;
-            title: string;
             consentId: string;
             url?: string | undefined;
         }[];
@@ -474,15 +474,15 @@ declare const memberCards: {
         message: zod.ZodOptional<zod.ZodString>;
     }, "strip", zod.ZodTypeAny, {
         userId: string;
-        state: "failed" | "active" | "pending_confirmation" | "confirmation_timeout";
-        message?: string | undefined;
+        state: "active" | "failed" | "pending_confirmation" | "confirmation_timeout";
         memberRef?: string | undefined;
+        message?: string | undefined;
         attemptRef?: string | undefined;
     }, {
         userId: string;
-        state: "failed" | "active" | "pending_confirmation" | "confirmation_timeout";
-        message?: string | undefined;
+        state: "active" | "failed" | "pending_confirmation" | "confirmation_timeout";
         memberRef?: string | undefined;
+        message?: string | undefined;
         attemptRef?: string | undefined;
     }>>;
     readonly 'member-enrollment-cta': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
@@ -495,16 +495,16 @@ declare const memberCards: {
         perks: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
     }, "strip", zod.ZodTypeAny, {
         userId: string;
-        state: "not_enrolled" | "closed";
         authState: "authenticated";
+        state: "not_enrolled" | "closed";
         title?: string | undefined;
         subtitle?: string | undefined;
         enrollUrl?: string | undefined;
         perks?: string[] | undefined;
     }, {
         userId: string;
-        state: "not_enrolled" | "closed";
         authState: "authenticated";
+        state: "not_enrolled" | "closed";
         title?: string | undefined;
         subtitle?: string | undefined;
         enrollUrl?: string | undefined;
@@ -541,19 +541,19 @@ declare const serverModule: {
                 labelRef: zod.ZodString;
                 name: zod.ZodString;
             }, "strip", zod.ZodTypeAny, {
-                name: string;
                 labelRef: string;
-            }, {
                 name: string;
+            }, {
                 labelRef: string;
+                name: string;
             }>, "many">;
         }, "strip", zod.ZodTypeAny, {
             userId: string;
-            state: "unknown" | "active" | "not_enrolled" | "closed";
             authState: "authenticated" | "unauthenticated";
+            state: "unknown" | "active" | "not_enrolled" | "closed";
             labels: {
-                name: string;
                 labelRef: string;
+                name: string;
             }[];
             displayName?: string | undefined;
             avatarUrl?: string | undefined;
@@ -562,11 +562,11 @@ declare const serverModule: {
             registeredAt?: string | undefined;
         }, {
             userId: string;
-            state: "unknown" | "active" | "not_enrolled" | "closed";
             authState: "authenticated" | "unauthenticated";
+            state: "unknown" | "active" | "not_enrolled" | "closed";
             labels: {
-                name: string;
                 labelRef: string;
+                name: string;
             }[];
             displayName?: string | undefined;
             avatarUrl?: string | undefined;
@@ -623,14 +623,14 @@ declare const serverModule: {
                     text: zod.ZodOptional<zod.ZodString>;
                 }, "strip", zod.ZodTypeAny, {
                     kind: "toast" | "miniapp" | "dialog";
+                    title?: string | undefined;
                     url?: string | undefined;
                     text?: string | undefined;
-                    title?: string | undefined;
                 }, {
                     kind: "toast" | "miniapp" | "dialog";
+                    title?: string | undefined;
                     url?: string | undefined;
                     text?: string | undefined;
-                    title?: string | undefined;
                 }>>;
             }, "strip", zod.ZodTypeAny, {
                 name: string;
@@ -638,9 +638,9 @@ declare const serverModule: {
                 description?: string | undefined;
                 action?: {
                     kind: "toast" | "miniapp" | "dialog";
+                    title?: string | undefined;
                     url?: string | undefined;
                     text?: string | undefined;
-                    title?: string | undefined;
                 } | undefined;
                 iconUrl?: string | undefined;
             }, {
@@ -649,9 +649,9 @@ declare const serverModule: {
                 description?: string | undefined;
                 action?: {
                     kind: "toast" | "miniapp" | "dialog";
+                    title?: string | undefined;
                     url?: string | undefined;
                     text?: string | undefined;
-                    title?: string | undefined;
                 } | undefined;
                 iconUrl?: string | undefined;
             }>, "many">>;
@@ -666,8 +666,8 @@ declare const serverModule: {
                 query: string;
             }>, "many">>;
         }, "strip", zod.ZodTypeAny, {
-            status: "unknown" | "active" | "inactive" | "frozen" | "expired";
             userId: string;
+            status: "unknown" | "active" | "inactive" | "frozen" | "expired";
             cardRef: string;
             cardDisplay: string;
             availablePoints: number;
@@ -692,9 +692,9 @@ declare const serverModule: {
                 description?: string | undefined;
                 action?: {
                     kind: "toast" | "miniapp" | "dialog";
+                    title?: string | undefined;
                     url?: string | undefined;
                     text?: string | undefined;
-                    title?: string | undefined;
                 } | undefined;
                 iconUrl?: string | undefined;
             }[] | undefined;
@@ -703,8 +703,8 @@ declare const serverModule: {
                 query: string;
             }[] | undefined;
         }, {
-            status: "unknown" | "active" | "inactive" | "frozen" | "expired";
             userId: string;
+            status: "unknown" | "active" | "inactive" | "frozen" | "expired";
             cardRef: string;
             cardDisplay: string;
             availablePoints: number;
@@ -729,9 +729,9 @@ declare const serverModule: {
                 description?: string | undefined;
                 action?: {
                     kind: "toast" | "miniapp" | "dialog";
+                    title?: string | undefined;
                     url?: string | undefined;
                     text?: string | undefined;
-                    title?: string | undefined;
                 } | undefined;
                 iconUrl?: string | undefined;
             }[] | undefined;
@@ -751,42 +751,42 @@ declare const serverModule: {
                 usedAt: zod.ZodOptional<zod.ZodString>;
                 description: zod.ZodOptional<zod.ZodString>;
             }, "strip", zod.ZodTypeAny, {
-                title: string;
                 usageRecordRef: string;
+                title: string;
                 amount: string;
-                description?: string | undefined;
                 usedAt?: string | undefined;
+                description?: string | undefined;
             }, {
-                title: string;
                 usageRecordRef: string;
+                title: string;
                 amount: string;
-                description?: string | undefined;
                 usedAt?: string | undefined;
+                description?: string | undefined;
             }>, "many">;
             total: zod.ZodNumber;
         }, "strip", zod.ZodTypeAny, {
             userId: string;
-            total: number;
+            balance: number;
             items: {
-                title: string;
                 usageRecordRef: string;
+                title: string;
                 amount: string;
-                description?: string | undefined;
                 usedAt?: string | undefined;
+                description?: string | undefined;
             }[];
-            balance: number;
+            total: number;
             membershipLabel?: string | undefined;
         }, {
             userId: string;
-            total: number;
+            balance: number;
             items: {
-                title: string;
                 usageRecordRef: string;
+                title: string;
                 amount: string;
-                description?: string | undefined;
                 usedAt?: string | undefined;
+                description?: string | undefined;
             }[];
-            balance: number;
+            total: number;
             membershipLabel?: string | undefined;
         }>>;
         readonly 'member-enrollment-form': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
@@ -828,15 +828,15 @@ declare const serverModule: {
                 required: zod.ZodBoolean;
                 url: zod.ZodOptional<zod.ZodString>;
             }, "strip", zod.ZodTypeAny, {
+                title: string;
                 required: boolean;
                 version: string;
-                title: string;
                 consentId: string;
                 url?: string | undefined;
             }, {
+                title: string;
                 required: boolean;
                 version: string;
-                title: string;
                 consentId: string;
                 url?: string | undefined;
             }>, "many">;
@@ -853,12 +853,11 @@ declare const serverModule: {
             manualNotice: zod.ZodOptional<zod.ZodString>;
         }, "strip", zod.ZodTypeAny, {
             userId: string;
+            state: "unknown" | "active" | "not_enrolled" | "closed";
             authorization: {
                 status: "required" | "unavailable" | "authorized";
                 mobileMasked?: string | undefined;
             };
-            state: "unknown" | "active" | "not_enrolled" | "closed";
-            formVersion: string;
             fields: {
                 type: "date" | "text" | "tel" | "select";
                 required: boolean;
@@ -869,22 +868,22 @@ declare const serverModule: {
                 prefill?: string | undefined;
                 placeholder?: string | undefined;
             }[];
+            formVersion: string;
             consents: {
+                title: string;
                 required: boolean;
                 version: string;
-                title: string;
                 consentId: string;
                 url?: string | undefined;
             }[];
             manualNotice?: string | undefined;
         }, {
             userId: string;
+            state: "unknown" | "active" | "not_enrolled" | "closed";
             authorization: {
                 status: "required" | "unavailable" | "authorized";
                 mobileMasked?: string | undefined;
             };
-            state: "unknown" | "active" | "not_enrolled" | "closed";
-            formVersion: string;
             fields: {
                 type: "date" | "text" | "tel" | "select";
                 required: boolean;
@@ -895,10 +894,11 @@ declare const serverModule: {
                 prefill?: string | undefined;
                 placeholder?: string | undefined;
             }[];
+            formVersion: string;
             consents: {
+                title: string;
                 required: boolean;
                 version: string;
-                title: string;
                 consentId: string;
                 url?: string | undefined;
             }[];
@@ -912,15 +912,15 @@ declare const serverModule: {
             message: zod.ZodOptional<zod.ZodString>;
         }, "strip", zod.ZodTypeAny, {
             userId: string;
-            state: "failed" | "active" | "pending_confirmation" | "confirmation_timeout";
-            message?: string | undefined;
+            state: "active" | "failed" | "pending_confirmation" | "confirmation_timeout";
             memberRef?: string | undefined;
+            message?: string | undefined;
             attemptRef?: string | undefined;
         }, {
             userId: string;
-            state: "failed" | "active" | "pending_confirmation" | "confirmation_timeout";
-            message?: string | undefined;
+            state: "active" | "failed" | "pending_confirmation" | "confirmation_timeout";
             memberRef?: string | undefined;
+            message?: string | undefined;
             attemptRef?: string | undefined;
         }>>;
         readonly 'member-enrollment-cta': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
@@ -933,16 +933,16 @@ declare const serverModule: {
             perks: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
         }, "strip", zod.ZodTypeAny, {
             userId: string;
-            state: "not_enrolled" | "closed";
             authState: "authenticated";
+            state: "not_enrolled" | "closed";
             title?: string | undefined;
             subtitle?: string | undefined;
             enrollUrl?: string | undefined;
             perks?: string[] | undefined;
         }, {
             userId: string;
-            state: "not_enrolled" | "closed";
             authState: "authenticated";
+            state: "not_enrolled" | "closed";
             title?: string | undefined;
             subtitle?: string | undefined;
             enrollUrl?: string | undefined;

package/dist/server/index.js

@@ -7,7 +7,7 @@ import {
   resolveMemberEnrollmentPort,
   resolveMemberProfilePort,
   serverModule
-} from "../chunk-T4SYPQA5.js";
+} from "../chunk-EPQEF43P.js";
 export {
   InMemoryMemberService,
   memberCards,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tbox.cn/app-module-member",
-  "version": "0.8.6",
+  "version": "0.9.0",
   "type": "module",
   "description": "商圈会员模块：会员账户、会员卡、积分流水与入会流程（codegen 源）。",
   "exports": {
@@ -18,9 +18,9 @@
     }
   },
   "dependencies": {
-    "@tbox.cn/app-sdk": "0.17.0",
-    "@tbox.cn/app-contracts": "0.9.0",
-    "@tbox.cn/app-contracts-mall": "0.9.0"
+    "@tbox.cn/app-sdk": "0.20.0",
+    "@tbox.cn/app-contracts": "0.11.0",
+    "@tbox.cn/app-contracts-mall": "0.11.0"
   },
   "peerDependencies": {
     "zod": "3.25.76",

package/src/client/cards/member-login-cta/index.tsx

@@ -10,7 +10,6 @@
 import { useRef, useState } from 'react';
 import { ArrowSquareOut, WarningCircle } from '@phosphor-icons/react';
 import { sendCardAction } from '@tbox.cn/app-sdk/client';
-import mascotUrl from '../../assets/login-mascot.jpg';
 import type { MemberLoginCtaCardData } from '@tbox.cn/app-contracts-mall';
 
 export function MemberLoginCtaCard(props: {
@@ -42,7 +41,8 @@ export function MemberLoginCtaCard(props: {
         </svg>
         {/* 地面光斑：把角色钉在台面上，否则它像浮在纸上 */}
         <span className="member-login-cta__ground" aria-hidden="true" />
-        <img className="member-login-cta__mascot" src={mascotUrl} alt="" />
+        {/* 素材变量链（主题轨 T-2.3）：装饰主视觉走 CSS background，主题包经 --tbox-asset-member-mascot 覆写 */}
+        <span className="member-login-cta__mascot" aria-hidden="true" />
         <span className="member-login-cta__grain" aria-hidden="true" />
       </div>
 

package/src/client/styles/member.css

@@ -1,6 +1,6 @@
 /* ============================================================
  * module-member 客户端域样式（0.4.0 D1/D2；头注二轮评审修正）。
- * 视觉源：mall-vis 双演示（MembershipMessageCard/MembershipInviteBanner 金系）；域色矩阵对照 docs/mall/visual.md。
+ * 视觉源：mall-vis 双演示（MembershipMessageCard/MembershipInviteBanner 金系）；域色矩阵对照 docs/reference/templates.md（视觉体系与域色矩阵）。
  * 基线（D2）：本仓库统一 750 设计稿 2x——源码 px 经 rootValue 100 转 rem，渲染折半（375 下 1px 源码 = 0.5px 物理）。
  *   POC membership 源按 web 物理 px 直觉作稿（如 avatar 76px——该值在 POC 同款 rootValue 100 管线下渲染折半为 38px，
  *   非设计意图），故本文件按 750 稿基线恢复意图：关键尺寸 ×2 于源值（76→152），其余（卡距/字阶 24/26/34/44）按
@@ -13,7 +13,7 @@
 
 /* ===== 域变量 ===== */
 .member-card {
-  --member-accent: #b45f06;
+  --member-accent: var(--tbox-domain-member-accent, #b45f06);
   --member-accent-strong: #b45f06;
   --member-label: #a3925f;
   --member-accent-soft: #fff6e0;
@@ -23,9 +23,9 @@
   --member-warning-light: var(--tbox-warning-light, #fff4e0);
   --member-muted: var(--tbox-text-secondary, #82745e);
   --member-faint: var(--tbox-text-muted, #a69a83);
-  --member-border: #ecdec2;
+  --member-border: var(--tbox-domain-member-border, #ecdec2);
   --member-bg-subtle: #fff8eb;
-  --member-surface: #fffdf8;
+  --member-surface: var(--tbox-domain-member-surface, #fffdf8);
   --member-accent-deep: #8c6a2f;
   --member-accent-deep-bg: #f9f1df;
   --member-accent-border: #ecdec2;
@@ -1597,8 +1597,14 @@
   bottom: 4PX;
   z-index: 2;
   width: 132PX;
-  height: auto;
+  aspect-ratio: 200 / 194; /* 资产契约 200×194，等比缩放 */
   transform: translateX(-50%);
+  /* 素材变量链（主题品牌资产轨 A1 级联修复）：元素只消费不声明（声明会截断主题覆写继承），
+     兜底 = 中立渐变（零品牌资产——B2），主题包经 html[data-theme] 段覆写 --tbox-asset-member-mascot */
+  background-image: var(--tbox-asset-member-mascot, linear-gradient(135deg, #fff8eb, #fffdf8));
+  background-size: contain;
+  background-repeat: no-repeat;
+  background-position: center bottom;
   /* 顶部淡入：图片上沿伸进天光区，不化开就是一条横切的硬边 */
   -webkit-mask-image: linear-gradient(180deg, rgba(0, 0, 0, 0) 0%, #000 22%, #000 100%);
   mask-image: linear-gradient(180deg, rgba(0, 0, 0, 0) 0%, #000 22%, #000 100%);

package/src/server/index.ts

@@ -1,6 +1,7 @@
 import type { ServerContext, ServerModule } from '@tbox.cn/app-sdk/server';
 import { loadModuleSkills, withCardEmissionHint, withEarlyExecution } from '@tbox.cn/app-sdk/server';
 import type { RequestContext } from '@tbox.cn/app-contracts';
+import { MEMBER_SNAPSHOT_SERVICE, type MemberSnapshotPort } from '@tbox.cn/app-contracts-mall';
 import memberInfoMeta from './cards/member-info/meta';
 import memberCardSummaryMeta from './cards/member-card-summary/meta';
 import memberPointUsageListMeta from './cards/member-point-usage-list/meta';
@@ -153,5 +154,24 @@ export const serverModule = {
     // 015 D9：主体绑定（promotion acquire 消费；ctx.services 跨模块 resolveService）
     ctx.services.register('member.subject-binding', createSubjectBinding(ctx));
 
+    // 会员快览工厂（member.snapshot，W3-3）：首页联单面板跨模块消费面
+    // （账户/授权三态 + 积分 + 入会引导）。三槽组装——enrollment 槽 fail-soft
+    // （缺席不拖垮账户/积分主面）；工厂运行期执行（注册期纯净铁律）。
+    ctx.services.register(
+      MEMBER_SNAPSHOT_SERVICE,
+      async (reqCtx: RequestContext): Promise<MemberSnapshotPort> => {
+        const [account, benefits, enrollment] = await Promise.all([
+          resolveMemberAccountPort(reqCtx, ctx),
+          resolveMemberBenefitsPort(reqCtx, ctx),
+          resolveMemberEnrollmentPort(reqCtx, ctx).catch(() => null),
+        ]);
+        return {
+          getAccount: (userId: string) => account.getAccount(userId),
+          queryPoints: (userId: string) => benefits.queryPoints(userId),
+          ...(enrollment?.enrollUrl ? { enrollUrl: enrollment.enrollUrl } : {}),
+        };
+      },
+    );
+
   },
 } satisfies ServerModule;

package/tbox.module.json

@@ -1,6 +1,8 @@
 {
   "schemaVersion": 1,
   "name": "module-member",
+  "title": "会员积分",
+  "description": "会员信息与会员卡、积分余额与流水、入会引导（两步授权）",
   "version": "0.3.0",
   "kind": "business",
   "risk": {

package/tests/enrollment.test.ts

@@ -20,7 +20,7 @@ const state = createInMemoryStateStore();
 const ctxFake = { state } as never;
 const actions = createMemberActions(ctxFake, async () => member);
 const reqCtx = (userId = 'u_1'): RequestContext =>
-  ({ identity: { userId, source: 'dev' }, attributes: { mall: { miniAppId: 'app', mallId: 'mall-1', subjectId: 's1' } } }) as never;
+  ({ identity: { userId, source: 'local' }, attributes: { mall: { miniAppId: 'app', mallId: 'mall-1', subjectId: 's1' } } }) as never;
 
 describe('入会链：授权 → 预填 → 提交 → 刷新', () => {
   it('阶段 1：request-alipay-authorization 返回 authorization effect（resultActionId 指向回调动作）', async () => {

package/tests/ports-resolve.test.ts

@@ -19,7 +19,7 @@ import {
 
 function requestContext(mallId = 'mall-demo', token = 'user-token'): RequestContext {
   return {
-    identity: { userId: 'u_1001', source: 'dev' },
+    identity: { userId: 'u_1001', source: 'local' },
     credentials: { provider: 'dev', token },
     attributes: { mall: { miniAppId: 'demo-app', mallId } },
   };

package/tests/preference-memory.test.ts

@@ -7,7 +7,7 @@ function authenticatedContext(userId = 'user-1', mallId = 'mall-1') {
   const memory = createInMemoryMemoryStore();
   const ctx = createServerContext({ memory });
   const reqCtx = {
-    identity: { userId, source: 'dev' as const },
+    identity: { userId, source: 'local' as const },
     attributes: { mall: { mallId, miniAppId: 'app-1', subjectId: 'subject-1' } },
   };
   return { ctx, memory, reqCtx };
@@ -63,7 +63,7 @@ describe('会员偏好长期记忆', () => {
       'intent',
       { content: '我常带娃来玩' },
       disabled,
-      { identity: { userId: 'user-1', source: 'dev' as const } },
+      { identity: { userId: 'user-1', source: 'local' as const } },
     );
     expect(disabledResult.text).toContain('暂不可用');
   });

package/tests/service.test.ts

@@ -53,7 +53,7 @@ function memberPortsOf(getStub: () => Promise<MemberService>): import('../src/se
 
 function requestContext(mallId = 'mall-demo', token = 'user-token', provider = 'dev'): RequestContext {
   return {
-    identity: { userId: 'u_1001', source: 'dev' },
+    identity: { userId: 'u_1001', source: 'local' },
     credentials: { provider, token },
     attributes: { mall: { miniAppId: 'demo-app', mallId } },
   };
@@ -363,7 +363,7 @@ describe('module-member 槽位轴工具链', () => {
     // 上下文统一化：userId 来自运行身份（reqCtx.identity.userId）不再经 LLM 传参——
     // 数值形态字符串由 requestContext 的 userId 承载（注入面关闭后该用例锁「字符串不数值化」）
     const numericCtx = createToolExecContext({
-      identity: { userId: '17000001019327925', source: 'dev' },
+      identity: { userId: '17000001019327925', source: 'local' },
       attributes: { mall: { miniAppId: 'demo-app', mallId: 'mall-demo' } },
     });
     const tool = ctx.tools.resolve('queryMemberInfo') as unknown as { execute(input: unknown, execCtx?: ToolExecContextLike): Promise<Record<string, unknown>> };
@@ -529,7 +529,7 @@ describe('module-member 槽位轴工具链', () => {
 });
 
 describe('createMemberHandler 查询路径门禁（意图与工具路径一致：不再对非 active 态答「积分 0」）', () => {
-  const handlerReqCtx = (source: 'dev' | 'anonymous' = 'dev'): RequestContext =>
+  const handlerReqCtx = (source: 'local' | 'anonymous' = 'local'): RequestContext =>
     ({
       identity: { userId: 'u_1001', source },
       attributes: { mall: { miniAppId: 'demo-app', mallId: 'mall-demo' } },

package/tests/snapshot-service.test.ts

@@ -0,0 +1,75 @@
+/**
+ * member.snapshot 快览服务回归（W3-3 单一模板统一化）：
+ * register 注册三槽组装工厂——账户/积分主面透传，enrollment 槽 fail-soft
+ * （缺席/失败不拖垮主面，enrollUrl 缺省）。
+ */
+import { describe, expect, it, vi } from 'vitest';
+
+vi.mock('../src/server/ports', async (importOriginal) => {
+  const actual = await importOriginal<typeof import('../src/server/ports')>();
+  return {
+    ...actual,
+    resolveMemberAccountPort: vi.fn(),
+    resolveMemberBenefitsPort: vi.fn(),
+    resolveMemberEnrollmentPort: vi.fn(),
+  };
+});
+
+import type { RequestContext } from '@tbox.cn/app-contracts';
+import type { MemberSnapshotPort } from '@tbox.cn/app-contracts-mall';
+import { MEMBER_SNAPSHOT_SERVICE } from '@tbox.cn/app-contracts-mall';
+import { createServerContext } from '@tbox.cn/app-sdk/server';
+import { serverModule } from '../src/server/index';
+import {
+  resolveMemberAccountPort,
+  resolveMemberBenefitsPort,
+  resolveMemberEnrollmentPort,
+} from '../src/server/ports';
+
+const makeReqCtx = () =>
+  ({
+    identity: { userId: 'u_1', source: 'local' },
+    conversationId: 'conv_snapshot',
+    attributes: { mall: { miniAppId: 'app', mallId: 'mall-1' } },
+  }) as unknown as RequestContext;
+
+describe('member.snapshot 快览工厂（register 注册，运行期解析）', () => {
+  it('register 注册工厂；三槽主面透传 + enrollUrl 透传', async () => {
+    const ctx = createServerContext();
+    serverModule.register(ctx);
+    const factory = ctx.resolveService<(reqCtx: RequestContext) => Promise<MemberSnapshotPort>>(
+      MEMBER_SNAPSHOT_SERVICE,
+    );
+    expect(factory).toBeTypeOf('function');
+
+    const getAccount = vi.fn(async () => ({ authState: 'authenticated', state: 'active' }));
+    const queryPoints = vi.fn(async () => ({ balance: '100' }));
+    vi.mocked(resolveMemberAccountPort).mockResolvedValue({ getAccount } as never);
+    vi.mocked(resolveMemberBenefitsPort).mockResolvedValue({ queryPoints } as never);
+    vi.mocked(resolveMemberEnrollmentPort).mockResolvedValue({ enrollUrl: 'https://enroll.example' } as never);
+
+    const port = await factory!(makeReqCtx());
+    await port.getAccount('u_1');
+    await port.queryPoints('u_1');
+    expect(getAccount).toHaveBeenCalledWith('u_1');
+    expect(queryPoints).toHaveBeenCalledWith('u_1');
+    expect(port.enrollUrl).toBe('https://enroll.example');
+  });
+
+  it('enrollment 槽失败 fail-soft：enrollUrl 缺席，账户/积分主面存活', async () => {
+    const ctx = createServerContext();
+    serverModule.register(ctx);
+    const factory = ctx.resolveService<(reqCtx: RequestContext) => Promise<MemberSnapshotPort>>(
+      MEMBER_SNAPSHOT_SERVICE,
+    );
+
+    const getAccount = vi.fn(async () => ({ authState: 'authenticated', state: 'not_enrolled' }));
+    vi.mocked(resolveMemberAccountPort).mockResolvedValue({ getAccount } as never);
+    vi.mocked(resolveMemberBenefitsPort).mockResolvedValue({ queryPoints: vi.fn() } as never);
+    vi.mocked(resolveMemberEnrollmentPort).mockRejectedValue(new Error('enrollment down'));
+
+    const port = await factory!(makeReqCtx());
+    await expect(port.getAccount('u_1')).resolves.toMatchObject({ state: 'not_enrolled' });
+    expect(port.enrollUrl).toBeUndefined();
+  });
+});

package/tests/status.test.ts

@@ -7,7 +7,7 @@ import type { RequestContext } from '@tbox.cn/app-contracts';
 import type { ServerContext } from '@tbox.cn/app-sdk/server';
 import { resolveMemberStatus, MEMBER_QUERY_NOTICES } from '../src/server/status';
 
-const reqCtx = (source: 'dev' | 'anonymous' = 'dev'): RequestContext =>
+const reqCtx = (source: 'local' | 'anonymous' = 'local'): RequestContext =>
   ({
     identity: { userId: 'u_1001', source },
     attributes: { mall: { miniAppId: 'demo-app', mallId: 'mall-demo' } },

package/src/client/assets.d.ts

@@ -1,5 +0,0 @@
-/** Static member image assets bundled by Vite/tsup. */
-declare module '*.jpg' {
-  const url: string;
-  export default url;
-}