oasis-editor 0.0.107 → 0.0.109

package/dist/core/color.d.ts

@@ -0,0 +1,9 @@
+/** Strips an optional leading `#` and surrounding whitespace. */
+export declare function stripHashPrefix(color: string): string;
+/**
+ * Parses a `#RRGGBB` (or `RRGGBB`) hex color into 0–255 integer RGB channels.
+ * Returns `null` when the input is not a valid 6-digit hex color.
+ */
+export declare function parseHexColorToRgb255(color: string | null | undefined): [number, number, number] | null;
+/** Formats 0–255 integer RGB channels as a lowercase `#rrggbb` string. */
+export declare function rgb255ToHex(r: number, g: number, b: number): string;

package/dist/core/units.d.ts

@@ -16,3 +16,11 @@ export declare const EMU_PER_PT = 12700;
 export declare const TWIPS_PER_INCH = 1440;
 /** Twentieths of a point ("twips") per typographic point. */
 export declare const TWIPS_PER_POINT = 20;
+/**
+ * Default document font size in CSS pixels: 11pt (the Calibri default used by
+ * Word) expressed as `11 * 96 / 72 ≈ 14.6667`. Single source of truth for the
+ * value that was previously redefined across the core, layout, canvas, import,
+ * export and testing layers (audit #1). Kept as the historical rounded literal
+ * `14.6667` so layout measurements remain byte-identical.
+ */
+export declare const DEFAULT_FONT_SIZE_PX = 14.6667;

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

