oasis-editor 0.0.1 → 0.0.3

package/dist/core/model.d.ts

@@ -1,447 +1,10 @@
-export type EditorUnderlineStyle = "single" | "double" | "thick" | "dotted" | "dottedHeavy" | "dash" | "dashedHeavy" | "dashLong" | "dashLongHeavy" | "dotDash" | "dashDotHeavy" | "dotDotDash" | "dashDotDotHeavy" | "wave" | "wavyHeavy" | "wavyDouble" | "words";
-export type EditorLigatures = "none" | "standard" | "contextual" | "historical" | "standardContextual";
-export type EditorNumberSpacing = "default" | "proportional" | "tabular";
-export type EditorNumberForm = "default" | "lining" | "oldStyle";
-export interface EditorTextStyle {
-    styleId?: string;
-    bold?: boolean;
-    italic?: boolean;
-    underline?: boolean;
-    underlineStyle?: EditorUnderlineStyle | null;
-    underlineColor?: string | null;
-    strike?: boolean;
-    doubleStrike?: boolean;
-    superscript?: boolean;
-    subscript?: boolean;
-    smallCaps?: boolean;
-    allCaps?: boolean;
-    hidden?: boolean;
-    characterScale?: number | null;
-    characterSpacing?: number | null;
-    baselineShift?: number | null;
-    kerningThreshold?: number | null;
-    ligatures?: EditorLigatures | null;
-    numberSpacing?: EditorNumberSpacing | null;
-    numberForm?: EditorNumberForm | null;
-    stylisticSet?: number | null;
-    contextualAlternates?: boolean;
-    fontFamily?: string | null;
-    fontSize?: number | null;
-    color?: string | null;
-    highlight?: string | null;
-    link?: string | null;
-}
-export interface EditorTabStop {
-    position: number;
-    type: "left" | "center" | "right" | "decimal" | "bar" | "clear";
-    leader?: "none" | "dot" | "hyphen" | "underscore" | "heavy" | "middleDot";
-}
-export interface EditorParagraphStyle {
-    styleId?: string;
-    align?: "left" | "center" | "right" | "justify";
-    spacingBefore?: number | null;
-    spacingAfter?: number | null;
-    lineHeight?: number | null;
-    lineGridPitch?: number | null;
-    lineGridType?: "lines" | "linesAndChars" | "snapToChars" | "implicit" | null;
-    snapToGrid?: boolean;
-    indentLeft?: number | null;
-    indentRight?: number | null;
-    indentFirstLine?: number | null;
-    indentHanging?: number | null;
-    shading?: string | null;
-    borderTop?: EditorBorderStyle | null;
-    borderRight?: EditorBorderStyle | null;
-    borderBottom?: EditorBorderStyle | null;
-    borderLeft?: EditorBorderStyle | null;
-    tabs?: EditorTabStop[] | null;
-    pageBreakBefore?: boolean;
-    keepWithNext?: boolean;
-    keepLinesTogether?: boolean;
-    widowControl?: boolean;
-}
-export interface EditorNamedStyle {
-    id: string;
-    name: string;
-    type: "paragraph" | "character" | "table";
-    basedOn?: string;
-    nextStyle?: string;
-    paragraphStyle?: EditorParagraphStyle;
-    textStyle?: EditorTextStyle;
-    tableStyle?: EditorTableStyle;
-}
-export interface EditorParagraphListStyle {
-    kind: "bullet" | "ordered";
-    level?: number;
-    format?: "decimal" | "lowerLetter" | "upperLetter" | "lowerRoman" | "upperRoman" | "bullet";
-    startAt?: number;
-}
-export interface EditorImageRunData {
-    src: string;
-    width: number;
-    height: number;
-    alt?: string;
-}
-export interface EditorFieldData {
-    type: "PAGE" | "NUMPAGES";
-}
 /**
- * Inline reference to a footnote body stored in `EditorDocument.footnotes`.
- * The `run.text` carries the materialized marker (e.g. "1", "2", "*") so
- * layout, hit-testing and export can treat the run as ordinary text.
+ * Re-export the refactored model module under its original path.
  *
- * Renumbering rewrites `run.text` to keep markers in sync with document
- * order. `customMark` (mapped from DOCX `w:customMarkFollows`) signals a
- * user-provided marker that should not be auto-numbered.
+ * The 1411-line monolithic `model.ts` was split into focused modules under
+ * `./model/` (types, queries, styleResolution, pageGeometry, documentIndex,
+ * editingZones, etc.). This file is now a one-liner barrel so the 43+
+ * existing `import { ... } from "../model.js"` sites continue to work
+ * without any change.
  */
