@thinkfree.dev/tfo-sdk 0.2.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -804,38 +804,54 @@
804
804
  "params": "alignType: AlignType",
805
805
  "ret": null,
806
806
  "array": false,
807
- "doc": "도형을 슬라이드 기준으로 정렬한다."
807
+ "doc": "도형을 슬라이드 기준으로 정렬한다. 이동이 불가능한 도형이면 무시된다. 그룹 자식도 그룹 안이 아니라 슬라이드를 기준으로 움직인다(에디터와 같다). 자식이 그룹 밖으로 나가면 그룹이 자식을 담도록 함께 넓어진다."
808
808
  },
809
809
  {
810
810
  "name": "flip",
811
811
  "params": "direction: FlipDirection",
812
812
  "ret": null,
813
813
  "array": false,
814
- "doc": "도형을 상하 또는 좌우로 반전한다."
814
+ "doc": "도형을 상하 또는 좌우로 반전한다. 현재 반전 상태를 뒤집는 토글이며, 지금 반전돼 있는지는 isFlippedH()/isFlippedV() 로 읽는다. 회전이 불가능한 도형에서는 반전도 무시된다. 회전된 도형은 각도도 거울상으로 함께 바뀐다 (getRotation() 값이 360 - 기존 각도 로 바뀐다)."
815
815
  },
816
816
  {
817
817
  "name": "getAdjustValues",
818
818
  "params": "",
819
819
  "ret": null,
820
820
  "array": true,
821
- "text": "AdjustValue[]",
822
- "doc": "일반 도형에 정의된 조절값과 조절 가능한 범위를 반환한다. 반환된 name은 조절값 조회와 변경 API에서 사용한다."
821
+ "text": "AdjustValue[] | null",
822
+ "doc": "일반 도형에 정의된 조절값과 조절 가능한 범위를 반환한다. 반환된 name 은 조절값 조회와 변경 API 에서 사용한다."
823
823
  },
824
824
  {
825
825
  "name": "getAlignH",
826
- "params": "range?: { from: number; to: number }",
826
+ "params": "range?: TextRange",
827
827
  "ret": null,
828
828
  "array": false,
829
829
  "text": "TextAlignH | null",
830
830
  "doc": "대표 단락의 가로 정렬을 반환한다. (setAlignH 대칭)"
831
831
  },
832
832
  {
833
- "name": "getBold",
833
+ "name": "getAlignV",
834
834
  "params": "",
835
835
  "ret": null,
836
836
  "array": false,
837
+ "text": "TextAlignV | null",
838
+ "doc": "텍스트 세로 정렬을 반환한다. (setAlignV 대칭) TextAlignV 는 TOP 이 0 인 숫자 enum 이라, 값이 있는지는 truthy 검사가 아니라 null 비교로 본다."
839
+ },
840
+ {
841
+ "name": "getBold",
842
+ "params": "range?: TextRange",
843
+ "ret": null,
844
+ "array": false,
837
845
  "text": "boolean | null",
838
- "doc": "대표 run 의 굵게 여부를 반환한다. (setBold 대칭)"
846
+ "doc": "대표 run 의 굵게 여부를 반환한다. (setBold 대칭 — 상속까지 반영된 실제 적용값)"
847
+ },
848
+ {
849
+ "name": "getBulletStyle",
850
+ "params": "range?: TextRange",
851
+ "ret": null,
852
+ "array": false,
853
+ "text": "BulletStyle | null",
854
+ "doc": "대표 단락의 글머리 기호 스타일을 반환한다. 반환 필드를 풀어서 setBulletStyle(type, subType, startAt) 에 넘길 수 있다. 값은 레이아웃/마스터 상속까지 반영해 실제 적용된 값이고, 없는 값(시작 번호)과 되넘길 수 없는 값(프리셋 밖 번호 유형)은 키를 담지 않는다. 그림 글머리·프리셋 밖 문자는 조회 전용이라 그대로는 적용되지 않는다. (제약은 setBulletStyle 참조)"
839
855
  },
840
856
  {
841
857
  "name": "getEffects",
@@ -843,7 +859,7 @@
843
859
  "ret": null,
844
860
  "array": false,
845
861
  "text": "Effects | null",
846
- "doc": "도형에 적용된 효과를 반환한다. 적용된 효과만 키로 포함된다. 각 값은 대응 setter(setOuterShadow/setInnerShadow/setGlow/setSoftEdge/setReflection/set3d) 인자와 대칭. 모델 UI obj 를 경유하므로 길이(pt)·비율(%)은 소수 첫째 자리까지만 정확하다 — 그보다 작은 차이는 왕복에서 반올림된다(렌더에는 나타나지 않는 수준)."
862
+ "doc": "도형에 적용된 효과를 반환한다. 적용된 효과만 키로 포함된다. 각 값은 대응 setter(setOuterShadow/setInnerShadow/setGlow/setSoftEdge/setReflection/set3d) 의 인자와 같은 형태다. 그림자·네온의 alpha 는 불투명(0)이어도 항상 포함되고, 길이(pt)·비율(%)은 소수 첫째 자리로 반올림된다. outerShadow·innerShadow 가 함께 실린 문서면 둘 다 담는다 (setter 로는 하나만 넣을 수 있다)."
847
863
  },
848
864
  {
849
865
  "name": "getFill",
@@ -851,11 +867,11 @@
851
867
  "ret": null,
852
868
  "array": false,
853
869
  "text": "Fill | null",
854
- "doc": "도형 채우기를 반환한다. (setSolidFill/setGradientFill/setImageFill/removeFill 대칭) type 으로 분기해 그대로 대응 setter 에 넘길 수 있다."
870
+ "doc": "도형 채우기를 반환한다. (setFill 대칭 - 반환 객체를 그대로 넘길 수 있다) type 별 개별 setter 는 setSolidFill/setGradientFill/setImageFill/setPatternFill/removeFill 이다."
855
871
  },
856
872
  {
857
873
  "name": "getFirstLineIndent",
858
- "params": "range?: { from: number; to: number }",
874
+ "params": "range?: TextRange",
859
875
  "ret": null,
860
876
  "array": false,
861
877
  "text": "number | null",
@@ -863,27 +879,27 @@
863
879
  },
864
880
  {
865
881
  "name": "getFontFamily",
866
- "params": "",
882
+ "params": "range?: TextRange",
867
883
  "ret": null,
868
884
  "array": false,
869
885
  "text": "string | null",
870
- "doc": "대표 run 의 글꼴 이름을 반환한다. (setFontFamily 대칭)"
886
+ "doc": "대표 run 의 글꼴 이름을 반환한다. (setFontFamily 대칭 — 상속까지 반영된 실제 적용값)"
871
887
  },
872
888
  {
873
889
  "name": "getFontSize",
874
- "params": "",
890
+ "params": "range?: TextRange",
875
891
  "ret": null,
876
892
  "array": false,
877
893
  "text": "number | null",
878
- "doc": "대표 run 의 글자 크기(pt)를 반환한다. (setFontSize 대칭)"
894
+ "doc": "대표 run 의 글자 크기(pt)를 반환한다. (setFontSize 대칭 — 상속까지 반영된 실제 적용값)"
879
895
  },
880
896
  {
881
897
  "name": "getFontStyle",
882
- "params": "",
898
+ "params": "range?: TextRange",
883
899
  "ret": null,
884
900
  "array": false,
885
901
  "text": "FontStyle | null",
886
- "doc": "대표 run(첫 run)의 글꼴 스타일을 반환한다. (setFontStyle 대칭) 반환 객체를 그대로 다른 개체의 setFontStyle 에 넘길 수 있다. 값이 없는 속성은 키를 생략한다."
902
+ "doc": "대표 run(range 가 걸친 첫 run)의 글꼴 스타일을 반환한다. (setFontStyle 대칭) 반환 객체를 그대로 다른 개체의 setFontStyle 에 넘길 수 있다. 값이 없는 속성은 키를 담지 않는다. 값은 레이아웃/마스터/표 스타일 상속까지 반영해 실제 적용된 값이라 run 이 직접 지정한 값만 골라낼 수는 없다."
887
903
  },
888
904
  {
889
905
  "name": "getHeight",
@@ -899,19 +915,19 @@
899
915
  "ret": null,
900
916
  "array": false,
901
917
  "text": "Hyperlink | null",
902
- "doc": "도형에 설정된 하이퍼링크를 반환한다. 반환 객체를 그대로 setHyperlink 에 넘길 수 있다. 지원하지 않는 action(program/macro/ole 등)은 공개 타입으로 노출하지 않고 null 을 반환한다."
918
+ "doc": "도형에 설정된 하이퍼링크를 반환한다. 반환 객체를 그대로 setHyperlink 에 넘길 수 있다. 지원하지 않는 종류(프로그램 실행·매크로 등)가 걸려 있으면 null 이다."
903
919
  },
904
920
  {
905
921
  "name": "getItalic",
906
- "params": "",
922
+ "params": "range?: TextRange",
907
923
  "ret": null,
908
924
  "array": false,
909
925
  "text": "boolean | null",
910
- "doc": "대표 run 의 기울임 여부를 반환한다. (setItalic 대칭)"
926
+ "doc": "대표 run 의 기울임 여부를 반환한다. (setItalic 대칭 — 상속까지 반영된 실제 적용값)"
911
927
  },
912
928
  {
913
929
  "name": "getLevel",
914
- "params": "range?: { from: number; to: number }",
930
+ "params": "range?: TextRange",
915
931
  "ret": null,
916
932
  "array": false,
917
933
  "text": "number | null",
@@ -951,7 +967,7 @@
951
967
  },
952
968
  {
953
969
  "name": "getLineSpacing",
954
- "params": "range?: { from: number; to: number }",
970
+ "params": "range?: TextRange",
955
971
  "ret": null,
956
972
  "array": false,
957
973
  "text": "number | null",
@@ -959,7 +975,7 @@
959
975
  },
960
976
  {
961
977
  "name": "getLineSpacingType",
962
- "params": "range?: { from: number; to: number }",
978
+ "params": "range?: TextRange",
963
979
  "ret": null,
964
980
  "array": false,
965
981
  "text": "LineSpacingType | null",
@@ -971,7 +987,7 @@
971
987
  "ret": null,
972
988
  "array": false,
973
989
  "text": "LineStyle | null",
974
- "doc": "선 스타일을 반환한다. (setLineColor/setLineWidth/setLineDash/setLineCap/setLineJoin 대칭)"
990
+ "doc": "선 스타일을 반환한다. (setLineStyle 대칭 - 반환 객체를 그대로 넘길 수 있다) 개별 setter 는 setLineColor/setLineGradient/setLineWidth/setLineDash/setLineCap/setLineJoin 이다."
975
991
  },
976
992
  {
977
993
  "name": "getLineWidth",
@@ -983,7 +999,7 @@
983
999
  },
984
1000
  {
985
1001
  "name": "getMarginLeft",
986
- "params": "range?: { from: number; to: number }",
1002
+ "params": "range?: TextRange",
987
1003
  "ret": null,
988
1004
  "array": false,
989
1005
  "text": "number | null",
@@ -991,11 +1007,19 @@
991
1007
  },
992
1008
  {
993
1009
  "name": "getParagraphStyle",
994
- "params": "range?: { from: number; to: number }",
1010
+ "params": "range?: TextRange",
995
1011
  "ret": null,
996
1012
  "array": false,
997
1013
  "text": "ParagraphStyle | null",
998
- "doc": "대표 단락(range 가 걸친 첫 단락)의 단락 서식을 반환한다. (setParagraphStyle 대칭) 반환 객체를 그대로 다른 개체의 setParagraphStyle 에 넘길 수 있다. 값이 없는 속성은 키를 생략한다. 값은 레이아웃/마스터 상속이 반영된 해석값이다. 단락이 직접 지정한 값만 골라낼 수는 없다. 같은 단락에 그대로 되돌려주면 상속값과 같은 속성은 오버라이드로 굳지 않고 지워진다. (updateTextPPr 동작) 목록 수준은 서식 값이 아니라 상속 프리셋이라 이 객체에 담지 않는다. (getLevel 대칭)"
1014
+ "doc": "대표 단락(range 가 걸친 첫 단락)의 단락 서식을 반환한다. (setParagraphStyle 대칭) 반환 객체를 그대로 다른 개체의 setParagraphStyle 에 넘길 수 있다. 값이 없는 속성은 키를 담지 않는다. 값은 레이아웃/마스터 상속까지 반영해 실제 적용된 값이라 단락이 직접 지정한 값만 골라낼 수는 없고, 같은 단락에 그대로 다시 넘기면 상속값과 같은 속성은 직접 지정으로 남지 않는다. 목록 수준은 서식 값이 아니라 상속 프리셋이라 담지 않는다. (getLevel 대칭)"
1015
+ },
1016
+ {
1017
+ "name": "getPlaceholderType",
1018
+ "params": "",
1019
+ "ret": null,
1020
+ "array": false,
1021
+ "text": "PlaceholderType | null",
1022
+ "doc": "도형의 placeholder 종류를 반환한다."
999
1023
  },
1000
1024
  {
1001
1025
  "name": "getPresetId",
@@ -1011,11 +1035,11 @@
1011
1035
  "ret": null,
1012
1036
  "array": false,
1013
1037
  "text": "number | null",
1014
- "doc": "도형의 회전 각도를 반환한다. (rotate 대칭)"
1038
+ "doc": "도형의 회전 각도를 반환한다. (setRotation 대칭)"
1015
1039
  },
1016
1040
  {
1017
1041
  "name": "getSpaceAfter",
1018
- "params": "range?: { from: number; to: number }",
1042
+ "params": "range?: TextRange",
1019
1043
  "ret": null,
1020
1044
  "array": false,
1021
1045
  "text": "number | null",
@@ -1023,7 +1047,7 @@
1023
1047
  },
1024
1048
  {
1025
1049
  "name": "getSpaceBefore",
1026
- "params": "range?: { from: number; to: number }",
1050
+ "params": "range?: TextRange",
1027
1051
  "ret": null,
1028
1052
  "array": false,
1029
1053
  "text": "number | null",
@@ -1031,19 +1055,19 @@
1031
1055
  },
1032
1056
  {
1033
1057
  "name": "getStrike",
1034
- "params": "",
1058
+ "params": "range?: TextRange",
1035
1059
  "ret": null,
1036
1060
  "array": false,
1037
1061
  "text": "Strike | null",
1038
- "doc": "대표 run 의 취소선 유형을 반환한다. (setStrike 대칭)"
1062
+ "doc": "대표 run 의 취소선 유형을 반환한다. (setStrike 대칭 — 상속까지 반영된 실제 적용값)"
1039
1063
  },
1040
1064
  {
1041
1065
  "name": "getText",
1042
- "params": "range?: { from: number; to: number }",
1066
+ "params": "range?: TextRange",
1043
1067
  "ret": null,
1044
1068
  "array": false,
1045
1069
  "text": "string",
1046
- "doc": "텍스트를 plain text로 반환한다."
1070
+ "doc": "텍스트를 plain text로 반환한다. 문단 사이의 개행은 그대로 들어가지만, 마지막 문단을 끝맺는 개행은 글자가 아니라 담지 않는다 (빈 텍스트는 \"\")."
1047
1071
  },
1048
1072
  {
1049
1073
  "name": "getTextboxAutoFit",
@@ -1055,19 +1079,19 @@
1055
1079
  },
1056
1080
  {
1057
1081
  "name": "getTextColor",
1058
- "params": "",
1082
+ "params": "range?: TextRange",
1059
1083
  "ret": null,
1060
1084
  "array": false,
1061
1085
  "text": "string | null",
1062
- "doc": "대표 run 의 글자 색상을 반환한다. (setTextColor 대칭)"
1086
+ "doc": "대표 run 의 글자 색상을 반환한다. (setTextColor 대칭 — 상속까지 반영된 실제 적용값)"
1063
1087
  },
1064
1088
  {
1065
1089
  "name": "getTextHyperlink",
1066
- "params": "range?: { from: number; to: number }",
1090
+ "params": "range?: TextRange",
1067
1091
  "ret": null,
1068
1092
  "array": false,
1069
1093
  "text": "Hyperlink | null",
1070
- "doc": "텍스트 구간의 하이퍼링크를 반환한다. (setTextHyperlink 대칭 — 반환 객체를 그대로 넘겨 하이퍼링크를 복사할 수 있다) range 를 주면 그 구간의 첫 글자, 없으면 텍스트 첫 글자가 속한 run 기준이다. 도형 자체에 걸린 하이퍼링크는 getHyperlink 로 읽는다."
1094
+ "doc": "텍스트 구간의 하이퍼링크를 반환한다. (setTextHyperlink 대칭 — 반환 객체를 그대로 넘겨 복사할 수 있다) range 를 주면 그 구간의 첫 글자, range 가 없으면 텍스트의 첫 글자가 속한 run 을 기준으로 한다. 도형 자체에 걸린 하이퍼링크는 getHyperlink 로 읽는다."
1071
1095
  },
1072
1096
  {
1073
1097
  "name": "getTransform",
@@ -1075,15 +1099,15 @@
1075
1099
  "ret": null,
1076
1100
  "array": false,
1077
1101
  "text": "ShapeTransform | null",
1078
- "doc": "도형의 위치, 크기, 회전 정보를 반환한다."
1102
+ "doc": "도형의 위치, 크기, 회전 정보를 반환한다. x/y 는 반전(flip) 여부와 무관하게 도형의 좌상단이라, 반환값을 다른 도형의 setTransform 에 그대로 넘기면 두 도형이 같은 자리에 놓인다. 값은 에디터 입력 단위로 반올림해 반환한다 - 크기는 소수 한 자리, 위치는 정수. setter 도 같은 단위로 넣으므로, 임포트 문서처럼 더 잘게 놓인 도형은 되넘길 때 그만큼 움직인다."
1079
1103
  },
1080
1104
  {
1081
1105
  "name": "getUnderline",
1082
- "params": "",
1106
+ "params": "range?: TextRange",
1083
1107
  "ret": null,
1084
1108
  "array": false,
1085
1109
  "text": "Underline | null",
1086
- "doc": "대표 run 의 밑줄 유형을 반환한다. (setUnderline 대칭)"
1110
+ "doc": "대표 run 의 밑줄 유형을 반환한다. (setUnderline 대칭 — 상속까지 반영된 실제 적용값)"
1087
1111
  },
1088
1112
  {
1089
1113
  "name": "getWidth",
@@ -1109,6 +1133,22 @@
1109
1133
  "text": "number | null",
1110
1134
  "doc": "도형의 Y 좌표를 반환한다. (setY 대칭)"
1111
1135
  },
1136
+ {
1137
+ "name": "getZOrderIndex",
1138
+ "params": "",
1139
+ "ret": null,
1140
+ "array": false,
1141
+ "text": "number | null",
1142
+ "doc": "부모(슬라이드, 그룹 자식이면 그 그룹) 안에서 도형의 z-order 순번을 반환한다. 0 이 맨 뒤이며, 클수록 앞이다."
1143
+ },
1144
+ {
1145
+ "name": "hasText",
1146
+ "params": "",
1147
+ "ret": null,
1148
+ "array": false,
1149
+ "text": "boolean | null",
1150
+ "doc": "도형이 텍스트를 담고 있는지 반환한다. 에디터가 텍스트를 비었다고 보는 기준과 같다 — 공백만 있거나 빈 문단이 둘 이상(개행만 넣은 상태)이면 true, 빈 문단 하나뿐이면 false 다. 도형 레벨 텍스트가 없는 종류(표·그룹·차트)는 항상 false 다. (표는 셀 단위로 조회)"
1151
+ },
1112
1152
  {
1113
1153
  "name": "insertSymbol",
1114
1154
  "params": "textOffset: number, symbol: string",
@@ -1147,6 +1187,30 @@
1147
1187
  "text": "this is Diagram",
1148
1188
  "doc": "이 핸들이 `Diagram` 인지 판별한다 (union 좁히기용 type guard). SDK 핸들의 내부 판별값을 동기 검사한다 — postMessage 왕복 없음, await 불필요."
1149
1189
  },
1190
+ {
1191
+ "name": "isFlatTx",
1192
+ "params": "",
1193
+ "ret": null,
1194
+ "array": false,
1195
+ "text": "boolean | null",
1196
+ "doc": "3D 회전 시 텍스트를 평면으로 유지하는지 반환한다. (setFlatTx 대칭)"
1197
+ },
1198
+ {
1199
+ "name": "isFlippedH",
1200
+ "params": "",
1201
+ "ret": null,
1202
+ "array": false,
1203
+ "text": "boolean | null",
1204
+ "doc": "도형이 좌우로 반전된 상태인지 반환한다. (flip(FlipDirection.HORIZONTAL) 을 호출하면 이 값이 뒤집힌다)"
1205
+ },
1206
+ {
1207
+ "name": "isFlippedV",
1208
+ "params": "",
1209
+ "ret": null,
1210
+ "array": false,
1211
+ "text": "boolean | null",
1212
+ "doc": "도형이 상하로 반전된 상태인지 반환한다. (flip(FlipDirection.VERTICAL) 을 호출하면 이 값이 뒤집힌다)"
1213
+ },
1150
1214
  {
1151
1215
  "name": "isGroup",
1152
1216
  "params": "",
@@ -1184,7 +1248,7 @@
1184
1248
  "params": "",
1185
1249
  "ret": null,
1186
1250
  "array": false,
1187
- "text": "boolean",
1251
+ "text": "boolean | null",
1188
1252
  "doc": "도형이 placeholder(제목 · 본문 틀 등)인지 반환한다."
1189
1253
  },
