@yaoxiu/marketing-dsl 2.7.0 → 2.9.0

package/dist/index.js

@@ -1,5 +1,5 @@
-import { normalizeViews, nextScopeUid, createTicker, createCssBuilder, declarations, toCssStyle, interpolateDeep, evaluate, resolveNodeStyle, interpolate, toLength, computeParts, formatParts, parseEndTime } from './chunk-DT3ZINDI.js';
-export { ACTION_TYPES, ALLOWED_EASINGS, ALLOWED_STYLE_KEYS, BANNER_MIN_ASPECT_RATIO, CLOSE_POSITIONS, CSS_NAME_PATTERN, DEFAULT_USER_FIELDS, DSL_VERSION, NODE_TYPES, SINGLE_VIEW_NAME, TRACK_EVENT_PATTERN, USER_FIELD_LABELS, check, computeParts, evaluate, formatIssues, formatParts, interpolate, interpolateDeep, isKeyframeOffset, isLength, isValidEasing, isValidEndTime, normalizeViews, parseEndTime, sanitizeCssValue, toCssStyle, toLength, validate, validateUserFields } from './chunk-DT3ZINDI.js';
+import { normalizeViews, nextScopeUid, createTicker, createAutoplay, createCssBuilder, declarations, toCssStyle, interpolateDeep, evaluate, resolveNodeStyle, interpolate, toLength, computeParts, formatParts, parseEndTime } from './chunk-B6BKOMWL.js';
+export { ACTION_TYPES, ALLOWED_EASINGS, ALLOWED_STYLE_KEYS, AUTOPLAY_FIELDS, AUTOPLAY_MIN_INTERVAL, BANNER_MIN_ASPECT_RATIO, CLOSE_POSITIONS, CSS_NAME_PATTERN, DEFAULT_USER_FIELDS, DERIVED_FIELDS, DSL_VERSION, NODE_TYPES, SINGLE_VIEW_NAME, TRACK_EVENT_PATTERN, USER_FIELD_LABELS, check, computeParts, evaluate, formatIssues, formatParts, interpolate, interpolateDeep, isKeyframeOffset, isLength, isValidEasing, isValidEndTime, normalizeViews, parseEndTime, sanitizeCssValue, toCssStyle, toLength, validate, validateAutoplay, validateUserFields } from './chunk-B6BKOMWL.js';
 
 // src/url.ts
 var SAFE_PROTOCOLS = ["http:", "https:", "mailto:", "tel:"];
@@ -716,7 +716,19 @@ function createRuntime(dsl, options = {}) {
     state = Object.assign({}, state, { [key]: value });
     emit("state-change", Object.assign({}, state));
     notify();
+    autoplay.reset(key);
   }
