@sliiu/present-three-bake 0.0.0-stage → 0.1.0

package/dist/types/presets.d.ts

@@ -0,0 +1,23 @@
+export interface CameraPreset {
+    /** 纬度（俯仰），度。负值=相机在物体上方俯视（"Above" 类语义）。 */
+    lat: number;
+    /** 经度（偏航），度。 */
+    lon: number;
+    /** 自转，度。 */
+    rev: number;
+    /** 视场角，度。<1 视为正交投影。 */
+    fov: number;
+}
+export declare const CAMERA_PRESETS: Record<string, CameraPreset>;
+export declare const FOV_LOCKED_PRESETS: Set<string>;
+/**
+ * ECMA-376 §20.1.5.4：`<a:bevelT/>` / `<a:bevelB/>` 缺省 w/h = 76200 EMU。
+ * 76200 ÷ 9525 EMU/px = 8 px。parser 把缺省留 undefined，这里补默认。
+ */
+export declare const DEFAULT_BEVEL_PX = 8;
+/** ECMA-376 §20.1.5.12 sp3d/@prstMaterial 默认 = warmMatte。 */
+export declare const DEFAULT_MATERIAL = "warmMatte";
+/** ECMA-376 §20.1.5.9 lightRig 缺省（无 scene3d 时）我们用 threePt 兜底。 */
+export declare const DEFAULT_LIGHT_RIG = "threePt";
+/** PerspectiveCamera 缺省 fov（无 preset 也无显式 fov 时）。 */
+export declare const DEFAULT_FOV = 35;

package/dist/types/resolve.d.ts

@@ -0,0 +1,67 @@
+import type { Backdrop3D, Camera3D, LightRig3D, Sp3DInfo, Sp3DParams } from "@sliiu/present-core";
+export interface ResolvedCamera {
+    lat: number;
+    lon: number;
+    rev: number;
+    /** 度；<1 视为正交。 */
+    fov: number;
+    isOrtho: boolean;
+    /** 倍率（1 = 100%），undefined = 不缩放。 */
+    zoom?: number;
+}
+export interface ResolvedBevel {
+    /** px，已补默认。 */
+    w: number;
+    h: number;
+}
+export interface ResolvedSp3D {
+    /** px，原始 extrusionH（缺省 0）。 */
+    extrusionH: number;
+    contourW?: number;
+    contourClr?: string;
+    extrusionClr?: string;
+    /** 已补默认（warmMatte）。 */
+    prstMaterial: string;
+    /** 仅当 XML 写了 `<a:bevelT>` 才有；w/h 已补默认。 */
+    bevelT?: ResolvedBevel;
+    bevelB?: ResolvedBevel;
+    /** bevelT/bevelB 任一存在（即声明了倒角）。 */
+    hasBevel: boolean;
+}
+export interface ResolvedLightRig {
+    /** 已补默认（threePt）。 */
+    rig: string;
+    dir?: string;
+}
+export interface ResolvedScene3D {
+    camera: ResolvedCamera;
+    sp3d: ResolvedSp3D;
+    lightRig: ResolvedLightRig;
+    /** undefined = OOXML 未写或 identity（+Z / +Y），相机保持 preset 朝向。 */
+    backdrop?: ResolvedBackdrop;
+}
+export interface ResolvedBackdrop {
+    target: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** 单位法向；identity (+Z) 时省略。 */
+    forward?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** 单位 up；identity (+Y) / 零向量时省略。 */
+    up?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+}
+export declare function resolveCamera(cam: Camera3D | undefined): ResolvedCamera;
+export declare function resolveSp3D(sp3d: Sp3DParams | undefined): ResolvedSp3D;
+export declare function resolveLightRig(lr: LightRig3D | undefined): ResolvedLightRig;
+/** identity / 全 0 → undefined，setupCamera 保持 preset 朝向。 */
+export declare function resolveBackdrop(bd: Backdrop3D | undefined): ResolvedBackdrop | undefined;
+export declare function resolveScene3D(info: Sp3DInfo): ResolvedScene3D;

package/dist/types/runtime.d.ts

@@ -0,0 +1,22 @@
+import type { Shape, Slide, Sp3DInfo } from "@sliiu/present-core";
+import type { Shape3DResult } from "./types.js";
+/**
+ * 该 3D 信息是否需要 3D 渲染（实时 or 烘焙）。parser 现在对 `<a:bevelT/>` 留空 w/h，
+ * 所以用「是否声明了 bevel 元素」判断，而非 h>0。
+ */
+export declare function needs3DRender(meta: Sp3DInfo | undefined): boolean;
+export declare function needs3DBake(s: Shape): boolean;
+export interface Bake3DRuntime {
+    /**
+     * 扫描 slide，找出需要烘焙的 3D shape 异步烘焙。同一 shape.id 不会重复。
+     * `applyBaked` 在烘焙完成时被调用，由调用方负责把结果写入副通道并按需触发 redraw。
+     */
+    kick(slide: Slide, applyBaked: (s: Shape, result: Shape3DResult) => void, opts?: {
+        frontImageSrc?: (s: Shape) => string | undefined;
+    }): void;
+    /** 等待所有 pending 烘焙完成（截图前调）。 */
+    waitForAll(): Promise<void>;
+    /** 标记 shape.id 已处理过（跨重建避免重复）。 */
+    markBaked(id: string): void;
+}
+export declare function createBake3DRuntime(): Bake3DRuntime;

