@ray-js/ipc-player-integration 0.0.49 → 0.0.50-beta.1

package/lib/widgets/zoomTurntable/constants.d.ts

@@ -0,0 +1,92 @@
+import type { ZoomTurntableStyleOptions } from './turntable/type';
+/** absolute 槽位 id：转盘浮层 */
+export declare const zoomTurntableDockId = "zoomTurntableDockId";
+/** absolute 槽位 id：圈选引导 */
+export declare const zoomTurntableTipId = "zoomTurntableTipId";
+/** 入口 widget id（bottomLeft 槽位） */
+export declare const zoomTurntableEntryId = "ZoomTurntableEntry";
+/** 事件：请求收起转盘 */
+export declare const zoomTurntableClose = "zoomTurntableClose";
+/** 事件：转盘已展开 */
+export declare const zoomTurntableOpen = "zoomTurntableOpen";
+/** 事件：物理镜头切换成功，载荷 { lensId, lensIndex, value } */
+export declare const zoomTurntableLensChange = "zoomTurntableLensChange";
+/** 事件：画面绝对倍率变化，载荷 { curM, d, lensIndex } */
+export declare const zoomTurntableZoomChange = "zoomTurntableZoomChange";
+/** 长按判定时长（ms） */
+export declare const LONG_PRESS_MS = 500;
+/** 长按期间允许的位移容差（px），超出视为横滑并取消长按 */
+export declare const MOVE_TOLERANCE = 10;
+/** switchChannel 下发超时（ms）：回调始终不来时不知道切没切成，超时回滚读数 */
+export declare const SWITCH_LENS_TIMEOUT = 3000;
+/**
+ * switchChannel 已 success 后，等 channelChange 报「切到位」的时长（ms）。
+ * 超时按下发结果自己收尾，**不回滚** —— 指令已被受理，物理镜头其实已经切了，
+ * 回滚读数只会让读数和画面对不上。
+ *
+ * 与 SWITCH_LENS_TIMEOUT 取同一档（3s）：设备真正切完镜头本身要一会儿，
+ * 给短了会在事件晚到时提前自己收尾，等于白订阅。
+ * 真机现状：设备侧暂未推 channelChange，切镜头基本都靠这条超时收尾。
+ */
+export declare const CHANNEL_SETTLE_TIMEOUT = 3000;
+/**
+ * 判定「画面是否正好停在镜头光学正倍数」的容差。
+ * 回读的 d 是浮点，1.0 附近会有 1.0000001 这种抖动，严格相等判不出来。
+ */
+export declare const D_MATCH_EPS = 0.01;
+/** 查询当前镜头超时（ms）：宿主不回调时不能把同步流程一直挂着 */
+export declare const QUERY_LENS_TIMEOUT = 3000;
+/**
+ * 手势缩放跨临界点判定的 trailing 防抖（ms）。
+ * zoomLevelChange 高频上报，等手势停下来再判定是否切镜头（协议 §4.4）。
+ * 待 APP 提供 zoomFree 的「手势是否结束」参数后可改为由该参数触发。
+ */
+export declare const GESTURE_SWITCH_DEBOUNCE = 500;
+/** 横屏 dock 距播放器右边的距离，负值时向右探出 */
+export declare const ZOOM_DOCK_RIGHT = -10;
+/** dock 层级，需高于四角容器的 z-index: 100 */
+export declare const ZOOM_DOCK_Z_INDEX = 120;
+/**
+ * 竖屏截取比例：从椭圆上弧顶往下截取多少。
+ * 0.5 = 完整上半椭圆（截面底边落在最宽处）；> 0.5 会带出两侧下弯段。
+ * 取 0.5 让背景一路铺到播放器底边、不留空隙，多出来的部分靠 ZOOM_DOCK_BOTTOM 探出被裁掉。
+ */
+export declare const CROP_RATIO_BOTTOM = 0.5;
+/**
+ * 触摸响应余量：把 canvas 向外扩一圈，让整个转盘区域（含椭圆上方空白）都能拖动，
+ * 而不是只有椭圆截面那一条带。绘制位置由 renderer 补偿，视觉不变。
+ */
+export declare const HIT_PADDING_X = 16;
+export declare const HIT_PADDING_Y = 24;
+/**
+ * 竖屏 dock 高度：必须 >= canvas 实际高度（椭圆截面 + 上下触摸余量），
+ * 否则承载它的 CoverView 会把转盘裁掉一截。随 CROP_RATIO_BOTTOM / HIT_PADDING_Y 自动跟随，留 8px 余量。
+ */
+export declare const ZOOM_DOCK_HEIGHT: number;
+/**
+ * 竖屏 dock 距播放器底边的距离。
+ * 负值 = 椭圆下半探出播放器底边，由 .ipc-player-content 的 overflow: hidden 裁掉，
+ * 保证背景铺满到底边、下方不留空隙。
+ */
+export declare const ZOOM_DOCK_BOTTOM: number;
+/** 横屏截取比例（右侧展示空间较窄，截得更深） */
+export declare const CROP_RATIO_RIGHT = 0.45;
+/** 布局沉降兜底：onShow / onResize 后的重挂载延时 */
+export declare const RELAYOUT_DELAYS: number[];
+/** 刻度与文案整体下移量（角度不变，仅平移绘制坐标系） */
+export declare const CONTENT_OFFSET_Y = 10;
+/** 刻度与标记值向椭圆内侧收的距离，加大与遮罩边缘的间距 */
+export declare const TRACK_EDGE_INSET = 10;
+/** 竖屏样式微调 */
+export declare const STYLE_OPTIONS_BOTTOM: ZoomTurntableStyleOptions;
+/** 横屏样式微调：压小刻度、文字与指针，避免与右侧控件重叠 */
+export declare const STYLE_OPTIONS_RIGHT: ZoomTurntableStyleOptions;
+/**
+ * 普通刻度震动节流（ms）。step=0.1 时整个区间有几十级，
+ * 不节流会震得过密，反而糊成一片没有颗粒感。
+ */
+export declare const VIBRATE_THROTTLE = 60;
+/** 圈选提示：圆环尺寸 */
+export declare const TIP_RING_SIZE = 44;
+/** 可视区判定：避开左下角滚动容器右侧淡出带的安全距离 */
+export declare const FADE_SAFE_PADDING = 24;