1190
1254
  {
@@ -1222,7 +1286,7 @@
1222
1286
  "params": "effectType: EffectType",
1223
1287
  "ret": null,
1224
1288
  "array": false,
1225
- "doc": "효과를 제거한다."
1289
+ "doc": "효과를 제거한다. 그 효과가 걸려 있지 않으면 아무 일도 하지 않는다. 도형이 직접 가진 효과만 제거한다 - 도형 스타일(effectRef)에서 상속받은 효과는 제거할 수 없어, getEffects() 가 돌려주는데도 아무 일도 하지 않는 경우가 있다."
1226
1290
  },
1227
1291
  {
1228
1292
  "name": "removeFill",
@@ -1247,7 +1311,7 @@
1247
1311
  },
1248
1312
  {
1249
1313
  "name": "removeTextHyperlink",
1250
- "params": "range?: { from: number; to: number }",
1314
+ "params": "range?: TextRange",
1251
1315
  "ret": null,
1252
1316
  "array": false,
1253
1317
  "doc": "텍스트의 하이퍼링크를 제거한다. (도형 자체에 걸린 하이퍼링크는 removeHyperlink)"
@@ -1257,28 +1321,21 @@
1257
1321
  "params": "order: ShapeZOrder",
1258
1322
  "ret": null,
1259
1323
  "array": false,
1260
- "doc": "도형의 정렬 순서(앞으로/뒤로)를 변경한다."
1261
- },
1262
- {
1263
- "name": "rotate",
1264
- "params": "rotation: number",
1265
- "ret": null,
1266
- "array": false,
1267
- "doc": "도형을 회전한다."
1324
+ "doc": "도형의 정렬 순서(앞으로/뒤로)를 변경한다. 이미 목표 위치라 바뀔 것이 없으면 무시된다."
1268
1325
  },
1269
1326
  {
1270
1327
  "name": "set3d",
1271
1328
  "params": "scene3d?: Scene3d, sp3d?: Sp3d",
1272
1329
  "ret": null,
1273
1330
  "array": false,
1274
- "doc": "도형에 3D 효과를 적용한다. scene3d 또는 sp3d 중 비어있는 인자는 적용하지 않는다."
1331
+ "doc": "도형에 3D 효과를 적용한다. scene3d 와 sp3d 중 비어 있는 인자는 적용하지 않는다."
1275
1332
  },
1276
1333
  {
1277
1334
  "name": "setAdjustValue",
1278
1335
  "params": "name: string, value: number",
1279
1336
  "ret": null,
1280
1337
  "array": false,
1281
- "doc": "일반 도형의 조절값(adjust value) 하나를 변경한다. 여러 조절값을 함께 변경하려면 setAdjustValues를 사용한다."
1338
+ "doc": "일반 도형의 조절값(adjust value) 하나를 변경한다. 여러 조절값을 함께 변경하려면 setAdjustValues 를 사용한다."
1282
1339
  },
1283
1340
  {
1284
1341
  "name": "setAdjustValues",
@@ -1289,7 +1346,7 @@
1289
1346
  },
1290
1347
  {
1291
1348
  "name": "setAlignH",
1292
- "params": "align: TextAlignH, range?: { from: number; to: number }",
1349
+ "params": "align: TextAlignH, range?: TextRange",
1293
1350
  "ret": null,
1294
1351
  "array": false,
1295
1352
  "doc": "텍스트 가로 정렬을 설정한다. range 를 주면 그 구간이 걸친 단락에만 적용한다."
@@ -1299,84 +1356,77 @@
1299
1356
  "params": "align: TextAlignV",
1300
1357
  "ret": null,
1301
1358
  "array": false,
1302
- "doc": "텍스트 세로 정렬을 설정한다."
1359
+ "doc": "텍스트 세로 정렬을 설정한다. (getAlignV 대칭)"
1303
1360
  },
1304
1361
  {
1305
1362
  "name": "setBold",
1306
- "params": "enabled: boolean, range?: { from: number; to: number }",
1363
+ "params": "enabled: boolean, range?: TextRange",
1307
1364
  "ret": null,
1308
1365
  "array": false,
1309
- "doc": "글자 굵게 설정."
1366
+ "doc": "글자를 굵게 설정한다."
1310
1367
  },
1311
1368
  {
1312
1369
  "name": "setBulletStyle",
1313
- "params": "bulletType: BulletType, subType?: NumberedType | CharType, startAt?: number, range?: { from: number; to: number }",
1314
- "ret": null,
1315
- "array": false,
1316
- "doc": "글머리 기호 스타일을 설정한다."
1317
- },
1318
- {
1319
- "name": "setEffect",
1320
- "params": "effect: Effect",
1370
+ "params": "bulletType: Exclude<BulletType, \"buBlip\">, subType?: NumberedType | CharType, startAt?: number, range?: TextRange",
1321
1371
  "ret": null,
1322
1372
  "array": false,
1323
- "doc": "도형에 효과(그림자/광선/반사 등)를 직접 obj로 적용한다. 단순 케이스는 setOuterShadow/setInnerShadow/setGlow/setSoftEdge/setReflection 사용 권장."
1373
+ "doc": "글머리 기호 스타일을 설정한다. (getBulletStyle 대칭) 그림 글머리(BulletType.BLIP)는 적용을 지원하지 않는 조회 전용 유형이라 거부한다. CharType 프리셋 밖의 문자도 적용할 수 없다 (조회 전용이라 받을 인자가 없다)."
1324
1374
  },
1325
1375
  {
1326
1376
  "name": "setEffects",
1327
- "params": "effects: Effects",
1377
+ "params": "effects?: Effects",
1328
1378
  "ret": null,
1329
1379
  "array": false,
1330
- "doc": "getEffects() 가 반환한 효과 객체를 그대로 적용한다. (getEffects 대칭 — 도형→도형 효과 복사) 포함된 효과 키만 대응 setter 로 적용한다. scene3d/sp3d 는 set3d 로 함께 넘긴다."
1380
+ "doc": "getEffects() 가 반환한 효과 객체를 그대로 적용한다. (getEffects 대칭 — 도형→도형 효과 복사) 포함된 효과 키만 대응 setter 로 적용한다. scene3d/sp3d 는 set3d 로 함께 넘긴다. 대상의 기존 효과를 지우지는 않는다 - 완전 복사하려면 removeEffect/remove3d 로 먼저 제거한 뒤 적용한다. outerShadow 와 innerShadow 를 함께 넘기면 거부하지 않고 순서대로 적용해 나중 것만 남는다."
1331
1381
  },
1332
1382
  {
1333
1383
  "name": "setFill",
1334
- "params": "fill: Fill",
1384
+ "params": "fill?: Fill",
1335
1385
  "ret": null,
1336
1386
  "array": false,
1337
- "doc": "getFill() 이 반환한 채우기 객체를 그대로 적용한다. (getFill 대칭 — 도형→도형 채우기 복사) type 으로 분기해 대응 setter 를 호출한다. image 는 readback 의 embed 를 재사용해 같은 문서 안에서 복원한다. embed 가 없는 image 입력은 무시된다(새 이미지는 개별 setImageFill 사용)."
1387
+ "doc": "getFill() 이 반환한 채우기 객체를 그대로 적용한다. (getFill 대칭 — 도형→도형 채우기 복사) image 는 조회 결과의 embed 를 재사용하므로 같은 문서 안에서만 복원된다. embed 없는 image 는 적용할 그림이 없어 거부한다 (새 이미지는 setImageFill)."
1338
1388
  },
1339
1389
  {
1340
1390
  "name": "setFirstLineIndent",
1341
- "params": "firstLineIndent: number, range?: { from: number; to: number }",
1391
+ "params": "firstLineIndent: number, range?: TextRange",
1342
1392
  "ret": null,
1343
1393
  "array": false,
1344
- "doc": "단락 첫 줄의 들여쓰기(UI \"첫 줄\")를 설정한다. 둘째 줄부터는 marginLeft 를 따른다. 양수는 들여쓰기, 음수는 내어쓰기, 0 은 없음이다. (UI 의 없음/들여쓰기/내어쓰기 구분을 부호 하나로 표현한다) 글머리 기호 목록의 계층 깊이를 바꾸려는 것이면 setLevel 이다."
1394
+ "doc": "단락 첫 줄의 들여쓰기(UI \"첫 줄\")를 설정한다. 둘째 줄부터는 marginLeft 를 따른다. 양수는 들여쓰기, 음수는 내어쓰기, 0 은 들여쓰기 없음이다. 글머리 기호 목록의 계층 깊이를 바꾸려면 setLevel 을 사용한다."
1345
1395
  },
1346
1396
  {
1347
1397
  "name": "setFlatTx",
1348
1398
  "params": "enabled: boolean",
1349
1399
  "ret": null,
1350
1400
  "array": false,
1351
- "doc": "3D 회전 시 텍스트를 평면으로 유지할지 설정한다."
1401
+ "doc": "3D 회전 시 텍스트를 평면으로 유지할지 설정한다. (isFlatTx 대칭)"
1352
1402
  },
1353
1403
  {
1354
1404
  "name": "setFontFamily",
1355
- "params": "fontFamily: string, range?: { from: number; to: number }",
1405
+ "params": "fontFamily: string, range?: TextRange",
1356
1406
  "ret": null,
1357
1407
  "array": false,
1358
- "doc": "글꼴 설정."
1408
+ "doc": "글꼴을 설정한다."
1359
1409
  },
1360
1410
  {
1361
1411
  "name": "setFontSize",
1362
- "params": "fontSize: number, range?: { from: number; to: number }",
1412
+ "params": "fontSize: number, range?: TextRange",
1363
1413
  "ret": null,
1364
1414
  "array": false,
1365
- "doc": "글자 크기 설정."
1415
+ "doc": "글자 크기를 설정한다."
1366
1416
  },
1367
1417
  {
1368
1418
  "name": "setFontStyle",
1369
- "params": "style: FontStyle, range?: { from: number; to: number }",
1419
+ "params": "style: FontStyle, range?: TextRange",
1370
1420
  "ret": null,
1371
1421
  "array": false,
1372
1422
  "doc": "글꼴 스타일을 설정한다. 단일 속성은 setBold/setItalic/setFontSize/setFontFamily/setTextColor 사용 권장."
1373
1423
  },
1374
1424
  {
1375
1425
  "name": "setGlow",
1376
- "params": "glow?: { color?: string; alpha?: number; rad?: number }",
1426
+ "params": "glow?: Glow",
1377
1427
  "ret": null,
1378
1428
  "array": false,
1379
- "doc": "네온(광선) 효과를 적용한다."
1429
+ "doc": "네온(광선) 효과를 적용한다. (getEffects().glow 대칭 - 반환 객체를 그대로 넘길 수 있다) 생략한 필드는 기본값으로 채운다 (필드별 기본값은 Glow 참조)."
1380
1430
  },
1381
1431
  {
1382
1432
  "name": "setGradientFill",
@@ -1390,14 +1440,14 @@
1390
1440
  "params": "height: number",
1391
1441
  "ret": null,
1392
1442
  "array": false,
1393
- "doc": "도형의 높이를 설정한다."
1443
+ "doc": "도형의 높이를 설정한다. 크기 조정이 불가능한 도형이면 무시된다."
1394
1444
  },
1395
1445
  {
1396
1446
  "name": "setHyperlink",
1397
1447
  "params": "hyperlink: Hyperlink",
1398
1448
  "ret": null,
1399
1449
  "array": false,
1400
- "doc": "도형에 하이퍼링크를 설정한다. (getHyperlink 대칭 — 반환 객체를 그대로 넘겨 하이퍼링크를 복사할 수 있다) other(program/macro/ole 등)와 유효하지 않은 대상(없는 슬라이드 id·ShowJumpType 밖의 값)은 무시한다."
1450
+ "doc": "도형에 하이퍼링크를 설정한다. (getHyperlink 대칭 — 반환 객체를 그대로 넘겨 하이퍼링크를 복사할 수 있다) 지원하지 않는 종류나 유효하지 않은 대상(없는 슬라이드 id 등)은 무시한다."
1401
1451
  },
1402
1452
  {
1403
1453
  "name": "setImageFill",
@@ -1408,24 +1458,24 @@
1408
1458
  },
1409
1459
  {
1410
1460
  "name": "setInnerShadow",
1411
- "params": "shadow?: { color?: string; alpha?: number; blur?: number; dist?: number; dir?: number }",
1461
+ "params": "shadow?: InnerShadow",
1412
1462
  "ret": null,
1413
1463
  "array": false,
1414
- "doc": "내부 그림자를 적용한다."
1464
+ "doc": "내부 그림자를 적용한다. (getEffects().innerShadow 대칭 - 반환 객체를 그대로 넘길 수 있다) 생략한 필드는 기본값으로 채운다 (필드별 기본값은 InnerShadow 참조). 도형이 갖는 그림자는 하나다 - 외부 그림자가 걸려 있으면 내부 그림자로 바뀐다."
1415
1465
  },
1416
1466
  {
1417
1467
  "name": "setItalic",
1418
- "params": "enabled: boolean, range?: { from: number; to: number }",
1468
+ "params": "enabled: boolean, range?: TextRange",
1419
1469
  "ret": null,
1420
1470
  "array": false,
1421
- "doc": "글자 기울임 설정."
1471
+ "doc": "글자 기울임을 설정한다."
1422
1472
  },
1423
1473
  {
1424
1474
  "name": "setLevel",
1425
- "params": "level: number, range?: { from: number; to: number }",
1475
+ "params": "level: number, range?: TextRange",
1426
1476
  "ret": null,
1427
1477
  "array": false,
1428
- "doc": "목록 수준(개요 계층 깊이)을 설정한다. range 가 걸친 단락을 모두 같은 수준으로 맞춘다. pt 단위 들여쓰기(setFirstLineIndent/setMarginLeft)와 달리 수준은 상속 프리셋 선택이라, 바꾸면 그 수준의 글머리 기호와 글자 크기가 함께 따라온다. marginLeft 는 새 수준의 값으로 덮인다. setMarginLeft 로 지정한 값도 버려지므로 둘을 함께 쓸 때는 setLevel 을 먼저 호출한다. (firstLineIndent 는 유지된다) 대상 텍스트가 허용하는 범위(제목 개체는 1 단계뿐)로 clamp 한다."
1478
+ "doc": "목록 수준(개요 계층 깊이)을 설정한다. range 가 걸친 단락을 모두 같은 수준으로 맞춘다. pt 단위 들여쓰기(setFirstLineIndent/setMarginLeft)와 달리 수준은 상속 프리셋 선택이라, 바꾸면 그 수준의 글머리 기호·글자 크기가 따라오고 marginLeft 는 새 수준의 값으로 덮인다. setMarginLeft 로 지정한 값도 버려지므로 둘을 함께 쓸 때는 setLevel 을 먼저 호출한다. (firstLineIndent 는 유지) 대상 텍스트가 허용하는 범위(제목 개체는 1 수준뿐)로 제한한다."
1429
1479
  },
1430
1480
  {
1431
1481
  "name": "setLineCap",
@@ -1464,14 +1514,14 @@
1464
1514
  },
1465
1515
  {
1466
1516
  "name": "setLineSpacing",
1467
- "params": "lineSpacing: number, type?: LineSpacingType, range?: { from: number; to: number }",
1517
+ "params": "lineSpacing: number, type?: LineSpacingType, range?: TextRange",
1468
1518
  "ret": null,
1469
1519
  "array": false,
1470
- "doc": "줄 간격을 설정한다. range 를 주면 그 구간이 걸친 단락에만 적용한다. MULTIPLE 이면 \"100%\" 형태, EXACT 이면 pt 입력을 twip view 값으로 변환한다"
1520
+ "doc": "줄 간격을 설정한다. range 를 주면 그 구간이 걸친 단락에만 적용한다. lineSpacing 의 단위는 유형에 따라 다르다 - MULTIPLE 이면 배수 백분율(150=1.5배), EXACT 이면 pt 다."
1471
1521
  },
1472
1522
  {
1473
1523
  "name": "setLineStyle",
1474
- "params": "style: LineStyle",
1524
+ "params": "style?: LineStyle",
1475
1525
  "ret": null,
1476
1526
  "array": false,
1477
1527
  "doc": "getLineStyle() 이 반환한 선 스타일 객체를 그대로 적용한다. (getLineStyle 대칭 — 도형→도형 선 복사)"
@@ -1485,45 +1535,52 @@
1485
1535
  },
1486
1536
  {
1487
1537
  "name": "setMarginLeft",
1488
- "params": "marginLeft: number, range?: { from: number; to: number }",
1538
+ "params": "marginLeft: number, range?: TextRange",
1489
1539
  "ret": null,
1490
1540
  "array": false,
1491
- "doc": "단락 전체의 왼쪽 여백(UI \"텍스트 앞\")을 설정한다. 첫 줄만 밀려면 setFirstLineIndent 를 쓴다."
1541
+ "doc": "단락 전체의 왼쪽 여백(UI \"텍스트 앞\")을 설정한다. 첫 줄만 들여쓰려면 setFirstLineIndent 를 사용한다."
1492
1542
  },
1493
1543
  {
1494
1544
  "name": "setOuterShadow",
1495
- "params": "shadow?: { color?: string; alpha?: number; blur?: number; dist?: number; dir?: number; sx?: number; sy?: number; kx?: number; ky?: number; algn?: RectAlign; rotWithShape?: boolean }",
1545
+ "params": "shadow?: OuterShadow",
1496
1546
  "ret": null,
1497
1547
  "array": false,
1498
- "doc": "외부 그림자를 적용한다."
1548
+ "doc": "외부 그림자를 적용한다. (getEffects().outerShadow 대칭 - 반환 객체를 그대로 넘길 수 있다) 생략한 필드는 기본값으로 채운다 (필드별 기본값은 OuterShadow 참조). 도형이 갖는 그림자는 하나다 - 내부 그림자가 걸려 있으면 외부 그림자로 바뀐다."
1499
1549
  },
1500
1550
  {
1501
1551
  "name": "setParagraphStyle",
1502
- "params": "style: ParagraphStyle, range?: { from: number; to: number }",
1552
+ "params": "style: ParagraphStyle, range?: TextRange",
1503
1553
  "ret": null,
1504
1554
  "array": false,
1505
- "doc": "단락 서식을 한 번에 설정한다. range 를 주면 그 구간이 걸친 단락에만 적용한다. 문단 모양 대화상자의 입력 항목과 1:1 로 대응하며, 대화상자와 같이 한 액션으로 적용해 실행 취소 단위가 하나다. 값을 준 속성만 바뀐다. null/undefined 는 \"변경 없음\"으로 무시하며, 지정한 값을 상속 상태로 되돌리는 방법은 아직 없다. 단일 속성은 setLineSpacing/setMarginLeft/setFirstLineIndent/setSpaceBefore/setSpaceAfter 사용 권장. 목록 수준은 부수 효과(글머리 기호·글자 크기)가 달라 여기 담지 않는다. (setLevel 참고) alignH 만 별도 액션(setAlignH)으로 나가므로 다른 속성과 함께 주면 실행 취소 단위가 2개로 나뉜다."
1555
+ "doc": "단락 서식을 한 번에 설정한다. range 를 주면 그 구간이 걸친 단락에만 적용한다. 값을 준 속성만 바뀐다. null/undefined 는 \"변경 없음\"으로 무시하며, 지정한 값을 상속 상태로 되돌리는 방법은 아직 없다. 단일 속성은 setLineSpacing/setMarginLeft/setFirstLineIndent/setSpaceBefore/setSpaceAfter 사용 권장. 목록 수준은 바꿀 때 딸려오는 부수 효과(글머리 기호·글자 크기)가 있어 여기 담지 않는다. (setLevel 참고)"
1506
1556
  },
1507
1557
  {
1508
1558
  "name": "setPatternFill",
1509
1559
  "params": "preset: PatternPreset, foreColor?: string, backColor?: string, foreAlpha?: number, backAlpha?: number",
1510
1560
  "ret": null,
1511
1561
  "array": false,
1512
- "doc": "패턴(무늬) 채우기를 설정한다. (getFill 왕복 대칭 — setFill 의 pattern 경로)"
1562
+ "doc": "패턴(무늬) 채우기를 설정한다. (getFill 왕복 대칭)"
1513
1563
  },
1514
1564
  {
1515
1565
  "name": "setReflection",
1516
- "params": "reflection?: { blur?: number; dist?: number; stPos?: number; endPos?: number; startAlpha?: number; endAlpha?: number; dir?: number; fadeDir?: number; sx?: number; sy?: number; kx?: number; ky?: number; algn?: RectAlign; rotWithShape?: boolean }",
1566
+ "params": "reflection?: Reflection",
1517
1567
  "ret": null,
1518
1568
  "array": false,
1519
- "doc": "반사 효과를 적용한다."
1569
+ "doc": "반사 효과를 적용한다. (getEffects().reflection 대칭 - 반환 객체를 그대로 넘길 수 있다) 생략한 필드는 기본값으로 채운다 (필드별 기본값은 Reflection 참조)."
1570
+ },
1571
+ {
1572
+ "name": "setRotation",
1573
+ "params": "rotation: number",
1574
+ "ret": null,
1575
+ "array": false,
1576
+ "doc": "도형의 회전 각도를 절대값으로 설정한다. 회전이 불가능한 도형이면 무시된다. (getRotation 대칭)"
1520
1577
  },
1521
1578
  {
1522
1579
  "name": "setSoftEdge",
1523
- "params": "softEdge?: { rad?: number }",
1580
+ "params": "softEdge?: SoftEdge",
1524
1581
  "ret": null,
1525
1582
  "array": false,
1526
- "doc": "옅은 테두리(softEdge) 효과를 적용한다."
1583
+ "doc": "옅은 테두리(softEdge) 효과를 적용한다. (getEffects().softEdge 대칭 - 반환 객체를 그대로 넘길 수 있다) 생략한 필드는 기본값으로 채운다 (필드별 기본값은 SoftEdge 참조)."
1527
1584
  },
