Add sqlite markdown edit command extension

Author: adamziel

.eslintignore

@@ -8,6 +8,7 @@ packages/playground/wordpress-builds/src/wordpress
 packages/playground/wordpress-builds/public
 packages/playground/sync/src/test/wp-*
 packages/php-wasm/node/src/test/__test*
+packages/playground/markdown-editor/src/assets/vendor/php-toolkit
 *.timestamp-1678999213403.mjs
 .local
 .vscode

.gitmodules

@@ -1,3 +1,6 @@
 [submodule "isomorphic-git"]
     path="isomorphic-git"
     url=https://github.com/adamziel/isomorphic-git.git
+[submodule "packages/playground/markdown-editor/src/assets/vendor/php-toolkit"]
+	path = packages/playground/markdown-editor/src/assets/vendor/php-toolkit
+	url = https://github.com/WordPress/php-toolkit.git

.nxignore

@@ -9,6 +9,7 @@ __pycache__
 packages/playground/wordpress-builds/src/wordpress
 packages/playground/wordpress-builds/public
 packages/php-wasm/node/src/test/__test*
+packages/playground/markdown-editor/src/assets/vendor/php-toolkit
 *.timestamp-1678999213403.mjs
 .local
 .vscode

package-lock.json

@@ -1444,9 +1444,11 @@ RUN export ASYNCIFY_IMPORTS=$'[\n\
 "sqlite_handle_closer",\
 "sqlite_handle_doer",\
 "sqlite_handle_preparer",\
+"sqlite3_auto_extension",\
 "sqlite3_autovacuum_pages",\
 "sqlite3_backup_step",\
 "sqlite3_bind_pointer",\
+"sqlite3_cancel_auto_extension",\
 "sqlite3_exec",\
 "sqlite3_finalize",\
 "sqlite3_free",\

packages/php-wasm/compile/php/Dockerfile

@@ -1461,9 +1461,11 @@ RUN export ASYNCIFY_IMPORTS=$'[\n\
 "sqlite_handle_closer",\
 "sqlite_handle_doer",\
 "sqlite_handle_preparer",\
+"sqlite3_auto_extension",\
 "sqlite3_autovacuum_pages",\
 "sqlite3_backup_step",\
 "sqlite3_bind_pointer",\
+"sqlite3_cancel_auto_extension",\
 "sqlite3_exec",\
 "sqlite3_finalize",\
 "sqlite3_free",\

packages/php-wasm/compile/php/Dockerfile-5-2

@@ -156,6 +156,26 @@ with `extension=` or `zend_extension=` in php.ini:
 }
 ```
 
+### Editing Markdown Directories
+
+The `edit-markdown` command opens a directory of Markdown files in wp-admin and
+writes block editor saves back to disk:
+
+```bash
+npx @wp-playground/cli@latest edit-markdown ./content
+```
+
+It loads the bundled `sqlite_markdown` PHP.wasm extension, mounts the Markdown
+directory at `/markdown-root`, and installs a small mu-plugin that maps
+`wp_posts` and `wp_postmeta` to writable SQLite virtual tables.
+
+When running from a Playground source checkout, build the extension artifacts
+first:
+
+```bash
+npx nx run playground-markdown-editor:build:sqlite-markdown-extension
+```
+
 ## Need some help with the CLI?
 
 With the Playground CLI, you can use the `--help` to get some support about the available commands.

packages/playground/cli/README.md

@@ -31,6 +31,9 @@
 	"main": "./index.cjs",
 	"module": "./index.js",
 	"types": "index.d.ts",
+	"dependencies": {
+		"@wp-playground/markdown-editor": "3.1.30"
+	},
 	"bin": {
 		"wp-playground-cli": "wp-playground.js"
 	},

packages/playground/cli/package.json

@@ -35,6 +35,7 @@ import {
 	parseMountDirArguments,
 	parseMountWithDelimiterArguments,
 } from './mounts';
+import { expandEditMarkdownCommandArgs } from '@wp-playground/markdown-editor';
 import {
 	parseDefineStringArguments,
 	parseDefineBoolArguments,
@@ -532,6 +533,18 @@ export async function parseOptionsAndRunCLI(argsToParse: string[]) {
 			.command('php', 'Run a PHP script', (yargsInstance: Argv) =>
 				yargsInstance.options({ ...sharedOptions })
 			)
+			.command(
+				'edit-markdown <dir>',
+				'Open a directory of Markdown files in the block editor',
+				(yargsInstance: Argv) =>
+					yargsInstance
+						.positional('dir', {
+							describe: 'Directory tree of .md files to mount.',
+							type: 'string',
+							demandOption: true,
+						})
+						.options(startCommandOptions)
+			)
 			.demandCommand(1, 'Please specify a command')
 			.strictCommands()
 			.conflicts(
@@ -689,6 +702,7 @@ export async function parseOptionsAndRunCLI(argsToParse: string[]) {
 				'server',
 				'build-snapshot',
 				'php',
+				'edit-markdown',
 			].includes(command)
 		) {
 			yargsObject.showHelp();
@@ -727,7 +741,7 @@ export async function parseOptionsAndRunCLI(argsToParse: string[]) {
 			}
 		}
 
-		const cliArgs = {
+		let cliArgs = {
 			...args,
 			define,
 			command,
@@ -741,6 +755,10 @@ export async function parseOptionsAndRunCLI(argsToParse: string[]) {
 			],
 		} as RunCLIArgs;
 
+		if (command === 'edit-markdown') {
+			cliArgs = expandEditMarkdownCommandArgs(cliArgs) as RunCLIArgs;
+		}
+
 		const cliServer = await runCLI(cliArgs);
 		if (cliServer === undefined) {
 			// No server was started, so we are done with our work.
@@ -876,7 +894,13 @@ export interface RunCLIArgs {
 		| BlueprintV1Declaration
 		| BlueprintV2Declaration
 		| BlueprintBundle;
-	command: 'start' | 'server' | 'run-blueprint' | 'build-snapshot' | 'php';
+	command:
+		| 'start'
+		| 'server'
+		| 'run-blueprint'
+		| 'build-snapshot'
+		| 'php'
+		| 'edit-markdown';
 	debug?: boolean;
 	login?: boolean;
 	mount?: Mount[];
@@ -1800,6 +1824,14 @@ export async function runCLI(args: RunCLIArgs): Promise<RunCLIServer | void> {
 	if (server && args.command === 'start' && !args.skipBrowser) {
 		openInBrowser(server.serverUrl);
 	}
+	if (server && args.command === 'edit-markdown' && !args.skipBrowser) {
+		openInBrowser(
+			new URL(
+				'/wp-admin/edit.php?post_type=page',
+				server.serverUrl
+			).toString()
+		);
+	}
 	return server;
 }
 

packages/playground/cli/src/run-cli.ts

@@ -0,0 +1,10 @@
+{
+	"extends": "../../../.eslintrc.json",
+	"ignorePatterns": ["!**/*"],
+	"overrides": [
+		{
+			"files": ["*.ts", "*.tsx", "*.js", "*.jsx"],
+			"rules": {}
+		}
+	]
+}