@sliiu/present-renderer 0.0.0-stage → 0.1.1

package/dist/types/svg-backend.d.ts

@@ -0,0 +1,88 @@
+import type { Shape } from "@sliiu/present-core";
+import { type Scene } from "./scene-node.js";
+export interface SvgBackendOptions {
+    shapeFilter?: (s: Shape) => boolean;
+    transparent?: boolean;
+    /**
+     * Thumbnail / sorter / presenter preview. Video, audio, and web embeds
+     * become static placeholders — no live `<iframe>` or media element.
+     * Cross-origin iframes swallow pointer events (the parent never sees the
+     * click) and would load YouTube/Vimeo in every visible thumbnail.
+     */
+    preview?: boolean;
+    /**
+     * 默认按幻灯片视口裁切。编辑器普通视图传 false，让伸出幻灯片的形状
+     * 画到周围的灰色工作区。放映、缩略图、阅读视图保持裁切。
+     */
+    clipToSlide?: boolean;
+}
+export declare class SvgBackend {
+    readonly root: SVGSVGElement;
+    private defs;
+    private bindings;
+    private scene;
+    private readonly uid;
+    private rafId;
+    private dispose;
+    private shapeFilter;
+    private preview;
+    private measureCtx;
+    private textFxSeq;
+    private textInnerFilters;
+    private getMeasureCtx;
+    constructor(scene: Scene, container: HTMLElement, opts?: SvgBackendOptions);
+    private scheduleRedraw;
+    /**
+     * 同步刷新当前 scene 到 DOM，并取消 pending rAF。
+     * 主要用于编辑器中切换/重建 backend 时，确保新 backend 的视觉在旧 backend
+     * 被销毁前已经写入 DOM，避免出现"先空一帧再绘制"的闪屏。
+     */
+    flush(): void;
+    private mount;
+    private createShapeEl;
+    private redraw;
+    private applyShapeEffects;
+    private ensureEffectFilter;
+    private applyReflection;
+    /** 离屏 3D：用 baked PNG 替换矢量或文字。image 的未烘焙分支仍走 applyShapeAttrs。 */
+    private paintBaked3D;
+    private applyShapeAttrs;
+    private renderMedia;
+    private renderWebEmbed;
+    private renderPreviewPoster;
+    /** Static tile used when `preview` is on — no live iframe / video / audio. */
+    private renderMediaPlaceholder;
+    private renderText;
+    /**
+     * 艺术字：把已画出的墨迹外接矩形拉到形状框。
+     */
+    private applyWordArtFit;
+    /** 字形墨迹，不含 em 方框上下的空档。getBBox 含整格，拉满后笔画仍缩在框里。 */
+    private wordArtInkBox;
+    private wordArtFallbackBox;
+    private renderTextWarped;
+    private renderTextHorizontal;
+    private layoutParagraphHoriz;
+    private distributeParagraphsAcrossColumns;
+    private renderHorizontalParagraph;
+    private renderTextStacked;
+    private renderStackedColumn;
+    /**
+     * Run-level innerShdw / reflection. Outer shadow and glow stay on the CSS
+     * filter from pickRunEffectsCssFilter. Inner shadow is an SVG filter; reflection
+     * is a mirrored <use> under the paragraph.
+     */
+    private attachTextRunEffects;
+    private ensureTextInnerFilter;
+    private renderBullet;
+    private applyRunStyle;
+    private renderParaSegmented;
+    private renderTextRunsWithOverrides;
+    private applyImageClip;
+    private removeImageClip;
+    private applyImageStroke;
+    private applyCharClip;
+    private applyParaClip;
+    private applyClip;
+    destroy(): void;
+}

package/dist/types/text-autofit.d.ts

@@ -0,0 +1,7 @@
+import type { TextShape } from "@sliiu/present-core";
+export declare function scaleTextShapeForAutofit(s: TextShape, scale: number): TextShape;
+/**
+ * normAutofit 文本溢出时返回缩小后的派生 shape；不溢出（或非 normAutofit）原样返回。
+ * measureTotalH 由调用方注入（svg / canvas 后端的段落排版逻辑不同但签名一致）。
+ */
+export declare function autofitTextShape(s: TextShape, innerH: number, measureTotalH: (shape: TextShape) => number): TextShape;

package/dist/types/text-hit.d.ts

@@ -0,0 +1,7 @@
+import type { HyperlinkRef, Shape, TextRun } from "@sliiu/present-core";
+/**
+ * 按与渲染层相同的换行 / 对齐 / 边距，命中文字框内某个 run。
+ * 竖排堆叠走列布局；`vert`/`vert270`/`bodyRot` 先把点逆旋转到布局坐标系。
+ */
+export declare function hitTestTextRunAt(shape: Shape, x: number, y: number): TextRun | undefined;
+export declare function runLinkAt(shape: Shape, x: number, y: number, slot: "hyperlink" | "hoverLink"): HyperlinkRef | undefined;