1528
1585
  {
1529
1586
  "name": "setSolidFill",
@@ -1534,28 +1591,28 @@
1534
1591
  },
1535
1592
  {
1536
1593
  "name": "setSpaceAfter",
1537
- "params": "spaceAfter: number, range?: { from: number; to: number }",
1594
+ "params": "spaceAfter: number, range?: TextRange",
1538
1595
  "ret": null,
1539
1596
  "array": false,
1540
1597
  "doc": "단락 뒤 간격(UI \"문단 아래\")을 설정한다."
1541
1598
  },
1542
1599
  {
1543
1600
  "name": "setSpaceBefore",
1544
- "params": "spaceBefore: number, range?: { from: number; to: number }",
1601
+ "params": "spaceBefore: number, range?: TextRange",
1545
1602
  "ret": null,
1546
1603
  "array": false,
1547
1604
  "doc": "단락 앞 간격(UI \"문단 위\")을 설정한다."
1548
1605
  },
1549
1606
  {
1550
1607
  "name": "setStrike",
1551
- "params": "strike: Strike, range?: { from: number; to: number }",
1608
+ "params": "strike: Strike, range?: TextRange",
1552
1609
  "ret": null,
1553
1610
  "array": false,
1554
- "doc": "글자 취소선 설정."
1611
+ "doc": "글자 취소선을 설정한다."
1555
1612
  },
1556
1613
  {
1557
1614
  "name": "setText",
1558
- "params": "text: string, range?: { from: number; to: number }",
1615
+ "params": "text: string, range?: TextRange",
1559
1616
  "ret": null,
1560
1617
  "array": false,
1561
1618
  "doc": "텍스트를 설정한다. 인자 조합에 따라 다음과 같이 동작한다. - range 없음: 전체 텍스트를 text 로 교체 - range 있음: 지정한 구간만 text 로 교체 - text 가 빈 문자열(\"\")이면 교체 대신 해당 범위를 삭제"
@@ -1565,56 +1622,56 @@
1565
1622
  "params": "autoAlignType: AutoFitType",
1566
1623
  "ret": null,
1567
1624
  "array": false,
1568
- "doc": "텍스트 상자 자동 맞춤 유형을 설정한다."
1625
+ "doc": "텍스트 상자 자동 맞춤 유형을 설정한다. 이미 같은 유형이면 아무것도 하지 않는다."
1569
1626
  },
1570
1627
  {
1571
1628
  "name": "setTextColor",
1572
- "params": "color: string, range?: { from: number; to: number }",
1629
+ "params": "color: string, range?: TextRange",
1573
1630
  "ret": null,
1574
1631
  "array": false,
1575
- "doc": "글자 색상 설정."
1632
+ "doc": "글자 색상을 설정한다."
1576
1633
  },
1577
1634
  {
1578
1635
  "name": "setTextHyperlink",
1579
- "params": "hyperlink: Hyperlink, range?: { from: number; to: number }",
1636
+ "params": "hyperlink: Hyperlink, range?: TextRange",
1580
1637
  "ret": null,
1581
1638
  "array": false,
1582
- "doc": "텍스트에 하이퍼링크를 설정한다. (getTextHyperlink 대칭 — 반환 객체를 그대로 넘겨 링크를 복사할 수 있다) 도형 전체에 링크를 거는 setHyperlink 와 달리 글자(run)에 걸려 하이퍼링크 서식으로 표시된다. other(program/macro/ole 등)와 유효하지 않은 대상(없는 슬라이드 id·ShowJumpType 밖의 값)은 무시한다."
1639
+ "doc": "텍스트에 하이퍼링크를 설정한다. (getTextHyperlink 대칭 — 반환 객체를 그대로 넘겨 링크를 복사할 수 있다) 도형 전체에 링크를 거는 setHyperlink 와 달리 링크가 글자(run) 단위로 걸리며 하이퍼링크 서식으로 표시된다. 지원하지 않는 종류나 유효하지 않은 대상(없는 슬라이드 id 등)은 무시한다."
1583
1640
  },
1584
1641
  {
1585
1642
  "name": "setTransform",
1586
- "params": "transform?: ShapeTransform",
1643
+ "params": "transform?: Partial<ShapeTransform>",
1587
1644
  "ret": null,
1588
1645
  "array": false,
1589
- "doc": "도형의 위치·크기·회전을 한 번에 설정한다. getTransform() 반환값을 그대로 넘길 수 있다. (getTransform 대칭) 제공된 필드만 적용하며, 각 필드는 개별 setter 의 잠금 가드(canResize/canMove/canRotate)를 따른다. 크기→위치→회전 순으로 개별 액션을 발생시키므로 실행 취소는 여러 단계가 될 수 있다."
1646
+ "doc": "도형의 위치·크기·회전을 한 번에 설정한다. getTransform() 반환값을 그대로 넘길 수 있다. (getTransform 대칭) 값을 준 필드만 크기→위치→회전 순으로 적용하고, 생략한 필드는 현재 값을 유지한다. 각 필드는 개별 setter 와 같이 해당 조작(크기/이동/회전)이 불가능한 도형에서 무시된다."
1590
1647
  },
1591
1648
  {
1592
1649
  "name": "setUnderline",
1593
- "params": "underline: Underline, range?: { from: number; to: number }",
1650
+ "params": "underline: Underline, range?: TextRange",
1594
1651
  "ret": null,
1595
1652
  "array": false,
1596
- "doc": "글자 밑줄 설정."
1653
+ "doc": "글자 밑줄을 설정한다."
1597
1654
  },
1598
1655
  {
1599
1656
  "name": "setWidth",
1600
1657
  "params": "width: number",
1601
1658
  "ret": null,
1602
1659
  "array": false,
1603
- "doc": "도형의 너비를 설정한다."
1660
+ "doc": "도형의 너비를 설정한다. 크기 조정이 불가능한 도형이면 무시된다."
1604
1661
  },
1605
1662
  {
1606
1663
  "name": "setX",
1607
1664
  "params": "x: number",
1608
1665
  "ret": null,
1609
1666
  "array": false,
1610
- "doc": "도형의 X 좌표를 절대값으로 설정한다. (상대 이동은 comment.moveBy 등과 구분)"
1667
+ "doc": "도형의 X 좌표를 절대값으로 설정한다. 이동이 불가능한 도형이면 무시된다. (상대 이동은 moveBy)"
1611
1668
  },
1612
1669
  {
1613
1670
  "name": "setY",
1614
1671
  "params": "y: number",
1615
1672
  "ret": null,
1616
1673
  "array": false,
1617
- "doc": "도형의 Y 좌표를 절대값으로 설정한다."
1674
+ "doc": "도형의 Y 좌표를 절대값으로 설정한다. 이동이 불가능한 도형이면 무시된다."
1618
1675
  }
1619
1676
  ],
1620
1677
  "Image": [
@@ -1623,21 +1680,22 @@
1623
1680
  "params": "alignType: AlignType",
1624
1681
  "ret": null,
1625
1682
  "array": false,
1626
- "doc": "도형을 슬라이드 기준으로 정렬한다."
1683
+ "doc": "도형을 슬라이드 기준으로 정렬한다. 이동이 불가능한 도형이면 무시된다. 그룹 자식도 그룹 안이 아니라 슬라이드를 기준으로 움직인다(에디터와 같다). 자식이 그룹 밖으로 나가면 그룹이 자식을 담도록 함께 넓어진다."
1627
1684
  },
1628
1685
  {
1629
- "name": "cropImage",
1630
- "params": "left?: number, top?: number, right?: number, bottom?: number",
1686
+ "name": "flip",
1687
+ "params": "direction: FlipDirection",
1631
1688
  "ret": null,
1632
1689
  "array": false,
1633
- "doc": "이미지를 지정한 방향으로 자른다 (srcRect 업데이트). 모든 인자 단위: 퍼센트 (0~100, UI 단위)."
1690
+ "doc": "도형을 상하 또는 좌우로 반전한다. 현재 반전 상태를 뒤집는 토글이며, 지금 반전돼 있는지는 isFlippedH()/isFlippedV() 로 읽는다. 회전이 불가능한 도형에서는 반전도 무시된다. 회전된 도형은 각도도 거울상으로 함께 바뀐다 (getRotation() 값이 360 - 기존 각도 로 바뀐다)."
1634
1691
  },
1635
1692
  {
1636
- "name": "flip",
1637
- "params": "direction: FlipDirection",
1693
+ "name": "getCrop",
1694
+ "params": "",
1638
1695
  "ret": null,
1639
1696
  "array": false,
1640
- "doc": "도형을 상하 또는 좌우로 반전한다."
1697
+ "text": "ImageCrop | null",
1698
+ "doc": "이미지에 적용된 자르기(crop) 상태를 반환한다. (setCrop 대칭 - 반환 객체를 그대로 넘길 수 있다) 모든 값의 단위는 퍼센트다 (-100~100). 자르지 않은 방향은 0 이고, 음수는 바깥 여백이다."
1641
1699
  },
1642
1700
  {
1643
1701
  "name": "getEffects",
@@ -1645,7 +1703,7 @@
1645
1703
  "ret": null,
1646
1704
  "array": false,
1647
1705
  "text": "Effects | null",
1648
- "doc": "도형에 적용된 효과를 반환한다. 적용된 효과만 키로 포함된다. 각 값은 대응 setter(setOuterShadow/setInnerShadow/setGlow/setSoftEdge/setReflection/set3d) 인자와 대칭. 모델 UI obj 를 경유하므로 길이(pt)·비율(%)은 소수 첫째 자리까지만 정확하다 — 그보다 작은 차이는 왕복에서 반올림된다(렌더에는 나타나지 않는 수준)."
1706
+ "doc": "도형에 적용된 효과를 반환한다. 적용된 효과만 키로 포함된다. 각 값은 대응 setter(setOuterShadow/setInnerShadow/setGlow/setSoftEdge/setReflection/set3d) 의 인자와 같은 형태다. 그림자·네온의 alpha 는 불투명(0)이어도 항상 포함되고, 길이(pt)·비율(%)은 소수 첫째 자리로 반올림된다. outerShadow·innerShadow 가 함께 실린 문서면 둘 다 담는다 (setter 로는 하나만 넣을 수 있다)."
1649
1707
  },
1650
1708
  {
1651
1709
  "name": "getFill",
@@ -1653,7 +1711,7 @@
1653
1711
  "ret": null,
1654
1712
  "array": false,
1655
1713
  "text": "Fill | null",
1656
- "doc": "도형 채우기를 반환한다. (setSolidFill/setGradientFill/setImageFill/removeFill 대칭) type 으로 분기해 그대로 대응 setter 에 넘길 수 있다."
1714
+ "doc": "도형 채우기를 반환한다. (setFill 대칭 - 반환 객체를 그대로 넘길 수 있다) type 별 개별 setter 는 setSolidFill/setGradientFill/setImageFill/setPatternFill/removeFill 이다."
1657
1715
  },
1658
1716
  {
1659
1717
  "name": "getHeight",
@@ -1669,7 +1727,7 @@
1669
1727
  "ret": null,
1670
1728
  "array": false,
1671
1729
  "text": "Hyperlink | null",
1672
- "doc": "도형에 설정된 하이퍼링크를 반환한다. 반환 객체를 그대로 setHyperlink 에 넘길 수 있다. 지원하지 않는 action(program/macro/ole 등)은 공개 타입으로 노출하지 않고 null 을 반환한다."
1730
+ "doc": "도형에 설정된 하이퍼링크를 반환한다. 반환 객체를 그대로 setHyperlink 에 넘길 수 있다. 지원하지 않는 종류(프로그램 실행·매크로 등)가 걸려 있으면 null 이다."
1673
1731
  },
1674
1732
  {
1675
1733
  "name": "getLineCap",
@@ -1709,7 +1767,7 @@
1709
1767
  "ret": null,
1710
1768
  "array": false,
1711
1769
  "text": "LineStyle | null",
1712
- "doc": "선 스타일을 반환한다. (setLineColor/setLineWidth/setLineDash/setLineCap/setLineJoin 대칭)"
1770
+ "doc": "선 스타일을 반환한다. (setLineStyle 대칭 - 반환 객체를 그대로 넘길 수 있다) 개별 setter 는 setLineColor/setLineGradient/setLineWidth/setLineDash/setLineCap/setLineJoin 이다."
1713
1771
  },
1714
1772
  {
1715
1773
  "name": "getLineWidth",
@@ -1719,6 +1777,14 @@
1719
1777
  "text": "number | null",
1720
1778
  "doc": "선 두께(pt)를 반환한다. (setLineWidth 대칭)"
1721
1779
  },
1780
+ {
1781
+ "name": "getPlaceholderType",
1782
+ "params": "",
1783
+ "ret": null,
1784
+ "array": false,
1785
+ "text": "PlaceholderType | null",
1786
+ "doc": "도형의 placeholder 종류를 반환한다."
1787
+ },
1722
1788
  {
1723
1789
  "name": "getPresetId",
1724
1790
  "params": "",
@@ -1733,7 +1799,7 @@
1733
1799
  "ret": null,
1734
1800
  "array": false,
1735
1801
  "text": "number | null",
1736
- "doc": "도형의 회전 각도를 반환한다. (rotate 대칭)"
1802
+ "doc": "도형의 회전 각도를 반환한다. (setRotation 대칭)"
1737
1803
  },
1738
1804
  {
1739
1805
  "name": "getTransform",
@@ -1741,7 +1807,7 @@
1741
1807
  "ret": null,
1742
1808
  "array": false,
1743
1809
  "text": "ShapeTransform | null",
1744
- "doc": "도형의 위치, 크기, 회전 정보를 반환한다."
1810
+ "doc": "도형의 위치, 크기, 회전 정보를 반환한다. x/y 는 반전(flip) 여부와 무관하게 도형의 좌상단이라, 반환값을 다른 도형의 setTransform 에 그대로 넘기면 두 도형이 같은 자리에 놓인다. 값은 에디터 입력 단위로 반올림해 반환한다 - 크기는 소수 한 자리, 위치는 정수. setter 도 같은 단위로 넣으므로, 임포트 문서처럼 더 잘게 놓인 도형은 되넘길 때 그만큼 움직인다."
1745
1811
  },
1746
1812
  {
1747
1813
  "name": "getWidth",
@@ -1767,6 +1833,22 @@
1767
1833
  "text": "number | null",
1768
1834
  "doc": "도형의 Y 좌표를 반환한다. (setY 대칭)"
1769
1835
  },
1836
+ {
1837
+ "name": "getZOrderIndex",
1838
+ "params": "",
1839
+ "ret": null,
1840
+ "array": false,
1841
+ "text": "number | null",
1842
+ "doc": "부모(슬라이드, 그룹 자식이면 그 그룹) 안에서 도형의 z-order 순번을 반환한다. 0 이 맨 뒤이며, 클수록 앞이다."
1843
+ },
1844
+ {
1845
+ "name": "hasText",
1846
+ "params": "",
1847
+ "ret": null,
1848
+ "array": false,
1849
+ "text": "boolean | null",
1850
+ "doc": "도형이 텍스트를 담고 있는지 반환한다. 에디터가 텍스트를 비었다고 보는 기준과 같다 — 공백만 있거나 빈 문단이 둘 이상(개행만 넣은 상태)이면 true, 빈 문단 하나뿐이면 false 다. 도형 레벨 텍스트가 없는 종류(표·그룹·차트)는 항상 false 다. (표는 셀 단위로 조회)"
1851
+ },
1770
1852
  {
1771
1853
  "name": "isChart",
1772
1854
  "params": "",
@@ -1791,6 +1873,22 @@
1791
1873
  "text": "this is Diagram",
1792
1874
  "doc": "이 핸들이 `Diagram` 인지 판별한다 (union 좁히기용 type guard). SDK 핸들의 내부 판별값을 동기 검사한다 — postMessage 왕복 없음, await 불필요."
1793
1875
  },
1876
+ {
1877
+ "name": "isFlippedH",
1878
+ "params": "",
1879
+ "ret": null,
1880
+ "array": false,
1881
+ "text": "boolean | null",
1882
+ "doc": "도형이 좌우로 반전된 상태인지 반환한다. (flip(FlipDirection.HORIZONTAL) 을 호출하면 이 값이 뒤집힌다)"
1883
+ },
1884
+ {
1885
+ "name": "isFlippedV",
1886
+ "params": "",
1887
+ "ret": null,
1888
+ "array": false,
1889
+ "text": "boolean | null",
1890
+ "doc": "도형이 상하로 반전된 상태인지 반환한다. (flip(FlipDirection.VERTICAL) 을 호출하면 이 값이 뒤집힌다)"
1891
+ },
1794
1892
  {
1795
1893
  "name": "isGroup",
1796
1894
  "params": "",
@@ -1828,7 +1926,7 @@
1828
1926
  "params": "",
1829
1927
  "ret": null,
1830
1928
  "array": false,
1831
- "text": "boolean",
1929
+ "text": "boolean | null",
1832
1930
  "doc": "도형이 placeholder(제목 · 본문 틀 등)인지 반환한다."
1833
1931
  },
1834
1932
  {
@@ -1866,7 +1964,7 @@
1866
1964
  "params": "effectType: EffectType",
1867
1965
  "ret": null,
1868
1966
  "array": false,
1869
- "doc": "효과를 제거한다."
1967
+ "doc": "효과를 제거한다. 그 효과가 걸려 있지 않으면 아무 일도 하지 않는다. 도형이 직접 가진 효과만 제거한다 - 도형 스타일(effectRef)에서 상속받은 효과는 제거할 수 없어, getEffects() 가 돌려주는데도 아무 일도 하지 않는 경우가 있다."
1870
1968
  },
1871
1969
  {
1872
1970
  "name": "removeFill",
@@ -1894,56 +1992,49 @@
1894
1992
  "params": "order: ShapeZOrder",
1895
1993
  "ret": null,
1896
1994
  "array": false,
1897
- "doc": "도형의 정렬 순서(앞으로/뒤로)를 변경한다."
1995
+ "doc": "도형의 정렬 순서(앞으로/뒤로)를 변경한다. 이미 목표 위치라 바뀔 것이 없으면 무시된다."
1898
1996
  },
1899
1997
  {
1900
- "name": "resetImageSize",
1998
+ "name": "resetSize",
1901
1999
  "params": "",
1902
2000
  "ret": null,
1903
2001
  "array": false,
1904
- "doc": "이미지를 원본 크기로 되돌린다. blip 의 width/height (pixel) 를 EMU 로 변환하여 xfrm 을 갱신하고, srcRect (crop) 가 있으면 함께 제거한다."
1905
- },
1906
- {
1907
- "name": "rotate",
1908
- "params": "rotation: number",
1909
- "ret": null,
1910
- "array": false,
1911
- "doc": "도형을 회전한다."
2002
+ "doc": "이미지를 문서에 실린 원본 크기로 되돌린다. 자르기(crop)가 있으면 함께 제거한다."
1912
2003
  },
1913
2004
  {
1914
2005
  "name": "set3d",
1915
2006
  "params": "scene3d?: Scene3d, sp3d?: Sp3d",
1916
2007
  "ret": null,
1917
2008
  "array": false,
1918
- "doc": "도형에 3D 효과를 적용한다. scene3d 또는 sp3d 중 비어있는 인자는 적용하지 않는다."
2009
+ "doc": "도형에 3D 효과를 적용한다. scene3d 와 sp3d 중 비어 있는 인자는 적용하지 않는다."
1919
2010
  },
1920
2011
  {
1921
- "name": "setEffect",
1922
- "params": "effect: Effect",
2012
+ "name": "setCrop",
2013
+ "params": "crop: Partial<ImageCrop>",
1923
2014
  "ret": null,
1924
2015
  "array": false,
1925
- "doc": "도형에 효과(그림자/광선/반사 등)를 직접 obj로 적용한다. 단순 케이스는 setOuterShadow/setInnerShadow/setGlow/setSoftEdge/setReflection 사용 권장."
2016
+ "doc": "이미지를 지정한 방향으로 자른다. (getCrop 대칭 - 반환 객체를 그대로 넘길 수 있다) 지정한 방향만 적용하고 생략한 방향은 기존 값을 유지한다. 자르기를 없애려면 0 을 명시한다. 모든 값의 단위는 퍼센트다 (-100~100). 양수는 그 방향을 잘라 내고, 음수는 바깥 여백을 만든다. 병합 결과가 지금 값과 같으면 아무것도 하지 않는다."
1926
2017
  },
1927
2018
  {
1928
2019
  "name": "setEffects",
1929
- "params": "effects: Effects",
2020
+ "params": "effects?: Effects",
1930
2021
  "ret": null,
1931
2022
  "array": false,
1932
- "doc": "getEffects() 가 반환한 효과 객체를 그대로 적용한다. (getEffects 대칭 — 도형→도형 효과 복사) 포함된 효과 키만 대응 setter 로 적용한다. scene3d/sp3d 는 set3d 로 함께 넘긴다."
2023
+ "doc": "getEffects() 가 반환한 효과 객체를 그대로 적용한다. (getEffects 대칭 — 도형→도형 효과 복사) 포함된 효과 키만 대응 setter 로 적용한다. scene3d/sp3d 는 set3d 로 함께 넘긴다. 대상의 기존 효과를 지우지는 않는다 - 완전 복사하려면 removeEffect/remove3d 로 먼저 제거한 뒤 적용한다. outerShadow 와 innerShadow 를 함께 넘기면 거부하지 않고 순서대로 적용해 나중 것만 남는다."
1933
2024
  },
