@mcpher/gas-fakes 2.5.4 → 2.5.6

package/.claspignore

@@ -3,4 +3,4 @@ run.js
 node_modules/
 package.json
 package-lock.json
-.gemini/gasmess/
+

package/README.md

@@ -157,7 +157,33 @@ For pushing modified files back to the Apps Script IDE, use the built-in `gas-fa
 
 As I mentioned earlier, to take this further, I'm going to need a lot of help to extend the methods and services supported - so if you feel this would be useful to you, and would like to collaborate, please ping me on bruce@mcpher.com and we'll talk.
 
-## <img src="../pngs/logo.png" alt="gas-fakes logo" width="50" align="top"> Further Reading
+# Gas-Fakes Progress Summary
+
+| Service | Classes | Methods | Completed | In Progress | Not Started |
+|---|---|---|---|---|---|
+| [Base](./progress/base.md) | 17 | 127 | 93 | 2 | 32 |
+| [Cache](./progress/cache.md) | 2 | 11 | 7 | 4 | 0 |
+| [Calendar](./progress/calendar.md) | 13 | 273 | 273 | 0 | 0 |
+| [Charts](./progress/charts.md) | 29 | 238 | 37 | 0 | 201 |
+| [Content](./progress/content.md) | 3 | 16 | 16 | 0 | 0 |
+| [Document](./progress/document.md) | 47 | 1032 | 880 | 12 | 140 |
+| [Drive](./progress/drive.md) | 8 | 164 | 124 | 8 | 32 |
+| [Forms](./progress/forms.md) | 41 | 504 | 266 | 0 | 238 |
+| [Gmail](./progress/gmail.md) | 6 | 168 | 167 | 0 | 1 |
+| [HTML](./progress/html.md) | 6 | 39 | 34 | 0 | 5 |
+| [JDBC](./progress/jdbc.md) | 20 | 753 | 311 | 0 | 442 |
+| [Lock](./progress/lock.md) | 2 | 7 | 7 | 0 | 0 |
+| [Mail](./progress/mail.md) | 1 | 5 | 0 | 0 | 5 |
+| [Properties](./progress/properties.md) | 4 | 11 | 6 | 5 | 0 |
+| [Script](./progress/script.md) | 16 | 84 | 22 | 0 | 62 |
+| [Slides](./progress/slides.md) | 76 | 1288 | 1005 | 0 | 283 |
+| [Spreadsheet](./progress/spreadsheet.md) | 108 | 1771 | 1301 | 19 | 451 |
+| [URL Fetch](./progress/urlfetch.md) | 2 | 13 | 12 | 0 | 1 |
+| [Utilities](./progress/utilities.md) | 5 | 59 | 59 | 0 | 0 |
+| [XML](./progress/xml.md) | 14 | 149 | 142 | 0 | 7 |
+| **Total** | **420** | **6712** | **4762** | **50** | **1900** |
+
+## <img src="./pngs/logo.png" alt="gas-fakes logo" width="50" align="top"> Further Reading
 
 
 

package/exgcp.sh

@@ -0,0 +1,63 @@
+#!/bin/bash
+
+# This script reads the GCP_PROJECT_ID from a .env file
+# and exports it as GOOGLE_CLOUD_PROJECT for the current shell session.
+#
+# Usage: source . ./exgcp.sh
+
+# Define the path to your .env file relative to the script's location
+ENV_FILE="./.env"
+
+# Check if the .env file exists
+
+if [ ! -f "$ENV_FILE" ]; then
+  echo "Error: .env file not found at path: $ENV_FILE"
+  # Use 'return' instead of 'exit' so it doesn't close the user's terminal when sourced
+  return 1
+fi
+
+# Read the GCP_PROJECT_ID, remove quotes, and handle potential carriage returns
+GOOGLE_CLOUD_PROJECT_VALUE=$(grep -E '^GOOGLE_CLOUD_PROJECT=' "$ENV_FILE" | cut -d '=' -f2 | tr -d '"\r')
+GEMINI_API_KEY_VALUE=$(grep -E '^GEMINI_API_KEY=' "$ENV_FILE" | cut -d '=' -f2 | tr -d '"\r')
+ANTIGRAVITY_API_KEY_VALUE=$(grep -E '^ANTIGRAVITY_API_KEY=' "$ENV_FILE" | cut -d '=' -f2 | tr -d '"\r')
+GEMINI_MODEL_VALUE=$(grep -E '^GEMINI_MODEL=' "$ENV_FILE" | cut -d '=' -f2 | tr -d '"\r')
+OMDB_API_KEY_VALUE=$(grep -E '^OMDB_API_KEY=' "$ENV_FILE" | cut -d '=' -f2 | tr -d '"\r')
+# Check if a value was extracted
+if [ -z "$GOOGLE_CLOUD_PROJECT_VALUE" ]; then
+  echo "Error: GOOGLE_CLOUD_PROJECT not found or is empty in $ENV_FILE."
+  return 1
+fi
+
+if [ -z "GEMINI_API_KEY_VALUE" ]; then
+  echo "GEMINI_API_KEY not found or is empty in $ENV_FILE."
+else
+  echo "exported: GEMINI_API_KEY"
+  export GEMINI_API_KEY="$GEMINI_API_KEY_VALUE"
+fi 
+
+if [ -z "ANTIGRAVITY_API_KEY_VALUE" ]; then
+  echo "ANTIGRAVITY_API_KEY not found or is empty in $ENV_FILE."
+else
+  echo "exported: ANTIGRAVITY_API_KEY"
+  export ANTIGRAVITY_API_KEY="$ANTIGRAVITY_API_KEY_VALUE"
+fi 
+
+if [ -z "OMDB_API_KEY_VALUE" ]; then
+  echo "OMDB_API_KEY not found or is empty in $ENV_FILE."
+else
+  echo "exported: OMDB_API_KEY"
+  export OMDB_API_KEY="$OMDB_API_KEY_VALUE"
+fi  
+
+
+if [ -z "GEMINI_MODEL_VALUE" ]; then
+  echo "GEMINI_MODEL not found or is empty in $ENV_FILE."
+else
+  echo "exported: GEMINI_MODEL=$GEMINI_MODEL_VALUE"
+  export GEMINI_MODEL="$GEMINI_MODEL_VALUE"
+fi  
+
+# Export the variable for the current session
+export GOOGLE_CLOUD_PROJECT="$GOOGLE_CLOUD_PROJECT_VALUE"
+
+echo "exported: GOOGLE_CLOUD_PROJECT=$GOOGLE_CLOUD_PROJECT"

package/package.json

@@ -39,7 +39,7 @@
   },
   "name": "@mcpher/gas-fakes",
   "author": "bruce mcpherson",
-  "version": "2.5.4",
+  "version": "2.5.6",
   "license": "MIT",
   "main": "main.js",
   "description": "An implementation of the Google Workspace Apps Script runtime: Run native App Script Code on Node and Cloud Run",

package/src/services/advslides/fakeadvslides.js

@@ -4,13 +4,32 @@ import { gError } from '../../support/helpers.js';
 import { slidesCacher } from '../../support/slidescacher.js';
 import { Proxies } from '../../support/proxies.js';
 
+/**
+ * @class FakeAdvSlidesPresentationsPages
+ */
+class FakeAdvSlidesPresentationsPages extends FakeAdvResource {
+  constructor(mainService) {
+    super(mainService, 'presentations', Syncit.fxSlides);
+  }
+
+
+  //https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations.pages/getThumbnail
+  getThumbnail(presentationId, pageObjectId, options) {
+    ScriptApp.__behavior.isAccessible(presentationId, 'Slides', 'read');
+    const { response, data } = this._call('getThumbnail', { presentationId, pageObjectId, ...options }, {}, 'pages');
+    gError(response, 'slides.presentations.pages', 'getThumbnail');
+    return data;
+  }
+}
+
 /**
  * @class FakeAdvSlidesPresentations
  */
 class FakeAdvSlidesPresentations extends FakeAdvResource {
   constructor(mainService) {
     super(mainService, 'presentations', Syncit.fxSlides);
-    this.slides = mainService
+    this.slides = mainService;
+    this.Pages = Proxies.guard(new FakeAdvSlidesPresentationsPages(mainService));
   }
 
   // Override 'get' to use the caching-enabled function fxSlidesGet.

package/src/services/documentapp/appenderhelpers.js

@@ -4,7 +4,7 @@ const { is, isBlob , stringCircular, lobify} = Utils
 import { getElementFactory } from './elementRegistry.js'
 import { signatureArgs, notYetImplemented } from '../../support/helpers.js';
 import { findItem } from './elementhelpers.js';
-import { paragraphOptions, pageBreakOptions, tableOptions, textOptions, listItemOptions, imageOptions, positionedImageOptions } from './elementoptions.js';
+import { horizontalRuleOptions, paragraphOptions, pageBreakOptions, tableOptions, textOptions, listItemOptions, imageOptions, positionedImageOptions } from './elementoptions.js';
 import { deleteContentRange, createParagraphBullets, reverseUpdateContent, deleteParagraphBullets } from "./elementblasters.js";
 
 /**
@@ -430,10 +430,15 @@ export const createFootnote = (parent, text) => {
 };
 
 
-// THE API has no way of inserting a horizontal rule
-// parking this for now - it'll need to be resurrected if this issue ever gets resolved
+// THE API has no way of inserting a horizontal rule natively.
 // https://issuetracker.google.com/issues/437825936
+export const appendHorizontalRule = (self, horizontalRule) => {
+  return notYetImplemented('appendHorizontalRule');
+};
 
+export const insertHorizontalRule = (self, childIndex, horizontalRule) => {
+  return notYetImplemented('insertHorizontalRule');
+};
 
 export const appendText = (self, textOrTextElement) => {
   return elementInserter(self, textOrTextElement, null, textOptions);

package/src/services/documentapp/elementhelpers.js

@@ -32,6 +32,9 @@ export const getElementProp = (se) => {
   if (se.horizontalRule) return { prop: null, type: 'HORIZONTAL_RULE' };
   if (se.footnoteReference) return { prop: null, type: 'FOOTNOTE_REFERENCE' };
   if (se.inlineObjectElement) return { prop: null, type: 'INLINE_IMAGE' };
+  if (se.person) return { prop: null, type: 'PERSON' };
+  if (se.richLink) return { prop: null, type: 'RICH_LINK' };
+  if (se.date) return { prop: null, type: 'DATE' };
   if (se.positionedObjectElement) return { prop: null, type: 'POSITIONED_IMAGE' };
 
   if (se.body) {
@@ -53,18 +56,24 @@ const getTextRecursive = (twig, structure) => {
   const item = structure.elementMap.get(twig.name);
   if (!item) return '';
 
-  // Base case: Text element. In the API, text is inside a paragraph's elements array.
-  if (item.paragraph) {
-    return item.paragraph.elements.map(e => e.textRun?.content || '').join('');
+  // Base case: Text element.
+  if (item.textRun) {
+    return item.textRun.content || '';
   }
 
   // Recursive case: Container element.
-  if (item.__twig && item.__twig.children) {
+  // Note: For Paragraph, item.paragraph.elements will be processed as children via __twig.children
+  if (item.__twig && item.__twig.children && item.__twig.children.length > 0) {
     return item.__twig.children
       .map(childTwig => getTextRecursive(childTwig, structure))
       .join('');
   }
 
+  // Fallback for elements that might not have children in twig yet (e.g. Paragraph during initial map)
+  if (item.paragraph) {
+    return item.paragraph.elements.map(e => e.textRun?.content || '').join('');
+  }
+
   return '';
 };
 
@@ -74,11 +83,16 @@ const getTextRecursive = (twig, structure) => {
  * @returns {string} The text content.
  */
 export const getText = (element) => {
-  if (!element || element.__isDetached) {
-    const item = element.__elementMapItem;
+  if (!element) return '';
+  const item = element.__elementMapItem;
+  if (!item) return '';
+
+  if (element.__isDetached) {
     let text = '';
 
-    if (item.paragraph) { // It's a Paragraph
+    if (item.textRun) {
+      text = item.textRun.content || '';
+    } else if (item.paragraph) { // It's a Paragraph
       text = item.paragraph.elements?.map(e => e.textRun?.content || '').join('') || '';
     } else if (item.content) { // It's a TableCell
       text = item.content.map(structuralElement =>
@@ -197,6 +211,133 @@ export const getAttributes = (element) => {
   return attributes;
 };
 
+/**
+ * Converts a DocumentApp.Attribute map to Docs API style objects.
+ * @param {object} attributes The attributes to convert.
+ * @returns {{paragraphStyle: object, textStyle: object, paraFields: string, textFields: string}}
+ */
+export const attributesToStyle = (attributes) => {
+  const paragraphStyle = {};
+  const textStyle = {};
+  const paraFields = [];
+  const textFields = [];
+
+  const Attribute = DocumentApp.Attribute;
+
+  const hexToRgb = (hex) => {
+    if (!hex || !is.string(hex) || !hex.startsWith('#')) return null;
+    const r = parseInt(hex.slice(1, 3), 16) / 255;
+    const g = parseInt(hex.slice(3, 5), 16) / 255;
+    const b = parseInt(hex.slice(5, 7), 16) / 255;
+    return { color: { rgbColor: { red: r, green: g, blue: b } } };
+  };
+
+  const alignmentMap = {
+    [DocumentApp.HorizontalAlignment.LEFT]: 'START',
+    [DocumentApp.HorizontalAlignment.CENTER]: 'CENTER',
+    [DocumentApp.HorizontalAlignment.RIGHT]: 'END',
+    [DocumentApp.HorizontalAlignment.JUSTIFIED]: 'JUSTIFY',
+  };
+
+  for (const [key, value] of Object.entries(attributes)) {
+    // Note: keys are likely strings like "BOLD", "HORIZONTAL_ALIGNMENT"
+    switch (key) {
+      case 'HORIZONTAL_ALIGNMENT':
+      case Attribute.HORIZONTAL_ALIGNMENT.toString():
+        paragraphStyle.alignment = alignmentMap[value] || value;
+        paraFields.push('alignment');
+        break;
+      case 'LEFT_TO_RIGHT':
+      case Attribute.LEFT_TO_RIGHT.toString():
+        paragraphStyle.direction = value ? 'LEFT_TO_RIGHT' : 'RIGHT_TO_LEFT';
+        paraFields.push('direction');
+        break;
+      case 'LINE_SPACING':
+      case Attribute.LINE_SPACING.toString():
+        paragraphStyle.lineSpacing = Math.round(value * 100);
+        paraFields.push('lineSpacing');
+        break;
+      case 'INDENT_START':
+      case Attribute.INDENT_START.toString():
+        paragraphStyle.indentStart = { magnitude: value, unit: 'PT' };
+        paraFields.push('indentStart');
+        break;
+      case 'INDENT_END':
+      case Attribute.INDENT_END.toString():
+        paragraphStyle.indentEnd = { magnitude: value, unit: 'PT' };
+        paraFields.push('indentEnd');
+        break;
+      case 'INDENT_FIRST_LINE':
+      case Attribute.INDENT_FIRST_LINE.toString():
+        paragraphStyle.indentFirstLine = { magnitude: value, unit: 'PT' };
+        paraFields.push('indentFirstLine');
+        break;
+      case 'SPACING_BEFORE':
+      case Attribute.SPACING_BEFORE.toString():
+        paragraphStyle.spaceAbove = { magnitude: value, unit: 'PT' };
+        paraFields.push('spaceAbove');
+        break;
+      case 'SPACING_AFTER':
+      case Attribute.SPACING_AFTER.toString():
+        paragraphStyle.spaceBelow = { magnitude: value, unit: 'PT' };
+        paraFields.push('spaceBelow');
+        break;
+      case 'BACKGROUND_COLOR':
+      case Attribute.BACKGROUND_COLOR.toString():
+        textStyle.backgroundColor = hexToRgb(value);
+        textFields.push('backgroundColor');
+        break;
+      case 'BOLD':
+      case Attribute.BOLD.toString():
+        textStyle.bold = value;
+        textFields.push('bold');
+        break;
+      case 'FONT_FAMILY':
+      case Attribute.FONT_FAMILY.toString():
+        textStyle.weightedFontFamily = { fontFamily: value };
+        textFields.push('weightedFontFamily');
+        break;
+      case 'FONT_SIZE':
+      case Attribute.FONT_SIZE.toString():
+        textStyle.fontSize = { magnitude: value, unit: 'PT' };
+        textFields.push('fontSize');
+        break;
+      case 'FOREGROUND_COLOR':
+      case Attribute.FOREGROUND_COLOR.toString():
+        textStyle.foregroundColor = hexToRgb(value);
+        textFields.push('foregroundColor');
+        break;
+      case 'ITALIC':
+      case Attribute.ITALIC.toString():
+        textStyle.italic = value;
+        textFields.push('italic');
+        break;
+      case 'STRIKETHROUGH':
+      case Attribute.STRIKETHROUGH.toString():
+        textStyle.strikethrough = value;
+        textFields.push('strikethrough');
+        break;
+      case 'UNDERLINE':
+      case Attribute.UNDERLINE.toString():
+        textStyle.underline = value;
+        textFields.push('underline');
+        break;
+      case 'LINK_URL':
+      case Attribute.LINK_URL.toString():
+        textStyle.link = { url: value };
+        textFields.push('link');
+        break;
+    }
+  }
+
+  return { 
+    paragraphStyle, 
+    textStyle, 
+    paraFields: paraFields.join(','), 
+    textFields: textFields.join(',') 
+  };
+};
+
 export const findItem = (elementMap, type, startIndex, segmentId) => {
   const item = Array.from(elementMap.values()).find(f => {
     // segmentId from API is empty string for body, but we might pass null. Normalize.

package/src/services/documentapp/elementoptions.js

@@ -58,6 +58,34 @@ const handleTextless = (loc, isAppend, self, type, extras = {}) => {
 
       break;
 
+    case 'HORIZONTAL_RULE':
+      reqs.push({
+        insertText: {
+          location,
+          text: '\n'
+        }
+      });
+      reqs.push({
+        updateParagraphStyle: {
+          range: {
+            startIndex: loc.index,
+            endIndex: loc.index + 1,
+            segmentId: loc.segmentId,
+            tabId: loc.tabId
+          },
+          paragraphStyle: {
+            borderBottom: {
+              color: { color: { rgbColor: { blue: 0, green: 0, red: 0 } } },
+              width: { magnitude: 1, unit: 'PT' },
+              padding: { magnitude: 0, unit: 'PT' },
+              dashStyle: 'SOLID'
+            }
+          },
+          fields: 'borderBottom'
+        }
+      });
+      break;
+
     default:
       throw new Error(`unknown type ${type} in handleTextless `)
   }
@@ -263,6 +291,18 @@ export const pageBreakOptions = {
 
 };
 
+export const horizontalRuleOptions = {
+  elementType: ElementType.HORIZONTAL_RULE,
+  insertMethodSignature: 'DocumentApp.Body.horizontalRule',
+  packCanBeNull: true,
+  canAcceptText: false,
+  getMainRequest: ({ location: loc, isAppend, self, leading }) => {
+    return handleTextless(loc, isAppend, self, 'HORIZONTAL_RULE')
+  },
+  getStyleRequests: null, 
+  findType: ElementType.PARAGRAPH.toString()
+};
+
 export const tableOptions = {
   elementType: ElementType.TABLE,
   packCanBeNull: true,

package/src/services/documentapp/elements.js

@@ -17,5 +17,12 @@ import './fakefootnote.js';
 import './fakeinlineimage.js';
 import './fakefootnotesection.js';
 import './fakepositionedimage.js';
+import './fakedate.js';
+import './fakeperson.js';
+import './fakerichlink.js';
+import './fakeequation.js';
+import './fakeequationfunction.js';
+import './fakeequationfunctionargumentseparator.js';
+import './fakeequationsymbol.js';
 // As you create more element types (e.g., Table, ListItem), import them here.
 // import './faketable.js';

package/src/services/documentapp/fakebookmark.js

@@ -41,8 +41,6 @@ export class FakeBookmark extends FakeContainerElement {
    */
   getId() {
     const item = this.__elementMapItem;
-    // The name is the full named range name, e.g., "kix.abcdef123".
-    // The ID is the part after "kix.".
     return item.name.startsWith(BOOKMARK_PREFIX) ? item.name.substring(BOOKMARK_PREFIX.length) : item.name;
   }
 
@@ -67,7 +65,7 @@ export class FakeBookmark extends FakeContainerElement {
     }
 
     const factory = getElementFactory(containingElementItem.__type);
-    const element = factory(shadow.structure, containingElementItem.__name);
+    const element = factory(shadow, containingElementItem.__name);
     const offset = startIndex - containingElementItem.startIndex;
 
     return newFakePosition(element, offset);

package/src/services/documentapp/fakecontainerelement.js

@@ -10,6 +10,7 @@ const { is } = Utils;
 import { getElementProp } from './elementhelpers.js';
 import { FakeElement } from './fakeelement.js';
 import { createFootnote } from './appenderhelpers.js';
+import { newFakeRangeElement } from './fakerangeelement.js';
 
 /**
  * Creates a new proxied FakeContainerElement instance.
@@ -183,6 +184,133 @@ export class FakeContainerElement extends FakeElement {
     return elements;
   }
 
+  /**
+   * Clears the contents of the element.
+   * @returns {GoogleAppsScript.Document.ContainerElement} The current element.
+   * @see https://developers.google.com/apps-script/reference/document/container-element#clear()
+   */
+  clear() {
+    const { nargs, matchThrow } = signatureArgs(arguments, 'ContainerElement.clear');
+    if (nargs !== 0) matchThrow();
+
+    // Snapshot the children names to avoid issues with index shifting during removal
+    const childrenNames = this.__twig.children.map(c => c.name);
+    childrenNames.forEach(name => {
+      newFakeElement(this.shadowDocument, name).removeFromParent();
+    });
+
+    return this;
+  }
+
+  /**
+   * Obtains a Text version of the current element, for editing.
+   * @returns {GoogleAppsScript.Document.Text} a text version of the current element
+   * @see https://developers.google.com/apps-script/reference/document/container-element#editAsText()
+   */
+  editAsText() {
+    const { nargs, matchThrow } = signatureArgs(arguments, 'ContainerElement.editAsText');
+    if (nargs !== 0) matchThrow();
+    // For now, we'll mark it as not implemented but mark as draft.
+    throw new Error('editAsText() is not yet implemented in gas-fakes');
+  }
+
+  /**
+   * Searches the contents of the element for a descendant of the specified type.
+   * @param {GoogleAppsScript.Document.ElementType} elementType The type of element to search for.
+   * @param {GoogleAppsScript.Document.RangeElement} [from] The element to start searching from.
+   * @returns {GoogleAppsScript.Document.RangeElement | null} A search result indicating the position of the search element.
+   * @see https://developers.google.com/apps-script/reference/document/container-element#findElement(ElementType,RangeElement)
+   */
+  findElement(elementType, from = null) {
+    const { nargs, matchThrow } = signatureArgs(arguments, 'ContainerElement.findElement');
+    if (nargs < 1 || nargs > 2) matchThrow();
+
+    const searchFromElement = from ? from.getElement() : null;
+    let foundStart = !searchFromElement;
+
+    const findRecursive = (container) => {
+      const numChildren = container.getNumChildren();
+      for (let i = 0; i < numChildren; i++) {
+        const child = container.getChild(i);
+        
+        if (!foundStart) {
+          if (child.__name === searchFromElement.__name) {
+            foundStart = true;
+          } else if (child.getNumChildren) {
+            const result = findRecursive(child);
+            if (result) return result;
+          }
+          continue;
+        }
+
+        if (child.getType().toString() === elementType.toString()) {
+          return newFakeRangeElement({ element: child });
+        }
+
+        if (child.getNumChildren) {
+          const result = findRecursive(child);
+          if (result) return result;
+        }
+      }
+      return null;
+    };
+
+    return findRecursive(this);
+  }
+
+  /**
+   * Searches the contents of the element for the specified text pattern using regular expressions.
+   * @param {string} searchPattern The text pattern to search for.
+   * @param {GoogleAppsScript.Document.RangeElement} [from] The element to start searching from.
+   * @returns {GoogleAppsScript.Document.RangeElement | null} a search result indicating the position of the search text, or null if there is no match
+   * @see https://developers.google.com/apps-script/reference/document/container-element#findText(String,RangeElement)
+   */
+  findText(searchPattern, from = null) {
+    const { nargs, matchThrow } = signatureArgs(arguments, 'ContainerElement.findText');
+    if (nargs < 1 || nargs > 2) matchThrow();
+
+    const searchFromElement = from ? from.getElement() : null;
+    let foundStart = !searchFromElement;
+    const regex = new RegExp(searchPattern);
+
+    const findRecursive = (container) => {
+      const numChildren = container.getNumChildren();
+      for (let i = 0; i < numChildren; i++) {
+        const child = container.getChild(i);
+
+        if (!foundStart) {
+          if (child.__name === searchFromElement.__name) {
+            foundStart = true;
+          } else if (child.getNumChildren) {
+            const result = findRecursive(child);
+            if (result) return result;
+          }
+          continue;
+        }
+
+        if (child.getType().toString() === 'TEXT') {
+          const text = child.getText();
+          const match = regex.exec(text);
+          if (match) {
+            return newFakeRangeElement({ 
+              element: child, 
+              startOffset: match.index, 
+              endOffsetInclusive: match.index + match[0].length - 1 
+            });
+          }
+        }
+
+        if (child.getNumChildren) {
+          const result = findRecursive(child);
+          if (result) return result;
+        }
+      }
+      return null;
+    };
+
+    return findRecursive(this);
+  }
+
   /**
    * Retrieves the child element at the specified index.
    * @param {number} childIndex The zero-based index of the child element to retrieve.
@@ -250,6 +378,66 @@ export class FakeContainerElement extends FakeElement {
     return newFakeElement(this.shadowDocument, childTwig.name).__cast();
   }
 
+  /**
+   * Retrieves the contents of the element as a text string.
+   * @returns {string} the contents of the element as text string
+   * @see https://developers.google.com/apps-script/reference/document/container-element#getText()
+   */
+  getText() {
+    const { nargs, matchThrow } = signatureArgs(arguments, 'ContainerElement.getText');
+    if (nargs !== 0) matchThrow();
+
+    return getText(this);
+  }
+
+  /**
+   * Gets the text alignment.
+   * @returns {GoogleAppsScript.Document.TextAlignment | null} the type of text alignment
+   * @see https://developers.google.com/apps-script/reference/document/container-element#getTextAlignment()
+   */
+  getTextAlignment() {
+    const { nargs, matchThrow } = signatureArgs(arguments, 'ContainerElement.getTextAlignment');
+    if (nargs !== 0) matchThrow();
+
+    const attrs = this.getAttributes();
+    // ContainerElement doesn't have a single text alignment, it's usually paragraph-level.
+    // However, if we are a Paragraph, this should work.
+    return attrs[DocumentApp.Attribute.TEXT_ALIGNMENT] || null;
+  }
+
+  /**
+   * Sets the text alignment.
+   * @param {GoogleAppsScript.Document.TextAlignment} textAlignment The text alignment to set.
+   * @returns {GoogleAppsScript.Document.ContainerElement} the current element
+   * @see https://developers.google.com/apps-script/reference/document/container-element#setTextAlignment(TextAlignment)
+   */
+  setTextAlignment(textAlignment) {
+    const { nargs, matchThrow } = signatureArgs(arguments, 'ContainerElement.setTextAlignment');
+    if (nargs !== 1) matchThrow();
+
+    this.setAttributes({
+      [DocumentApp.Attribute.TEXT_ALIGNMENT]: textAlignment
+    });
+    return this;
+  }
+
+  /**
+   * Replaces all occurrences of a search pattern with a replacement string.
+   * @param {string} searchPattern The text pattern to search for.
+   * @param {string} replacement The replacement string.
+   * @returns {GoogleAppsScript.Document.ContainerElement} the current element
+   * @see https://developers.google.com/apps-script/reference/document/container-element#replaceText(String,String)
+   */
+  replaceText(searchPattern, replacement) {
+    const { nargs, matchThrow } = signatureArgs(arguments, 'ContainerElement.replaceText');
+    if (nargs !== 2 || !is.string(searchPattern) || !is.string(replacement)) matchThrow();
+
+    // replaceText in GAS is global if called on Body, or scoped if called on other containers.
+    // Implementing scoped replaceText via API is complex (requires finding and replacing chunks).
+    // For now, let's mark it.
+    throw new Error('replaceText() is not yet implemented in gas-fakes');
+  }
+
   /**
    * Gets the index of a given child element.
    * @param {GoogleAppsScript.Document.Element} child The child element to find.