@stll/folio-core 0.61.0 → 0.63.0

package/dist/paged-layout/rangeProjection.d.ts

@@ -1,15 +1,15 @@
 import { FlowBlock, Layout, Measure } from "../layout-engine/types.js";
 import { SelectionRect } from "../layout-bridge/engine/selectionRects.js";
 //#region src/paged-layout/rangeProjection.d.ts
-type ProjectableRange = {
+export type ProjectableRange = {
   from: number;
   to: number;
 };
-type ProjectedRange<T extends ProjectableRange> = {
+export type ProjectedRange<T extends ProjectableRange> = {
   range: T;
   rects: SelectionRect[];
 };
-type RangeProjectionContext = {
+export type RangeProjectionContext = {
   pagesContainer: HTMLElement;
   zoom: number;
   layout: Layout | null;
@@ -23,13 +23,13 @@ type RangeProjectionContext = {
  * horizontally between paint passes while content above reflows. The page's
  * left margin is fixed, so this value holds steady as text is edited.
  */
-declare const measureContentLeft: (pagesContainer: HTMLElement, zoom: number) => number | null;
+export declare const measureContentLeft: (pagesContainer: HTMLElement, zoom: number) => number | null;
 /**
  * One page's body-content vertical extent in container space. `.layout-page-content`
  * is inset by the page margins, so its box excludes the header/footer and the
  * inter-page gap — exactly the region a gutter rail is allowed to paint over.
  */
-type PageContentBand = {
+export type PageContentBand = {
   /** 0-based page index (from `data-page-number` minus one). */
   pageIndex: number;
   /** Top of the body content area, container space. */
@@ -43,7 +43,7 @@ type PageContentBand = {
  * budget), and each page's body-content band (so a rail can be clipped per page
  * instead of running across page breaks). Measured O(pages), never per-range.
  */
-type DirectiveGutterGeometry = {
+export type DirectiveGutterGeometry = {
   /** Text-column left edge, container space. Rails anchor here. */
   contentLeft: number;
   /** Usable left-margin width: `contentLeft - pageLeftEdge`. Drives the budget. */
@@ -51,14 +51,14 @@ type DirectiveGutterGeometry = {
   /** Per-page body-content vertical bands, in document order. */
   pageBands: PageContentBand[];
 };
-declare const measureDirectiveGutter: (pagesContainer: HTMLElement, zoom: number) => DirectiveGutterGeometry | null;
+export declare const measureDirectiveGutter: (pagesContainer: HTMLElement, zoom: number) => DirectiveGutterGeometry | null;
 /**
  * Computed text style of the painted run at a PM position. Overlays
  * that paint substituted text over the pages (template fill preview,
  * AI suggestion replacement) copy these so the injected text matches
  * the surrounding run instead of the overlay container's base font.
  */
-type ProjectedRunFont = {
+export type ProjectedRunFont = {
   fontFamily: string;
   fontSize: string;
   fontWeight: string;
@@ -72,7 +72,6 @@ type ProjectedRunFont = {
  * (virtualized pages) simply stay absent from the result; callers fall
  * back to the overlay's inherited font.
  */
-declare const collectRunFontsAtPmPositions: (pagesContainer: HTMLElement, positions: readonly number[]) => Map<number, ProjectedRunFont>;
-declare const projectRangesToRects: <T extends ProjectableRange>(ranges: readonly T[], ctx: RangeProjectionContext) => Promise<ProjectedRange<T>[]>;
-//#endregion
-export { DirectiveGutterGeometry, PageContentBand, ProjectableRange, ProjectedRange, ProjectedRunFont, RangeProjectionContext, collectRunFontsAtPmPositions, measureContentLeft, measureDirectiveGutter, projectRangesToRects };
+export declare const collectRunFontsAtPmPositions: (pagesContainer: HTMLElement, positions: readonly number[]) => Map<number, ProjectedRunFont>;
+export declare const projectRangesToRects: <T extends ProjectableRange>(ranges: readonly T[], ctx: RangeProjectionContext) => Promise<ProjectedRange<T>[]>;
+//#endregion

package/dist/paged-layout/readOnlyEditAttempt.d.ts

@@ -1,5 +1,5 @@
 //#region src/paged-layout/readOnlyEditAttempt.d.ts
 type ReadOnlyEditKeyEvent = Pick<KeyboardEvent, "altKey" | "ctrlKey" | "key" | "metaKey">;
-declare const isReadOnlyEditKey: (event: ReadOnlyEditKeyEvent) => boolean;
+export declare const isReadOnlyEditKey: (event: ReadOnlyEditKeyEvent) => boolean;
 //#endregion
-export { isReadOnlyEditKey };
+export {};

package/dist/paged-layout/scrollNavigation.d.ts

@@ -1,13 +1,13 @@
 import { Layout } from "../layout-engine/types.js";
 //#region src/paged-layout/scrollNavigation.d.ts
-type PageScrollTarget = {
+export type PageScrollTarget = {
   type: "position";
   pmPos: number;
 } | {
   type: "pageShell";
   pageIndex: number;
 };
-declare const isValidPmScrollPosition: (pmPos: number) => boolean;
+export declare const isValidPmScrollPosition: (pmPos: number) => boolean;
 /**
  * Pick a `scrollIntoView` / `scrollTo` `behavior` that respects the
  * user's `prefers-reduced-motion` setting. Chrome silently no-ops
@@ -16,7 +16,6 @@ declare const isValidPmScrollPosition: (pmPos: number) => boolean;
  * leaves the user wondering why the chip "doesn't work". Use the
  * helper everywhere we'd otherwise hard-code `"smooth"`.
  */
-declare const prefersReducedMotionBehavior: () => ScrollBehavior;
-declare const getPageScrollTarget: (layout: Layout | null, pageNumber: number) => PageScrollTarget | null;
-//#endregion
-export { PageScrollTarget, getPageScrollTarget, isValidPmScrollPosition, prefersReducedMotionBehavior };
+export declare const prefersReducedMotionBehavior: () => ScrollBehavior;
+export declare const getPageScrollTarget: (layout: Layout | null, pageNumber: number) => PageScrollTarget | null;
+//#endregion

package/dist/paged-layout/scrollPageInfo.d.ts

@@ -7,13 +7,13 @@
  * `useZoomAndPageInfo` hook owns the React state and the scroll/layout DOM
  * reads; this module owns the pure geometry.
  */
-type ScrollPageInfo = {
+export type ScrollPageInfo = {
   currentPage: number;
   totalPages: number;
   visible: boolean;
 };
-declare const updateScrollPageTotal: (previous: ScrollPageInfo, totalPages: number) => ScrollPageInfo;
-type ScrollPageMetrics = {
+export declare const updateScrollPageTotal: (previous: ScrollPageInfo, totalPages: number) => ScrollPageInfo;
+export type ScrollPageMetrics = {
   /** Laid-out page heights (unscaled), top to bottom. */
   pageHeights: readonly number[];
   /** Current scroll offset of the container (scaled by zoom). */
@@ -32,9 +32,8 @@ type ScrollPageMetrics = {
  * count from the laid-out page heights and the live scroll position. Returns
  * null when there are no pages to measure.
  */
-declare const computeScrollPageInfo: ({ pageHeights, scrollTop, clientHeight, zoom, viewportPaddingTop, pageGap }: ScrollPageMetrics) => {
+export declare const computeScrollPageInfo: ({ pageHeights, scrollTop, clientHeight, zoom, viewportPaddingTop, pageGap }: ScrollPageMetrics) => {
   currentPage: number;
   totalPages: number;
 } | null;
-//#endregion
-export { ScrollPageInfo, ScrollPageMetrics, computeScrollPageInfo, updateScrollPageTotal };
+//#endregion

package/dist/paged-layout/scrollToPmPosition.d.ts

@@ -1,9 +1,9 @@
 import { EditorView } from "prosemirror-view";
 //#region src/paged-layout/scrollToPmPosition.d.ts
 /** Class on the pages container `PagedEditor` paints into. */
-declare const PAGES_CONTAINER_CLASS = "paged-editor__pages";
+export declare const PAGES_CONTAINER_CLASS = "paged-editor__pages";
 /** Scroll visible pages to a ProseMirror position. */
-declare const scrollPagesToPmPosition: (pageContainer: HTMLElement, pmPos: number) => void;
+export declare const scrollPagesToPmPosition: (pageContainer: HTMLElement, pmPos: number) => void;
 /**
  * Scroll the paged layout that mirrors `view` so `pmPos` is centered
  * in the viewport. The hidden editing view sits inside the editor's
@@ -11,6 +11,5 @@ declare const scrollPagesToPmPosition: (pageContainer: HTMLElement, pmPos: numbe
  * Returns false when no paged layout is found (non-paged host) so
  * callers can fall back to coordinate-based scrolling.
  */
-declare const scrollFolioPositionIntoView: (view: EditorView, pmPos: number) => boolean;
-//#endregion
-export { PAGES_CONTAINER_CLASS, scrollFolioPositionIntoView, scrollPagesToPmPosition };
+export declare const scrollFolioPositionIntoView: (view: EditorView, pmPos: number) => boolean;
+//#endregion

package/dist/paged-layout/sectionBlockWidths.d.ts

@@ -41,7 +41,7 @@ type PerBlockMeasureInputs = {
  * Section N's blocks use config from sectionBreak[N].
  * The final section (after all breaks) uses body-level config.
  */
-declare function computePerBlockWidths({ blocks, bodyConfig, finalConfig }: ComputePerBlockMeasureInput): number[];
-declare function computePerBlockMeasureInputs({ blocks, bodyConfig, finalConfig }: ComputePerBlockMeasureInput): PerBlockMeasureInputs;
+export declare function computePerBlockWidths({ blocks, bodyConfig, finalConfig }: ComputePerBlockMeasureInput): number[];
+export declare function computePerBlockMeasureInputs({ blocks, bodyConfig, finalConfig }: ComputePerBlockMeasureInput): PerBlockMeasureInputs;
 //#endregion
-export { computePerBlockMeasureInputs, computePerBlockWidths };
+export {};

package/dist/paged-layout/sectionBlockWidths.js

@@ -76,9 +76,6 @@ function computePerBlockMeasureInputs({ blocks, bodyConfig, finalConfig }) {
 				hasPhysicalPageContent = false;
 				columnGeometryDirty = true;
 				columnIndex = 0;
-				break;
-			case "none": break;
-			default:
 		}
 		if (measuredSectionIdx !== sectionIdx || columnGeometryDirty) {
 			activeColumns = config.columns ?? SINGLE_COLUMN_LAYOUT;

package/dist/paged-layout/sectionGeometry.d.ts

@@ -1,21 +1,20 @@
 import { document_d_exports } from "../types/document.js";
 import { PageMargins, SectionPageNumbering } from "../layout-engine/types.js";
 //#region src/paged-layout/sectionGeometry.d.ts
-declare const DEFAULT_PAGE_WIDTH_PX = 816;
-declare const DEFAULT_PAGE_HEIGHT_PX = 1056;
-declare const DEFAULT_BODY_MARGIN_PX = 96;
-declare const DEFAULT_HEADER_FOOTER_DISTANCE_PX = 48;
-declare const twipsToPixels: (twips: number) => number;
+export declare const DEFAULT_PAGE_WIDTH_PX = 816;
+export declare const DEFAULT_PAGE_HEIGHT_PX = 1056;
+export declare const DEFAULT_BODY_MARGIN_PX = 96;
+export declare const DEFAULT_HEADER_FOOTER_DISTANCE_PX = 48;
+export declare const twipsToPixels: (twips: number) => number;
 /**
  * Convert an offset-like twip dimension to px. Explicit 0 is meaningful for
  * page margins and header/footer distances; only absence should use fallback.
  */
-declare const twipsToPxOr: (twips: number | null | undefined, fallbackPx: number) => number;
-declare const getPageSize: (sectionProps: document_d_exports.SectionProperties | null | undefined) => {
+export declare const twipsToPxOr: (twips: number | null | undefined, fallbackPx: number) => number;
+export declare const getPageSize: (sectionProps: document_d_exports.SectionProperties | null | undefined) => {
   w: number;
   h: number;
 };
-declare const getMargins: (sectionProps: document_d_exports.SectionProperties | null | undefined) => PageMargins;
-declare const getPageNumbering: (sectionProps: document_d_exports.SectionProperties | null | undefined) => SectionPageNumbering;
-//#endregion
-export { DEFAULT_BODY_MARGIN_PX, DEFAULT_HEADER_FOOTER_DISTANCE_PX, DEFAULT_PAGE_HEIGHT_PX, DEFAULT_PAGE_WIDTH_PX, getMargins, getPageNumbering, getPageSize, twipsToPixels, twipsToPxOr };
+export declare const getMargins: (sectionProps: document_d_exports.SectionProperties | null | undefined) => PageMargins;
+export declare const getPageNumbering: (sectionProps: document_d_exports.SectionProperties | null | undefined) => SectionPageNumbering;
+//#endregion

package/dist/paged-layout/selectionViewportRect.d.ts

@@ -1,9 +1,9 @@
 import { EditorView } from "prosemirror-view";
 //#region src/paged-layout/selectionViewportRect.d.ts
 /** Attribute SelectionOverlay stamps on every painted highlight rect. */
-declare const FOLIO_SELECTION_RECT_ATTRIBUTE = "data-folio-selection-rect";
+export declare const FOLIO_SELECTION_RECT_ATTRIBUTE = "data-folio-selection-rect";
 /** Attribute SelectionOverlay stamps on the painted collapsed caret. */
-declare const FOLIO_CARET_RECT_ATTRIBUTE = "data-folio-caret-rect";
+export declare const FOLIO_CARET_RECT_ATTRIBUTE = "data-folio-caret-rect";
 /**
  * Union bounding rect (client coordinates) of the painted selection
  * highlights mirroring `view`'s selection. Returns null for a collapsed
@@ -12,7 +12,7 @@ declare const FOLIO_CARET_RECT_ATTRIBUTE = "data-folio-caret-rect";
  * callers should retry on a later frame instead of treating null as
  * "no selection".
  */
-declare const getFolioSelectionViewportRect: (view: EditorView) => DOMRect | null;
+export declare const getFolioSelectionViewportRect: (view: EditorView) => DOMRect | null;
 /**
  * Client-coordinate rect of the painted collapsed caret mirroring `view`'s
  * cursor. The paged editor's editing view is hidden off-screen, so
@@ -23,6 +23,5 @@ declare const getFolioSelectionViewportRect: (view: EditorView) => DOMRect | nul
  * so callers should retry on a later frame instead of treating null as "no
  * caret".
  */
-declare const getFolioCaretViewportRect: (view: EditorView) => DOMRect | null;
-//#endregion
-export { FOLIO_CARET_RECT_ATTRIBUTE, FOLIO_SELECTION_RECT_ATTRIBUTE, getFolioCaretViewportRect, getFolioSelectionViewportRect };
+export declare const getFolioCaretViewportRect: (view: EditorView) => DOMRect | null;
+//#endregion

package/dist/paged-layout/tableColumnResize.d.ts

@@ -11,9 +11,8 @@
  * unchanged when either side would drop below `minWidth`.
  * eigenpal/docx-editor#940.
  */
-declare const resizeColumnPair: (left: number, right: number, deltaTwips: number, bidi: boolean, minWidth: number) => {
+export declare const resizeColumnPair: (left: number, right: number, deltaTwips: number, bidi: boolean, minWidth: number) => {
   left: number;
   right: number;
 };
-//#endregion
-export { resizeColumnPair };
+//#endregion

package/dist/paged-layout/tableInsertButtonGeometry.d.ts

@@ -10,6 +10,5 @@
  * button, which is scaled too. Without the divisor the button drifts off the
  * table edge at any zoom other than 100% (eigenpal/docx-editor#934).
  */
-declare const tableInsertButtonOffset: (edge: number, viewportEdge: number, zoom: number, nudge: number) => number;
-//#endregion
-export { tableInsertButtonOffset };
+export declare const tableInsertButtonOffset: (edge: number, viewportEdge: number, zoom: number, nudge: number) => number;
+//#endregion

package/dist/paged-layout/transactionDirtyRange.d.ts

@@ -1,6 +1,5 @@
 import { DirtyRange } from "./incrementalMeasure.js";
 import { Transaction } from "prosemirror-state";
 //#region src/paged-layout/transactionDirtyRange.d.ts
-declare function getTransactionDirtyRange(transaction: Transaction): DirtyRange | null;
-//#endregion
-export { getTransactionDirtyRange };
+export declare function getTransactionDirtyRange(transaction: Transaction): DirtyRange | null;
+//#endregion

package/dist/paged-layout/zoomScrollAnchor.d.ts

@@ -6,7 +6,7 @@
  * `useZoomAndPageInfo` hook captures an anchor before a zoom change and restores
  * the scroll position after the layout reflows so the document does not jump.
  */
-type ViewportCenterZoomAnchor = {
+export type ViewportCenterZoomAnchor = {
   offsetY: number;
   scaledY: number;
   zoom: number;
@@ -23,8 +23,8 @@ type GetViewportCenterZoomAnchorForZoomChangeParams = {
   pendingAnchor: ViewportCenterZoomAnchor | null;
   scrollTop: number;
 };
-declare const captureViewportCenterZoomAnchor: ({ clientHeight, scrollTop, zoom }: CaptureViewportCenterZoomAnchorParams) => ViewportCenterZoomAnchor;
-declare const getViewportCenterZoomAnchorForZoomChange: ({ clientHeight, currentZoom, nextZoom, pendingAnchor, scrollTop }: GetViewportCenterZoomAnchorForZoomChangeParams) => ViewportCenterZoomAnchor | null;
-declare const getScrollTopForZoomAnchor: (anchor: ViewportCenterZoomAnchor, nextZoom: number) => number;
+export declare const captureViewportCenterZoomAnchor: ({ clientHeight, scrollTop, zoom }: CaptureViewportCenterZoomAnchorParams) => ViewportCenterZoomAnchor;
+export declare const getViewportCenterZoomAnchorForZoomChange: ({ clientHeight, currentZoom, nextZoom, pendingAnchor, scrollTop }: GetViewportCenterZoomAnchorForZoomChangeParams) => ViewportCenterZoomAnchor | null;
+export declare const getScrollTopForZoomAnchor: (anchor: ViewportCenterZoomAnchor, nextZoom: number) => number;
 //#endregion
-export { ViewportCenterZoomAnchor, captureViewportCenterZoomAnchor, getScrollTopForZoomAnchor, getViewportCenterZoomAnchorForZoomChange };
+export {};

package/dist/panel-layout.d.ts

@@ -24,7 +24,7 @@
  * landscape section moves them.
  */
 /** Widths, in CSS pixels, every tier is derived from. */
-declare const PANEL_METRICS: {
+export declare const PANEL_METRICS: {
   /** The outline column in the `wide` tier, border included. */
   readonly outlineColumnWidth: 256;
   /** The outline rail in the `medium` tier, border included. */
@@ -41,13 +41,13 @@ declare const PANEL_METRICS: {
   readonly drawerWidth: 304;
 };
 /** Width the comments take beside the page: gap, cards, gap. */
-declare const COMMENTS_TRACK_WIDTH: number;
-type PanelLayoutTier = "wide" | "medium" | "narrow";
+export declare const COMMENTS_TRACK_WIDTH: number;
+export type PanelLayoutTier = "wide" | "medium" | "narrow";
 /** How the outline is shown: a column, tick rail, drawer, or explicitly opened track. */
-type OutlinePresentation = "none" | "column" | "rail" | "drawer" | "expanded";
+export type OutlinePresentation = "none" | "column" | "rail" | "drawer" | "expanded";
 /** How the comments are shown: a column beside the page, a drawer, or not at all. */
-type CommentsPresentation = "hidden" | "column" | "drawer";
-type PanelLayoutInput = {
+export type CommentsPresentation = "hidden" | "column" | "drawer";
+export type PanelLayoutInput = {
   /** Width of the row the outline track and the scroll viewport share, scrollbar excluded. */
   availableWidth: number;
   /** Width of the widest page at the current zoom. */
@@ -57,7 +57,7 @@ type PanelLayoutInput = {
   /** Whether the user (or the auto-open) wants the comments shown. */
   comments: "closed" | "open";
 };
-type PanelLayout = {
+export type PanelLayout = {
   tier: PanelLayoutTier;
   outline: OutlinePresentation;
   comments: CommentsPresentation;
@@ -76,10 +76,9 @@ type PanelLayout = {
  * given: `wide` fits every column, `medium` fits the outline rail and the
  * comments column.
  */
-declare const panelLayoutThresholds: ({ pageWidth, outline, comments }: Omit<PanelLayoutInput, "availableWidth">) => PanelLayout["thresholds"];
+export declare const panelLayoutThresholds: ({ pageWidth, outline, comments }: Omit<PanelLayoutInput, "availableWidth">) => PanelLayout["thresholds"];
 /** Decide each panel's presentation for the width the editor has. */
-declare const computePanelLayout: (input: PanelLayoutInput) => PanelLayout;
+export declare const computePanelLayout: (input: PanelLayoutInput) => PanelLayout;
 /** Which drawer is open over the page: at most one at a time. */
-type PanelOverlay = "none" | "outline" | "comments";
-//#endregion
-export { COMMENTS_TRACK_WIDTH, CommentsPresentation, OutlinePresentation, PANEL_METRICS, PanelLayout, PanelLayoutInput, PanelLayoutTier, PanelOverlay, computePanelLayout, panelLayoutThresholds };
+export type PanelOverlay = "none" | "outline" | "comments";
+//#endregion

package/dist/pdf/contentStream.d.ts

@@ -1,7 +1,7 @@
 import { DisplayColor } from "../display-list/types.js";
 import { PdfMatrix } from "./pageSpace.js";
 //#region src/pdf/contentStream.d.ts
-type PdfResourceUse = {
+export type PdfResourceUse = {
   readonly kind: "font";
   readonly resourceIndex: number;
 } | {
@@ -11,12 +11,12 @@ type PdfResourceUse = {
   readonly kind: "extGState";
   readonly alpha: number;
 };
-type ContentPart = {
+export type ContentPart = {
   readonly kind: "literal";
   readonly text: string;
 } | PdfResourceUse;
 /** A glyph plus the correction that follows it in a `TJ` array. */
-type PositionedGlyph = {
+export type PositionedGlyph = {
   readonly glyphId: number;
   /** Thousandths of text space, subtracted from the pen after the glyph. */
   readonly adjustment: number;
@@ -25,13 +25,13 @@ type PositionedGlyph = {
  * Text rendering modes. `fillThenStroke` is what an outlined run (`w:outline`)
  * paints.
  */
-declare const TEXT_RENDER_MODE: {
+export declare const TEXT_RENDER_MODE: {
   readonly fill: 0;
   readonly stroke: 1;
   readonly fillThenStroke: 2;
 };
-type PdfTextRenderMode = (typeof TEXT_RENDER_MODE)[keyof typeof TEXT_RENDER_MODE];
-type ContentStream = {
+export type PdfTextRenderMode = (typeof TEXT_RENDER_MODE)[keyof typeof TEXT_RENDER_MODE];
+export type ContentStream = {
   readonly save: () => void;
   readonly restore: () => void;
   readonly concat: (matrix: PdfMatrix) => void;
@@ -58,16 +58,15 @@ type ContentStream = {
   readonly drawImage: (imageIndex: number) => void;
   readonly parts: () => readonly ContentPart[];
 };
-declare const createContentStream: () => ContentStream;
+export declare const createContentStream: () => ContentStream;
 /** Resource names for one page, assigned from sorted keys. */
-type ContentResources = {
+export type ContentResources = {
   /** Keyed by font resource index: one face can hold several of them. */
   readonly fontNames: ReadonlyMap<number, string>;
   readonly imageNames: ReadonlyMap<number, string>;
   /** Keyed by the formatted alpha, so two alphas that print alike share a state. */
   readonly extGStateNames: ReadonlyMap<string, string>;
 };
-declare const collectResources: (parts: readonly ContentPart[]) => ContentResources;
-declare const renderContentStream: (parts: readonly ContentPart[], resources: ContentResources) => string;
-//#endregion
-export { ContentPart, ContentResources, ContentStream, PdfResourceUse, PdfTextRenderMode, PositionedGlyph, TEXT_RENDER_MODE, collectResources, createContentStream, renderContentStream };
+export declare const collectResources: (parts: readonly ContentPart[]) => ContentResources;
+export declare const renderContentStream: (parts: readonly ContentPart[], resources: ContentResources) => string;
+//#endregion

package/dist/pdf/fonts.d.ts

@@ -3,21 +3,21 @@ import { Shaper, ShapingDirection } from "../shaping/shaper.js";
 import { PdfDocument, PdfRef } from "./objects.js";
 import { PdfUnencodable } from "./writePdf.js";
 //#region src/pdf/fonts.d.ts
-type PdfFontSource = {
+export type PdfFontSource = {
   /**
    * Every binary that carries part of this face, in priority order. A code
    * point is served by the first binary whose cmap covers it.
    */
   readonly load: (face: DisplayFontFace) => readonly Uint8Array[];
 };
-type PdfSubstitution = {
+export type PdfSubstitution = {
   readonly family: string;
   readonly weight: number;
   readonly italic: boolean;
   readonly reason: string;
 };
 /** A code point placed in the glyph space of the resource that serves it. */
-type PdfGlyph = {
+export type PdfGlyph = {
   /** The PDF font resource this glyph id belongs to. */
   readonly resourceIndex: number;
   readonly glyphId: number;
@@ -30,7 +30,7 @@ type PdfGlyph = {
  * optional fields that are only valid in one of them.
  */
 /** One shaped glyph, in the glyph space of the resource that will paint it. */
-type PlacedPdfGlyph = PdfGlyph & {
+export type PlacedPdfGlyph = PdfGlyph & {
   /** Code-point index in the run's text of the cluster this glyph came from. */
   readonly clusterIndex: number;
   readonly xAdvancePx: number;
@@ -38,13 +38,13 @@ type PlacedPdfGlyph = PdfGlyph & {
   readonly yOffsetPx: number;
 };
 /** A run whose glyphs shaping has to choose, as the collection pass saw it. */
-type ShapedRunRequest = {
+export type ShapedRunRequest = {
   readonly text: string;
   readonly direction: ShapingDirection;
   readonly fontSizePx: number;
 };
 /** A face embedded as a subset of its own program. */
-type EmbeddedPdfFont = {
+export type EmbeddedPdfFont = {
   readonly kind: "embedded";
   /** Resource and subset glyph for a code point the collection pass saw. */
   readonly glyphFor: (codePoint: number) => PdfGlyph;
@@ -56,13 +56,13 @@ type EmbeddedPdfFont = {
   readonly placeShapedRun: (request: ShapedRunRequest) => readonly PlacedPdfGlyph[] | null;
 };
 /** A base-14 stand-in for a face that could not be embedded. */
-type StandardPdfFont = {
+export type StandardPdfFont = {
   readonly kind: "standard";
   readonly resourceIndex: number;
   /** WinAnsi byte for a code point. */
   readonly byteFor: (codePoint: number) => number;
 };
-type PreparedFont = EmbeddedPdfFont | StandardPdfFont;
+export type PreparedFont = EmbeddedPdfFont | StandardPdfFont;
 type PrepareFontsOptions = {
   readonly document: PdfDocument;
   readonly faces: readonly DisplayFontFace[];
@@ -79,7 +79,7 @@ type PrepareFontsOptions = {
   readonly shaper?: Shaper | null;
   readonly source: PdfFontSource;
 };
-type PreparedFonts = {
+export type PreparedFonts = {
   readonly byFontIndex: ReadonlyMap<number, PreparedFont>;
   /** Every PDF font resource the pages may name, by resource index. */
   readonly fontRefByResourceIndex: ReadonlyMap<number, PdfRef>;
@@ -91,6 +91,6 @@ type PreparedFonts = {
  * paints is skipped entirely: an unused face is not a substitution, and
  * embedding it would put bytes in the file no page reads.
  */
-declare const prepareFonts: ({ document, faces, usedCodePoints, shapedRuns, shaper, source }: PrepareFontsOptions) => PreparedFonts;
+export declare const prepareFonts: ({ document, faces, usedCodePoints, shapedRuns, shaper, source }: PrepareFontsOptions) => PreparedFonts;
 //#endregion
-export { EmbeddedPdfFont, PdfFontSource, PdfGlyph, PdfSubstitution, PlacedPdfGlyph, PreparedFont, PreparedFonts, ShapedRunRequest, StandardPdfFont, prepareFonts };
+export {};

package/dist/pdf/fonts.js

@@ -6,25 +6,6 @@ import { bytesToHex, decodeText, encodeUtf16BE, encodeUtf8 } from "../utils/text
 import { pdfArray, pdfAsciiString, pdfDict, pdfFlateStream, pdfName, pdfNumber, pdfNumberArray } from "./objects.js";
 import { Result, TaggedError, panic } from "better-result";
 //#region src/pdf/fonts.ts
-/**
-* Font embedding.
-*
-* Every face the document paints becomes a composite (Type 0) font with
-* `Identity-H` encoding, so a run is written as two-byte glyph ids and the
-* file carries no encoding table to disagree with the font. A face the source
-* cannot supply, or whose licence bits forbid embedding, falls back to a
-* base-14 face and is *reported*: a substitution the caller cannot see is a
-* silently different document.
-*
-* ## A face is not a binary
-*
-* A packaged family arrives cut into disjoint script subsets: one binary
-* carries ASCII, another the Central European letters, and Czech, Slovak or
-* Polish text needs both at once. Each binary is its own sfnt with its own
-* glyph space, so one face becomes one PDF font resource *per binary the
-* document actually uses*, and a code point is served by the first binary
-* whose cmap covers it.
-*/
 var PdfFontError = class extends TaggedError("PdfFontError") {};
 /** Text space is 1000 units to the em whatever the font's own head is. */
 const TEXT_SPACE_UNITS_PER_EM = 1e3;

package/dist/pdf/images.d.ts

@@ -3,15 +3,15 @@ import { PdfValue } from "./objects.js";
 import { Result } from "better-result";
 //#region src/pdf/images.d.ts
 declare const PdfImageError_base: import("better-result").TaggedErrorClass<"PdfImageError">;
-declare class PdfImageError extends PdfImageError_base<{
+export declare class PdfImageError extends PdfImageError_base<{
   message: string;
 }> {}
 /** A soft mask: one alpha sample per pixel, matching the image's dimensions. */
-type PdfImageAlpha = {
+export type PdfImageAlpha = {
   readonly data: Uint8Array;
   readonly bitsPerComponent: number;
 };
-type PdfImageSamples = {
+export type PdfImageSamples = {
   readonly widthPx: number;
   readonly heightPx: number;
   readonly bitsPerComponent: number;
@@ -23,6 +23,6 @@ type PdfImageSamples = {
   readonly decode?: readonly number[];
   readonly alpha?: PdfImageAlpha;
 };
-declare const decodeImage: (source: DisplayImageSource) => Result<PdfImageSamples, PdfImageError>;
+export declare const decodeImage: (source: DisplayImageSource) => Result<PdfImageSamples, PdfImageError>;
 //#endregion
-export { PdfImageAlpha, PdfImageError, PdfImageSamples, decodeImage };
+export {};

package/dist/pdf/images.js

@@ -378,7 +378,10 @@ const decodePng = (bytes) => {
 					bitDepth
 				});
 				const data = new Uint8Array(pixelCount);
-				for (let index = 0; index < pixelCount; index += 1) data[index] = transparency[indices[index] ?? 0] ?? FULLY_OPAQUE;
+				for (let index = 0; index < pixelCount; index += 1) {
+					const paletteIndex = indices[index] ?? 0;
+					data[index] = transparency[paletteIndex] ?? FULLY_OPAQUE;
+				}
 				alpha = {
 					data,
 					bitsPerComponent: EIGHT_BIT
@@ -566,6 +569,7 @@ const decodeImage = (source) => {
 	switch (source.format) {
 		case "png": return decodePng(source.bytes);
 		case "jpeg": return decodeJpeg(source.bytes);
+		case "svg": return Result.err(new PdfImageError({ message: "SVG images are not supported in PDF" }));
 		default: {
 			const unreachable = source.format;
 			return Result.err(new PdfImageError({ message: `unsupported image format ${String(unreachable)}` }));