1934
2025
  {
1935
2026
  "name": "setFill",
1936
- "params": "fill: Fill",
2027
+ "params": "fill?: Fill",
1937
2028
  "ret": null,
1938
2029
  "array": false,
1939
- "doc": "getFill() 이 반환한 채우기 객체를 그대로 적용한다. (getFill 대칭 — 도형→도형 채우기 복사) type 으로 분기해 대응 setter 를 호출한다. image 는 readback 의 embed 를 재사용해 같은 문서 안에서 복원한다. embed 가 없는 image 입력은 무시된다(새 이미지는 개별 setImageFill 사용)."
2030
+ "doc": "getFill() 이 반환한 채우기 객체를 그대로 적용한다. (getFill 대칭 — 도형→도형 채우기 복사) image 는 조회 결과의 embed 를 재사용하므로 같은 문서 안에서만 복원된다. embed 없는 image 는 적용할 그림이 없어 거부한다 (새 이미지는 setImageFill)."
1940
2031
  },
1941
2032
  {
1942
2033
  "name": "setGlow",
1943
- "params": "glow?: { color?: string; alpha?: number; rad?: number }",
2034
+ "params": "glow?: Glow",
1944
2035
  "ret": null,
1945
2036
  "array": false,
1946
- "doc": "네온(광선) 효과를 적용한다."
2037
+ "doc": "네온(광선) 효과를 적용한다. (getEffects().glow 대칭 - 반환 객체를 그대로 넘길 수 있다) 생략한 필드는 기본값으로 채운다 (필드별 기본값은 Glow 참조)."
1947
2038
  },
1948
2039
  {
1949
2040
  "name": "setGradientFill",
@@ -1957,14 +2048,14 @@
1957
2048
  "params": "height: number",
1958
2049
  "ret": null,
1959
2050
  "array": false,
1960
- "doc": "도형의 높이를 설정한다."
2051
+ "doc": "도형의 높이를 설정한다. 크기 조정이 불가능한 도형이면 무시된다."
1961
2052
  },
1962
2053
  {
1963
2054
  "name": "setHyperlink",
1964
2055
  "params": "hyperlink: Hyperlink",
1965
2056
  "ret": null,
1966
2057
  "array": false,
1967
- "doc": "도형에 하이퍼링크를 설정한다. (getHyperlink 대칭 — 반환 객체를 그대로 넘겨 하이퍼링크를 복사할 수 있다) other(program/macro/ole 등)와 유효하지 않은 대상(없는 슬라이드 id·ShowJumpType 밖의 값)은 무시한다."
2058
+ "doc": "도형에 하이퍼링크를 설정한다. (getHyperlink 대칭 — 반환 객체를 그대로 넘겨 하이퍼링크를 복사할 수 있다) 지원하지 않는 종류나 유효하지 않은 대상(없는 슬라이드 id 등)은 무시한다."
1968
2059
  },
1969
2060
  {
1970
2061
  "name": "setImageFill",
@@ -1975,10 +2066,10 @@
1975
2066
  },
1976
2067
  {
1977
2068
  "name": "setInnerShadow",
1978
- "params": "shadow?: { color?: string; alpha?: number; blur?: number; dist?: number; dir?: number }",
2069
+ "params": "shadow?: InnerShadow",
1979
2070
  "ret": null,
1980
2071
  "array": false,
1981
- "doc": "내부 그림자를 적용한다."
2072
+ "doc": "내부 그림자를 적용한다. (getEffects().innerShadow 대칭 - 반환 객체를 그대로 넘길 수 있다) 생략한 필드는 기본값으로 채운다 (필드별 기본값은 InnerShadow 참조). 도형이 갖는 그림자는 하나다 - 외부 그림자가 걸려 있으면 내부 그림자로 바뀐다."
1982
2073
  },
1983
2074
  {
1984
2075
  "name": "setLineCap",
@@ -2017,7 +2108,7 @@
2017
2108
  },
2018
2109
  {
2019
2110
  "name": "setLineStyle",
2020
- "params": "style: LineStyle",
2111
+ "params": "style?: LineStyle",
2021
2112
  "ret": null,
2022
2113
  "array": false,
2023
2114
  "doc": "getLineStyle() 이 반환한 선 스타일 객체를 그대로 적용한다. (getLineStyle 대칭 — 도형→도형 선 복사)"
@@ -2031,31 +2122,38 @@
2031
2122
  },
2032
2123
  {
2033
2124
  "name": "setOuterShadow",
2034
- "params": "shadow?: { color?: string; alpha?: number; blur?: number; dist?: number; dir?: number; sx?: number; sy?: number; kx?: number; ky?: number; algn?: RectAlign; rotWithShape?: boolean }",
2125
+ "params": "shadow?: OuterShadow",
2035
2126
  "ret": null,
2036
2127
  "array": false,
2037
- "doc": "외부 그림자를 적용한다."
2128
+ "doc": "외부 그림자를 적용한다. (getEffects().outerShadow 대칭 - 반환 객체를 그대로 넘길 수 있다) 생략한 필드는 기본값으로 채운다 (필드별 기본값은 OuterShadow 참조). 도형이 갖는 그림자는 하나다 - 내부 그림자가 걸려 있으면 외부 그림자로 바뀐다."
2038
2129
  },
2039
2130
  {
2040
2131
  "name": "setPatternFill",
2041
2132
  "params": "preset: PatternPreset, foreColor?: string, backColor?: string, foreAlpha?: number, backAlpha?: number",
2042
2133
  "ret": null,
2043
2134
  "array": false,
2044
- "doc": "패턴(무늬) 채우기를 설정한다. (getFill 왕복 대칭 — setFill 의 pattern 경로)"
2135
+ "doc": "패턴(무늬) 채우기를 설정한다. (getFill 왕복 대칭)"
2045
2136
  },
2046
2137
  {
2047
2138
  "name": "setReflection",
2048
- "params": "reflection?: { blur?: number; dist?: number; stPos?: number; endPos?: number; startAlpha?: number; endAlpha?: number; dir?: number; fadeDir?: number; sx?: number; sy?: number; kx?: number; ky?: number; algn?: RectAlign; rotWithShape?: boolean }",
2139
+ "params": "reflection?: Reflection",
2049
2140
  "ret": null,
2050
2141
  "array": false,
2051
- "doc": "반사 효과를 적용한다."
2142
+ "doc": "반사 효과를 적용한다. (getEffects().reflection 대칭 - 반환 객체를 그대로 넘길 수 있다) 생략한 필드는 기본값으로 채운다 (필드별 기본값은 Reflection 참조)."
2143
+ },
2144
+ {
2145
+ "name": "setRotation",
2146
+ "params": "rotation: number",
2147
+ "ret": null,
2148
+ "array": false,
2149
+ "doc": "도형의 회전 각도를 절대값으로 설정한다. 회전이 불가능한 도형이면 무시된다. (getRotation 대칭)"
2052
2150
  },
2053
2151
  {
2054
2152
  "name": "setSoftEdge",
2055
- "params": "softEdge?: { rad?: number }",
2153
+ "params": "softEdge?: SoftEdge",
2056
2154
  "ret": null,
2057
2155
  "array": false,
2058
- "doc": "옅은 테두리(softEdge) 효과를 적용한다."
2156
+ "doc": "옅은 테두리(softEdge) 효과를 적용한다. (getEffects().softEdge 대칭 - 반환 객체를 그대로 넘길 수 있다) 생략한 필드는 기본값으로 채운다 (필드별 기본값은 SoftEdge 참조)."
2059
2157
  },
2060
2158
  {
2061
2159
  "name": "setSolidFill",
@@ -2066,31 +2164,31 @@
2066
2164
  },
2067
2165
  {
2068
2166
  "name": "setTransform",
2069
- "params": "transform?: ShapeTransform",
2167
+ "params": "transform?: Partial<ShapeTransform>",
2070
2168
  "ret": null,
2071
2169
  "array": false,
2072
- "doc": "도형의 위치·크기·회전을 한 번에 설정한다. getTransform() 반환값을 그대로 넘길 수 있다. (getTransform 대칭) 제공된 필드만 적용하며, 각 필드는 개별 setter 의 잠금 가드(canResize/canMove/canRotate)를 따른다. 크기→위치→회전 순으로 개별 액션을 발생시키므로 실행 취소는 여러 단계가 될 수 있다."
2170
+ "doc": "도형의 위치·크기·회전을 한 번에 설정한다. getTransform() 반환값을 그대로 넘길 수 있다. (getTransform 대칭) 값을 준 필드만 크기→위치→회전 순으로 적용하고, 생략한 필드는 현재 값을 유지한다. 각 필드는 개별 setter 와 같이 해당 조작(크기/이동/회전)이 불가능한 도형에서 무시된다."
2073
2171
  },
2074
2172
  {
2075
2173
  "name": "setWidth",
2076
2174
  "params": "width: number",
2077
2175
  "ret": null,
2078
2176
  "array": false,
2079
- "doc": "도형의 너비를 설정한다."
2177
+ "doc": "도형의 너비를 설정한다. 크기 조정이 불가능한 도형이면 무시된다."
2080
2178
  },
2081
2179
  {
2082
2180
  "name": "setX",
2083
2181
  "params": "x: number",
2084
2182
  "ret": null,
2085
2183
  "array": false,
2086
- "doc": "도형의 X 좌표를 절대값으로 설정한다. (상대 이동은 comment.moveBy 등과 구분)"
2184
+ "doc": "도형의 X 좌표를 절대값으로 설정한다. 이동이 불가능한 도형이면 무시된다. (상대 이동은 moveBy)"
2087
2185
  },
2088
2186
  {
2089
2187
  "name": "setY",
2090
2188
  "params": "y: number",
2091
2189
  "ret": null,
2092
2190
  "array": false,
2093
- "doc": "도형의 Y 좌표를 절대값으로 설정한다."
2191
+ "doc": "도형의 Y 좌표를 절대값으로 설정한다. 이동이 불가능한 도형이면 무시된다."
2094
2192
  }
2095
2193
  ],
2096
2194
  "Line": [
@@ -2099,14 +2197,14 @@
2099
2197
  "params": "alignType: AlignType",
2100
2198
  "ret": null,
2101
2199
  "array": false,
2102
- "doc": "도형을 슬라이드 기준으로 정렬한다."
2200
+ "doc": "도형을 슬라이드 기준으로 정렬한다. 이동이 불가능한 도형이면 무시된다. 그룹 자식도 그룹 안이 아니라 슬라이드를 기준으로 움직인다(에디터와 같다). 자식이 그룹 밖으로 나가면 그룹이 자식을 담도록 함께 넓어진다."
2103
2201
  },
2104
2202
  {
2105
2203
  "name": "flip",
2106
2204
  "params": "direction: FlipDirection",
2107
2205
  "ret": null,
2108
2206
  "array": false,
2109
- "doc": "도형을 상하 또는 좌우로 반전한다."
2207
+ "doc": "도형을 상하 또는 좌우로 반전한다. 현재 반전 상태를 뒤집는 토글이며, 지금 반전돼 있는지는 isFlippedH()/isFlippedV() 로 읽는다. 회전이 불가능한 도형에서는 반전도 무시된다. 회전된 도형은 각도도 거울상으로 함께 바뀐다 (getRotation() 값이 360 - 기존 각도 로 바뀐다)."
2110
2208
  },
2111
2209
  {
2112
2210
  "name": "getEffects",
@@ -2114,7 +2212,7 @@
2114
2212
  "ret": null,
2115
2213
  "array": false,
2116
2214
  "text": "Effects | null",
2117
- "doc": "도형에 적용된 효과를 반환한다. 적용된 효과만 키로 포함된다. 각 값은 대응 setter(setOuterShadow/setInnerShadow/setGlow/setSoftEdge/setReflection/set3d) 인자와 대칭. 모델 UI obj 를 경유하므로 길이(pt)·비율(%)은 소수 첫째 자리까지만 정확하다 — 그보다 작은 차이는 왕복에서 반올림된다(렌더에는 나타나지 않는 수준)."
2215
+ "doc": "도형에 적용된 효과를 반환한다. 적용된 효과만 키로 포함된다. 각 값은 대응 setter(setOuterShadow/setInnerShadow/setGlow/setSoftEdge/setReflection/set3d) 의 인자와 같은 형태다. 그림자·네온의 alpha 는 불투명(0)이어도 항상 포함되고, 길이(pt)·비율(%)은 소수 첫째 자리로 반올림된다. outerShadow·innerShadow 가 함께 실린 문서면 둘 다 담는다 (setter 로는 하나만 넣을 수 있다)."
2118
2216
  },
2119
2217
  {
2120
2218
  "name": "getFill",
@@ -2122,7 +2220,15 @@
2122
2220
  "ret": null,
2123
2221
  "array": false,
2124
2222
  "text": "Fill | null",
2125
- "doc": "도형 채우기를 반환한다. (setSolidFill/setGradientFill/setImageFill/removeFill 대칭) type 으로 분기해 그대로 대응 setter 에 넘길 수 있다."
2223
+ "doc": "도형 채우기를 반환한다. (setFill 대칭 - 반환 객체를 그대로 넘길 수 있다) type 별 개별 setter 는 setSolidFill/setGradientFill/setImageFill/setPatternFill/removeFill 이다."
2224
+ },
2225
+ {
2226
+ "name": "getHeadEnd",
2227
+ "params": "",
2228
+ "ret": null,
2229
+ "array": false,
2230
+ "text": "LineEnd | null",
2231
+ "doc": "연결선의 시작 화살표(headEnd)를 반환한다. (setHeadEnd 대칭 - 반환 객체를 그대로 넘길 수 있다)"
2126
2232
  },
2127
2233
  {
2128
2234
  "name": "getHeight",
@@ -2138,7 +2244,7 @@
2138
2244
  "ret": null,
2139
2245
  "array": false,
2140
2246
  "text": "Hyperlink | null",
2141
- "doc": "도형에 설정된 하이퍼링크를 반환한다. 반환 객체를 그대로 setHyperlink 에 넘길 수 있다. 지원하지 않는 action(program/macro/ole 등)은 공개 타입으로 노출하지 않고 null 을 반환한다."
2247
+ "doc": "도형에 설정된 하이퍼링크를 반환한다. 반환 객체를 그대로 setHyperlink 에 넘길 수 있다. 지원하지 않는 종류(프로그램 실행·매크로 등)가 걸려 있으면 null 이다."
2142
2248
  },
2143
2249
  {
2144
2250
  "name": "getLineCap",
@@ -2178,7 +2284,7 @@
2178
2284
  "ret": null,
2179
2285
  "array": false,
2180
2286
  "text": "LineStyle | null",
2181
- "doc": "선 스타일을 반환한다. (setLineColor/setLineWidth/setLineDash/setLineCap/setLineJoin 대칭)"
2287
+ "doc": "선 스타일을 반환한다. (setLineStyle 대칭 - 반환 객체를 그대로 넘길 수 있다) 개별 setter 는 setLineColor/setLineGradient/setLineWidth/setLineDash/setLineCap/setLineJoin 이다."
2182
2288
  },
2183
2289
  {
2184
2290
  "name": "getLineWidth",
@@ -2188,6 +2294,14 @@
2188
2294
  "text": "number | null",
2189
2295
  "doc": "선 두께(pt)를 반환한다. (setLineWidth 대칭)"
2190
2296
  },
2297
+ {
2298
+ "name": "getPlaceholderType",
2299
+ "params": "",
2300
+ "ret": null,
2301
+ "array": false,
2302
+ "text": "PlaceholderType | null",
2303
+ "doc": "도형의 placeholder 종류를 반환한다."
2304
+ },
2191
2305
  {
2192
2306
  "name": "getPresetId",
2193
2307
  "params": "",
@@ -2202,7 +2316,15 @@
2202
2316
  "ret": null,
2203
2317
  "array": false,
2204
2318
  "text": "number | null",
2205
- "doc": "도형의 회전 각도를 반환한다. (rotate 대칭)"
2319
+ "doc": "도형의 회전 각도를 반환한다. (setRotation 대칭)"
2320
+ },
2321
+ {
2322
+ "name": "getTailEnd",
2323
+ "params": "",
2324
+ "ret": null,
2325
+ "array": false,
2326
+ "text": "LineEnd | null",
2327
+ "doc": "연결선의 끝 화살표(tailEnd)를 반환한다. (setTailEnd 대칭 - 반환 객체를 그대로 넘길 수 있다)"
2206
2328
  },
2207
2329
  {
2208
2330
  "name": "getTransform",
@@ -2210,7 +2332,7 @@
2210
2332
  "ret": null,
2211
2333
  "array": false,
2212
2334
  "text": "ShapeTransform | null",
2213
- "doc": "도형의 위치, 크기, 회전 정보를 반환한다."
2335
+ "doc": "도형의 위치, 크기, 회전 정보를 반환한다. x/y 는 반전(flip) 여부와 무관하게 도형의 좌상단이라, 반환값을 다른 도형의 setTransform 에 그대로 넘기면 두 도형이 같은 자리에 놓인다. 값은 에디터 입력 단위로 반올림해 반환한다 - 크기는 소수 한 자리, 위치는 정수. setter 도 같은 단위로 넣으므로, 임포트 문서처럼 더 잘게 놓인 도형은 되넘길 때 그만큼 움직인다."
2214
2336
  },
2215
2337
  {
2216
2338
  "name": "getWidth",
@@ -2236,6 +2358,22 @@
2236
2358
  "text": "number | null",
2237
2359
  "doc": "도형의 Y 좌표를 반환한다. (setY 대칭)"
2238
2360
  },
2361
+ {
2362
+ "name": "getZOrderIndex",
2363
+ "params": "",
2364
+ "ret": null,
2365
+ "array": false,
2366
+ "text": "number | null",
2367
+ "doc": "부모(슬라이드, 그룹 자식이면 그 그룹) 안에서 도형의 z-order 순번을 반환한다. 0 이 맨 뒤이며, 클수록 앞이다."
2368
+ },
2369
+ {
2370
+ "name": "hasText",
2371
+ "params": "",
2372
+ "ret": null,
2373
+ "array": false,
2374
+ "text": "boolean | null",
2375
+ "doc": "도형이 텍스트를 담고 있는지 반환한다. 에디터가 텍스트를 비었다고 보는 기준과 같다 — 공백만 있거나 빈 문단이 둘 이상(개행만 넣은 상태)이면 true, 빈 문단 하나뿐이면 false 다. 도형 레벨 텍스트가 없는 종류(표·그룹·차트)는 항상 false 다. (표는 셀 단위로 조회)"
2376
+ },
2239
2377
  {
2240
2378
  "name": "isChart",
2241
2379
  "params": "",
@@ -2260,6 +2398,22 @@
2260
2398
  "text": "this is Diagram",
2261
2399
  "doc": "이 핸들이 `Diagram` 인지 판별한다 (union 좁히기용 type guard). SDK 핸들의 내부 판별값을 동기 검사한다 — postMessage 왕복 없음, await 불필요."
2262
2400
  },
2401
+ {
2402
+ "name": "isFlippedH",
2403
+ "params": "",
2404
+ "ret": null,
2405
+ "array": false,
2406
+ "text": "boolean | null",
2407
+ "doc": "도형이 좌우로 반전된 상태인지 반환한다. (flip(FlipDirection.HORIZONTAL) 을 호출하면 이 값이 뒤집힌다)"
2408
+ },
2409
+ {
2410
+ "name": "isFlippedV",
2411
+ "params": "",
2412
+ "ret": null,
2413
+ "array": false,
2414
+ "text": "boolean | null",
2415
+ "doc": "도형이 상하로 반전된 상태인지 반환한다. (flip(FlipDirection.VERTICAL) 을 호출하면 이 값이 뒤집힌다)"
2416
+ },
2263
2417
  {
2264
2418
  "name": "isGroup",
2265
2419
  "params": "",
@@ -2297,7 +2451,7 @@
2297
2451
  "params": "",
2298
2452
  "ret": null,
2299
2453
  "array": false,
2300
- "text": "boolean",
2454
+ "text": "boolean | null",
2301
2455
  "doc": "도형이 placeholder(제목 · 본문 틀 등)인지 반환한다."
2302
2456
  },
2303
2457
  {
@@ -2335,7 +2489,7 @@
2335
2489
  "params": "effectType: EffectType",
2336
2490
  "ret": null,
2337
2491
  "array": false,
2338
- "doc": "효과를 제거한다."
2492
+ "doc": "효과를 제거한다. 그 효과가 걸려 있지 않으면 아무 일도 하지 않는다. 도형이 직접 가진 효과만 제거한다 - 도형 스타일(effectRef)에서 상속받은 효과는 제거할 수 없어, getEffects() 가 돌려주는데도 아무 일도 하지 않는 경우가 있다."
2339
2493
  },
2340
2494
  {
2341
2495
  "name": "removeFill",
@@ -2363,49 +2517,35 @@
2363
2517
  "params": "order: ShapeZOrder",
2364
2518
  "ret": null,
2365
2519
  "array": false,
2366
- "doc": "도형의 정렬 순서(앞으로/뒤로)를 변경한다."
2367
- },
2368
- {
2369
- "name": "rotate",
2370
- "params": "rotation: number",
2371
- "ret": null,
2372
- "array": false,
2373
- "doc": "도형을 회전한다."
2520
+ "doc": "도형의 정렬 순서(앞으로/뒤로)를 변경한다. 이미 목표 위치라 바뀔 것이 없으면 무시된다."
2374
2521
  },
2375
2522
  {
2376
2523
  "name": "set3d",
2377
2524
  "params": "scene3d?: Scene3d, sp3d?: Sp3d",
2378
2525
  "ret": null,
2379
2526
  "array": false,
2380
- "doc": "도형에 3D 효과를 적용한다. scene3d 또는 sp3d 중 비어있는 인자는 적용하지 않는다."
2381
- },
2382
- {
2383
- "name": "setEffect",
2384
- "params": "effect: Effect",
2385
- "ret": null,
2386
- "array": false,
2387
- "doc": "도형에 효과(그림자/광선/반사 등)를 직접 obj로 적용한다. 단순 케이스는 setOuterShadow/setInnerShadow/setGlow/setSoftEdge/setReflection 사용 권장."
2527
+ "doc": "도형에 3D 효과를 적용한다. scene3d 와 sp3d 중 비어 있는 인자는 적용하지 않는다."
2388
2528
  },
