@yaoxiu/marketing-dsl 1.2.0 → 1.4.0

package/dist/index.d.ts

@@ -1,285 +1,5 @@
-/**
- * DSL 的类型定义。
- *
- * 分两组：
- *   - Dsl* 是运营写的配置，也就是存进数据库的那份 JSON
- *   - Render* 是 core 算完之后交给框架层的渲染树，纯数据，跟框架无关
- *
- * 框架层只认 Render*，永远不该去读 Dsl*——一旦读了，解析逻辑就又漏回渲染层了。
- */
-type DslViewType = 'popup' | 'banner' | 'notice';
-type DslNodeType = 'box' | 'flex' | 'repeat' | 'image' | 'text' | 'button' | 'tabs' | 'countdown';
-/** 长度：数字按 px，字符串原样交给 CSS，可以带 {{ }} */
-type DslLength = number | string;
-/** rect: [x, y, width, height]，绝对定位容器里用 */
-type DslRect = [DslLength, DslLength, DslLength, DslLength];
-/** 样式对象，键必须在白名单内，值可以带 {{ }} */
-type DslStyle = Record<string, unknown>;
-interface DslActionBase {
-    type: string;
-}
-interface DslNavigateAction extends DslActionBase {
-    type: 'navigate';
-    url: string;
-    target?: '_self' | '_blank';
-}
-interface DslCloseAction extends DslActionBase {
-    type: 'close';
-    reason?: string;
-}
-interface DslCloseAllAction extends DslActionBase {
-    type: 'closeAll';
-    reason?: string;
-}
-interface DslOpenAction extends DslActionBase {
-    type: 'open';
-    view: string;
-    mode?: 'stack' | 'replace';
-}
-interface DslSetStateAction extends DslActionBase {
-    type: 'setState';
-    key: string;
-    value: unknown;
-}
-interface DslTrackAction extends DslActionBase {
-    type: 'track';
-    event: string;
-    params?: Record<string, unknown>;
-}
-/** 调用宿主注册的方法，名字必须在 handlers 白名单内 */
-interface DslCallAction extends DslActionBase {
-    type: 'call';
-    name: string;
-    params?: Record<string, unknown>;
-}
-interface DslSequenceAction extends DslActionBase {
-    type: 'sequence';
-    actions: DslAction[];
-}
-type DslAction = DslNavigateAction | DslCloseAction | DslCloseAllAction | DslOpenAction | DslSetStateAction | DslTrackAction | DslCallAction | DslSequenceAction;
-interface DslNode {
-    id?: string;
-    type: DslNodeType;
-    rect?: DslRect;
-    style?: DslStyle;
-    /** 表达式，为假时整个节点不渲染 */
-    visibleWhen?: string;
-    action?: DslAction;
-    /** box / flex / countdown */
-    children?: DslNode[];
-    /** repeat / tabs：数组来源表达式 */
-    bind?: string;
-    /** repeat */
-    template?: DslNode;
-    itemName?: string;
-    indexName?: string;
-    /** tabs */
-    stateKey?: string;
-    labelField?: string;
-    itemStyle?: DslStyle;
-    activeItemStyle?: DslStyle;
-    /** image */
-    src?: string;
-    /** text */
-    content?: string;
-    /** button */
-    text?: string;
-    /** countdown */
-    to?: string;
-    precision?: 's' | 'cs';
-    as?: string;
-    format?: string;
-    endText?: string;
-    onEnd?: DslAction;
-}
-type DslClosePosition = 'top-right' | 'top-left' | 'top-center' | 'bottom-right' | 'bottom-left' | 'bottom-center';
-interface DslCloseButton {
-    show?: boolean;
-    position?: DslClosePosition;
-    /** [x, y]，负值把按钮移到弹窗外面 */
-    offset?: [DslLength, DslLength];
-    size?: DslLength;
-    icon?: string;
-    image?: string;
-    style?: DslStyle;
-}
-interface DslStage {
-    width?: DslLength;
-    height?: DslLength;
-    /** absolute（默认）子节点用 rect 定位；flow 子节点按 flex 排 */
-    layout?: 'absolute' | 'flow';
-    mask?: boolean;
-    maskClosable?: boolean;
-    closeButton?: DslCloseButton;
-    style?: DslStyle;
-    /** 曝光埋点：数据就绪、视图真正展示时触发一次 */
-    onShow?: DslAction;
-    /** 关闭埋点：点 X、点遮罩、close 动作、被 replace 顶掉都会触发 */
-    onClose?: DslAction;
-}
-interface DslView {
-    type: DslViewType;
-    stage: DslStage;
-    nodes: DslNode[];
-}
-/** 后端数据源引用，名字必须在 sources 白名单内 */
-interface DslSourceRef {
-    $source: string;
-    params?: Record<string, unknown>;
-}
-interface DslDerived {
-    /** data 里的数组字段名 */
-    list: string;
-    /** state 里的下标字段名 */
-    indexBy: string;
-}
-/** 一份完整配置。单视图直接写 type/stage/nodes，多视图写 views + entry */
-interface Dsl extends Partial<DslView> {
-    version: number;
-    meta?: {
-        name?: string;
-        [key: string]: unknown;
-    };
-    data?: Record<string, unknown | DslSourceRef>;
-    state?: Record<string, unknown>;
-    derived?: Record<string, DslDerived>;
-    views?: Record<string, DslView>;
-    entry?: string;
-}
-/** 已经算好的行内样式，键是 CSS 属性名（驼峰），值是最终字符串 */
-type CssStyle = Record<string, string>;
-interface RenderElement {
-    /** 稳定 key，框架层做列表 diff 用 */
-    key: string;
-    /** 画成什么。div 带 text 就是文本节点，带 children 就是容器 */
-    tag: 'div' | 'img';
-    /**
-     * 类名，如 "dsl-node dsl-text is-clickable"。
-     * 不参与样式（样式全在 style 里），纯粹是留给调试和宿主微调的钩子。
-     * 由 core 统一生成，不让各框架壳各拼一套，否则 DOM 结构会慢慢跑偏。
-     */
-    className: string;
-    style: CssStyle;
-    text?: string;
-    src?: string;
-    /**
-     * 有值才是可点的，动作和上下文都已经绑好，框架层直接挂上去即可。
-     *
-     * 【框架层必须遵守】挂上去时要阻止冒泡。
-     * 父子都可点是常见排版——公告条整条点开弹窗、行末 × 关闭公告条——
-     * 不阻止的话点 × 会连带触发外层，关掉的瞬间又弹出来。
-     * 没有 onClick 的节点不要绑任何事件，让它正常冒泡到有 onClick 的祖先。
-     */
-    onClick?: () => void;
-    children?: RenderElement[];
-}
-/**
- * 一个视图层。框架层照着这个结构套四层 div 就行，不需要自带任何 CSS：
- *
- *   div(layerStyle)
- *     div(maskStyle)          ← mask 为 true 时才画
- *     div(scrollStyle)
- *       div(stageStyle)
- *         div(clipStyle)      ← 圆角裁切，关闭按钮留在外面才能溢出
- *           ...nodes
- *         closeButton         ← 有配才有
- */
-interface RenderLayer {
-    /** 视图名，同时用作 key */
-    name: string;
-    type: DslViewType;
-    isTop: boolean;
-    /** 画不画遮罩。只有栈顶的弹窗层才为 true */
-    mask: boolean;
-    onMaskClick?: () => void;
-    layerStyle: CssStyle;
-    maskStyle: CssStyle;
-    scrollStyle: CssStyle;
-    stageStyle: CssStyle;
-    clipStyle: CssStyle;
-    /** 关闭按钮，没配就是 undefined */
-    closeButton?: RenderElement;
-    nodes: RenderElement[];
-}
-interface RenderTree {
-    /** 数据没回来或加载失败时为 false，框架层什么都不画 */
-    ready: boolean;
-    /** 有弹窗层时框架层需要撑满宿主容器 */
-    hasPopup: boolean;
-    /** 根容器样式，已按 hasPopup 算好 */
-    rootStyle: CssStyle;
-    layers: RenderLayer[];
-    /** 这一轮里所有倒计时的结束时间戳，运行时据此决定要不要起定时器 */
-    countdownEndTimes: number[];
-    /** 只要有一个倒计时要厘秒，整体就按厘秒刷 */
-    countdownPrecision: 's' | 'cs';
-}
-type DslSource = (params: Record<string, unknown>, user: Record<string, unknown>) => unknown | Promise<unknown>;
-type DslHandler = (params: Record<string, unknown>) => void;
-interface RuntimeEvents {
-    ready: {
-        keys: string[];
-    };
-    close: {
-        reason: string;
-    };
-    track: {
-        event: string;
-        params: Record<string, unknown>;
-    };
-    navigate: {
-        url: string;
-        target: string;
-    };
-    call: {
-        name: string;
-        params: Record<string, unknown>;
-    };
-    'state-change': Record<string, unknown>;
-    'view-change': {
-        view: string;
-        mode: string;
-        stack: string[];
-        closed?: string;
-    };
-    open: {
-        view: string;
-        mode: string;
-    };
-    error: {
-        type: 'unknown-source';
-        name: string;
-    } | {
-        type: 'unknown-view';
-        name: string;
-    } | {
-        type: 'unknown-handler';
-        name: string;
-    } | {
-        type: 'unknown-action';
-        action: string;
-    } | {
-        type: 'unsafe-url';
-        raw: string;
-    } | {
-        type: 'data-source-failed';
-        message: string;
-    };
-}
-type RuntimeEventName = keyof RuntimeEvents;
-type RuntimeEmit = <K extends RuntimeEventName>(event: K, payload: RuntimeEvents[K]) => void;
-interface RuntimeOptions {
-    /** 宿主注入的用户上下文，配置里用 {{ user.xxx }} 读 */
-    user?: Record<string, unknown>;
-    /** 数据源白名单 */
-    sources?: Record<string, DslSource>;
-    /** call 动作的方法白名单 */
-    handlers?: Record<string, DslHandler>;
-    /** 编辑态：动作只上报不真正执行 */
-    editMode?: boolean;
-    /** 所有事件都从这里出去，宿主自己决定怎么处理 */
-    emit?: RuntimeEmit;
-}
+import { D as Dsl, R as RuntimeOptions, a as RenderTree, b as DslView, c as DslStyle, C as CssStyle } from './types-BgUaJUAu.js';
+export { q as DslAction, h as DslActionBase, o as DslCallAction, j as DslCloseAction, k as DslCloseAllAction, t as DslCloseButton, s as DslClosePosition, w as DslDerived, A as DslHandler, f as DslLength, i as DslNavigateAction, r as DslNode, e as DslNodeType, l as DslOpenAction, g as DslRect, p as DslSequenceAction, m as DslSetStateAction, z as DslSource, v as DslSourceRef, u as DslStage, n as DslTrackAction, d as DslViewType, x as RenderElement, y as RenderLayer, F as RuntimeEmit, E as RuntimeEventName, B as RuntimeEvents } from './types-BgUaJUAu.js';
 
 /**
  * 运行时。
@@ -334,6 +54,13 @@ interface ValidateResult {
 declare const DSL_VERSION = 1;
 declare const NODE_TYPES: string[];
 declare const ACTION_TYPES: string[];
+/**
+ * 埋点事件名格式：小写字母开头，后接小写字母 / 数字 / 下划线，总长 3~64。
+ *
+ * 只校验格式、不做白名单——事件名由运营自由定义，后端按前缀聚合，
+ * 格式统一才能聚合得干净（中文、驼峰、中划线混着来就没法分组）。
+ */
+declare const TRACK_EVENT_PATTERN: RegExp;
 declare const CLOSE_POSITIONS: string[];
 declare function validate(dsl: Dsl | unknown): ValidateResult;
 /** 把校验结果拼成可以直接展示的文本 */
