oasis-editor 0.0.107 → 0.0.108

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/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/{index-4uLtMJwI.js → index-DzBLUs91.js}

@@ -2519,7 +2519,7 @@ function OasisEditorAppLazy(props = {}) {
     onCleanup(() => {
       cancelled = true;
     });
-    import("./OasisEditorApp-BFNqDc07.js").then((m) => {
+    import("./OasisEditorApp-DkiTrFZ6.js").then((m) => {
       cancelled = true;
       setProgress(1);
       setTimeout(() => setApp(() => m.OasisEditorApp), 180);
@@ -41929,7 +41929,7 @@ export {
   resolveImageSrc as Z,
   listKindForTag as _,
   getPageContentWidth as a,
-  DEFAULT_FONT_SIZE_PX as a$,
+  resolveOpenTypeFeatureTags as a$,
   collectInlineRuns as a0,
   parseParagraphStyle as a1,
   getRunImage as a2,
@@ -41966,7 +41966,7 @@ export {
   getImageFloatingGeometry as aX,
   textStyleToFontSizePt as aY,
   PX_PER_POINT as aZ,
-  resolveOpenTypeFeatureTags as a_,
+  DEFAULT_FONT_SIZE_PX as a_,
   CaretOverlay as aa,
   Show as ab,
   createRenderEffect as ac,
@@ -41994,7 +41994,7 @@ export {
   setPreciseFontPreference as ay,
   setWelcomeSeen as az,
   getPageBodyTop as b,
-  previousFontSizePt as b$,
+  nextFontSizePt as b$,
   isDoubleUnderlineStyle as b0,
   isWavyUnderlineStyle as b1,
   underlineStyleLineWidthPx as b2,
@@ -42005,33 +42005,33 @@ export {
   getParagraphBorderInsets as b7,
   buildSegmentTable as b8,
   buildCanvasTableLayout as b9,
-  unwrap as bA,
-  perfTimer as bB,
-  getRunTextBox as bC,
-  createEditorDocument as bD,
-  resolveResizedDimensions as bE,
-  resolveTextBoxRenderHeight as bF,
-  getToolbarStyleState as bG,
-  getCachedCanvasImage as bH,
-  measureParagraphMinContentWidthPx as bI,
-  getEditableBlocksForZone as bJ,
-  findParagraphLocation as bK,
-  createSectionBoundaryParagraph as bL,
-  normalizePageSettings as bM,
-  DEFAULT_EDITOR_PAGE_SETTINGS as bN,
-  markStart as bO,
-  markEnd as bP,
-  getParagraphEntries as bQ,
-  getParagraphById as bR,
-  createEditorFootnote as bS,
-  createFootnoteReferenceRun as bT,
-  renumberFootnotes as bU,
-  getHeadingLevel as bV,
-  preciseFontModeVersion as bW,
-  isPreciseFontModeEnabled as bX,
-  resolveNamedTextStyle as bY,
-  togglePreciseFontMode as bZ,
-  nextFontSizePt as b_,
+  debounce as bA,
+  unwrap as bB,
+  perfTimer as bC,
+  getRunTextBox as bD,
+  createEditorDocument as bE,
+  resolveResizedDimensions as bF,
+  resolveTextBoxRenderHeight as bG,
+  getToolbarStyleState as bH,
+  getCachedCanvasImage as bI,
+  measureParagraphMinContentWidthPx as bJ,
+  getEditableBlocksForZone as bK,
+  findParagraphLocation as bL,
+  createSectionBoundaryParagraph as bM,
+  normalizePageSettings as bN,
+  DEFAULT_EDITOR_PAGE_SETTINGS as bO,
+  markStart as bP,
+  markEnd as bQ,
+  getParagraphEntries as bR,
+  getParagraphById as bS,
+  createEditorFootnote as bT,
+  createFootnoteReferenceRun as bU,
+  renumberFootnotes as bV,
+  getHeadingLevel as bW,
+  preciseFontModeVersion as bX,
+  isPreciseFontModeEnabled as bY,
+  resolveNamedTextStyle as bZ,
+  togglePreciseFontMode as b_,
   resolveCanvasTableWidth as ba,
   resolveFloatingTableRect as bb,
   normalizeFamily as bc,
@@ -42043,78 +42043,79 @@ export {
   defaultFontDecoderRegistry as bi,
   SfntFontProgram as bj,
   collectPdfFontFamilies as bk,
-  getPageHeaderZoneTop as bl,
-  getPageColumnRects as bm,
-  findFootnoteReference as bn,
-  FOOTNOTE_MARKER_GUTTER_PX as bo,
-  resolveImporterForFile as bp,
-  getDocumentSectionsCanonical as bq,
-  getDocumentParagraphsCanonical as br,
-  getDocumentParagraphs as bs,
-  getDocumentPageSettings as bt,
-  getTableCellContentWidthForParagraph as bu,
-  layoutMetricsEpoch as bv,
-  bumpLayoutMetricsEpoch as bw,
-  createCanvasLayoutSnapshotProvider as bx,
-  on as by,
-  debounce as bz,
+  outlineFrom as bl,
+  getPageHeaderZoneTop as bm,
+  getPageColumnRects as bn,
+  findFootnoteReference as bo,
+  FOOTNOTE_MARKER_GUTTER_PX as bp,
+  resolveImporterForFile as bq,
+  getDocumentSectionsCanonical as br,
+  getDocumentParagraphsCanonical as bs,
+  getDocumentParagraphs as bt,
+  getDocumentPageSettings as bu,
+  getTableCellContentWidthForParagraph as bv,
+  layoutMetricsEpoch as bw,
+  bumpLayoutMetricsEpoch as bx,
+  createCanvasLayoutSnapshotProvider as by,
+  on as bz,
   getPageBodyBottom as c,
-  fontSizePtToPx as c0,
-  createDefaultToolbarPreset as c1,
-  MenuRegistry as c2,
-  createToolbarRegistry as c3,
-  Editor as c4,
-  resolveCommandRef as c5,
-  commandRefName as c6,
-  createOasisEditorClient as c7,
-  createEditorZoom as c8,
-  startLongTaskObserver as c9,
-  PluginCollection as cA,
-  Popover as cB,
-  RIBBON_TABS as cC,
-  Select as cD,
-  SelectField as cE,
-  Separator as cF,
-  SidePanel as cG,
-  SidePanelBody as cH,
-  SidePanelFooter as cI,
-  SidePanelHeader as cJ,
-  SplitButton as cK,
-  StyleGallery as cL,
-  TextField as cM,
-  Button$1 as cN,
-  buildRibbonTabDefinitions as cO,
-  createEditorCommandBus as cP,
-  createOasisEditor as cQ,
-  createOasisEditorContainer as cR,
-  mount as cS,
-  registerToolbarRenderer as cT,
-  installGlobalReport as ca,
-  applyStoredPreciseFontPreference as cb,
-  getWelcomeSeen as cc,
-  isLocalFontAccessSupported as cd,
-  EDITOR_SCROLL_PADDING_PX as ce,
-  Toolbar as cf,
-  OasisEditorLoading as cg,
-  I18nProvider as ch,
-  createTranslator as ci,
-  createEditorLogger as cj,
-  registerDomStatsSurface as ck,
-  Button as cl,
-  Checkbox as cm,
-  ColorPicker as cn,
-  CommandRegistry as co,
-  DEFAULT_PALETTE as cp,
-  DialogFooter as cq,
-  FloatingActionButton as cr,
-  GridPicker as cs,
-  IconButton as ct,
-  Menu as cu,
-  OASIS_BUILTIN_COMMANDS as cv,
-  OASIS_MENU_ITEMS as cw,
-  OASIS_TOOLBAR_ITEMS as cx,
-  OasisEditorAppLazy as cy,
-  OasisEditorContainer as cz,
+  previousFontSizePt as c0,
+  fontSizePtToPx as c1,
+  createDefaultToolbarPreset as c2,
+  MenuRegistry as c3,
+  createToolbarRegistry as c4,
+  Editor as c5,
+  resolveCommandRef as c6,
+  commandRefName as c7,
+  createOasisEditorClient as c8,
+  createEditorZoom as c9,
+  OasisEditorContainer as cA,
+  PluginCollection as cB,
+  Popover as cC,
+  RIBBON_TABS as cD,
+  Select as cE,
+  SelectField as cF,
+  Separator as cG,
+  SidePanel as cH,
+  SidePanelBody as cI,
+  SidePanelFooter as cJ,
+  SidePanelHeader as cK,
+  SplitButton as cL,
+  StyleGallery as cM,
+  TextField as cN,
+  Button$1 as cO,
+  buildRibbonTabDefinitions as cP,
+  createEditorCommandBus as cQ,
+  createOasisEditor as cR,
+  createOasisEditorContainer as cS,
+  mount as cT,
+  registerToolbarRenderer as cU,
+  startLongTaskObserver as ca,
+  installGlobalReport as cb,
+  applyStoredPreciseFontPreference as cc,
+  getWelcomeSeen as cd,
+  isLocalFontAccessSupported as ce,
+  EDITOR_SCROLL_PADDING_PX as cf,
+  Toolbar as cg,
+  OasisEditorLoading as ch,
+  I18nProvider as ci,
+  createTranslator as cj,
+  createEditorLogger as ck,
+  registerDomStatsSurface as cl,
+  Button as cm,
+  Checkbox as cn,
+  ColorPicker as co,
+  CommandRegistry as cp,
+  DEFAULT_PALETTE as cq,
+  DialogFooter as cr,
+  FloatingActionButton as cs,
+  GridPicker as ct,
+  IconButton as cu,
+  Menu as cv,
+  OASIS_BUILTIN_COMMANDS as cw,
+  OASIS_MENU_ITEMS as cx,
+  OASIS_TOOLBAR_ITEMS as cy,
+  OasisEditorAppLazy as cz,
   domTextMeasurer as d,
   estimateTableBlockHeight as e,
   getFootnoteDisplayMarker as f,

package/dist/oasis-editor.js

@@ -1,57 +1,57 @@
-import { a4, cl, cm, cn, co, cp, an, cq, a5, c4, cr, cs, ct, a3, cu, c2, cv, cw, cx, cy, cz, cg, cA, cB, cC, cD, cE, cF, cG, cH, cI, cJ, cK, cL, as, cM, cf, cN, cn as cn2, cs as cs2, cu as cu2, cD as cD2, cF as cF2, cK as cK2, cO, c6, c1, cP, cQ, cR, c3, cS, cT, c5 } from "./index-4uLtMJwI.js";
+import { a4, cm, cn, co, cp, cq, an, cr, a5, c5, cs, ct, cu, a3, cv, c3, cw, cx, cy, cz, cA, ch, cB, cC, cD, cE, cF, cG, cH, cI, cJ, cK, cL, cM, as, cN, cg, cO, co as co2, ct as ct2, cv as cv2, cE as cE2, cG as cG2, cL as cL2, cP, c7, c2, cQ, cR, cS, c4, cT, cU, c6 } from "./index-DzBLUs91.js";
 export {
   a4 as BalloonShell,
-  cl as Button,
-  cm as Checkbox,
-  cn as ColorPicker,
-  co as CommandRegistry,
-  cp as DEFAULT_PALETTE,
+  cm as Button,
+  cn as Checkbox,
+  co as ColorPicker,
+  cp as CommandRegistry,
+  cq as DEFAULT_PALETTE,
   an as Dialog,
-  cq as DialogFooter,
+  cr as DialogFooter,
   a5 as DocumentShell,
-  c4 as Editor,
-  cr as FloatingActionButton,
-  cs as GridPicker,
-  ct as IconButton,
+  c5 as Editor,
+  cs as FloatingActionButton,
+  ct as GridPicker,
+  cu as IconButton,
   a3 as InlineShell,
-  cu as Menu,
-  c2 as MenuRegistry,
-  cv as OASIS_BUILTIN_COMMANDS,
-  cw as OASIS_MENU_ITEMS,
-  cx as OASIS_TOOLBAR_ITEMS,
-  cy as OasisEditorAppLazy,
-  cz as OasisEditorContainer,
-  cg as OasisEditorLoading,
-  cA as PluginCollection,
-  cB as Popover,
-  cC as RIBBON_TABS,
-  cD as Select,
-  cE as SelectField,
-  cF as Separator,
-  cG as SidePanel,
-  cH as SidePanelBody,
-  cI as SidePanelFooter,
-  cJ as SidePanelHeader,
-  cK as SplitButton,
-  cL as StyleGallery,
+  cv as Menu,
+  c3 as MenuRegistry,
+  cw as OASIS_BUILTIN_COMMANDS,
+  cx as OASIS_MENU_ITEMS,
+  cy as OASIS_TOOLBAR_ITEMS,
+  cz as OasisEditorAppLazy,
+  cA as OasisEditorContainer,
+  ch as OasisEditorLoading,
+  cB as PluginCollection,
+  cC as Popover,
+  cD as RIBBON_TABS,
+  cE as Select,
+  cF as SelectField,
+  cG as Separator,
+  cH as SidePanel,
+  cI as SidePanelBody,
+  cJ as SidePanelFooter,
+  cK as SidePanelHeader,
+  cL as SplitButton,
+  cM as StyleGallery,
   as as Tabs,
-  cM as TextField,
-  cf as Toolbar,
-  cN as ToolbarButton,
-  cn2 as ToolbarColorPicker,
-  cs2 as ToolbarGridPicker,
-  cu2 as ToolbarMenu,
-  cD2 as ToolbarSelect,
-  cF2 as ToolbarSeparator,
-  cK2 as ToolbarSplitButton,
-  cO as buildRibbonTabDefinitions,
-  c6 as commandRefName,
-  c1 as createDefaultToolbarPreset,
-  cP as createEditorCommandBus,
-  cQ as createOasisEditor,
-  cR as createOasisEditorContainer,
-  c3 as createToolbarRegistry,
-  cS as mount,
-  cT as registerToolbarRenderer,
-  c5 as resolveCommandRef
+  cN as TextField,
+  cg as Toolbar,
+  cO as ToolbarButton,
+  co2 as ToolbarColorPicker,
+  ct2 as ToolbarGridPicker,
+  cv2 as ToolbarMenu,
+  cE2 as ToolbarSelect,
+  cG2 as ToolbarSeparator,
+  cL2 as ToolbarSplitButton,
+  cP as buildRibbonTabDefinitions,
+  c7 as commandRefName,
+  c2 as createDefaultToolbarPreset,
+  cQ as createEditorCommandBus,
+  cR as createOasisEditor,
+  cS as createOasisEditorContainer,
+  c4 as createToolbarRegistry,
+  cT as mount,
+  cU as registerToolbarRenderer,
+  c6 as resolveCommandRef
 };