bloub-to-vue-and-react 0.1.2

package/dist/types/bot/cycles.d.ts

@@ -0,0 +1,89 @@
+import { type StateId } from './states';
+/**
+ * 一个循环就是一个剪辑：由一系列块组成，每个块是一个保持选定时长的状态。
+ * 这是目录中"编辑器"的部分，并且它保留了这些规则——纯数据，没有时钟，
+ * 没有 Vue 导入：同一个循环必须能够被测试、播放器和时间轴重新读取。
+ *
+ * 块没有标识符：它就是列表中的一个位置，渲染的键就是索引。
+ * 这让 localStorage 中的 JSON 保持可读，也让测试保持确定性。
+ */
+export interface Block {
+    state: StateId;
+    duration: number;
+}
+export interface Cycle {
+    id: string;
+    name: string;
+    blocks: Block[];
+}
+/**
+ * 所有块的共同下限。引擎只保留一个历史记录槽
+ * （`BotEngine.setState` 会覆盖 `prev`），因此如果一个块比下一个块的
+ * 入场过渡还短，它就会跳到那一帧而不是平滑过渡。
+ *
+ * 该值由目录推导而来，而非手写。原来的值是 0.6，之所以能正常工作，
+ * 仅仅是因为 0.6 恰好是目录中最长的 `morph`——也就是 `orbit` 的过渡时长。
+ * 没有任何东西保证这一点：如果新增一个过渡时长为 0.8 秒的状态，
+ * 就会让编辑器出现抖动，而不会有任何测试察觉。现在这个下限会随之联动。
+ */
+export declare const MIN_BLOCK: number;
+/**
+ * 这是编辑器的一道护栏，而不是度量：拉长一个块没有风险
+ * （状态会饱和它们的渐变并保持最终姿态），但一分钟长的块轨道就不再可读了。
+ */
+export declare const MAX_BLOCK = 10;
+/**
+ * 在编辑和重新读取时，允许的块数和剪辑数量上限。
+ *
+ * 这些不是产品限制，而是针对恶意存储的边界：存储是可修改的，能容纳几兆字节，
+ * 而下游没有任何组件按这种规模来设计——一个包含 150 000 个块的循环，
+ * 约 4 MB 的 JSON，会产生 1 500 000 秒的时长、同样多的刻度需要分配，
+ * 以及一条 29 700 000 px 宽的轨道。之前在进入 Animations 视图时标签页会卡死。
+ *
+ * 200 个块相当于半小时的剪辑，远超任何实际用途。
+ */
+export declare const MAX_BLOCS = 200;
+export declare const MAX_CYCLES = 50;
+/** 滚轮和缩放调整的步长，单位为秒。 */
+export declare const STEP = 0.1;
+/** 块的最小时长：引擎下限，或该状态的实测时长。 */
+export declare function minDurationOf(state: StateId): number;
+/** 将时长限制在其边界内并对齐到步长，且不残留浮点尾数。 */
+export declare function clampDuration(state: StateId, seconds: number): number;
+export declare function makeBlock(state: StateId): Block;
+/**
+ * 从视频测得的剪辑：`SEQUENCE` 的顺序，每个状态保持其测得的时长。
+ * 它作为首次启动时的初始内容，之后便归用户所有——可以像其他剪辑一样
+ * 编辑和存储。而参考版本则留在代码中：清空存储后它就会回来。
+ */
+export declare function defaultCycle(): Cycle;
+export declare function totalDuration(blocks: Block[]): number;
+/** 块在剪辑中的开始时刻。 */
+export declare function offsetOf(blocks: Block[], index: number): number;
+/**
+ * 在时刻 `t` 播放的块，以及在其中已流逝的时间。超过最后一个块后会
+ * 回到开头：播放是循环的。调用方需确保剪辑不为空。
+ */
+export declare function blockAt(blocks: Block[], t: number): {
+    index: number;
+    elapsed: number;
+};
+/**
+ * 在剪辑末尾添加一个动画（右侧面板或「+」卡片）。
+ *
+ * 与重新读取一样，受 `MAX_BLOCS` 上限约束。否则编辑器会允许构建出
+ * 比存储重载时所能返回的更大的剪辑，工作成果就会无声消失——
+ * 一个不作为编辑上限的读取上限是陷阱，而不是保护。
+ */
+export declare function blocksWith(blocks: Block[], state: StateId): Block[];
+/** 移动一个块，并返回一个新列表（Vue 状态会被替换）。 */
+export declare function moveBlock(blocks: Block[], from: number, to: number): Block[];
+/** `Mon cycle`、`Mon cycle 2`、`Mon cycle 3`……——绝不出现两个相同的名字。 */
+export declare function uniqueName(base: string, cycles: Cycle[]): string;
+/** 无冲突的标识符，即使面对手动改过的 localStorage 也能保证。 */
+export declare function nextCycleId(cycles: Cycle[]): string;
+/**
+ * localStorage 可以被手动修改：我们不信任它，这与对待 URL hash 的规则相同。
+ * 凡是无法重新读取的内容都会被静默丢弃，而不是在启动时破坏应用。
+ */
+export declare function parseCycles(raw: string | null): Cycle[];

