@agile-team/mach-report 0.5.0 → 0.7.0

package/dist/textwrap-DWzM7pt1.d.cts

@@ -1,135 +0,0 @@
-type ComponentKind = "text" | "image" | "barcode" | "qrcode" | "chart" | "line" | "rect" | "ellipse";
-interface ComponentStyle {
-    fontSizePx?: number;
-    fontSize?: number;
-    fontFamily?: string;
-    bold?: boolean;
-    italic?: boolean;
-    underline?: boolean;
-    color?: string;
-    backgroundColor?: string;
-    align?: "left" | "center" | "right" | "justify";
-    verticalAlign?: "top" | "middle" | "bottom";
-    lineColor?: string;
-    borderColor?: string;
-    lineWidthPt?: number;
-    borderTop?: boolean;
-    borderRight?: boolean;
-    borderBottom?: boolean;
-    borderLeft?: boolean;
-    lineHeight?: number;
-    letterSpacing?: number;
-    opacity?: number;
-    rotateDeg?: number;
-}
-interface RichParagraph {
-    segments: RichSegment[];
-    align?: ComponentStyle["align"];
-    lineHeight?: number;
-    spaceBeforeMm?: number;
-    spaceAfterMm?: number;
-    indentMm?: number;
-}
-interface RichSegment {
-    kind?: "text" | "field";
-    text?: string;
-    field?: string;
-    style?: ComponentStyle;
-}
-interface GridCell {
-    text?: string;
-    rawText?: string;
-    children?: PlanComponent[];
-    colSpan?: number;
-    rowSpan?: number;
-    style?: ComponentStyle;
-}
-interface PlanGrid {
-    /** 行内允许 null 空位（jh4j 契约数据存在稀疏行；渲染器按空单元格处理） */
-    cells: (GridCell | null)[][];
-    colWidthsMm?: number[];
-    rowHeightsMm?: number[];
-    gapMm?: number;
-}
-interface PlanComponent {
-    kind: ComponentKind;
-    leftMm: number;
-    topMm: number;
-    widthMm: number;
-    heightMm: number;
-    nid?: string;
-    rkey?: string;
-    text?: string;
-    rawText?: string;
-    lines?: string[];
-    richParagraphs?: RichParagraph[];
-    imageData?: string;
-    grid?: PlanGrid;
-    style?: ComponentStyle;
-    meta?: Record<string, unknown>;
-    /** MachReport 扩展字段：未知 kind 的兜底渲染标记 */
-    fallbackText?: string;
-}
-interface PlanPage {
-    pageWidthMm: number;
-    pageHeightMm: number;
-    marginTopMm?: number;
-    marginBottomMm?: number;
-    marginLeftMm?: number;
-    marginRightMm?: number;
-    components: PlanComponent[];
-}
-interface GridPlanResponse {
-    code?: number;
-    message?: string;
-    data?: {
-        pages?: PlanPage[];
-    } | null;
-}
-interface RenderPlan {
-    schemaVersion: string;
-    pages: PlanPage[];
-}
-declare const RENDER_PLAN_SCHEMA_VERSION = "1.0.0-mach";
-declare function toRenderPlan(response: GridPlanResponse): RenderPlan;
-declare function isImageBackedComponent(comp: PlanComponent): boolean;
-declare function isRichText(comp: PlanComponent): boolean;
-
-/**
- * 文本测量与折行（分页/Canvas/PDF 共用的唯一折行真相源）。
- *
- * 测量模型可注入（TextMeasurer）：
- * - 默认 createHeuristicMeasurer()：CJK/拉丁宽度启发式（零依赖、Node 可用）
- * - 浏览器端可注入 createCanvasMeasurer()（真字体 metrics，消除三端折行差异）
- */
-interface TextMeasureOptions {
-    fontSizePt: number;
-    bold?: boolean;
-    letterSpacingPt?: number;
-}
-/** 宽度测量接口：返回文本在给定字号下的宽度（mm）。实现必须无副作用、可缓存。 */
-interface TextMeasurer {
-    measureMm(text: string, options: TextMeasureOptions): number;
-}
-declare function charWidthEm(ch: string): number;
-/** 启发式测量器：宽度模型与 jh4j 近似口径一致（默认实现） */
-declare const heuristicMeasurer: TextMeasurer;
-/** 兼容旧 API：默认启发式测量 */
-declare function createHeuristicMeasurer(): TextMeasurer;
-declare function measureTextMm(text: string, options: TextMeasureOptions): number;
-/**
- * 浏览器 Canvas 测量器：用真实字体 metrics 校准宽度（可选注入）。
- * 无 2D 环境时自动回退启发式（Node/SSR 安全）。
- */
-declare function createCanvasMeasurer(getCtx2d: () => CanvasRenderingContext2D | null): TextMeasurer;
-/**
- * 文本折行：
- * - CJK 字符任意位置可断（与既有行为一致）
- * - 连续拉丁/数字串视为一个词，仅在词间（空格/CJK 边界）断行；
- *   单词本身超宽时按字符硬拆（兜底，不无限溢出）
- * - 换行符强制断行；行首不保留折行产生的空格
- * - 可注入 TextMeasurer（默认启发式）
- */
-declare function wrapText(text: string, maxWidthMm: number, options: TextMeasureOptions, measurer?: TextMeasurer): string[];
-
-export { type ComponentStyle as C, type GridCell as G, type PlanPage as P, type RenderPlan as R, type TextMeasurer as T, type PlanComponent as a, type PlanGrid as b, type ComponentKind as c, type GridPlanResponse as d, RENDER_PLAN_SCHEMA_VERSION as e, type RichParagraph as f, type RichSegment as g, type TextMeasureOptions as h, charWidthEm as i, createCanvasMeasurer as j, createHeuristicMeasurer as k, heuristicMeasurer as l, isImageBackedComponent as m, isRichText as n, measureTextMm as o, toRenderPlan as t, wrapText as w };