@@ -438,9 +165,16 @@ interface CountdownParts {
 type CountdownPrecision = 's' | 'cs';
 /** 把 to 解析成时间戳。兼容 '2026-09-01 00:00:00' 这种 Safari 不认的格式 */
 declare function parseEndTime(to: unknown): number;
+/**
+ * 判断一个 to 能不能解析。给校验用。
+ *
+ * 解析失败会当成「已结束」，页面上只会看到一行「已结束」，
+ * 运营根本意识不到是自己时间写错了——所以必须在保存前就拦下来。
+ */
+declare function isValidEndTime(to: unknown): boolean;
 /** 算出某个时刻的时间片段 */
 declare function computeParts(endTime: number, now?: number): CountdownParts;
 /** 不给 children 时退化成一行文本，占位符 {d} {h} {hAll} {m} {s} {cs} */
 declare function formatParts(parts: CountdownParts, format?: string): string;
 
-export { ACTION_TYPES, ALLOWED_STYLE_KEYS, CLOSE_POSITIONS, type CountdownParts, type CountdownPrecision, type CssStyle, DSL_VERSION, type Dsl, type DslAction, type DslActionBase, type DslCallAction, type DslCloseAction, type DslCloseAllAction, type DslCloseButton, type DslClosePosition, type DslDerived, type DslHandler, type DslLength, type DslNavigateAction, type DslNode, type DslNodeType, type DslOpenAction, type DslRect, type DslRuntime, type DslSequenceAction, type DslSetStateAction, type DslSource, type DslSourceRef, type DslStage, type DslStyle, type DslTrackAction, type DslView, type DslViewType, type Issue, NODE_TYPES, type NormalizedViews, type RenderElement, type RenderLayer, type RenderTree, type RuntimeEmit, type RuntimeEventName, type RuntimeEvents, type RuntimeOptions, SINGLE_VIEW_NAME, type ValidateResult, check, computeParts, createRuntime, evaluate, formatIssues, formatParts, interpolate, interpolateDeep, isLength, normalizeViews, parseEndTime, safeImageUrl, safeUrl, toCssStyle, toLength, validate };
+export { ACTION_TYPES, ALLOWED_STYLE_KEYS, CLOSE_POSITIONS, type CountdownParts, type CountdownPrecision, CssStyle, DSL_VERSION, Dsl, type DslRuntime, DslStyle, DslView, type Issue, NODE_TYPES, type NormalizedViews, RenderTree, RuntimeOptions, SINGLE_VIEW_NAME, TRACK_EVENT_PATTERN, type ValidateResult, check, computeParts, createRuntime, evaluate, formatIssues, formatParts, interpolate, interpolateDeep, isLength, isValidEndTime, normalizeViews, parseEndTime, safeImageUrl, safeUrl, toCssStyle, toLength, validate };