package/dist/types/bot/decor.d.ts

@@ -0,0 +1,110 @@
+export interface DotRender {
+    x: number;
+    y: number;
+    r: number;
+    opacity: number;
+    /** 显式颜色；默认情况下渲染使用身体自身的颜色 */
+    color?: string;
+    /**
+     * 深度雾化：0 = 融入背景，1 = 身体自身的完整颜色。
+     * 混合发生在渲染阶段，只有渲染才知道所选择的颜色。
+     */
+    depth?: number;
+    /**
+     * 非圆形形状，以球半径为单位的尺寸，且以原点为中心
+     * （倾斜的 "!" 的点是一滴水滴，而不是圆盘）。当提供该字段时，
+     * 绘制不再使用 `r`。
+     */
+    d?: string;
+    /** 应用于 `d` 的旋转，单位为度 */
+    rot?: number;
+}
+/**
+ * 状态所声明的内容：弧的几何形状保持以球半径为单位，
+ * 由引擎（唯一知道 viewBox 缩放比例的组件）来将其栅格化。
+ * 否则，各状态就必须知道 viewBox 的尺寸。
+ */
+export interface ArcSpec {
+    id: string;
+    seed: ArcSeed;
+    t: number;
+    opacity: number;
+}
+export interface ArcRender {
+    id: string;
+    /** 身体前方的部分 */
+    front: string;
+    /** 身体后方的部分（先绘制，因此被剪影遮挡） */
+    back: string;
+    width: number;
+    opacity: number;
+    /** 沿轨迹的色相渐变 */
+    grad: {
+        x1: number;
+        y1: number;
+        x2: number;
+        y2: number;
+        stops: string[];
+    };
+}
+export interface ArcSeed {
+    /** 半长轴，以球半径为单位 */
+    a: number;
+    /** 扁率 b/a：实测 <= 0.45，轨道平面以侧视角度呈现 */
+    k: number;
+    /** 长轴在屏幕上的倾角，单位为弧度 */
+    tilt: number;
+    /** 每秒转数 */
+    speed: number;
+    phase: number;
+    /** 实际绘制的弧长占整圈的比例 */
+    sweep: number;
+    hue: number;
+    hueSpan: number;
+    width: number;
+    cx: number;
+    cy: number;
+}
+/**
+ * 将倾斜的 3D 圆以正交投影方式投射出来。
+ *
+ * 圆位于由 u（在屏幕内）和 v（伸入纵深方向）张成的平面上。z 分量用于把弧
+ * 切成两半：后半部分先于身体绘制，因此被它遮挡。正是这种真正的深度排序，
+ * 让圆环读起来像轨道，而不是一幅平面图画。
+ */
+export declare function arcRender(seed: ArcSeed, t: number, scale: number, id: string, opacity?: number): ArcRender;
+/**
+ * 6 个圆环，半长轴 1.30-1.40（因此明显大于球体），
+ * 扁率始终 <= 0.45，厚度 0.055，约 3.3 转/秒。
+ */
+export declare const RINGS: ArcSeed[];
+/**
+ * 一束嵌套的弧，在轨道之前扫过三角形。
+ * 几乎以侧视角度呈现（因此呈发夹形），rmax 为 1.37。
+ */
+export declare const SWOOSH: ArcSeed[];
+/** x 实测值：-0.557 / -0.013 / +0.532，y = 0。 */
+export declare const DOT_X: readonly [-0.557, -0.013, 0.532];
+export declare const DOT_R = 0.165;
+export declare const DOT_PEAK = 1.25;
+/**
+ * 粒子并非沿直线飞出：它们一边变大，一边向中心螺旋收缩
+ * （半径每帧乘 0.75，角度 +100 度/秒），最终转到核心后方被吞没。
+ */
+export declare function particles(t: number, scale: number): DotRender[];
+export declare const COMET_RIBBONS: ArcSeed[];
+/** 彗星中心点的半径，实测为 0.129。 */
+export declare const COMET_DOT = 0.129;
+/** 从像素取样的蓝色。 */
+export declare const NOTIF_BLUE = "#2496e8";
+/** 小圆点恰好位于圆周上，在 -42deg 处。 */
+export declare const NOTIF_ANGLE = -42;
+export declare const NOTIF_DIST = 1.003;
+/** 静止时的半径；弹出动画最高高出 14%。 */
+export declare const NOTIF_R = 0.15;
+export declare const NOTIF_POP = 1.14;
+/**
+ * 凹槽是一个与小圆点同心的圆盘，从身体上减去。
+ * 边距是恒定的（0.054 R），并随身体的缩放而变化。
+ */
+export declare const NOTIF_MARGIN = 0.054;

