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

package/lib/types/index.d.ts

@@ -1,8 +1,8 @@
 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, 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, IShapeText, IShapeTextRectPadding, ShapeAdjustHandleTypeEnum, ShapeHitTestHitTypeEnum, ShapeTextDirection, } from '../src/shape-type';
+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';
@@ -192,7 +192,7 @@ 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 { computeConnectorRouteLayout, getBasicShapeRotateBound, rotatePointAroundCenter, routeConnectorLineShape, } from './render-engine/connector-points-util';
 export { ShapeDefaultConfig } from './shape-default';
 export { freeRouteBentConnectorLinePoints } from './util/connector-points-util';
 export type { IBentConnectorResult } from './util/connector-points-util';

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

@@ -30,6 +30,55 @@ export declare enum ShapeDirectionEnum {
     Left = 180,
     Up = 270
 }
+/**
+ * OOXML ST_PresetShadowVal values used by `<a:prstShdw prst="...">`.
+ *
+ * The enum member names intentionally keep the OOXML `shdw*` numbering so JSON
+ * can map back to OOXML losslessly. Use each member's JSDoc for the human-readable
+ * Office preset name.
+ */
+export declare enum ShapePresetShadowValEnum {
+    /** OOXML shdw1: Top Left Drop Shadow, a regular outer shadow toward the top-left. */
+    Shdw1 = "shdw1",
+    /** OOXML shdw2: Top Right Drop Shadow, a regular outer shadow toward the top-right. */
+    Shdw2 = "shdw2",
+    /** OOXML shdw3: Back Left Perspective Shadow, a perspective shadow behind the shape on the left. */
+    Shdw3 = "shdw3",
+    /** OOXML shdw4: Back Right Perspective Shadow, a perspective shadow behind the shape on the right. */
+    Shdw4 = "shdw4",
+    /** OOXML shdw5: Bottom Left Drop Shadow, a regular outer shadow toward the bottom-left. */
+    Shdw5 = "shdw5",
+    /** OOXML shdw6: Bottom Right Drop Shadow, a regular outer shadow toward the bottom-right. */
+    Shdw6 = "shdw6",
+    /** OOXML shdw7: Front Left Perspective Shadow, a perspective shadow in front of the shape on the left. */
+    Shdw7 = "shdw7",
+    /** OOXML shdw8: Front Right Perspective Shadow, a perspective shadow in front of the shape on the right. */
+    Shdw8 = "shdw8",
+    /** OOXML shdw9: Top Left Small Drop Shadow, a smaller top-left outer shadow. */
+    Shdw9 = "shdw9",
+    /** OOXML shdw10: Top Left Large Drop Shadow, a larger top-left outer shadow. */
+    Shdw10 = "shdw10",
+    /** OOXML shdw11: Back Left Long Perspective Shadow, a longer back-left perspective shadow. */
+    Shdw11 = "shdw11",
+    /** OOXML shdw12: Back Right Long Perspective Shadow, a longer back-right perspective shadow. */
+    Shdw12 = "shdw12",
+    /** OOXML shdw13: Top Left Double Drop Shadow, a double-layer top-left outer shadow. */
+    Shdw13 = "shdw13",
+    /** OOXML shdw14: Bottom Right Small Drop Shadow, a smaller bottom-right outer shadow. */
+    Shdw14 = "shdw14",
+    /** OOXML shdw15: Front Left Long Perspective Shadow, a longer front-left perspective shadow. */
+    Shdw15 = "shdw15",
+    /** OOXML shdw16: Front Right Long Perspective Shadow, a longer front-right perspective shadow. */
+    Shdw16 = "shdw16",
+    /** OOXML shdw17: 3D Outer Box Shadow, a 3D-style shadow outside the shape box. */
+    Shdw17 = "shdw17",
+    /** OOXML shdw18: 3D Inner Box Shadow, a 3D-style shadow inside the shape box. */
+    Shdw18 = "shdw18",
+    /** OOXML shdw19: Back Center Perspective Shadow, a centered perspective shadow behind the shape. */
+    Shdw19 = "shdw19",
+    /** OOXML shdw20: Front Bottom Shadow, a front-facing shadow below the shape. */
+    Shdw20 = "shdw20"
+}
 /**
  * Shape fill type enum
  * Currently, PatternFill and PictureFill are not supported, but we define them for future use, if will be treat as Nofill currently.

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

@@ -1,4 +1,4 @@
-import type { BasicShapeEnum, ImageFillModeEnum, ImageSourceTypeEnum, ShapeArrowSizeEnum, ShapeArrowTypeEnum, ShapeFillEnum, ShapeGradientTypeEnum, ShapeLineCapEnum, ShapeLineDashEnum, ShapeLineJoinEnum, ShapeLineTypeEnum, ShapeOperatorEnum, ShapeRenderModeEnum, ShapeSketchTypeEnum, ShapeTypeEnum } from './shape-enum';
+import type { BasicShapeEnum, ImageFillModeEnum, ImageSourceTypeEnum, ShapeArrowSizeEnum, ShapeArrowTypeEnum, ShapeFillEnum, ShapeGradientTypeEnum, ShapeLineCapEnum, ShapeLineDashEnum, ShapeLineJoinEnum, ShapeLineTypeEnum, ShapeOperatorEnum, ShapePresetShadowValEnum, ShapeRenderModeEnum, ShapeSketchTypeEnum, ShapeTypeEnum } from './shape-enum';
 /**
  * GdContext 用来计算 OOXML Shape 的 Geometry Definitions (gd)
  * 包含：
@@ -575,6 +575,30 @@ export interface IShapeText extends IShapeTextAlign {
 export interface ICustomShapeTextData extends IShapeTextAlign {
     dataModel?: unknown;
 }
+/**
+ * A shape outer-shadow effect. Distances and blur radius use slide drawing
+ * units; direction is in degrees where 0 points right and 90 points down.
+ */
+export interface IShapeShadowEffect {
+    /** Shadow color as a CSS color string. */
+    color: string;
+    /** OOXML preset shadow value, when the shadow originated from `<a:prstShdw>`. */
+    preset?: ShapePresetShadowValEnum;
+    /** Shadow opacity, from 0 (transparent) to 1 (opaque). */
+    opacity?: number;
+    /** Blur radius in slide drawing units. */
+    blurRadius?: number;
+    /** Direction angle in degrees, with 0 pointing right and 90 pointing down. */
+    direction?: number;
+    /** Offset distance from the shape in slide drawing units. */
+    distance?: number;
+    /** Horizontal shadow scale factor; 1 means 100%. */
+    sx?: number;
+    /** Vertical shadow scale factor; 1 means 100%. */
+    sy?: number;
+    /** Whether the shadow rotates together with the shape. */
+    rotateWithShape?: boolean;
+}
 /**
  * This interface defines the shape data structure , and this part will save in json
  */
@@ -643,6 +667,8 @@ export interface IBasicShapeData {
     adjustValues?: Record<string, number>;
     isCustom?: boolean;
     customGeometry?: IPresetShapeConfig;
+    /** Basic outer shadow effect applied while rendering the shape path. */
+    outerShadow?: IShapeShadowEffect;
     shapeText?: IShapeText | ICustomShapeTextData;
     /**
      * Text box inset used to calculate the editable/rendered text rect.