@yaoxiu/marketing-dsl 1.5.2 → 2.0.0

package/dist/{types-BgUaJUAu.d.ts → types-Bj0xyWnx.d.ts}

@@ -213,7 +213,12 @@ interface RenderLayer {
 interface RenderTree {
     /** 数据没回来或加载失败时为 false，框架层什么都不画 */
     ready: boolean;
-    /** 有弹窗层时框架层需要撑满宿主容器 */
+    /**
+     * 当前视图栈里是否有弹窗视图。
+     *
+     * 注意不是「配置里有没有 popup 视图」——多视图配置（如公告条点击弹出弹窗）在弹出之前
+     * 这里是 `false`，根容器保持 `relative`，宿主的流式坑位才不会被脱流的根节点撑塌。
+     */
     hasPopup: boolean;
     /** 根容器样式，已按 hasPopup 算好 */
     rootStyle: CssStyle;
@@ -225,6 +230,51 @@ interface RenderTree {
 }
 type DslSource = (params: Record<string, unknown>, user: Record<string, unknown>) => unknown | Promise<unknown>;
 type DslHandler = (params: Record<string, unknown>) => void;
+/**
+ * 一次交互（手势 / 时机）的触发来源。
+ *
+ * - `show`：视图的 `stage.onShow` 被触发（曝光时机）
+ * - `close`：视图的 `stage.onClose` 被触发（关闭时机）
+ * - `action`：用户点了带 `action` 的节点（含关闭按钮、tab、倒计时 `onEnd`）
+ */
+type DslInteractionTrigger = 'show' | 'close' | 'action';
+/**
+ * 一次交互的汇总事件（`interaction`），**专供上报**。
+ *
+ * 【为什么要有它】`track` / `navigate` 是**动作**粒度的事件，一次手势里配
+ * `sequence: [track, navigate]`（先埋点再跳转）是标准写法，按动作上报必然把点击量翻倍；
+ * 而 `track` 还能挂在 `stage.onShow` / `stage.onClose` 上，动作粒度看不出时机，
+ * 一律算成点击会把曝光和关闭也计成点击。
+ *
+ * 所以在**时机**粒度上再派发一条汇总事件：一次手势 = 一条 `interaction`，
+ * `sequence` 里有 N 个动作也只汇总成一条。原有的 `track` / `navigate` / `close` /
+ * `call` / `error` 事件语义不变、照常派发（宿主要靠它们做跳转、接自有埋点系统），
+ * `interaction` 是**新增**的，不替代任何既有事件。
+ */
+interface DslInteractionEvent {
+    /** 触发时机 */
+    trigger: DslInteractionTrigger;
+    /** 关闭原因，仅 `trigger='close'` 时有值 */
+    reason?: string;
+    /** 这次交互里的埋点动作；`sequence` 里有多个 `track` 时只取第一个 */
+    track?: {
+        event: string;
+        params?: Record<string, unknown>;
+    };
+    /** 这次交互里的跳转动作；有多个 `navigate` 时只取第一个 */
+    navigate?: {
+        url: string;
+        target?: string;
+    };
+    /**
+     * 这次交互里执行了关闭动作（`close` / `closeAll`）。
+     *
+     * 用来把「点关闭按钮」和「点营销内容」区分开：前者的本质是关闭，不该再算一次点击。
+     * 运营常把埋点配进关闭按钮的 `sequence: [track, close]`，不标记的话这一下会同时
+     * 产出 close 和 click 两条，点击量照样虚增。埋点名不会丢 —— 宿主把它并进 close 上报。
+     */
+    closes?: boolean;
+}
 interface RuntimeEvents {
     ready: {
         keys: string[];
@@ -244,6 +294,8 @@ interface RuntimeEvents {
         name: string;
         params: Record<string, unknown>;
     };
+    /** 一次交互的汇总事件，专供上报，见 {@link DslInteractionEvent} */
+    interaction: DslInteractionEvent;
     'state-change': Record<string, unknown>;
     'view-change': {
         view: string;
@@ -290,4 +342,4 @@ interface RuntimeOptions {
     emit?: RuntimeEmit;
 }
 
-export type { DslHandler as A, RuntimeEvents as B, CssStyle as C, Dsl as D, RuntimeEventName as E, RuntimeEmit as F, RuntimeOptions as R, RenderTree as a, DslView as b, DslStyle as c, DslViewType as d, DslNodeType as e, DslLength as f, DslRect as g, DslActionBase as h, DslNavigateAction as i, DslCloseAction as j, DslCloseAllAction as k, DslOpenAction as l, DslSetStateAction as m, DslTrackAction as n, DslCallAction as o, DslSequenceAction as p, DslAction as q, DslNode as r, DslClosePosition as s, DslCloseButton as t, DslStage as u, DslSourceRef as v, DslDerived as w, RenderElement as x, RenderLayer as y, DslSource as z };
+export type { DslHandler as A, DslInteractionTrigger as B, CssStyle as C, Dsl as D, DslInteractionEvent as E, RuntimeEvents as F, RuntimeEventName as G, RuntimeEmit as H, RuntimeOptions as R, RenderTree as a, DslView as b, DslStyle as c, DslViewType as d, DslNodeType as e, DslLength as f, DslRect as g, DslActionBase as h, DslNavigateAction as i, DslCloseAction as j, DslCloseAllAction as k, DslOpenAction as l, DslSetStateAction as m, DslTrackAction as n, DslCallAction as o, DslSequenceAction as p, DslAction as q, DslNode as r, DslClosePosition as s, DslCloseButton as t, DslStage as u, DslSourceRef as v, DslDerived as w, RenderElement as x, RenderLayer as y, DslSource as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yaoxiu/marketing-dsl",
-  "version": "1.5.2",
+  "version": "2.0.0",
   "type": "module",
   "description": "营销弹窗 DSL 解释器核心，纯逻辑无框架依赖",
   "license": "MIT",