package/dist/types/text-layout.d.ts

@@ -0,0 +1,35 @@
+import type { FieldResolveContext, TextParagraph, TextRun } from "@sliiu/present-core";
+export declare function isEastAsianChar(cp: number): boolean;
+export declare function mapVisualAlign(align: NonNullable<TextParagraph["align"]>, rtl: boolean): "start" | "middle" | "end" | "justify";
+export declare function mapVisualAlignWithAnchorCtr(s: {
+    anchorCtr?: boolean;
+    paragraphs?: {
+        length: number;
+    };
+    cellMeta?: unknown;
+}, p: {
+    align?: TextParagraph["align"];
+    rtl?: boolean;
+}): "start" | "middle" | "end" | "justify";
+export type Token = {
+    text: string;
+    kind: "word" | "ws" | "cjk" | "tab";
+};
+/** Glue prohibited line-start / line-end characters to their CJK neighbour so they wrap together. */
+export declare function applyKinsoku(tokens: Token[]): Token[];
+/** eaLnBrk 为假：相邻汉字粘成一块，标点后面仍可断。调用前先走过禁则。 */
+export declare function glueUnbrokenEastAsian(tokens: Token[]): Token[];
+export interface VisualLine {
+    segments: Array<{
+        run: TextRun;
+        text: string;
+        width: number;
+    }>;
+    width: number;
+    /** 行末挂在边外的标点宽度。对齐用 width - hang。 */
+    hang: number;
+    height: number;
+    ascent: number;
+    maxFs: number;
+}
+export declare function wrapParagraphIntoLines(p: TextParagraph, maxWidth: number, fallbackFs: number, ctx: CanvasRenderingContext2D, firstLineMaxWidth: number, noWrap: boolean, fieldCtx?: FieldResolveContext, compatLnSpc?: boolean): VisualLine[];

package/dist/types/text-shared.d.ts

