oasis-editor 0.0.89 → 0.0.90

package/dist/core/model/index.d.ts

@@ -6,7 +6,7 @@
  * statements that pointed there continue to work via the barrel
  * re-export in `src/core/model.ts`.
  */
-export type { EditorUnderlineStyle, EditorLigatures, EditorNumberSpacing, EditorNumberForm, EditorTextLanguage, EditorBorderStyle, EditorTabStop, EditorParagraphListStyle, EditorImageCrop, EditorImageFillMode, EditorImageFloatingPosition, EditorImageFloatingLayout, EditorImageRunData, EditorWrapPolygonPoint, EditorFieldData, EditorFieldChar, EditorFootnoteReferenceData, EditorEndnoteReferenceData, EditorRevision, EditorRevisionMetadata, EditorStructuralRevision, EditorPropertyRevision, EditorAsset, EditorFootnoteNumberFormat, EditorFootnoteRestart, EditorDocxWidthValue, EditorTableLayout, EditorTableRowHeightRule, } from './types/primitives.js';
+export type { EditorUnderlineStyle, EditorLigatures, EditorNumberSpacing, EditorNumberForm, EditorTextLanguage, EditorBorderStyle, EditorEmphasisMark, EditorTabStop, EditorParagraphListStyle, EditorImageCrop, EditorImageFillMode, EditorImageFloatingPosition, EditorImageFloatingLayout, EditorImageRunData, EditorWrapPolygonPoint, EditorFieldData, EditorFieldChar, EditorFootnoteReferenceData, EditorEndnoteReferenceData, EditorRevision, EditorRevisionMetadata, EditorStructuralRevision, EditorPropertyRevision, EditorAsset, EditorFootnoteNumberFormat, EditorFootnoteRestart, EditorDocxWidthValue, EditorTableLayout, EditorTableRowHeightRule, } from './types/primitives.js';
 export type { EditorTextStyle, EditorParagraphStyle, EditorTableStyle, EditorTableFloatingLayout, EditorTableConditionalFormat, EditorConditionalRowStyle, EditorTableConditionalType, EditorTableConditionalFlags, EditorNamedStyle, } from './types/styles.js';
 export type { EditorRunBase, EditorTextRun, EditorTextBoxShape, EditorTextBoxBody, EditorTextBoxData, EditorDropCap, EditorParagraphNode, EditorTableCellStyle, EditorTableCellNode, EditorTableRowStyle, EditorTableRowNode, EditorTableNode, EditorBlockNode, } from './types/nodes.js';
 export type { RunKind, RunOfKind, RunVisitor } from './runKind.js';

package/dist/core/model/types/primitives.d.ts

@@ -18,6 +18,8 @@ export interface EditorBorderStyle {
     type: "solid" | "dashed" | "dotted" | "none";
     color: string;
 }