package/lib/widgets/zoomTurntable/constants.js

@@ -0,0 +1,148 @@
+/** absolute 槽位 id：转盘浮层 */
+export const zoomTurntableDockId = 'zoomTurntableDockId';
+
+/** absolute 槽位 id：圈选引导 */
+export const zoomTurntableTipId = 'zoomTurntableTipId';
+
+/** 入口 widget id（bottomLeft 槽位） */
+export const zoomTurntableEntryId = 'ZoomTurntableEntry';
+
+/** 事件：请求收起转盘 */
+export const zoomTurntableClose = 'zoomTurntableClose';
+
+/** 事件：转盘已展开 */
+export const zoomTurntableOpen = 'zoomTurntableOpen';
+
+/** 事件：物理镜头切换成功，载荷 { lensId, lensIndex, value } */
+export const zoomTurntableLensChange = 'zoomTurntableLensChange';
+
+/** 事件：画面绝对倍率变化，载荷 { curM, d, lensIndex } */
+export const zoomTurntableZoomChange = 'zoomTurntableZoomChange';
+
+/** 长按判定时长（ms） */
+export const LONG_PRESS_MS = 500;
+
+/** 长按期间允许的位移容差（px），超出视为横滑并取消长按 */
+export const MOVE_TOLERANCE = 10;
+
+/** switchChannel 下发超时（ms）：回调始终不来时不知道切没切成，超时回滚读数 */
+export const SWITCH_LENS_TIMEOUT = 3000;
+
+/**
+ * switchChannel 已 success 后，等 channelChange 报「切到位」的时长（ms）。
+ * 超时按下发结果自己收尾，**不回滚** —— 指令已被受理，物理镜头其实已经切了，
+ * 回滚读数只会让读数和画面对不上。
+ *
+ * 与 SWITCH_LENS_TIMEOUT 取同一档（3s）：设备真正切完镜头本身要一会儿，
+ * 给短了会在事件晚到时提前自己收尾，等于白订阅。
+ * 真机现状：设备侧暂未推 channelChange，切镜头基本都靠这条超时收尾。
+ */
+export const CHANNEL_SETTLE_TIMEOUT = 3000;
+
+/**
+ * 判定「画面是否正好停在镜头光学正倍数」的容差。
+ * 回读的 d 是浮点，1.0 附近会有 1.0000001 这种抖动，严格相等判不出来。
+ */
+export const D_MATCH_EPS = 0.01;
+
+/** 查询当前镜头超时（ms）：宿主不回调时不能把同步流程一直挂着 */
+export const QUERY_LENS_TIMEOUT = 3000;
+
+/**
+ * 手势缩放跨临界点判定的 trailing 防抖（ms）。
+ * zoomLevelChange 高频上报，等手势停下来再判定是否切镜头（协议 §4.4）。
+ * 待 APP 提供 zoomFree 的「手势是否结束」参数后可改为由该参数触发。
+ */
+export const GESTURE_SWITCH_DEBOUNCE = 500;
+
+/** 横屏 dock 距播放器右边的距离，负值时向右探出 */
+export const ZOOM_DOCK_RIGHT = -10;
+
+/** dock 层级，需高于四角容器的 z-index: 100 */
+export const ZOOM_DOCK_Z_INDEX = 120;
+
+/**
+ * 竖屏截取比例：从椭圆上弧顶往下截取多少。
+ * 0.5 = 完整上半椭圆（截面底边落在最宽处）；> 0.5 会带出两侧下弯段。
+ * 取 0.5 让背景一路铺到播放器底边、不留空隙，多出来的部分靠 ZOOM_DOCK_BOTTOM 探出被裁掉。
+ */
+export const CROP_RATIO_BOTTOM = 0.5;
+
+/** 基准椭圆全高，与 rjs 里的 BASE_RY * 2 保持一致 */
+const BASE_ELLIPSE_HEIGHT = 351;
+
+/**
+ * 触摸响应余量：把 canvas 向外扩一圈，让整个转盘区域（含椭圆上方空白）都能拖动，
+ * 而不是只有椭圆截面那一条带。绘制位置由 renderer 补偿，视觉不变。
+ */
+export const HIT_PADDING_X = 16;
+export const HIT_PADDING_Y = 24;
+
+/**
+ * 竖屏 dock 高度：必须 >= canvas 实际高度（椭圆截面 + 上下触摸余量），
+ * 否则承载它的 CoverView 会把转盘裁掉一截。随 CROP_RATIO_BOTTOM / HIT_PADDING_Y 自动跟随，留 8px 余量。
+ */
+export const ZOOM_DOCK_HEIGHT = Math.ceil(BASE_ELLIPSE_HEIGHT * CROP_RATIO_BOTTOM) + HIT_PADDING_Y * 2 + 8;
+
+/**
+ * 内容顶部到播放器底边的距离（视觉基准）。
+ * dock 是 bottom 定位、内容从顶部往下画，所以顶部位置 = 该值，与截取比例无关 ——
+ * 改 CROP_RATIO_BOTTOM 只影响背景往下探多深，不会动到当前倍率文案与刻度的位置。
+ */
+const ZOOM_DOCK_TOP_GAP = 169;
+
+/**
+ * 竖屏 dock 距播放器底边的距离。
+ * 负值 = 椭圆下半探出播放器底边，由 .ipc-player-content 的 overflow: hidden 裁掉，
+ * 保证背景铺满到底边、下方不留空隙。
+ */
+export const ZOOM_DOCK_BOTTOM = ZOOM_DOCK_TOP_GAP - ZOOM_DOCK_HEIGHT;
+
+/** 横屏截取比例（右侧展示空间较窄，截得更深） */
+export const CROP_RATIO_RIGHT = 0.45;
+
+/** 布局沉降兜底：onShow / onResize 后的重挂载延时 */
+export const RELAYOUT_DELAYS = [80, 260];
+
+/** 刻度与文案整体下移量（角度不变，仅平移绘制坐标系） */
+export const CONTENT_OFFSET_Y = 10;
+
+/** 刻度与标记值向椭圆内侧收的距离，加大与遮罩边缘的间距 */
+export const TRACK_EDGE_INSET = 10;
+
+/** 竖屏样式微调 */
+export const STYLE_OPTIONS_BOTTOM = {
+  topSafeArea: 30,
+  currentLabelFontSize: 12,
+  markLabelFontSize: 10,
+  contentOffsetY: CONTENT_OFFSET_Y,
+  trackEdgeInset: TRACK_EDGE_INSET,
+  hitPaddingX: HIT_PADDING_X,
+  hitPaddingY: HIT_PADDING_Y
+};
+
+/** 横屏样式微调：压小刻度、文字与指针，避免与右侧控件重叠 */
+export const STYLE_OPTIONS_RIGHT = {
+  topSafeArea: 30,
+  currentLabelFontSize: 12,
+  markLabelFontSize: 10,
+  innerLabelOffsetX: 36,
+  innerLabelOffsetY: 36,
+  // 横屏画布整体旋转 90°，这里的偏移沿旋转后坐标系生效（即向屏幕右侧）
+  contentOffsetY: CONTENT_OFFSET_Y,
+  trackEdgeInset: TRACK_EDGE_INSET,
+  hitPaddingX: HIT_PADDING_X,
+  hitPaddingY: HIT_PADDING_Y
+};
+
+/**
+ * 普通刻度震动节流（ms）。step=0.1 时整个区间有几十级，
+ * 不节流会震得过密，反而糊成一片没有颗粒感。
+ */
+export const VIBRATE_THROTTLE = 60;
+
+/** 圈选提示：圆环尺寸 */
+export const TIP_RING_SIZE = 44;
+
+/** 可视区判定：避开左下角滚动容器右侧淡出带的安全距离 */
+export const FADE_SAFE_PADDING = 24;

