chore: update version references and consolidate agent documentation

Author: ajaydsouza

AGENTS.md

@@ -1,6 +1,6 @@
 # AGENTS.md
 
-WordPress plugin extending the native Gutenberg `core/code` block with syntax highlighting via JS block filters and a `render_block_core/code` PHP filter. Does not replace the block — existing posts stay valid.
+**WebberZone Code Block Highlighting** v1.1.0. WordPress plugin extending the native Gutenberg `core/code` block with syntax highlighting via JS block filters and a `render_block_core/code` PHP filter. Does not replace the block — existing posts stay valid. Namespace: `WebberZone\Code_Block_Highlighting`. Requires WordPress 6.6+, PHP 7.4+. No Freemius.
 
 Two highlighting modes:
 - **Client-side** (default): Prism.js runs in the browser. Loads the Prism JS bundle + theme CSS.
@@ -24,11 +24,6 @@ npm run start          # Watch mode for block/editor/frontend bundles
 npm run zip            # Plugin zip
 ```
 
-## Source of truth
-
-- Active implementation plan: `PLAN.md`
-- Backlog/reference only: `OLD-FEATURE-PLAN.md` — do not assume features exist unless implemented in code.
-
 ## Architecture
 
 **Namespace:** `WebberZone\Code_Block_Highlighting`
@@ -37,9 +32,9 @@ Bootstrap: `wzcbh()` singleton on `plugins_loaded` → instantiates `Frontend\Bl
 
 Key files:
 - `includes/class-main.php` — bootstrap and object wiring
-- `includes/frontend/class-blocks.php` — editor assets, REST route, `render_block_core/code`
-- `includes/frontend/class-styles-handler.php` — conditional Prism asset loading
-- `includes/admin/class-settings.php` — settings registration, theme resolution
+- `includes/frontend/class-blocks.php` — editor assets, REST route, `render_block_core/code` filter; `render_code_block_server()` for server mode; `remap_token_classes()` for hljs→Prism class mapping
+- `includes/frontend/class-styles-handler.php` — conditional asset loading for both modes: client (Prism JS + theme CSS) and server (theme CSS + `hljs-server-mode.css`, no JS)
+- `includes/admin/class-settings.php` — settings registration; `get_color_scheme_css()` always returns Prism CSS URL (no per-mode branch)
 - `includes/blocks/src/js/index.js` — block filter, Inspector Controls
 - `includes/blocks/src/js/frontend.js` — Prism grammars + plugins
 
@@ -61,9 +56,32 @@ Always `require` the generated `.asset.php` manifest before enqueueing block scr
 
 **If you change block attributes in JS**, update `render_code_block()` in `class-blocks.php` and the defaults flow as well.
 
+## Non-obvious implementation details
+
+**`_legacyTitle` attribute** — read-only migration attribute; copies `title` from old `code-syntax-block` format on first load, then clears itself.
+
+**`maxHeight`** — CSS-only: serialized as inline `style` by the block save function, not touched by the PHP render filter.
+
+**`wzcbh_languages` filter** — controls the editor UI dropdown only. Does not affect which Prism grammars are bundled. Adding a slug without a matching grammar import in `frontend.js` results in plain-text output.
+
+**Editor canvas styling** — `enqueue_editor_canvas_styles()` extracts only `background` and `color` from the active Prism theme CSS and re-injects them with `.block-editor-block-list__layout` prepended to win the specificity race against the editor's own `pre` styles.
+
+**Server-mode token remapping** — `remap_token_classes()` in `class-blocks.php` uses `strtr()` to convert every `class="hljs-*"` span emitted by highlight.php into the equivalent Prism `class="token *"` span. Keys are ordered longest-first to prevent prefix collisions.
+
+**highlight.php autoloader** — `\Highlight\Autoloader::register()` does not exist. Use `spl_autoload_register(static function(string $class_name): void { \Highlight\Autoloader::load($class_name); })`.
+
+**`hljs-server-mode.css`** — only handles `.wzcbh-highlighted-line` line highlighting. Font-size, line-numbers gutter, and word-wrap are all in `frontend.css` (webpack build), which loads in both modes.
+
+**Both modes use the same Prism theme CSS** — `Settings::get_color_scheme_css()` always returns the Prism CSS URL. There is no per-mode branch.
+
+**Default color scheme:** `prism-onedark`
+
 ## Asset loading
 
-Prism assets load only on pages containing at least one `core/code` block (`Styles_Handler::enqueue_assets()`). Use `wzcbh_force_load_assets` to override.
+Assets load only on pages containing at least one `core/code` block (`Styles_Handler::enqueue_assets()`). Use `wzcbh_force_load_assets` to override.
+
+- **Client mode**: `frontend.css` + Prism theme CSS + `wzcbh-prism-js` script bundle
+- **Server mode**: `frontend.css` + Prism theme CSS + `hljs-server-mode.css` (no JS; syntax already pre-rendered in HTML)
 
 ## Filters and routes
 

CLAUDE.md

@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Plugin Overview
 
-**WebberZone Code Block Highlighting** (plugin slug: `webberzone-code-block-highlighting`) extends the native Gutenberg `core/code` block with syntax highlighting via JS block filters and a `render_block_core/code` PHP filter. Does not replace the block — existing posts stay valid. Namespace: `WebberZone\Code_Block_Highlighting`. Requires WordPress 6.6+, PHP 7.4+. No Freemius.
+**WebberZone Code Block Highlighting** v1.1.0 (plugin slug: `webberzone-code-block-highlighting`) extends the native Gutenberg `core/code` block with syntax highlighting via JS block filters and a `render_block_core/code` PHP filter. Does not replace the block — existing posts stay valid. Namespace: `WebberZone\Code_Block_Highlighting`. Requires WordPress 6.6+, PHP 7.4+. No Freemius.
 
 Two highlighting modes:
 - **Client-side** (default): Prism.js runs in the browser. Loads the Prism JS bundle + theme CSS.
@@ -31,11 +31,6 @@ npm run start          # Watch mode for block/editor/frontend bundles
 npm run zip            # Plugin zip
 ```
 
-## Source of truth
-
-- Active implementation plan: `PLAN.md`
-- Backlog/reference only: `OLD-FEATURE-PLAN.md` — do not assume features exist unless implemented in code.
-
 ## Architecture
 
 **Namespace:** `WebberZone\Code_Block_Highlighting`

includes/frontend/class-blocks.php

@@ -618,7 +618,7 @@ static function () use ( $new_code ): string {
 	 * server mode reuse the Prism theme CSS directly, giving exact theme parity
 	 * across all 21 themes with no per-theme hljs CSS files needed.
 	 *
-	 * @since 1.3.0
+	 * @since 1.1.0
 	 *
 	 * @param string $html Highlighted HTML from highlight.php.
 	 * @return string HTML with hljs class names replaced by Prism token class names.