package/dist/types/bot/engine.d.ts

@@ -0,0 +1,189 @@
+import { type ArcRender, type DotRender } from './decor';
+import { type BotExpression } from './expressions';
+import { type StateId } from './states';
+export interface RenderedEye {
+    d: string;
+    matrix: string;
+    alpha: number;
+}
+export interface BotFrame {
+    bodyPath: string;
+    bodyAlpha: number;
+    eyes: RenderedEye[];
+    /** 嘴巴，像眼睛一样在身体上开洞；null = 没有嘴巴 */
+    mouth: RenderedEye | null;
+    dots: DotRender[];
+    /** true = 点状装饰移到身体后面（爆裂粒子） */
+    dotsBehind: boolean;
+    arcs: ArcRender[];
+    notif: {
+        x: number;
+        y: number;
+        r: number;
+    } | null;
+    notch: {
+        x: number;
+        y: number;
+        r: number;
+    } | null;
+}
+/**
+ * 当外部事物驱动机器人时，它看向哪里——目前是鼠标指针。
+ *
+ * `yaw` 和 `pitch` 是绝对方向，随着 `mix` 升高，它们取代姿态中的方向。有两个原因，
+ * 每个都是已经踩过的坑：
+ *
+ * - 这种混合必须由引擎完成，而不是调用方，因为只有引擎才知道当前这一刻的姿态。
+ *   如果调用方去补偿表情的朝向，它会在过渡仍在进行时读到目标值，于是每次情绪变化
+ *   眼睛都会跳动；
+ * - 而且两个轴上都必须是绝对的。如果使用相对值，眼睛的高度会跟随每个表情而变化
+ *   ——「中性」看向 +28.6deg，而其他表情介于 -9 到 +9 之间——于是第一次情绪变化时
+ *   眼睛会骤然下坠。在跟随过程中决定表情性格的，是它眼睛的形状（眯起、圆睁、不对称），
+ *   而不是它看向哪里：看向哪里，由光标来决定。
+ *
+ * `mix` 表示外部对方向的掌控程度（0 = 完全没有）。
+ *
+ * `wander` 则单独表示剩余的自动漂移。两者不能混淆：当指针移动时，漂移应当熄灭——
+ * 如果叠加，机器人看起来就像在寻找光标却永远抓不住它。但当没有指针时（例如切到
+ * 键盘、触屏，或鼠标移出窗口），头部应当保持转向并继续存活。把两者混淆会让视线
+ * 在视图一打开时就僵住。
+ *
+ * `spin` 是途中要转过的圈数，单位为度，会随着到达而逐渐融化为 0。由于眼睛生活在一个
+ * 球面上，转一圈会让它们绕到球体背面再从另一侧回来——而 `-360deg` 和 `0` 是同一个
+ * 角度，因此不会改变它们最终落下的位置。
+ */
+export interface Look {
+    yaw: number;
+    pitch: number;
+    mix: number;
+    spin: number;
+    wander: number;
+}
+/**
+ * 无时钟引擎：`sample(t)` 是时间的纯函数。
+ *
+ * 实际后果：暂停、恢复、减速以及跳到任意时间点都会得到完全相同的画面，
+ * 而且渲染无需 DOM 即可测试。
+ */
+export declare class BotEngine {
+    /** 静止时球体的半径，以 viewBox 为单位 */
+    readonly scale: number;
+    private cur;
+    private prev;
+    /**
+     * 被冻结的起始姿态，仅当状态变化发生在一次过渡仍在进行时才会设置。
+     * 参见 `setState`。
+     */
+    private departFige;
+    private tCur;
+    private tPrev;
+    private blinkAt;
+    private pts;
+    private shape;
+    private shapePrev;
+    private shapeAt;
+    private expr;
+    private exprPrev;
+    private exprAt;
+    private look;
+    private lookPrev;
+    private lookAt;
+    /** 当前追赶过渡的时长；见 `LOOK_MORPH`，它的默认值 */
+    private lookMorph;
+    /** 改变身体形状时的过渡时长 */
+    static readonly SHAPE_MORPH = 0.45;
+    /**
+     * 视线追赶目标的时长。比 `SHAPE_MORPH` 更短：一个跟随的视线应当显得专注，
+     * 而不是黏滞。由于目标在每次鼠标移动时都会被重新设定，正是这个时长赋予了
+     * 跟随的惯性——视线永远不会完全追上一个正在移动的光标。
+     */
+    static readonly LOOK_MORPH = 0.24;
+    constructor(scale?: number, initial?: StateId, shape?: number[] | null, expression?: BotExpression | null);
+    /**
+     * 在个性化设置中选择的静止表情。和形状一样，它会滑向新值而不是直接跳变。
+     */
+    setExpression(expression: BotExpression | null, now?: number): void;
+    /** 在 `now` 时刻生效的表情，包含正在进行的过渡。 */
+    private exprAtTime;
+    /**
+     * 在个性化设置中选择的形状。它只会在静止状态（`baseBody`）下替换身体：
+     * 在其他状态下，轮廓本身就是动画，不能被覆盖。
+     *
+     * 变化以过渡方式进行，而不是瞬间完成：由于所有形状都在相同的角度上采样，
+     * 只需要对半径进行插值即可。
+     */
+    setShape(radii: number[] | null, now?: number): void;
+    /**
+     * 在 `now` 时刻生效的形状，包含正在进行的过渡。
+     *
+     * 过渡结束时不会把 `shapePrev` 置为 null：`sample` 必须保持为时间的纯函数，
+     * 因此重新读取一个过去的时刻必须得到中间画面。这里只是多保留了一个引用。
+     */
+    private shapeAtTime;
+    /**
+     * 新的视线目标，传入 `null` 表示回到该状态自身的视线。
+     *
+     * 它从当前值出发，而不是像 `setShape` 那样从上一个目标出发：这个方法在每次
+     * 指针移动时都会被调用，如果从上个目标出发，就会在每次追赶之前让视线倒退一步
+     * ——跟随会抖动而不是平滑滑动。
+     *
+     * 除此之外与 `setShape` 约定相同：外部状态通过带时间戳的 setter 进入，
+     * 绝不通过 `sample` 期间读取的变量，否则引擎就不再是时间的纯函数。
+     */
+    setLook(look: Look | null, now: number, morph?: number): void;
+    /** 在 `now` 时刻生效的视线，包含正在进行的追赶。 */
+    private lookAtTime;
+    private posed;
+    /**
+     * 在 `now` 时刻、给定状态下的眼睛偏移，以球体半径为单位。
+     *
+     * 它是从表中读取并插值得到的，绝不重新计算：`eyefit.ts` 解释了为什么这种区分
+     * 就是全部修正。这里剩下的只是沿着形状轴去插值它，使用与轮廓过渡完全相同的曲线
+     * 和时长——因为是同一个原因，所以必须是同一种运动。
+     *
+     * 我们在过渡的两端（`shapePrev` 和 `shape`）上查询表格，而不是查询 `shapeAtTime`
+     * 返回的轮廓：后者是每一帧新分配的数组，没有身份标识，任何表格里都不存在它。
+     */
+    private decalageAtTime;
+    get state(): StateId;
+    /**
+     * 不带任何先前状态、直接回到 `id`，就像一台全新的引擎落在这个状态上。
+     *
+     * 这就是对这个引擎而言「倒带」的含义。仅靠 `setState` 无法做到这一点：
+     * 它会保留被离开的状态用于融合，这在回放时正是它的职责，但在回到序列开头时
+     * 恰恰是错误的行为。在完整跑完一遍后重放第 0 帧，会把第一个状态与最后一个状态
+     * 混合起来，GIF 导出就会以一颗没有眼睛的球开场——彗星状态的 `eyeAlpha` 为零。
+     *
+     * `sample` 仍然是时间的纯函数：和 `setState` 一样，这是一个带时间戳的 setter，
+     * 由序列驱动器调用，绝不会在采样期间调用。
+     */
+    reset(id: StateId, now: number): void;
+    /**
+     * 当前过渡的起点：如果有被冻结的姿态就用它，否则用被离开的状态按其自身已流逝的
+     * 时间求值——因此它仍在动画中，这正是期望的行为。
+     */
+    private origine;
+    /**
+     * 在 `now` 时刻的合成姿态，包含正在进行的过渡：正是 `sample` 在叠加静止生命
+     * 与视线层之前所混合的内容。抽离出来是为了让 `setState` 能够冻结它。
+     */
+    private poseComposee;
+    /**
+     * 状态变化，带时间戳。
+     *
+     * 引擎只保留一格历史，因此在过渡进行中发生的状态变化，会把混合起点替换为被离开
+     * 状态的完整姿态，而不是屏幕上那幅部分混合的画面。以 100 ms 间隔测量
+     * `idle -> wide -> idle`：跳变 35.9 px，而正常运动只有 8.0 px。
+     *
+     * 因此我们把当前合成姿态冻结起来，从它开始混合。无论连续发生多少次状态变化，
+     * 这样在构造上都是连续的。
+     *
+     * 而且只有在这种情况下才冻结。每次变化都冻结，会让被离开的状态在整个过渡期间
+     * 戛然停住——`alert` 的「!」会在行进途中僵住——而在非过渡时并没有需要修正的
+     * 东西：被离开的状态此时恰好就是屏幕上显示的画面。播放一段剪辑时，其各块时长
+     * 至少不短于最长的过渡（`MIN_BLOCK`），因此从不会冻结任何东西，输出与原先逐位
+     * 一致。
+     */
+    setState(id: StateId, now: number): void;
+    sample(now: number): BotFrame;
+}

