feat(slides): add native table creation (#837)

Add native Slides table creation and safe zero-based table-cell text insertion and replacement.

Co-authored-by: clawsweeper <274271284+clawsweeper[bot]@users.noreply.github.com>

Author: steipete

CHANGELOG.md

@@ -7,6 +7,7 @@
 - Slides: allow `insert-image` and `replace-slide` to use public HTTPS image URLs without temporary Drive sharing. (#825) — thanks @sebsnyk.
 - Slides: add structured element geometry, styled text runs, table-cell content, image source URLs, native presentation metadata, and read-only text location with exact UTF-16 ranges. (#822) — thanks @sebsnyk.
 - Slides: add range-scoped styling, links, bullets, and object-scoped replacement; `replace-text` now requires explicit `--object`, `--page`, or `--all` scope instead of silently changing the whole deck. (#823, #835) — thanks @sebsnyk.
+- Slides: add native table creation and zero-based table-cell targeting for `insert-text`, including atomic cell replacement. (#824, #834) — thanks @sebsnyk.
 
 ### Fixed
 

README.md

@@ -383,6 +383,7 @@ Docs: [Slides from Markdown](docs/slides-markdown.md),
 [template replacement](docs/slides-template-replacement.md),
 [introspection](docs/slides-introspection.md),
 [text editing](docs/slides-text-editing.md),
+[tables](docs/slides-tables.md),
 [`gog slides`](docs/commands/gog-slides.md),
 [`gog forms`](docs/commands/gog-forms.md).
 
@@ -393,6 +394,8 @@ gog slides read-slide <presentationId> <slideId> --detail --json
 gog slides locate <presentationId> "Quarterly revenue" --all --json
 gog slides style-text <presentationId> <objectId> --range 0:12 --bold --size 24
 gog slides replace-text <presentationId> old new --object <objectId>
+gog slides table create <presentationId> <slideId> --rows 2 --cols 3
+gog slides insert-text <presentationId> <tableId> "Revenue" --row 0 --col 0 --replace
 gog slides insert-image <presentationId> <slideId> chart.png --x 24 --y 24 --width 240
 gog slides insert-text <presentationId> <objectId> "New text"
 gog forms update <formId> --quiz=true

docs/commands.generated.md

@@ -604,6 +604,8 @@ Generated from `gog schema --json`.
     - [`gog slides (slide) replace-slide <presentationId> <slideId> [<image>] [flags]`](commands/gog-slides-replace-slide.md) - Replace an existing slide image from a local file or public URL
     - [`gog slides (slide) replace-text <presentationId> <find> <replacement> [flags]`](commands/gog-slides-replace-text.md) - Find-and-replace text in an explicit object, slide, or presentation scope
     - [`gog slides (slide) style-text --range=STRING <presentationId> <objectId> [flags]`](commands/gog-slides-style-text.md) - Apply range-scoped text styling to one page element
+    - [`gog slides (slide) table <command>`](commands/gog-slides-table.md) - Create and update native tables
+      - [`gog slides (slide) table create (add) --rows=INT-64 --cols=INT-64 <presentationId> <slideId> [flags]`](commands/gog-slides-table-create.md) - Create an auto-sized native table on a slide
     - [`gog slides (slide) thumbnail (thumb) <presentationId> <slideId> [flags]`](commands/gog-slides-thumbnail.md) - Get or download a rendered thumbnail for a slide
     - [`gog slides (slide) update-notes <presentationId> <slideId> [flags]`](commands/gog-slides-update-notes.md) - Update speaker notes on an existing slide
   - [`gog status (st) [flags]`](commands/gog-status.md) - Show auth/config status (alias for 'auth status')

docs/commands/README.md

@@ -2,7 +2,7 @@
 
 Every `gog` command has a generated docs page. The source of truth is the live CLI schema; run `make docs-commands` after changing command names, flags, help text, aliases, or arguments.
 
-Generated pages: 650.
+Generated pages: 652.
 
 ## Top-level Commands
 
@@ -655,6 +655,8 @@ Generated pages: 650.
     - [gog slides replace-slide](gog-slides-replace-slide.md) - Replace an existing slide image from a local file or public URL
     - [gog slides replace-text](gog-slides-replace-text.md) - Find-and-replace text in an explicit object, slide, or presentation scope
     - [gog slides style-text](gog-slides-style-text.md) - Apply range-scoped text styling to one page element
+    - [gog slides table](gog-slides-table.md) - Create and update native tables
+      - [gog slides table create](gog-slides-table-create.md) - Create an auto-sized native table on a slide
     - [gog slides thumbnail](gog-slides-thumbnail.md) - Get or download a rendered thumbnail for a slide
     - [gog slides update-notes](gog-slides-update-notes.md) - Update speaker notes on an existing slide
   - [gog status](gog-status.md) - Show auth/config status (alias for 'auth status')

docs/commands/gog-slides-insert-text.md

@@ -21,6 +21,7 @@ gog slides (slide) insert-text <presentationId> <objectId> <text> [flags]
 | `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
 | `-a`<br>`--account`<br>`--acct` | `string` |  | Account email, alias, or auto for authenticated Google API commands |
 | `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--col` | `*int64` |  | 0-based table column index for cell-targeted text; requires --row |
 | `--color` | `string` | auto | Color output: auto\|always\|never |
 | `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
 | `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
@@ -36,6 +37,7 @@ gog slides (slide) insert-text <presentationId> <objectId> <text> [flags]
 | `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
 | `--replace` | `bool` |  | Clear existing text in the element before inserting (emits DeleteText + InsertText in the same batch) |
 | `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--row` | `*int64` |  | 0-based table row index for cell-targeted text; requires --col |
 | `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
 | `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
 | `--version` | `kong.VersionFlag` |  | Print version and exit |

docs/commands/gog-slides-table-create.md

@@ -0,0 +1,48 @@
+# `gog slides table create`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Create an auto-sized native table on a slide
+
+## Usage
+
+```bash
+gog slides (slide) table create (add) --rows=INT-64 --cols=INT-64 <presentationId> <slideId> [flags]
+```
+
+## Parent
+
+- [gog slides table](gog-slides-table.md)
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email, alias, or auto for authenticated Google API commands |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--cols` | `int64` |  | Number of table columns (>=1) |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled command prefixes; dot paths allowed (restricts CLI) |
+| `--enable-commands-exact` | `string` |  | Comma-separated list of exact enabled commands; dot paths allowed and parent commands do not enable children |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `--home` | `string` |  | Override gogcli config/data/state/cache root (equivalent to GOG_HOME) |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `--object-id` | `string` |  | Optional table object ID to assign |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--rows` | `int64` |  | Number of table rows (>=1) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+| `--wrap-untrusted` | `bool` | false | In JSON/raw output, wrap fetched text fields in external untrusted-content markers |
+
+## See Also
+
+- [gog slides table](gog-slides-table.md)
+- [Command index](README.md)

docs/commands/gog-slides-table.md

@@ -0,0 +1,49 @@
+# `gog slides table`
+
+> Generated from `gog schema --json`. Do not edit this page by hand; run `make docs-commands`.
+
+Create and update native tables
+
+## Usage
+
+```bash
+gog slides (slide) table <command>
+```
+
+## Parent
+
+- [gog slides](gog-slides.md)
+
+## Subcommands
+
+- [gog slides table create](gog-slides-table-create.md) - Create an auto-sized native table on a slide
+
+## Flags
+
+| Flag | Type | Default | Help |
+| --- | --- | --- | --- |
+| `--access-token` | `string` |  | Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) |
+| `-a`<br>`--account`<br>`--acct` | `string` |  | Account email, alias, or auto for authenticated Google API commands |
+| `--client` | `string` |  | OAuth client name (selects stored credentials + token bucket) |
+| `--color` | `string` | auto | Color output: auto\|always\|never |
+| `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
+| `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
+| `--enable-commands` | `string` |  | Comma-separated list of enabled command prefixes; dot paths allowed (restricts CLI) |
+| `--enable-commands-exact` | `string` |  | Comma-separated list of exact enabled commands; dot paths allowed and parent commands do not enable children |
+| `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
+| `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
+| `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
+| `--home` | `string` |  | Override gogcli config/data/state/cache root (equivalent to GOG_HOME) |
+| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
+| `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
+| `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
+| `--version` | `kong.VersionFlag` |  | Print version and exit |
+| `--wrap-untrusted` | `bool` | false | In JSON/raw output, wrap fetched text fields in external untrusted-content markers |
+
+## See Also
+
+- [gog slides](gog-slides.md)
+- [Command index](README.md)

docs/commands/gog-slides.md

@@ -35,6 +35,7 @@ gog slides (slide) <command> [flags]
 - [gog slides replace-slide](gog-slides-replace-slide.md) - Replace an existing slide image from a local file or public URL
 - [gog slides replace-text](gog-slides-replace-text.md) - Find-and-replace text in an explicit object, slide, or presentation scope
 - [gog slides style-text](gog-slides-style-text.md) - Apply range-scoped text styling to one page element
+- [gog slides table](gog-slides-table.md) - Create and update native tables
 - [gog slides thumbnail](gog-slides-thumbnail.md) - Get or download a rendered thumbnail for a slide
 - [gog slides update-notes](gog-slides-update-notes.md) - Update speaker notes on an existing slide
 

docs/slides-tables.md

@@ -0,0 +1,32 @@
+# Slides tables
+
+Create a native table on an existing slide:
+
+```bash
+gog slides table create <presentationId> <slideId> --rows 3 --cols 4
+```
+
+The command prints the table object ID. Pass `--object-id` to choose a stable ID
+when a later script needs to reference the table without parsing the response.
+
+Google Slides chooses a new table's initial size and position. The Slides API
+ignores size and transform fields on table creation, so this command does not
+expose geometry flags that would report a result the provider does not honor.
+
+## Cell text
+
+Target a cell with zero-based `--row` and `--col` indexes:
+
+```bash
+gog slides insert-text <presentationId> <tableId> "Revenue" --row 0 --col 0
+gog slides insert-text <presentationId> <tableId> '$1.2M' --row 1 --col 0 --replace
+```
+
+`--row` and `--col` must be provided together. `--replace` clears and inserts
+within the selected cell in one Slides batch update; it does not alter other
+cells. `--insertion-index` selects an index within the cell when appending or
+inserting without `--replace`.
+
+Use `--dry-run --json` to inspect the exact Slides `batchUpdate` request without
+contacting Google. Use `slides read-slide --detail --json` to verify the table
+dimensions, cell coordinates, and text returned by the provider.

internal/cmd/slides.go

@@ -31,6 +31,7 @@ type SlidesCmd struct {
 	ReplaceSlide       SlidesReplaceSlideCmd       `cmd:"" name:"replace-slide" help:"Replace an existing slide image from a local file or public URL"`
 	InsertImage        SlidesInsertImageCmd        `cmd:"" name:"insert-image" help:"Insert a local or public image at a position and size"`
 	InsertText         SlidesInsertTextCmd         `cmd:"" name:"insert-text" help:"Insert text into an existing page element (shape or table) by objectId"`
+	Table              SlidesTableCmd              `cmd:"" name:"table" help:"Create and update native tables"`
 	StyleText          SlidesStyleTextCmd          `cmd:"" name:"style-text" help:"Apply range-scoped text styling to one page element"`
 	Link               SlidesLinkCmd               `cmd:"" name:"link" help:"Apply a hyperlink to a text range in one page element"`
 	Bullets            SlidesBulletsCmd            `cmd:"" name:"bullets" help:"Turn paragraph bullets on or off in one page element"`