2389
2529
  {
2390
2530
  "name": "setEffects",
2391
- "params": "effects: Effects",
2531
+ "params": "effects?: Effects",
2392
2532
  "ret": null,
2393
2533
  "array": false,
2394
- "doc": "getEffects() 가 반환한 효과 객체를 그대로 적용한다. (getEffects 대칭 — 도형→도형 효과 복사) 포함된 효과 키만 대응 setter 로 적용한다. scene3d/sp3d 는 set3d 로 함께 넘긴다."
2534
+ "doc": "getEffects() 가 반환한 효과 객체를 그대로 적용한다. (getEffects 대칭 — 도형→도형 효과 복사) 포함된 효과 키만 대응 setter 로 적용한다. scene3d/sp3d 는 set3d 로 함께 넘긴다. 대상의 기존 효과를 지우지는 않는다 - 완전 복사하려면 removeEffect/remove3d 로 먼저 제거한 뒤 적용한다. outerShadow 와 innerShadow 를 함께 넘기면 거부하지 않고 순서대로 적용해 나중 것만 남는다."
2395
2535
  },
2396
2536
  {
2397
2537
  "name": "setFill",
2398
- "params": "fill: Fill",
2538
+ "params": "fill?: Fill",
2399
2539
  "ret": null,
2400
2540
  "array": false,
2401
- "doc": "getFill() 이 반환한 채우기 객체를 그대로 적용한다. (getFill 대칭 — 도형→도형 채우기 복사) type 으로 분기해 대응 setter 를 호출한다. image 는 readback 의 embed 를 재사용해 같은 문서 안에서 복원한다. embed 가 없는 image 입력은 무시된다(새 이미지는 개별 setImageFill 사용)."
2541
+ "doc": "getFill() 이 반환한 채우기 객체를 그대로 적용한다. (getFill 대칭 — 도형→도형 채우기 복사) image 는 조회 결과의 embed 를 재사용하므로 같은 문서 안에서만 복원된다. embed 없는 image 는 적용할 그림이 없어 거부한다 (새 이미지는 setImageFill)."
2402
2542
  },
2403
2543
  {
2404
2544
  "name": "setGlow",
2405
- "params": "glow?: { color?: string; alpha?: number; rad?: number }",
2545
+ "params": "glow?: Glow",
2406
2546
  "ret": null,
2407
2547
  "array": false,
2408
- "doc": "네온(광선) 효과를 적용한다."
2548
+ "doc": "네온(광선) 효과를 적용한다. (getEffects().glow 대칭 - 반환 객체를 그대로 넘길 수 있다) 생략한 필드는 기본값으로 채운다 (필드별 기본값은 Glow 참조)."
2409
2549
  },
2410
2550
  {
2411
2551
  "name": "setGradientFill",
@@ -2414,19 +2554,26 @@
2414
2554
  "array": false,
2415
2555
  "doc": "그라데이션 채우기를 설정한다."
2416
2556
  },
2557
+ {
2558
+ "name": "setHeadEnd",
2559
+ "params": "lineEnd: Partial<LineEnd> & {type: LineEndType}",
2560
+ "ret": null,
2561
+ "array": false,
2562
+ "doc": "연결선의 시작 화살표(headEnd)를 설정한다. (getHeadEnd 대칭 - 반환 객체를 그대로 넘길 수 있다) 화살표를 없애려면 type 에 LineEndType.NONE 을 준다. width/length 를 생략하면 기존 크기가 아니라 기본값(MEDIUM)이 적용된다."
2563
+ },
2417
2564
  {
2418
2565
  "name": "setHeight",
2419
2566
  "params": "height: number",
2420
2567
  "ret": null,
2421
2568
  "array": false,
2422
- "doc": "도형의 높이를 설정한다."
2569
+ "doc": "도형의 높이를 설정한다. 크기 조정이 불가능한 도형이면 무시된다."
2423
2570
  },
2424
2571
  {
2425
2572
  "name": "setHyperlink",
2426
2573
  "params": "hyperlink: Hyperlink",
2427
2574
  "ret": null,
2428
2575
  "array": false,
2429
- "doc": "도형에 하이퍼링크를 설정한다. (getHyperlink 대칭 — 반환 객체를 그대로 넘겨 하이퍼링크를 복사할 수 있다) other(program/macro/ole 등)와 유효하지 않은 대상(없는 슬라이드 id·ShowJumpType 밖의 값)은 무시한다."
2576
+ "doc": "도형에 하이퍼링크를 설정한다. (getHyperlink 대칭 — 반환 객체를 그대로 넘겨 하이퍼링크를 복사할 수 있다) 지원하지 않는 종류나 유효하지 않은 대상(없는 슬라이드 id 등)은 무시한다."
2430
2577
  },
2431
2578
  {
2432
2579
  "name": "setImageFill",
@@ -2437,10 +2584,10 @@
2437
2584
  },
2438
2585
  {
2439
2586
  "name": "setInnerShadow",
2440
- "params": "shadow?: { color?: string; alpha?: number; blur?: number; dist?: number; dir?: number }",
2587
+ "params": "shadow?: InnerShadow",
2441
2588
  "ret": null,
2442
2589
  "array": false,
2443
- "doc": "내부 그림자를 적용한다."
2590
+ "doc": "내부 그림자를 적용한다. (getEffects().innerShadow 대칭 - 반환 객체를 그대로 넘길 수 있다) 생략한 필드는 기본값으로 채운다 (필드별 기본값은 InnerShadow 참조). 도형이 갖는 그림자는 하나다 - 외부 그림자가 걸려 있으면 내부 그림자로 바뀐다."
2444
2591
  },
2445
2592
  {
2446
2593
  "name": "setLineCap",
@@ -2470,13 +2617,6 @@
2470
2617
  "array": false,
2471
2618
  "doc": "선(테두리) 그라데이션 채우기를 설정한다."
2472
2619
  },
2473
- {
2474
- "name": "setLineHeadEnd",
2475
- "params": "type: LineEndType, width?: LineEndSize, length?: LineEndSize",
2476
- "ret": null,
2477
- "array": false,
2478
- "doc": "연결선의 시작 화살표(headEnd)를 설정한다."
2479
- },
2480
2620
  {
2481
2621
  "name": "setLineJoin",
2482
2622
  "params": "lineJoin: LineJoin",
@@ -2486,18 +2626,11 @@
2486
2626
  },
2487
2627
  {
2488
2628
  "name": "setLineStyle",
2489
- "params": "style: LineStyle",
2629
+ "params": "style?: LineStyle",
2490
2630
  "ret": null,
2491
2631
  "array": false,
2492
2632
  "doc": "getLineStyle() 이 반환한 선 스타일 객체를 그대로 적용한다. (getLineStyle 대칭 — 도형→도형 선 복사)"
2493
2633
  },
2494
- {
2495
- "name": "setLineTailEnd",
2496
- "params": "type: LineEndType, width?: LineEndSize, length?: LineEndSize",
2497
- "ret": null,
2498
- "array": false,
2499
- "doc": "연결선의 끝 화살표(tailEnd)를 설정한다."
2500
- },
2501
2634
  {
2502
2635
  "name": "setLineWidth",
2503
2636
  "params": "lineWidth: number",
@@ -2507,31 +2640,38 @@
2507
2640
  },
2508
2641
  {
2509
2642
  "name": "setOuterShadow",
2510
- "params": "shadow?: { color?: string; alpha?: number; blur?: number; dist?: number; dir?: number; sx?: number; sy?: number; kx?: number; ky?: number; algn?: RectAlign; rotWithShape?: boolean }",
2643
+ "params": "shadow?: OuterShadow",
2511
2644
  "ret": null,
2512
2645
  "array": false,
2513
- "doc": "외부 그림자를 적용한다."
2646
+ "doc": "외부 그림자를 적용한다. (getEffects().outerShadow 대칭 - 반환 객체를 그대로 넘길 수 있다) 생략한 필드는 기본값으로 채운다 (필드별 기본값은 OuterShadow 참조). 도형이 갖는 그림자는 하나다 - 내부 그림자가 걸려 있으면 외부 그림자로 바뀐다."
2514
2647
  },
2515
2648
  {
2516
2649
  "name": "setPatternFill",
2517
2650
  "params": "preset: PatternPreset, foreColor?: string, backColor?: string, foreAlpha?: number, backAlpha?: number",
2518
2651
  "ret": null,
2519
2652
  "array": false,
2520
- "doc": "패턴(무늬) 채우기를 설정한다. (getFill 왕복 대칭 — setFill 의 pattern 경로)"
2653
+ "doc": "패턴(무늬) 채우기를 설정한다. (getFill 왕복 대칭)"
2521
2654
  },
2522
2655
  {
2523
2656
  "name": "setReflection",
2524
- "params": "reflection?: { blur?: number; dist?: number; stPos?: number; endPos?: number; startAlpha?: number; endAlpha?: number; dir?: number; fadeDir?: number; sx?: number; sy?: number; kx?: number; ky?: number; algn?: RectAlign; rotWithShape?: boolean }",
2657
+ "params": "reflection?: Reflection",
2525
2658
  "ret": null,
2526
2659
  "array": false,
2527
- "doc": "반사 효과를 적용한다."
2660
+ "doc": "반사 효과를 적용한다. (getEffects().reflection 대칭 - 반환 객체를 그대로 넘길 수 있다) 생략한 필드는 기본값으로 채운다 (필드별 기본값은 Reflection 참조)."
2661
+ },
2662
+ {
2663
+ "name": "setRotation",
2664
+ "params": "rotation: number",
2665
+ "ret": null,
2666
+ "array": false,
2667
+ "doc": "도형의 회전 각도를 절대값으로 설정한다. 회전이 불가능한 도형이면 무시된다. (getRotation 대칭)"
2528
2668
  },
2529
2669
  {
2530
2670
  "name": "setSoftEdge",
2531
- "params": "softEdge?: { rad?: number }",
2671
+ "params": "softEdge?: SoftEdge",
2532
2672
  "ret": null,
2533
2673
  "array": false,
2534
- "doc": "옅은 테두리(softEdge) 효과를 적용한다."
2674
+ "doc": "옅은 테두리(softEdge) 효과를 적용한다. (getEffects().softEdge 대칭 - 반환 객체를 그대로 넘길 수 있다) 생략한 필드는 기본값으로 채운다 (필드별 기본값은 SoftEdge 참조)."
2535
2675
  },
2536
2676
  {
2537
2677
  "name": "setSolidFill",
@@ -2540,33 +2680,40 @@
2540
2680
  "array": false,
2541
2681
  "doc": "도형 채우기를 단색으로 설정한다."
2542
2682
  },
2683
+ {
2684
+ "name": "setTailEnd",
2685
+ "params": "lineEnd: Partial<LineEnd> & {type: LineEndType}",
2686
+ "ret": null,
2687
+ "array": false,
2688
+ "doc": "연결선의 끝 화살표(tailEnd)를 설정한다. (getTailEnd 대칭 - 반환 객체를 그대로 넘길 수 있다) 화살표를 없애려면 type 에 LineEndType.NONE 을 준다. width/length 를 생략하면 기존 크기가 아니라 기본값(MEDIUM)이 적용된다."
2689
+ },
2543
2690
  {
2544
2691
  "name": "setTransform",
2545
- "params": "transform?: ShapeTransform",
2692
+ "params": "transform?: Partial<ShapeTransform>",
2546
2693
  "ret": null,
2547
2694
  "array": false,
2548
- "doc": "도형의 위치·크기·회전을 한 번에 설정한다. getTransform() 반환값을 그대로 넘길 수 있다. (getTransform 대칭) 제공된 필드만 적용하며, 각 필드는 개별 setter 의 잠금 가드(canResize/canMove/canRotate)를 따른다. 크기→위치→회전 순으로 개별 액션을 발생시키므로 실행 취소는 여러 단계가 될 수 있다."
2695
+ "doc": "도형의 위치·크기·회전을 한 번에 설정한다. getTransform() 반환값을 그대로 넘길 수 있다. (getTransform 대칭) 값을 준 필드만 크기→위치→회전 순으로 적용하고, 생략한 필드는 현재 값을 유지한다. 각 필드는 개별 setter 와 같이 해당 조작(크기/이동/회전)이 불가능한 도형에서 무시된다."
2549
2696
  },
2550
2697
  {
2551
2698
  "name": "setWidth",
2552
2699
  "params": "width: number",
2553
2700
  "ret": null,
2554
2701
  "array": false,
2555
- "doc": "도형의 너비를 설정한다."
2702
+ "doc": "도형의 너비를 설정한다. 크기 조정이 불가능한 도형이면 무시된다."
2556
2703
  },
2557
2704
  {
2558
2705
  "name": "setX",
2559
2706
  "params": "x: number",
2560
2707
  "ret": null,
2561
2708
  "array": false,
2562
- "doc": "도형의 X 좌표를 절대값으로 설정한다. (상대 이동은 comment.moveBy 등과 구분)"
2709
+ "doc": "도형의 X 좌표를 절대값으로 설정한다. 이동이 불가능한 도형이면 무시된다. (상대 이동은 moveBy)"
2563
2710
  },
2564
2711
  {
2565
2712
  "name": "setY",
2566
2713
  "params": "y: number",
2567
2714
  "ret": null,
2568
2715
  "array": false,
2569
- "doc": "도형의 Y 좌표를 절대값으로 설정한다."
2716
+ "doc": "도형의 Y 좌표를 절대값으로 설정한다. 이동이 불가능한 도형이면 무시된다."
2570
2717
  }
2571
2718
  ],
2572
2719
  "Group": [
@@ -2575,14 +2722,14 @@
2575
2722
  "params": "alignType: AlignType",
2576
2723
  "ret": null,
2577
2724
  "array": false,
2578
- "doc": "도형을 슬라이드 기준으로 정렬한다."
2725
+ "doc": "도형을 슬라이드 기준으로 정렬한다. 이동이 불가능한 도형이면 무시된다. 그룹 자식도 그룹 안이 아니라 슬라이드를 기준으로 움직인다(에디터와 같다). 자식이 그룹 밖으로 나가면 그룹이 자식을 담도록 함께 넓어진다."
2579
2726
  },
2580
2727
  {
2581
2728
  "name": "flip",
2582
2729
  "params": "direction: FlipDirection",
2583
2730
  "ret": null,
2584
2731
  "array": false,
2585
- "doc": "도형을 상하 또는 좌우로 반전한다."
2732
+ "doc": "도형을 상하 또는 좌우로 반전한다. 현재 반전 상태를 뒤집는 토글이며, 지금 반전돼 있는지는 isFlippedH()/isFlippedV() 로 읽는다. 회전이 불가능한 도형에서는 반전도 무시된다. 회전된 도형은 각도도 거울상으로 함께 바뀐다 (getRotation() 값이 360 - 기존 각도 로 바뀐다)."
2586
2733
  },
2587
2734
  {
2588
2735
  "name": "getChildren",
@@ -2605,7 +2752,15 @@
2605
2752
  "ret": null,
2606
2753
  "array": false,
2607
2754
  "text": "Hyperlink | null",
2608
- "doc": "도형에 설정된 하이퍼링크를 반환한다. 반환 객체를 그대로 setHyperlink 에 넘길 수 있다. 지원하지 않는 action(program/macro/ole 등)은 공개 타입으로 노출하지 않고 null 을 반환한다."
2755
+ "doc": "도형에 설정된 하이퍼링크를 반환한다. 반환 객체를 그대로 setHyperlink 에 넘길 수 있다. 지원하지 않는 종류(프로그램 실행·매크로 등)가 걸려 있으면 null 이다."
2756
+ },
2757
+ {
2758
+ "name": "getPlaceholderType",
2759
+ "params": "",
2760
+ "ret": null,
2761
+ "array": false,
2762
+ "text": "PlaceholderType | null",
2763
+ "doc": "도형의 placeholder 종류를 반환한다."
2609
2764
  },
2610
2765
  {
2611
2766
  "name": "getPresetId",
@@ -2621,7 +2776,7 @@
2621
2776
  "ret": null,
2622
2777
  "array": false,
2623
2778
  "text": "number | null",
2624
- "doc": "도형의 회전 각도를 반환한다. (rotate 대칭)"
2779
+ "doc": "도형의 회전 각도를 반환한다. (setRotation 대칭)"
2625
2780
  },
2626
2781
  {
2627
2782
  "name": "getTransform",
@@ -2629,7 +2784,7 @@
2629
2784
  "ret": null,
2630
2785
  "array": false,
2631
2786
  "text": "ShapeTransform | null",
2632
- "doc": "도형의 위치, 크기, 회전 정보를 반환한다."
2787
+ "doc": "도형의 위치, 크기, 회전 정보를 반환한다. x/y 는 반전(flip) 여부와 무관하게 도형의 좌상단이라, 반환값을 다른 도형의 setTransform 에 그대로 넘기면 두 도형이 같은 자리에 놓인다. 값은 에디터 입력 단위로 반올림해 반환한다 - 크기는 소수 한 자리, 위치는 정수. setter 도 같은 단위로 넣으므로, 임포트 문서처럼 더 잘게 놓인 도형은 되넘길 때 그만큼 움직인다."
2633
2788
  },
2634
2789
  {
2635
2790
  "name": "getWidth",
@@ -2655,6 +2810,22 @@
2655
2810
  "text": "number | null",
2656
2811
  "doc": "도형의 Y 좌표를 반환한다. (setY 대칭)"
2657
2812
  },
2813
+ {
2814
+ "name": "getZOrderIndex",
2815
+ "params": "",
2816
+ "ret": null,
2817
+ "array": false,
2818
+ "text": "number | null",
2819
+ "doc": "부모(슬라이드, 그룹 자식이면 그 그룹) 안에서 도형의 z-order 순번을 반환한다. 0 이 맨 뒤이며, 클수록 앞이다."
2820
+ },
2821
+ {
2822
+ "name": "hasText",
2823
+ "params": "",
2824
+ "ret": null,
2825
+ "array": false,
2826
+ "text": "boolean | null",
2827
+ "doc": "도형이 텍스트를 담고 있는지 반환한다. 에디터가 텍스트를 비었다고 보는 기준과 같다 — 공백만 있거나 빈 문단이 둘 이상(개행만 넣은 상태)이면 true, 빈 문단 하나뿐이면 false 다. 도형 레벨 텍스트가 없는 종류(표·그룹·차트)는 항상 false 다. (표는 셀 단위로 조회)"
2828
+ },
2658
2829
  {
2659
2830
  "name": "isChart",
2660
2831
  "params": "",
@@ -2679,6 +2850,22 @@
2679
2850
  "text": "this is Diagram",
2680
2851
  "doc": "이 핸들이 `Diagram` 인지 판별한다 (union 좁히기용 type guard). SDK 핸들의 내부 판별값을 동기 검사한다 — postMessage 왕복 없음, await 불필요."
2681
2852
  },
2853
+ {
2854
+ "name": "isFlippedH",
2855
+ "params": "",
2856
+ "ret": null,
2857
+ "array": false,
2858
+ "text": "boolean | null",
2859
+ "doc": "도형이 좌우로 반전된 상태인지 반환한다. (flip(FlipDirection.HORIZONTAL) 을 호출하면 이 값이 뒤집힌다)"
2860
+ },
2861
+ {
2862
+ "name": "isFlippedV",
2863
+ "params": "",
2864
+ "ret": null,
2865
+ "array": false,
2866
+ "text": "boolean | null",
2867
+ "doc": "도형이 상하로 반전된 상태인지 반환한다. (flip(FlipDirection.VERTICAL) 을 호출하면 이 값이 뒤집힌다)"
2868
+ },
2682
2869
  {
2683
2870
  "name": "isGroup",
2684
2871
  "params": "",
@@ -2716,7 +2903,7 @@
2716
2903
  "params": "",
2717
2904
  "ret": null,
2718
2905
  "array": false,
2719
- "text": "boolean",
2906
+ "text": "boolean | null",
2720
2907
  "doc": "도형이 placeholder(제목 · 본문 틀 등)인지 반환한다."
2721
2908
  },
2722
2909
  {
@@ -2754,63 +2941,63 @@
2754
2941
  "params": "order: ShapeZOrder",
2755
2942
  "ret": null,
2756
2943
  "array": false,
2757
- "doc": "도형의 정렬 순서(앞으로/뒤로)를 변경한다."
2758
- },
2759
- {
2760
- "name": "rotate",
2761
- "params": "rotation: number",
2762
- "ret": null,
2763
- "array": false,
2764
- "doc": "도형을 회전한다."
2944
+ "doc": "도형의 정렬 순서(앞으로/뒤로)를 변경한다. 이미 목표 위치라 바뀔 것이 없으면 무시된다."
2765
2945
  },
2766
2946
  {
2767
2947
  "name": "setHeight",
2768
2948
  "params": "height: number",
2769
2949
  "ret": null,
2770
2950
  "array": false,
2771
- "doc": "도형의 높이를 설정한다."
2951
+ "doc": "도형의 높이를 설정한다. 크기 조정이 불가능한 도형이면 무시된다."
2772
2952
  },
2773
2953
  {
2774
2954
  "name": "setHyperlink",
2775
2955
  "params": "hyperlink: Hyperlink",
2776
2956
  "ret": null,
2777
2957
  "array": false,
2778
- "doc": "도형에 하이퍼링크를 설정한다. (getHyperlink 대칭 — 반환 객체를 그대로 넘겨 하이퍼링크를 복사할 수 있다) other(program/macro/ole 등)와 유효하지 않은 대상(없는 슬라이드 id·ShowJumpType 밖의 값)은 무시한다."
2958
+ "doc": "도형에 하이퍼링크를 설정한다. (getHyperlink 대칭 — 반환 객체를 그대로 넘겨 하이퍼링크를 복사할 수 있다) 지원하지 않는 종류나 유효하지 않은 대상(없는 슬라이드 id 등)은 무시한다."
2959
+ },
2960
+ {
2961
+ "name": "setRotation",
2962
+ "params": "rotation: number",
2963
+ "ret": null,
2964
+ "array": false,
2965
+ "doc": "도형의 회전 각도를 절대값으로 설정한다. 회전이 불가능한 도형이면 무시된다. (getRotation 대칭)"
2779
2966
  },
