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

package/lib/types/index.d.ts

@@ -1,201 +1,24 @@
 export { BasicShapeModel as ShapeModel } from '../src/models/shape-model';
-export { LineShapeRenderModel } from '../src/render-engine/line-shape-render-model';
 export { BaseShapeRenderModel } from '../src/render-engine/shape-render-model';
-export { BasicShapeEnum, ImageFillModeEnum, ImageSourceTypeEnum, ShapeArrowSizeEnum, ShapeArrowTypeEnum, ShapeFillEnum, ShapeGradientTypeEnum, ShapeLineCapEnum, ShapeLineDashEnum, ShapeLineJoinEnum, ShapeLineTypeEnum, ShapeOperatorEnum, ShapePresetShadowValEnum, ShapeRenderModeEnum, ShapeSketchTypeEnum, ShapeTypeEnum, } from '../src/shape-enum';
-export type { IBasicShapeData, IConnectorLayoutResult, IConnectorRouteLayoutResult, IConnectPointInfo, ICustomShapeTextData, ICxnShapeData, IDrawingRect, IGdContext, IGdContextBase, ILineType, IPathCommand, IPresetShapeConfig, IShapeAdjustItem, IShapeAdjustItemResolved, IShapeContextOptions, IShapeData, IShapeHitTestResult, IShapeJSONData, IShapeLineStyle, IShapeModel, IShapePath, IShapePoint, IShapePointWithAdjName, IShapeRect, IShapeRelation, IShapeRelationItem, IShapeRenderParameters, IShapeShadowEffect, IShapeText, IShapeTextRectPadding, ShapeAdjustHandleTypeEnum, ShapeHitTestHitTypeEnum, ShapeTextDirection, } from '../src/shape-type';
-export { AccentBorderCallout1Shape } from '../src/shapes/accent-border-callout1-shape';
-export { AccentBorderCallout2Shape } from '../src/shapes/accent-border-callout2-shape';
-export { AccentBorderCallout3Shape } from '../src/shapes/accent-border-callout3-shape';
-export { AccentCallout1Shape } from '../src/shapes/accent-callout1-shape';
-export { AccentCallout2Shape } from '../src/shapes/accent-callout2-shape';
-export { AccentCallout3Shape } from '../src/shapes/accent-callout3-shape';
-export { ActionButtonBackPreviousShape } from '../src/shapes/action-button-back-previous-shape';
-export { ActionButtonBeginningShape } from '../src/shapes/action-button-beginning-shape';
-export { ActionButtonBlankShape } from '../src/shapes/action-button-blank-shape';
-export { ActionButtonDocumentShape } from '../src/shapes/action-button-document-shape';
-export { ActionButtonEndShape } from '../src/shapes/action-button-end-shape';
-export { ActionButtonForwardNextShape } from '../src/shapes/action-button-forward-next-shape';
-export { ActionButtonHelpShape } from '../src/shapes/action-button-help-shape';
-export { ActionButtonHomeShape } from '../src/shapes/action-button-home-shape';
-export { ActionButtonInformationShape } from '../src/shapes/action-button-information-shape';
-export { ActionButtonMovieShape } from '../src/shapes/action-button-movie-shape';
-export { ActionButtonReturnShape } from '../src/shapes/action-button-return-shape';
-export { ActionButtonSoundShape } from '../src/shapes/action-button-sound-shape';
-export { ArcShape } from '../src/shapes/arc-shape';
-export { BentArrowShape } from '../src/shapes/bent-arrow-shape';
-export { BentConnector2Shape } from '../src/shapes/bent-connector2-shape';
-export { BentConnector3Shape } from '../src/shapes/bent-connector3-shape';
-export { BentConnector4Shape } from '../src/shapes/bent-connector4-shape';
-export { BentConnector5Shape } from '../src/shapes/bent-connector5-shape';
-export { BentUpArrowShape } from '../src/shapes/bent-up-arrow-shape';
-export { BevelShape } from '../src/shapes/bevel-shape';
-export { BlockArcShape } from '../src/shapes/block-arc-shape';
-export { BorderCallout1Shape } from '../src/shapes/border-callout1-shape';
-export { BorderCallout2Shape } from '../src/shapes/border-callout2-shape';
-export { BorderCallout3Shape } from '../src/shapes/border-callout3-shape';
-export { BracePairShape } from '../src/shapes/brace-pair-shape';
-export { BracketPairShape } from '../src/shapes/bracket-pair-shape';
-export { Callout1Shape } from '../src/shapes/callout1-shape';
-export { Callout2Shape } from '../src/shapes/callout2-shape';
-export { Callout3Shape } from '../src/shapes/callout3-shape';
-export { CanShape } from '../src/shapes/can-shape';
-export { ChartPlusShape } from '../src/shapes/chart-plus-shape';
-export { ChartStarShape } from '../src/shapes/chart-star-shape';
-export { ChartXShape } from '../src/shapes/chart-x-shape';
-export { ChevronShape } from '../src/shapes/chevron-shape';
-export { ChordShape } from '../src/shapes/chord-shape';
-export { CircleShape } from '../src/shapes/circle-shape';
-export { CircularArrowShape } from '../src/shapes/circular-arrow-shape';
-export { CloudCalloutShape } from '../src/shapes/cloud-callout-shape';
-export { CloudShape } from '../src/shapes/cloud-shape';
-export { CornerShape } from '../src/shapes/corner-shape';
-export { CornerTabsShape } from '../src/shapes/corner-tabs-shape';
-export { CubeShape } from '../src/shapes/cube-shape';
-export { CurvedConnector2Shape } from '../src/shapes/curved-connector2-shape';
-export { CurvedConnector3Shape } from '../src/shapes/curved-connector3-shape';
-export { CurvedConnector4Shape } from '../src/shapes/curved-connector4-shape';
-export { CurvedConnector5Shape } from '../src/shapes/curved-connector5-shape';
-export { CurvedDownArrowShape } from '../src/shapes/curved-down-arrow-shape';
-export { CurvedLeftArrowShape } from '../src/shapes/curved-left-arrow-shape';
-export { CurvedRightArrowShape } from '../src/shapes/curved-right-arrow-shape';
-export { CurvedUpArrowShape } from '../src/shapes/curved-up-arrow-shape';
-export { DecagonShape } from '../src/shapes/decagon-shape';
-export { DiagStripeShape } from '../src/shapes/diagonal-stripe-shape';
-export { DiamondShape } from '../src/shapes/diamond-shape';
-export { DodecagonShape } from '../src/shapes/dodecagon-shape';
-export { DonutShape } from '../src/shapes/donut-shape';
-export { DoubleWaveShape } from '../src/shapes/double-wave-shape';
-export { DownArrowCalloutShape } from '../src/shapes/down-arrow-callout-shape';
-export { DownArrowShape } from '../src/shapes/down-arrow-shape';
-export { EllipseRibbon2Shape } from '../src/shapes/ellipse-ribbon2-shape';
-export { EllipseRibbonShape } from '../src/shapes/ellipse-ribbon-shape';
-export { EllipseShape } from '../src/shapes/ellipse-shape';
-export { FlowChartOfflineStorageShape } from '../src/shapes/flow-chart-offline-storage-shape';
-export { FlowchartAlternateProcessShape } from '../src/shapes/flowchart-alternate-process-shape';
-export { FlowchartCollateShape } from '../src/shapes/flowchart-collate-shape';
-export { FlowchartConnectorShape } from '../src/shapes/flowchart-connector-shape';
-export { FlowChartInputOutputShape } from '../src/shapes/flowchart-data-shape';
-export { FlowchartDecisionShape } from '../src/shapes/flowchart-decision-shape';
-export { FlowchartDelayShape } from '../src/shapes/flowchart-delay-shape';
-export { FlowchartDisplayShape } from '../src/shapes/flowchart-display-shape';
-export { FlowchartDocumentShape } from '../src/shapes/flowchart-document-shape';
-export { FlowchartExtractShape } from '../src/shapes/flowchart-extract-shape';
-export { FlowchartInternalStorageShape } from '../src/shapes/flowchart-internal-storage-shape';
-export { FlowchartMagneticDiskShape } from '../src/shapes/flowchart-magnetic-disk-shape';
-export { FlowchartMagneticDrumShape } from '../src/shapes/flowchart-magnetic-drum-shape';
-export { FlowchartMagneticTapeShape } from '../src/shapes/flowchart-magnetic-tape-shape';
-export { FlowchartManualInputShape } from '../src/shapes/flowchart-manual-input-shape';
-export { FlowchartManualOperationShape } from '../src/shapes/flowchart-manual-operation-shape';
-export { FlowchartMergeShape } from '../src/shapes/flowchart-merge-shape';
-export { FlowchartMultiDocumentShape } from '../src/shapes/flowchart-multidocument-shape';
-export { FlowchartOffPageConnectorShape } from '../src/shapes/flowchart-offpage-connector-shape';
-export { FlowchartOnlineStorageShape } from '../src/shapes/flowchart-online-storage-shape';
-export { FlowchartOrShape } from '../src/shapes/flowchart-or-shape';
-export { FlowchartPredefinedProcessShape } from '../src/shapes/flowchart-predefined-process-shape';
-export { FlowchartPreparationShape } from '../src/shapes/flowchart-preparation-shape';
-export { FlowchartProcessShape } from '../src/shapes/flowchart-process-shape';
-export { FlowchartPunchedCardShape } from '../src/shapes/flowchart-punched-card-shape';
-export { FlowchartPunchedTapeShape } from '../src/shapes/flowchart-punched-tape-shape';
-export { FlowchartSortShape } from '../src/shapes/flowchart-sort-shape';
-export { FlowchartSummingJunctionShape } from '../src/shapes/flowchart-summing-junction-shape';
-export { FlowchartTerminatorShape } from '../src/shapes/flowchart-terminator-shape';
-export { FoldedCornerShape } from '../src/shapes/folded-corner-shape';
-export { FrameShape } from '../src/shapes/frame-shape';
-export { FunnelShape } from '../src/shapes/funnel-shape';
-export { Gear6Shape } from '../src/shapes/gear6-shape';
-export { Gear9Shape } from '../src/shapes/gear9-shape';
-export { HalfFrameShape } from '../src/shapes/half-frame-shape';
-export { HeartShape } from '../src/shapes/heart-shape';
-export { HeptagonShape } from '../src/shapes/heptagon-shape';
-export { HexagonShape } from '../src/shapes/hexagon-shape';
-export { HomePlateShape } from '../src/shapes/home-plate-shape';
-export { HorizontalScrollShape } from '../src/shapes/horizontal-scroll-shape';
-export { IrregularSeal1Shape } from '../src/shapes/irregular-seal1-shape';
-export { IrregularSeal2Shape } from '../src/shapes/irregular-seal2-shape';
-export { LeftArrowCalloutShape } from '../src/shapes/left-arrow-callout-shape';
-export { LeftArrowShape } from '../src/shapes/left-arrow-shape';
-export { LeftBraceShape } from '../src/shapes/left-brace-shape';
-export { LeftBracketShape } from '../src/shapes/left-bracket-shape';
-export { LeftCircularArrowShape } from '../src/shapes/left-circular-arrow-shape';
-export { LeftRightArrowCalloutShape } from '../src/shapes/left-right-arrow-callout-shape';
-export { LeftRightArrowShape } from '../src/shapes/left-right-arrow-shape';
-export { LeftRightCircularArrowShape } from '../src/shapes/left-right-circular-arrow-shape';
-export { LeftRightRibbonShape } from '../src/shapes/left-right-ribbon-shape';
-export { LeftRightUpArrowShape } from '../src/shapes/left-right-up-arrow-shape';
-export { LeftUpArrowShape } from '../src/shapes/left-up-arrow-shape';
-export { LightningBoltShape } from '../src/shapes/lightning-bolt-shape';
-export { LineInvShape } from '../src/shapes/line-lnv-shape';
-export { LineShape } from '../src/shapes/line-shape';
-export { MathDivideShape } from '../src/shapes/math-divide-shape';
-export { MathEqualShape } from '../src/shapes/math-equal-shape';
-export { MathMinusShape } from '../src/shapes/math-minus-shape';
-export { MathMultiplyShape } from '../src/shapes/math-multiply-shape';
-export { MathNotEqualShape } from '../src/shapes/math-not-equal-shape';
-export { MathPlusShape } from '../src/shapes/math-plus-shape';
-export { MoonShape } from '../src/shapes/moon-shape';
-export { NoSmokingShape } from '../src/shapes/no-smoking-shape';
-export { NonIsoscelesTrapezoidShape } from '../src/shapes/non-isosceles-trapezoid';
-export { NotchedRightArrowShape } from '../src/shapes/notched-right-arrow-shape';
-export { OctagonShape } from '../src/shapes/octagon-shape';
-export { ParallelogramShape } from '../src/shapes/parallelogram-shape';
-export { PentagonShape } from '../src/shapes/pentagon-shape';
-export { PieShape } from '../src/shapes/pie-shape';
-export { PieWedgeShape } from '../src/shapes/pie-wedge-shape';
-export { PlaqueShape } from '../src/shapes/plaque-shape';
-export { PlaqueTabsShape } from '../src/shapes/plaque-tabs-shape';
-export { PlusShape } from '../src/shapes/plus-shape';
-export { QuadArrowCalloutShape } from '../src/shapes/quad-arrow-callout-shape';
-export { QuadArrowShape } from '../src/shapes/quad-arrow-shape';
-export { RectangleShape } from '../src/shapes/rectangle-shape';
-export { Ribbon2Shape } from '../src/shapes/ribbon2-shape';
-export { RibbonShape } from '../src/shapes/ribbon-shape';
-export { RightArrowCalloutShape } from '../src/shapes/right-arrow-callout-shape';
-export { RightArrowShape } from '../src/shapes/right-arrow-shape';
-export { RightBraceShape } from '../src/shapes/right-brace-shape';
-export { RightBracketShape } from '../src/shapes/right-bracket-shape';
-export { RightTriangleShape } from '../src/shapes/right-triangle-shape';
-export { Round1RectShape } from '../src/shapes/round-rectangle1-shape';
-export { Round2DiagRectShape } from '../src/shapes/round-rectangle2-diagonal-shape';
-export { Round2SameRectShape } from '../src/shapes/round-rectangle2-shape';
-export { RoundRectangleShape } from '../src/shapes/round-rectangle-shape';
-export { SmileyFaceShape } from '../src/shapes/smiley-face-shape';
-export { SnipRectangle1Shape } from '../src/shapes/snip-rectangle1-shape';
-export { SnipRectangle2DiagonalShape } from '../src/shapes/snip-rectangle2-diagonal-shape';
-export { SnipRectangle2SameShape } from '../src/shapes/snip-rectangle2-same-shape';
-export { SnipRoundRectangle1Shape } from '../src/shapes/snip-round-rectangle1-shape';
-export { SquareTabsShape } from '../src/shapes/square-tabs-shape';
-export { Star4Shape } from '../src/shapes/star4-shape';
-export { Star5Shape } from '../src/shapes/star5-shape';
-export { Star6Shape } from '../src/shapes/star6-shape';
-export { Star7Shape } from '../src/shapes/star7-shape';
-export { Star8Shape } from '../src/shapes/star8-shape';
-export { Star10Shape } from '../src/shapes/star10-shape';
-export { Star12Shape } from '../src/shapes/star12-shape';
-export { Star16Shape } from '../src/shapes/star16-shape';
-export { Star24Shape } from '../src/shapes/star24-shape';
-export { Star32Shape } from '../src/shapes/star32-shape';
-export { StraightConnector1Shape } from '../src/shapes/straight-connector1-shape';
-export { StripedRightArrowShape } from '../src/shapes/striped-right-arrow-shape';
-export { SunShape } from '../src/shapes/sun-shape';
-export { SwooshArrowShape } from '../src/shapes/swoosh-arrow-shape';
-export { TeardropShape } from '../src/shapes/teardrop-shape';
-export { TextBoxShape } from '../src/shapes/text-box-shape';
-export { TrapezoidShape } from '../src/shapes/trapezoid-shape';
-export { TriangleShape } from '../src/shapes/triangle-shape';
-export { UpArrowCalloutShape } from '../src/shapes/up-arrow-callout-shape';
-export { UpArrowShape } from '../src/shapes/up-arrow-shape';
-export { UpDownArrowCalloutShape } from '../src/shapes/up-down-arrow-callout-shape';
-export { UpDownArrowShape } from '../src/shapes/up-down-arrow-shape';
-export { UturnArrowShape } from '../src/shapes/uturn-arrow-shape';
-export { VerticalScrollShape } from '../src/shapes/vertical-scroll-shape';
-export { WaveShape } from '../src/shapes/wave-shape';
-export { WedgeEllipseCalloutShape } from '../src/shapes/wedge-ellipse-callout-shape';
-export { WedgeRectCalloutShape } from '../src/shapes/wedge-rect-callout-shape';
-export { WedgeRoundRectCalloutShape } from '../src/shapes/wedge-round-rect-callout-shape';
-export { computeConnectorRouteLayout, getBasicShapeRotateBound, rotatePointAroundCenter, routeConnectorLineShape, } from './render-engine/connector-points-util';
+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, 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 { freeRouteBentConnectorLinePoints } from './util/connector-points-util';
-export type { IBentConnectorResult } from './util/connector-points-util';
+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 { 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

@@ -1,5 +1,5 @@
 import type { ShapeTypeEnum } from '../shape-enum';
-import type { ICustomShapeTextData, IGdContext, IPresetShapeConfig, IShapeAdjustItemResolved, IShapeContextOptions, IShapeData, IShapeJSONData, IShapeModel, IShapePoint, IShapePointWithAdjName, IShapeRect, IShapeRelation, IShapeRelationItem, IShapeRenderParameters, IShapeText } from '../shape-type';
+import type { IGdContext, IPresetShapeConfig, IShapeAdjustItemResolved, IShapeContextOptions, IShapeData, IShapeJSONData, IShapeModel, IShapePoint, IShapePointWithAdjName, IShapeRect, IShapeRelation, IShapeRelationItem, IShapeRenderParameters, IShapeTextData } from '../shape-type';
 import { BasicShapeEnum } from '../shape-enum';
 export declare function deepMerge<T extends Record<string, any>>(target: T, ...sources: Partial<T>[]): T;
 export declare class BasicShapeModel implements IShapeModel {
@@ -26,12 +26,12 @@ export declare class BasicShapeModel implements IShapeModel {
      * get shape text data
      * @returns The shape text data
      */
-    getShapeTextData(): IShapeText | ICustomShapeTextData;
+    getShapeTextData(): IShapeTextData;
     /**
      * set shape text data
      * @param shapeText The shape text data
      */
-    setShapeTextData(shapeText: IShapeText | ICustomShapeTextData): void;
+    setShapeTextData(shapeText: IShapeTextData): void;
     /**
      * get shape text rect, the shape text rect is defined in shape preset config, if not exist, return the whole shape rect, we will add padding in render model
      * @param rect The drawing rect, define the position and size of the shape

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;
+}

package/lib/types/render-engine/shape-render-model.d.ts

@@ -24,7 +24,6 @@ export declare abstract class BaseShapeRenderModel {
      * @returns {IShapeRect} The text rectangle within the shape
      */
     getTextRect(rect: IShapeRect, gdRecord: Partial<IGdContext>, shapeData?: IShapeData): IShapeRect;
-    private _hasExplicitTextRectPadding;
     private _getPaddedWholeRect;
     private _getTextRectPadding;
     /**

package/lib/types/services/connector-shape-host-adapter.d.ts

@@ -0,0 +1,40 @@
+import type { ShapeArrowSizeEnum, ShapeArrowTypeEnum } from '../shape-enum';
+import type { IShapePoint, IShapeRelationItem } from '../shape-type';
+import type { IConnectorShapeHostAdapter, IConnectorShapeSnapshot } from './connector-shape-host-adapter.service';
+import type { IShapeRef } from './shape-host-adapter.service';
+import { IShapeHostAdapterRegistry } from './shape-host-adapter.service';
+/**
+ * Host-neutral Connector service that resolves the owning host's common Shape
+ * adapter from `IShapeHostAdapterRegistry` for every operation.
+ */
+export declare class ConnectorShapeHostAdapter implements IConnectorShapeHostAdapter {
+    private readonly _shapeAdapterRegistry;
+    constructor(_shapeAdapterRegistry: IShapeHostAdapterRegistry);
+    /** Returns a resolved Connector snapshot. */
+    getConnector(ref: IShapeRef): IConnectorShapeSnapshot | null;
+    /** Binds the start endpoint to a target Shape connection site. */
+    bindStart(ref: IShapeRef, target: IShapeRelationItem): boolean;
+    /** Binds the end endpoint to a target Shape connection site. */
+    bindEnd(ref: IShapeRef, target: IShapeRelationItem): boolean;
+    /** Unbinds the start endpoint while preserving its current visual position. */
+    unbindStart(ref: IShapeRef): boolean;
+    /** Unbinds the end endpoint while preserving its current visual position. */
+    unbindEnd(ref: IShapeRef): boolean;
+    /** Sets a free start point and removes the existing start binding. */
+    setStartPoint(ref: IShapeRef, point: IShapePoint): boolean;
+    /** Sets a free end point and removes the existing end binding. */
+    setEndPoint(ref: IShapeRef, point: IShapePoint): boolean;
+    /** Replaces the intermediate route points in document coordinates. */
+    setRoutePoints(ref: IShapeRef, points: IShapePoint[]): boolean;
+    /** Sets the start arrowhead type and optional size. */
+    setStartArrow(ref: IShapeRef, type: ShapeArrowTypeEnum, size?: ShapeArrowSizeEnum): boolean;
+    /** Sets the end arrowhead type and optional size. */
+    setEndArrow(ref: IShapeRef, type: ShapeArrowTypeEnum, size?: ShapeArrowSizeEnum): boolean;
+    private _updateEndpoint;
+    private _getConnectorSnapshot;
+    private _resolveBinding;
+    private _setArrow;
+    private _getShapeAdapter;
+    private _getConnectorShape;
+    private _getArrow;
+}

package/lib/types/services/connector-shape-host-adapter.service.d.ts

@@ -0,0 +1,55 @@
+import type { ShapeArrowSizeEnum, ShapeArrowTypeEnum } from '../shape-enum';
+import type { IShapePoint, IShapeRelationItem } from '../shape-type';
+import type { IShapeRef } from './shape-host-adapter.service';
+export interface IConnectorEndpoint {
+    /** Resolved endpoint in the host's document coordinate system. */
+    point: IShapePoint;
+    /** Target Shape connection-site binding, or `null` for a free endpoint. */
+    binding: IShapeRelationItem | null;
+}
+export interface IConnectorArrow {
+    /** Arrowhead type. */
+    type: ShapeArrowTypeEnum;
+    /** Optional arrowhead size. */
+    size?: ShapeArrowSizeEnum;
+}
+export interface IConnectorShapeSnapshot {
+    /** Resolved start endpoint. */
+    start: IConnectorEndpoint;
+    /** Resolved end endpoint. */
+    end: IConnectorEndpoint;
+    /** Resolved Connector path in the host's document coordinate system. */
+    routePoints: IShapePoint[];
+    /** Start arrowhead, or `null` when none is configured. */
+    startArrow: IConnectorArrow | null;
+    /** End arrowhead, or `null` when none is configured. */
+    endArrow: IConnectorArrow | null;
+}
+/**
+ * Common service contract for Connector-specific Shape reads and mutations.
+ * Mutations delegate persistence to the owning host's common Shape adapter.
+ */
+export interface IConnectorShapeHostAdapter {
+    /** Returns the resolved Connector snapshot, or `null` when it does not exist. */
+    getConnector(ref: IShapeRef): IConnectorShapeSnapshot | null;
+    /** Binds the start endpoint to a target Shape connection site. */
+    bindStart(ref: IShapeRef, target: IShapeRelationItem): boolean;
+    /** Binds the end endpoint to a target Shape connection site. */
+    bindEnd(ref: IShapeRef, target: IShapeRelationItem): boolean;
+    /** Unbinds the start endpoint while preserving its current visual position. */
+    unbindStart(ref: IShapeRef): boolean;
+    /** Unbinds the end endpoint while preserving its current visual position. */
+    unbindEnd(ref: IShapeRef): boolean;
+    /** Sets a free start point and removes any existing start binding. */
+    setStartPoint(ref: IShapeRef, point: IShapePoint): boolean;
+    /** Sets a free end point and removes any existing end binding. */
+    setEndPoint(ref: IShapeRef, point: IShapePoint): boolean;
+    /** Replaces the explicit Connector route points. */
+    setRoutePoints(ref: IShapeRef, points: IShapePoint[]): boolean;
+    /** Sets the start arrowhead type and optional size. */
+    setStartArrow(ref: IShapeRef, type: ShapeArrowTypeEnum, size?: ShapeArrowSizeEnum): boolean;
+    /** Sets the end arrowhead type and optional size. */
+    setEndArrow(ref: IShapeRef, type: ShapeArrowTypeEnum, size?: ShapeArrowSizeEnum): boolean;
+}
+/** Singleton Connector service backed by the registered common Shape adapters. */
+export declare const IConnectorShapeHostAdapter: import("@wendellhu/redi").IdentifierDecorator<IConnectorShapeHostAdapter>;

package/lib/types/services/shape-host-adapter.service.d.ts

@@ -0,0 +1,103 @@
+import type { IDisposable, UniverInstanceType } from '@univerjs/core';
+import type { ShapeTypeEnum } from '../shape-enum';
+import type { IShapeData } from '../shape-type';
+export type ShapeHostType = UniverInstanceType.UNIVER_SHEET | UniverInstanceType.UNIVER_DOC | UniverInstanceType.UNIVER_SLIDE | UniverInstanceType.UNIVER_BOARD;
+export declare function isShapeHostType(type: UniverInstanceType): type is ShapeHostType;
+export interface IShapeScope {
+    /** Univer host type that owns the Shape. */
+    hostType: ShapeHostType;
+    /** Host unit identifier, such as a workbook, document, presentation, or board id. */
+    unitId: string;
+    /** Host subunit identifier, such as a worksheet or slide id. */
+    subUnitId: string;
+}
+export interface IShapeRef extends IShapeScope {
+    /** Stable Shape identifier within the host subunit. */
+    shapeId: string;
+}
+export interface IShapeTransform {
+    /** Horizontal position in host coordinates. */
+    left: number;
+    /** Vertical position in host coordinates. */
+    top: number;
+    /** Shape width in host coordinates. */
+    width: number;
+    /** Shape height in host coordinates. */
+    height: number;
+    /** Clockwise rotation in degrees. */
+    rotation: number;
+    /** Whether the Shape is flipped horizontally. */
+    flipX: boolean;
+    /** Whether the Shape is flipped vertically. */
+    flipY: boolean;
+}
+export interface IShapeSnapshot extends IShapeRef {
+    /** Current preset Shape type. */
+    shapeType: ShapeTypeEnum;
+    /** Current host-neutral Shape data. */
+    shapeData: IShapeData;
+    /** Optional user-facing Shape name. */
+    name?: string;
+    /** Optional user-facing Shape description. */
+    description?: string;
+    /** Fully resolved Shape transform. */
+    transform: IShapeTransform;
+    /** Whether the Shape is rendered by its host. */
+    visible: boolean;
+    /** Whether the Shape can be selected from its host canvas. */
+    selectable: boolean;
+}
+export interface IShapeCreateInput {
+    /** Preset type of the Shape to create. */
+    shapeType: ShapeTypeEnum;
+    /** Partial transform. Omitted fields use defaults supplied by the target host. */
+    transform?: Partial<IShapeTransform>;
+    /** Initial host-neutral Shape data. */
+    shapeData?: IShapeData;
+    /** Initial user-facing Shape name. */
+    name?: string;
+    /** Initial user-facing Shape description. */
+    description?: string;
+    /** Initial visibility. Defaults to `true`. */
+    visible?: boolean;
+    /** Initial canvas selectability. Defaults to `true`. */
+    selectable?: boolean;
+}
+export interface IShapeUpdateInput {
+    /** Replacement preset Shape type. */
+    shapeType?: ShapeTypeEnum;
+    /** Transform fields to update. */
+    transform?: Partial<IShapeTransform>;
+    /** Replacement host-neutral Shape data. */
+    shapeData?: IShapeData;
+    /** User-facing Shape name. Pass `undefined` explicitly to clear it. */
+    name?: string;
+    /** User-facing Shape description. Pass `undefined` explicitly to clear it. */
+    description?: string;
+    /** Visibility to update. Omit to preserve the current value. */
+    visible?: boolean;
+    /** Canvas selectability to update. Omit to preserve the current value. */
+    selectable?: boolean;
+}
+export interface IShapeHostAdapter {
+    readonly hostType: ShapeHostType;
+    getShape(ref: IShapeRef): IShapeSnapshot | null;
+    listShapes(scope: IShapeScope): IShapeSnapshot[];
+    createShape(scope: IShapeScope, input: IShapeCreateInput): IShapeSnapshot | null;
+    updateShape(ref: IShapeRef, input: IShapeUpdateInput): boolean;
+    removeShape(ref: IShapeRef): boolean;
+    bringToFront(ref: IShapeRef): boolean;
+    bringForward(ref: IShapeRef): boolean;
+    sendBackward(ref: IShapeRef): boolean;
+    sendToBack(ref: IShapeRef): boolean;
+}
+export interface IShapeHostAdapterRegistry {
+    register(adapter: IShapeHostAdapter): IDisposable;
+    get(hostType: UniverInstanceType): IShapeHostAdapter | null;
+}
+export declare const IShapeHostAdapterRegistry: import("@wendellhu/redi").IdentifierDecorator<IShapeHostAdapterRegistry>;
+export declare class ShapeHostAdapterRegistry implements IShapeHostAdapterRegistry {
+    private readonly _adapters;
+    register(adapter: IShapeHostAdapter): IDisposable;
+    get(hostType: UniverInstanceType): IShapeHostAdapter | null;
+}

package/lib/types/shape-default-size.d.ts

@@ -0,0 +1,9 @@
+import { ShapeTypeEnum } from './shape-enum';
+export declare const SHAPE_DEFAULT_INSERT_BASE_SIZE = 100;
+export interface IShapeDefaultInsertSize {
+    width: number;
+    height: number;
+}
+export declare const SHAPE_DEFAULT_INSERT_SIZE: Record<ShapeTypeEnum, IShapeDefaultInsertSize>;
+export declare function resolveShapeDefaultAspectRatio(shapeType: ShapeTypeEnum | string | null | undefined): number | undefined;
+export declare function resolveShapeDefaultInsertSize(shapeType: ShapeTypeEnum | string | null | undefined, baseSize?: number): IShapeDefaultInsertSize | undefined;

package/lib/types/shape-default.d.ts

@@ -1,8 +1,17 @@
-import { ShapeLineCapEnum, ShapeLineDashEnum, ShapeLineJoinEnum } from './shape-enum';
+import { ShapeFillEnum, ShapeGradientTypeEnum, ShapeLineCapEnum, ShapeLineDashEnum, ShapeLineJoinEnum, ShapeLineTypeEnum, ShapeSketchTypeEnum } from './shape-enum';
 export declare const ShapeDefaultConfig: {
+    fillType: ShapeFillEnum;
     fill: string;
+    fillOpacity: number;
+    gradientType: ShapeGradientTypeEnum;
+    gradientAngle: number;
+    gradientEndColor: string;
+    lineType: ShapeLineTypeEnum;
     stroke: string;
     strokeWidth: number;
+    strokeOpacity: number;
+    cornerRadius: number;
+    sketchType: ShapeSketchTypeEnum;
     cxnPointRadius: number;
     cxnPointFill: string;
     cxnPointStroke: string;
@@ -19,7 +28,6 @@ export declare const ShapeDefaultConfig: {
         fontSize: number;
         fontFamily: string;
         color: string;
-        isRichText: boolean;
         bold: boolean;
         italic: boolean;
         underline: boolean;