Add missing files.

Author: dereuromark

.gitignore

@@ -19,7 +19,8 @@ composer.lock
 
 # Testing
 /coverage/
-.phpunit.result.cache
+/.phpunit.result.cache
+/.phpunit.cache/
 
 # Temporary files
 *.log

CHANGELOG.md

@@ -7,7 +7,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## [1.0.0] - 2024-XX-XX
+## [0.1.0] - 2025-XX-XX
 
 ### Added
 
@@ -25,12 +25,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Dark mode CSS support
 - Multisite compatible
 - Clean uninstall (removes all options)
+- Gutenberg block editor support with live preview
+  - Native "Djot" block for the block editor
+  - REST API endpoint for server-side preview rendering
+  - Toggle between edit and preview modes
+- WP-CLI migration commands for converting existing content to Djot
+  - `wp djot analyze` - Analyze posts for migration complexity
+  - `wp djot migrate` - Migrate posts from HTML/Markdown to Djot
+  - `wp djot rollback` - Restore posts to original content
+  - `wp djot status` - View migration statistics
+- Content migration from HTML to Djot (using djot-php HtmlToDjot converter)
+- Content migration from Markdown to Djot (using djot-php MarkdownToDjot converter)
+- Automatic backup of original content before migration
+- Complexity analysis (none, low, medium, high) for migration planning
+- Dry-run mode with diff preview
+- Batch processing with progress bar
+- Preservation of WordPress shortcodes during migration
+- Preservation of Gutenberg blocks during migration
 
 ### Security
 
 - Safe mode enabled by default for untrusted content
 - Comments always processed with safe mode
 - XSS protection via djot-php safe mode
 
-[Unreleased]: https://github.com/php-collective/wp-djot/compare/v1.0.0...HEAD
-[1.0.0]: https://github.com/php-collective/wp-djot/releases/tag/v1.0.0
+[Unreleased]: https://github.com/php-collective/wp-djot/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/php-collective/wp-djot/releases/tag/v0.1.0

README.md

