@yaoxiu/marketing-dsl 2.2.1 → 2.3.0

package/dist/index.cjs

@@ -1882,12 +1882,31 @@ function formatIssues(issues) {
   return issues.map((item) => item.path ? `${item.path}: ${item.message}` : item.message).join("\n");
 }
 
+// src/host-capabilities.ts
+var HOST_SOURCE_NAMES = ["shopAchievements", "listRenewTiers"];
+var HOST_HANDLER_NAMES = [];
+var HOST_SOURCE_LABELS = {
+  shopAchievements: "\u5E97\u94FA\u6210\u679C\u7EDF\u8BA1\uFF08\u5DF2\u4E0A\u67B6/\u8FD0\u884C\u4E2D/\u767D\u5E95\u56FE\u7B49\u683C\u5B50\u6570\u7EC4\uFF09",
+  listRenewTiers: "\u7EED\u8D39\u4EF7\u683C\u6863\u4F4D\u5217\u8868\uFF08\u6708\u4ED8/\u5B63\u4ED8/\u534A\u5E74/\u5E74\u4ED8\uFF0C\u542B\u4E0B\u5355\u5730\u5740\uFF09"
+};
+var HOST_HANDLER_LABELS = {};
+function isRegisteredHostSource(name) {
+  return HOST_SOURCE_NAMES.indexOf(name) > -1;
+}
+function isRegisteredHostHandler(name) {
+  return HOST_HANDLER_NAMES.indexOf(name) > -1;
+}
+
 exports.ACTION_TYPES = ACTION_TYPES;
 exports.ALLOWED_STYLE_KEYS = ALLOWED_STYLE_KEYS;
 exports.BANNER_MIN_ASPECT_RATIO = BANNER_MIN_ASPECT_RATIO;
 exports.CLOSE_POSITIONS = CLOSE_POSITIONS;
 exports.DEFAULT_USER_FIELDS = DEFAULT_USER_FIELDS;
 exports.DSL_VERSION = DSL_VERSION;
+exports.HOST_HANDLER_LABELS = HOST_HANDLER_LABELS;
+exports.HOST_HANDLER_NAMES = HOST_HANDLER_NAMES;
+exports.HOST_SOURCE_LABELS = HOST_SOURCE_LABELS;
+exports.HOST_SOURCE_NAMES = HOST_SOURCE_NAMES;
 exports.NODE_TYPES = NODE_TYPES;
 exports.SINGLE_VIEW_NAME = SINGLE_VIEW_NAME;
 exports.TRACK_EVENT_PATTERN = TRACK_EVENT_PATTERN;
@@ -1901,6 +1920,8 @@ exports.formatParts = formatParts;
 exports.interpolate = interpolate;
 exports.interpolateDeep = interpolateDeep;
 exports.isLength = isLength;
+exports.isRegisteredHostHandler = isRegisteredHostHandler;
+exports.isRegisteredHostSource = isRegisteredHostSource;
 exports.isValidEndTime = isValidEndTime;
 exports.normalizeViews = normalizeViews;
 exports.parseEndTime = parseEndTime;

package/dist/index.d.cts

@@ -137,6 +137,70 @@ declare const USER_FIELD_LABELS: Record<string, string>;
  */
 declare function validateUserFields(dsl: unknown, allowed: string[]): FieldIssue[];
 