package/dist/types/bot/expressions.d.ts

@@ -0,0 +1,36 @@
+import { type HeadGaze } from './face';
+import type { EyeCfg, MouthCfg } from './states';
+/**
+ * 机器人的静止表情。
+ *
+ * 脸只靠两颗胶囊立住，因此一切都围绕四个杠杆展开：
+ * 头部的朝向、眼睛的间距、它们的比例，以及
+ * 每只眼睛自身的倾斜。正是这最后一个造就了愤怒与
+ * 悲伤：它们要求镜像的倾斜（上端
+ * 向内聚拢或向外张开），仅靠头部滚转无法实现，因为那会让
+ * 两只眼睛朝同一侧倾斜。
+ *
+ * 只有静止状态承载这个表情。视频中的表情状态
+ * （眨眼、睁大眼睛、通知）保留它们自己的：我们来这里正是为了
+ * 复现它。
+ *
+ * 这些幅度参考 bible-strong-avatar-lab，它暴露了相同的
+ * 模型（头部 X/Y/Z、每只眼睛的宽度和高度、间距、每只眼睛的角度）：在它们
+ * 那里宽度从中性的 0.8 倍到 2.7 倍，高度从 0.3 到 1.5，
+ * 角度最大到 ±80°。我们保持在这个范围内。
+ */
+/** 枚举类型，使 i18n 层能在编译期校验它们的翻译。 */
+export type ExpressionId = 'neutre' | 'attentif' | 'surpris' | 'excite' | 'heureux' | 'hilare' | 'colere' | 'triste' | 'effraye' | 'mefiant' | 'confus' | 'curieux' | 'fier' | 'timide' | 'blase' | 'somnolent' | 'admiratif' | 'stupefait' | 'sourire' | 'regardHaut' | 'regardBas' | 'regardGauche' | 'regardDroite' | 'regardHautGauche' | 'regardHautDroite' | 'regardBasGauche' | 'regardBasDroite' | 'regardArriereHaut' | 'regardArriereBas' | 'regardArriereGauche' | 'regardArriereDroite';
+export interface BotExpression {
+    id: ExpressionId;
+    gaze: HeadGaze;
+    split: number;
+    eyes: [EyeCfg, EyeCfg];
+    /** 可选的嘴巴：只有携带嘴巴的表情才有它。 */
+    mouth?: MouthCfg;
+}
+export declare const EXPRESSIONS: BotExpression[];
+export declare const EXPRESSION_BY_ID: Map<string, BotExpression>;
+export declare const DEFAULT_EXPRESSION = "neutre";
+/** 两种表情之间的插值：变化以平滑过渡的方式进行。 */
+export declare function blendExpression(a: BotExpression, b: BotExpression, t: number): BotExpression;

