Define concrete layout spec and control placement for preview tool - PR_26126_003-preview-tool-layout-spec

Author: DavidQ

docs/dev/codex_commands.md

@@ -1,19 +1,19 @@
-# Codex Commands - PR_26126_002-preview-tool-detailed-design
+# Codex Commands - PR_26126_003-preview-tool-layout-spec
 
 ```bash
-codex run "Create PR_26126_002-preview-tool-detailed-design. Add a detailed design document for tools/preview/index.html covering capabilities, UI regions, control placement, input/output contracts, error states, preview modes, and export actions. No implementation code. Do not modify samples. Place design under docs/pr/PR_26126_002-preview-tool-detailed-design.md and produce required review artifacts."
+codex run "Create PR_26126_003-preview-tool-layout-spec. Convert the preview tool design into a concrete layout spec for tools/preview/index.html. Define exact regions (header, left panel controls, main preview canvas, right panel properties, footer actions). Specify each control placement (input source, validation status, preview mode selector, zoom, background toggle, export buttons). Include DOM structure outline (ids/classes only, no implementation), state model (toolState shape), and interaction flows (load -> validate -> render -> export). No runtime code. Do not modify samples. Place doc under docs/pr/PR_26126_003-preview-tool-layout-spec.md and produce required review artifacts."
 ```
 
 ## Validation Commands
 
 ```bash
-git diff --check -- docs/pr/PR_26126_002-preview-tool-detailed-design.md docs/dev/codex_commands.md docs/dev/commit_comment.txt
-npm run codex:review-artifacts
+git diff --check -- docs/pr/PR_26126_003-preview-tool-layout-spec.md docs/dev/codex_commands.md docs/dev/commit_comment.txt
+node --input-type=module <write PR-scoped review artifacts>
 ```
 
 ## Playwright
 
-No Playwright impact. This PR is a documentation/design-only PR for the Preview tool and does not modify implementation code.
+No Playwright impact. This PR is a documentation/layout-spec-only PR for the Preview tool and does not modify implementation code.
 
 ## Full Samples
 

docs/dev/commit_comment.txt

@@ -1 +1 @@
-Add Preview tool detailed design - PR_26126_002-preview-tool-detailed-design
+Add Preview tool layout spec - PR_26126_003-preview-tool-layout-spec

docs/dev/reports/codex_changed_files.txt

@@ -1,8 +1,16 @@
 # git status --short
 M docs/dev/codex_commands.md
  M docs/dev/commit_comment.txt
+?? docs/pr/PR_26126_003-preview-tool-layout-spec.md
 
 # git diff --stat
-docs/dev/codex_commands.md  | 19 +++++--------------
+docs/dev/codex_commands.md  | 10 +++++-----
  docs/dev/commit_comment.txt |  2 +-
- 2 files changed, 6 insertions(+), 15 deletions(-)
+ 2 files changed, 6 insertions(+), 6 deletions(-)
+
+# New design doc diff --stat
+.../pr/PR_26126_003-preview-tool-layout-spec.md    | 619 +++++++++++++++++++++
+ 1 file changed, 619 insertions(+)
+
+# Scope note
+PR_26126_003 is documentation/layout-spec only. No samples or runtime code were modified.