@univerjs-pro/engine-shape 1.0.0-alpha.3 → 1.0.0-alpha.4

package/lib/types/facade/f-shape.d.ts

@@ -0,0 +1,625 @@
+import type { IBasicShapeData, ImageSourceTypeEnum, IPresetShapeConfig, IShapeData, IShapeHostAdapter, IShapeLineStyle, IShapePointWithAdjName, IShapeRef, IShapeRelationItem, IShapeSnapshot, IShapeTransform, IShapeUpdateInput, ShapeGradientTypeEnum, ShapeHostType, ShapeLineCapEnum, ShapeLineDashEnum, ShapeLineJoinEnum, ShapeTypeEnum } from '@univerjs-pro/engine-shape';
+import type { Injector } from '@univerjs/core';
+import { ShapeLineTypeEnum } from '@univerjs-pro/engine-shape';
+import { FBase } from '@univerjs/core/facade';
+import { FShapeText } from './f-shape-text';
+type ShapeFill = NonNullable<IBasicShapeData['fill']>;
+export interface IShapeGradientStop {
+    /** Stop position in the normalized gradient range. */
+    position: number;
+    /** Stop color. */
+    color: string;
+    /** Optional stop opacity. */
+    opacity?: number;
+}
+/** A connector attachment site in the Shape's local coordinate system. */
+export interface IShapeConnectionSite {
+    /** Horizontal position relative to the Shape's top-left corner. */
+    x: number;
+    /** Vertical position relative to the Shape's top-left corner. */
+    y: number;
+    /** Stable site index used by Connector endpoint bindings. */
+    index: number;
+    /** Outward site angle in OOXML angle units (1/60000 degree). */
+    ang: number;
+}
+/** Optional image-fill properties accepted by `FShape.setImageFill()`. */
+export type IShapeImageFillOptions = Pick<ShapeFill, 'imageFillMode' | 'imageOpacity' | 'imageRotateWithShape' | 'stretchFillRect' | 'srcRect' | 'imageTile'>;
+/**
+ * A live, host-neutral facade handle for a Shape.
+ *
+ * @example Sheet
+ * ```ts
+ * const fWorkbook = univerAPI.getActiveWorkbook();
+ * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+ * const fShape = fWorksheet.insertShape({
+ *   shapeType: univerAPI.Enum.ShapeTypeEnum.Rect,
+ * });
+ * ```
+ *
+ * @example Doc
+ * ```ts
+ * const fDocument = univerAPI.getActiveDocument();
+ * const fShape = fDocument.insertShape({
+ *   shapeType: univerAPI.Enum.ShapeTypeEnum.Rect,
+ *   textRange: { startOffset: 0, endOffset: 0, collapsed: true },
+ * });
+ * ```
+ *
+ * @example Slide
+ * ```ts
+ * const fPresentation = univerAPI.getActivePresentation();
+ * const fSlide = fPresentation.getSlideByIndex(0);
+ * const fShape = fSlide.insertShape({
+ *   shapeType: univerAPI.Enum.ShapeTypeEnum.Rect,
+ * });
+ * ```
+ *
+ * @example Board
+ * ```ts
+ * const fBoard = univerAPI.getActiveBoard();
+ * const fShape = fBoard.insertShape({
+ *   shapeType: univerAPI.Enum.ShapeTypeEnum.Rect,
+ * });
+ * ```
+ *
+ * @example
+ * ```ts
+ * const snapshot = fShape.getSnapshot();
+ * console.log(snapshot);
+ *
+ * fShape
+ *   .setShapeType(univerAPI.Enum.ShapeTypeEnum.Ellipse)
+ *   .setSolidFill('#FF0000', 0.5)
+ *   .setSize(200, 100)
+ *   .setRotation(45)
+ *   .setAbsolutePosition(100, 100)
+ *   .setStroke({
+ *     color: '#000000',
+ *     width: 2,
+ *     lineStrokeType: univerAPI.Enum.ShapeLineTypeEnum.SolidLine,
+ *     dashType: univerAPI.Enum.ShapeLineDashEnum.Solid,
+ *     capType: univerAPI.Enum.ShapeLineCapEnum.Round,
+ *     lineJoinType: univerAPI.Enum.ShapeLineJoinEnum.Round,
+ *   });
+ * ```
+ */
+export declare class FShape extends FBase {
+    protected readonly _shapeRef: IShapeRef;
+    protected readonly _injector: Injector;
+    constructor(_shapeRef: IShapeRef, _injector: Injector);
+    /**
+     * Whether this Shape is a Connector preset type.
+     * @returns {boolean} Whether this Shape is a Connector preset type.
+     * @example
+     * ```ts
+     * console.log(fShape.isConnectorShape());
+     * ```
+     */
+    isConnectorShape(): boolean;
+    /**
+     * Returns the stable Shape identifier.
+     * @returns {string} The stable Shape identifier.
+     * @example
+     * ```ts
+     * console.log(fShape.getId());
+     * ```
+     */
+    getId(): string;
+    /**
+     * Returns the user-facing Shape name.
+     * @returns {string | undefined} The Shape name, or `undefined` when none is configured.
+     * @example
+     * ```ts
+     * console.log(fShape.getName());
+     * ```
+     */
+    getName(): string | undefined;
+    /**
+     * Sets or clears the user-facing Shape name.
+     * @param {string | undefined} name The Shape name, or `undefined` to clear it.
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * fShape.setName('Revenue forecast');
+     * ```
+     */
+    setName(name?: string): this;
+    /**
+     * Returns the user-facing Shape description.
+     * @returns {string | undefined} The Shape description, or `undefined` when none is configured.
+     * @example
+     * ```ts
+     * console.log(fShape.getDescription());
+     * ```
+     */
+    getDescription(): string | undefined;
+    /**
+     * Sets or clears the user-facing Shape description.
+     * @param {string | undefined} description The Shape description, or `undefined` to clear it.
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * fShape.setDescription('Shows the quarterly revenue forecast.');
+     * ```
+     */
+    setDescription(description?: string): this;
+    /**
+     * Returns the Univer host type that owns this Shape.
+     * @returns {ShapeHostType} The Univer host type that owns this Shape.
+     * @example
+     * ```ts
+     * console.log(fShape.getHostType());
+     * ```
+     */
+    getHostType(): ShapeHostType;
+    /**
+     * Returns the current Shape preset type, or `null` when the Shape is unavailable.
+     * @returns {ShapeTypeEnum | null} The current Shape preset type, or `null` when the Shape is unavailable.
+     * @example
+     * ```ts
+     * console.log(fShape.getShapeType());
+     * ```
+     */
+    getShapeType(): ShapeTypeEnum | null;
+    /**
+     * Returns a detached copy of the current Shape data.
+     * @returns {IShapeData | null} A detached copy of the current Shape data, or `null` when the Shape is unavailable.
+     * @example
+     * ```ts
+     * const shapeData = fShape.getShapeData();
+     * console.log(shapeData?.fill, shapeData?.stroke);
+     * ```
+     */
+    getShapeData(): IShapeData | null;
+    /**
+     * Returns a detached snapshot of the Shape and its host identity.
+     * @returns {IShapeSnapshot | null} A detached snapshot of the Shape and its host identity, or `null` when the Shape is unavailable.
+     * @example
+     * ```ts
+     * console.log(fShape.getSnapshot());
+     * ```
+     */
+    getSnapshot(): IShapeSnapshot | null;
+    /**
+     * Returns a detached copy of the current Shape transform.
+     * @returns {IShapeTransform | null} A detached copy of the current Shape transform, or `null` when the Shape is unavailable.
+     * @example
+     * ```ts
+     * const transform = fShape.getTransform();
+     * console.log(transform?.left, transform?.top, transform?.width, transform?.height);
+     * ```
+     */
+    getTransform(): IShapeTransform | null;
+    /**
+     * Returns whether the Shape is visible in its host.
+     * @returns {boolean} Whether the Shape is visible.
+     * @example
+     * ```ts
+     * console.log(fShape.isVisible());
+     * ```
+     */
+    isVisible(): boolean;
+    /**
+     * Sets whether the Shape is visible in its host.
+     * @param {boolean} visible Whether the Shape should be visible.
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * fShape.setVisible(false);
+     * ```
+     */
+    setVisible(visible: boolean): this;
+    /**
+     * Returns whether the Shape can be selected from the host canvas.
+     * @returns {boolean} Whether the Shape can be selected.
+     * @example
+     * ```ts
+     * console.log(fShape.isSelectable());
+     * ```
+     */
+    isSelectable(): boolean;
+    /**
+     * Sets whether the Shape can be selected from the host canvas.
+     * This does not change any host-specific hard-lock state.
+     * @param {boolean} selectable Whether the Shape should be selectable.
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * fShape.setSelectable(false);
+     * ```
+     */
+    setSelectable(selectable: boolean): this;
+    /**
+     * Returns the text facade associated with this Shape.
+     * @returns {FShapeText} The text facade associated with this Shape.
+     * @example
+     * ```ts
+     * fShape.getText().setText('Quarterly review');
+     * ```
+     */
+    getText(): FShapeText;
+    /**
+     * Returns whether this Shape uses custom geometry.
+     * @returns {boolean} Whether this Shape uses custom geometry.
+     * @example
+     * ```ts
+     * console.log(fShape.isCustomShape());
+     * ```
+     */
+    isCustomShape(): boolean;
+    /**
+     * Returns a detached copy of the custom geometry, or `null` when none is configured.
+     * @returns {IPresetShapeConfig | null} A detached copy of the custom geometry, or `null` when none is configured.
+     * @example
+     * ```ts
+     * const geometry = fShape.getCustomGeometry();
+     * console.log(geometry?.pathLst);
+     * ```
+     */
+    getCustomGeometry(): IPresetShapeConfig | null;
+    /**
+     * Changes the Shape preset type while preserving the remaining Shape data.
+     * @param {ShapeTypeEnum} shapeType The new Shape preset type.
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * fShape.setShapeType(univerAPI.Enum.ShapeTypeEnum.Ellipse);
+     * ```
+     */
+    setShapeType(shapeType: ShapeTypeEnum): this;
+    /**
+     * Replaces the complete Shape data with a detached copy of the supplied value.
+     * @param {IShapeData} shapeData The new Shape data.
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * fShape.setShapeData({
+     *   shapeType: univerAPI.Enum.ShapeTypeEnum.Rect,
+     *   fill: { fillType: univerAPI.Enum.ShapeFillEnum.SolidFill, color: '#4f90ff' },
+     * });
+     * ```
+     */
+    setShapeData(shapeData: IShapeData): this;
+    /**
+     * Applies a partial Shape transform update.
+     *
+     * In Docs, width, height, and rotation apply to both inline and floating Shapes. Left and top affect only
+     * non-inline Shapes because inline placement is controlled by the document text range. Docs also does not
+     * currently support changing flipX or flipY.
+     *
+     * @param {Partial<IShapeTransform>} transform A partial Shape transform update.
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * fShape.setTransform({ left: 120, top: 80, rotation: 15 });
+     * ```
+     */
+    setTransform(transform: Partial<IShapeTransform>): this;
+    /**
+     * Sets the Shape width and height. Both values must be greater than zero.
+     * @param {number} width The new Shape width in host-document units.
+     * @param {number} height The new Shape height in host-document units.
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * fShape.setSize(240, 120);
+     * ```
+     */
+    setSize(width: number, height: number): this;
+    /**
+     * Sets the clockwise Shape rotation in degrees.
+     * @param {number} rotation The clockwise Shape rotation in degrees.
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * fShape.setRotation(30);
+     * ```
+     */
+    setRotation(rotation: number): this;
+    /**
+     * Sets the absolute host-document position of the Shape.
+     *
+     * In Docs, this changes the configured horizontal and vertical offsets only for non-inline Shapes. Inline Shapes
+     * remain positioned by their document text range. The horizontal offset is page-relative and the vertical offset
+     * is relative to the anchor paragraph.
+     *
+     * @param {number} left The new Shape left position in host-document units.
+     * @param {number} top The new Shape top position in host-document units.
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * fShape.setAbsolutePosition(160, 96);
+     * ```
+     */
+    setAbsolutePosition(left: number, top: number): this;
+    /**
+     * Sets detached custom geometry and marks this Shape as custom.
+     * @param {IPresetShapeConfig} customGeometry The new custom geometry.
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * // Replace the preset geometry with an adjustable right arrow.
+     * fShape
+     *   .setCustomGeometry({
+     *     adjustValues: {
+     *       adj1: [univerAPI.Enum.ShapeOperatorEnum.Val, 32000],
+     *     },
+     *     gd: {
+     *       dx: [univerAPI.Enum.ShapeOperatorEnum.MulDiv, 'w', 'adj1', 100000],
+     *       ix: [univerAPI.Enum.ShapeOperatorEnum.AddSub, 'r', 0, 'dx'],
+     *     },
+     *     ahLst: [{
+     *       type: 'ahXY',
+     *       gdRefX: 'adj1',
+     *       minX: 0,
+     *       maxX: 50000,
+     *       pos: { x: 'dx', y: 'hd2' },
+     *     }],
+     *     cxnLst: [
+     *       { ang: 0, x: 'r', y: 'hd2' },
+     *       { ang: 180, x: 0, y: 'hd2' },
+     *     ],
+     *     rect: { l: 'dx', t: 0, r: 'ix', b: 'b' },
+     *     pathLst: [{
+     *       dataArray: [
+     *         { command: 'M', points: [0, 0] },
+     *         { command: 'L', points: ['ix', 0] },
+     *         { command: 'L', points: ['r', 'hd2'] },
+     *         { command: 'L', points: ['ix', 'b'] },
+     *         { command: 'L', points: [0, 'b'] },
+     *         { command: 'L', points: ['dx', 'hd2'] },
+     *         { command: 'z', points: [] },
+     *       ],
+     *     }],
+     *   })
+     *   .setSolidFill('#16a34a', 0.92)
+     *   .setStroke({
+     *     lineStrokeType: univerAPI.Enum.ShapeLineTypeEnum.SolidLine,
+     *     color: '#14532d',
+     *     width: 3,
+     *   });
+     * ```
+     */
+    setCustomGeometry(customGeometry: IPresetShapeConfig): this;
+    /**
+     * Returns the sites where Connector endpoints can attach to this Shape.
+     * Coordinates are local to the unrotated Shape bounds. Shapes without
+     * connection-site geometry, including Connector Shapes, return an empty array.
+     * @returns {IShapeConnectionSite[]} The sites where Connector endpoints can attach to this Shape.
+     * @example
+     * ```ts
+     * const sites = fShape.getConnectionSites();
+     * console.log(sites.map(({ index, x, y }) => ({ index, x, y })));
+     * ```
+     */
+    getConnectionSites(): IShapeConnectionSite[];
+    /**
+     * Returns the geometry adjustment handles exposed by this Shape preset.
+     * Coordinates are local to the unrotated Shape bounds and `adjName` identifies
+     * the corresponding entry in `shapeData.adjustValues`.
+     * @returns {IShapePointWithAdjName[]} The geometry adjustment handles exposed by this Shape preset.
+     * @example
+     * ```ts
+     * console.log(fShape.getAdjustPoints());
+     * ```
+     */
+    getAdjustPoints(): IShapePointWithAdjName[];
+    /**
+     * Returns the Shape and connection-site index bound to a Connector's start point, or `null` when unbound.
+     * @returns {IShapeRelationItem | null} The Shape and connection-site index bound to a Connector's start point, or `null` when unbound.
+     * @example
+     * ```ts
+     * console.log(fShape.getStartConnectInfo());
+     * ```
+     */
+    getStartConnectInfo(): IShapeRelationItem | null;
+    /**
+     * Returns the Shape and connection-site index bound to a Connector's end point, or `null` when unbound.
+     * @returns {IShapeRelationItem | null} The Shape and connection-site index bound to a Connector's end point, or `null` when unbound.
+     * @example
+     * ```ts
+     * console.log(fShape.getEndConnectInfo());
+     * ```
+     */
+    getEndConnectInfo(): IShapeRelationItem | null;
+    /**
+     * Replaces the current fill with a solid color and optional opacity.
+     * @param {string} color The new fill color.
+     * @param {number} [opacity] The new fill opacity, ranging from 0 (completely transparent) to 1 (completely opaque).
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * fShape.setSolidFill('#4f90ff', 0.85);
+     * ```
+     */
+    setSolidFill(color: string, opacity?: number): this;
+    /**
+     * Replaces the current fill with a gradient containing at least two color stops.
+     * @param {ShapeGradientTypeEnum} gradientType The new gradient type.
+     * @param {IShapeGradientStop[]} colorStops An array of at least two gradient stops.
+     * @param {number} [gradientAngle] The new gradient angle in degrees, used only for linear gradients.
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * fShape.setGradientFill(univerAPI.Enum.ShapeGradientTypeEnum.Linear, [
+     *   { position: 0, color: '#2563eb' },
+     *   { position: 1, color: '#a855f7' },
+     * ], 45);
+     * ```
+     */
+    setGradientFill(gradientType: ShapeGradientTypeEnum, colorStops: IShapeGradientStop[], gradientAngle?: number): this;
+    /**
+     * Replaces the current fill with an image source and optional image-fill settings.
+     * @param {string} source The image source, which can be a URL or base64 data URI.
+     * @param {ImageSourceTypeEnum} [imageSourceType] The type of the image source, either URL or base64.
+     * @param {IShapeImageFillOptions} [options] Optional image-fill settings, including fill mode, opacity, and rotation behavior.
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * fShape.setImageFill(
+     *   'https://github.com/dream-num.png',
+     *   univerAPI.Enum.ShapeImageSourceTypeEnum.URL,
+     *   { imageOpacity: 0.9 }
+     * );
+     * ```
+     */
+    setImageFill(source: string, imageSourceType?: ImageSourceTypeEnum, options?: IShapeImageFillOptions): this;
+    /**
+     * Removes the visible fill from this Shape.
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * fShape.setNoneFill();
+     * ```
+     */
+    setNoneFill(): this;
+    /**
+     * Replaces the complete Shape stroke configuration.
+     * @param {IShapeLineStyle} stroke The new Shape stroke configuration.
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * fShape.setStroke({
+     *   color: '#1e3a8a',
+     *   width: 2,
+     *   lineStrokeType: univerAPI.Enum.ShapeLineTypeEnum.SolidLine,
+     *   dashType: univerAPI.Enum.ShapeLineDashEnum.Dash,
+     * });
+     * ```
+     */
+    setStroke(stroke: IShapeLineStyle): this;
+    /**
+     * Sets the stroke color while preserving other stroke properties.
+     * @param {string} color The new stroke color.
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * fShape.setStrokeColor('#1e3a8a');
+     * ```
+     */
+    setStrokeColor(color: string): this;
+    /**
+     * Sets the stroke width while preserving other stroke properties.
+     * @param {number} width The new stroke width in host-document units.
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * fShape.setStrokeWidth(3);
+     * ```
+     */
+    setStrokeWidth(width: number): this;
+    /**
+     * Sets the stroke opacity while preserving other stroke properties.
+     * @param {number} opacity The new stroke opacity, ranging from 0 (completely transparent) to 1 (completely opaque).
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * fShape.setStrokeOpacity(0.6);
+     * ```
+     */
+    setStrokeOpacity(opacity: number): this;
+    /**
+     * Sets the stroke dash preset.
+     * @param {ShapeLineDashEnum} lineDashType The new stroke dash preset.
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * fShape.setStrokeLineDashType(univerAPI.Enum.ShapeLineDashEnum.DashDot);
+     * ```
+     */
+    setStrokeLineDashType(lineDashType: ShapeLineDashEnum): this;
+    /**
+     * Sets the stroke line-join preset.
+     * @param {ShapeLineJoinEnum} lineJoinType The new stroke line-join preset.
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * fShape.setStrokeLineJoinType(univerAPI.Enum.ShapeLineJoinEnum.Round);
+     * ```
+     */
+    setStrokeLineJoinType(lineJoinType: ShapeLineJoinEnum): this;
+    /**
+     * Sets the stroke line-cap preset.
+     * @param {ShapeLineCapEnum} lineCapType The new stroke line-cap preset.
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * fShape.setStrokeLineCapType(univerAPI.Enum.ShapeLineCapEnum.Round);
+     * ```
+     */
+    setStrokeLineCapType(lineCapType: ShapeLineCapEnum): this;
+    /**
+     * Sets the stroke line type.
+     * @param {ShapeLineTypeEnum} lineType The new stroke line type.
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * fShape.setStrokeLineType(univerAPI.Enum.ShapeLineTypeEnum.SolidLine);
+     * ```
+     */
+    setStrokeLineType(lineType: ShapeLineTypeEnum): this;
+    /**
+     * Applies a partial Shape update through the registered host adapter.
+     * @param {IShapeUpdateInput} input A partial Shape update.
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * fShape.update({ transform: { left: 240, top: 120, rotation: 20 } });
+     * ```
+     */
+    update(input: IShapeUpdateInput): this;
+    /**
+     * Removes the Shape and returns whether the host mutation succeeded.
+     * @returns {boolean} Whether the shape was successfully removed from its host.
+     * @example
+     * ```ts
+     * const removed = fShape.remove();
+     * console.log(removed);
+     * ```
+     */
+    remove(): boolean;
+    /**
+     * Moves the Shape to the front of its host drawing order.
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * fShape.bringToFront();
+     * ```
+     */
+    bringToFront(): this;
+    /**
+     * Moves the Shape forward by one position in its host drawing order.
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * fShape.bringForward();
+     * ```
+     */
+    bringForward(): this;
+    /**
+     * Moves the Shape backward by one position in its host drawing order.
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * fShape.sendBackward();
+     * ```
+     */
+    sendBackward(): this;
+    /**
+     * Moves the Shape to the back of its host drawing order.
+     * @returns {FShape} This Shape facade for chaining.
+     * @example
+     * ```ts
+     * fShape.sendToBack();
+     * ```
+     */
+    sendToBack(): this;
+    protected _getAdapter(): IShapeHostAdapter | null;
+    private _patchShapeData;
+    private _patchStroke;
+    private _getSnapshot;
+    private _getGeometryModel;
+    private _mutate;
+}
+export {};