package/lib/widgets/zoomTurntable/entryAnchor.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 入口图标的锚点类名，供 createSelectorQuery 定位。
+ *
+ * 单独成文件：measureVisible 与 zoomTurntableEntry 双向都要用到它，
+ * 放任一侧都会造成循环引用。
+ */
+export declare const ZOOM_ENTRY_ANCHOR_CLS = "ipc-zoom-entry-anchor";

package/lib/widgets/zoomTurntable/entryAnchor.js

@@ -0,0 +1,7 @@
+/**
+ * 入口图标的锚点类名，供 createSelectorQuery 定位。
+ *
+ * 单独成文件：measureVisible 与 zoomTurntableEntry 双向都要用到它，
+ * 放任一侧都会造成循环引用。
+ */
+export const ZOOM_ENTRY_ANCHOR_CLS = 'ipc-zoom-entry-anchor';

package/lib/widgets/zoomTurntable/index.d.ts

@@ -0,0 +1,8 @@
+export * from './zoomTurntableEntry';
+export * from './zoomTurntableDock';
+export * from './zoomTurntableTip';
+export * from './lensSkill';
+export * from './lensModel';
+export * from './useLensZoom';
+export * from './entryAnchor';
+export * from './constants';

package/lib/widgets/zoomTurntable/index.js

