OfficeDev · ElizabethSamuel-MSFT · Sep 19, 2024 · Sep 19, 2024
diff --git a/docs/docs-ref-autogen/powerpoint/powerpoint/powerpoint.connectortype.yml b/docs/docs-ref-autogen/powerpoint/powerpoint/powerpoint.connectortype.yml
@@ -24,11 +24,11 @@ remarks: >-
   // start and end points. Then it names the shape.
 
   await PowerPoint.run(async (context) => {
-    const shapes = context.presentation.slides.getItemAt(0).shapes;
+    const shapes: PowerPoint.ShapeCollection = context.presentation.slides.getItemAt(0).shapes;
 
     // For a line, left and top are the coordinates of the start point,
     // while height and width are the coordinates of the end point.
-    const line = shapes.addLine(PowerPoint.ConnectorType.straight, 
+    const line: PowerPoint.Shape = shapes.addLine(PowerPoint.ConnectorType.straight, 
         { 
           left: 400, 
           top: 200, 

diff --git a/docs/docs-ref-autogen/powerpoint/powerpoint/powerpoint.geometricshapetype.yml b/docs/docs-ref-autogen/powerpoint/powerpoint/powerpoint.geometricshapetype.yml
@@ -24,14 +24,14 @@ remarks: >-
   // location and size. Then it names the shape.
 
   await PowerPoint.run(async (context) => {
-    const shapes = context.presentation.slides.getItemAt(0).shapes;
-    const hexagon = shapes.addGeometricShape(PowerPoint.GeometricShapeType.hexagon, 
-        {
-          left: 100,
-          top: 100,
-          height: 150,
-          width: 150
-        });
+    const shapes: PowerPoint.ShapeCollection = context.presentation.slides.getItemAt(0).shapes;
+    const shapeOptions: PowerPoint.ShapeAddOptions = {
+      left: 100,
+      top: 100,
+      height: 150,
+      width: 150
+    };
+    const hexagon: PowerPoint.Shape = shapes.addGeometricShape(PowerPoint.GeometricShapeType.hexagon, shapeOptions);
     hexagon.name = "Hexagon";
 
     await context.sync();

diff --git a/docs/docs-ref-autogen/powerpoint/powerpoint/powerpoint.insertslideformatting.yml b/docs/docs-ref-autogen/powerpoint/powerpoint/powerpoint.insertslideformatting.yml
@@ -19,8 +19,8 @@ remarks: >-
 
   await PowerPoint.run(async function(context) {
       // Get the ID of the first selected slide.
-      const presentation = context.presentation;
-      const selected = presentation.getSelectedSlides().getItemAt(0);
+      const presentation: PowerPoint.Presentation = context.presentation;
+      const selected: PowerPoint.Slide = presentation.getSelectedSlides().getItemAt(0);
       selected.load("id");
       await context.sync();
 

diff --git a/docs/docs-ref-autogen/powerpoint/powerpoint/powerpoint.insertslideoptions.yml b/docs/docs-ref-autogen/powerpoint/powerpoint/powerpoint.insertslideoptions.yml
@@ -19,8 +19,8 @@ remarks: >-
 
   await PowerPoint.run(async function(context) {
       // Get the ID of the first selected slide.
-      const presentation = context.presentation;
-      const selected = presentation.getSelectedSlides().getItemAt(0);
+      const presentation: PowerPoint.Presentation = context.presentation;
+      const selected: PowerPoint.Slide = presentation.getSelectedSlides().getItemAt(0);
       selected.load("id");
       await context.sync();
 

diff --git a/docs/docs-ref-autogen/powerpoint/powerpoint/powerpoint.presentation.yml b/docs/docs-ref-autogen/powerpoint/powerpoint/powerpoint.presentation.yml
@@ -19,8 +19,8 @@ remarks: >-
 
   await PowerPoint.run(async function(context) {
       // Get the ID of the first selected slide.
-      const presentation = context.presentation;
-      const selected = presentation.getSelectedSlides().getItemAt(0);
+      const presentation: PowerPoint.Presentation = context.presentation;
+      const selected: PowerPoint.Slide = presentation.getSelectedSlides().getItemAt(0);
       selected.load("id");
       await context.sync();
 
@@ -150,7 +150,7 @@ methods:
       // Arranges the selected shapes in a line from left to right.
 
       await PowerPoint.run(async (context) => {
-        const shapes = context.presentation.getSelectedShapes();
+        const shapes: PowerPoint.ShapeScopedCollection = context.presentation.getSelectedShapes();
         const shapeCount = shapes.getCount();
         shapes.load("items");
         await context.sync();
@@ -178,7 +178,7 @@ methods:
 
       await PowerPoint.run(async (context) => {
         let finalTable = "";
-        const shapes = context.presentation.getSelectedShapes();
+        const shapes: PowerPoint.ShapeScopedCollection = context.presentation.getSelectedShapes();
         const shapeCount = shapes.getCount();
         await context.sync();
         finalTable += "<br>getSelectedShapes.getCount returned:<b>" + shapeCount.value + "</b><br>";
@@ -203,15 +203,15 @@ methods:
       await PowerPoint.run(async (context) => {
         context.presentation.load("slides");
         await context.sync();
-        const slides = context.presentation.getSelectedSlides();
+        const slides: PowerPoint.SlideScopedCollection = context.presentation.getSelectedSlides();
         const slideCount = slides.getCount();
         slides.load("items");
         await context.sync();
         savedSlideSelection = [];
         slides.items.map((slide) => {
           savedSlideSelection.push(slide.id);
         });
-        const shapes = context.presentation.getSelectedShapes();
+        const shapes: PowerPoint.ShapeScopedCollection = context.presentation.getSelectedShapes();
         const shapeCount = shapes.getCount();
         shapes.load("items");
         await context.sync();
@@ -258,15 +258,15 @@ methods:
         const allSlidesCount = context.presentation.slides.getCount();
         context.presentation.slides.load("items");
         await context.sync();
-        let allSlideItems = context.presentation.slides.items;
+        let allSlideItems: PowerPoint.Slide[] = context.presentation.slides.items;
         allSlideItems.map((slide, index) => {
           allSlidesList[slide.id] = `Slide ${index + 1}`;
         });
 
         if ($("#id-check-usenative").is(":checked")) {
           context.presentation.load("tags");
         }
-        const slides = context.presentation.getSelectedSlides();
+        const slides: PowerPoint.SlideScopedCollection = context.presentation.getSelectedSlides();
         const slideCount = slides.getCount();
         slides.load("items");
         await context.sync();
@@ -291,7 +291,7 @@ methods:
         let finalTable = "";
         context.presentation.load("slides");
         await context.sync();
-        const slides = context.presentation.getSelectedSlides();
+        const slides: PowerPoint.SlideScopedCollection = context.presentation.getSelectedSlides();
         const slideCount = slides.getCount();
         await context.sync();
         finalTable += "<br>getSelectedSlides.getCount returned:<b>" + slideCount.value + "</b><br>";
@@ -340,7 +340,7 @@ methods:
       // Gets the selected text range and prints data about the range on the task pane.
 
       await PowerPoint.run(async (context) => {
-        const textRange = context.presentation.getSelectedTextRange();
+        const textRange: PowerPoint.TextRange = context.presentation.getSelectedTextRange();
         try {
           await context.sync();
         } catch (error) {
@@ -379,9 +379,9 @@ methods:
       // Sets the range selection to the range that was saved previously.
 
       await PowerPoint.run(async (context) => {
-        const slide1 = context.presentation.slides.getItem(savedTextSlideSelection[0]);
-        const shape1 = slide1.shapes.getItem(savedTextShapeSelection[0]);
-        const textRange = shape1.textFrame.textRange.getSubstring(savedTextTextRangeStart, savedTextTextRangeLength);
+        const slide1: PowerPoint.Slide = context.presentation.slides.getItem(savedTextSlideSelection[0]);
+        const shape1: PowerPoint.Shape = slide1.shapes.getItem(savedTextShapeSelection[0]);
+        const textRange: PowerPoint.TextRange = shape1.textFrame.textRange.getSubstring(savedTextTextRangeStart, savedTextTextRangeLength);
         textRange.setSelected();
         await context.sync();
       });
@@ -429,8 +429,8 @@ methods:
 
       await PowerPoint.run(async function(context) {
           // Get the ID of the first selected slide.
-          const presentation = context.presentation;
-          const selected = presentation.getSelectedSlides().getItemAt(0);
+          const presentation: PowerPoint.Presentation = context.presentation;
+          const selected: PowerPoint.Slide = presentation.getSelectedSlides().getItemAt(0);
           selected.load("id");
           await context.sync();
 
@@ -563,9 +563,9 @@ methods:
       await PowerPoint.run(async (context) => {
         context.presentation.load("slides");
         await context.sync();
-        const slide2 = context.presentation.slides.getItemAt(1);
-        const slide4 = context.presentation.slides.getItemAt(3);
-        const slide5 = context.presentation.slides.getItemAt(4);
+        const slide2: PowerPoint.Slide = context.presentation.slides.getItemAt(1);
+        const slide4: PowerPoint.Slide = context.presentation.slides.getItemAt(3);
+        const slide5: PowerPoint.Slide = context.presentation.slides.getItemAt(4);
         slide2.load("id");
         slide4.load("id");
         slide5.load("id");

diff --git a/docs/docs-ref-autogen/powerpoint/powerpoint/powerpoint.shape.yml b/docs/docs-ref-autogen/powerpoint/powerpoint/powerpoint.shape.yml
@@ -21,7 +21,7 @@ remarks: >-
 
   await PowerPoint.run(async (context) => {
     // Get the type of shape for every shape in the collection.
-    const shapes = context.presentation.slides.getItemAt(0).shapes;
+    const shapes: PowerPoint.ShapeCollection = context.presentation.slides.getItemAt(0).shapes;
     shapes.load("type");
     await context.sync();
 
@@ -88,7 +88,7 @@ properties:
       // Changes the selected shapes fill color to red.
 
       await PowerPoint.run(async (context) => {
-        const shapes = context.presentation.getSelectedShapes();
+        const shapes: PowerPoint.ShapeScopedCollection = context.presentation.getSelectedShapes();
         const shapeCount = shapes.getCount();
         shapes.load("items");
         await context.sync();
@@ -128,7 +128,7 @@ properties:
       // Arranges the selected shapes in a line from left to right.
 
       await PowerPoint.run(async (context) => {
-        const shapes = context.presentation.getSelectedShapes();
+        const shapes: PowerPoint.ShapeScopedCollection = context.presentation.getSelectedShapes();
         const shapeCount = shapes.getCount();
         shapes.load("items");
         await context.sync();
@@ -188,7 +188,7 @@ properties:
       // Arranges the selected shapes in a line from left to right.
 
       await PowerPoint.run(async (context) => {
-        const shapes = context.presentation.getSelectedShapes();
+        const shapes: PowerPoint.ShapeScopedCollection = context.presentation.getSelectedShapes();
         const shapeCount = shapes.getCount();
         shapes.load("items");
         await context.sync();
@@ -284,7 +284,7 @@ properties:
       // Arranges the selected shapes in a line from left to right.
 
       await PowerPoint.run(async (context) => {
-        const shapes = context.presentation.getSelectedShapes();
+        const shapes: PowerPoint.ShapeScopedCollection = context.presentation.getSelectedShapes();
         const shapeCount = shapes.getCount();
         shapes.load("items");
         await context.sync();
@@ -333,7 +333,7 @@ properties:
 
       await PowerPoint.run(async (context) => {
         // Get the type of shape for every shape in the collection.
-        const shapes = context.presentation.slides.getItemAt(0).shapes;
+        const shapes: PowerPoint.ShapeCollection = context.presentation.slides.getItemAt(0).shapes;
         shapes.load("type");
         await context.sync();
 
@@ -378,7 +378,7 @@ properties:
       // Arranges the selected shapes in a line from left to right.
 
       await PowerPoint.run(async (context) => {
-        const shapes = context.presentation.getSelectedShapes();
+        const shapes: PowerPoint.ShapeScopedCollection = context.presentation.getSelectedShapes();
         const shapeCount = shapes.getCount();
         shapes.load("items");
         await context.sync();
@@ -411,7 +411,38 @@ methods:
     package: powerpoint!
     fullName: delete()
     summary: Deletes the shape from the shape collection. Does nothing if the shape does not exist.
-    remarks: '\[ [API set: PowerPointApi 1.3](/javascript/api/requirement-sets/powerpoint/powerpoint-api-requirement-sets) \]'
+    remarks: >-
+      \[ [API set: PowerPointApi 1.3](/javascript/api/requirement-sets/powerpoint/powerpoint-api-requirement-sets) \]
+
+
+      #### Examples
+
+
+      ```TypeScript
+
+      // Link to full sample:
+      https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/shapes/shapes.yaml
+
+
+      // This function gets the collection of shapes on the first slide,
+
+      // and then iterates through them, deleting each one.
+
+      await PowerPoint.run(async (context) => {
+        const slide: PowerPoint.Slide = context.presentation.slides.getItemAt(0);
+        const shapes: PowerPoint.ShapeCollection = slide.shapes;
+
+        // Load all the shapes in the collection without loading their properties.
+        shapes.load("items/$none");
+
+        await context.sync();
+
+        shapes.items.forEach((shape) => shape.delete());
+
+        await context.sync();
+      });
+
+      ```
     isPreview: false
     isDeprecated: false
     syntax:

diff --git a/docs/docs-ref-autogen/powerpoint/powerpoint/powerpoint.shapeaddoptions.yml b/docs/docs-ref-autogen/powerpoint/powerpoint/powerpoint.shapeaddoptions.yml
@@ -4,7 +4,40 @@ uid: 'powerpoint!PowerPoint.ShapeAddOptions:interface'
 package: powerpoint!
 fullName: PowerPoint.ShapeAddOptions
 summary: Represents the available options when adding shapes.
-remarks: '\[ [API set: PowerPointApi 1.4](/javascript/api/requirement-sets/powerpoint/powerpoint-api-requirement-sets) \]'
+remarks: >-
+  \[ [API set: PowerPointApi 1.4](/javascript/api/requirement-sets/powerpoint/powerpoint-api-requirement-sets) \]
+
+
+  #### Examples
+
+
+  ```TypeScript
+
+  // Link to full sample:
+  https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/shapes/shapes.yaml
+
+
+  // This function gets the collection of shapes on the first slide,
+
+  // and adds a hexagon shape to the collection, while specifying its
+
+  // location and size. Then it names the shape.
+
+  await PowerPoint.run(async (context) => {
+    const shapes: PowerPoint.ShapeCollection = context.presentation.slides.getItemAt(0).shapes;
+    const shapeOptions: PowerPoint.ShapeAddOptions = {
+      left: 100,
+      top: 100,
+      height: 150,
+      width: 150
+    };
+    const hexagon: PowerPoint.Shape = shapes.addGeometricShape(PowerPoint.GeometricShapeType.hexagon, shapeOptions);
+    hexagon.name = "Hexagon";
+
+    await context.sync();
+  });
+
+  ```
 isPreview: false
 isDeprecated: false
 type: interface