oasis-editor 0.0.138 → 0.0.139

package/dist/{OasisEditorApp-DMI2ZfOd.js → OasisEditorApp-B1x9P0Ua.js}

@@ -1,7 +1,7 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-import { E as EMPTY_PROJECTION_CONTEXT, d as domTextMeasurer, g as getProjectedParagraphBlockHeight, e as estimateTableBlockHeight, p as projectParagraphLayout, a as getPageBodyBottom, b as getPageBodyTop, c as getPageContentWidth, F as FOOTNOTE_MARKER_GUTTER_PX, f as getParagraphText, h as getBlockParagraphs, i as getRunFootnoteReference, l as listReferencedEndnotes, j as getFootnoteDisplayMarker, k as createProjectionContext, m as getDocumentSections, n as getRunField, o as projectBlocksLayout, v as visitRun, q as assertNever, r as createSignal, s as createEditorStateFromDocument, t as createInitialEditorState, S as STANDARD_FONT_SIZES_PT, u as fontSizePxToPt, w as probeLocalFontFamilies, x as createEditorParagraphFromRuns, y as isInlineObjectRun, z as createEditorStyledRun, A as getParagraphLength, B as getActiveZone, C as getActiveSectionIndex, D as getParagraphs, G as normalizeSelection, H as positionToParagraphOffset, I as paragraphOffsetToPosition, J as clampPosition, K as findParagraphIndex, L as createCollapsedSelection, M as isSelectionCollapsed, N as parseFontSizePtToPx, O as formatFontSizePt, P as createEditorParagraph, Q as resolveDefaultParagraphStyleId, R as findParagraphTableLocation, T as buildTableCellLayout, U as PT_PER_PX, V as createEditorTableCell, W as createEditorTableRow, X as createEditorTable, Y as PX_PER_POINT, Z as underlineStyleToCssDecorationStyle, _ as resolveImageSrc, $ as listKindForTag, a0 as isParagraphTag, a1 as collectInlineRuns, a2 as parseParagraphStyle, a3 as getRunImage, a4 as InlineShell, a5 as BalloonShell, a6 as DocumentShell, a7 as createMemo, a8 as getCaretRectFromSnapshot, a9 as getParagraphRectFromSnapshot, aa as createComponent, ab as CaretOverlay, ac as Show, ad as createRenderEffect, ae as style, af as setStyleProperty, ag as setAttribute, ah as memo, ai as template, aj as Button, ak as useI18n, al as createEffect, am as TextField, an as Dialog, ao as insert, ap as className, aq as Grid, ar as SelectField, as as StatusText, at as ColorField, au as UNDERLINE_STYLE_OPTIONS, av as Stack, aw as For, ax as ToggleChip, ay as FormField, az as Checkbox, aA as FieldGroup, aB as Tabs, aC as NumberField, aD as parseNumber, aE as createStore, aF as reconcile, aG as RadioGroup, aH as Radio$1, aI as TextAreaField, aJ as Text, aK as SurfaceButton, aL as delegateEvents, aM as onMount, aN as onCleanup, aO as CheckIcon, aP as use, aQ as PluginUiHost, aR as OasisEditorEditor, aS as OasisBrandMark, aT as setPreciseFontPreference, aU as setWelcomeSeen, aV as enablePreciseFontMode, aW as TWIPS_PER_POINT, aX as PX_PER_INCH, aY as TWIPS_PER_INCH, aZ as normalizeHex6, a_ as TABLE_CONDITIONAL_FLAG_ATTRIBUTES, a$ as TABLE_BORDER_EDGE_KEYS, b0 as resolveEffectiveParagraphStyle, b1 as resolveEffectiveTextStyleForParagraph, b2 as EMU_PER_PT, b3 as OOXML_ROTATION_UNITS, b4 as OOXML_PERCENT_DENOMINATOR, b5 as parseHexColorToRgb255, b6 as EMU_PER_PX, b7 as getRunEndnoteReference, b8 as iterateFootnoteReferenceRuns, b9 as iterateEndnoteReferenceRuns, ba as imageContentTypeDefaults, bb as getRunFieldChar, bc as getRunFieldInstruction, bd as createEditorRun, be as JSZip, bf as imageExtensionFromMime, bg as pxToPt$1, bh as resolveFloatingObjectRect, bi as getTextBoxFloatingGeometry, bj as getPresetPathSegments, bk as buildListLabels, bl as lineDashPatternPt, bm as DEFAULT_FONT_SIZE_PX, bn as resolveGradientAxis, bo as isDoubleUnderlineStyle, bp as isWavyUnderlineStyle, bq as underlineStyleLineWidthPx, br as WAVY_UNDERLINE_WAVELENGTH_PX, bs as WAVY_UNDERLINE_AMPLITUDE_PX, bt as DOUBLE_UNDERLINE_OFFSET_PX, bu as underlineStyleDashArray, bv as EMPHASIS_GLYPH, bw as rgb255ToHex, bx as getImageFloatingGeometry, by as textStyleToFontSizePt, bz as resolveTextAlignmentBaselineOffset, bA as TEXT_BASELINE_RATIO, bB as resolveRenderedTextChar, bC as resolveOpenTypeFeatureTags, bD as isLowercaseSmallCapsChar, bE as resolveDecorationLineY, bF as DOUBLE_STRIKE_OFFSET_PX, bG as resolveListLabel, bH as getListLabelInset, bI as getAlignedListLabelInset, bJ as getParagraphBorderInsets, bK as buildSegmentTable, bL as buildCanvasTableLayout, bM as resolveCanvasTableWidth, bN as resolveFloatingTableRect, bO as paragraphBetweenBorderMatches, bP as normalizeFamily, bQ as ROBOTO_FONT_FILES, bR as loadFontAsset, bS as getRemotePdfFontFaces, bT as OFFICE_COMPAT_FONT_FAMILIES, bU as BinaryReader, bV as buildSfnt, bW as defaultFontDecoderRegistry, bX as SfntFontProgram, bY as zlibSync, bZ as collectPdfFontFamilies, b_ as outlineFrom, b$ as getPageHeaderZoneTop, c0 as getPageColumnRects, c1 as findFootnoteReference, c2 as resolveImporterForFile, c3 as roundTo, c4 as getDocumentSectionsCanonical, c5 as getDocumentParagraphsCanonical, c6 as getDocumentParagraphs, c7 as PX_PER_CM, c8 as getDocumentPageSettings, c9 as getTableCellContentWidthForParagraph, ca as layoutMetricsEpoch, cb as bumpLayoutMetricsEpoch, cc as createCanvasLayoutSnapshotProvider, cd as on, ce as debounce, cf as unwrap, cg as perfTimer, ch as prepareDocumentFonts, ci as getRunTextBox, cj as createEditorDocument, ck as resolveResizedDimensions, cl as axisSignForDirection, cm as clamp$1, cn as MIN_RESIZE_SIZE_PX, co as resolveTextBoxRenderHeight, cp as getToolbarStyleState, cq as VERTICAL_HIT_WEIGHT, cr as getCachedCanvasImage, cs as measureParagraphMinContentWidthPx, ct as getEditableBlocksForZone, cu as findParagraphLocation, cv as createSectionBoundaryParagraph, cw as normalizePageSettings, cx as DEFAULT_EDITOR_PAGE_SETTINGS, cy as markStart, cz as markEnd, cA as getParagraphEntries, cB as getParagraphById, cC as createEditorFootnote, cD as createFootnoteReferenceRun, cE as renumberFootnotes, cF as preciseFontModeVersion, cG as isPreciseFontModeEnabled, cH as getHeadingLevel, cI as togglePreciseFontMode, cJ as nextFontSizePt, cK as previousFontSizePt, cL as fontSizePtToPx, cM as resolveNamedTextStyle, cN as resolveNamedTableStyle, cO as resolveEffectiveTableStyle, cP as createDefaultToolbarPreset, cQ as MenuRegistry, cR as createToolbarRegistry, cS as Editor, cT as resolveCommandRef, cU as commandRefName, cV as createOasisEditorClient, cW as createEditorZoom, cX as startLongTaskObserver, cY as installGlobalReport, cZ as applyStoredPreciseFontPreference, c_ as getWelcomeSeen, c$ as isLocalFontAccessSupported, d0 as EDITOR_SCROLL_PADDING_PX, d1 as Toolbar, d2 as OasisEditorLoading, d3 as I18nProvider, d4 as createTranslator, d5 as registerDomStatsSurface, d6 as createEditorLogger } from "./index-M7h7REmM.js";
+import { E as EMPTY_PROJECTION_CONTEXT, d as domTextMeasurer, g as getProjectedParagraphBlockHeight, e as estimateTableBlockHeight, p as projectParagraphLayout, a as getPageBodyBottom, b as getPageBodyTop, c as getPageContentWidth, F as FOOTNOTE_MARKER_GUTTER_PX, f as getParagraphText, h as getBlockParagraphs, i as getRunFootnoteReference, l as listReferencedEndnotes, j as getFootnoteDisplayMarker, k as createProjectionContext, m as getDocumentSections, n as getRunField, o as projectBlocksLayout, v as visitRun, q as assertNever, r as createSignal, s as createEditorStateFromDocument, t as createInitialEditorState, S as STANDARD_FONT_SIZES_PT, u as fontSizePxToPt, w as probeLocalFontFamilies, x as createEditorParagraphFromRuns, y as isInlineObjectRun, z as createEditorStyledRun, A as getParagraphLength, B as getActiveZone, C as getActiveSectionIndex, D as getParagraphs, G as normalizeSelection, H as positionToParagraphOffset, I as paragraphOffsetToPosition, J as clampPosition, K as findParagraphIndex, L as createCollapsedSelection, M as isSelectionCollapsed, N as parseFontSizePtToPx, O as formatFontSizePt, P as createEditorParagraph, Q as resolveDefaultParagraphStyleId, R as findParagraphTableLocation, T as buildTableCellLayout, U as PT_PER_PX, V as createEditorTableCell, W as createEditorTableRow, X as createEditorTable, Y as PX_PER_POINT, Z as underlineStyleToCssDecorationStyle, _ as resolveImageSrc, $ as listKindForTag, a0 as isParagraphTag, a1 as collectInlineRuns, a2 as parseParagraphStyle, a3 as getRunImage, a4 as InlineShell, a5 as BalloonShell, a6 as DocumentShell, a7 as createMemo, a8 as getCaretRectFromSnapshot, a9 as getParagraphRectFromSnapshot, aa as createComponent, ab as CaretOverlay, ac as Show, ad as createRenderEffect, ae as style, af as setStyleProperty, ag as setAttribute, ah as memo, ai as template, aj as Button, ak as useI18n, al as createEffect, am as TextField, an as Dialog, ao as insert, ap as className, aq as Grid, ar as SelectField, as as StatusText, at as ColorField, au as UNDERLINE_STYLE_OPTIONS, av as Stack, aw as For, ax as ToggleChip, ay as FormField, az as Checkbox, aA as FieldGroup, aB as Tabs, aC as NumberField, aD as parseNumber, aE as createStore, aF as reconcile, aG as RadioGroup, aH as Radio$1, aI as TextAreaField, aJ as Text, aK as SurfaceButton, aL as delegateEvents, aM as onMount, aN as onCleanup, aO as CheckIcon, aP as use, aQ as PluginUiHost, aR as OasisEditorEditor, aS as OasisBrandMark, aT as setPreciseFontPreference, aU as setWelcomeSeen, aV as enablePreciseFontMode, aW as TWIPS_PER_POINT, aX as PX_PER_INCH, aY as TWIPS_PER_INCH, aZ as normalizeHex6, a_ as TABLE_CONDITIONAL_FLAG_ATTRIBUTES, a$ as TABLE_BORDER_EDGE_KEYS, b0 as resolveEffectiveParagraphStyle, b1 as resolveEffectiveTextStyleForParagraph, b2 as EMU_PER_PT, b3 as OOXML_ROTATION_UNITS, b4 as OOXML_PERCENT_DENOMINATOR, b5 as parseHexColorToRgb255, b6 as EMU_PER_PX, b7 as getRunEndnoteReference, b8 as iterateFootnoteReferenceRuns, b9 as iterateEndnoteReferenceRuns, ba as imageContentTypeDefaults, bb as getRunFieldChar, bc as getRunFieldInstruction, bd as createEditorRun, be as JSZip, bf as imageExtensionFromMime, bg as pxToPt$1, bh as resolveFloatingObjectRect, bi as getTextBoxFloatingGeometry, bj as getPresetPathSegments, bk as buildListLabels, bl as lineDashPatternPt, bm as DEFAULT_FONT_SIZE_PX, bn as resolveGradientAxis, bo as isDoubleUnderlineStyle, bp as isWavyUnderlineStyle, bq as underlineStyleLineWidthPx, br as WAVY_UNDERLINE_WAVELENGTH_PX, bs as WAVY_UNDERLINE_AMPLITUDE_PX, bt as DOUBLE_UNDERLINE_OFFSET_PX, bu as underlineStyleDashArray, bv as EMPHASIS_GLYPH, bw as rgb255ToHex, bx as getImageFloatingGeometry, by as textStyleToFontSizePt, bz as resolveTextAlignmentBaselineOffset, bA as TEXT_BASELINE_RATIO, bB as resolveRenderedTextChar, bC as resolveOpenTypeFeatureTags, bD as isLowercaseSmallCapsChar, bE as resolveDecorationLineY, bF as DOUBLE_STRIKE_OFFSET_PX, bG as resolveListLabel, bH as getListLabelInset, bI as getAlignedListLabelInset, bJ as getParagraphBorderInsets, bK as buildSegmentTable, bL as buildCanvasTableLayout, bM as resolveCanvasTableWidth, bN as resolveFloatingTableRect, bO as paragraphBetweenBorderMatches, bP as normalizeFamily, bQ as ROBOTO_FONT_FILES, bR as loadFontAsset, bS as getRemotePdfFontFaces, bT as OFFICE_COMPAT_FONT_FAMILIES, bU as BinaryReader, bV as buildSfnt, bW as defaultFontDecoderRegistry, bX as SfntFontProgram, bY as zlibSync, bZ as collectPdfFontFamilies, b_ as outlineFrom, b$ as getPageHeaderZoneTop, c0 as getPageColumnRects, c1 as findFootnoteReference, c2 as resolveImporterForFile, c3 as roundTo, c4 as getDocumentSectionsCanonical, c5 as getDocumentParagraphsCanonical, c6 as getDocumentParagraphs, c7 as PX_PER_CM, c8 as getDocumentPageSettings, c9 as getTableCellContentWidthForParagraph, ca as layoutMetricsEpoch, cb as bumpLayoutMetricsEpoch, cc as createCanvasLayoutSnapshotProvider, cd as on, ce as debounce, cf as unwrap, cg as perfTimer, ch as prepareDocumentFonts, ci as getRunTextBox, cj as createEditorDocument, ck as resolveResizedDimensions, cl as axisSignForDirection, cm as clamp$1, cn as MIN_RESIZE_SIZE_PX, co as resolveTextBoxRenderHeight, cp as getToolbarStyleState, cq as VERTICAL_HIT_WEIGHT, cr as getCachedCanvasImage, cs as measureParagraphMinContentWidthPx, ct as getEditableBlocksForZone, cu as findParagraphLocation, cv as createSectionBoundaryParagraph, cw as normalizePageSettings, cx as DEFAULT_EDITOR_PAGE_SETTINGS, cy as markStart, cz as markEnd, cA as getParagraphEntries, cB as getParagraphById, cC as createEditorFootnote, cD as createFootnoteReferenceRun, cE as renumberFootnotes, cF as preciseFontModeVersion, cG as isPreciseFontModeEnabled, cH as getHeadingLevel, cI as togglePreciseFontMode, cJ as nextFontSizePt, cK as previousFontSizePt, cL as fontSizePtToPx, cM as resolveNamedTextStyle, cN as resolveNamedTableStyle, cO as resolveEffectiveTableStyle, cP as createDefaultToolbarPreset, cQ as MenuRegistry, cR as createToolbarRegistry, cS as Editor, cT as resolveCommandRef, cU as commandRefName, cV as createOasisEditorClient, cW as createEditorZoom, cX as startLongTaskObserver, cY as installGlobalReport, cZ as applyStoredPreciseFontPreference, c_ as getWelcomeSeen, c$ as isLocalFontAccessSupported, d0 as EDITOR_SCROLL_PADDING_PX, d1 as Toolbar, d2 as OasisEditorLoading, d3 as I18nProvider, d4 as createTranslator, d5 as registerDomStatsSurface, d6 as createEditorLogger } from "./index-BVWzLonI.js";
 function projectHeaderFooterBlocksWithDependencies(blocks, deps, context = {}) {
   const {
     pageIndex,
@@ -43910,15 +43910,21 @@ function createDocumentExporter(deps) {
     const blob = await exportEditorDocumentToDocxBlob(deps.document());
     download(blob, "oasis-editor.docx");
     deps.focusInput();
+    return blob;
   };
   const handleExportPdf = async () => {
     const blob = await exportEditorDocumentToPdfBlob(deps.document());
     download(blob, "oasis-editor.pdf");
     deps.focusInput();
+    return blob;
   };
+  const exportDocxBlob = () => exportEditorDocumentToDocxBlob(deps.document());
+  const exportPdfBlob = () => exportEditorDocumentToPdfBlob(deps.document());
   return {
     handleExportDocx,
-    handleExportPdf
+    handleExportPdf,
+    exportDocxBlob,
+    exportPdfBlob
   };
 }
 async function readFileBuffer(file) {
@@ -44753,16 +44759,18 @@ function createEditorDocumentIOImpl(deps) {
     deps.focusInput();
   };
   const handleExportDocx = async () => {
-    await exporter.handleExportDocx();
+    return exporter.handleExportDocx();
   };
   const handleExportPdf = async () => {
-    await exporter.handleExportPdf();
+    return exporter.handleExportPdf();
   };
   return {
     importProgress,
     handleImportFile,
     handleExportDocx,
     handleExportPdf,
+    exportDocxBlob: exporter.exportDocxBlob,
+    exportPdfBlob: exporter.exportPdfBlob,
     insertImageFromFile,
     handleInsertImage
   };
@@ -53537,6 +53545,7 @@ function connectEditorClientHost(controller, deps) {
       deps.resetEditorChromeState();
       deps.focusInput();
     },
+    applyTransactionalState: deps.applyTransactionalState,
     resetDocument: () => {
       deps.applyState(createInitialEditorState());
       deps.resetEditorChromeState();
@@ -53563,7 +53572,16 @@ function connectEditorClientHost(controller, deps) {
     clearHistory: () => deps.clearHistory(),
     importDocx: (file) => deps.docIO.handleImportFile(file),
     exportDocx: () => Promise.resolve(deps.docIO.handleExportDocx()),
-    exportPdf: () => Promise.resolve(deps.docIO.handleExportPdf())
+    exportPdf: () => Promise.resolve(deps.docIO.handleExportPdf()),
+    exportDocxBlob: () => deps.docIO.exportDocxBlob(),
+    exportPdfBlob: () => deps.docIO.exportPdfBlob(),
+    getUiState: deps.getUiState,
+    updateUiState: deps.updateUiState,
+    getZoom: deps.getZoom,
+    setZoom: deps.setZoom,
+    adjustZoom: deps.adjustZoom,
+    toolbarRegistry: deps.toolbarRegistry,
+    menuRegistry: deps.menuRegistry
   });
 }
 function createCommandBuilder(isCommandEnabled) {
@@ -55770,12 +55788,20 @@ function createEditorCommandRuntimeImpl(deps) {
     getStateSnapshot: deps.getStateSnapshot,
     cloneState: deps.cloneState,
     applyState: deps.applyState,
+    applyTransactionalState: doc.applyTransactionalState,
     resetEditorChromeState: doc.resetEditorChromeState,
     focusInput: deps.focusInput,
     setFocused: deps.setFocused,
     clearHistory: doc.clearHistory,
     getPersistence: () => deps.documentOptions().persistence ?? doc.fallbackPersistence,
-    docIO: doc.docIO
+    docIO: doc.docIO,
+    getUiState: deps.getUiState,
+    updateUiState: deps.updateUiState,
+    getZoom: deps.zoom.zoomPercent,
+    setZoom: deps.zoom.setZoomPercent,
+    adjustZoom: deps.zoom.adjustZoom,
+    toolbarRegistry,
+    menuRegistry
   });
   createEffect(() => {
     if (!runtimeReady()) return;
@@ -55820,8 +55846,24 @@ var _tmpl$ = /* @__PURE__ */ template(`<div class="oasis-editor-shell oasis-edit
 function OasisEditorApp(props = {}) {
   var _a;
   const runtimeClient = ((_a = props.runtime) == null ? void 0 : _a.client) ?? createOasisEditorClient();
-  const ui = () => props.ui ?? {};
-  const documentOptions = () => props.document ?? {};
+  const [uiOverrides] = createSignal({});
+  const ui = () => {
+    var _a2;
+    return {
+      ...props.ui ?? {},
+      ...uiOverrides(),
+      toolbar: {
+        ...((_a2 = props.ui) == null ? void 0 : _a2.toolbar) ?? {},
+        ...uiOverrides().toolbar ?? {}
+      }
+    };
+  };
+  const documentOptions = () => ({
+    ...props.document ?? {},
+    ...uiOverrides().readOnly === void 0 ? {} : {
+      readOnly: uiOverrides().readOnly
+    }
+  });
   const runtimeOptions = () => props.runtime ?? {};
   syncCanvasDebugApiVisibility();
   const translator = createTranslator(() => ui().locale ?? "pt-BR");

package/dist/adapters/mountController.d.ts

@@ -6,7 +6,18 @@ import { OasisEditorAppProps, OasisEditorClient } from '../index.ts';
  * around their own reactivity hooks.
  */
 export interface OasisMountController {
+    /**
+     * Mounts the editor into the given container.
+     * @param container - The DOM element to mount into.
+     * @param props - Editor configuration props.
+     * @param onClient - Optional callback receiving the mounted client.
+     */
     mount(container: HTMLElement, props: OasisEditorAppProps, onClient?: (client: OasisEditorClient) => void): void;
+    /** Unmounts the editor and releases resources. */
     unmount(): void;
 }
+/**
+ * Creates a framework-agnostic mount controller.
+ * @returns A new OasisMountController.
+ */
 export declare function createOasisMountController(): OasisMountController;

package/dist/adapters/react.d.ts

@@ -1,6 +1,7 @@
 import { default as React } from 'react';
 import { OasisEditorAppProps, OasisEditorClient } from '../index.ts';
 
+/** Props for the React adapter component, extending the standard editor app props. */
 export type ReactOasisEditorProps = OasisEditorAppProps & {
     /**
      * Receives the mounted Oasis client. Props are mount-only for this adapter;
@@ -8,4 +9,11 @@ export type ReactOasisEditorProps = OasisEditorAppProps & {
      */
     onClient?: (client: OasisEditorClient) => void;
 };
+/**
+ * React component that mounts the Oasis editor. Mount-only — remount to
+ * apply a new configuration.
+ *
+ * @param props - The editor configuration props.
+ * @returns A React element wrapping the editor.
+ */
 export declare const OasisEditor: React.FC<ReactOasisEditorProps>;

package/dist/adapters/ui.d.ts

@@ -1,2 +1,2 @@
-export { ActionRow, Button, Checkbox, ColorField, ColorPicker, ColorPicker as ToolbarColorPicker, Dialog, DialogFooter, FieldGroup, FieldRow, FloatingActionButton, FormField, Grid, GridPicker, Heading, IconButton, Menu, NumberField, Popover, Radio, RadioGroup, Select, SelectField, Separator, SidePanel, SidePanelBody, SidePanelFooter, SidePanelHeader, SplitButton, Stack, StatusText, SurfaceButton, Tabs, Text, TextAreaField, TextField, ToolbarButton, ToggleChip, } from '../index.ts';
+export { Button, Checkbox, ColorField, ColorPicker, ColorPicker as ToolbarColorPicker, Dialog, DialogFooter, FieldGroup, FieldRow, FloatingActionButton, FormField, Grid, GridPicker, Heading, IconButton, Menu, NumberField, Popover, Radio, RadioGroup, Select, SelectField, Separator, SidePanel, SidePanelBody, SidePanelFooter, SidePanelHeader, SplitButton, Stack, StatusText, SurfaceButton, Tabs, Text, TextAreaField, TextField, ToolbarButton, ToggleChip, } from '../index.ts';
 export type { ActionRowProps, ButtonProps, CheckboxProps, ColorFieldProps, ColorPickerKind, ColorPickerProps, DialogFooterProps, DialogProps, FieldGroupProps, FieldRowProps, FloatingActionButtonProps, FormFieldProps, GridOffset, GridPickerProps, GridProps, GridSize, HeadingProps, IconButtonProps, MenuProps, NumberFieldProps, PopoverProps, PopoverTriggerApi, RadioGroupOption, RadioGroupProps, RadioProps, ResponsiveValue, SelectFieldOption, SelectFieldProps, SeparatorProps, SidePanelProps, SidePanelSectionProps, SplitButtonProps, StackProps, StatusTextProps, SurfaceButtonProps, TabsItem, TabsProps, TextAreaFieldProps, TextProps, TextFieldProps, ToolbarButtonProps, ToolbarSelectProps, ToggleChipProps, } from '../index.ts';

package/dist/adapters/vue.d.ts

@@ -1,6 +1,16 @@
 import { VNode, RendererNode, RendererElement, PropType } from 'vue';
 import { OasisEditorAppProps, OasisEditorClient } from '../index.ts';
 
+/**
+ * Vue 3 component that mounts the Oasis editor. Mount-only — remount to
+ * apply a new configuration.
+ *
+ * @component
+ * @param props.config - Editor configuration props.
+ * @param props.class - CSS class for the container.
+ * @param props.style - CSS style for the container.
+ * @param props.onClient - Callback receiving the mounted client.
+ */
 export declare const OasisEditor: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
     config: {
         type: () => OasisEditorAppProps;

package/dist/app/bootstrap/createOasisEditorApp.d.ts

@@ -1,5 +1,14 @@
 import { OasisEditorAppProps } from '../../ui/OasisEditorApp.js';
 import { OasisEditorClient } from '../client/OasisEditorClient.js';
 
+/** An Oasis editor instance created via {@link createOasisEditor}. */
 export type OasisEditorInstance = OasisEditorClient;
+/**
+ * Mounts the full Oasis editor application (document shell) into a container
+ * element and returns the public editor client API.
+ *
+ * @param container - The DOM element to mount the editor into.
+ * @param props - Optional editor configuration props.
+ * @returns The editor client API.
+ */
 export declare function createOasisEditor(container: HTMLElement, props?: OasisEditorAppProps): OasisEditorInstance;

package/dist/app/bootstrap/createOasisEditorContainer.d.ts

@@ -1,5 +1,14 @@
 import { OasisEditorContainerProps } from '../../ui/OasisEditorContainer.js';
 import { OasisEditorClient } from '../client/OasisEditorClient.js';
 
+/** An Oasis editor container instance created via {@link createOasisEditorContainer}. */
 export type OasisEditorContainerInstance = OasisEditorClient;
+/**
+ * Mounts the Oasis editor container component into a container element and
+ * returns the public editor client API.
+ *
+ * @param container - The DOM element to mount into.
+ * @param props - Optional container props.
+ * @returns The editor client API.
+ */
 export declare function createOasisEditorContainer(container: HTMLElement, props?: OasisEditorContainerProps): OasisEditorContainerInstance;

package/dist/app/client/OasisEditorClient.d.ts

@@ -2,80 +2,305 @@ import { EditorDocument, EditorSelection, EditorState } from '../../core/model.j
 import { Editor } from '../../core/Editor.js';
 import { ToolbarCommandState } from '../../ui/components/Toolbar/schema/items.js';
 import { TypedCommandBus } from '../../core/commands/publicCommandTypes.js';
+import { queryDocument, ApplyEditRequest, ApplyEditValue, DocumentRange, DocumentSelector, OasisResult, SemanticDocumentSnapshot } from './publicDocumentApi.js';
+import { ToolbarRegistry } from '../../ui/components/Toolbar/registry/ToolbarRegistry.js';
+import { MenuRegistry } from '../../ui/components/Menubar/menuRegistry.js';
 
-export type OasisEditorClientEvent = "ready" | "change" | "documentChange" | "selectionChange" | "error";
+/** UI-related editor state that can be toggled or configured at runtime. */
+export interface OasisEditorUiState {
+    showChrome?: boolean;
+    showTitleBar?: boolean;
+    showMenubar?: boolean;
+    showToolbar?: boolean;
+    showOutline?: boolean;
+    shell?: "document" | "inline" | "balloon";
+    locale?: "pt-BR" | "en";
+    toolbar?: {
+        view?: "ribbon" | "compact";
+        layout?: "overflow" | "wrap";
+    };
+    viewportHeight?: number | string;
+    readOnly?: boolean;
+}
+/** Events emitted by the editor client lifecycle. */
+export type OasisEditorClientEvent = "ready" | "change" | "documentChange" | "selectionChange" | "uiChange" | "error";
+/** Payload types associated with each client event. */
 export interface OasisEditorClientEvents {
     ready: Editor;
     change: EditorState;
     documentChange: EditorDocument;
     selectionChange: EditorSelection;
+    uiChange: OasisEditorUiState;
     error: unknown;
 }
+/**
+ * Handler signature for subscribing to client events.
+ * @typeParam TEvent - The specific event type being handled.
+ */
 export type OasisEditorClientEventHandler<TEvent extends OasisEditorClientEvent = OasisEditorClientEvent> = (payload: OasisEditorClientEvents[TEvent]) => void;
+/** Low-level document CRUD API exposed through the editor client. */
 export interface OasisEditorDocumentApi {
+    /** Returns the current document. */
     get(): EditorDocument;
+    /** @param document - The new document to set. Marks the editor dirty. */
     set(document: EditorDocument): void;
+    /** @param document - The document to load. Does NOT mark the editor dirty. */
     load(document: EditorDocument): void;
+    /** @param updater - Function that receives the current document and returns the new one. */
     update(updater: (document: EditorDocument) => EditorDocument): void;
+    /** Resets the document to its initial empty state. */
     reset(): void;
+    /** @returns A promise that resolves once the document is persisted. */
     save(): Promise<void>;
+    /** @returns `true` if the document has unsaved changes. */
     isDirty(): boolean;
+    /** Marks the document as clean (no unsaved changes). */
     markClean(): void;
+    /** @returns A monotonically increasing version counter, incremented on every mutation. */
+    version(): number;
+}
+/** Query API for reading the document without mutation. */
+export interface OasisEditorQueryApi {
+    /** @returns A snapshot of the entire document (text, outline, nodes). */
+    snapshot(): SemanticDocumentSnapshot;
+    /**
+     * @param target - Optional selector or range to scope the text to.
+     * @returns Plain text for the whole document or a specific target/range.
+     */
+    getText(target?: DocumentSelector | DocumentRange): string;
+    /**
+     * @param selector - The selector identifying the node.
+     * @returns A semantic node descriptor, or `null` if not found.
+     */
+    getNode(selector: DocumentSelector): ReturnType<ReturnType<typeof queryDocument>["getNode"]>;
+    /**
+     * @param text - The text to search for.
+     * @returns An array of match descriptors.
+     */
+    find(text: string): ReturnType<ReturnType<typeof queryDocument>["find"]>;
+    /** @returns The document outline (heading-based hierarchy). */
+    outline(): ReturnType<ReturnType<typeof queryDocument>["outline"]>;
+}
+/** Edit API for applying structured operations to the document. */
+export interface OasisEditorEditApi {
+    /**
+     * Applies one or more edit operations.
+     * @param request - The edit request containing operations and optional version checks.
+     * @returns A result indicating success or failure with error details.
+     */
+    apply(request: ApplyEditRequest): Promise<OasisResult<ApplyEditValue>>;
 }
+/** Selection read/write API. */
 export interface OasisEditorSelectionApi {
+    /** @returns The current selection. */
     get(): EditorSelection;
+    /** @param selection - The new selection to set. */
     set(selection: EditorSelection): void;
 }
+/** Focus management API. */
 export interface OasisEditorFocusApi {
+    /** Focuses the editor input area. */
     focus(): void;
+    /** Blurs the editor input area. */
     blur(): void;
 }
+/** History (undo/redo) API. */
 export interface OasisEditorHistoryApi {
+    /** @returns The result of undoing the last operation. */
     undo(): unknown;
+    /** @returns The result of reapplying the last undone operation. */
     redo(): unknown;
+    /** @returns `true` if undo is available. */
     canUndo(): boolean;
+    /** @returns `true` if redo is available. */
     canRedo(): boolean;
+    /** Clears the entire undo/redo history. */
     clear(): void;
 }
+/** File import API. */
 export interface OasisEditorImportApi {
+    /**
+     * Imports a .docx file from a browser File object.
+     * @param file - The .docx file to import.
+     */
     docx(file: File): Promise<void>;
 }
+/** File export API. */
 export interface OasisEditorExportApi {
+    /** @returns A promise resolving to the exported .docx data. */
     docx(): Promise<unknown>;
+    /** @returns A promise resolving to the exported .pdf data. */
     pdf(): Promise<unknown>;
 }
+/** Data input/output API with progress reporting and result wrapping. */
+export interface OasisEditorDataIoApi {
+    /**
+     * Imports a document from raw data.
+     * @param request - Import configuration including format, data, and optional progress callback.
+     * @returns A wrapped result indicating success or failure.
+     */
+    import(request: {
+        format: "docx";
+        data: Blob | ArrayBuffer | Uint8Array;
+        filename?: string;
+        signal?: AbortSignal;
+        onProgress?: (progress: unknown) => void;
+    }): Promise<OasisResult<{
+        format: "docx";
+    }>>;
+    /**
+     * Exports the document as a Blob in the requested format.
+     * @param request - Export configuration including format and optional filename.
+     * @returns A wrapped result containing the blob.
+     */
+    export(request: {
+        format: "docx" | "pdf";
+        filename?: string;
+    }): Promise<OasisResult<{
+        format: "docx" | "pdf";
+        blob: Blob;
+        arrayBuffer: () => Promise<ArrayBuffer>;
+    }>>;
+}
+/** UI configuration and chrome API. */
+export interface OasisEditorUiApi {
+    /** @returns The current UI state. */
+    state(): OasisEditorUiState;
+    /**
+     * Applies a partial UI state patch.
+     * @param patch - The partial state to apply.
+     * @returns The new UI state after applying the patch.
+     */
+    update(patch: OasisEditorUiState): OasisEditorUiState;
+    /** @param value - Whether the editor should be read-only. */
+    setReadOnly(value: boolean): void;
+    /** Zoom controls. */
+    zoom: {
+        get(): number;
+        set(value: number): void;
+        adjust(delta: number): void;
+    };
+    /** Chrome visibility controls. */
+    chrome: {
+        setVisible(value: boolean): void;
+    };
+    /** Title bar visibility control. */
+    titleBar: {
+        setVisible(value: boolean): void;
+    };
+    /** Menubar visibility and item registry. */
+    menubar: {
+        setVisible(value: boolean): void;
+        items: MenuRegistry;
+    };
+    /** Toolbar visibility and item registry. */
+    toolbar: {
+        setVisible(value: boolean): void;
+        items: ToolbarRegistry;
+    };
+    /** Outline panel visibility control. */
+    outline: {
+        setVisible(value: boolean): void;
+    };
+    /** @param value - The shell mode to set. */
+    shell: {
+        set(value: "document" | "inline" | "balloon"): void;
+    };
+    /** @param value - The locale to set. */
+    locale: {
+        set(value: "pt-BR" | "en"): void;
+    };
+}
+/**
+ * The main public API surface of an Oasis Editor instance. Returned by
+ * {@link createOasisEditor} and {@link createOasisEditorContainer}.
+ */
 export interface OasisEditorClient {
+    /** Resolves once the editor runtime is fully initialized. */
     readonly ready: Promise<Editor>;
+    /** Typed command bus for dispatching editor commands. */
     readonly commands: TypedCommandBus<ToolbarCommandState>;
+    /** Document CRUD API. */
     readonly document: OasisEditorDocumentApi;
+    /** Selection API. */
     readonly selection: OasisEditorSelectionApi;
+    /** Focus API. */
     readonly focus: OasisEditorFocusApi;
+    /** History (undo/redo) API. */
     readonly history: OasisEditorHistoryApi;
+    /** File import API. */
     readonly import: OasisEditorImportApi;
+    /** File export API. */
     readonly export: OasisEditorExportApi;
+    /** Document query API. */
+    readonly query: OasisEditorQueryApi;
+    /** Document edit API. */
+    readonly edit: OasisEditorEditApi;
+    /** Data import/export API with result wrapping. */
+    readonly io: OasisEditorDataIoApi;
+    /** UI configuration API. */
+    readonly ui: OasisEditorUiApi;
+    /** Disposes the editor, releasing resources. */
     dispose(): void | Promise<void>;
+    /** @returns The current editor state. */
     getState(): EditorState;
+    /** @returns The current document. */
     getDocument(): EditorDocument;
+    /** @param document - The new document to set. Marks the editor dirty. */
     setDocument(document: EditorDocument): void;
+    /** @param document - The document to load. Does NOT mark the editor dirty. */
     loadDocument(document: EditorDocument): void;
+    /**
+     * @param updater - Function that receives the current document and returns the new one.
+     */
     updateDocument(updater: (document: EditorDocument) => EditorDocument): void;
+    /** Resets the document to its initial state. */
     resetDocument(): void;
+    /** @returns A promise that resolves once the document is persisted. */
     save(): Promise<void>;
+    /** @returns `true` if the document has unsaved changes. */
     isDirty(): boolean;
+    /** Marks the document as clean. */
     markClean(): void;
+    /** @returns The current selection. */
     getSelection(): EditorSelection;
+    /** @param selection - The new selection to set. */
     setSelection(selection: EditorSelection): void;
+    /** Focuses the editor. */
     focusEditor(): void;
+    /** Blurs the editor. */
     blurEditor(): void;
+    /**
+     * Subscribes to a client event.
+     * @param event - The event name.
+     * @param callback - The handler to invoke when the event fires.
+     * @returns An unsubscribe function.
+     */
     on<TEvent extends OasisEditorClientEvent>(event: TEvent, callback: OasisEditorClientEventHandler<TEvent>): () => void;
+    /**
+     * Subscribes to a single emission of a client event.
+     * @param event - The event name.
+     * @param callback - The handler to invoke once.
+     * @returns An unsubscribe function.
+     */
     once<TEvent extends OasisEditorClientEvent>(event: TEvent, callback: OasisEditorClientEventHandler<TEvent>): () => void;
+    /**
+     * Removes a previously subscribed event handler.
+     * @param event - The event name.
+     * @param callback - The handler to remove.
+     */
     off<TEvent extends OasisEditorClientEvent>(event: TEvent, callback: OasisEditorClientEventHandler<TEvent>): void;
 }
+/**
+ * Internal contract used by the host (editor UI shell) to drive the client.
+ * Extends the public {@link OasisEditorClient} with connection lifecycle methods.
+ */
 export interface OasisEditorClientHost {
     getRuntimeEditor(): Editor | null;
     getState(): EditorState;
     getDocument(): EditorDocument;
     setDocument(document: EditorDocument): void;
+    applyTransactionalState?(producer: (state: EditorState) => EditorState): void;
     resetDocument(): void;
     saveDocument(): Promise<void>;
     getSelection(): EditorSelection;
@@ -86,12 +311,40 @@ export interface OasisEditorClientHost {
     importDocx(file: File): Promise<void>;
     exportDocx(): Promise<unknown>;
     exportPdf(): Promise<unknown>;
+    exportDocxBlob(): Promise<Blob>;
+    exportPdfBlob(): Promise<Blob>;
+    getUiState?(): OasisEditorUiState;
+    updateUiState?(patch: OasisEditorUiState): OasisEditorUiState;
+    getZoom?(): number;
+    setZoom?(value: number): void;
+    adjustZoom?(delta: number): void;
+    toolbarRegistry?: ToolbarRegistry;
+    menuRegistry?: MenuRegistry;
 }
+/**
+ * Combined interface for the internal client-controller, extending the public
+ * API with host connection, disposal, ready resolution, and event emission.
+ */
 export interface OasisEditorClientController extends OasisEditorClient {
+    /** @param host - The host to connect. */
     connectHost(host: OasisEditorClientHost): void;
+    /** @param dispose - The dispose function to call on cleanup. */
     setDispose(dispose: () => void | Promise<void>): void;
+    /** @param editor - The editor instance that is now ready. */
     resolveReady(editor: Editor): void;
+    /** @param error - The error that prevented initialization. */
     rejectReady(error: unknown): void;
+    /**
+     * Emits a client event.
+     * @param event - The event name.
+     * @param payload - The event payload.
+     */
     emit<TEvent extends OasisEditorClientEvent>(event: TEvent, payload: OasisEditorClientEvents[TEvent]): void;
 }
+/**
+ * Creates a new editor client controller. The client is a lightweight broker
+ * that connects the public API surface to the host runtime once mounted.
+ *
+ * @returns A new {@link OasisEditorClientController} instance.
+ */
 export declare function createOasisEditorClient(): OasisEditorClientController;