docs: highlight code snapshot feature in README and changelog

This commit is contained in:
h3p 2026-03-16 11:48:32 +01:00
parent 2d1cc89758
commit b9e0d2801c
5 changed files with 83 additions and 4 deletions

View file

@ -10,6 +10,7 @@ The format follows *Keep a Changelog*. Versions use semantic versioning with pre
- Stabilized first-open rendering from the project sidebar so file content and syntax highlighting appear on first click without requiring tab switches.
- Hardened startup/session behavior so `Reopen Last Session` reliably wins over conflicting blank-document startup states.
- Refined large-file activation and loading placeholders to avoid misclassifying smaller files as large-file sessions.
- Added Share Shot (`Code Snapshot`) creation flow with toolbar + selection-context actions (`camera.viewfinder`) and a styled share/export composer.
### Fixes
- Fixed a session-restore regression where previously open files could appear empty on first sidebar click until changing tabs.

View file

@ -361,7 +361,7 @@
CODE_SIGNING_ALLOWED = YES;
CODE_SIGN_IDENTITY = "Apple Development";
CODE_SIGN_STYLE = Automatic;
CURRENT_PROJECT_VERSION = 526;
CURRENT_PROJECT_VERSION = 527;
DEAD_CODE_STRIPPING = YES;
DEVELOPMENT_TEAM = CS727NF72U;
ENABLE_APP_SANDBOX = YES;
@ -444,7 +444,7 @@
CODE_SIGNING_ALLOWED = YES;
CODE_SIGN_IDENTITY = "Apple Development";
CODE_SIGN_STYLE = Automatic;
CURRENT_PROJECT_VERSION = 526;
CURRENT_PROJECT_VERSION = 527;
DEAD_CODE_STRIPPING = YES;
DEVELOPMENT_TEAM = CS727NF72U;
ENABLE_APP_SANDBOX = YES;

View file