@@ -0,0 +1,86 @@
+import type { BulletDef, ShapeEffect, TextParagraph } from "@sliiu/present-core";
+/**
+ * §21.1.2.1.1 bodyPr@lIns/tIns/rIns/bIns 的 OOXML 缺省值：
+ * 左右 91440 EMU = 7.2pt ≈ 9.6px，上下 45720 EMU = 3.6pt ≈ 4.8px。
+ */
+export declare const DEFAULT_TEXT_INSETS: {
+    readonly l: 9.6;
+    readonly t: 4.8;
+    readonly r: 9.6;
+    readonly b: 4.8;
+};
+/** 未写 lnSpc 时的行框系数。§21.1.2.2.5 只说由字号决定，这里取 1.2。 */
+export declare const DEFAULT_LINE_HEIGHT_FACTOR = 1.2;
+/** 继承链都没写 sz 时的绘制字号（px）。schema 不给 sz 缺省值；Office 用 18pt。 */
+export declare const FALLBACK_FONT_SIZE: number;
+export type VertMode = NonNullable<import("@sliiu/present-core").TextShape["vert"]>;
+/**
+ * §21.1.2.1.1 bodyPr@vert — 整框旋转角度。
+ * 仅 vert/vert270 走"外层 rotate"路径；其余竖排模式靠自定义竖排 layout。
+ */
+export declare function vertRotateDeg(v: VertMode | undefined): number;
+export declare function isVerticalStack(v: VertMode | undefined): v is "wordArtVert" | "wordArtVertRtl" | "eaVert" | "mongolianVert";
+/**
+ * 竖排堆叠的列推进方向。
+ * wordArtVertRtl = 从右到左（WPS「行顺序：从右到左」）。
+ * wordArtVert = 从左到右（WPS「行顺序：从左到右」）。rtlCol 对这两种 vert 无效。
+ */
+export declare function stackedColumnsLtr(vert: "wordArtVert" | "wordArtVertRtl" | "eaVert" | "mongolianVert", rtlCol?: boolean): boolean;
+/**
+ * §21.1.2.1.1 bodyPr@rot / @vert / @upright 叠加后，文字内容相对 slide 的总旋转角。
+ * 渲染端把 shape 自身的 rotation 加在 scene node 上、把 bodyRot+vert 加在文本组上，
+ * upright 再抵消掉 shape 的 rotation —— 三者之和就是文字最终看起来的旋转角度。
+ */
+export declare function textTotalRotationDeg(s: {
+    transform?: {
+        rotation?: number;
+    };
+    bodyRot?: number;
+    vert?: VertMode;
+    upright?: boolean;
+}): number;
+/** 段落缺省字号：取段内最大显式字号，全缺省时用 FALLBACK_FONT_SIZE。 */
+export declare function paragraphFallbackFontSize(p: TextParagraph): number;
+/**
+ * §21.1.2.2.5 spcPct 是最大字号的百分比：120000 = 1.2 × 字号，不再乘第二层系数。
+ * 未写 lnSpc 时用 DEFAULT_LINE_HEIGHT_FACTOR；compatLnSpc 时按 1 × 字号。
+ */
+export declare function lineHeightFactor(p: TextParagraph, compatLnSpc?: boolean): number;
+/** 段落行高（px）：显式 lineHeightPx 优先，否则按 §21.1.2.2.5 的百分比系数算。 */
+export declare function paragraphLineHeightPx(p: TextParagraph, fallbackFs?: number, compatLnSpc?: boolean): number;
+export interface BulletNumState {
+    lastLevel: number;
+    lastType: string;
+    count: number;
+}
+export declare function newBulletNumState(): BulletNumState;
+/** §21.1.2.4.1 buAutoNum@type — 把序号按 ST_TextAutonumberScheme 格式化。 */
+export declare function formatBulletNumber(n: number, type: string): string;
+/**
+ * §21.1.2.4.5 buSzPts 优先于 §21.1.2.4.4 buSzPct；两者都缺省时跟随 run 字号（buSzTx）。
+ */
+export declare function bulletFontSize(bullet: BulletDef, runFs: number): number;
+/**
+ * 推进自动编号状态机，返回该段 bullet 的显示文本。
+ * none / picture 返回 null（picture bullet 由各消费者自行绘制图片）。
+ *
+ * 编号连续性规则：连续的同 level buAutoNum 段落累加；一旦遇到 buChar / buNone /
+ * level 变化就重置，与 PowerPoint 表现一致。
+ */
+export declare function advanceBulletLabel(p: TextParagraph, state: BulletNumState): string | null;
+export declare function hexWithAlpha(color: string, alpha: number): string;
+/**
+ * §21.1.2.3.9 rPr/effectLst → CSS `filter` 串（drop-shadow 链式叠加）。
+ *
+ * `scale` 用来把 slide 单位换算成目标坐标系的 px：SVG 里 filter 走 user-space
+ * 会随 viewBox 自动缩放，所以后端传 1；HTML overlay（编辑器）按屏幕 px 绘制，
+ * 必须传当前 stageScale，否则缩放后阴影 / 光晕的偏移和模糊半径会明显不对。
+ *
+ * inner shadow 与 reflection 不走这条 CSS 链：SVG 用 feComposite / 镜像 <use>，
+ * Canvas 在 drawText 里单独画。这里若把 reflection 收成 drop-shadow，倒影会变成一团光。
+ */
+export declare function textEffectsCssFilter(effects: ShapeEffect[] | undefined, scale?: number): string | undefined;
+/** 取 paragraph 内首个声明 effects 的 run 的 CSS filter（paragraph 级近似）。 */
+export declare function pickRunEffectsCssFilter(runs: ReadonlyArray<{
+    effects?: ShapeEffect[];
+}>, scale?: number): string | undefined;

package/dist/types/text-stacked.d.ts

@@ -0,0 +1,11 @@
+import type { FieldResolveContext, TextParagraph, TextRun } from "@sliiu/present-core";
+import type { ParaOverride } from "./scene-node.js";
+export interface StackedGlyph {
+    ch: string;
+    run: TextRun;
+    fontSize: number;
+    stepY: number;
+    upright: boolean;
+}
+export declare function buildStackedGlyphs(p: TextParagraph, para: ParaOverride | undefined, vert: "wordArtVert" | "wordArtVertRtl" | "eaVert" | "mongolianVert", fieldCtx?: FieldResolveContext): StackedGlyph[];
+export declare function wrapGlyphsIntoColumns(glyphs: StackedGlyph[], maxH: number): StackedGlyph[][];

package/dist/types/text-warp.d.ts