package/dist/types/bot/eyefit.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 在个性化器的形状上放置脸部。
+ *
+ * 眼睛生活在一个球面上，而 `radiusAtAngle` 会按局部半径的比例
+ * 把它们贴回到真实轮廓上。这个比例确实放对了它们的中心，但眼睛本身有尺寸：
+ * 它前方离边缘所剩的边距被乘上了相同的因子，因此在它方向上较窄的
+ * 轮廓会把它推向边缘，直到
+ * 蒙版将它向外打开。胶囊在 `capsule`、`triangle`、`nuage` 和 `goutte` 上
+ * 会表现为身体上的一个凹槽。
+ *
+ * 这个模块在加载时一次性解决问题，并返回一张偏移量表。
+ * 这个选择才是修复的核心，远胜过随后介绍的几何：
+ *
+ * 如果在渲染循环中求解，修正会响应每一秒六十帧里
+ * 一切运动的东西——视线的漂移、指针、正在 morph 的
+ * 表达式、最近边缘的变化、最受约束眼睛的变化。用这种方式写了
+ * 七种变体，全都产生了可见的运动伪影：
+ * 持续的颤抖、参考边缘切换时 26 个单位的方向跳变、
+ * 尺寸参与计算时的骤然放大。
+ * 缺陷不在于它们任何一个的几何，而在于逐帧求解这件事本身。
+ *
+ * 引擎的其余部分并不是这样工作的：姿态是声明的，它只是
+ * 用已知的曲线在它们之间插值。一张查表得到的偏移量符合这个模式。
+ * 它不会在视线漂移或指针移动时变化，而在形状
+ * 或表达式变化时，它只是沿着该 morph 的曲线
+ * 从表中的一个条目走到另一个。颤抖从构造上变得不可能，而不是被压制：
+ * 在两个常量之间插值是单调的，而在正在插值的视线上重新求解
+ * 问题则不是单调的。
+ *
+ * 令人愉快的一个推论：求解器不再有任何连续性约束，因为它
+ * 在动画期间不运行。因此它可以探测一整束方向，
+ * 覆盖视线漂移的最坏情况，这是逐帧版本所
+ * 无法承担的。
+ *
+ * 这张表是模块常量，在 import 时由纯数据构建：
+ * 性质与 `face.ts` 的眨眼时刻表相同，确定性的、无状态的，
+ * 因此不影响 `engine.sample(t)` 的纯性。
+ */
+import { type StateId } from './states';
+/**
+ * 偏移量表，在 import 时构建：每个（形状、带基础身体的状态、
+ * 表达式）一个条目。只有 `idle` 和 `swirl` 承载静止脸部，因此只有它们
+ * 会按表达式细分——另外三个带基础身体的状态在视频中有一张
+ * 抬起的脸，只有一个条目。
+ *
+ * 通过半径数组的引用来作为键，这已经是引擎的约定：它的
+ * 守卫 `radii === this.shape` 和 `expression === this.expr` 依赖同样的
+ * 稳定性。一个未知的轮廓，或 `null`，不做任何修正——API 接受任意
+ * 数组，引擎不必依赖调用者的谨慎。
+ */
+declare function batir(): Map<number[], Map<string, {
+    x: number;
+    y: number;
+}>>;
+/**
+ * 对于这个状态下的这个形状，要施加在两只眼睛上的偏移量，单位为球的
+ * 半径——引擎会把它缩放到自己的比例。
+ *
+ * 只要形状不在目录中就为零，这涵盖了 `null` 和圆：
+ * 在圆上两个轮廓是相同的，因此边距已经是要求的边距，
+ * 下降在第一轮就退出。因此视频中记录的形状不会移动，
+ * 无需特殊情况。
+ */
+export declare function decalageDesYeux(radii: number[] | null, state: StateId, expr: string | null): {
+    x: number;
+    y: number;
+};
+/** 供测试使用：用来在不重做几何的情况下验证这张表。 */
+/** 供测试使用：用来计时这张表的构建。 */
+export declare const POUR_TESTS: {
+    batir: typeof batir;
+};
+export {};