2780
2967
  {
2781
2968
  "name": "setTransform",
2782
- "params": "transform?: ShapeTransform",
2969
+ "params": "transform?: Partial<ShapeTransform>",
2783
2970
  "ret": null,
2784
2971
  "array": false,
2785
- "doc": "도형의 위치·크기·회전을 한 번에 설정한다. getTransform() 반환값을 그대로 넘길 수 있다. (getTransform 대칭) 제공된 필드만 적용하며, 각 필드는 개별 setter 의 잠금 가드(canResize/canMove/canRotate)를 따른다. 크기→위치→회전 순으로 개별 액션을 발생시키므로 실행 취소는 여러 단계가 될 수 있다."
2972
+ "doc": "도형의 위치·크기·회전을 한 번에 설정한다. getTransform() 반환값을 그대로 넘길 수 있다. (getTransform 대칭) 값을 준 필드만 크기→위치→회전 순으로 적용하고, 생략한 필드는 현재 값을 유지한다. 각 필드는 개별 setter 와 같이 해당 조작(크기/이동/회전)이 불가능한 도형에서 무시된다."
2786
2973
  },
2787
2974
  {
2788
2975
  "name": "setWidth",
2789
2976
  "params": "width: number",
2790
2977
  "ret": null,
2791
2978
  "array": false,
2792
- "doc": "도형의 너비를 설정한다."
2979
+ "doc": "도형의 너비를 설정한다. 크기 조정이 불가능한 도형이면 무시된다."
2793
2980
  },
2794
2981
  {
2795
2982
  "name": "setX",
2796
2983
  "params": "x: number",
2797
2984
  "ret": null,
2798
2985
  "array": false,
2799
- "doc": "도형의 X 좌표를 절대값으로 설정한다. (상대 이동은 comment.moveBy 등과 구분)"
2986
+ "doc": "도형의 X 좌표를 절대값으로 설정한다. 이동이 불가능한 도형이면 무시된다. (상대 이동은 moveBy)"
2800
2987
  },
2801
2988
  {
2802
2989
  "name": "setY",
2803
2990
  "params": "y: number",
2804
2991
  "ret": null,
2805
2992
  "array": false,
2806
- "doc": "도형의 Y 좌표를 절대값으로 설정한다."
2993
+ "doc": "도형의 Y 좌표를 절대값으로 설정한다. 이동이 불가능한 도형이면 무시된다."
2807
2994
  },
2808
2995
  {
2809
2996
  "name": "ungroup",
2810
2997
  "params": "",
2811
- "ret": null,
2812
- "array": false,
2813
- "doc": "그룹을 해제하여 자식 도형들을 슬라이드 루트로 분리한다. 해제 후 이 Group 인스턴스는 더 이상 유효하지 않다."
2998
+ "ret": "Shape",
2999
+ "array": true,
3000
+ "doc": "그룹을 해제하여 자식 도형을 슬라이드 최상위로 분리한다. 해제 후 이 Group 인스턴스와 미리 얻어 둔 자식 프록시는 무효가 된다 (자식이 새 id 를 받는다)."
2814
3001
  }
2815
3002
  ],
2816
3003
  "Chart": [
@@ -2819,14 +3006,14 @@
2819
3006
  "params": "alignType: AlignType",
2820
3007
  "ret": null,
2821
3008
  "array": false,
2822
- "doc": "도형을 슬라이드 기준으로 정렬한다."
3009
+ "doc": "도형을 슬라이드 기준으로 정렬한다. 이동이 불가능한 도형이면 무시된다. 그룹 자식도 그룹 안이 아니라 슬라이드를 기준으로 움직인다(에디터와 같다). 자식이 그룹 밖으로 나가면 그룹이 자식을 담도록 함께 넓어진다."
2823
3010
  },
2824
3011
  {
2825
3012
  "name": "flip",
2826
3013
  "params": "direction: FlipDirection",
2827
3014
  "ret": null,
2828
3015
  "array": false,
2829
- "doc": "도형을 상하 또는 좌우로 반전한다."
3016
+ "doc": "도형을 상하 또는 좌우로 반전한다. 현재 반전 상태를 뒤집는 토글이며, 지금 반전돼 있는지는 isFlippedH()/isFlippedV() 로 읽는다. 회전이 불가능한 도형에서는 반전도 무시된다. 회전된 도형은 각도도 거울상으로 함께 바뀐다 (getRotation() 값이 360 - 기존 각도 로 바뀐다)."
2830
3017
  },
2831
3018
  {
2832
3019
  "name": "getAxisTitle",
@@ -2866,7 +3053,7 @@
2866
3053
  "ret": null,
2867
3054
  "array": false,
2868
3055
  "text": "Hyperlink | null",
2869
- "doc": "도형에 설정된 하이퍼링크를 반환한다. 반환 객체를 그대로 setHyperlink 에 넘길 수 있다. 지원하지 않는 action(program/macro/ole 등)은 공개 타입으로 노출하지 않고 null 을 반환한다."
3056
+ "doc": "도형에 설정된 하이퍼링크를 반환한다. 반환 객체를 그대로 setHyperlink 에 넘길 수 있다. 지원하지 않는 종류(프로그램 실행·매크로 등)가 걸려 있으면 null 이다."
2870
3057
  },
2871
3058
  {
2872
3059
  "name": "getLegendPosition",
@@ -2876,6 +3063,14 @@
2876
3063
  "text": "ChartLegendPosition",
2877
3064
  "doc": "범례 위치를 반환한다. 범례가 없으면 \"none\"."
2878
3065
  },
3066
+ {
3067
+ "name": "getPlaceholderType",
3068
+ "params": "",
3069
+ "ret": null,
3070
+ "array": false,
3071
+ "text": "PlaceholderType | null",
3072
+ "doc": "도형의 placeholder 종류를 반환한다."
3073
+ },
2879
3074
  {
2880
3075
  "name": "getPresetId",
2881
3076
  "params": "",
@@ -2890,7 +3085,7 @@
2890
3085
  "ret": null,
2891
3086
  "array": false,
2892
3087
  "text": "number | null",
2893
- "doc": "도형의 회전 각도를 반환한다. (rotate 대칭)"
3088
+ "doc": "도형의 회전 각도를 반환한다. (setRotation 대칭)"
2894
3089
  },
2895
3090
  {
2896
3091
  "name": "getState",
@@ -2914,7 +3109,7 @@
2914
3109
  "ret": null,
2915
3110
  "array": false,
2916
3111
  "text": "ShapeTransform | null",
2917
- "doc": "도형의 위치, 크기, 회전 정보를 반환한다."
3112
+ "doc": "도형의 위치, 크기, 회전 정보를 반환한다. x/y 는 반전(flip) 여부와 무관하게 도형의 좌상단이라, 반환값을 다른 도형의 setTransform 에 그대로 넘기면 두 도형이 같은 자리에 놓인다. 값은 에디터 입력 단위로 반올림해 반환한다 - 크기는 소수 한 자리, 위치는 정수. setter 도 같은 단위로 넣으므로, 임포트 문서처럼 더 잘게 놓인 도형은 되넘길 때 그만큼 움직인다."
2918
3113
  },
2919
3114
  {
2920
3115
  "name": "getType",
@@ -2948,6 +3143,22 @@
2948
3143
  "text": "number | null",
2949
3144
  "doc": "도형의 Y 좌표를 반환한다. (setY 대칭)"
2950
3145
  },
3146
+ {
3147
+ "name": "getZOrderIndex",
3148
+ "params": "",
3149
+ "ret": null,
3150
+ "array": false,
3151
+ "text": "number | null",
3152
+ "doc": "부모(슬라이드, 그룹 자식이면 그 그룹) 안에서 도형의 z-order 순번을 반환한다. 0 이 맨 뒤이며, 클수록 앞이다."
3153
+ },
3154
+ {
3155
+ "name": "hasText",
3156
+ "params": "",
3157
+ "ret": null,
3158
+ "array": false,
3159
+ "text": "boolean | null",
3160
+ "doc": "도형이 텍스트를 담고 있는지 반환한다. 에디터가 텍스트를 비었다고 보는 기준과 같다 — 공백만 있거나 빈 문단이 둘 이상(개행만 넣은 상태)이면 true, 빈 문단 하나뿐이면 false 다. 도형 레벨 텍스트가 없는 종류(표·그룹·차트)는 항상 false 다. (표는 셀 단위로 조회)"
3161
+ },
2951
3162
  {
2952
3163
  "name": "isChart",
2953
3164
  "params": "",
@@ -2980,6 +3191,22 @@
2980
3191
  "text": "boolean",
2981
3192
  "doc": "차트가 편집 가능한지 반환한다. 대상 부재·복원 불가·외부 데이터 차트는 false (throw 하지 않는다)."
2982
3193
  },
3194
+ {
3195
+ "name": "isFlippedH",
3196
+ "params": "",
3197
+ "ret": null,
3198
+ "array": false,
3199
+ "text": "boolean | null",
3200
+ "doc": "도형이 좌우로 반전된 상태인지 반환한다. (flip(FlipDirection.HORIZONTAL) 을 호출하면 이 값이 뒤집힌다)"
3201
+ },
3202
+ {
3203
+ "name": "isFlippedV",
3204
+ "params": "",
3205
+ "ret": null,
3206
+ "array": false,
3207
+ "text": "boolean | null",
3208
+ "doc": "도형이 상하로 반전된 상태인지 반환한다. (flip(FlipDirection.VERTICAL) 을 호출하면 이 값이 뒤집힌다)"
3209
+ },
2983
3210
  {
2984
3211
  "name": "isGroup",
2985
3212
  "params": "",
@@ -3017,7 +3244,7 @@
3017
3244
  "params": "",
3018
3245
  "ret": null,
3019
3246
  "array": false,
3020
- "text": "boolean",
3247
+ "text": "boolean | null",
3021
3248
  "doc": "도형이 placeholder(제목 · 본문 틀 등)인지 반환한다."
3022
3249
  },
3023
3250
  {
@@ -3055,14 +3282,7 @@
3055
3282
  "params": "order: ShapeZOrder",
3056
3283
  "ret": null,
3057
3284
  "array": false,
3058
- "doc": "도형의 정렬 순서(앞으로/뒤로)를 변경한다."
3059
- },
3060
- {
3061
- "name": "rotate",
3062
- "params": "rotation: number",
3063
- "ret": null,
3064
- "array": false,
3065
- "doc": "도형을 회전한다."
3285
+ "doc": "도형의 정렬 순서(앞으로/뒤로)를 변경한다. 이미 목표 위치라 바뀔 것이 없으면 무시된다."
3066
3286
  },
3067
3287
  {
3068
3288
  "name": "setAxisTitle",
@@ -3090,14 +3310,14 @@
3090
3310
  "params": "height: number",
3091
3311
  "ret": null,
3092
3312
  "array": false,
3093
- "doc": "도형의 높이를 설정한다."
3313
+ "doc": "도형의 높이를 설정한다. 크기 조정이 불가능한 도형이면 무시된다."
3094
3314
  },
3095
3315
  {
3096
3316
  "name": "setHyperlink",
3097
3317
  "params": "hyperlink: Hyperlink",
3098
3318
  "ret": null,
3099
3319
  "array": false,
3100
- "doc": "도형에 하이퍼링크를 설정한다. (getHyperlink 대칭 — 반환 객체를 그대로 넘겨 하이퍼링크를 복사할 수 있다) other(program/macro/ole 등)와 유효하지 않은 대상(없는 슬라이드 id·ShowJumpType 밖의 값)은 무시한다."
3320
+ "doc": "도형에 하이퍼링크를 설정한다. (getHyperlink 대칭 — 반환 객체를 그대로 넘겨 하이퍼링크를 복사할 수 있다) 지원하지 않는 종류나 유효하지 않은 대상(없는 슬라이드 id 등)은 무시한다."
3101
3321
  },
3102
3322
  {
3103
3323
  "name": "setLegendPosition",
@@ -3106,6 +3326,13 @@
3106
3326
  "array": false,
3107
3327
  "doc": "범례 위치를 설정한다. \"none\"이면 범례를 숨긴다."
3108
3328
  },
3329
+ {
3330
+ "name": "setRotation",
3331
+ "params": "rotation: number",
3332
+ "ret": null,
3333
+ "array": false,
3334
+ "doc": "도형의 회전 각도를 절대값으로 설정한다. 회전이 불가능한 도형이면 무시된다. (getRotation 대칭)"
3335
+ },
3109
3336
  {
3110
3337
  "name": "setStyle",
3111
3338
  "params": "style: number",
@@ -3122,10 +3349,10 @@
3122
3349
  },
3123
3350
  {
3124
3351
  "name": "setTransform",
3125
- "params": "transform?: ShapeTransform",
3352
+ "params": "transform?: Partial<ShapeTransform>",
3126
3353
  "ret": null,
3127
3354
  "array": false,
3128
- "doc": "도형의 위치·크기·회전을 한 번에 설정한다. getTransform() 반환값을 그대로 넘길 수 있다. (getTransform 대칭) 제공된 필드만 적용하며, 각 필드는 개별 setter 의 잠금 가드(canResize/canMove/canRotate)를 따른다. 크기→위치→회전 순으로 개별 액션을 발생시키므로 실행 취소는 여러 단계가 될 수 있다."
3355
+ "doc": "도형의 위치·크기·회전을 한 번에 설정한다. getTransform() 반환값을 그대로 넘길 수 있다. (getTransform 대칭) 값을 준 필드만 크기→위치→회전 순으로 적용하고, 생략한 필드는 현재 값을 유지한다. 각 필드는 개별 setter 와 같이 해당 조작(크기/이동/회전)이 불가능한 도형에서 무시된다."
3129
3356
  },
3130
3357
  {
3131
3358
  "name": "setType",
@@ -3139,21 +3366,21 @@
3139
3366
  "params": "width: number",
3140
3367
  "ret": null,
3141
3368
  "array": false,
3142
- "doc": "도형의 너비를 설정한다."
3369
+ "doc": "도형의 너비를 설정한다. 크기 조정이 불가능한 도형이면 무시된다."
3143
3370
  },
3144
3371
  {
3145
3372
  "name": "setX",
3146
3373
  "params": "x: number",
3147
3374
  "ret": null,
3148
3375
  "array": false,
3149
- "doc": "도형의 X 좌표를 절대값으로 설정한다. (상대 이동은 comment.moveBy 등과 구분)"
3376
+ "doc": "도형의 X 좌표를 절대값으로 설정한다. 이동이 불가능한 도형이면 무시된다. (상대 이동은 moveBy)"
3150
3377
  },
3151
3378
  {
3152
3379
  "name": "setY",
3153
3380
  "params": "y: number",
3154
3381
  "ret": null,
3155
3382
  "array": false,
3156
- "doc": "도형의 Y 좌표를 절대값으로 설정한다."
3383
+ "doc": "도형의 Y 좌표를 절대값으로 설정한다. 이동이 불가능한 도형이면 무시된다."
3157
3384
  }
3158
3385
  ],
3159
3386
  "Table": [
@@ -3162,42 +3389,42 @@
3162
3389
  "params": "alignType: AlignType",
3163
3390
  "ret": null,
3164
3391
  "array": false,
3165
- "doc": "도형을 슬라이드 기준으로 정렬한다."
3392
+ "doc": "도형을 슬라이드 기준으로 정렬한다. 이동이 불가능한 도형이면 무시된다. 그룹 자식도 그룹 안이 아니라 슬라이드를 기준으로 움직인다(에디터와 같다). 자식이 그룹 밖으로 나가면 그룹이 자식을 담도록 함께 넓어진다."
3166
3393
  },
3167
3394
  {
3168
3395
  "name": "deleteCol",
3169
3396
  "params": "startCol: number, endCol: number",
3170
3397
  "ret": null,
3171
3398
  "array": false,
3172
- "doc": "지정 범위의 열을 삭제한다."
3399
+ "doc": "지정 범위의 열을 삭제한다. 모든 열을 지울 수는 없다 - 한 열짜리 표에서 그 열을 지우려 하면 오류가 난다. 표 자체를 없애려면 Slide.deleteShape 를 쓴다."
3173
3400
  },
3174
3401
  {
3175
3402
  "name": "deleteRow",
3176
3403
  "params": "startRow: number, endRow: number",
3177
3404
  "ret": null,
3178
3405
  "array": false,
3179
- "doc": "지정 범위의 행을 삭제한다."
3406
+ "doc": "지정 범위의 행을 삭제한다. 모든 행을 지울 수는 없다 - 한 행짜리 표에서 그 행을 지우려 하면 오류가 난다. 표 자체를 없애려면 Slide.deleteShape 를 쓴다."
3180
3407
  },
3181
3408
  {
3182
3409
  "name": "findCells",
3183
3410
  "params": "filter?: CellFilter",
3184
3411
  "ret": "TableCell",
3185
3412
  "array": true,
3186
- "doc": "조건에 맞는 셀 배열을 반환한다. 복수 조건은 AND로 결합. range 는 셀 본체가 범위와 겹치면 매칭 (병합 대표 셀이 범위 밖에 있어도 셀 일부가 범위 안이면 결과에 포함됨). 그 외 조건은 병합된 셀의 대표 셀 좌표/속성 기준으로 평가."
3413
+ "doc": "조건에 맞는 셀 배열을 반환한다. 복수 조건은 AND 로 결합한다. range 는 셀 본체가 범위와 겹치면 매칭된다 (병합 대표 셀이 범위 밖에 있어도 셀 일부가 범위 안이면 결과에 포함된다). 그 외 조건은 병합된 셀의 대표 셀 좌표/속성 기준으로 평가한다."
3187
3414
  },
3188
3415
  {
3189
3416
  "name": "flip",
3190
3417
  "params": "direction: FlipDirection",
3191
3418
  "ret": null,
3192
3419
  "array": false,
3193
- "doc": "도형을 상하 또는 좌우로 반전한다."
3420
+ "doc": "도형을 상하 또는 좌우로 반전한다. 현재 반전 상태를 뒤집는 토글이며, 지금 반전돼 있는지는 isFlippedH()/isFlippedV() 로 읽는다. 회전이 불가능한 도형에서는 반전도 무시된다. 회전된 도형은 각도도 거울상으로 함께 바뀐다 (getRotation() 값이 360 - 기존 각도 로 바뀐다)."
3194
3421
  },
3195
3422
  {
3196
3423
  "name": "getCell",
3197
3424
  "params": "row: number, col: number",
3198
3425
  "ret": "TableCell",
3199
3426
  "array": false,
3200
- "doc": "병합된 셀 내부 좌표를 지정하면 해당 병합 영역의 대표 셀을 반환한다."
3427
+ "doc": "지정 좌표의 셀을 반환한다. 병합 영역 내부 좌표를 지정하면 그 병합 영역의 대표 셀을 반환한다."
3201
3428
  },
3202
3429
  {
3203
3430
  "name": "getCells",
@@ -3243,7 +3470,15 @@
3243
3470
  "ret": null,
3244
3471
  "array": false,
3245
3472
  "text": "Hyperlink | null",
3246
- "doc": "도형에 설정된 하이퍼링크를 반환한다. 반환 객체를 그대로 setHyperlink 에 넘길 수 있다. 지원하지 않는 action(program/macro/ole 등)은 공개 타입으로 노출하지 않고 null 을 반환한다."
3473
+ "doc": "도형에 설정된 하이퍼링크를 반환한다. 반환 객체를 그대로 setHyperlink 에 넘길 수 있다. 지원하지 않는 종류(프로그램 실행·매크로 등)가 걸려 있으면 null 이다."
3474
+ },
3475
+ {
3476
+ "name": "getPlaceholderType",
3477
+ "params": "",
3478
+ "ret": null,
3479
+ "array": false,
3480
+ "text": "PlaceholderType | null",
3481
+ "doc": "도형의 placeholder 종류를 반환한다."
3247
3482
  },
3248
3483
  {
3249
3484
  "name": "getPresetId",
@@ -3259,7 +3494,7 @@
3259
3494
  "ret": null,
3260
3495
  "array": false,
3261
3496
  "text": "number | null",
3262
- "doc": "도형의 회전 각도를 반환한다. (rotate 대칭)"
3497
+ "doc": "도형의 회전 각도를 반환한다. (setRotation 대칭)"
3263
3498
  },
3264
3499
  {
3265
3500
  "name": "getRow",
@@ -3284,13 +3519,29 @@
3284
3519
  "text": "number | null",
3285
3520
  "doc": "지정 행의 높이를 반환한다. (setRowHeight 대칭)"
3286
3521
  },