+/**
+ * 宿主已注册的能力清单（数据源 `$source` / 宿主方法 `call`）。
+ *
+ * 【这份清单是什么】
+ * 它是「**前台宿主实际注册了什么**」的事实记录，**不是** core 的能力声明。
+ * core 本身对数据源名一无所知：运行时只认宿主创建 runtime 时传进来的 `sources` /
+ * `handlers` 对象，查不到名字就抛 `unknown-source`、整份物料静默白屏
+ * （不报错、什么都不画，投到线上才发现）。
+ *
+ * 【为什么放在 core 里】
+ * 因为前台（move-front，注册表在 `components-business/marketing/sources.ts`）与
+ * 后台投放编辑器（moveback-front，保存前要检出「DSL 用到、但前台没注册」的能力并告警）
+ * 必须共用同一份名单，而这两个仓库唯一的共同依赖就是本包。
+ * 与 `DEFAULT_USER_FIELDS`（「宿主提供哪些 user 字段」的白名单）的处境一模一样，
+ * 组织方式也照它办：名单 + 中文含义同文件，从主入口导出。
+ *
+ * 【维护约定，两条都是硬性的】
+ *   1. **只增不改**：名字一旦进清单就是对运营的契约，DSL 里写死的就是这个名字。
+ *      改名 = 线上已投放的物料静默白屏。实现随便换，名字不许动。
+ *   2. **前台增减数据源 / 宿主方法时，必须同步改本文件并发版**（minor），
+ *      否则后台的告警会误报（前台已注册却报「未注册」）或漏报（前台没注册却不告警）。
+ *      前台注册表的返回类型由本文件的名单推导，漏注册编译期就会失败；
+ *      「清单删了名字但注册表还留着」由前台的运行时单测兜住。
+ */
+/**
+ * 前台已注册的**数据源名**（DSL 里 `data: { x: { $source: 'name' } }` 的 `name`）。
+ *
+ * 用 `as const` 是为了推导出 {@link HostSourceName} 联合类型，供前台约束注册表。
+ */
+declare const HOST_SOURCE_NAMES: readonly ["shopAchievements", "listRenewTiers"];
+/** 数据源名的联合类型，前台注册表以它为键，漏注册一个就编译不过 */
+type HostSourceName = (typeof HOST_SOURCE_NAMES)[number];
+/**
+ * 前台已注册的**宿主方法名**（DSL 里 `{ type: 'call', name: 'xxx' }` 的 `name`）。
+ *
+ * 当前**确实一个都没注册**，空名单是真实状态、不是占位：
+ * 运营在 DSL 里写任何 `call` 都会白屏，后台据此照常告警。
+ */
+declare const HOST_HANDLER_NAMES: readonly string[];
+/** 宿主方法名的联合类型（当前名单为空，故为 `never`） */
+type HostHandlerName = (typeof HOST_HANDLER_NAMES)[number];
+/**
+ * 数据源的中文含义。后台告警文案、运营看的能力清单共用一份，避免说明各写各的。
+ *
+ * 键必须覆盖 {@link HOST_SOURCE_NAMES} 的全部名字（有单测钉死）。
+ */
+declare const HOST_SOURCE_LABELS: Record<HostSourceName, string>;
+/** 宿主方法的中文含义，键覆盖 {@link HOST_HANDLER_NAMES}（当前为空对象） */
+declare const HOST_HANDLER_LABELS: Record<string, string>;
+/**
+ * 判断一个数据源名是否已被前台注册。
+ *
+ * @param name 待判断的名字，通常来自 DSL 里的 `$source`
+ * @returns 已注册返回 true；未注册意味着渲染时会白屏，调用方应告警
+ */
+declare function isRegisteredHostSource(name: string): boolean;
+/**
+ * 判断一个宿主方法名是否已被前台注册。
+ *
+ * @param name 待判断的名字，通常来自 DSL 里 `call` 动作的 `name`
+ * @returns 已注册返回 true；当前名单为空，所以恒为 false
+ */
+declare function isRegisteredHostHandler(name: string): boolean;
+
 /**
  * 视图归一化。
  *
@@ -248,4 +312,4 @@ 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, BANNER_MIN_ASPECT_RATIO, CLOSE_POSITIONS, type CountdownParts, type CountdownPrecision, CssStyle, DEFAULT_USER_FIELDS, DSL_VERSION, Dsl, type DslRuntime, DslStyle, DslView, type Issue, NODE_TYPES, type NormalizedViews, RenderTree, RuntimeOptions, SINGLE_VIEW_NAME, TRACK_EVENT_PATTERN, USER_FIELD_LABELS, type ValidateOptions, type ValidateResult, check, computeParts, createRuntime, evaluate, formatIssues, formatParts, interpolate, interpolateDeep, isLength, isValidEndTime, normalizeViews, parseEndTime, safeImageUrl, safeUrl, toCssStyle, toLength, validate, validateUserFields };
+export { ACTION_TYPES, ALLOWED_STYLE_KEYS, BANNER_MIN_ASPECT_RATIO, CLOSE_POSITIONS, type CountdownParts, type CountdownPrecision, CssStyle, DEFAULT_USER_FIELDS, DSL_VERSION, Dsl, type DslRuntime, DslStyle, DslView, HOST_HANDLER_LABELS, HOST_HANDLER_NAMES, HOST_SOURCE_LABELS, HOST_SOURCE_NAMES, type HostHandlerName, type HostSourceName, type Issue, NODE_TYPES, type NormalizedViews, RenderTree, RuntimeOptions, SINGLE_VIEW_NAME, TRACK_EVENT_PATTERN, USER_FIELD_LABELS, type ValidateOptions, type ValidateResult, check, computeParts, createRuntime, evaluate, formatIssues, formatParts, interpolate, interpolateDeep, isLength, isRegisteredHostHandler, isRegisteredHostSource, isValidEndTime, normalizeViews, parseEndTime, safeImageUrl, safeUrl, toCssStyle, toLength, validate, validateUserFields };

package/dist/index.d.ts

@@ -137,6 +137,70 @@ declare const USER_FIELD_LABELS: Record<string, string>;
  */
 declare function validateUserFields(dsl: unknown, allowed: string[]): FieldIssue[];
 