+  const autoplay = createAutoplay({
+    derived: dsl.derived,
+    getLength: (name) => {
+      const list = resolvedData[name];
+      return Array.isArray(list) ? list.length : 0;
+    },
+    getIndex: (key) => Number(state[key]) || 0,
+    setState: (key, value) => {
+      if (!destroyed) setState(key, value);
+    }
+  });
   function openView(name, mode) {
     if (!normalized.views[name]) {
       emit("error", { type: "unknown-view", name });
@@ -817,6 +829,7 @@ function createRuntime(dsl, options = {}) {
       notify();
       fireLifecycle(normalized.entry, "onShow");
       emit("ready", { keys: Object.keys(resolved) });
+      autoplay.start();
     }).catch((error) => {
       if (destroyed) return;
       loading = false;
@@ -845,6 +858,10 @@ function createRuntime(dsl, options = {}) {
       hover
     });
     ticker.sync(tree.countdownEndTimes, tree.countdownPrecision);
+    if (autoplay.pausable) {
+      tree.onRootEnter = autoplay.pause;
+      tree.onRootLeave = autoplay.resume;
+    }
     return tree;
   }
   return {
@@ -864,6 +881,7 @@ function createRuntime(dsl, options = {}) {
     destroy() {
       destroyed = true;
       ticker.stop();
+      autoplay.stop();
       listeners.clear();
     }
   };

package/dist/report/index.cjs

@@ -46,7 +46,7 @@ function mapRuntimeEventToReport(id, event, payload) {
   if (event !== "interaction") return null;
   const data = payload != null ? payload : {};
   if (data.trigger !== "action") return null;
-  if (data.closes) return null;
+  if (data.closes && !data.navigate) return null;
   const extra = buildClickExtra(data);
   if (!extra) return null;
   return { id, event: "click", extra };

package/dist/report/index.d.cts

@@ -1,4 +1,4 @@
-import { I as RuntimeEventName, G as DslInteractionEvent } from '../types-8FNxDXp0.cjs';
+import { J as RuntimeEventName, H as DslInteractionEvent } from '../types-BapBTTio.cjs';
 
 /**
  * 营销物料上报载荷类型（上报契约的唯一数据源）。
@@ -184,8 +184,10 @@ declare function buildCloseReport(id: string | undefined | null, options?: {
  * - `interaction` 且 `trigger='action'` → 一条 `click`，`extra` 见 {@link buildClickExtra}
  * - `interaction` 且 `trigger='show'` / `'close'` → `null`：曝光 / 关闭由宿主统一上报，
  *   运营配在这两个时机上的埋点名走 {@link buildExposureReport} / {@link buildCloseReport} 的 `extra`
- * - `interaction` 且 `trigger='action'` 但 `closes` 为真（手势里执行了关闭动作）→ `null`：
- *   点关闭按钮的本质是关闭，不再算一次点击
+ * - `interaction` 且 `trigger='action'`、`closes` 为真（手势里执行了关闭动作）但**没有** `navigate`
+ *   → `null`：纯关闭手势的本质是关闭，不再算一次点击
+ * - `interaction` 且 `trigger='action'`、`closes` 为真但同一次交互里**有** `navigate`
+ *   → 照常产出 `click`：跳走了就是一次转化行为，「顺手关掉弹窗」只是它的副作用
  * - 其余事件（`track` / `navigate` / `close` / `call` / `error` / `state-change` /
  *   `view-change` / `ready` / `open`）不产生上报 —— 它们是动作粒度的事件，按它们上报会重复计数
  *

package/dist/report/index.d.ts

@@ -1,4 +1,4 @@
-import { I as RuntimeEventName, G as DslInteractionEvent } from '../types-8FNxDXp0.js';
+import { J as RuntimeEventName, H as DslInteractionEvent } from '../types-BapBTTio.js';
 
 /**
  * 营销物料上报载荷类型（上报契约的唯一数据源）。
@@ -184,8 +184,10 @@ declare function buildCloseReport(id: string | undefined | null, options?: {
  * - `interaction` 且 `trigger='action'` → 一条 `click`，`extra` 见 {@link buildClickExtra}
  * - `interaction` 且 `trigger='show'` / `'close'` → `null`：曝光 / 关闭由宿主统一上报，
  *   运营配在这两个时机上的埋点名走 {@link buildExposureReport} / {@link buildCloseReport} 的 `extra`
- * - `interaction` 且 `trigger='action'` 但 `closes` 为真（手势里执行了关闭动作）→ `null`：
- *   点关闭按钮的本质是关闭，不再算一次点击
+ * - `interaction` 且 `trigger='action'`、`closes` 为真（手势里执行了关闭动作）但**没有** `navigate`
+ *   → `null`：纯关闭手势的本质是关闭，不再算一次点击
+ * - `interaction` 且 `trigger='action'`、`closes` 为真但同一次交互里**有** `navigate`
+ *   → 照常产出 `click`：跳走了就是一次转化行为，「顺手关掉弹窗」只是它的副作用
  * - 其余事件（`track` / `navigate` / `close` / `call` / `error` / `state-change` /
  *   `view-change` / `ready` / `open`）不产生上报 —— 它们是动作粒度的事件，按它们上报会重复计数
  *

package/dist/report/index.js

@@ -44,7 +44,7 @@ function mapRuntimeEventToReport(id, event, payload) {
   if (event !== "interaction") return null;
   const data = payload != null ? payload : {};
   if (data.trigger !== "action") return null;
-  if (data.closes) return null;
+  if (data.closes && !data.navigate) return null;
   const extra = buildClickExtra(data);
   if (!extra) return null;
   return { id, event: "click", extra };

package/dist/{types-8FNxDXp0.d.cts → types-BapBTTio.d.cts}

@@ -213,11 +213,25 @@ interface DslSourceRef {
     $source: string;
     params?: Record<string, unknown>;
 }
+/**
+ * 自动轮播配置，挂在 `derived.xxx.autoplay` 上。
+ *
+ * 配了就开启、始终循环：每隔 `interval` 毫秒把 `state[indexBy]` 往下推一格
+ * （到末尾回到 0）。走的是和用户点 tab 同一个 setState，效果与手动切换完全一致。
+ */
+interface DslAutoplay {
+    /** 切换间隔，毫秒，不小于 1000 */
+    interval: number;
+    /** 鼠标悬停在整个物料上时暂停，离开后重新计时。默认 false */
+    pauseOnHover?: boolean;
+}
 interface DslDerived {
     /** data 里的数组字段名 */
     list: string;
     /** state 里的下标字段名 */
     indexBy: string;
+    /** 自动轮播；不写就不轮播 */
+    autoplay?: DslAutoplay;
 }
 /** 一份完整配置。单视图直接写 type/stage/nodes，多视图写 views + entry */
 interface Dsl extends Partial<DslView> {
@@ -341,6 +355,15 @@ interface RenderTree {
      * 同一个页面上出现多份物料时，各自的 hover 规则不会串台。
      */
     rootClassName: string;
+    /**
+     * 鼠标进入根容器时调用。只有配置里存在 `pauseOnHover: true` 的自动轮播时才有值。
+     *
+     * 框架壳的义务：有值时在根容器上绑 `mouseenter` 调它，**不阻止冒泡、不加任何判断**；
+     * 没值时什么都不绑。暂停哪些轮播、何时恢复，全由 core 决定。
+     */
+    onRootEnter?: () => void;
+    /** 鼠标离开根容器时调用，与 `onRootEnter` 成对出现，壳绑 `mouseleave` */
+    onRootLeave?: () => void;
 }
 type DslSource = (params: Record<string, unknown>, user: Record<string, unknown>) => unknown | Promise<unknown>;
 type DslHandler = (params: Record<string, unknown>) => void;
@@ -383,9 +406,14 @@ interface DslInteractionEvent {
     /**
      * 这次交互里执行了关闭动作（`close` / `closeAll`）。
      *
-     * 用来把「点关闭按钮」和「点营销内容」区分开：前者的本质是关闭，不该再算一次点击。
-     * 运营常把埋点配进关闭按钮的 `sequence: [track, close]`，不标记的话这一下会同时
-     * 产出 close 和 click 两条，点击量照样虚增。埋点名不会丢 —— 宿主把它并进 close 上报。
+     * 用来把「点关闭按钮」和「点营销内容」区分开：**纯关闭手势**（有关闭动作、又没有
+     * `navigate`）的本质是关闭，不该再算一次点击。运营常把埋点配进关闭按钮的
+     * `sequence: [track, close]`，不标记的话这一下会同时产出 close 和 click 两条，
+     * 点击量虚增。埋点名不会丢 —— 宿主把它并进 close 上报。
+     *
+     * 例外：同一次交互里还有 `navigate` 时仍算一次 click。转化型主 CTA 常写成
+     * `sequence: [track, closeAll, navigate]`（跳走前顺手收掉弹窗），真跳转了就是转化行为，
+     * 关闭只是副作用。此时埋点名已进 click 的 `extra`，宿主不再把它并进 close。
      */
     closes?: boolean;
 }
@@ -456,4 +484,4 @@ interface RuntimeOptions {
     emit?: RuntimeEmit;
 }
 
-export type { RenderLayer as A, DslSource as B, CssStyle as C, Dsl as D, DslHandler as E, DslInteractionTrigger as F, DslInteractionEvent as G, RuntimeEvents as H, RuntimeEventName as I, RuntimeEmit as J, RuntimeOptions as R, RenderTree as a, DslView as b, DslStyle as c, DslViewType as d, DslNodeType as e, DslLength as f, DslRect as g, DslAnimate as h, DslKeyframe as i, DslActionBase as j, DslNavigateAction as k, DslCloseAction as l, DslCloseAllAction as m, DslOpenAction as n, DslSetStateAction as o, DslTrackAction as p, DslCallAction as q, DslSequenceAction as r, DslAction as s, DslNode as t, DslClosePosition as u, DslCloseButton as v, DslStage as w, DslSourceRef as x, DslDerived as y, RenderElement as z };
+export type { RenderElement as A, RenderLayer as B, CssStyle as C, Dsl as D, DslSource as E, DslHandler as F, DslInteractionTrigger as G, DslInteractionEvent as H, RuntimeEvents as I, RuntimeEventName as J, RuntimeEmit as K, RuntimeOptions as R, RenderTree as a, DslView as b, DslStyle as c, DslViewType as d, DslNodeType as e, DslLength as f, DslRect as g, DslAnimate as h, DslKeyframe as i, DslActionBase as j, DslNavigateAction as k, DslCloseAction as l, DslCloseAllAction as m, DslOpenAction as n, DslSetStateAction as o, DslTrackAction as p, DslCallAction as q, DslSequenceAction as r, DslAction as s, DslNode as t, DslClosePosition as u, DslCloseButton as v, DslStage as w, DslSourceRef as x, DslAutoplay as y, DslDerived as z };

package/dist/{types-8FNxDXp0.d.ts → types-BapBTTio.d.ts}

@@ -213,11 +213,25 @@ interface DslSourceRef {
     $source: string;
     params?: Record<string, unknown>;
 }
+/**
+ * 自动轮播配置，挂在 `derived.xxx.autoplay` 上。
+ *
+ * 配了就开启、始终循环：每隔 `interval` 毫秒把 `state[indexBy]` 往下推一格
+ * （到末尾回到 0）。走的是和用户点 tab 同一个 setState，效果与手动切换完全一致。
+ */
+interface DslAutoplay {
+    /** 切换间隔，毫秒，不小于 1000 */
+    interval: number;
+    /** 鼠标悬停在整个物料上时暂停，离开后重新计时。默认 false */
+    pauseOnHover?: boolean;
+}
 interface DslDerived {
     /** data 里的数组字段名 */
     list: string;
     /** state 里的下标字段名 */
     indexBy: string;
+    /** 自动轮播；不写就不轮播 */
+    autoplay?: DslAutoplay;
 }
 /** 一份完整配置。单视图直接写 type/stage/nodes，多视图写 views + entry */
 interface Dsl extends Partial<DslView> {
@@ -341,6 +355,15 @@ interface RenderTree {
      * 同一个页面上出现多份物料时，各自的 hover 规则不会串台。
      */
     rootClassName: string;
+    /**
+     * 鼠标进入根容器时调用。只有配置里存在 `pauseOnHover: true` 的自动轮播时才有值。
+     *
+     * 框架壳的义务：有值时在根容器上绑 `mouseenter` 调它，**不阻止冒泡、不加任何判断**；
+     * 没值时什么都不绑。暂停哪些轮播、何时恢复，全由 core 决定。
+     */
+    onRootEnter?: () => void;
+    /** 鼠标离开根容器时调用，与 `onRootEnter` 成对出现，壳绑 `mouseleave` */
+    onRootLeave?: () => void;
 }
 type DslSource = (params: Record<string, unknown>, user: Record<string, unknown>) => unknown | Promise<unknown>;
 type DslHandler = (params: Record<string, unknown>) => void;
@@ -383,9 +406,14 @@ interface DslInteractionEvent {
     /**
      * 这次交互里执行了关闭动作（`close` / `closeAll`）。
      *
-     * 用来把「点关闭按钮」和「点营销内容」区分开：前者的本质是关闭，不该再算一次点击。
-     * 运营常把埋点配进关闭按钮的 `sequence: [track, close]`，不标记的话这一下会同时
-     * 产出 close 和 click 两条，点击量照样虚增。埋点名不会丢 —— 宿主把它并进 close 上报。
+     * 用来把「点关闭按钮」和「点营销内容」区分开：**纯关闭手势**（有关闭动作、又没有
+     * `navigate`）的本质是关闭，不该再算一次点击。运营常把埋点配进关闭按钮的
+     * `sequence: [track, close]`，不标记的话这一下会同时产出 close 和 click 两条，
+     * 点击量虚增。埋点名不会丢 —— 宿主把它并进 close 上报。
+     *
+     * 例外：同一次交互里还有 `navigate` 时仍算一次 click。转化型主 CTA 常写成
+     * `sequence: [track, closeAll, navigate]`（跳走前顺手收掉弹窗），真跳转了就是转化行为，
+     * 关闭只是副作用。此时埋点名已进 click 的 `extra`，宿主不再把它并进 close。
      */
     closes?: boolean;
 }
@@ -456,4 +484,4 @@ interface RuntimeOptions {
     emit?: RuntimeEmit;
 }
 
-export type { RenderLayer as A, DslSource as B, CssStyle as C, Dsl as D, DslHandler as E, DslInteractionTrigger as F, DslInteractionEvent as G, RuntimeEvents as H, RuntimeEventName as I, RuntimeEmit as J, RuntimeOptions as R, RenderTree as a, DslView as b, DslStyle as c, DslViewType as d, DslNodeType as e, DslLength as f, DslRect as g, DslAnimate as h, DslKeyframe as i, DslActionBase as j, DslNavigateAction as k, DslCloseAction as l, DslCloseAllAction as m, DslOpenAction as n, DslSetStateAction as o, DslTrackAction as p, DslCallAction as q, DslSequenceAction as r, DslAction as s, DslNode as t, DslClosePosition as u, DslCloseButton as v, DslStage as w, DslSourceRef as x, DslDerived as y, RenderElement as z };
+export type { RenderElement as A, RenderLayer as B, CssStyle as C, Dsl as D, DslSource as E, DslHandler as F, DslInteractionTrigger as G, DslInteractionEvent as H, RuntimeEvents as I, RuntimeEventName as J, RuntimeEmit as K, RuntimeOptions as R, RenderTree as a, DslView as b, DslStyle as c, DslViewType as d, DslNodeType as e, DslLength as f, DslRect as g, DslAnimate as h, DslKeyframe as i, DslActionBase as j, DslNavigateAction as k, DslCloseAction as l, DslCloseAllAction as m, DslOpenAction as n, DslSetStateAction as o, DslTrackAction as p, DslCallAction as q, DslSequenceAction as r, DslAction as s, DslNode as t, DslClosePosition as u, DslCloseButton as v, DslStage as w, DslSourceRef as x, DslAutoplay as y, DslDerived as z };

package/package.json

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