package/dist/types/bot/face.d.ts

@@ -0,0 +1,76 @@
+/** 眼睛在球面上的半张角，单位为度（总间距约 31 度）。 */
+export declare const EYE_SPLIT = 15.46;
+/** 静止状态下眼睛的尺寸，单位为球的半径。 */
+export declare const EYE_W = 0.186;
+export declare const EYE_H = 0.412;
+/** 静止状态下的头部朝向，依据参考帧拟合得出。 */
+export declare const REST_GAZE: HeadGaze;
+export interface EyePose {
+    x: number;
+    y: number;
+    /** 2x2 切向矩阵：[a b c d]，含义同 SVG 的 matrix(a,b,c,d,e,f) */
+    a: number;
+    b: number;
+    c: number;
+    d: number;
+    /** 法线的 z 分量：> 0 表示该面可见 */
+    depth: number;
+}
+export interface HeadGaze {
+    /** 偏航角，单位为度，正值表示向右看 */
+    yaw: number;
+    /** 俯仰角，单位为度，正值表示向上看 */
+    pitch: number;
+    /** 滚转角，单位为度，表示头部倾斜 */
+    roll: number;
+}
+/**
+ * 先是头部的坐标系，然后是两只眼睛的坐标系。
+ * 屏幕坐标系：x 向右，y 向下，z 指向观察者。
+ * 索引 0 是内侧眼，索引 1 是外侧眼。
+ */
+export declare function eyePoses(gaze: HeadGaze, scale: number, split?: number): [EyePose, EyePose];
+/**
+ * 嘴巴落在球面上时位于眼睛下方的角度，单位为度。
+ *
+ * 这是选择出来的，而非测量出来的：参考视频中没有嘴巴。
+ * 只要它保持在球面的前侧并位于眼睛下方即可，也就是处于
+ * 与向下看相同的范围内。
+ */
+export declare const MOUTH_DOWN = 28;
+/**
+ * 嘴巴在球面上的位置，采用与眼睛相同的正交投影：
+ * forward 向下旋转 `MOUTH_DOWN` 度，宽度沿 `right` 方向，
+ * 高度沿 `down` 方向。只有一个点，而不是两个。
+ */
+export declare function mouthPose(gaze: HeadGaze, scale: number): EyePose;
+/**
+ * 静止状态下的生命力：视线的缓慢漂移、扫视、眨眼。
+ *
+ * 时间的纯函数（没有内部状态），因此暂停、恢复以及跳到
+ * 任意时间点都会得到相同的画面。这些数值是要
+ * 加到当前状态姿态上的偏移量。
+ */
+export interface Liveliness {
+    dYaw: number;
+    dPitch: number;
+    dRoll: number;
+    /** 1 = 眼睛睁开，0 = 闭合（屏幕坐标系中的垂直压扁） */
+    lid: number;
+    driftX: number;
+    driftY: number;
+    breath: number;
+}
+export interface LivelinessOptions {
+    wander?: number;
+    blink?: boolean;
+    float?: boolean;
+}
+export declare function liveliness(t: number, opt?: LivelinessOptions): Liveliness;
+/**
+ * 眨眼是屏幕坐标系中围绕眼睛中心的垂直压扁
+ * （测量结果：bbox 的宽度保持不变，高度降到约 0.35），
+ * 而不是沿胶囊倾斜轴的收缩。因此我们在切向矩阵之后
+ * 再合成它，只影响 y 方向上的输出。
+ */
+export declare function blinkScale(lid: number): number;