+/**
+ * 宿主已注册的能力清单（数据源 `$source` / 宿主方法 `call`）。
+ *
+ * 【这份清单是什么】
+ * 它是「**前台宿主实际注册了什么**」的事实记录，**不是** core 的能力声明。
+ * core 本身对数据源名一无所知：运行时只认宿主创建 runtime 时传进来的 `sources` /
+ * `handlers` 对象，查不到名字就抛 `unknown-source`、整份物料静默白屏
+ * （不报错、什么都不画，投到线上才发现）。
+ *
+ * 【为什么放在 core 里】
+ * 因为前台（move-front，注册表在 `components-business/marketing/sources.ts`）与
+ * 后台投放编辑器（moveback-front，保存前要检出「DSL 用到、但前台没注册」的能力并告警）
+ * 必须共用同一份名单，而这两个仓库唯一的共同依赖就是本包。
+ * 与 `DEFAULT_USER_FIELDS`（「宿主提供哪些 user 字段」的白名单）的处境一模一样，
+ * 组织方式也照它办：名单 + 中文含义同文件，从主入口导出。
+ *
+ * 【维护约定，两条都是硬性的】
+ *   1. **只增不改**：名字一旦进清单就是对运营的契约，DSL 里写死的就是这个名字。
+ *      改名 = 线上已投放的物料静默白屏。实现随便换，名字不许动。
+ *   2. **前台增减数据源 / 宿主方法时，必须同步改本文件并发版**（minor），
+ *      否则后台的告警会误报（前台已注册却报「未注册」）或漏报（前台没注册却不告警）。
+ *      前台注册表的返回类型由本文件的名单推导，漏注册编译期就会失败；
+ *      「清单删了名字但注册表还留着」由前台的运行时单测兜住。
+ */
+/**
+ * 前台已注册的**数据源名**（DSL 里 `data: { x: { $source: 'name' } }` 的 `name`）。
+ *
+ * 用 `as const` 是为了推导出 {@link HostSourceName} 联合类型，供前台约束注册表。
+ */
+declare const HOST_SOURCE_NAMES: readonly ["shopAchievements", "listRenewTiers"];
+/** 数据源名的联合类型，前台注册表以它为键，漏注册一个就编译不过 */
+type HostSourceName = (typeof HOST_SOURCE_NAMES)[number];
+/**
+ * 前台已注册的**宿主方法名**（DSL 里 `{ type: 'call', name: 'xxx' }` 的 `name`）。
+ *
+ * 当前**确实一个都没注册**，空名单是真实状态、不是占位：
+ * 运营在 DSL 里写任何 `call` 都会白屏，后台据此照常告警。
+ */
+declare const HOST_HANDLER_NAMES: readonly string[];
+/** 宿主方法名的联合类型（当前名单为空，故为 `never`） */
+type HostHandlerName = (typeof HOST_HANDLER_NAMES)[number];
+/**
+ * 数据源的中文含义。后台告警文案、运营看的能力清单共用一份，避免说明各写各的。
+ *
+ * 键必须覆盖 {@link HOST_SOURCE_NAMES} 的全部名字（有单测钉死）。
+ */
+declare const HOST_SOURCE_LABELS: Record<HostSourceName, string>;
+/** 宿主方法的中文含义，键覆盖 {@link HOST_HANDLER_NAMES}（当前为空对象） */
+declare const HOST_HANDLER_LABELS: Record<string, string>;
+/**
+ * 判断一个数据源名是否已被前台注册。
+ *
+ * @param name 待判断的名字，通常来自 DSL 里的 `$source`
+ * @returns 已注册返回 true；未注册意味着渲染时会白屏，调用方应告警
+ */
+declare function isRegisteredHostSource(name: string): boolean;
+/**
+ * 判断一个宿主方法名是否已被前台注册。
+ *
+ * @param name 待判断的名字，通常来自 DSL 里 `call` 动作的 `name`
+ * @returns 已注册返回 true；当前名单为空，所以恒为 false
+ */
+declare function isRegisteredHostHandler(name: string): boolean;
+
 /**
  * 视图归一化。
  *
@@ -248,4 +312,4 @@ 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, BANNER_MIN_ASPECT_RATIO, CLOSE_POSITIONS, type CountdownParts, type CountdownPrecision, CssStyle, DEFAULT_USER_FIELDS, DSL_VERSION, Dsl, type DslRuntime, DslStyle, DslView, type Issue, NODE_TYPES, type NormalizedViews, RenderTree, RuntimeOptions, SINGLE_VIEW_NAME, TRACK_EVENT_PATTERN, USER_FIELD_LABELS, type ValidateOptions, type ValidateResult, check, computeParts, createRuntime, evaluate, formatIssues, formatParts, interpolate, interpolateDeep, isLength, isValidEndTime, normalizeViews, parseEndTime, safeImageUrl, safeUrl, toCssStyle, toLength, validate, validateUserFields };
+export { ACTION_TYPES, ALLOWED_STYLE_KEYS, BANNER_MIN_ASPECT_RATIO, CLOSE_POSITIONS, type CountdownParts, type CountdownPrecision, CssStyle, DEFAULT_USER_FIELDS, DSL_VERSION, Dsl, type DslRuntime, DslStyle, DslView, HOST_HANDLER_LABELS, HOST_HANDLER_NAMES, HOST_SOURCE_LABELS, HOST_SOURCE_NAMES, type HostHandlerName, type HostSourceName, type Issue, NODE_TYPES, type NormalizedViews, RenderTree, RuntimeOptions, SINGLE_VIEW_NAME, TRACK_EVENT_PATTERN, USER_FIELD_LABELS, type ValidateOptions, type ValidateResult, check, computeParts, createRuntime, evaluate, formatIssues, formatParts, interpolate, interpolateDeep, isLength, isRegisteredHostHandler, isRegisteredHostSource, isValidEndTime, normalizeViews, parseEndTime, safeImageUrl, safeUrl, toCssStyle, toLength, validate, validateUserFields };

package/dist/index.js

@@ -774,4 +774,19 @@ function createRuntime(dsl, options = {}) {
   };
 }
 
-export { createRuntime, safeImageUrl, safeUrl };
+// src/host-capabilities.ts
+var HOST_SOURCE_NAMES = ["shopAchievements", "listRenewTiers"];
+var HOST_HANDLER_NAMES = [];
+var HOST_SOURCE_LABELS = {
+  shopAchievements: "\u5E97\u94FA\u6210\u679C\u7EDF\u8BA1\uFF08\u5DF2\u4E0A\u67B6/\u8FD0\u884C\u4E2D/\u767D\u5E95\u56FE\u7B49\u683C\u5B50\u6570\u7EC4\uFF09",
+  listRenewTiers: "\u7EED\u8D39\u4EF7\u683C\u6863\u4F4D\u5217\u8868\uFF08\u6708\u4ED8/\u5B63\u4ED8/\u534A\u5E74/\u5E74\u4ED8\uFF0C\u542B\u4E0B\u5355\u5730\u5740\uFF09"
+};
+var HOST_HANDLER_LABELS = {};
+function isRegisteredHostSource(name) {
+  return HOST_SOURCE_NAMES.indexOf(name) > -1;
+}
+function isRegisteredHostHandler(name) {
+  return HOST_HANDLER_NAMES.indexOf(name) > -1;
+}
+
+export { HOST_HANDLER_LABELS, HOST_HANDLER_NAMES, HOST_SOURCE_LABELS, HOST_SOURCE_NAMES, createRuntime, isRegisteredHostHandler, isRegisteredHostSource, safeImageUrl, safeUrl };

package/package.json

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