@univerjs-pro/shape-editor-ui 1.0.0-alpha.7 → 1.0.0-beta.0

package/lib/types/views/shape-text-editor/ShapeTextPositionWrapper.d.ts

@@ -46,9 +46,10 @@ export declare function isShapeTextEditorPointerInsideContent(target: EventTarge
 export declare function resolveShapeTextEditorPositionTransform(options: {
     editingParams: Nullable<IShapeTextEditingParams>;
     positionOptions: IShapeTextEditorPositionOptions;
-    renderUnit: Nullable<ReturnType<IRenderManagerService['getRenderById']>>;
+    renderUnit: Nullable<ReturnType<IRenderManagerService['getRenderUnitById']>>;
     scene: Nullable<Scene>;
 }): Nullable<IShapeObjectLike>;
+export declare function resolveShapeTextEditorPositionRoot(editorElement: HTMLElement | null): Element | null;
 /**
  * Position wrapper component that handles shape positioning in DOM.
  * This is the first layer DOM that tracks shape position with scroll.

package/lib/types/views/shape-text-editor/shape-text-document.d.ts

@@ -1,5 +1,7 @@
-import type { IShapeRect, IShapeText, IShapeTextBodyBehavior } from '@univerjs-pro/engine-shape';
-import type { IDocumentData } from '@univerjs/core';
+import type { ICustomShapeTextData, IShapeRect, IShapeText, IShapeTextBodyBehavior, IShapeTextDataModel } from '@univerjs-pro/engine-shape';
+import type { IDocumentData, Nullable } from '@univerjs/core';
+import type { Editor } from '@univerjs/docs-ui';
+import type { IShapeTextDataContext } from './types';
 import { HorizontalAlign, VerticalAlign, WrapStrategy } from '@univerjs/core';
 interface IPrepareShapeTextDocumentOptions {
     bodyBehavior?: IShapeTextBodyBehavior;
@@ -20,4 +22,17 @@ export declare function prepareShapeTextDocumentData(documentData: IDocumentData
 export declare function resolveShapeTextDocumentPageHeight(documentData: IDocumentData, viewportHeight: number): number;
 export declare function stripShapeTextDocumentLayout(documentData: IDocumentData, options?: IShapeTextDocumentAlignmentOptions): IDocumentData;
 export declare function createEditableShapeTextDocumentDataCopy(documentData: IDocumentData): IDocumentData;
+export declare function buildShapeTextEditorCommitShapeText(options: {
+    dataModel?: IShapeTextDataModel;
+    isHorizontal?: boolean;
+    shapeText?: ICustomShapeTextData | null;
+}): ICustomShapeTextData;
+export declare function createEmptyShapeTextEditorDocument(editorUnitId: string, pageWidth: number): IDocumentData;
+export declare function createShapeTextEditorInitialDocument(options: {
+    editorUnitId: string;
+    pageWidth: number;
+    shapeData: Nullable<IShapeTextDataContext>;
+}): IDocumentData;
+export declare function setShapeTextEditorDocumentData(editor: Pick<Editor, 'setDocumentData' | 'clearUndoRedoHistory'>, ...params: Parameters<Editor['setDocumentData']>): void;
+export declare function getShapeTextEditorDocumentData(editor: Pick<Editor, 'getDocumentData' | 'getDocumentDataModel'>): IDocumentData | null;
 export {};

package/lib/types/views/shape-text-editor/shape-text-keyboard.d.ts

@@ -0,0 +1,27 @@
+import type { ICommandService, Nullable } from '@univerjs/core';
+import type { IKeyboardEventConfig } from '@univerjs/docs-ui';
+import type { IShapeTextEditingParams } from './types';
+interface IShapeTextEditorKeyboardRange {
+    startOffset?: number;
+    endOffset?: number;
+    collapsed?: boolean;
+}
+export declare function isShapeTextEditorKeyboardFocusActive(isInputFocusing: boolean, textRanges: readonly IShapeTextEditorKeyboardRange[] | null | undefined): boolean;
+interface IShapeTextEditorKeyboardOptions {
+    commitOnEnter?: boolean;
+    cancel?: () => void;
+    commit?: () => void;
+    currentFontSize?: number;
+}
+export declare const DEFAULT_SHAPE_TEXT_EDITOR_FONT_SIZE = 14;
+export declare function getShapeTextEditorFocusSessionKey(options: {
+    editorUnitId: string;
+    editingParams: Nullable<IShapeTextEditingParams>;
+}): string | null;
+export declare function shouldCompleteShapeTextEditingOnPointerDown(target: EventTarget | null, editorElement: HTMLElement | null): boolean;
+export declare function getShapeTextEditorKeyboardConfig(commandService: Pick<ICommandService, 'executeCommand'>, executeUndoRedoCommand?: (commandId: string) => void, options?: IShapeTextEditorKeyboardOptions): IKeyboardEventConfig;
+export {};
+/**
+ * Shape editor component - second layer DOM.
+ * Handles document editing, content height tracking, and vertical alignment.
+ */

package/lib/types/views/shape-text-editor/shape-text-layout.d.ts

@@ -1,5 +1,9 @@
+import type { IShapeRect } from '@univerjs-pro/engine-shape';
+import type { IDocumentData, Nullable } from '@univerjs/core';
 import type { DocumentSkeleton } from '@univerjs/engine-render';
-import { VerticalAlign } from '@univerjs/core';
+import type { CSSProperties } from 'react';
+import type { IShapeTextEditingParams, IShapeTextEditorAdapter, IShapeTextEditorModel } from './types';
+import { HorizontalAlign, VerticalAlign } from '@univerjs/core';
 export interface IResolveShapeTextVerticalOffsetOptions {
     contentHeight: number;
     verticalAlign?: VerticalAlign;
@@ -17,8 +21,193 @@ export interface IResolveShapeTextDocumentRenderLayoutOptions extends IResolveSh
     opticalVerticalOffset?: number;
     verticalOffset?: number;
 }
+export declare function normalizeShapeTextRect(textRect: IShapeRect, fallbackRect: IShapeRect): IShapeRect;
 export declare function isShapeTextOpticalVerticalAlignEnabled(value: unknown): boolean;
+export declare function getShapeTextVisibleInkHeight(skeleton: DocumentSkeleton): number | undefined;
 export declare function resolveShapeTextVerticalOffset(options: IResolveShapeTextVerticalOffsetOptions): number;
 export declare function resolveShapeTextDocumentRenderLayout(options: IResolveShapeTextDocumentRenderLayoutOptions): IShapeTextDocumentRenderLayout;
 export declare function getShapeTextContentHeight(skeleton: DocumentSkeleton, fallbackHeight?: number): number;
 export declare function getShapeTextOpticalVerticalOffset(skeleton: DocumentSkeleton, targetHeight: number, verticalAlign?: VerticalAlign): number;
+export interface IContentLayout {
+    documentMarginTop: number;
+    editorLeft: number;
+    editorTop: number;
+    editorWidth: number;
+    editorHeight: number;
+    editorSurfaceWidth?: number;
+}
+export declare function resolveShapeTextEditingContentHeight(measuredContentHeight: number, caretHeight?: number): number;
+export declare function getShapeTextEditingCaretHeight(activeRange?: {
+    getAbsolutePosition(): Nullable<{
+        height?: number;
+    }>;
+}): number | undefined;
+export declare function areShapeTextEditorLayoutsEqual(a: IContentLayout, b: IContentLayout): boolean;
+interface IShapeTextEditorLayoutOptions {
+    actualHeight: number;
+    contentWidth?: number;
+    scaleX: number;
+    scaleY: number;
+    textRect: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+    verticalAlign: VerticalAlign;
+    opticalVerticalOffset?: number;
+}
+interface IShapeTextEditorLayout {
+    documentMarginTop: number;
+    editorLeft: number;
+    editorTop: number;
+    editorWidth: number;
+    editorHeight: number;
+    pageHeight: number;
+}
+interface IShapeTextEditorHostHeightOptions {
+    hostHeight: number;
+    textRect: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+    contentHeight: number;
+}
+interface IShapeTextEditorHostSizeOptions {
+    hostWidth: number;
+    hostHeight: number;
+    textRect: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+    contentWidth: number;
+    contentHeight: number;
+    allowShrink?: boolean;
+}
+interface IShapeTextEditorHostSizeChangeOptions {
+    nextWidth: number;
+    nextHeight: number;
+    baselineWidth: number;
+    baselineHeight: number;
+    tolerance?: number;
+}
+export declare function resolveShapeTextEditorTextRect(options: {
+    shapeModel: Pick<IShapeTextEditorModel, 'getShapeTextRect'>;
+    hostRect: IShapeRect;
+}): IShapeRect;
+export declare function resolveShapeTextEditorRenderScale(options: {
+    ancestorScale?: {
+        scaleX?: number;
+        scaleY?: number;
+    };
+    canvasClientWidth: number;
+    declaredCanvasWidth: number;
+    fallbackScaleX: number;
+    fallbackScaleY: number;
+}): {
+    scaleAdjust: number;
+    renderScaleX: number;
+    renderScaleY: number;
+};
+export declare function resolveShapeTextEditorEmptyTextBoxMinSize(options: {
+    isHorizontal: boolean;
+    placeholderWidth: number;
+}): {
+    width: number;
+    height: number;
+};
+export declare function measureShapeTextEditorPlaceholderWidth(documentData: IDocumentData, placeholder: string): number;
+export declare function resolveShapeTextEditorMeasurePageWidth(options: {
+    autoFitNoWrap: boolean;
+    maxAutoFitWidth?: number;
+    textRectWidth: number;
+}): number;
+export declare function measureShapeTextEditorNoWrapContentWidth(documentData: IDocumentData | null | undefined): number;
+export declare function resolveShapeTextEditorRenderedContentWidth(options: {
+    actualWidth: number;
+    autoFitNoWrap: boolean;
+    measuredContentWidth?: number;
+    textRectWidth: number;
+}): number;
+export declare function resolveShapeTextEditorHostContentWidth(options: {
+    actualWidth: number;
+    allowShrink: boolean;
+    autoFitNoWrap: boolean;
+    measuredContentWidth?: number;
+    renderedContentWidth: number;
+}): number;
+export declare function resolveShapeTextEditorFinalPageWidth(options: {
+    autoFitNoWrap: boolean;
+    measurePageWidth?: number;
+    renderedContentWidth: number;
+    textRectWidth: number;
+}): number;
+export declare function resolveShapeTextEditorRenderSurfaceWidth(options: {
+    autoFitNoWrap: boolean;
+    editorWidth: number;
+    measurePageWidth: number;
+    renderedContentWidth?: number;
+    scaleX: number;
+}): number;
+export declare function hasShapeTextEditorHostSizeChanged(options: IShapeTextEditorHostSizeChangeOptions): boolean;
+export declare function resolveShapeTextEditorShouldShrinkHostSize(options: {
+    adapter: Pick<IShapeTextEditorAdapter, 'allowHostSizeShrink' | 'updateHostSize'>;
+    editingParams: Nullable<IShapeTextEditingParams>;
+}): boolean;
+export declare function shouldDeferShapeTextEditorHostSizeUpdateDuringEditing(options: {
+    adapter: Pick<IShapeTextEditorAdapter, 'deferHostSizeUpdateDuringEditing'>;
+    editingParams: Nullable<IShapeTextEditingParams>;
+}): boolean;
+export declare function resolveShapeTextEditorDocumentVerticalAlign(options: {
+    opticalVerticalAlign: boolean;
+    verticalAlign: VerticalAlign;
+}): VerticalAlign;
+export declare function resolveShapeTextEditorLayout(options: IShapeTextEditorLayoutOptions): IShapeTextEditorLayout;
+export declare function resolveShapeTextEditorPlaceholderLayout(options: {
+    documentMarginTop: number;
+    editorLeft: number;
+    editorSurfaceWidth?: number;
+    editorTop: number;
+    editorWidth: number;
+    horizontalAlign: HorizontalAlign;
+}): {
+    left: number;
+    textAlign: 'center' | 'left' | 'right';
+    top: number;
+    width: number;
+};
+export declare function resolveShapeTextEditorHostHeight(options: IShapeTextEditorHostHeightOptions): number;
+export declare function resolveShapeTextEditorHostSize(options: IShapeTextEditorHostSizeOptions): {
+    width: number;
+    height: number;
+};
+export declare function resolveShapeTextEditorPhysicalContentSize(options: {
+    crossAxisLength: number;
+    flowAxis: 'width' | 'height';
+    flowAxisLength: number;
+}): {
+    height: number;
+    width: number;
+};
+export declare function getShapeTextEditorContentStyle(leftOrWidth: number, topOrHeight: number, width?: number, height?: number): CSSProperties;
+export declare function applyShapeTextEditorContentLayout(element: HTMLElement | null | undefined, layout: IContentLayout): void;
+export declare function applyShapeTextEditorCanvasTransparency(renderer: {
+    engine?: {
+        getCanvasElement?: () => HTMLElement | null;
+    };
+} | null | undefined | void): void;
+export declare function resetShapeTextEditorDocumentMargins(renderer: {
+    mainComponent?: unknown;
+    components?: {
+        forEach?: (callback: (component: unknown) => void) => void;
+    };
+} | null | undefined | void): void;
+export declare function refreshShapeTextEditorRenderer(renderer: {
+    mainComponent?: unknown;
+    scene?: unknown;
+} | null | undefined | void): void;
+export {};

package/lib/types/views/shape-text-editor/types.d.ts

@@ -83,5 +83,5 @@ export interface IShapeTextEditorPositionOptions {
     viewportKeys: IShapeTextEditorViewportKeys;
     getSkeleton?: (renderUnit: IRender, editingParams: IShapeTextEditingParams) => unknown;
     getHostTransform?: (renderUnit: IRender, editingParams: IShapeTextEditingParams) => Nullable<ITransformState>;
-    getPositionOffset?: (renderUnit: IRender, editingParams: IShapeTextEditingParams) => Nullable<IShapeTextEditorPositionOffset>;
+    getPositionOffset?: (renderUnit: IRender, editingParams: IShapeTextEditingParams, positionRoot?: Element | null) => Nullable<IShapeTextEditorPositionOffset>;
 }