package/dist/textwrap-DWzM7pt1.d.ts

@@ -1,135 +0,0 @@
-type ComponentKind = "text" | "image" | "barcode" | "qrcode" | "chart" | "line" | "rect" | "ellipse";
-interface ComponentStyle {
-    fontSizePx?: number;
-    fontSize?: number;
-    fontFamily?: string;
-    bold?: boolean;
-    italic?: boolean;
-    underline?: boolean;
-    color?: string;
-    backgroundColor?: string;
-    align?: "left" | "center" | "right" | "justify";
-    verticalAlign?: "top" | "middle" | "bottom";
-    lineColor?: string;
-    borderColor?: string;
-    lineWidthPt?: number;
-    borderTop?: boolean;
-    borderRight?: boolean;
-    borderBottom?: boolean;
-    borderLeft?: boolean;
-    lineHeight?: number;
-    letterSpacing?: number;
-    opacity?: number;
-    rotateDeg?: number;
-}
-interface RichParagraph {
-    segments: RichSegment[];
-    align?: ComponentStyle["align"];
-    lineHeight?: number;
-    spaceBeforeMm?: number;
-    spaceAfterMm?: number;
-    indentMm?: number;
-}
-interface RichSegment {
-    kind?: "text" | "field";
-    text?: string;
-    field?: string;
-    style?: ComponentStyle;
-}
-interface GridCell {
-    text?: string;
-    rawText?: string;
-    children?: PlanComponent[];
-    colSpan?: number;
-    rowSpan?: number;
-    style?: ComponentStyle;
-}
-interface PlanGrid {
-    /** 行内允许 null 空位（jh4j 契约数据存在稀疏行；渲染器按空单元格处理） */
-    cells: (GridCell | null)[][];
-    colWidthsMm?: number[];
-    rowHeightsMm?: number[];
-    gapMm?: number;
-}
-interface PlanComponent {
-    kind: ComponentKind;
-    leftMm: number;
-    topMm: number;
-    widthMm: number;
-    heightMm: number;
-    nid?: string;
-    rkey?: string;
-    text?: string;
-    rawText?: string;
-    lines?: string[];
-    richParagraphs?: RichParagraph[];
-    imageData?: string;
-    grid?: PlanGrid;
-    style?: ComponentStyle;
-    meta?: Record<string, unknown>;
-    /** MachReport 扩展字段：未知 kind 的兜底渲染标记 */
-    fallbackText?: string;
-}
-interface PlanPage {
-    pageWidthMm: number;
-    pageHeightMm: number;
-    marginTopMm?: number;
-    marginBottomMm?: number;
-    marginLeftMm?: number;
-    marginRightMm?: number;
-    components: PlanComponent[];
-}
-interface GridPlanResponse {
-    code?: number;
-    message?: string;
-    data?: {
-        pages?: PlanPage[];
-    } | null;
-}
-interface RenderPlan {
-    schemaVersion: string;
-    pages: PlanPage[];
-}
-declare const RENDER_PLAN_SCHEMA_VERSION = "1.0.0-mach";
-declare function toRenderPlan(response: GridPlanResponse): RenderPlan;
-declare function isImageBackedComponent(comp: PlanComponent): boolean;
-declare function isRichText(comp: PlanComponent): boolean;
-
-/**
- * 文本测量与折行（分页/Canvas/PDF 共用的唯一折行真相源）。
- *
- * 测量模型可注入（TextMeasurer）：
- * - 默认 createHeuristicMeasurer()：CJK/拉丁宽度启发式（零依赖、Node 可用）
- * - 浏览器端可注入 createCanvasMeasurer()（真字体 metrics，消除三端折行差异）
- */
-interface TextMeasureOptions {
-    fontSizePt: number;
-    bold?: boolean;
-    letterSpacingPt?: number;
-}
-/** 宽度测量接口：返回文本在给定字号下的宽度（mm）。实现必须无副作用、可缓存。 */
-interface TextMeasurer {
-    measureMm(text: string, options: TextMeasureOptions): number;
-}
-declare function charWidthEm(ch: string): number;
-/** 启发式测量器：宽度模型与 jh4j 近似口径一致（默认实现） */
-declare const heuristicMeasurer: TextMeasurer;
-/** 兼容旧 API：默认启发式测量 */
-declare function createHeuristicMeasurer(): TextMeasurer;
-declare function measureTextMm(text: string, options: TextMeasureOptions): number;
-/**
- * 浏览器 Canvas 测量器：用真实字体 metrics 校准宽度（可选注入）。
- * 无 2D 环境时自动回退启发式（Node/SSR 安全）。
- */
-declare function createCanvasMeasurer(getCtx2d: () => CanvasRenderingContext2D | null): TextMeasurer;
-/**
- * 文本折行：
- * - CJK 字符任意位置可断（与既有行为一致）
- * - 连续拉丁/数字串视为一个词，仅在词间（空格/CJK 边界）断行；
- *   单词本身超宽时按字符硬拆（兜底，不无限溢出）
- * - 换行符强制断行；行首不保留折行产生的空格
- * - 可注入 TextMeasurer（默认启发式）
- */
-declare function wrapText(text: string, maxWidthMm: number, options: TextMeasureOptions, measurer?: TextMeasurer): string[];
-
-export { type ComponentStyle as C, type GridCell as G, type PlanPage as P, type RenderPlan as R, type TextMeasurer as T, type PlanComponent as a, type PlanGrid as b, type ComponentKind as c, type GridPlanResponse as d, RENDER_PLAN_SCHEMA_VERSION as e, type RichParagraph as f, type RichSegment as g, type TextMeasureOptions as h, charWidthEm as i, createCanvasMeasurer as j, createHeuristicMeasurer as k, heuristicMeasurer as l, isImageBackedComponent as m, isRichText as n, measureTextMm as o, toRenderPlan as t, wrapText as w };