package/dist/types/scene-builder.d.ts

@@ -0,0 +1,35 @@
+import * as THREE from "three";
+import type { Paint, Stroke } from "@sliiu/present-core";
+import type { ResolvedBackdrop, ResolvedCamera, ResolvedScene3D } from "./resolve.js";
+export interface BuildSceneInputs {
+    /** 几何基准尺寸（px）= shape bbox。 */
+    baseW: number;
+    baseH: number;
+    pathD?: string;
+    fill?: Paint;
+    stroke?: Stroke;
+    resolved: ResolvedScene3D;
+    /** image shape 的正面贴图（已加载 + 已按 cropRect 裁 UV）。 */
+    texture?: THREE.Texture | null;
+    /** 是否 image shape（决定 slab 几何 + 贴图保色路径）。 */
+    isImage: boolean;
+}
+export interface BuiltScene {
+    scene: THREE.Scene;
+    /** 几何在世界坐标的宽/高（用于相机 fit）。 */
+    geoW: number;
+    geoH: number;
+    dispose(): void;
+}
+export declare function buildThreeScene(inputs: BuildSceneInputs): BuiltScene;
+/**
+ * 把相机摆到「物体在 viewW×viewH 视口里接近 1:1（含 pad 余量）」的距离并构建 THREE 相机。
+ * offscreen 与 live 共用：offscreen 传 padded canvas 尺寸；live 传显示像素尺寸。
+ */
+export declare function createSceneCamera(cam: ResolvedCamera, geoW: number, geoH: number, viewW: number, viewH: number, pad: number, backdrop?: ResolvedBackdrop): THREE.Camera;
+/**
+ * 若 src 对应图片此前已被 loadImageTexture 解码过，则同步返回一个新 Texture；否则
+ * 返回 null（调用方需走异步 loadImageTexture）。用于热路径（拖动重建）下零延迟首渲。
+ */
+export declare function getCachedImageTexture(src: string): THREE.Texture | null;
+export declare function loadImageTexture(src: string): Promise<THREE.Texture | null>;

package/dist/types/shape-path.d.ts

@@ -0,0 +1,15 @@
+import type { Shape, Sp3DInfo } from "@sliiu/present-core";
+/** 与 bake-sp3d 的 image pad 一致：贴图几何收在 bbox 内。 */
+export declare const IMAGE_3D_PAD = 0.05;
+/** 与 bake-sp3d 的非 image pad 一致：倒角会对称外扩。 */
+export declare const SHAPE_3D_PAD = 0.15;
+export declare function shapeSupports3D(s: Shape): boolean;
+export declare function shape3DPad(kind: Shape["kind"]): number;
+/** 形状上真正参加 3D 的那份参数。文字只看 bodyPr，避免和形状自己的 spPr 3D 各挤出一次。 */
+export declare function shape3DInfo(s: Shape): Sp3DInfo | undefined;
+/**
+ * 非 image 形状的挤出轮廓，坐标系是形状本地的 0..bbox。
+ * image 不需要轮廓（正面是贴图 slab）。rect 也不返回：scene-builder 在没有 pathD
+ * 时已经按 bbox 挤出一个矩形。path 的 `d` 原样传入，由场景构建器按路径自身包围盒居中。
+ */
+export declare function shape3DPathD(s: Shape): string | undefined;

package/dist/types/types.d.ts

@@ -0,0 +1 @@
+export type { Bevel3D, Sphere3D, Sp3DParams, Camera3D, LightRig3D, Backdrop3D, Scene3DParams, Sp3DInfo, Shape3DRequest, Shape3DResult, Baker, } from "@sliiu/present-core";

package/package.json

@@ -1,6 +1,32 @@
 {
   "name": "@sliiu/present-three-bake",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "license": "AGPL-3.0-or-later",
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    }
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "three": "^0.186.0",
+    "@sliiu/present-core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/three": "^0.186.0"
+  },
+  "module": "./dist/esm/index.js",
+  "files": [
+    "dist",
+    "LICENSE",
+    "COPYRIGHT",
+    "THIRD-PARTY-NOTICES.md"
+  ]
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.