package/lib/types/facade/index.d.ts

@@ -0,0 +1,6 @@
+import './f-enum';
+export { FConnectorShape } from './f-connector-shape';
+export { FShape } from './f-shape';
+export type { IShapeConnectionSite, IShapeGradientStop, IShapeImageFillOptions } from './f-shape';
+export { FShapeText } from './f-shape-text';
+export type { IShapeTextImageFillOptions } from './f-shape-text';

package/lib/types/index.d.ts

@@ -1,12 +1,24 @@
 export { BasicShapeModel as ShapeModel } from '../src/models/shape-model';
 export { BaseShapeRenderModel } from '../src/render-engine/shape-render-model';
 export { ImageFillModeEnum, ImageSourceTypeEnum, ShapeArrowSizeEnum, ShapeArrowTypeEnum, ShapeFillEnum, ShapeGradientTypeEnum, ShapeLineCapEnum, ShapeLineDashEnum, ShapeLineJoinEnum, ShapeLineTypeEnum, ShapeOperatorEnum, ShapePresetShadowValEnum, ShapeRenderModeEnum, ShapeSketchTypeEnum, ShapeTypeEnum, } from '../src/shape-enum';
-export type { IBasicShapeData, IConnectorLayoutResult, IConnectPointInfo, ICustomShapeTextData, ICxnShapeData, IDrawingRect, IGdContext, ILineType, IPathCommand, IPresetShapeConfig, IShapeAdjustItemResolved, IShapeData, IShapeJSONData, IShapeLineStyle, IShapePath, IShapePoint, IShapePointWithAdjName, IShapeRect, IShapeRelation, IShapeRelationItem, IShapeShadowEffect, IShapeText, IShapeTextBodyBehavior, IShapeTextData, IShapeTextDataModel, ShapeTextHorizontalAnchor, ShapeTextWrapType, } from '../src/shape-type';
-export { ShapeTextAutoFitType } from '../src/shape-type';
-export { resolveShapeTextBodyBehavior, shouldUseFullShapeTextRectForAutoFit } from '../src/utils/shape-text-behavior.util';
+export type { IBasicShapeData, IConnectorLayoutResult, IConnectPointInfo, ICustomShapeTextData, ICxnShapeData, IDrawingRect, IGdContext, ILineType, IPathCommand, IPresetShapeConfig, IShapeAdjustItemResolved, IShapeData, IShapeJSONData, IShapeLineStyle, IShapePath, IShapePoint, IShapePointWithAdjName, IShapeRect, IShapeRelation, IShapeRelationItem, IShapeShadowEffect, IShapeText, IShapeTextBodyBehavior, IShapeTextBoxOptions, IShapeTextData, IShapeTextDataModel, IShapeTextRectPadding, ShapeShadowAlignment, ShapeTextHorizontalAnchor, } from '../src/shape-type';
+export { ShapeTextAutoFitType, ShapeTextDirection, ShapeTextWrapType } from '../src/shape-type';
+export type { IResolvedShapeShadow } from '../src/utils/shape-shadow.util';
+export { resolveShapeShadow } from '../src/utils/shape-shadow.util';
+export { applyShapeTextBoxOptions, resolveShapeTextBodyBehavior, resolveShapeTextBoxOptions, shouldUseFullShapeTextRectForAutoFit, } from '../src/utils/shape-text-behavior.util';
+export type { IResolvedShapeTextBoxOptions } from '../src/utils/shape-text-behavior.util';
+export { UniverShapePlugin } from './plugin';
 export { computeConnectorRouteLayout, getBasicShapeRotateBound, routeConnectorLineShape, } from './render-engine/connector-points-util';