-export interface EditorFootnoteReferenceData {
-    footnoteId: string;
-    customMark?: string;
-}
-export interface EditorRevision {
-    id: string;
-    type: "insert" | "delete";
-    author: string;
-    date: number;
-}
-export interface EditorTextRun {
-    id: string;
-    text: string;
-    styles?: EditorTextStyle;
-    image?: EditorImageRunData;
-    field?: EditorFieldData;
-    revision?: EditorRevision;
-    /**
-     * When set, this run is the inline marker of a footnote whose body lives in
-     * `EditorDocument.footnotes.items[footnoteReference.footnoteId]`. The run
-     * should be treated as atomic for selection/editing purposes.
-     */
-    footnoteReference?: EditorFootnoteReferenceData;
-}
-export interface EditorParagraphNode {
-    id: string;
-    type: "paragraph";
-    runs: EditorTextRun[];
-    style?: EditorParagraphStyle;
-    list?: EditorParagraphListStyle;
-}
-export interface EditorBorderStyle {
-    width: number;
-    type: "solid" | "dashed" | "dotted" | "none";
-    color: string;
-}
-export interface EditorTableCellStyle {
-    shading?: string;
-    width?: number | string;
-    borderTop?: EditorBorderStyle;
-    borderRight?: EditorBorderStyle;
-    borderBottom?: EditorBorderStyle;
-    borderLeft?: EditorBorderStyle;
-    padding?: number;
-    paddingTop?: number;
-    paddingRight?: number;
-    paddingBottom?: number;
-    paddingLeft?: number;
-    verticalAlign?: "top" | "middle" | "bottom";
-    horizontalAlign?: "left" | "center" | "right" | "justify";
-}
-export interface EditorTableCellNode {
-    id: string;
-    blocks: EditorParagraphNode[];
-    colSpan?: number;
-    rowSpan?: number;
-    vMerge?: "restart" | "continue";
-    style?: EditorTableCellStyle;
-}
-export interface EditorTableRowStyle {
-    height?: number | string;
-}
-export interface EditorTableRowNode {
-    id: string;
-    cells: EditorTableCellNode[];
-    isHeader?: boolean;
-    style?: EditorTableRowStyle;
-}
-export interface EditorTableStyle {
-    styleId?: string;
-    width?: number | string;
-    align?: "left" | "center" | "right";
-    indentLeft?: number;
-    pageBreakBefore?: boolean;
-}
-export interface EditorTableNode {
-    id: string;
-    type: "table";
-    rows: EditorTableRowNode[];
-    gridCols?: number[];
-    style?: EditorTableStyle;
-}
-export type EditorBlockNode = EditorParagraphNode | EditorTableNode;
-export interface EditorPageMargins {
-    top: number;
-    right: number;
-    bottom: number;
-    left: number;
-    header: number;
-    footer: number;
-    gutter: number;
-}
-export interface EditorPageSettings {
-    width: number;
-    height: number;
-    orientation?: "portrait" | "landscape";
-    margins: EditorPageMargins;
-}
-export interface EditorSection {
-    id: string;
-    blocks: EditorBlockNode[];
-    pageSettings: EditorPageSettings;
-    header?: EditorBlockNode[];
-    firstPageHeader?: EditorBlockNode[];
-    evenPageHeader?: EditorBlockNode[];
-    footer?: EditorBlockNode[];
-    firstPageFooter?: EditorBlockNode[];
-    evenPageFooter?: EditorBlockNode[];
-    breakType?: "nextPage" | "continuous";
-}
-/**
- * An out-of-band asset bundled with the document (e.g. an embedded image).
- * Heavy binary data (data URLs) lives here exactly once; runs reference it
- * via `image.src = "asset:<id>"`. Keeping payloads off the per-paragraph
- * state lets equality checks, signatures and clones stay cheap on every
- * keystroke even when a document embeds large images.
- */
-export interface EditorAsset {
-    id: string;
-    /** Full data URL (e.g. `data:image/png;base64,...`) or remote URL. */
-    url: string;
-}
-export declare const EDITOR_ASSET_REF_PREFIX = "asset:";
-export type EditorFootnoteNumberFormat = "decimal" | "lowerRoman" | "upperRoman" | "lowerLetter" | "upperLetter" | "symbol";
-export type EditorFootnoteRestart = "continuous" | "eachSection";
-/**
- * Body of a single footnote. `blocks` is fully editable, mirroring the
- * shape of a section's main content. The DOCX `<w:footnoteRef/>` marker
- * inside the body is NOT stored here — render/export reinjects it.
- */
-export interface EditorFootnote {
-    id: string;
-    blocks: EditorBlockNode[];
-    /** Original DOCX `w:id`, kept for round-trip diagnostics only. */
-    docxId?: number;
-}
-export interface EditorFootnoteSettings {
-    numberFormat?: EditorFootnoteNumberFormat;
-    restart?: EditorFootnoteRestart;
-    startAt?: number;
-}
-export interface EditorFootnotes {
-    items: Record<string, EditorFootnote>;
-    settings?: EditorFootnoteSettings;
-    /** Optional imported separator part (Fase futura: render/export). */
-    separator?: EditorBlockNode[];
-    /** Optional imported continuation separator part (Fase futura). */
-    continuationSeparator?: EditorBlockNode[];
-}
-export interface EditorDocument {
-    id: string;
-    pageSettings?: EditorPageSettings;
-    sections?: EditorSection[];
-    styles?: Record<string, EditorNamedStyle>;
-    /**
-     * Out-of-band asset registry. Image runs reference entries here using
-     * `src = "asset:<id>"`. The map itself is treated as append-only and is
-     * deliberately excluded from per-keystroke equality checks/signatures.
-     */
-    assets?: Record<string, EditorAsset>;
-    /**
-     * Footnote bodies keyed by id. Inline references live in
-     * `EditorTextRun.footnoteReference` and point here. May be undefined when
-     * the document has no notes.
-     */
-    footnotes?: EditorFootnotes;
-    metadata?: {
-        title?: string;
-        [key: string]: any;
-    };
-}
-export { getParagraphLength, getParagraphText, getRunIndex, getRunStartOffset, paragraphOffsetToPosition, positionToParagraphOffset, } from '../model/queries.js';
-/**
- * Resolve an `asset:<id>` reference (or pass through any other src) to the
- * actual URL using the document's asset registry.
- */
-export declare function resolveImageSrc(document: Pick<EditorDocument, "assets"> | undefined, src: string | undefined): string;
-export declare const EFFECTIVE_TEXT_STYLE_DEFAULTS: Required<EditorTextStyle>;
-export declare const EFFECTIVE_PARAGRAPH_STYLE_DEFAULTS: Required<EditorParagraphStyle>;
-export declare function resolveNamedTextStyle(styleId: string | undefined, styles: Record<string, EditorNamedStyle> | undefined): EditorTextStyle;
-export declare function resolveNamedParagraphStyle(styleId: string | undefined, styles: Record<string, EditorNamedStyle> | undefined): EditorParagraphStyle;
-/**
- * Resolve the effective text style for a run:
- * 1. Resolve named style via styleId + basedOn chain
- * 2. Apply local overrides (undefined → inherit, null → keep as null for reset)
- * 3. Fill in system defaults for any remaining undefined values
- */
-export declare function resolveEffectiveTextStyle(style: EditorTextStyle | undefined, styles: Record<string, EditorNamedStyle> | undefined): Required<EditorTextStyle>;
-/**
- * Resolve the effective text style for a run, inheriting textStyle from the
- * paragraph named style when the run does not override it locally.
- */
-export declare function resolveEffectiveTextStyleForParagraph(style: EditorTextStyle | undefined, paragraphStyleId: string | undefined, styles: Record<string, EditorNamedStyle> | undefined): Required<EditorTextStyle>;
-/**
- * Resolve the effective paragraph style:
- * 1. Resolve named style via styleId + basedOn chain
- * 2. Apply local overrides (undefined → inherit, null → keep as null for reset)
- * 3. Fill in system defaults for any remaining undefined values
- */
-export declare function resolveEffectiveParagraphStyle(style: EditorParagraphStyle | undefined, styles: Record<string, EditorNamedStyle> | undefined): Required<EditorParagraphStyle>;
-export interface EditorPosition {
-    paragraphId: string;
-    runId: string;
-    offset: number;
-}
-export interface EditorSelection {
-    anchor: EditorPosition;
-    focus: EditorPosition;
-}
-export type EditorEditingZone = "main" | "header" | "footer" | "footnote";
-export interface EditorState {
-    document: EditorDocument;
-    selection: EditorSelection;
-    activeSectionIndex?: number;
-    activeZone?: EditorEditingZone;
-    /**
-     * Identifies the footnote currently being edited when `activeZone === "footnote"`.
-     * Ignored for other zones.
-     */
-    activeFootnoteId?: string;
-    trackChangesEnabled?: boolean;
-    showMargins?: boolean;
-    showParagraphMarks?: boolean;
-}
-export interface EditorCaretSlot {
-    paragraphId: string;
-    offset: number;
-    left: number;
-    top: number;
-    height: number;
-}
-export interface EditorLayoutFragmentChar {
-    char: string;
-    paragraphOffset: number;
-    runOffset: number;
-}
-export interface EditorLayoutFragment {
-    paragraphId: string;
-    runId: string;
-    startOffset: number;
-    endOffset: number;
-    text: string;
-    styles?: EditorTextStyle;
-    image?: EditorImageRunData;
-    revision?: EditorRevision;
-    chars: EditorLayoutFragmentChar[];
-}
-export interface EditorLayoutLine {
-    paragraphId: string;
-    index: number;
-    startOffset: number;
-    endOffset: number;
-    top: number;
-    height: number;
-    slots: EditorCaretSlot[];
-    fragments: EditorLayoutFragment[];
-}
-export interface EditorLayoutParagraph {
-    paragraphId: string;
-    text: string;
-    fragments: EditorLayoutFragment[];
-    lines: EditorLayoutLine[];
-    startOffset?: number;
-    endOffset?: number;
-    contentWidth?: number;
-}
-export interface EditorLayoutBlock {
-    blockId: string;
-    blockType: EditorBlockNode["type"];
-    paragraphId?: string;
-    globalIndex: number;
-    estimatedHeight: number;
-    layout?: EditorLayoutParagraph;
-    tableSegment?: {
-        startRowIndex: number;
-        endRowIndex: number;
-        repeatedHeaderRowCount: number;
-    };
-    sourceBlockId?: string;
-    sourceBlock: EditorBlockNode;
-}
-export interface EditorLayoutPage {
-    id: string;
-    index: number;
-    height: number;
-    maxHeight: number;
-    blocks: EditorLayoutBlock[];
-    pageSettings: EditorPageSettings;
-    headerBlocks?: EditorLayoutBlock[];
-    footerBlocks?: EditorLayoutBlock[];
-    footnoteBlocks?: EditorLayoutBlock[];
-    footnoteReferenceIds?: string[];
-    bodyTop?: number;
-    bodyBottom?: number;
-    headerTop?: number;
-    footerTop?: number;
-    footnoteTop?: number;
-    footnoteSeparatorTop?: number;
-}
-export interface EditorLayoutDocument {
-    pages: EditorLayoutPage[];
-}
-export declare const DEFAULT_EDITOR_PAGE_SETTINGS: EditorPageSettings;
-export declare function normalizePageSettings(pageSettings: EditorPageSettings): EditorPageSettings;
-export declare function getDocumentPageSettings(document: EditorDocument): EditorPageSettings;
-export declare function getPageContentWidth(pageSettings: EditorPageSettings): number;
-export declare function getPageHeaderZoneTop(pageSettings: EditorPageSettings): number;
-export declare function getPageBodyTop(pageSettings: EditorPageSettings): number;
-export declare function getPageFooterReferenceTop(pageSettings: EditorPageSettings): number;
-export declare function getPageBodyBottom(pageSettings: EditorPageSettings): number;
-export declare function getPageHeaderZoneHeight(pageSettings: EditorPageSettings): number;
-export declare function getPageFooterZoneTop(pageSettings: EditorPageSettings): number;
-export declare function getPageFooterZoneHeight(pageSettings: EditorPageSettings): number;
-export declare function getPageContentHeight(pageSettings: EditorPageSettings): number;
-export declare function getDocumentSectionsCanonical(document: EditorDocument): EditorSection[];
-export declare function getDocumentSections(document: EditorDocument): EditorSection[];
-export declare function getEditableBlocksForZone(state: EditorState, zone: EditorEditingZone): EditorBlockNode[];
-export declare function getActiveSectionBlocks(state: EditorState): EditorBlockNode[];
-export declare function getBlockParagraphs(block: EditorBlockNode): EditorParagraphNode[];
-export declare function getDocumentParagraphsCanonical(document: EditorDocument): EditorParagraphNode[];
-export declare function getDocumentParagraphs(document: EditorDocument): EditorParagraphNode[];
-export declare function getParagraphs(state: EditorState): EditorParagraphNode[];
-export declare function getActiveSectionIndex(state: EditorState): number;
-export declare function getActiveZone(state: EditorState): EditorEditingZone;
-export interface EditorParagraphLocation {
-    sectionIndex: number;
-    zone: EditorEditingZone;
-    paragraphIndexInSection: number;
-    /** When `zone === "footnote"`, identifies which footnote owns the paragraph. */
-    footnoteId?: string;
-}
-export interface DocumentParagraphIndexEntry {
-    paragraph: EditorParagraphNode;
-    location: EditorParagraphLocation;
-    tableLocation: {
-        blockIndex: number;
-        rowIndex: number;
-        cellIndex: number;
-        paragraphIndex: number;
-    } | null;
-}
-export declare function getDocumentParagraphIndex(document: EditorDocument): Map<string, DocumentParagraphIndexEntry>;
-export declare function getParagraphById(document: EditorDocument, paragraphId: string): EditorParagraphNode | undefined;
-export declare function findParagraphLocation(document: EditorDocument, paragraphId: string): EditorParagraphLocation | null;
-export declare function findParagraphTableLocation(document: EditorDocument, paragraphId: string, activeSectionIndex?: number): {
-    blockIndex: number;
-    rowIndex: number;
-    cellIndex: number;
-    paragraphIndex: number;
-    zone: EditorEditingZone;
-} | null;
+export * from '../model/index.js';