package/dist/types/bot/math.d.ts

@@ -0,0 +1,21 @@
+export declare const TAU: number;
+export declare const clamp: (v: number, lo?: number, hi?: number) => number;
+export declare const lerp: (a: number, b: number, t: number) => number;
+export type Easing = (t: number) => number;
+/**
+ * 视频上的测量结果：过渡都是指数型的 ease-out，不会超出
+ * 身体范围。仅有的弹簧效果都是局部的（通知圆点的弹出、
+ * 眼睛的睁开），并且直接写在
+ * 相关的状态中。
+ */
+export declare const easings: {
+    easeOutCubic: (t: number) => number;
+    easeInOutCubic: (t: number) => number;
+    easeOutQuint: (t: number) => number;
+};
+/** 周期性一维噪声：在 `period` 上无缝循环，用于视线的漂移。 */
+export declare function loopNoise(t: number, period: number, seed?: number): number;
+/** 确定性 PRNG（mulberry32）：每次读取都产生相同的序列。 */
+export declare function createRng(seed: number): () => number;
+/** 短舍入：将 60 fps 下生成的 path 字符串的体积大约减半。 */
+export declare const r2: (v: number) => number;

package/dist/types/bot/profiles.d.ts

@@ -0,0 +1,7 @@
+export declare const PROFILE_SAMPLES = 64;
+export declare const PROFILES: {
+    readonly egg: readonly [0.8369, 0.8424, 0.8497, 0.8585, 0.8674, 0.8775, 0.8878, 0.8983, 0.9089, 0.9185, 0.9288, 0.9374, 0.9445, 0.9504, 0.9543, 0.9559, 0.9555, 0.9519, 0.9466, 0.9389, 0.9302, 0.9193, 0.9085, 0.8969, 0.8852, 0.8734, 0.8625, 0.8513, 0.8411, 0.8325, 0.8243, 0.8179, 0.8137, 0.8112, 0.8102, 0.8128, 0.8178, 0.8262, 0.8374, 0.8518, 0.8702, 0.8922, 0.9169, 0.9446, 0.9741, 1.0023, 1.0267, 1.0433, 1.0481, 1.0393, 1.0216, 0.997, 0.9697, 0.9418, 0.9169, 0.8949, 0.876, 0.8604, 0.849, 0.8394, 0.8337, 0.8314, 0.8305, 0.8326];
+    readonly hexagon: readonly [0.921, 0.9282, 0.9441, 0.9706, 0.9984, 1.0059, 0.9896, 0.9562, 0.929, 0.9124, 0.9047, 0.9058, 0.9157, 0.9349, 0.9642, 0.9873, 0.9882, 0.9665, 0.9336, 0.9105, 0.8968, 0.8918, 0.8955, 0.908, 0.9293, 0.9611, 0.982, 0.9812, 0.959, 0.9282, 0.9089, 0.8978, 0.8964, 0.9026, 0.9189, 0.9439, 0.9778, 0.999, 0.9964, 0.9713, 0.9439, 0.9274, 0.9196, 0.9206, 0.9308, 0.9502, 0.9799, 1.0121, 1.0226, 1.0071, 0.9752, 0.951, 0.9366, 0.9316, 0.9351, 0.9485, 0.9711, 1.0026, 1.0213, 1.0155, 0.9863, 0.9547, 0.9347, 0.9232];
+    readonly triangle: readonly [0.7819, 0.8211, 0.8747, 0.944, 1.0223, 1.096, 1.1401, 1.134, 1.0808, 1.0047, 0.9265, 0.8603, 0.8104, 0.773, 0.745, 0.7273, 0.7151, 0.7118, 0.7148, 0.7245, 0.7427, 0.768, 0.8037, 0.8518, 0.9148, 0.9876, 1.0583, 1.1073, 1.1109, 1.0667, 0.994, 0.9164, 0.8482, 0.7948, 0.7555, 0.7261, 0.7056, 0.6925, 0.6859, 0.6869, 0.6938, 0.7084, 0.7305, 0.7615, 0.804, 0.8595, 0.9311, 1.0092, 1.0791, 1.1171, 1.1054, 1.0501, 0.9779, 0.905, 0.845, 0.799, 0.7656, 0.7413, 0.7258, 0.716, 0.7146, 0.7204, 0.733, 0.7528];
+};
+export type ProfileName = keyof typeof PROFILES;