@@ -1,12 +1,15 @@
-import { OasisPdfAxialGradient, OasisPdfFontResource, OasisPdfImageOptions, OasisPdfImageResource, OasisPdfLineOptions, OasisPdfPageSize, OasisPdfPathOptions, OasisPdfRectOptions, OasisPdfTextOptions } from './writer/pdfTypes.js';
+import { OasisPdfAxialGradient, OasisPdfLinkAnnotation, OasisPdfNamedDestination, OasisPdfOutlineItem, OasisPdfDocumentInfo, 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 type { OasisPdfPageSize, OasisPdfPage, OasisPdfRectOptions, OasisPdfLineOptions, OasisPdfPathSegment, OasisPdfPathOptions, OasisPdfTextOptions, OasisPdfImageResource, OasisPdfImageOptions, OasisPdfFontResource, OasisPdfBase14FontResource, OasisPdfUnicodeFontResource, OasisPdfLinkAnnotation, OasisPdfAnnotation, OasisPdfNamedDestination, OasisPdfOutlineItem, OasisPdfDocumentInfo, } from './writer/pdfTypes.js';
 export declare class OasisPdfWriter {
     private readonly pages;
     private readonly streams;
     private readonly fonts;
     private readonly images;
     private readonly shadings;
+    private readonly namedDestinations;
+    private readonly outlineItems;
+    private documentInfo;
     constructor(fontResources?: OasisPdfFontResource[]);
     registerFontResource(resource: OasisPdfFontResource): void;
     addPage(size: OasisPdfPageSize): number;
@@ -29,6 +32,24 @@ export declare class OasisPdfWriter {
         resourceName?: string;
     }): string;
     drawImage(pageIndex: number, options: OasisPdfImageOptions): void;
+    /**
+     * Attaches a clickable external link annotation to a page. The rect is in the
+     * writer's top-left point space; the serializer flips it to PDF space.
+     */
+    addLinkAnnotation(pageIndex: number, annotation: OasisPdfLinkAnnotation): void;
+    /**
+     * Registers a named destination (jump target). Position is in the writer's
+     * top-left point space. The first registration of a given name wins; later
+     * duplicates are ignored so destinations stay unique in the names tree.
+     */
+    addNamedDestination(destination: OasisPdfNamedDestination): void;
+    /**
+     * Appends an outline (bookmarks-panel) entry. Call in document order; the
+     * serializer nests entries by `level`.
+     */
+    addOutlineItem(item: OasisPdfOutlineItem): void;
+    /** Sets the document information dictionary (`/Info`). */
+    setDocumentInfo(info: OasisPdfDocumentInfo): void;
     toArrayBuffer(): ArrayBuffer;
     toBlob(): Blob;
     private toUint8Array;

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

@@ -2,4 +2,4 @@ import { EditorDocument, EditorLayoutBlock, EditorPageSettings } from '../../../
 import { PdfFontRegistry } from '../fonts/PdfFontRegistry.js';
 import { OasisPdfWriter } from '../OasisPdfWriter.js';
 
-export declare function drawBlockList(writer: OasisPdfWriter, pageIndex: number, blocks: EditorLayoutBlock[] | undefined, document: EditorDocument, originX: number, originY: number, contentWidth: number, fontRegistry: PdfFontRegistry, listOrdinals: Map<string, string>, pageSettings?: EditorPageSettings): Promise<void>;
+export declare function drawBlockList(writer: OasisPdfWriter, pageIndex: number, blocks: EditorLayoutBlock[] | undefined, document: EditorDocument, originX: number, originY: number, contentWidth: number, fontRegistry: PdfFontRegistry, listOrdinals: Map<string, string>, pageSettings?: EditorPageSettings, onParagraphDrawn?: (paragraphId: string, topPx: number) => void): Promise<void>;

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

@@ -1,8 +1,9 @@
 import { EditorTextStyle } from '../../core/model.js';
+import { DEFAULT_FONT_SIZE_PX } from '../../core/units.js';
 
 /** Points per pixel (72 / 96). Named PX_TO_PT for historical call sites. */
 export declare const PX_TO_PT: number;
-export declare const DEFAULT_FONT_SIZE_PX = 14.6667;
+export { DEFAULT_FONT_SIZE_PX };
 export declare function pxToPt(value: number): number;
 export declare function ptToPx(value: number): number;
 export declare function textStyleToFontSizePt(style: Required<EditorTextStyle>): number;

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

@@ -1,6 +1,6 @@
-import { OasisPdfPage } from './pdfTypes.js';
+import { OasisPdfDocumentInfo, OasisPdfNamedDestination, OasisPdfOutlineItem, OasisPdfPage } from './pdfTypes.js';
 import { PdfFontTable } from './PdfFontTable.js';
 import { PdfImageTable } from './PdfImageTable.js';
 import { PdfShadingTable } from './PdfShadingTable.js';
 
-export declare function serializePdfDocument(pages: OasisPdfPage[], fonts: PdfFontTable, images: PdfImageTable, shadings: PdfShadingTable): Uint8Array;
+export declare function serializePdfDocument(pages: OasisPdfPage[], fonts: PdfFontTable, images: PdfImageTable, shadings: PdfShadingTable, namedDestinations?: OasisPdfNamedDestination[], outlineItems?: OasisPdfOutlineItem[], documentInfo?: OasisPdfDocumentInfo): Uint8Array;

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

@@ -13,6 +13,54 @@ export interface OasisPdfPage {
     commands: string[];
     imageResourceNames: Set<string>;
     shadingResourceNames: Set<string>;
+    annotations: OasisPdfAnnotation[];
+}
+/**
+ * A clickable link annotation. The rect is given in the writer's top-left point
+ * space (same convention as drawing); the serializer flips y to PDF bottom-left
+ * space and emits the `[x1 y1 x2 y2]` `/Rect`. Exactly one of `uri` (external)
+ * or `destName` (internal named destination) is set.
+ */
+export interface OasisPdfLinkAnnotation {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    /** External target (`/URI` action). */
+    uri?: string;
+    /** Internal target: a named destination resolved via the `/Dests` name tree. */
+    destName?: string;
+}
+export type OasisPdfAnnotation = OasisPdfLinkAnnotation;
+/**
+ * A named destination (a jump target for internal links / the outline). Position
+ * is in the writer's top-left point space; the serializer flips y and binds it to
+ * the page object as a `/XYZ` destination.
+ */
+export interface OasisPdfNamedDestination {
+    name: string;
+    pageIndex: number;
+    x: number;
+    y: number;
+}
+/**
+ * One entry in the document outline (bookmarks panel). Items are supplied in
+ * document order; the serializer folds them into a nested tree by `level` (1 =
+ * top level). `destName` references a registered named destination.
+ */
+export interface OasisPdfOutlineItem {
+    title: string;
+    level: number;
+    destName: string;
+}
+/** Document information dictionary (`/Info`). All fields optional. */
+export interface OasisPdfDocumentInfo {
+    title?: string;
+    author?: string;
+    subject?: string;
+    keywords?: string;
+    producer?: string;
+    creationDate?: Date;
 }
 /** One color stop of an axial gradient. `offset` is 0–1; `color` is a hex string. */
 export interface OasisPdfGradientStop {
@@ -131,10 +179,14 @@ export interface OasisPdfUnicodeFontResource {
     fontData: Uint8Array;
     postscriptName?: string;
 }
-/** A serialized indirect PDF object: its 1-based id and dictionary/stream body. */
+/**
+ * A serialized indirect PDF object: its 1-based id and dictionary/stream body.
+ * The body is a string for text objects, or raw bytes when it embeds a binary
+ * (e.g. FlateDecode-compressed) stream that must not pass through UTF-8 encoding.
+ */
 export interface PdfObject {
     id: number;
-    body: string;
+    body: string | Uint8Array;
 }
 /** Signature of the object-appending closure used during serialization. */
-export type AddPdfObject = (body: string) => number;
+export type AddPdfObject = (body: string | Uint8Array) => number;

package/dist/i18n/locales/en.d.ts

@@ -14,6 +14,16 @@ export declare const en: {
     "toolbar.shape.triangle": string;
     "toolbar.shape.rtTriangle": string;
     "toolbar.shape.diamond": string;
+    "toolbar.shapes.recentlyUsed": string;
+    "toolbar.shapes.lines": string;
+    "toolbar.shapes.rectangles": string;
+    "toolbar.shapes.basicShapes": string;
+    "toolbar.shapes.blockArrows": string;
+    "toolbar.shapes.equation": string;
+    "toolbar.shapes.flowchart": string;
+    "toolbar.shapes.starsAndBanners": string;
+    "toolbar.shapes.callouts": string;
+    "locale.id": string;
     "toolbar.table": string;
     "toolbar.pageNumber": string;
     "toolbar.totalPages": string;

package/dist/i18n/locales/pt-BR.d.ts

@@ -14,6 +14,16 @@ export declare const ptBR: {
     "toolbar.shape.triangle": string;
     "toolbar.shape.rtTriangle": string;
     "toolbar.shape.diamond": string;
+    "toolbar.shapes.recentlyUsed": string;
+    "toolbar.shapes.lines": string;
+    "toolbar.shapes.rectangles": string;
+    "toolbar.shapes.basicShapes": string;
+    "toolbar.shapes.blockArrows": string;
+    "toolbar.shapes.equation": string;
+    "toolbar.shapes.flowchart": string;
+    "toolbar.shapes.starsAndBanners": string;
+    "toolbar.shapes.callouts": string;
+    "locale.id": string;
     "toolbar.table": string;
     "toolbar.pageNumber": string;
     "toolbar.totalPages": string;

package/dist/import/docx/units.d.ts

@@ -1,6 +1,10 @@
-import { TWIPS_PER_INCH, PX_PER_INCH } from '../../core/units.js';
+import { TWIPS_PER_INCH, PX_PER_INCH, EMU_PER_PT } from '../../core/units.js';
 
-export { TWIPS_PER_INCH, PX_PER_INCH };
+export { TWIPS_PER_INCH, PX_PER_INCH, EMU_PER_PT };
+/** OOXML thousandths-of-a-percent denominator (`100000` == 100%). */
+export declare const OOXML_PERCENT_DENOMINATOR = 100000;
+/** OOXML angle units (60000ths of a degree). */
+export declare const OOXML_ROTATION_UNITS = 60000;
 export declare const PAGE_BREAK_MARKER = "\f";
 export declare const DOCX_IMPLICIT_SINGLE_LINE_HEIGHT = 1.1;
 export declare function twipsToPx(value: string | null | undefined, fallback: number): number;