@ -67,7 +67,7 @@
> Latest release: **v0.5.5**
> Platform target: **macOS 26 (Tahoe)** compatible with **macOS Sequoia**
> Apple Silicon: tested / Intel: not tested
> Last updated (README): **2026-03-16** for release line **v0.5.4**
> Last updated (README): **2026-03-16** for release line **v0.5.5**
## Start Here
@ -96,6 +96,7 @@
<a href="#download-metrics">Download Metrics</a> ·
<a href="#project-docs">Project Docs</a> ·
<a href="#features">Features</a> ·
<a href="#share-shot-code-snapshot-highlight">Share Shot</a> ·
<a href="#platform-matrix">Platform Matrix</a><br>
<a href="#roadmap-near-term">Roadmap (Near Term)</a> ·
<a href="#troubleshooting">Troubleshooting</a> ·
@ -171,6 +172,7 @@
- Added a dedicated large-file open mode with deferred first paint and chunked text installation, so ultra-large files no longer depend on a single blocking initial render.
- Added per-session large-file modes directly in the editor UI: `Standard`, `Deferred`, and `Plain Text`.
- Added clearer large-file status chrome with line counts and session indicators in the editor/status surfaces.
- Added Share Shot (`Code Snapshot`) workflow with the toolbar `camera.viewfinder` action and an export/share composer.
- Fixed large-file responsiveness regressions across project-sidebar reopen, tab switching, and status updates.
- Fixed large-file editor stability issues around line-number visibility and blank/flickering content during heavy-file workflows.
@ -284,6 +286,7 @@ Platform-specific availability is tracked in the [Platform Matrix](#platform-mat
<p align="center">
<img alt="Themes" src="https://img.shields.io/badge/Themes-Prism%20Daylight-DB2777?style=for-the-badge">
<img alt="Tabs" src="https://img.shields.io/badge/Tabs-Double--Click%20Close-4F46E5?style=for-the-badge">
<img alt="Share Shot" src="https://img.shields.io/badge/Share%20Shot-camera.viewfinder-F97316?style=for-the-badge">
</p>
### Editing Core
@ -309,6 +312,22 @@ Platform-specific availability is tracked in the [Platform Matrix](#platform-mat
- Built-in theme collection: Dracula, One Dark Pro, Nord, Tokyo Night, Gruvbox, and Neon Glow.
- Grouped settings, optional StoreKit support flow, and AI Activity Log diagnostics on macOS.
## Share Shot (Code Snapshot) Highlight
Create polished share images directly from your selected code.
<p align="center">
<a href="docs/images/code-snapshot-showcase.svg">
<img src="docs/images/code-snapshot-showcase.svg" alt="Code Snapshot preview showing styled code card on gradient background" width="920">
</a><br>
<sub>Styled export preview for social sharing, changelogs, and issue discussions.</sub>
</p>
- Toolbar button: click the `camera.viewfinder` icon in the top toolbar (`Create Code Snapshot`).
- Selection menu: right-click selected text and choose `Create Code Snapshot`.
- Composer controls: choose appearance, background, frame style, line numbers, and padding.
- Export: use `Share` to generate a PNG snapshot and share/save it.
## Architecture At A Glance
```mermaid
@ -614,7 +633,7 @@ Latest stable: **v0.5.5** (2026-03-16)
| Version | Date | Highlights | Fixes | Breaking changes | Migration |
|---|---|---|---|---|---|
| [`v0.5.5`](https://github.com/h3pdesign/Neon-Vision-Editor/releases/tag/v0.5.5) | 2026-03-16 | Stabilized first-open rendering from the project sidebar so file content and syntax highlighting appear on first click without requiring tab switches; Hardened startup/session behavior so `Reopen Last Session` reliably wins over conflicting blank-document startup states; Refined large-file activation and loading placeholders to avoid misclassifying smaller files as large-file sessions | a session-restore regression where previously open files could appear empty on first sidebar click until changing tabs; highlight scheduling during document-state transitions (`switch`, `finish load`, external edits) on macOS, iOS, and iPadOS; startup-default conflicts by aligning defaults and runtime startup gating between `Reopen Last Session` and `Open with Blank Document` | None noted | None required |
| [`v0.5.5`](https://github.com/h3pdesign/Neon-Vision-Editor/releases/tag/v0.5.5) | 2026-03-16 | Stabilized first-open rendering from the project sidebar so file content and syntax highlighting appear on first click without requiring tab switches; Hardened startup/session behavior so `Reopen Last Session` reliably wins over conflicting blank-document startup states; Refined large-file activation and loading placeholders to avoid misclassifying smaller files as large-file sessions; Added Share Shot (`Code Snapshot`) creation via toolbar/selection action (`camera.viewfinder`) with styled export composer | a session-restore regression where previously open files could appear empty on first sidebar click until changing tabs; highlight scheduling during document-state transitions (`switch`, `finish load`, external edits) on macOS, iOS, and iPadOS; startup-default conflicts by aligning defaults and runtime startup gating between `Reopen Last Session` and `Open with Blank Document` | None noted | None required |
| [`v0.5.4`](https://github.com/h3pdesign/Neon-Vision-Editor/releases/tag/v0.5.4) | 2026-03-13 | a dedicated large-file open mode with deferred first paint, chunked text installation, and an optional plain-text session mode for ultra-large documents | large-file responsiveness regressions across project-sidebar reopen, tab switching, line-number visibility, status metrics, and large-file editor rendering stability | None noted | None required |
| [`v0.5.3`](https://github.com/h3pdesign/Neon-Vision-Editor/releases/tag/v0.5.3) | 2026-03-10 | a new high-readability colorful light theme preset: `Prism Daylight` (also selectable while app appearance is set to dark); double-click-to-close behavior for tabs on macOS tab strips; custom theme vibrancy by applying the vivid neon syntax profile to `Custom`, so syntax colors remain bright and saturated | toolbar-symbol contrast edge cases in dark mode where gray/black variants could appear too similar | None noted | None required |

View file

@ -47,6 +47,10 @@ This index describes screenshot assets in `docs/images` and where they are used.
- Source: `scripts/update_release_history_svg.py`.
- Used in: Root `README.md` (`Release Flow (Completed + Upcoming)`, light/default scheme).
- `code-snapshot-showcase.svg`
- Description: Styled visual mock for the Share Shot / Code Snapshot feature highlight.
- Used in: Root `README.md` (`Share Shot (Code Snapshot) Highlight`).
## Notes
- App Store media is managed in App Store Connect and linked from the root `README.md`.

View file

@ -0,0 +1,55 @@
<svg xmlns="http://www.w3.org/2000/svg" width="1600" height="1200" viewBox="0 0 1600 1200" role="img" aria-label="Code Snapshot styled preview">
<defs>
<linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
<stop offset="0%" stop-color="#ff7b54"/>
<stop offset="100%" stop-color="#f04db8"/>
</linearGradient>
<linearGradient id="title" x1="0" y1="0" x2="1" y2="0">
<stop offset="0%" stop-color="#1e1b30"/>
<stop offset="100%" stop-color="#161429"/>
</linearGradient>
<filter id="shadow" x="-20%" y="-20%" width="140%" height="140%">
<feDropShadow dx="0" dy="16" stdDeviation="18" flood-color="#0f172a" flood-opacity="0.45"/>
</filter>
</defs>
<rect x="0" y="0" width="1600" height="1200" fill="url(#bg)"/>
<g filter="url(#shadow)">
<rect x="130" y="110" width="1340" height="980" rx="52" fill="#111427"/>
<rect x="130" y="110" width="1340" height="92" rx="52" fill="url(#title)"/>
<rect x="130" y="170" width="1340" height="32" fill="url(#title)"/>
<circle cx="190" cy="156" r="13" fill="#ff5f57"/>
<circle cx="230" cy="156" r="13" fill="#febc2e"/>
<circle cx="270" cy="156" r="13" fill="#28c840"/>
<text x="1300" y="163" text-anchor="end" fill="#b8bfd8" font-family="ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace" font-size="34" font-weight="600">Code Snapshot</text>
<g font-family="ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace" font-size="44">
<text x="210" y="280" fill="#6d7693">1</text>
<text x="270" y="280" fill="#f472b6">## Share Shot Highlight</text>
<text x="210" y="350" fill="#6d7693">2</text>
<text x="270" y="350" fill="#f8fafc">Select code and click</text>
<text x="900" y="350" fill="#22d3ee">camera.viewfinder</text>
<text x="210" y="420" fill="#6d7693">3</text>
<text x="270" y="420" fill="#f8fafc">Open styled composer, tweak frame + colors,</text>
<text x="210" y="490" fill="#6d7693">4</text>
<text x="270" y="490" fill="#f8fafc">then press</text>
<text x="560" y="490" fill="#60a5fa">Share</text>
<text x="720" y="490" fill="#f8fafc">to export PNG.</text>
<text x="210" y="630" fill="#6d7693">5</text>
<text x="270" y="630" fill="#c084fc">- Toolbar: Create Code Snapshot</text>
<text x="210" y="700" fill="#6d7693">6</text>
<text x="270" y="700" fill="#34d399">- Context menu: Create Code Snapshot</text>
<text x="210" y="770" fill="#6d7693">7</text>
<text x="270" y="770" fill="#f59e0b">- Output: share-ready visual code card</text>
</g>
</g>
</svg>

After

Width:  |  Height:  |  Size: 2.6 KiB