@office-kit/pptx-dev 0.6.0 → 0.8.1

package/README.md

@@ -16,11 +16,31 @@ npm install
 npm run dev
 ```
 
+For a single-command first launch (macOS/Linux):
+
+```sh
+npx --yes @office-kit/pptx-dev@latest init my-slides && cd my-slides && npm install && npm run dev
+```
+
+The built-in `init` is the starter generator: no separate `degit` checkout is
+needed, and it selects compatible package versions. For an existing project,
+start development with `npm run dev` or `npx office-pptx dev deck.tsx`.
+If you prefer the bare `office-pptx dev deck.tsx` command, install the CLI once
+with `npm install --global @office-kit/pptx-dev@latest`. The local npm script
+continues to use the project's installed version.
+
+To update an existing project, stop its dev server and run inside the project:
+
+```sh
+npm install -D @office-kit/pptx-dev@latest
+npm run dev
+```
+
 Open the local URL printed by the server. Save a slide file, `theme.ts` or `deck.tsx` to rebuild. The viewer
 has a vertical thumbnail strip, a large slide canvas and an AI chat panel on the right. Click a thumbnail or use
 arrow keys, Page Up/Down, Home/End to navigate. Fit/zoom and Present (Escape to
-exit) are viewing controls; the canvas has no editing, dragging or resize handles.
-Changes are made only in TSX, including when an AI agent edits the presentation.
+exit) are viewing controls. Click an object or drag an area for an AI instruction, or double-click text
+to save a literal directly. All edits are persisted in TSX.
 Keep the server running throughout the edit/review loop. Saving updates only the
 changed thumbnails and slide view, preserving zoom, scroll position and presentation
 mode. The previous slide stays visible until its replacement is ready. Rapid edits
@@ -140,6 +160,62 @@ References: [Claude Code commands](https://code.claude.com/docs/en/commands),
 [Claude Code hooks](https://code.claude.com/docs/en/hooks), and
 [Codex non-interactive mode](https://developers.openai.com/codex/noninteractive).
 
+## Edit from the slide
+
+Hover to see an object's outline, **click an object** to give it an AI instruction,
+or **drag a rectangle** to select an arbitrary area. No mode switching is needed.
+Enter an instruction such as “Move this down a little,” choose an agent pane, and
+click **Apply with AI**. The request includes the slide, preview revision, relative
+bounds and intersecting text. Start Claude Code in that pane first; Codex starts
+when you send. Click the background or press Escape to deselect. Selection also
+clears when the preview or selected slide changes. Shift+Enter inserts a newline;
+Cmd/Ctrl+Enter sends the request.
+
+**Double-click a paragraph** to edit it in place. Enter inserts a newline;
+Cmd/Ctrl+Enter or **Save text** saves, and Escape cancels. Direct saves require a
+unique source literal within the entry directory and verify that other slides did
+not change. Computed text, shared values and ambiguous matches use **Apply with AI**
+instead.
+
+### Undo and Redo
+
+The toolbar's **Undo / Redo** restores actual source and asset changes, including
+AI edits, direct text saves and saves from an external editor. Use **Cmd/Ctrl+Z**
+and **Cmd/Ctrl+Shift+Z** (or Ctrl+Y) while focused on the preview. Inside a text
+field or agent terminal, those keys keep their normal local meaning.
+
+An AI turn includes its build repairs and screenshot correction passes. Overlapping
+agent turns are grouped as **Concurrent edits**; Undo waits until all have finished.
+A direct text save and any subsequent AI visual corrections are separate entries.
+New edits clear Redo. File additions and deletions are included; newer external saves
+are recorded as their own edit before Undo, and conflicting writes are refused.
+Undo/Redo rebuilds the preview without asking an agent to reinterpret or change the
+restored design. It also works when an AI edit broke the build.
+
+History lasts for the dev server session (browser reloads preserve it), up to 50
+entries / 128 MiB. It covers TS/JS, JSON, CSS, Markdown, YAML, PPTX and image files
+inside the entry directory, excluding symlinks, `node_modules`, `.git`, `dist` and
+`.office-kit`. The tracked project must fit within 64 MiB. Changes outside that
+folder, CLI session state and conversation transcripts are not restored. Keep Git for
+persistent project history.
+
+After each successful agent edit or direct text save, the dev server captures
+all changed slides, including slides offscreen. Codex receives PNG attachments;
+Claude Code receives local PNG paths through its Stop hook and is instructed to
+read them. The agent checks overlap, clipping, alignment, spacing and contrast,
+and can make up to two correction passes followed by a final inspection. This is
+AI-assisted review, not a guarantee of pixel-perfect rendering. The preview updates
+as soon as the build finishes, independently of screenshot review.
+
+Screenshot capture uses an installed Chrome, or falls back to Playwright Chromium.
+Set `PLAYWRIGHT_CHANNEL` to use another installed Chromium channel. If neither is
+available, install Chrome and restart the dev server. Capture failures are shown
+explicitly; saved edits remain available. If the chosen agent is busy or not started,
+use **Retry visual review** after making it available. Screenshots and review prompts
+are stored locally under `.office-kit/reviews/`; new projects ignore this directory.
+Add `.office-kit/` to `.gitignore` in existing projects. Images are provided to the
+selected AI agent using its existing login and provider settings.
+
 ## Edit only what changed
 
 New projects separate slide order, content and shared styling: