@openpresentation/opf 0.10.0 → 0.10.1

package/dist/composition.d.ts

@@ -73,7 +73,7 @@ interface LayoutBox {
     height: number;
 }
 interface LayoutDiagnostic {
-    code: "text-overflow" | "small-cell";
+    code: "text-overflow" | "small-cell" | "unresolved-content";
     path: string;
     message: string;
 }
@@ -184,7 +184,7 @@ interface ComposedFlow {
     itemCount: number;
     slotCount: number;
 }
-/** Additive penalties in grid-score-v8; lower is preferred. These are not quality percentages. */
+/** Additive penalties in grid-score-v9; lower is preferred. These are not quality percentages. */
 interface CompositionPenalties {
     cellProportions: number;
     fontReduction: number;
@@ -208,12 +208,12 @@ interface CompositionDecision {
     candidates: CompositionCandidate[];
 }
 interface CompositionExplanation {
-    algorithm: 'grid-score-v8';
+    algorithm: 'grid-score-v9';
     /** Provided widths do not establish shaping, glyph coverage or native fidelity. */
     textMeasurement: 'estimated' | 'provided';
     /** Optional vector coverage for headings and scalar/rich text, not every payload. */
     textOutlines: 'provided' | 'unavailable';
-    /** Effective canvas reference pixels; not a universal raster tolerance. */
+    /** Effective body-text reference pixels; furniture reports its own placement padding. Not a universal raster tolerance. */
     textRasterPadding: number;
     decisions: CompositionDecision[];
     /** Payloads whose complete internal fit is not covered by this scoring model. */
@@ -228,14 +228,26 @@ interface SlideComposition {
     flows: ComposedFlow[];
     diagnostics: LayoutDiagnostic[];
     composition: Composition;
+    /** Repeated furniture is measured separately from body pagination leaves. */
+    furniture?: FurnitureLayout;
     explanation?: CompositionExplanation;
 }
 interface ComposeSlideOptions {
+    /** Context for inherited furniture and generated organization names. */
+    presentation?: {
+        design?: {
+            header?: unknown;
+            footer?: unknown;
+        };
+        organization?: unknown;
+    };
+    /** One-based displayed number; source paths still use slideIndex. */
+    slideNumber?: number;
     fonts?: Partial<FontFamilies>;
     /** Host-resolved alignment for shared content; slide design can override it. */
     contentAlignment?: 'left' | 'center' | 'right';
     titleAlignment?: 'left' | 'center' | 'right';
-    /** Unscaled reference pixels around provided vector outlines; defaults to 1. */
+    /** Unscaled reference pixels around provided vector outlines; defaults to 1 for body text and 2 for furniture. Explicit values apply to both. */
     textRasterPadding?: number;
     /** Host-resolved body cards. A slide's explicit design.contentBox overrides this value. */
     contentBox?: boolean;
@@ -253,6 +265,46 @@ declare class OPFCompositionError extends Error {
     readonly explanation?: CompositionExplanation;
     constructor(diagnostics: LayoutDiagnostic[], explanation?: CompositionExplanation);
 }
+interface FurniturePartBase {
+    kind: 'header' | 'footer';
+    zone: 'left' | 'center' | 'right';
+    field: 'text' | 'image' | 'organization' | 'section' | 'slideNumber' | 'date';
+    /** Literal field or controlling flag, with the actual inherited/local path. */
+    path: string;
+    /** String/asset source, when different from a generated field's flag. */
+    sourcePath?: string;
+    generated: boolean;
+    box: LayoutBox;
+    alignment: 'left' | 'center' | 'right';
+}
+interface FurnitureTextPart extends FurniturePartBase {
+    type: 'text';
+    text: string;
+    style: TextStyle;
+    requestedFontSize: number;
+    minFontSize: number;
+    fit: SourceTextFit;
+}
+interface FurnitureImagePart extends FurniturePartBase {
+    type: 'image';
+    image: unknown;
+}
+type FurniturePart = FurnitureTextPart | FurnitureImagePart;
+interface FurnitureLayout {
+    algorithm: 'furniture-flow-v2';
+    /** Includes explicitly empty definitions, which override inherited furniture. */
+    configured: boolean;
+    textMeasurement: 'estimated' | 'provided';
+    textOutlines: 'provided' | 'unavailable';
+    parts: FurniturePart[];
+    /** Outer occupied edges; composeSlide adds its normal content gap. */
+    headerBottom: number;
+    footerTop: number;
+    diagnostics: LayoutDiagnostic[];
+    overflow: boolean;
+}
+/** Resolve and measure repeated fields without mutating metadata or consulting a clock. */
+declare function layoutFurniture(input: unknown, options?: ComposeSlideOptions): FurnitureLayout;
 /** Deterministic estimate, not a font shaping engine. Preserves explicit line breaks. */
 declare function measureText(text: string, fontSize: number): number;
 declare function wrapText(text: string, width: number, fontSize: number, measure?: MeasureTextWidth): string[];
@@ -621,4 +673,4 @@ declare function resolveCanvasDimensions(input: unknown): {
     height: number;
 };
 
-export { type CodeContent, type CodeLayout, type CodeLayoutDiagnostic, type CodeLayoutOptions, type CodeLineSegment, type CodeLineSource, type CodeTextFit, type CodeTextPart, type ComposeSlideOptions, type ComposedFlow, type ComposedGroup, type ComposedItem, type Composition, type CompositionCandidate, type CompositionDecision, type CompositionExplanation, type CompositionPenalties, type CompositionTrack, type FontFaceSelection, type FontFamilies, type LayoutBox, type LayoutDiagnostic, type ListEntryLayout, type ListFit, type ListText, type ListValue, MAX_COMPOSITION_DEPTH, type MeasureTextWidth, type MetricContent, type MetricLayout, type MetricLayoutDiagnostic, type MetricLayoutOptions, type MetricTextPart, type MetricTextSource, OPFCompositionError, type QuoteContent, type QuoteLayout, type QuoteLayoutDiagnostic, type QuoteLayoutOptions, type QuoteTextPart, type QuoteTextSource, type RichTextFit, type RichTextFragment, type RichTextLine, type RichTextOptions, type RichTextRun, type SlideComposition, type SourceTextFit, type TableBorder, type TableCellLayout, type TableCellStyle, type TableGrid, type TableGridCell, type TableGridIssue, type TableLayout, type TableLayoutOptions, type TableRowLayout, type TextFit, type TextLineInk, type TextLineSegment, type TextLineSource, type TextMeasurement, type TextPlacement, type TextPlacementLine, type TextStyle, type TimelineContent, type TimelineEvent, type TimelineLayout, type TimelineLayoutDiagnostic, type TimelineLayoutOptions, type TimelineTextPart, chartColorForFill, colorContrast, composeSlide, fitList, fitRichText, fitText, layoutCode, layoutMetric, layoutQuote, layoutTable, layoutTimeline, measureText, measureTextOutline, placeTextLines, resolveCanvasDimensions, resolveFontFamilies, resolveTextStyle, tableGrid, tableRowBoundaries, textColorForFill, textWidthMeasurer, wrapText };
+export { type CodeContent, type CodeLayout, type CodeLayoutDiagnostic, type CodeLayoutOptions, type CodeLineSegment, type CodeLineSource, type CodeTextFit, type CodeTextPart, type ComposeSlideOptions, type ComposedFlow, type ComposedGroup, type ComposedItem, type Composition, type CompositionCandidate, type CompositionDecision, type CompositionExplanation, type CompositionPenalties, type CompositionTrack, type FontFaceSelection, type FontFamilies, type FurnitureImagePart, type FurnitureLayout, type FurniturePart, type FurniturePartBase, type FurnitureTextPart, type LayoutBox, type LayoutDiagnostic, type ListEntryLayout, type ListFit, type ListText, type ListValue, MAX_COMPOSITION_DEPTH, type MeasureTextWidth, type MetricContent, type MetricLayout, type MetricLayoutDiagnostic, type MetricLayoutOptions, type MetricTextPart, type MetricTextSource, OPFCompositionError, type QuoteContent, type QuoteLayout, type QuoteLayoutDiagnostic, type QuoteLayoutOptions, type QuoteTextPart, type QuoteTextSource, type RichTextFit, type RichTextFragment, type RichTextLine, type RichTextOptions, type RichTextRun, type SlideComposition, type SourceTextFit, type TableBorder, type TableCellLayout, type TableCellStyle, type TableGrid, type TableGridCell, type TableGridIssue, type TableLayout, type TableLayoutOptions, type TableRowLayout, type TextFit, type TextLineInk, type TextLineSegment, type TextLineSource, type TextMeasurement, type TextPlacement, type TextPlacementLine, type TextStyle, type TimelineContent, type TimelineEvent, type TimelineLayout, type TimelineLayoutDiagnostic, type TimelineLayoutOptions, type TimelineTextPart, chartColorForFill, colorContrast, composeSlide, fitList, fitRichText, fitText, layoutCode, layoutFurniture, layoutMetric, layoutQuote, layoutTable, layoutTimeline, measureText, measureTextOutline, placeTextLines, resolveCanvasDimensions, resolveFontFamilies, resolveTextStyle, tableGrid, tableRowBoundaries, textColorForFill, textWidthMeasurer, wrapText };

package/dist/composition.js

@@ -1 +1 @@
-export { MAX_COMPOSITION_DEPTH, OPFCompositionError, chartColorForFill, colorContrast, composeSlide, fitList, fitRichText, fitText, layoutCode, layoutMetric, layoutQuote, layoutTable, layoutTimeline, measureText, measureTextOutline, placeTextLines, resolveCanvasDimensions, resolveFontFamilies, resolveTextStyle, tableGrid, tableRowBoundaries, textColorForFill, textWidthMeasurer, wrapText } from './chunk-BAWLYSUN.js';
+export { MAX_COMPOSITION_DEPTH, OPFCompositionError, chartColorForFill, colorContrast, composeSlide, fitList, fitRichText, fitText, layoutCode, layoutFurniture, layoutMetric, layoutQuote, layoutTable, layoutTimeline, measureText, measureTextOutline, placeTextLines, resolveCanvasDimensions, resolveFontFamilies, resolveTextStyle, tableGrid, tableRowBoundaries, textColorForFill, textWidthMeasurer, wrapText } from './chunk-PQJRDNA6.js';