package/dist/types/bot/repere.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 引擎所渲染一切内容的基准。
+ *
+ * `engine.sample()` 输出以 viewBox 为单位的坐标，而这两个数字就是它的定义：
+ * 没有它们，引擎的输出就没有任何意义。它们原本住在 `BloubBot.vue` 里，因此无法被引用——
+ * 一个 `<script setup>` 不导出任何东西——而 `export.ts` 又手动重复定义了其中一个，
+ * 并附上了指明该问题的注释。
+ *
+ * 它们之所以在这里，是因为 `src/bot/` 是供外部读取和消费的：Vue 组件只是引擎的
+ * 一个客户端，而不是它的定义。
+ */
+/**
+ * 球体静止时的半径，以 viewBox 为单位。它就是组件传给 `BotEngine` 的 `scale`。
+ *
+ * 这是选定值而非测量值：它是工作单位。目录中其余所有内容都以该半径的分数来表示，
+ * 这使从视频测得的数值与显示尺寸无关。
+ */
+export declare const RAYON = 100;
+/**
+ * 所显示 viewBox 的半边长。半径之外的边距用于容纳圆环。
+ *
+ * 这不是一个随意值：轨道的圆环和彗星的 swoosh 最高到达半径的 1.4 倍，即 140。
+ * 运行时不设任何限制——正是对 `RINGS` 和 `SWOOSH`（`decor.ts`）数组的手动调整
+ * 让它们保持在 158 以内，并且有一个测试来锁定这一点。
+ */
+export declare const DEMI_VIEWBOX = 158;