+/** `w:em/@w:val`: the emphasis mark drawn over each glyph of a run. */
+export type EditorEmphasisMark = "dot" | "comma" | "circle" | "underDot" | "none";
 export interface EditorTabStop {
     position: number;
     type: "left" | "center" | "right" | "decimal" | "bar" | "clear";

package/dist/core/model/types/styles.d.ts

@@ -1,4 +1,4 @@
-import { EditorBorderStyle, EditorDocxWidthValue, EditorLigatures, EditorNumberForm, EditorNumberSpacing, EditorPropertyRevision, EditorTabStop, EditorTextLanguage, EditorUnderlineStyle } from './primitives.js';
+import { EditorBorderStyle, EditorDocxWidthValue, EditorEmphasisMark, EditorLigatures, EditorNumberForm, EditorNumberSpacing, EditorPropertyRevision, EditorTabStop, EditorTextLanguage, EditorUnderlineStyle } from './primitives.js';
 import { EditorTableCellStyle } from './nodes.js';
 
 export interface EditorTextStyle {
@@ -18,6 +18,26 @@ export interface EditorTextStyle {
     noProof?: boolean;
     webHidden?: boolean;
     specVanish?: boolean;
+    /** `w:rtl`: run flows right-to-left. */
+    rtl?: boolean;
+    /** `w:cs`: run is complex-script text. */
+    complexScript?: boolean;
+    /** `w:snapToGrid` (run): snap characters to the document grid. Defaults on. */
+    snapToGrid?: boolean;
+    /** `w:fitText`: compress/expand the run to this target width (in pt). */
+    fitText?: number | null;
+    /** `w:em`: emphasis mark drawn above (or below for `underDot`) each glyph. */
+    emphasisMark?: EditorEmphasisMark | null;
+    /** `w:bdr`: border box drawn around the run's text. */
+    textBorder?: EditorBorderStyle | null;
+    /** `w:outline`: hollow/outlined glyphs. */
+    outline?: boolean;
+    /** `w:shadow`: drop shadow behind glyphs. */
+    shadow?: boolean;
+    /** `w:emboss`: raised (embossed) glyphs. */
+    emboss?: boolean;
+    /** `w:imprint`: engraved glyphs. */
+    imprint?: boolean;
     textEffect?: string | null;
     characterScale?: number | null;
     characterSpacing?: number | null;

package/dist/export/pdf/OasisPdfWriter.d.ts

@@ -1,102 +1,11 @@
-export interface OasisPdfPageSize {
-    width: number;
-    height: number;
-}
-export interface OasisPdfPage {
-    width: number;
-    height: number;
-    commands: string[];
-    imageResourceNames: Set<string>;
-}
-export interface OasisPdfRectOptions {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    fill?: string;
-    stroke?: string;
-    lineWidth?: number;
-}
-export interface OasisPdfLineOptions {
-    x1: number;
-    y1: number;
-    x2: number;
-    y2: number;
-    stroke?: string;
-    lineWidth?: number;
-    dashArray?: number[];
-}
-export type OasisPdfPathSegment = {
-    type: "move";
-    x: number;
-    y: number;
-} | {
-    type: "line";
-    x: number;
-    y: number;
-} | {
-    type: "cubic";
-    x1: number;
-    y1: number;
-    x2: number;
-    y2: number;
-    x: number;
-    y: number;
-} | {
-    type: "close";
-};
-export interface OasisPdfPathOptions {
-    segments: OasisPdfPathSegment[];
-    fill?: string;
-    stroke?: string;
-    lineWidth?: number;
-}
-export interface OasisPdfTextOptions {
-    x: number;
-    y: number;
-    text: string;
-    fontSize?: number;
-    color?: string;
-    bold?: boolean;
-    italic?: boolean;
-    fontResourceName?: string;
-    characterSpacing?: number;
-    horizontalScale?: number;
-}
-export interface OasisPdfImageResource {
-    resourceName: string;
-    width: number;
-    height: number;
-    data: Uint8Array;
-    filter: "DCTDecode";
-}
-export interface OasisPdfImageOptions {
-    resourceName: string;
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    rotation?: number;
-}
-export type OasisPdfFontResource = OasisPdfBase14FontResource | OasisPdfUnicodeFontResource;
-export interface OasisPdfBase14FontResource {
-    kind: "base14";
-    resourceName: string;
-    baseFont: string;
-}
-export interface OasisPdfUnicodeFontResource {
-    kind: "unicode";
-    resourceName: string;
-    family: string;
-    fontData: Uint8Array;
-    postscriptName?: string;
-}
+import { OasisPdfFontResource, OasisPdfImageOptions, OasisPdfImageResource, OasisPdfLineOptions, OasisPdfPageSize, OasisPdfPathOptions, OasisPdfRectOptions, OasisPdfTextOptions } from './writer/pdfTypes.js';
+
+export type { OasisPdfPageSize, OasisPdfPage, OasisPdfRectOptions, OasisPdfLineOptions, OasisPdfPathSegment, OasisPdfPathOptions, OasisPdfTextOptions, OasisPdfImageResource, OasisPdfImageOptions, OasisPdfFontResource, OasisPdfBase14FontResource, OasisPdfUnicodeFontResource, } from './writer/pdfTypes.js';
 export declare class OasisPdfWriter {
     private readonly pages;
-    private readonly fontResources;
-    private readonly unicodeFontStates;
-    private readonly usedFontResourceNames;
-    private readonly imageResources;
+    private readonly streams;
+    private readonly fonts;
+    private readonly images;
     constructor(fontResources?: OasisPdfFontResource[]);
     registerFontResource(resource: OasisPdfFontResource): void;
     addPage(size: OasisPdfPageSize): number;
@@ -113,12 +22,7 @@ export declare class OasisPdfWriter {
         resourceName?: string;
     }): string;
     drawImage(pageIndex: number, options: OasisPdfImageOptions): void;
-    private layoutUnicodeText;
-    private encodeUnicodeGlyphRun;
-    private drawUnicodeText;
     toArrayBuffer(): ArrayBuffer;
     toBlob(): Blob;
     private toUint8Array;
-    private addImageObject;
-    private addUnicodeFontObjects;
 }

package/dist/export/pdf/draw/drawFragment.d.ts

@@ -17,5 +17,7 @@ export declare function drawFloatingImagesForParagraph(options: {
 }): Promise<void>;
 export declare function drawFragmentHighlight(writer: OasisPdfWriter, pageIndex: number, line: EditorLayoutLine, fragment: EditorLayoutFragment, originX: number, originY: number, styles: Required<EditorTextStyle>): void;
 export declare function drawFragmentShading(writer: OasisPdfWriter, pageIndex: number, line: EditorLayoutLine, fragment: EditorLayoutFragment, originX: number, originY: number, styles: Required<EditorTextStyle>): void;
+export declare function drawFragmentBorder(writer: OasisPdfWriter, pageIndex: number, line: EditorLayoutLine, fragment: EditorLayoutFragment, originX: number, originY: number, styles: Required<EditorTextStyle>): void;
+export declare function drawFragmentEmphasis(writer: OasisPdfWriter, pageIndex: number, line: EditorLayoutLine, fragment: EditorLayoutFragment, originX: number, originY: number, styles: Required<EditorTextStyle>): void;
 export declare function drawFragmentDecoration(writer: OasisPdfWriter, pageIndex: number, line: EditorLayoutLine, fragment: EditorLayoutFragment, originX: number, originY: number, styles: Required<EditorTextStyle>, kind: "underline" | "strike" | "doubleStrike"): void;
 export declare function drawFragmentText(writer: OasisPdfWriter, pageIndex: number, paragraph: EditorParagraphNode, line: EditorLayoutLine, fragment: EditorLayoutFragment, document: EditorDocument, originX: number, originY: number, fontRegistry: PdfFontRegistry, drawers: BlockDrawers): Promise<void>;

package/dist/export/pdf/writer/PdfContentStream.d.ts

@@ -0,0 +1,20 @@
+import { OasisPdfImageOptions, OasisPdfLineOptions, OasisPdfPage, OasisPdfPathOptions, OasisPdfRectOptions, OasisPdfTextOptions } from './pdfTypes.js';
+import { PdfFontTable } from './PdfFontTable.js';
+import { PdfImageTable } from './PdfImageTable.js';
+
+export declare class PdfContentStream {
+    readonly page: OasisPdfPage;
+    private readonly fonts;
+    private readonly images;
+    constructor(page: OasisPdfPage, fonts: PdfFontTable, images: PdfImageTable);
+    drawRect(options: OasisPdfRectOptions): void;
+    drawLine(options: OasisPdfLineOptions): void;
+    drawPath(options: OasisPdfPathOptions): void;
+    saveGraphicsState(): void;
+    restoreGraphicsState(): void;
+    rotateAbout(centerX: number, centerY: number, degrees: number): void;
+    clipRect(x: number, y: number, width: number, height: number): void;
+    drawText(options: OasisPdfTextOptions): void;
+    private emitTextBlock;
+    drawImage(options: OasisPdfImageOptions): void;
+}

package/dist/export/pdf/writer/PdfDocumentSerializer.d.ts

@@ -0,0 +1,5 @@
+import { OasisPdfPage } from './pdfTypes.js';
+import { PdfFontTable } from './PdfFontTable.js';
+import { PdfImageTable } from './PdfImageTable.js';
+
+export declare function serializePdfDocument(pages: OasisPdfPage[], fonts: PdfFontTable, images: PdfImageTable): Uint8Array;

package/dist/export/pdf/writer/PdfFontTable.d.ts

@@ -0,0 +1,38 @@
+import { GlyphInfo, GlyphRun, PdfEmbeddableFont } from '../../../text/fonts/core/types.js';
+import { AddPdfObject, OasisPdfFontResource, OasisPdfTextOptions, OasisPdfUnicodeFontResource } from './pdfTypes.js';
+
+interface OasisPdfUnicodeFontState {
+    resource: OasisPdfUnicodeFontResource;
+    font: PdfEmbeddableFont;
+    usedGlyphs: Map<number, GlyphInfo>;
+    scale: number;
+    layoutCache: Map<string, GlyphRun>;
+}
+export declare class PdfFontTable {
+    private readonly fontResources;
+    private readonly unicodeFontStates;
+    private readonly usedFontResourceNames;
+    constructor(fontResources: OasisPdfFontResource[]);
+    registerFontResource(resource: OasisPdfFontResource): void;
+    /** Resolves the font resource a run uses and marks it as referenced. */
+    resolveAndMarkFontName(options: Pick<OasisPdfTextOptions, "bold" | "italic" | "fontResourceName">): string;
+    getUnicodeState(resourceName: string): OasisPdfUnicodeFontState | undefined;
+    /**
+     * Builds the glyph-show operator (`<...> Tj` or `[...] TJ`) for an embedded
+     * Unicode run, recording the glyphs used for subsetting. Returns `null` when
+     * the run produced no glyphs so the caller can skip emission entirely.
+     */
+    buildUnicodeShowCommand(state: OasisPdfUnicodeFontState, text: string): string | null;
+    /**
+     * Emits the font objects (base-14 dictionaries and embedded Unicode font
+     * programs) for every referenced resource and returns the `/Font` resource
+     * dictionary XML for page objects.
+     */
+    buildFontObjects(addObject: AddPdfObject): {
+        resourceXml: string;
+    };
+    private layoutUnicodeText;
+    private encodeUnicodeGlyphRun;
+    private addUnicodeFontObjects;
+}
+export {};

package/dist/export/pdf/writer/PdfImageTable.d.ts

@@ -0,0 +1,12 @@
+import { AddPdfObject, OasisPdfImageResource } from './pdfTypes.js';
+
+export declare class PdfImageTable {
+    private readonly imageResources;
+    registerImageResource(resource: Omit<OasisPdfImageResource, "resourceName"> & {
+        resourceName?: string;
+    }): string;
+    has(resourceName: string): boolean;
+    /** Emits each registered image object, keyed by resource name for page maps. */
+    buildImageObjects(addObject: AddPdfObject): Map<string, number>;
+    private addImageObject;
+}

package/dist/export/pdf/writer/pdfPrimitives.d.ts

@@ -0,0 +1,20 @@
+import { OasisPdfFontResource, OasisPdfTextOptions } from './pdfTypes.js';
+
+export declare const PDF_HEADER = "%PDF-1.4\n% Oasis PDF\n";
+export declare const DEFAULT_PDF_FONT_RESOURCES: OasisPdfFontResource[];
+export declare function formatNumber(value: number): string;
+export declare function byteLength(value: string): number;
+export declare function bytesToHex(bytes: Uint8Array): string;
+export declare function toHex16(value: number): string;
+export declare function colorCommand(color: string | undefined, operator: "rg" | "RG", fallback: [number, number, number]): string;
+export declare function resolveFontName(options: Pick<OasisPdfTextOptions, "bold" | "italic" | "fontResourceName">): string;
+export declare function fontResourceObjectBody(resource: OasisPdfFontResource): string;
+export declare function sanitizePdfName(value: string | undefined, fallback: string): string;
+export declare function encodePdfHexString(value: string): string;
+export declare function encodePdfUtf16Hex(codePoints: number[]): string;
+export declare function buildToUnicodeCMap(unicode: number[][]): string;
+export declare function streamObjectBody(stream: string, extraDictionary?: string): string;
+export declare function asciiHexStreamObjectBody(bytes: Uint8Array, extraDictionary?: string): string;
+export declare function asciiHexImageStreamObjectBody(bytes: Uint8Array, dictionaryEntries: string[]): string;
+export declare function encodeGlyphHex(glyphId: number): string;
+export declare function textMarkerComment(value: string): string;

package/dist/export/pdf/writer/pdfTypes.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Public value/option types for the PDF writer. These are the interfaces that
+ * callers across `src/export/pdf` (and the font registry) depend on; the
+ * `OasisPdfWriter` facade re-exports them so existing import paths keep working.
+ */
+export interface OasisPdfPageSize {
+    width: number;
+    height: number;
+}
+export interface OasisPdfPage {
+    width: number;
+    height: number;
+    commands: string[];
+    imageResourceNames: Set<string>;
+}
+export interface OasisPdfRectOptions {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    fill?: string;
+    stroke?: string;
+    lineWidth?: number;
+}
+export interface OasisPdfLineOptions {
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    stroke?: string;
+    lineWidth?: number;
+    dashArray?: number[];
+}
+export type OasisPdfPathSegment = {
+    type: "move";
+    x: number;
+    y: number;
+} | {
+    type: "line";
+    x: number;
+    y: number;
+} | {
+    type: "cubic";
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    x: number;
+    y: number;
+} | {
+    type: "close";
+};
+export interface OasisPdfPathOptions {
+    segments: OasisPdfPathSegment[];
+    fill?: string;
+    stroke?: string;
+    lineWidth?: number;
+}
+export interface OasisPdfTextOptions {
+    x: number;
+    y: number;
+    text: string;
+    fontSize?: number;
+    color?: string;
+    bold?: boolean;
+    italic?: boolean;
+    fontResourceName?: string;
+    characterSpacing?: number;
+    horizontalScale?: number;
+    /** PDF text render mode (`Tr`): 0 fill (default), 1 stroke, 2 fill+stroke. */
+    renderMode?: number;
+}
+export interface OasisPdfImageResource {
+    resourceName: string;
+    width: number;
+    height: number;
+    data: Uint8Array;
+    filter: "DCTDecode";
+}
+export interface OasisPdfImageOptions {
+    resourceName: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rotation?: number;
+}
+export type OasisPdfFontResource = OasisPdfBase14FontResource | OasisPdfUnicodeFontResource;
+export interface OasisPdfBase14FontResource {
+    kind: "base14";
+    resourceName: string;
+    baseFont: string;
+}
+export interface OasisPdfUnicodeFontResource {
+    kind: "unicode";
+    resourceName: string;
+    family: string;
+    fontData: Uint8Array;
+    postscriptName?: string;
+}
+/** A serialized indirect PDF object: its 1-based id and dictionary/stream body. */
+export interface PdfObject {
+    id: number;
+    body: string;
+}
+/** Signature of the object-appending closure used during serialization. */
+export type AddPdfObject = (body: string) => number;