Barranca/resize api additions

gatsby-config.js

@@ -246,6 +246,10 @@ module.exports = {
                     title: "ReadOnlyItemList",
                     path: "references/document-sandbox/document-apis/classes/ReadOnlyItemList.md",
                   },
+                  {
+                    title: "ReadOnlyMask",
+                    path: "references/document-sandbox/document-apis/classes/ReadOnlyMask.md",
+                  },
                   {
                     title: "RectangleNode",
                     path: "references/document-sandbox/document-apis/classes/RectangleNode.md",
@@ -332,10 +336,10 @@ module.exports = {
                     title: "BaseParagraphStyles",
                     path: "references/document-sandbox/document-apis/interfaces/BaseParagraphStyles.md",
                   },
-                  {
-                    title: "BitmapImage",
-                    path: "references/document-sandbox/document-apis/interfaces/BitmapImage.md",
-                  },
+                  // {
+                  //   title: "BitmapImage",
+                  //   path: "references/document-sandbox/document-apis/interfaces/BitmapImage.md",
+                  // },
                   {
                     title: "CharacterStyles",
                     path: "references/document-sandbox/document-apis/interfaces/CharacterStyles.md",
@@ -360,6 +364,10 @@ module.exports = {
                     title: "ColorFill",
                     path: "references/document-sandbox/document-apis/interfaces/ColorFill.md",
                   },
+                  {
+                    title: "CommonResizeOptions",
+                    path: "references/document-sandbox/document-apis/interfaces/CommonResizeOptions.md",
+                  },
                   {
                     title: "ContainerNode",
                     path: "references/document-sandbox/document-apis/interfaces/ContainerNode.md",
@@ -376,6 +384,14 @@ module.exports = {
                     title: "IFillableNode",
                     path: "references/document-sandbox/document-apis/interfaces/IFillableNode.md",
                   },
+                  {
+                    title: "IMediaContainerNode",
+                    path: "references/document-sandbox/document-apis/interfaces/IMediaContainerNode.md",
+                  },
+                  {
+                    title: "INodeBounds",
+                    path: "references/document-sandbox/document-apis/interfaces/INodeBounds.md",
+                  },
                   {
                     title: "IRectangularNode",
                     path: "references/document-sandbox/document-apis/interfaces/IRectangularNode.md",
@@ -384,6 +400,10 @@ module.exports = {
                     title: "IStrokableNode",
                     path: "references/document-sandbox/document-apis/interfaces/IStrokableNode.md",
                   },
+                  {
+                    title: "IVisualNodeBounds",
+                    path: "references/document-sandbox/document-apis/interfaces/IVisualNodeBounds.md",
+                  },
                   {
                     title: "ListItem",
                     path: "references/document-sandbox/document-apis/interfaces/ListItem.md",
@@ -420,6 +440,30 @@ module.exports = {
                     title: "RectangleGeometry",
                     path: "references/document-sandbox/document-apis/interfaces/RectangleGeometry.md",
                   },
+                  {
+                    title: "RemoveListStyleInput",
+                    path: "references/document-sandbox/document-apis/interfaces/RemoveListStyleInput.md",
+                  },
+                  {
+                    title: "RescaleProportionalToHeightOptions",
+                    path: "references/document-sandbox/document-apis/interfaces/RescaleProportionalToHeightOptions.md",
+                  },
+                  {
+                    title: "RescaleProportionalToWidthOptions",
+                    path: "references/document-sandbox/document-apis/interfaces/RescaleProportionalToWidthOptions.md",
+                  },
+                  {
+                    title: "ResizeUsingHeightOptions",
+                    path: "references/document-sandbox/document-apis/interfaces/ResizeUsingHeightOptions.md",
+                  },
+                  {
+                    title: "ResizeUsingWidthOptions",
+                    path: "references/document-sandbox/document-apis/interfaces/ResizeUsingWidthOptions.md",
+                  },
+                  {
+                    title: "SolidColorStroke",
+                    path: "references/document-sandbox/document-apis/interfaces/SolidColorStroke.md",
+                  },
                   {
                     title: "Stroke",
                     path: "references/document-sandbox/document-apis/interfaces/Stroke.md",
@@ -466,6 +510,10 @@ module.exports = {
                     title: "FillType",
                     path: "references/document-sandbox/document-apis/enumerations/FillType.md",
                   },
+                  {
+                    title: "ResizeBehavior",
+                    path: "references/document-sandbox/document-apis/enumerations/ResizeBehavior.md",
+                  },
                   {
                     title: "OrderedListNumbering",
                     path: "references/document-sandbox/document-apis/namespaces/Constants/enumerations/OrderedListNumbering.md",
@@ -498,6 +546,10 @@ module.exports = {
                     title: "TextScriptStyle",
                     path: "references/document-sandbox/document-apis/enumerations/TextScriptStyle.md",
                   },
+                  {
+                    title: "TextStyleSource",
+                    path: "references/document-sandbox/document-apis/namespaces/Constants/enumerations/TextStyleSource.md",
+                  },
                   {
                     title: "VisualEffectType",
                     path: "references/document-sandbox/document-apis/enumerations/VisualEffectType.md",
@@ -520,10 +572,18 @@ module.exports = {
                     title: "Font",
                     path: "references/document-sandbox/document-apis/type-aliases/Font.md",
                   },
+                  {
+                    title: "ListStyleInput",
+                    path: "references/document-sandbox/document-apis/type-aliases/ListStyleInput.md",
+                  },
                   {
                     title: "OrderedListStyle",
                     path: "references/document-sandbox/document-apis/type-aliases/OrderedListStyle.md",
                   },
+                  {
+                    title: "ResizeOptions",
+                    path: "references/document-sandbox/document-apis/type-aliases/ResizeOptions.md",
+                  },
                   {
                     title: "SolidColorStrokeWithOptionalType",
                     path: "references/document-sandbox/document-apis/type-aliases/SolidColorStrokeWithOptionalType.md",
@@ -738,10 +798,10 @@ module.exports = {
                     title: "Group Elements",
                     path: "guides/learn/how_to/group_elements.md",
                   },
-                  // {
-                  //   title: "Resize & Rescale Elements",
-                  //   path: "guides/learn/how_to/resize_rescale_elements.md",
-                  // },
+                  {
+                    title: "Resize Elements",
+                    path: "guides/learn/how_to/resize_elements.md",
+                  },
                   {
                     title: "Position Elements",
                     path: "guides/learn/how_to/position_elements.md",

src/pages/guides/getting_started/changelog.md

@@ -45,6 +45,7 @@ contributors:
 
 - **Major restructure** of the [Add-on UI SDK Constants Reference](../../references/addonsdk/addonsdk-constants.md).
 - Improved content and metadata for SEO and AI assistant optimization.
+- **Breaking change:** Removed experimental resize/rescale methods (`rescaleProportionalToWidth()`, `rescaleProportionalToHeight()`, `resizeToFitWithin()`, `resizeToCover()`) and replaced with unified **experimental** [`resize()`](../../references/document-sandbox/document-apis/classes/Node.md#resize) method offering more flexible behavior control via [`ResizeBehavior`](../../references/document-sandbox/document-apis/enumerations/ResizeBehavior.md) options. The [`experimentalApis`](../../references/manifest/index.md#requirements) flag is required.
 
 ## 2025-12-28
 
@@ -98,15 +99,6 @@ The Adobe Express Code Playground has received a major update with the release o
 
 ### Added
 
-- **Experimental** [`rescaleProportionalToHeight()`](../../references/document-sandbox/document-apis/classes/Node.md#rescaleproportionaltoheight) method - Proportional height scaling for all node types
-- **Experimental** [`rescaleProportionalToWidth()`](../../references/document-sandbox/document-apis/classes/Node.md#rescaleproportionaltowidth) method - Proportional width scaling for all node types
-- **Experimental** [`resizeToCover()`](../../references/document-sandbox/document-apis/classes/Node.md#resizetocover) method - Resize nodes to cover specified dimensions
-- **Experimental** [`resizeToFitWithin()`](../../references/document-sandbox/document-apis/classes/Node.md#resizetofitwithin) method - Resize nodes to fit within specified dimensions
-- **Experimental** [`appendText()`](../../references/document-sandbox/document-apis/classes/TextContentModel.md#appendtext) method - Append text to existing content
-- **Experimental** [`deleteText()`](../../references/document-sandbox/document-apis/classes/TextContentModel.md#deletetext) method - Delete text ranges from content
-- **Experimental** [`insertText()`](../../references/document-sandbox/document-apis/classes/TextContentModel.md#inserttext) method - Insert text at specific positions
-- **Experimental** [`replaceText()`](../../references/document-sandbox/document-apis/classes/TextContentModel.md#replacetext) method - Replace text ranges with new content
-- **Experimental** [`hasUnavailableFonts()`](../../references/document-sandbox/document-apis/classes/TextContentModel.md#hasunavailablefonts) method - Check for unavailable fonts in text content
 - **Experimental** [`id`](../../references/document-sandbox/document-apis/classes/TextContentModel.md#id) property - Unique identifier for text content models
 - **Experimental** [`TextStyleSource`](../../references/document-sandbox/document-apis/namespaces/Constants/enumerations/TextStyleSource.md) enumeration - Options for text style source matching
 
@@ -240,7 +232,7 @@ With MCP-enabled IDEs (Cursor, Claude Desktop, VS Code etc.), developers can [co
 ### Added
 
 - New [Markdown Parser add-on tutorial](../learn/how_to/tutorials/markdown-parser-text-api.md) covering the Text API, while building from scratch an add-on capable of parsing Markdown files and converting them into rich text directly within an Adobe Express document.
-- New [Resize and Rescale Elements](../learn/how_to/resize_rescale_elements.md) how-to guide, which covers the new Resize/Rescale APIs, and provides examples and code snippets.
+- New [Resize and Rescale Elements](../learn/how_to/resize_elements.md) how-to guide, which covers the new Resize/Rescale APIs, and provides examples and code snippets.
 
 ## 2025-06-19
 
@@ -259,10 +251,10 @@ The [Page Metadata API](../../references/addonsdk/app-document.md#pagemetadata)
 ### Added
 
 - Four new Resize/Rescale APIs have been added to the [Node](../../references/document-sandbox/document-apis/classes/Node.md) class as experimental features:
-  - [`rescaleProportionalToHeight()`](../../references/document-sandbox/document-apis/classes/Node.md#rescaleproportionaltoheight)
-  - [`rescaleProportionalToWidth()`](../../references/document-sandbox/document-apis/classes/Node.md#rescaleproportionaltowidth)
-  - [`resizeToCover()`](../../references/document-sandbox/document-apis/classes/Node.md#resizetocover)
-  - [`resizeToFitWithin()`](../../references/document-sandbox/document-apis/classes/Node.md#resizetofitwithin)
+  - `rescaleProportionalToHeight()`
+  - `rescaleProportionalToWidth()`
+  - `resizeToCover()`
+  - `resizeToFitWithin()`
 - [`Editor.createText()`](../../references/document-sandbox/document-apis/classes/Editor.md#createtext) now accepts a String parameter, which sets the text content of the new node. The use without a parameter is deprecated.
 - [`TextNode`](../../references/document-sandbox/document-apis/classes/TextNode.md) is now an abstract base class with two specialized subclasses:
   - [StandaloneTextNode](../../references/document-sandbox/document-apis/classes/StandaloneTextNode.md): displays text in a single frame.