+export { ConnectorShapeHostAdapter } from './services/connector-shape-host-adapter';
+export { IConnectorShapeHostAdapter } from './services/connector-shape-host-adapter.service';
+export type { IConnectorArrow, IConnectorEndpoint, IConnectorShapeSnapshot, } from './services/connector-shape-host-adapter.service';
+export { IShapeHostAdapterRegistry, isShapeHostType, ShapeHostAdapterRegistry, } from './services/shape-host-adapter.service';
+export type { IShapeCreateInput, IShapeHostAdapter, IShapeRef, IShapeScope, IShapeSnapshot, IShapeTransform, IShapeUpdateInput, ShapeHostType, } from './services/shape-host-adapter.service';
 export { ShapeDefaultConfig } from './shape-default';
 export { resolveShapeDefaultInsertSize } from './shape-default-size';
 export { ConnectorCoordinateTransform } from './util/connector-transform';
 export { createUniqueShapeName } from './util/shape-name';
 export { isConnectorShape, isCurvedConnectorShape, } from './util/shape-util';
+export { buildConnectorEndpointUpdate, buildConnectorRoutePointsUpdate, createFreeConnectorPointInfo, resolveConnectorRoutePoints, resolveShapeConnectionPoint, } from './utils/connector.util';
+export { applyDocumentToShapeText, applyRichTextToShapeText, applyShapeTextAlignment, applyShapeTextStyle, applyTextToShapeText, normalizeShapeTextData, shapeTextToRichTextValue, } from './utils/shape-text-converter';
+export type { IShapeTextAlignmentOptions } from './utils/shape-text-converter';

package/lib/types/models/shape-model.d.ts

@@ -26,7 +26,7 @@ export declare class BasicShapeModel implements IShapeModel {
      * get shape text data
      * @returns The shape text data
      */
-    getShapeTextData(): IShapeTextData<unknown, unknown, unknown>;
+    getShapeTextData(): IShapeTextData;
     /**
      * set shape text data
      * @param shapeText The shape text data

package/lib/types/plugin.d.ts

@@ -0,0 +1,13 @@
+import type { IUniverEngineShapeConfig } from './config/config';
+import { IConfigService, Injector, Plugin, UniverInstanceType } from '@univerjs/core';
+export declare class UniverShapePlugin extends Plugin {
+    private readonly _config;
+    protected readonly _injector: Injector;
+    private readonly _configService;
+    static type: UniverInstanceType;
+    static pluginName: string;
+    static packageName: string;
+    static version: string;
+    constructor(_config: Partial<IUniverEngineShapeConfig> | undefined, _injector: Injector, _configService: IConfigService);
+    onStarting(): void;
+}