@@ -0,0 +1,8 @@
+export * from './zoomTurntableEntry';
+export * from './zoomTurntableDock';
+export * from './zoomTurntableTip';
+export * from './lensSkill';
+export * from './lensModel';
+export * from './useLensZoom';
+export * from './entryAnchor';
+export * from './constants';

package/lib/widgets/zoomTurntable/lensModel.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 双层缩放换算：物理镜头（光学）× 播放器本地数字缩放 d。
+ *
+ *   curM = lens.basicRatio + (d − 1) × Δ        Δ = 区间跨度 / (D_MAX − D_MIN)
+ *
+ * 是加法不是乘法：thresholds [1,3,6] 的长焦（basicRatio 3、区间 [3,6]）上
+ * d=1→3.0x、d=2→4.0x、d=3→5.0x、d=4→6.0x，不是 3×4=12。
+ * d 是相对当前镜头的读数，同一个 d 在不同镜头上画面倍率不同，直接显示 d 是错的。
+ */
+import { ZoomSkill } from './lensSkill';
+/** 本地数字缩放下限（协议规定） */
+export declare const D_MIN = 1;
+/** 本地数字缩放上限（协议规定 d ∈ [1, 4]） */
+export declare const D_MAX = 4;
+/** 镜头匹配容差缺省值，镜头未声明 step 时使用 */
+export declare const DEFAULT_MATCH_TOLERANCE = 0.1;
+/** 镜头 i 负责的倍率区间 [thresholds[i], thresholds[i + 1]] */
+export declare const lensRange: (skill: ZoomSkill, index: number) => [number, number];
+/** 镜头 i 上「每 1 单位 d」对应的画面倍率增量 */
+export declare const deltaOf: (skill: ZoomSkill, index: number) => number;
+/** 回读方向：本地数字缩放 d → 画面绝对倍率 curM */
+export declare const toDisplayZoom: (skill: ZoomSkill, index: number, d: number) => number;
+/** 下发方向：画面绝对倍率 curM → 该镜头上的本地数字缩放 d */
+export declare const toScaleMultiple: (skill: ZoomSkill, index: number, curM: number) => number;
+/**
+ * 镜头 i 上允许的最大本地数字缩放 d —— 即该镜头区间上限换算出的 d（受 D_MAX 约束）。
+ * 播放器的 maxScaleMultiple 是 d 口径，多镜头下要按当前镜头换算，不能直接用画面绝对上限。
+ */
+export declare const maxScaleMultiple: (skill: ZoomSkill, index: number) => number;
+/** 镜头 i 的匹配容差：取该镜头的步进精度 step，未声明时用缺省值 */
+export declare const toleranceOf: (skill: ZoomSkill, index: number) => number;
+/** 协议未声明 step 时的缺省步进 */
+export declare const DEFAULT_STEP = 0.1;
+/**
+ * 画面倍率 → 目标镜头下标。
+ * 容差取各镜头自己的 step；同时命中多个区间时取大镜头，避免临界处反复横跳。
+ * 代价：临界带会被判到大镜头，画面至多向上吸附一个 step。
+ */
+export declare const matchLens: (skill: ZoomSkill, curM: number) => number;
+/** 由镜头 id 反查下标 */
+export declare const indexOfLensId: (skill: ZoomSkill, lensId: number) => number;
+/** 转盘可用倍率域：[thresholds[0], thresholds 末位] */
+export declare const zoomBounds: (skill: ZoomSkill) => [number, number];
+/**
+ * 次刻度值：逐镜头区间按各自 step 生成，故各段疏密不同。
+ * 在逻辑层算好再给 rjs：rjs 只有当前镜头的 step，推不出分段间距。
+ */
+export declare const buildTickValues: (skill: ZoomSkill) => number[];
+/** 主刻度 = 各镜头固定光学倍数 + 上限，与镜头临界点对齐 */
+export declare const buildMarks: (skill: ZoomSkill) => {
+    value: number;
+    label: string;
+}[];

package/lib/widgets/zoomTurntable/lensModel.js

@@ -0,0 +1,137 @@
+import "core-js/modules/esnext.iterator.constructor.js";
+import "core-js/modules/esnext.iterator.filter.js";
+import "core-js/modules/esnext.iterator.map.js";
+/**
+ * 双层缩放换算：物理镜头（光学）× 播放器本地数字缩放 d。
+ *
+ *   curM = lens.basicRatio + (d − 1) × Δ        Δ = 区间跨度 / (D_MAX − D_MIN)
+ *
+ * 是加法不是乘法：thresholds [1,3,6] 的长焦（basicRatio 3、区间 [3,6]）上
+ * d=1→3.0x、d=2→4.0x、d=3→5.0x、d=4→6.0x，不是 3×4=12。
+ * d 是相对当前镜头的读数，同一个 d 在不同镜头上画面倍率不同，直接显示 d 是错的。
+ */
+import { lensCount } from './lensSkill';
+
+/** 本地数字缩放下限（协议规定） */
+export const D_MIN = 1.0;
+/** 本地数字缩放上限（协议规定 d ∈ [1, 4]） */
+export const D_MAX = 4.0;
+/** 镜头匹配容差缺省值，镜头未声明 step 时使用 */
+export const DEFAULT_MATCH_TOLERANCE = 0.1;
+
+/** 镜头 i 负责的倍率区间 [thresholds[i], thresholds[i + 1]] */
+export const lensRange = (skill, index) => {
+  const lo = skill.thresholds[index];
+  const hi = skill.thresholds[index + 1];
+  return [lo, hi];
+};
+
+/** 镜头 i 上「每 1 单位 d」对应的画面倍率增量 */
+export const deltaOf = (skill, index) => {
+  const [lo, hi] = lensRange(skill, index);
+  const span = hi - lo;
+  if (!(span > 0)) return 1;
+  return span / (D_MAX - D_MIN);
+};
+const clampD = d => Math.min(D_MAX, Math.max(D_MIN, d));
+
+/** 回读方向：本地数字缩放 d → 画面绝对倍率 curM */
+export const toDisplayZoom = (skill, index, d) => {
+  var _skill$lenses;
+  const lens = skill === null || skill === void 0 || (_skill$lenses = skill.lenses) === null || _skill$lenses === void 0 ? void 0 : _skill$lenses[index];
+  if (!lens) return d;
+  return lens.basicRatio + (clampD(d) - D_MIN) * deltaOf(skill, index);
+};
+
+/** 下发方向：画面绝对倍率 curM → 该镜头上的本地数字缩放 d */
+export const toScaleMultiple = (skill, index, curM) => {
+  var _skill$lenses2;
+  const lens = skill === null || skill === void 0 || (_skill$lenses2 = skill.lenses) === null || _skill$lenses2 === void 0 ? void 0 : _skill$lenses2[index];
+  if (!lens) return D_MIN;
+  return clampD(D_MIN + (curM - lens.basicRatio) / deltaOf(skill, index));
+};
+
+/**
+ * 镜头 i 上允许的最大本地数字缩放 d —— 即该镜头区间上限换算出的 d（受 D_MAX 约束）。
+ * 播放器的 maxScaleMultiple 是 d 口径，多镜头下要按当前镜头换算，不能直接用画面绝对上限。
+ */
+export const maxScaleMultiple = (skill, index) => toScaleMultiple(skill, index, lensRange(skill, index)[1]);
+
+/** 镜头 i 的匹配容差：取该镜头的步进精度 step，未声明时用缺省值 */
+export const toleranceOf = (skill, index) => {
+  var _skill$lenses$index$s, _skill$lenses3;
+  return (_skill$lenses$index$s = skill === null || skill === void 0 || (_skill$lenses3 = skill.lenses) === null || _skill$lenses3 === void 0 || (_skill$lenses3 = _skill$lenses3[index]) === null || _skill$lenses3 === void 0 ? void 0 : _skill$lenses3.step) !== null && _skill$lenses$index$s !== void 0 ? _skill$lenses$index$s : DEFAULT_MATCH_TOLERANCE;
+};
+
+/** 协议未声明 step 时的缺省步进 */
+export const DEFAULT_STEP = 0.1;
+
+/**
+ * 画面倍率 → 目标镜头下标。
+ * 容差取各镜头自己的 step；同时命中多个区间时取大镜头，避免临界处反复横跳。
+ * 代价：临界带会被判到大镜头，画面至多向上吸附一个 step。
+ */
+export const matchLens = (skill, curM) => {
+  let hit = 0;
+  const count = lensCount(skill);
+  for (let i = 0; i < count; i++) {
+    const [lo, hi] = lensRange(skill, i);
+    const tolerance = toleranceOf(skill, i);
+    if (curM >= lo - tolerance && curM <= hi + tolerance) {
+      hit = i;
+    }
+  }
+  return hit;
+};
+
+/** 由镜头 id 反查下标 */
+export const indexOfLensId = (skill, lensId) => {
+  var _skill$lenses4;
+  const index = skill === null || skill === void 0 || (_skill$lenses4 = skill.lenses) === null || _skill$lenses4 === void 0 ? void 0 : _skill$lenses4.findIndex(item => item.id === lensId);
+  return index != null && index >= 0 ? index : 0;
+};
+
+/** 转盘可用倍率域：[thresholds[0], thresholds 末位] */
+export const zoomBounds = skill => {
+  const {
+    thresholds
+  } = skill;
+  return [thresholds[0], thresholds[thresholds.length - 1]];
+};
+
+/**
+ * 次刻度值：逐镜头区间按各自 step 生成，故各段疏密不同。
+ * 在逻辑层算好再给 rjs：rjs 只有当前镜头的 step，推不出分段间距。
+ */
+export const buildTickValues = skill => {
+  const count = lensCount(skill);
+  const values = [];
+  for (let i = 0; i < count; i += 1) {
+    var _skill$lenses$i$step, _skill$lenses5;
+    const [lo, hi] = lensRange(skill, i);
+    const step = (_skill$lenses$i$step = (_skill$lenses5 = skill.lenses) === null || _skill$lenses5 === void 0 || (_skill$lenses5 = _skill$lenses5[i]) === null || _skill$lenses5 === void 0 ? void 0 : _skill$lenses5.step) !== null && _skill$lenses$i$step !== void 0 ? _skill$lenses$i$step : DEFAULT_STEP;
+    if (step > 0 && hi > lo) {
+      // 浮点累加会漂，用格数反推每一格的值
+      const gridCount = Math.floor((hi - lo) / step + 1e-9);
+      for (let g = 0; g <= gridCount; g += 1) {
+        values.push(Number((lo + g * step).toFixed(4)));
+      }
+    }
+  }
+  const [, max] = zoomBounds(skill);
+  values.push(Number(max.toFixed(4)));
+  return values.filter(value => value <= max + 1e-9).filter((value, index, arr) => arr.indexOf(value) === index).sort((a, b) => a - b);
+};
+
+/** 主刻度 = 各镜头固定光学倍数 + 上限，与镜头临界点对齐 */
+export const buildMarks = skill => {
+  const [, max] = zoomBounds(skill);
+  const count = lensCount(skill);
+  const values = skill.lenses.slice(0, count).map(item => item.basicRatio);
+  values.push(max);
+  return values.filter((value, i, arr) => arr.indexOf(value) === i).sort((a, b) => a - b).map(value => ({
+    value,
+    // 整数不带小数点（1 / 3 / 6），非整数保留一位（1.5）
+    label: Number.isInteger(value) ? String(value) : value.toFixed(1)
+  }));
+};

package/lib/widgets/zoomTurntable/lensModel.test.d.ts

@@ -0,0 +1 @@
+export {};