package/dist/core/plugin.d.ts

@@ -1,17 +1,29 @@
+import { JSX } from '../solid-js';
 import { EditorState } from '../model.js';
 import { Editor } from '../Editor.js';
 import { CommandRef } from '../commands/CommandRef.js';
 
 export type Unsubscribe = () => void;
+export interface OasisCommandContext {
+    editor: OasisEditor;
+    commands: OasisCommandRegistry;
+    ui: OasisPluginUiRegistry;
+    getState(): EditorState;
+    getDocument(): EditorState["document"];
+    getSelection(): EditorState["selection"];
+}
 export interface OasisCommand<TPayload = unknown, TResult = unknown> {
-    execute: (payload?: TPayload) => TResult;
-    refresh?: (payload?: TPayload) => CommandState;
+    execute: (payload?: TPayload, context?: OasisCommandContext) => TResult;
+    refresh?: (payload?: TPayload, context?: OasisCommandContext) => CommandState;
 }
 export interface OasisCommandRegistry {
     register: <TPayload = unknown, TResult = unknown>(name: string, command: OasisCommand<TPayload, TResult>) => void;
     unregister: (name: string) => void;
     get: (name: string) => OasisCommand | undefined;
     has: (name: string) => boolean;
+    execute: <TPayload = unknown, TResult = unknown>(name: string, payload?: TPayload) => TResult;
+    canExecute: (name: string, payload?: unknown) => boolean;
+    state: (name: string, payload?: unknown) => CommandState;
 }
 export interface CommandState {
     isEnabled: boolean;
@@ -21,10 +33,7 @@ export interface CommandState {
 export interface OasisEditor {
     readonly state: EditorState;
     readonly commands: OasisCommandRegistry;
-    registerCommand: <TPayload = unknown, TResult = unknown>(name: string, command: OasisCommand<TPayload, TResult>) => void;
-    unregisterCommand: (name: string) => void;
-    execute: <TPayload = unknown, TResult = unknown>(name: string, payload?: TPayload) => TResult;
-    canExecute: (name: string, payload?: unknown) => boolean;
+    readonly ui: OasisPluginUiRegistry;
     on: (event: string, callback: (...args: unknown[]) => void) => Unsubscribe;
     once: (event: string, callback: (...args: unknown[]) => void) => Unsubscribe;
     off: (event: string, callback: (...args: unknown[]) => void) => void;
@@ -42,6 +51,49 @@ export interface PluginMenuItem extends PluginAction {
     separator?: boolean;
     labelKey?: string;
 }
+export type FloatingActionScope = "container" | "viewport";
+export type FloatingActionPlacement = "bottom-right" | "bottom-left" | "top-right" | "top-left";
+export interface FloatingActionContribution extends PluginAction {
+    label?: string;
+    labelKey?: string;
+    tooltip?: string;
+    scope?: FloatingActionScope;
+    placement?: FloatingActionPlacement;
+    order?: number;
+}
+export type SidePanelMode = "dock" | "overlay";
+export interface PluginUiRenderContext extends OasisCommandContext {
+    panelId?: string;
+    closePanel?: () => void;
+}
+export interface SidePanelContribution {
+    id: string;
+    title: string;
+    titleKey?: string;
+    icon?: string;
+    mode?: SidePanelMode;
+    width?: number | string;
+    order?: number;
+    render: (context: PluginUiRenderContext) => JSX.Element;
+}
+export interface OasisPluginUiContributions {
+    floatingActions?: FloatingActionContribution[];
+    sidePanels?: SidePanelContribution[];
+}
+export interface OasisPluginUiSnapshot {
+    floatingActions: FloatingActionContribution[];
+    sidePanels: SidePanelContribution[];
+    activeSidePanelId: string | null;
+}
+export interface OasisPluginUiRegistry {
+    registerFloatingAction(contribution: FloatingActionContribution): Unsubscribe;
+    registerSidePanel(contribution: SidePanelContribution): Unsubscribe;
+    openSidePanel(id: string): void;
+    closeSidePanel(id?: string): void;
+    toggleSidePanel(id: string): void;
+    getSnapshot(): OasisPluginUiSnapshot;
+    onChange(callback: () => void): Unsubscribe;
+}
 export interface OasisPlugin {
     name: string;
     requires?: PluginReference[];
@@ -56,6 +108,7 @@ export interface OasisPlugin {
     }>;
     toolbar?: PluginAction[];
     menubar?: PluginMenuItem[];
+    ui?: OasisPluginUiContributions;
     init?: (editor: OasisEditor) => void | Promise<void>;
     afterInit?: (editor: OasisEditor) => void | Promise<void>;
     destroy?: (editor: OasisEditor) => void | Promise<void>;

package/dist/core/plugins/PluginCollection.d.ts

@@ -11,6 +11,7 @@ export declare class PluginCollection {
     initializeAll(): Promise<void>;
     private initializePlugin;
     private registerPluginCommands;
+    private registerPluginUi;
     destroy(): Promise<void>;
     getPlugins(): OasisPlugin[];
 }

package/dist/core/plugins/PluginUiRegistry.d.ts

@@ -0,0 +1,20 @@
+import { FloatingActionContribution, OasisPluginUiRegistry, OasisPluginUiSnapshot, SidePanelContribution, Unsubscribe } from '../../../plugin.js';
+
+export declare class PluginUiRegistry implements OasisPluginUiRegistry {
+    private floatingActions;
+    private sidePanels;
+    private activeSidePanelId;
+    private listeners;
+    registerFloatingAction(contribution: FloatingActionContribution): Unsubscribe;
+    registerSidePanel(contribution: SidePanelContribution): Unsubscribe;
+    openSidePanel(id: string): void;
+    closeSidePanel(id?: string): void;
+    toggleSidePanel(id: string): void;
+    getSnapshot(): OasisPluginUiSnapshot;
+    onChange(callback: () => void): Unsubscribe;
+    clear(): void;
+    private unregisterFloatingAction;
+    private unregisterSidePanel;
+    private sort;
+    private emit;
+}

package/dist/core/selection/navigation.d.ts

@@ -0,0 +1,5 @@
+import { EditorState } from '../../../model.js';
+
+export declare function moveVertical(state: EditorState, delta: -1 | 1): EditorState;
+export declare function moveFocusHorizontally(state: EditorState, delta: -1 | 1): EditorState;
+export declare function moveFocusVertical(state: EditorState, delta: -1 | 1): EditorState;

package/dist/core/selection/rangeEditing.d.ts

@@ -0,0 +1,13 @@
+import { EditorParagraphNode, EditorPosition, EditorSelection, EditorState, EditorTextRun } from '../../../model.js';
+import { normalizeSelection } from '../../../selection.js';
+
+export declare function withSelection(position: EditorPosition): EditorSelection;
+export declare function getFocusParagraph(state: EditorState): {
+    paragraph: EditorParagraphNode;
+    index: number;
+    offset: number;
+};
+export declare function deleteSelectionRange(state: EditorState): EditorState;
+export declare function mapRunsInRange(paragraph: EditorParagraphNode, startOffset: number, endOffset: number, mapper: (run: EditorTextRun) => EditorTextRun): EditorParagraphNode;
+export declare function preserveSelectionByParagraphOffsets(paragraphs: EditorParagraphNode[], normalized: ReturnType<typeof normalizeSelection>): EditorSelection;
+export declare function collapseToBoundary(state: EditorState, direction: "start" | "end"): EditorState;

package/dist/core/textStyle/textStyleKeys.d.ts

@@ -0,0 +1,6 @@
+import { EditorParagraphListStyle } from '../../../model.js';
+
+export type ToggleableTextStyleKey = "bold" | "italic" | "underline" | "strike" | "doubleStrike" | "superscript" | "subscript" | "smallCaps" | "allCaps" | "hidden" | "noProof" | "webHidden" | "specVanish" | "contextualAlternates";
+export type ValueTextStyleKey = "fontFamily" | "fontSize" | "color" | "highlight" | "shading" | "language" | "textEffect" | "link" | "underlineStyle" | "underlineColor" | "characterScale" | "characterSpacing" | "baselineShift" | "kerningThreshold" | "ligatures" | "numberSpacing" | "numberForm" | "stylisticSet";
+export type ValueParagraphStyleKey = "styleId" | "align" | "spacingBefore" | "spacingAfter" | "lineHeight" | "indentLeft" | "indentRight" | "indentFirstLine" | "indentHanging" | "shading" | "borderTop" | "borderRight" | "borderBottom" | "borderLeft" | "tabs" | "pageBreakBefore" | "keepWithNext";
+export type ParagraphListKind = EditorParagraphListStyle["kind"];

package/dist/core/textStyle/textStyleMutations.d.ts

@@ -0,0 +1,8 @@
+import { EditorParagraphStyle, EditorTextStyle } from '../../../model.js';
+import { ToggleableTextStyleKey, ValueParagraphStyleKey, ValueTextStyleKey } from '../../textStyleKeys.js';
+
+export declare function cloneStyle(style?: EditorTextStyle): EditorTextStyle | undefined;
+export declare function stylesEqual(left?: EditorTextStyle, right?: EditorTextStyle): boolean;
+export declare function setBooleanStyle(style: EditorTextStyle | undefined, key: ToggleableTextStyleKey, enabled: boolean): EditorTextStyle | undefined;
+export declare function setValueStyle<K extends ValueTextStyleKey>(style: EditorTextStyle | undefined, key: K, value: EditorTextStyle[K] | null): EditorTextStyle | undefined;
+export declare function setParagraphStyleValue<K extends ValueParagraphStyleKey>(style: EditorParagraphStyle | undefined, key: K, value: EditorParagraphStyle[K] | null): EditorParagraphStyle | undefined;

package/dist/export/docx/bookmarksXml.d.ts

@@ -0,0 +1,21 @@
+import { EditorDocument } from '../../../../core/model.js';
+
+export interface BookmarkBoundaryEvent {
+    kind: "start" | "end";
+    /** Character offset into the paragraph's flattened text. */
+    offset: number;
+    /** Stable emit order for boundaries that share an offset. */
+    seq: number;
+    /** Allocated DOCX `w:id`. */
+    wId: number;
+    name?: string;
+    colFirst?: number;
+    colLast?: number;
+}
+export type BookmarkEventsByParagraph = Map<string, BookmarkBoundaryEvent[]>;
+/**
+ * Allocate unique numeric `w:id`s (preferring each bookmark's imported hint)
+ * and group start/end boundary events by paragraph id.
+ */
+export declare function buildBookmarkExportPlan(document: EditorDocument): BookmarkEventsByParagraph | undefined;
+export declare function serializeBookmarkEvent(event: BookmarkBoundaryEvent): string;

package/dist/export/docx/borders.d.ts

@@ -0,0 +1,25 @@
+import { EditorBorderStyle } from '../../../../core/model.js';
+
+/**
+ * Serializes a concrete border into the attribute string that follows a border
+ * edge element name, e.g. the `w:val="single" w:sz="8" .../>` part of
+ * `<w:top w:val="single" .../>`. Shared by table-cell borders (`w:tcBorders`)
+ * and paragraph borders (`w:pBdr`).
+ *
+ * `w:sz` is in eighths of a point. A `none`/zero-width border becomes `nil`.
+ */
+export declare function serializeDocxBorderAttrs(border: EditorBorderStyle, colorFallback?: string): string;
+interface EditorBoxBorders {
+    borderTop?: EditorBorderStyle | null;
+    borderRight?: EditorBorderStyle | null;
+    borderBottom?: EditorBorderStyle | null;
+    borderLeft?: EditorBorderStyle | null;
+}
+/**
+ * Serializes a `w:pBdr` element for the defined paragraph border edges. Returns
+ * an empty string when no edge is set so callers can skip it. Unlike table
+ * cells (which always emit all four edges with defaults), paragraph borders only
+ * emit the edges that are actually present.
+ */
+export declare function serializeParagraphBorders(style: EditorBoxBorders): string;
+export {};