3522
+ {
3523
+ "name": "getStyleName",
3524
+ "params": "",
3525
+ "ret": null,
3526
+ "array": false,
3527
+ "text": "string | null",
3528
+ "doc": "표에 적용된 스타일 이름을 반환한다. (setStyle 대칭) 반환한 이름은 그대로 setStyle 에 되먹일 수 있다. 다만 문서에만 실려 있고 편집기 갤러리에는 없는 스타일이면 doc.getTableStyleNames() 목록에는 나오지 않는다."
3529
+ },
3530
+ {
3531
+ "name": "getStyleOption",
3532
+ "params": "option: TableStyleOption",
3533
+ "ret": null,
3534
+ "array": false,
3535
+ "text": "boolean | null",
3536
+ "doc": "표 스타일 옵션(머리글 행, 줄무늬 행 등)의 활성화 여부를 반환한다. (setStyleOption 대칭)"
3537
+ },
3287
3538
  {
3288
3539
  "name": "getTransform",
3289
3540
  "params": "",
3290
3541
  "ret": null,
3291
3542
  "array": false,
3292
3543
  "text": "ShapeTransform | null",
3293
- "doc": "도형의 위치, 크기, 회전 정보를 반환한다."
3544
+ "doc": "도형의 위치, 크기, 회전 정보를 반환한다. x/y 는 반전(flip) 여부와 무관하게 도형의 좌상단이라, 반환값을 다른 도형의 setTransform 에 그대로 넘기면 두 도형이 같은 자리에 놓인다. 값은 에디터 입력 단위로 반올림해 반환한다 - 크기는 소수 한 자리, 위치는 정수. setter 도 같은 단위로 넣으므로, 임포트 문서처럼 더 잘게 놓인 도형은 되넘길 때 그만큼 움직인다."
3294
3545
  },
3295
3546
  {
3296
3547
  "name": "getWidth",
@@ -3316,6 +3567,22 @@
3316
3567
  "text": "number | null",
3317
3568
  "doc": "도형의 Y 좌표를 반환한다. (setY 대칭)"
3318
3569
  },
3570
+ {
3571
+ "name": "getZOrderIndex",
3572
+ "params": "",
3573
+ "ret": null,
3574
+ "array": false,
3575
+ "text": "number | null",
3576
+ "doc": "부모(슬라이드, 그룹 자식이면 그 그룹) 안에서 도형의 z-order 순번을 반환한다. 0 이 맨 뒤이며, 클수록 앞이다."
3577
+ },
3578
+ {
3579
+ "name": "hasText",
3580
+ "params": "",
3581
+ "ret": null,
3582
+ "array": false,
3583
+ "text": "boolean | null",
3584
+ "doc": "도형이 텍스트를 담고 있는지 반환한다. 에디터가 텍스트를 비었다고 보는 기준과 같다 — 공백만 있거나 빈 문단이 둘 이상(개행만 넣은 상태)이면 true, 빈 문단 하나뿐이면 false 다. 도형 레벨 텍스트가 없는 종류(표·그룹·차트)는 항상 false 다. (표는 셀 단위로 조회)"
3585
+ },
3319
3586
  {
3320
3587
  "name": "insertCol",
3321
3588
  "params": "baseColIndex: number, position: InsertPosition, insertNum: number",
@@ -3354,6 +3621,22 @@
3354
3621
  "text": "this is Diagram",
3355
3622
  "doc": "이 핸들이 `Diagram` 인지 판별한다 (union 좁히기용 type guard). SDK 핸들의 내부 판별값을 동기 검사한다 — postMessage 왕복 없음, await 불필요."
3356
3623
  },
3624
+ {
3625
+ "name": "isFlippedH",
3626
+ "params": "",
3627
+ "ret": null,
3628
+ "array": false,
3629
+ "text": "boolean | null",
3630
+ "doc": "도형이 좌우로 반전된 상태인지 반환한다. (flip(FlipDirection.HORIZONTAL) 을 호출하면 이 값이 뒤집힌다)"
3631
+ },
3632
+ {
3633
+ "name": "isFlippedV",
3634
+ "params": "",
3635
+ "ret": null,
3636
+ "array": false,
3637
+ "text": "boolean | null",
3638
+ "doc": "도형이 상하로 반전된 상태인지 반환한다. (flip(FlipDirection.VERTICAL) 을 호출하면 이 값이 뒤집힌다)"
3639
+ },
3357
3640
  {
3358
3641
  "name": "isGroup",
3359
3642
  "params": "",
@@ -3391,7 +3674,7 @@
3391
3674
  "params": "",
3392
3675
  "ret": null,
3393
3676
  "array": false,
3394
- "text": "boolean",
3677
+ "text": "boolean | null",
3395
3678
  "doc": "도형이 placeholder(제목 · 본문 틀 등)인지 반환한다."
3396
3679
  },
3397
3680
  {
@@ -3436,14 +3719,7 @@
3436
3719
  "params": "order: ShapeZOrder",
3437
3720
  "ret": null,
3438
3721
  "array": false,
3439
- "doc": "도형의 정렬 순서(앞으로/뒤로)를 변경한다."
3440
- },
3441
- {
3442
- "name": "rotate",
3443
- "params": "rotation: number",
3444
- "ret": null,
3445
- "array": false,
3446
- "doc": "도형을 회전한다."
3722
+ "doc": "도형의 정렬 순서(앞으로/뒤로)를 변경한다. 이미 목표 위치라 바뀔 것이 없으면 무시된다."
3447
3723
  },
3448
3724
  {
3449
3725
  "name": "setColWidth",
@@ -3457,14 +3733,21 @@
3457
3733
  "params": "height: number",
3458
3734
  "ret": null,
3459
3735
  "array": false,
3460
- "doc": "도형의 높이를 설정한다."
3736
+ "doc": "도형의 높이를 설정한다. 크기 조정이 불가능한 도형이면 무시된다."
3461
3737
  },
3462
3738
  {
3463
3739
  "name": "setHyperlink",
3464
3740
  "params": "hyperlink: Hyperlink",
3465
3741
  "ret": null,
3466
3742
  "array": false,
3467
- "doc": "도형에 하이퍼링크를 설정한다. (getHyperlink 대칭 — 반환 객체를 그대로 넘겨 하이퍼링크를 복사할 수 있다) other(program/macro/ole 등)와 유효하지 않은 대상(없는 슬라이드 id·ShowJumpType 밖의 값)은 무시한다."
3743
+ "doc": "도형에 하이퍼링크를 설정한다. (getHyperlink 대칭 — 반환 객체를 그대로 넘겨 하이퍼링크를 복사할 수 있다) 지원하지 않는 종류나 유효하지 않은 대상(없는 슬라이드 id 등)은 무시한다."
3744
+ },
3745
+ {
3746
+ "name": "setRotation",
3747
+ "params": "rotation: number",
3748
+ "ret": null,
3749
+ "array": false,
3750
+ "doc": "도형의 회전 각도를 절대값으로 설정한다. 회전이 불가능한 도형이면 무시된다. (getRotation 대칭)"
3468
3751
  },
3469
3752
  {
3470
3753
  "name": "setRowHeight",
@@ -3478,42 +3761,42 @@
3478
3761
  "params": "styleName: string",
3479
3762
  "ret": null,
3480
3763
  "array": false,
3481
- "doc": "표 스타일을 변경한다."
3764
+ "doc": "표 스타일을 변경한다. (getStyleName 대칭)"
3482
3765
  },
3483
3766
  {
3484
3767
  "name": "setStyleOption",
3485
3768
  "params": "option: TableStyleOption, enabled: boolean",
3486
3769
  "ret": null,
3487
3770
  "array": false,
3488
- "doc": "표 스타일 옵션(머리글 행, 줄무늬 행 등)을 변경한다."
3771
+ "doc": "표 스타일 옵션(머리글 행, 줄무늬 행 등)을 변경한다. (getStyleOption 대칭)"
3489
3772
  },
3490
3773
  {
3491
3774
  "name": "setTransform",
3492
- "params": "transform?: ShapeTransform",
3775
+ "params": "transform?: Partial<ShapeTransform>",
3493
3776
  "ret": null,
3494
3777
  "array": false,
3495
- "doc": "도형의 위치·크기·회전을 한 번에 설정한다. getTransform() 반환값을 그대로 넘길 수 있다. (getTransform 대칭) 제공된 필드만 적용하며, 각 필드는 개별 setter 의 잠금 가드(canResize/canMove/canRotate)를 따른다. 크기→위치→회전 순으로 개별 액션을 발생시키므로 실행 취소는 여러 단계가 될 수 있다."
3778
+ "doc": "도형의 위치·크기·회전을 한 번에 설정한다. getTransform() 반환값을 그대로 넘길 수 있다. (getTransform 대칭) 값을 준 필드만 크기→위치→회전 순으로 적용하고, 생략한 필드는 현재 값을 유지한다. 각 필드는 개별 setter 와 같이 해당 조작(크기/이동/회전)이 불가능한 도형에서 무시된다."
3496
3779
  },
3497
3780
  {
3498
3781
  "name": "setWidth",
3499
3782
  "params": "width: number",
3500
3783
  "ret": null,
3501
3784
  "array": false,
3502
- "doc": "도형의 너비를 설정한다."
3785
+ "doc": "도형의 너비를 설정한다. 크기 조정이 불가능한 도형이면 무시된다."
3503
3786
  },
3504
3787
  {
3505
3788
  "name": "setX",
3506
3789
  "params": "x: number",
3507
3790
  "ret": null,
3508
3791
  "array": false,
3509
- "doc": "도형의 X 좌표를 절대값으로 설정한다. (상대 이동은 comment.moveBy 등과 구분)"
3792
+ "doc": "도형의 X 좌표를 절대값으로 설정한다. 이동이 불가능한 도형이면 무시된다. (상대 이동은 moveBy)"
3510
3793
  },
3511
3794
  {
3512
3795
  "name": "setY",
3513
3796
  "params": "y: number",
3514
3797
  "ret": null,
3515
3798
  "array": false,
3516
- "doc": "도형의 Y 좌표를 절대값으로 설정한다."
3799
+ "doc": "도형의 Y 좌표를 절대값으로 설정한다. 이동이 불가능한 도형이면 무시된다."
3517
3800
  },
3518
3801
  {
3519
3802
  "name": "unmergeCell",
@@ -3533,27 +3816,43 @@
3533
3816
  },
3534
3817
  {
3535
3818
  "name": "getAlignH",
3536
- "params": "range?: { from: number; to: number }",
3819
+ "params": "range?: TextRange",
3537
3820
  "ret": null,
3538
3821
  "array": false,
3539
3822
  "text": "TextAlignH | null",
3540
3823
  "doc": "대표 단락의 가로 정렬을 반환한다. (setAlignH 대칭)"
3541
3824
  },
3542
3825
  {
3543
- "name": "getBold",
3826
+ "name": "getAlignV",
3544
3827
  "params": "",
3545
3828
  "ret": null,
3546
3829
  "array": false,
3830
+ "text": "TextAlignV | null",
3831
+ "doc": "텍스트 세로 정렬을 반환한다. (setAlignV 대칭) TextAlignV 는 TOP 이 0 인 숫자 enum 이라, 값이 있는지는 truthy 검사가 아니라 null 비교로 본다."
3832
+ },
3833
+ {
3834
+ "name": "getBold",
3835
+ "params": "range?: TextRange",
3836
+ "ret": null,
3837
+ "array": false,
3547
3838
  "text": "boolean | null",
3548
- "doc": "대표 run 의 굵게 여부를 반환한다. (setBold 대칭)"
3839
+ "doc": "대표 run 의 굵게 여부를 반환한다. (setBold 대칭 — 상속까지 반영된 실제 적용값)"
3549
3840
  },
3550
3841
  {
3551
3842
  "name": "getBorderStyle",
3552
- "params": "position: BorderPosition",
3843
+ "params": "position: Exclude<BorderPosition, \"all\">",
3553
3844
  "ret": null,
3554
3845
  "array": false,
3555
3846
  "text": "BorderStyle | null",
3556
- "doc": "지정 위치의 셀 테두리 스타일을 반환한다. (setBorderStyle 대칭) 해당 위치에 명시적 테두리가 없으면 null. ALL 등 복수 위치는 조회 미지원(null)."
3847
+ "doc": "지정 위치의 셀 테두리 스타일을 반환한다. (setBorderStyle 대칭) ALL 일괄 조회는 지원하지 않는다 - 한 변씩 조회한다."
3848
+ },
3849
+ {
3850
+ "name": "getBulletStyle",
3851
+ "params": "range?: TextRange",
3852
+ "ret": null,
3853
+ "array": false,
3854
+ "text": "BulletStyle | null",
3855
+ "doc": "대표 단락의 글머리 기호 스타일을 반환한다. 반환 필드를 풀어서 setBulletStyle(type, subType, startAt) 에 넘길 수 있다. 값은 레이아웃/마스터 상속까지 반영해 실제 적용된 값이고, 없는 값(시작 번호)과 되넘길 수 없는 값(프리셋 밖 번호 유형)은 키를 담지 않는다. 그림 글머리·프리셋 밖 문자는 조회 전용이라 그대로는 적용되지 않는다. (제약은 setBulletStyle 참조)"
3557
3856
  },
3558
3857
  {
3559
3858
  "name": "getColIndex",
@@ -3563,17 +3862,25 @@
3563
3862
  "text": "number",
3564
3863
  "doc": "셀의 열 인덱스를 반환한다."
3565
3864
  },
3865
+ {
3866
+ "name": "getColSpan",
3867
+ "params": "",
3868
+ "ret": null,
3869
+ "array": false,
3870
+ "text": "number | null",
3871
+ "doc": "셀이 가로로 차지하는 열 수를 반환한다. 병합되지 않았으면 1 이다."
3872
+ },
3566
3873
  {
3567
3874
  "name": "getFill",
3568
3875
  "params": "",
3569
3876
  "ret": null,
3570
3877
  "array": false,
3571
3878
  "text": "Fill | null",
3572
- "doc": "셀에 명시적으로 설정된 배경 채우기를 반환한다. (setSolidFill 대칭) 스타일 상속분은 포함하지 않으며(tcPr 에 명시된 fill 만), alpha 는 setSolidFill 과 동일한 투명도(0~100, 0=불투명)로 역변환되어 반환된다."
3879
+ "doc": "셀에 명시적으로 설정된 배경 채우기를 반환한다. (setSolidFill 대칭) 스타일 상속분은 포함하지 않으며(셀에 직접 지정한 채우기만), alpha 는 setSolidFill 과 같은 투명도(0~100, 0=불투명)로 반환한다."
3573
3880
  },
3574
3881
  {
3575
3882
  "name": "getFirstLineIndent",
3576
- "params": "range?: { from: number; to: number }",
3883
+ "params": "range?: TextRange",
3577
3884
  "ret": null,
3578
3885
  "array": false,
3579
3886
  "text": "number | null",
@@ -3581,39 +3888,39 @@
3581
3888
  },
3582
3889
  {
3583
3890
  "name": "getFontFamily",
3584
- "params": "",
3891
+ "params": "range?: TextRange",
3585
3892
  "ret": null,
3586
3893
  "array": false,
3587
3894
  "text": "string | null",
3588
- "doc": "대표 run 의 글꼴 이름을 반환한다. (setFontFamily 대칭)"
3895
+ "doc": "대표 run 의 글꼴 이름을 반환한다. (setFontFamily 대칭 — 상속까지 반영된 실제 적용값)"
3589
3896
  },
3590
3897
  {
3591
3898
  "name": "getFontSize",
3592
- "params": "",
3899
+ "params": "range?: TextRange",
3593
3900
  "ret": null,
3594
3901
  "array": false,
3595
3902
  "text": "number | null",
3596
- "doc": "대표 run 의 글자 크기(pt)를 반환한다. (setFontSize 대칭)"
3903
+ "doc": "대표 run 의 글자 크기(pt)를 반환한다. (setFontSize 대칭 — 상속까지 반영된 실제 적용값)"
3597
3904
  },
3598
3905
  {
3599
3906
  "name": "getFontStyle",
3600
- "params": "",
3907
+ "params": "range?: TextRange",
3601
3908
  "ret": null,
3602
3909
  "array": false,
3603
3910
  "text": "FontStyle | null",
3604
- "doc": "대표 run(첫 run)의 글꼴 스타일을 반환한다. (setFontStyle 대칭) 반환 객체를 그대로 다른 개체의 setFontStyle 에 넘길 수 있다. 값이 없는 속성은 키를 생략한다."
3911
+ "doc": "대표 run(range 가 걸친 첫 run)의 글꼴 스타일을 반환한다. (setFontStyle 대칭) 반환 객체를 그대로 다른 개체의 setFontStyle 에 넘길 수 있다. 값이 없는 속성은 키를 담지 않는다. 값은 레이아웃/마스터/표 스타일 상속까지 반영해 실제 적용된 값이라 run 이 직접 지정한 값만 골라낼 수는 없다."
3605
3912
  },
3606
3913
  {
3607
3914
  "name": "getItalic",
3608
- "params": "",
3915
+ "params": "range?: TextRange",
3609
3916
  "ret": null,
3610
3917
  "array": false,
3611
3918
  "text": "boolean | null",
3612
- "doc": "대표 run 의 기울임 여부를 반환한다. (setItalic 대칭)"
3919
+ "doc": "대표 run 의 기울임 여부를 반환한다. (setItalic 대칭 — 상속까지 반영된 실제 적용값)"
3613
3920
  },
3614
3921
  {
3615
3922
  "name": "getLevel",
3616
- "params": "range?: { from: number; to: number }",
3923
+ "params": "range?: TextRange",
3617
3924
  "ret": null,
3618
3925
  "array": false,
3619
3926
  "text": "number | null",
@@ -3621,7 +3928,7 @@
3621
3928
  },
3622
3929
  {
3623
3930
  "name": "getLineSpacing",
3624
- "params": "range?: { from: number; to: number }",
3931
+ "params": "range?: TextRange",
3625
3932
  "ret": null,
3626
3933
  "array": false,
3627
3934
  "text": "number | null",
@@ -3629,7 +3936,7 @@
3629
3936
  },
3630
3937
  {
3631
3938
  "name": "getLineSpacingType",
3632
- "params": "range?: { from: number; to: number }",
3939
+ "params": "range?: TextRange",
3633
3940
  "ret": null,
3634
3941
  "array": false,
3635
3942
  "text": "LineSpacingType | null",
@@ -3637,7 +3944,7 @@
3637
3944
  },
3638
3945
  {
3639
3946
  "name": "getMarginLeft",
3640
- "params": "range?: { from: number; to: number }",
3947
+ "params": "range?: TextRange",
3641
3948
  "ret": null,
3642
3949
  "array": false,
3643
3950
  "text": "number | null",
@@ -3645,11 +3952,11 @@
3645
3952
  },
3646
3953
  {
3647
3954
  "name": "getParagraphStyle",
3648
- "params": "range?: { from: number; to: number }",
3955
+ "params": "range?: TextRange",
3649
3956
  "ret": null,
3650
3957
  "array": false,
3651
3958
  "text": "ParagraphStyle | null",
3652
- "doc": "대표 단락(range 가 걸친 첫 단락)의 단락 서식을 반환한다. (setParagraphStyle 대칭) 반환 객체를 그대로 다른 개체의 setParagraphStyle 에 넘길 수 있다. 값이 없는 속성은 키를 생략한다. 값은 레이아웃/마스터 상속이 반영된 해석값이다. 단락이 직접 지정한 값만 골라낼 수는 없다. 같은 단락에 그대로 되돌려주면 상속값과 같은 속성은 오버라이드로 굳지 않고 지워진다. (updateTextPPr 동작) 목록 수준은 서식 값이 아니라 상속 프리셋이라 이 객체에 담지 않는다. (getLevel 대칭)"
3959
+ "doc": "대표 단락(range 가 걸친 첫 단락)의 단락 서식을 반환한다. (setParagraphStyle 대칭) 반환 객체를 그대로 다른 개체의 setParagraphStyle 에 넘길 수 있다. 값이 없는 속성은 키를 담지 않는다. 값은 레이아웃/마스터 상속까지 반영해 실제 적용된 값이라 단락이 직접 지정한 값만 골라낼 수는 없고, 같은 단락에 그대로 다시 넘기면 상속값과 같은 속성은 직접 지정으로 남지 않는다. 목록 수준은 서식 값이 아니라 상속 프리셋이라 담지 않는다. (getLevel 대칭)"
3653
3960
  },
3654
3961
  {
3655
3962
  "name": "getRowIndex",
@@ -3659,9 +3966,17 @@
3659
3966
  "text": "number",
3660
3967
  "doc": "셀의 행 인덱스를 반환한다."
3661
3968
  },
3969
+ {
3970
+ "name": "getRowSpan",
3971
+ "params": "",
3972
+ "ret": null,
3973
+ "array": false,
3974
+ "text": "number | null",
3975
+ "doc": "셀이 세로로 차지하는 행 수를 반환한다. 병합되지 않았으면 1 이다."
3976
+ },
3662
3977
  {
3663
3978
  "name": "getSpaceAfter",
3664
- "params": "range?: { from: number; to: number }",
3979
+ "params": "range?: TextRange",
3665
3980
  "ret": null,
3666
3981
  "array": false,
3667
3982
  "text": "number | null",
@@ -3669,7 +3984,7 @@
3669
3984
  },
3670
3985
  {
3671
3986
  "name": "getSpaceBefore",
3672
- "params": "range?: { from: number; to: number }",
3987
+ "params": "range?: TextRange",
3673
3988
  "ret": null,
3674
3989
  "array": false,
3675
3990
  "text": "number | null",
@@ -3677,19 +3992,19 @@
3677
3992
  },
3678
3993
  {
3679
3994
  "name": "getStrike",
3680
- "params": "",
3995
+ "params": "range?: TextRange",
3681
3996
  "ret": null,
3682
3997
  "array": false,
3683
3998
  "text": "Strike | null",
3684
- "doc": "대표 run 의 취소선 유형을 반환한다. (setStrike 대칭)"
3999
+ "doc": "대표 run 의 취소선 유형을 반환한다. (setStrike 대칭 — 상속까지 반영된 실제 적용값)"
3685
4000
  },
3686
4001
  {
3687
4002
  "name": "getText",
3688
- "params": "range?: { from: number; to: number }",
4003
+ "params": "range?: TextRange",
3689
4004
  "ret": null,
3690
4005
  "array": false,
3691
4006
  "text": "string",
3692
- "doc": "텍스트를 plain text로 반환한다."
4007
+ "doc": "텍스트를 plain text로 반환한다. 문단 사이의 개행은 그대로 들어가지만, 마지막 문단을 끝맺는 개행은 글자가 아니라 담지 않는다 (빈 텍스트는 \"\")."
3693
4008
  },
