@firetable/project-xiaochun 0.1.14 → 0.1.16

package/dist/element.js

@@ -1,10 +1,10 @@
-/*! @firetable/project-xiaochun v0.1.14 | MIT | https://github.com/FireTable/project-xiaochun */
+/*! @firetable/project-xiaochun v0.1.16 | MIT | https://github.com/FireTable/project-xiaochun */
 import {
   XIAOCHUN_ELEMENT_TAG,
   defineXiaochunElement
-} from "./chunks/chunk-HLVD6HQM.js";
-import "./chunks/chunk-OLVSOJML.js";
-import "./chunks/chunk-DUU5PTKT.js";
+} from "./chunks/chunk-HZ2ADKG7.js";
+import "./chunks/chunk-UWL65W7D.js";
+import "./chunks/chunk-RHQW4QZH.js";
 
 // src/element.ts
 defineXiaochunElement();

package/dist/gesture-box.d.ts

@@ -0,0 +1,72 @@
+/**
+ * gesture-box.ts — iframe 手势 (xc.gesture-move / xc.gesture-resize) 在宿主侧的纯逻辑: 校验 + 几何限幅。零 DOM 依赖, 可单测。
+ *
+ * 宿主 SDK 对 iframe 发来的手势**不信任**: 载荷逐字段校验 (类型 / 有限数 / 量级 / 角名), 序号必须按规则递增 (GestureGate),
+ * 位置 / 尺寸全部在这里按"当前视口 + 最小 / 最大尺寸"夹紧, iframe 说多少就移多少是不可能的。
+ * 计算一律用 start 时的盒子 + 累计位移 (totalDx / totalDy), 不累加增量: 丢包 / 夹紧都不会让结果漂移。
+ */
+import type { XcGestureCorner } from './protocol';
+export interface Box {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+export interface Viewport {
+    width: number;
+    height: number;
+}
+export interface ResizeLimits {
+    minWidth: number;
+    minHeight: number;
+    maxWidth: number;
+    maxHeight: number;
+}
+/** 默认限幅: 最小 120x180 (再小角色基本看不清), 最大只受视口限制。 */
+export declare const DEFAULT_RESIZE_LIMITS: Readonly<ResizeLimits>;
+export interface XiaochunResizeLimits {
+    /** 最小宽 (px), 默认 120。 */
+    minWidth?: number;
+    /** 最小高 (px), 默认 180。 */
+    minHeight?: number;
+    /** 最大宽 (px), 默认只受视口限制。 */
+    maxWidth?: number;
+    /** 最大高 (px), 默认只受视口限制。 */
+    maxHeight?: number;
+}
+/** `resizable` 选项 → 限幅; false / undefined → null (关闭); true → 默认限幅; 对象 → 逐项覆盖 (非法值用默认)。min 不会超过 max。 */
+export declare function normalizeResizable(v: boolean | XiaochunResizeLimits | undefined): ResizeLimits | null;
+/** 移动: 起点盒子 + 累计位移, 夹在视口内 (盒子比视口大时贴左上)。 */
+export declare function moveBox(start: Box, totalDx: number, totalDy: number, vp: Viewport): Box;
+/**
+ * 缩放: 被拖的角跟手, 对角固定; 宽高夹在 [min, min(max, 视口内还能伸展的空间)]。
+ * 例: 拖 SE 角 → 左上固定, 右 / 下边界不能越过视口; 拖 NW 角 → 右下固定, 左 / 上边界不能越过视口。
+ */
+export declare function resizeBox(start: Box, corner: XcGestureCorner, totalDx: number, totalDy: number, limits: ResizeLimits, vp: Viewport): Box;
+/** 窗口 / 视口变小后把盒子重新夹回视口 (尺寸也不超过视口)。 */
+export declare function fitBox(b: Box, vp: Viewport): Box;
+/** 单次累计位移的合理上限 (CSS px)。屏幕再大也到不了, 超过的一律当作伪造。 */
+export declare const MAX_GESTURE_DELTA = 20000;
+export interface ParsedGesture {
+    gesture: number;
+    seq: number;
+    phase: 'start' | 'move' | 'end';
+    totalDx: number;
+    totalDy: number;
+    corner?: XcGestureCorner;
+}
+/** 校验 iframe 发来的手势载荷; 不合法返回 null。kind='resize' 还要求合法的 corner。 */
+export declare function parseGesturePayload(kind: 'move' | 'resize', raw: unknown): ParsedGesture | null;
+/**
+ * 手势序号闸门: 只放行"合法的手势序列" —— start(gesture 比上一个大, seq=0) → move* (seq 严格递增) → end。
+ * 迟到 / 重放 / 乱序 / 没有 start 的消息一律拒绝。一个闸门对应一种手势 (move 或 resize)。
+ */
+export declare class GestureGate {
+    private lastGesture;
+    private lastSeq;
+    private open;
+    get active(): boolean;
+    accept(p: Pick<ParsedGesture, 'gesture' | 'seq' | 'phase'>): boolean;
+    /** 宿主主动结束 (关闭手势 / 销毁): 之后同一手势的迟到消息被拒绝。 */
+    close(): void;
+}