@@ -14,13 +14,15 @@ Djot is a light markup syntax created by John MacFarlane (creator of CommonMark
 ## Features
 
 - **Full Djot Support**: Headings, emphasis, links, images, code blocks, tables, footnotes, and more
+- **Block Editor Support**: Native Gutenberg block for writing Djot with live preview
 - **Shortcode Support**: Use `[djot]...[/djot]` in your content
 - **Content Filtering**: Automatically process `{djot}...{/djot}` blocks in posts and pages
 - **Safe Mode**: XSS protection for untrusted content (enabled by default for comments)
 - **Syntax Highlighting**: Built-in highlight.js integration with multiple themes
 - **Admin Settings**: Easy configuration through WordPress admin
 - **Template Tags**: `djot_to_html()` and `the_djot()` for theme developers
 - **Dark Mode Support**: CSS automatically adapts to dark mode preferences
+- **WP-CLI Migration**: Migrate existing HTML/Markdown content to Djot with rollback support
 
 ## Requirements
 
@@ -47,6 +49,16 @@ Search for "WP Djot" in the WordPress plugin directory.
 
 ## Usage
 
+### Block Editor (Gutenberg)
+
+Add a **Djot** block from the block inserter (search for "Djot"). The block provides:
+
+- A code editor for writing Djot markup
+- Live preview toggle in the sidebar
+- Server-side rendering for accurate output
+
+Simply write your Djot content and toggle preview to see the rendered HTML.
+
 ### Shortcode
 
 ```
@@ -161,37 +173,86 @@ add_filter('wp_djot_post_convert', function(string $html): string {
 });
 ```
 
-## Development
+## WP-CLI Commands
 
-### Running Tests
+Migrate existing HTML or Markdown content to Djot format using WP-CLI.
+
+### Analyze Content
+
+Analyze posts to determine migration complexity before converting:
 
 ```bash
-composer install
-composer test
+# Analyze all posts and pages
+wp djot analyze
+
+# Analyze a specific post
+wp djot analyze --post-id=123
+
+# Analyze only posts, limit to 10
+wp djot analyze --post-type=post --limit=10
+
+# Output as JSON
+wp djot analyze --format=json
 ```
 
-### Code Style
+The analysis shows:
+- **Complexity**: none, low, medium, high
+- **Content types**: HTML, Markdown, Gutenberg blocks, shortcodes
+- **Auto-migrate**: Whether the post can be safely auto-migrated
+
+### Migrate Content
+
+Convert posts from HTML/Markdown to Djot:
 
 ```bash
-composer cs-check
-composer cs-fix
+# Migrate a single post
+wp djot migrate --post-id=123
+
+# Preview migration without saving (dry run)
+wp djot migrate --dry-run
+
+# Preview with content diff
+wp djot migrate --dry-run --show-diff --post-id=123
+
+# Migrate posts in batches
+wp djot migrate --post-type=post --limit=10
+
+# Force migration of high-complexity posts
+wp djot migrate --post-id=123 --force
 ```
 
-### Static Analysis
+**Features:**
+- Automatic backup of original content
+- Preserves WordPress shortcodes
+- Preserves Gutenberg blocks
+- Converts HTML tags to Djot syntax
+- Converts Markdown syntax to Djot
+
+### Rollback Migrations
+
+Restore posts to their original content:
 
 ```bash
-composer stan
+# Rollback a single post
+wp djot rollback --post-id=123
+
+# Rollback all migrated posts
+wp djot rollback --all
 ```
 
-## Contributing
+### Migration Status
 
-Contributions are welcome! Please feel free to submit a Pull Request.
+View migration statistics:
 
-1. Fork the repository
-2. Create your feature branch (`git checkout -b feature/amazing-feature`)
-3. Commit your changes (`git commit -m 'Add some amazing feature'`)
-4. Push to the branch (`git push origin feature/amazing-feature`)
-5. Open a Pull Request
+```bash
+wp djot status
+```
+
+Shows count of migrated posts, pending posts, and complexity distribution.
+
+## Contributing
+
+Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
 
 ## License
 
@@ -205,12 +266,13 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ## Changelog
 
-### 1.0.0
+See [CHANGELOG.md](CHANGELOG.md) for full history.
+
+### 0.1.0
 
-- Initial release
-- Full Djot syntax support
+- Initial release with full Djot syntax support
 - Shortcode and content filtering
-- Admin settings page
-- Syntax highlighting with highlight.js
+- Admin settings page with syntax highlighting
 - Safe mode for untrusted content
 - Template tags for theme developers
+- WP-CLI migration commands for HTML/Markdown to Djot conversion

assets/blocks/djot/block.json

@@ -0,0 +1,26 @@
+{
+    "$schema": "https://schemas.wp.org/trunk/block.json",
+    "apiVersion": 3,
+    "name": "wp-djot/djot",
+    "version": "0.1.0",
+    "title": "Djot",
+    "category": "text",
+    "icon": "editor-code",
+    "description": "Write content using Djot markup language.",
+    "keywords": ["djot", "markup", "markdown", "text"],
+    "supports": {
+        "html": false,
+        "align": ["wide", "full"],
+        "className": true
+    },
+    "textdomain": "wp-djot",
+    "attributes": {
+        "content": {
+            "type": "string",
+            "default": ""
+        }
+    },
+    "editorScript": "file:./index.js",
+    "editorStyle": "file:./editor.css",
+    "render": "file:./render.php"
+}

assets/blocks/djot/editor.css

@@ -0,0 +1,127 @@
+.wp-djot-block {
+    border: 1px solid #ddd;
+    border-radius: 4px;
+    background: #fff;
+}
+
+.wp-djot-block-wrapper {
+    padding: 0;
+}
+
+.wp-djot-block .wp-djot-editor textarea {
+    font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono", monospace;
+    font-size: 13px;
+    line-height: 1.6;
+    min-height: 200px;
+    width: 100%;
+    padding: 16px;
+    border: none;
+    border-radius: 4px;
+    resize: vertical;
+    background: #f9f9f9;
+}
+
+.wp-djot-block .wp-djot-editor textarea:focus {
+    outline: none;
+    box-shadow: none;
+    background: #fff;
+}
+
+.wp-djot-block .components-base-control__label {
+    display: none;
+}
+
+.wp-djot-preview-wrapper {
+    background: #fff;
+}
+
+.wp-djot-preview-header {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    padding: 8px 16px;
+    background: #f0f0f0;
+    border-bottom: 1px solid #ddd;
+    font-size: 12px;
+    font-weight: 500;
+    text-transform: uppercase;
+    color: #666;
+}
+
+.wp-djot-edit-button {
+    background: #007cba;
+    color: #fff;
+    border: none;
+    border-radius: 3px;
+    padding: 4px 12px;
+    font-size: 12px;
+    cursor: pointer;
+    text-transform: none;
+}
+
+.wp-djot-edit-button:hover {
+    background: #005a87;
+}
+
+.wp-djot-preview {
+    padding: 16px;
+    min-height: 100px;
+}
+
+.wp-djot-preview:empty::before {
+    content: "Preview will appear here...";
+    color: #999;
+    font-style: italic;
+}
+
+/* Djot content styles in editor */
+.wp-djot-preview.djot-content h1,
+.wp-djot-preview.djot-content h2,
+.wp-djot-preview.djot-content h3,
+.wp-djot-preview.djot-content h4,
+.wp-djot-preview.djot-content h5,
+.wp-djot-preview.djot-content h6 {
+    margin-top: 0;
+}
+
+.wp-djot-preview.djot-content pre {
+    background: #f4f4f4;
+    padding: 12px;
+    border-radius: 4px;
+    overflow-x: auto;
+}
+
+.wp-djot-preview.djot-content code {
+    background: #f4f4f4;
+    padding: 2px 6px;
+    border-radius: 3px;
+    font-size: 0.9em;
+}
+
+.wp-djot-preview.djot-content pre code {
+    background: none;
+    padding: 0;
+}
+
+.wp-djot-preview.djot-content blockquote {
+    border-left: 4px solid #ddd;
+    margin-left: 0;
+    padding-left: 16px;
+    color: #666;
+}
+
+/* Placeholder styles */
+.wp-djot-block .components-placeholder {
+    min-height: auto;
+    padding: 24px;
+}
+
+.wp-djot-block .components-placeholder .wp-djot-editor textarea {
+    margin-top: 16px;
+}
+
+/* Loading spinner */
+.wp-djot-preview-wrapper .components-spinner {
+    margin: 40px auto;
+    display: block;
+}