3694
4009
  {
3695
4010
  "name": "getTextboxAutoFit",
@@ -3701,27 +4016,27 @@
3701
4016
  },
3702
4017
  {
3703
4018
  "name": "getTextColor",
3704
- "params": "",
4019
+ "params": "range?: TextRange",
3705
4020
  "ret": null,
3706
4021
  "array": false,
3707
4022
  "text": "string | null",
3708
- "doc": "대표 run 의 글자 색상을 반환한다. (setTextColor 대칭)"
4023
+ "doc": "대표 run 의 글자 색상을 반환한다. (setTextColor 대칭 — 상속까지 반영된 실제 적용값)"
3709
4024
  },
3710
4025
  {
3711
4026
  "name": "getTextHyperlink",
3712
- "params": "range?: { from: number; to: number }",
4027
+ "params": "range?: TextRange",
3713
4028
  "ret": null,
3714
4029
  "array": false,
3715
4030
  "text": "Hyperlink | null",
3716
- "doc": "텍스트 구간의 하이퍼링크를 반환한다. (setTextHyperlink 대칭 — 반환 객체를 그대로 넘겨 하이퍼링크를 복사할 수 있다) range 를 주면 그 구간의 첫 글자, 없으면 텍스트 첫 글자가 속한 run 기준이다. 도형 자체에 걸린 하이퍼링크는 getHyperlink 로 읽는다."
4031
+ "doc": "텍스트 구간의 하이퍼링크를 반환한다. (setTextHyperlink 대칭 — 반환 객체를 그대로 넘겨 복사할 수 있다) range 를 주면 그 구간의 첫 글자, range 가 없으면 텍스트의 첫 글자가 속한 run 을 기준으로 한다. 도형 자체에 걸린 하이퍼링크는 getHyperlink 로 읽는다."
3717
4032
  },
3718
4033
  {
3719
4034
  "name": "getUnderline",
3720
- "params": "",
4035
+ "params": "range?: TextRange",
3721
4036
  "ret": null,
3722
4037
  "array": false,
3723
4038
  "text": "Underline | null",
3724
- "doc": "대표 run 의 밑줄 유형을 반환한다. (setUnderline 대칭)"
4039
+ "doc": "대표 run 의 밑줄 유형을 반환한다. (setUnderline 대칭 — 상속까지 반영된 실제 적용값)"
3725
4040
  },
3726
4041
  {
3727
4042
  "name": "insertSymbol",
@@ -3747,14 +4062,14 @@
3747
4062
  },
3748
4063
  {
3749
4064
  "name": "removeTextHyperlink",
3750
- "params": "range?: { from: number; to: number }",
4065
+ "params": "range?: TextRange",
3751
4066
  "ret": null,
3752
4067
  "array": false,
3753
4068
  "doc": "텍스트의 하이퍼링크를 제거한다. (도형 자체에 걸린 하이퍼링크는 removeHyperlink)"
3754
4069
  },
3755
4070
  {
3756
4071
  "name": "setAlignH",
3757
- "params": "align: TextAlignH, range?: { from: number; to: number }",
4072
+ "params": "align: TextAlignH, range?: TextRange",
3758
4073
  "ret": null,
3759
4074
  "array": false,
3760
4075
  "doc": "텍스트 가로 정렬을 설정한다. range 를 주면 그 구간이 걸친 단락에만 적용한다."
@@ -3764,98 +4079,98 @@
3764
4079
  "params": "align: TextAlignV",
3765
4080
  "ret": null,
3766
4081
  "array": false,
3767
- "doc": "텍스트 세로 정렬을 설정한다."
4082
+ "doc": "텍스트 세로 정렬을 설정한다. (getAlignV 대칭)"
3768
4083
  },
3769
4084
  {
3770
4085
  "name": "setBold",
3771
- "params": "enabled: boolean, range?: { from: number; to: number }",
4086
+ "params": "enabled: boolean, range?: TextRange",
3772
4087
  "ret": null,
3773
4088
  "array": false,
3774
- "doc": "글자 굵게 설정."
4089
+ "doc": "글자를 굵게 설정한다."
3775
4090
  },
3776
4091
  {
3777
4092
  "name": "setBorderStyle",
3778
4093
  "params": "position: BorderPosition, color?: string, width?: number, lineDash?: LineDash",
3779
4094
  "ret": null,
3780
4095
  "array": false,
3781
- "doc": "셀 테두리 스타일을 설정한다. color/width/lineDash 를 모두 생략하면 아무 것도 변경하지 않는다. 색상은 hex / scheme color 모두 ValueMapper.colorToFillObj 가 자동 판정."
4096
+ "doc": "셀 테두리 스타일을 설정한다. 생략한 속성은 유지되지 않고 기본값이 되므로, 일부만 바꾸려면 getBorderStyle() 반환값에 바꿀 속성을 덮어 함께 넘긴다. 셋을 모두 생략하면 아무것도 바꾸지 않는다. ALL 은 위/아래/왼쪽/오른쪽 4변만 설정한다 - 대각선은 포함하지 않는다. 색상은 hex / scheme color 모두 자동 판정."
3782
4097
  },
3783
4098
  {
3784
4099
  "name": "setBulletStyle",
3785
- "params": "bulletType: BulletType, subType?: NumberedType | CharType, startAt?: number, range?: { from: number; to: number }",
4100
+ "params": "bulletType: Exclude<BulletType, \"buBlip\">, subType?: NumberedType | CharType, startAt?: number, range?: TextRange",
3786
4101
  "ret": null,
3787
4102
  "array": false,
3788
- "doc": "글머리 기호 스타일을 설정한다."
4103
+ "doc": "글머리 기호 스타일을 설정한다. (getBulletStyle 대칭) 그림 글머리(BulletType.BLIP)는 적용을 지원하지 않는 조회 전용 유형이라 거부한다. CharType 프리셋 밖의 문자도 적용할 수 없다 (조회 전용이라 받을 인자가 없다)."
3789
4104
  },
3790
4105
  {
3791
4106
  "name": "setFill",
3792
- "params": "fill: Fill",
4107
+ "params": "fill: Fill & { type: \"solidFill\" }",
3793
4108
  "ret": null,
3794
4109
  "array": false,
3795
- "doc": "getFill() 이 반환한 채우기 객체를 그대로 적용한다. (getFill 대칭 — 셀 채우기 복사) 셀은 단색만 지원하므로 solid 만 적용하고 gradient/image/pattern/none 은 무시한다."
4110
+ "doc": "getFill() 이 반환한 채우기 객체를 그대로 적용한다. (getFill 대칭 — 셀 채우기 복사) 셀 채우기 설정은 단색만 지원한다 — getFill() 이 다른 타입(none/gradient 등)을 돌려준 셀의 값은 되넘길 수 없다."
3796
4111
  },
3797
4112
  {
3798
4113
  "name": "setFirstLineIndent",
3799
- "params": "firstLineIndent: number, range?: { from: number; to: number }",
4114
+ "params": "firstLineIndent: number, range?: TextRange",
3800
4115
  "ret": null,
3801
4116
  "array": false,
3802
- "doc": "단락 첫 줄의 들여쓰기(UI \"첫 줄\")를 설정한다. 둘째 줄부터는 marginLeft 를 따른다. 양수는 들여쓰기, 음수는 내어쓰기, 0 은 없음이다. (UI 의 없음/들여쓰기/내어쓰기 구분을 부호 하나로 표현한다) 글머리 기호 목록의 계층 깊이를 바꾸려는 것이면 setLevel 이다."
4117
+ "doc": "단락 첫 줄의 들여쓰기(UI \"첫 줄\")를 설정한다. 둘째 줄부터는 marginLeft 를 따른다. 양수는 들여쓰기, 음수는 내어쓰기, 0 은 들여쓰기 없음이다. 글머리 기호 목록의 계층 깊이를 바꾸려면 setLevel 을 사용한다."
3803
4118
  },
3804
4119
  {
3805
4120
  "name": "setFontFamily",
3806
- "params": "fontFamily: string, range?: { from: number; to: number }",
4121
+ "params": "fontFamily: string, range?: TextRange",
3807
4122
  "ret": null,
3808
4123
  "array": false,
3809
- "doc": "글꼴 설정."
4124
+ "doc": "글꼴을 설정한다."
3810
4125
  },
3811
4126
  {
3812
4127
  "name": "setFontSize",
3813
- "params": "fontSize: number, range?: { from: number; to: number }",
4128
+ "params": "fontSize: number, range?: TextRange",
3814
4129
  "ret": null,
3815
4130
  "array": false,
3816
- "doc": "글자 크기 설정."
4131
+ "doc": "글자 크기를 설정한다."
3817
4132
  },
3818
4133
  {
3819
4134
  "name": "setFontStyle",
3820
- "params": "style: FontStyle, range?: { from: number; to: number }",
4135
+ "params": "style: FontStyle, range?: TextRange",
3821
4136
  "ret": null,
3822
4137
  "array": false,
3823
4138
  "doc": "글꼴 스타일을 설정한다. 단일 속성은 setBold/setItalic/setFontSize/setFontFamily/setTextColor 사용 권장."
3824
4139
  },
3825
4140
  {
3826
4141
  "name": "setItalic",
3827
- "params": "enabled: boolean, range?: { from: number; to: number }",
4142
+ "params": "enabled: boolean, range?: TextRange",
3828
4143
  "ret": null,
3829
4144
  "array": false,
3830
- "doc": "글자 기울임 설정."
4145
+ "doc": "글자 기울임을 설정한다."
3831
4146
  },
3832
4147
  {
3833
4148
  "name": "setLevel",
3834
- "params": "level: number, range?: { from: number; to: number }",
4149
+ "params": "level: number, range?: TextRange",
3835
4150
  "ret": null,
3836
4151
  "array": false,
3837
- "doc": "목록 수준(개요 계층 깊이)을 설정한다. range 가 걸친 단락을 모두 같은 수준으로 맞춘다. pt 단위 들여쓰기(setFirstLineIndent/setMarginLeft)와 달리 수준은 상속 프리셋 선택이라, 바꾸면 그 수준의 글머리 기호와 글자 크기가 함께 따라온다. marginLeft 는 새 수준의 값으로 덮인다. setMarginLeft 로 지정한 값도 버려지므로 둘을 함께 쓸 때는 setLevel 을 먼저 호출한다. (firstLineIndent 는 유지된다) 대상 텍스트가 허용하는 범위(제목 개체는 1 단계뿐)로 clamp 한다."
4152
+ "doc": "목록 수준(개요 계층 깊이)을 설정한다. range 가 걸친 단락을 모두 같은 수준으로 맞춘다. pt 단위 들여쓰기(setFirstLineIndent/setMarginLeft)와 달리 수준은 상속 프리셋 선택이라, 바꾸면 그 수준의 글머리 기호·글자 크기가 따라오고 marginLeft 는 새 수준의 값으로 덮인다. setMarginLeft 로 지정한 값도 버려지므로 둘을 함께 쓸 때는 setLevel 을 먼저 호출한다. (firstLineIndent 는 유지) 대상 텍스트가 허용하는 범위(제목 개체는 1 수준뿐)로 제한한다."
3838
4153
  },
3839
4154
  {
3840
4155
  "name": "setLineSpacing",
3841
- "params": "lineSpacing: number, type?: LineSpacingType, range?: { from: number; to: number }",
4156
+ "params": "lineSpacing: number, type?: LineSpacingType, range?: TextRange",
3842
4157
  "ret": null,
3843
4158
  "array": false,
3844
- "doc": "줄 간격을 설정한다. range 를 주면 그 구간이 걸친 단락에만 적용한다. MULTIPLE 이면 \"100%\" 형태, EXACT 이면 pt 입력을 twip view 값으로 변환한다"
4159
+ "doc": "줄 간격을 설정한다. range 를 주면 그 구간이 걸친 단락에만 적용한다. lineSpacing 의 단위는 유형에 따라 다르다 - MULTIPLE 이면 배수 백분율(150=1.5배), EXACT 이면 pt 다."
3845
4160
  },
3846
4161
  {
3847
4162
  "name": "setMarginLeft",
3848
- "params": "marginLeft: number, range?: { from: number; to: number }",
4163
+ "params": "marginLeft: number, range?: TextRange",
3849
4164
  "ret": null,
3850
4165
  "array": false,
3851
- "doc": "단락 전체의 왼쪽 여백(UI \"텍스트 앞\")을 설정한다. 첫 줄만 밀려면 setFirstLineIndent 를 쓴다."
4166
+ "doc": "단락 전체의 왼쪽 여백(UI \"텍스트 앞\")을 설정한다. 첫 줄만 들여쓰려면 setFirstLineIndent 를 사용한다."
3852
4167
  },
3853
4168
  {
3854
4169
  "name": "setParagraphStyle",
3855
- "params": "style: ParagraphStyle, range?: { from: number; to: number }",
4170
+ "params": "style: ParagraphStyle, range?: TextRange",
3856
4171
  "ret": null,
3857
4172
  "array": false,
3858
- "doc": "단락 서식을 한 번에 설정한다. range 를 주면 그 구간이 걸친 단락에만 적용한다. 문단 모양 대화상자의 입력 항목과 1:1 로 대응하며, 대화상자와 같이 한 액션으로 적용해 실행 취소 단위가 하나다. 값을 준 속성만 바뀐다. null/undefined 는 \"변경 없음\"으로 무시하며, 지정한 값을 상속 상태로 되돌리는 방법은 아직 없다. 단일 속성은 setLineSpacing/setMarginLeft/setFirstLineIndent/setSpaceBefore/setSpaceAfter 사용 권장. 목록 수준은 부수 효과(글머리 기호·글자 크기)가 달라 여기 담지 않는다. (setLevel 참고) alignH 만 별도 액션(setAlignH)으로 나가므로 다른 속성과 함께 주면 실행 취소 단위가 2개로 나뉜다."
4173
+ "doc": "단락 서식을 한 번에 설정한다. range 를 주면 그 구간이 걸친 단락에만 적용한다. 값을 준 속성만 바뀐다. null/undefined 는 \"변경 없음\"으로 무시하며, 지정한 값을 상속 상태로 되돌리는 방법은 아직 없다. 단일 속성은 setLineSpacing/setMarginLeft/setFirstLineIndent/setSpaceBefore/setSpaceAfter 사용 권장. 목록 수준은 바꿀 때 딸려오는 부수 효과(글머리 기호·글자 크기)가 있어 여기 담지 않는다. (setLevel 참고)"
3859
4174
  },
3860
4175
  {
3861
4176
  "name": "setSolidFill",
@@ -3866,28 +4181,28 @@
3866
4181
  },
3867
4182
  {
3868
4183
  "name": "setSpaceAfter",
3869
- "params": "spaceAfter: number, range?: { from: number; to: number }",
4184
+ "params": "spaceAfter: number, range?: TextRange",
3870
4185
  "ret": null,
3871
4186
  "array": false,
3872
4187
  "doc": "단락 뒤 간격(UI \"문단 아래\")을 설정한다."
3873
4188
  },
3874
4189
  {
3875
4190
  "name": "setSpaceBefore",
3876
- "params": "spaceBefore: number, range?: { from: number; to: number }",
4191
+ "params": "spaceBefore: number, range?: TextRange",
3877
4192
  "ret": null,
3878
4193
  "array": false,
3879
4194
  "doc": "단락 앞 간격(UI \"문단 위\")을 설정한다."
3880
4195
  },
3881
4196
  {
3882
4197
  "name": "setStrike",
3883
- "params": "strike: Strike, range?: { from: number; to: number }",
4198
+ "params": "strike: Strike, range?: TextRange",
3884
4199
  "ret": null,
3885
4200
  "array": false,
3886
- "doc": "글자 취소선 설정."
4201
+ "doc": "글자 취소선을 설정한다."
3887
4202
  },
3888
4203
  {
3889
4204
  "name": "setText",
3890
- "params": "text: string, range?: { from: number; to: number }",
4205
+ "params": "text: string, range?: TextRange",
3891
4206
  "ret": null,
3892
4207
  "array": false,
3893
4208
  "doc": "텍스트를 설정한다. 인자 조합에 따라 다음과 같이 동작한다. - range 없음: 전체 텍스트를 text 로 교체 - range 있음: 지정한 구간만 text 로 교체 - text 가 빈 문자열(\"\")이면 교체 대신 해당 범위를 삭제"
@@ -3897,28 +4212,28 @@
3897
4212
  "params": "autoAlignType: AutoFitType",
3898
4213
  "ret": null,
3899
4214
  "array": false,
3900
- "doc": "텍스트 상자 자동 맞춤 유형을 설정한다."
4215
+ "doc": "텍스트 상자 자동 맞춤 유형을 설정한다. 이미 같은 유형이면 아무것도 하지 않는다."
3901
4216
  },
3902
4217
  {
3903
4218
  "name": "setTextColor",
3904
- "params": "color: string, range?: { from: number; to: number }",
4219
+ "params": "color: string, range?: TextRange",
3905
4220
  "ret": null,
3906
4221
  "array": false,
3907
- "doc": "글자 색상 설정."
4222
+ "doc": "글자 색상을 설정한다."
3908
4223
  },
3909
4224
  {
3910
4225
  "name": "setTextHyperlink",
3911
- "params": "hyperlink: Hyperlink, range?: { from: number; to: number }",
4226
+ "params": "hyperlink: Hyperlink, range?: TextRange",
3912
4227
  "ret": null,
3913
4228
  "array": false,
3914
- "doc": "텍스트에 하이퍼링크를 설정한다. (getTextHyperlink 대칭 — 반환 객체를 그대로 넘겨 링크를 복사할 수 있다) 도형 전체에 링크를 거는 setHyperlink 와 달리 글자(run)에 걸려 하이퍼링크 서식으로 표시된다. other(program/macro/ole 등)와 유효하지 않은 대상(없는 슬라이드 id·ShowJumpType 밖의 값)은 무시한다."
4229
+ "doc": "텍스트에 하이퍼링크를 설정한다. (getTextHyperlink 대칭 — 반환 객체를 그대로 넘겨 링크를 복사할 수 있다) 도형 전체에 링크를 거는 setHyperlink 와 달리 링크가 글자(run) 단위로 걸리며 하이퍼링크 서식으로 표시된다. 지원하지 않는 종류나 유효하지 않은 대상(없는 슬라이드 id 등)은 무시한다."
3915
4230
  },
3916
4231
  {
3917
4232
  "name": "setUnderline",
3918
- "params": "underline: Underline, range?: { from: number; to: number }",
4233
+ "params": "underline: Underline, range?: TextRange",
3919
4234
  "ret": null,
3920
4235
  "array": false,
3921
- "doc": "글자 밑줄 설정."
4236
+ "doc": "글자 밑줄을 설정한다."
3922
4237
  }
3923
4238
  ],
3924
4239
  "Comment": [
@@ -4510,14 +4825,6 @@
4510
4825
  "WORDART_VERTICAL": "wordArtVert",
4511
4826
  "MONGOLIAN_VERTICAL": "mongolianVert"
4512
4827
  },
4513
- "TextMode": {
4514
- "REPLACE": "replace",
4515
- "APPEND": "append"
4516
- },
4517
- "MoveMode": {
4518
- "ABSOLUTE": "absolute",
4519
- "RELATIVE": "relative"
4520
- },
4521
4828
  "TextAlignV": {
4522
4829
  "TOP": 0,
4523
4830
  "MIDDLE": 1,
@@ -6330,7 +6637,7 @@
6330
6637
  "params": "options: { x?: number; y?: number; relativeFromH?: PositionRelativeFromH; relativeFromV?: PositionRelativeFromV; anchorParagraphId?: string }",
6331
6638
  "ret": null,
6332
6639
  "array": false,
6333
- "doc": "Changes the position of a shape placed in front of or behind text. - x and y are px coordinates relative to relativeFromH and relativeFromV; unspecified fields are kept. - A reference point must be given together with its coordinate, because changing the reference point changes the meaning of the coordinate. - If anchorParagraphId is given, the shape moves to that paragraph; otherwise only the position within the current paragraph changes."
6640
+ "doc": "Changes the position of a shape placed in front of or behind text. - x and y are pt coordinates relative to relativeFromH and relativeFromV; unspecified fields are kept. - A reference point must be given together with its coordinate, because changing the reference point changes the meaning of the coordinate. - If anchorParagraphId is given, the shape moves to that paragraph; otherwise only the position within the current paragraph changes."
6334
6641
  },
6335
6642
  {
6336
6643
  "name": "removeHyperlink",
@@ -6461,7 +6768,7 @@
6461
6768
  "params": "options: { x?: number; y?: number; relativeFromH?: PositionRelativeFromH; relativeFromV?: PositionRelativeFromV; anchorParagraphId?: string }",
6462
6769
  "ret": null,
6463
6770
  "array": false,
6464
- "doc": "Changes the position of a shape placed in front of or behind text. - x and y are px coordinates relative to relativeFromH and relativeFromV; unspecified fields are kept. - A reference point must be given together with its coordinate, because changing the reference point changes the meaning of the coordinate. - If anchorParagraphId is given, the shape moves to that paragraph; otherwise only the position within the current paragraph changes."
6771
+ "doc": "Changes the position of a shape placed in front of or behind text. - x and y are pt coordinates relative to relativeFromH and relativeFromV; unspecified fields are kept. - A reference point must be given together with its coordinate, because changing the reference point changes the meaning of the coordinate. - If anchorParagraphId is given, the shape moves to that paragraph; otherwise only the position within the current paragraph changes."
6465
6772
  },
6466
6773
  {
6467
6774
  "name": "removeHyperlink",