@@ -0,0 +1,37 @@
+import type { TextRun, TextShape } from "@sliiu/present-core";
+export interface WarpSample {
+    x: number;
+    y: number;
+    angle: number;
+    /** Pour 内外路径间距（px）。有值时 glyph 沿法向拉伸填满环带。 */
+    radial?: number;
+}
+export interface WarpGlyph {
+    ch: string;
+    x: number;
+    y: number;
+    angle: number;
+    scaleY: number;
+    run: TextRun;
+    fontSize: number;
+}
+export declare function warpActive(s: TextShape): boolean;
+/** 在文字框内生成 warp 基线采样（沿路径从左到右）。 */
+export declare function sampleWarpPath(prst: string, box: {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}, avLst?: Record<string, number>): WarpSample[];
+export declare function placeGlyphsOnWarp(glyphs: Array<{
+    ch: string;
+    width: number;
+    run: TextRun;
+    fontSize: number;
+}>, samples: WarpSample[], prst?: string): WarpGlyph[];
+export declare function flattenWarpGlyphs(s: TextShape, measure: (run: TextRun, text: string) => number): Array<{
+    ch: string;
+    width: number;
+    run: TextRun;
+    fontSize: number;
+}>;

package/dist/types/text-wordart.d.ts

@@ -0,0 +1,18 @@
+export interface WordArtBox {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+export interface WordArtFit {
+    sx: number;
+    sy: number;
+    tx: number;
+    ty: number;
+}
+/**
+ * 把已排好的墨迹框映射到形状框。
+ * 变换顺序是先缩放再平移：`x' = x * sx + tx`。
+ * 近乎 1:1 或比例离谱时返回 null，调用方保持原排版。
+ */
+export declare function wordArtFitTransform(ink: WordArtBox, box: WordArtBox): WordArtFit | null;

package/dist/types/video-frame.d.ts

@@ -0,0 +1,2 @@
+export declare function getVideoPosterFrame(src: string, onReady?: () => void, seekTo?: number): HTMLImageElement | null;
+export declare function waitForVideoFrames(timeoutMs?: number): Promise<void>;

package/dist/types/webgl-model3d-backend.d.ts

@@ -0,0 +1,25 @@
+import type { Shape } from "@sliiu/present-core";
+import type { Scene } from "./scene-node.js";
+export interface WebGLModel3DBackendOptions {
+    shapeFilter?: (s: Shape) => boolean;
+    interactive?: boolean;
+}
+export declare class WebGLModel3DBackend {
+    private space;
+    private managed;
+    private dispose;
+    private k;
+    private rafId;
+    private readyResolvers;
+    constructor(scene: Scene, container: HTMLElement, opts?: WebGLModel3DBackendOptions);
+    private add;
+    private bindOrbit;
+    private syncWrapper;
+    private scheduleRender;
+    private renderAll;
+    private resolveReady;
+    orbitModel3D(shapeId: string, dLon: number, dLat: number): boolean;
+    flush(): void;
+    whenReady(): Promise<void>;
+    destroy(): void;
+}

package/dist/types/webgl-shape-backend.d.ts

@@ -0,0 +1,33 @@
+import type { Shape } from "@sliiu/present-core";
+import type { Scene } from "./scene-node.js";
+export interface WebGLShapeBackendOptions {
+    shapeFilter?: (s: Shape) => boolean;
+}
+export declare class WebGLShapeBackend {
+    private scene;
+    private space;
+    private managed;
+    private dispose;
+    private dpr;
+    private k;
+    private rafId;
+    private ro;
+    private readyResolvers;
+    constructor(scene: Scene, container: HTMLElement, opts?: WebGLShapeBackendOptions);
+    private add;
+    /** 用（可能为空的）贴图构建 three 场景 + 相机，写回 managed 并触发首渲。 */
+    private buildManaged;
+    private getRenderer;
+    private scheduleSync;
+    private syncTransforms;
+    private syncOne;
+    private scheduleGlRender;
+    private glRenderAll;
+    private glRenderOne;
+    flush(): void;
+    /** 所有 3D shape 的贴图都加载完、场景已构建并首渲后 resolve（截图前等待用）。 */
+    whenReady(): Promise<void>;
+    private isReady;
+    private checkReady;
+    destroy(): void;
+}

package/package.json

@@ -1,6 +1,45 @@
 {
   "name": "@sliiu/present-renderer",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "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": {
+    "emf-converter": "^4.8.0",
+    "three": "^0.186.0",
+    "@sliiu/present-animation": "0.1.1",
+    "@sliiu/present-core": "0.1.1",
+    "@sliiu/present-three-bake": "0.1.1"
+  },
+  "devDependencies": {
+    "@types/three": "^0.186.0"
+  },
+  "module": "./dist/esm/index.js",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sliiu/slimoffice.git",
+    "directory": "present/renderer"
+  },
+  "homepage": "https://github.com/sliiu/slimoffice/tree/main/present/renderer",
+  "bugs": {
+    "url": "https://github.com/sliiu/slimoffice/issues"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "COPYRIGHT",
+    "THIRD-PARTY-NOTICES.md"
+  ]
+}