add migration command cli from tabs block

MIGRATION.md

@@ -0,0 +1,86 @@
+# Migrating from `beapi/tabs-block` to `blockparty-tabs`
+
+This document describes how to move from the abandoned [`beapi/tabs-block`](https://github.com/BeAPI/beapi-tabs-block) package to `beapi/blockparty-tabs`.
+
+## Package swap
+
+```bash
+composer remove beapi/tabs-block
+composer require beapi/blockparty-tabs
+```
+
+Activate `blockparty-tabs` and deactivate `beapi-tabs-block` (or `tabs-block`).
+
+## Block model changes
+
+| Old | New |
+|---|---|
+| `beapi/tabs` | `blockparty/tabs` |
+| `beapi/tabs-nav` | `blockparty/tabs-nav` |
+| `beapi/tabs-nav-item` | `blockparty/tabs-nav-item` |
+| `beapi/tabs-panels` | `blockparty/tabs-panels` |
+| `beapi/tabs-panel-item` | `blockparty/tabs-panel-item` |
+| Parent `title` (saved as `aria-label` on the root) | `ariaLabel` on `blockparty/tabs-nav` |
+| CSS `.wp-block-beapi-tabs` | CSS `.wp-block-blockparty-tabs` |
+
+Nested structure (nav + panels, paired nav/panel items) is preserved. Icons inside tab labels keep working when `blockparty-icons` or `beapi/icon-block` is active (`blockparty_tabs_allowed_icon_blocks` filter).
+
+## Content migration (WP-CLI)
+
+WP-CLI only loads **active** plugins. If you see `'blockparty-tabs' is not a registered wp command`, activate the plugin first:
+
+```bash
+wp plugin activate blockparty-tabs
+```
+
+After activating `blockparty-tabs` and updating theme allowlists:
+
+```bash
+# Preview (current site)
+wp blockparty-tabs migrate-from-tabs-block --dry-run
+
+# Apply on the current site
+wp blockparty-tabs migrate-from-tabs-block
+
+# Limit post types
+wp blockparty-tabs migrate-from-tabs-block --post-type=post,page
+```
+
+The command always targets **one site only**. On multisite, repeat it yourself with `--url=` for each site:
+
+```bash
+wp blockparty-tabs migrate-from-tabs-block --url=https://example.com/
+```
+
+The command:
+
+1. Scans `post_content` for `beapi/tabs*` block comments and legacy class names
+2. Parses blocks, converts markup recursively, serializes back
+3. Moves the parent `title` attribute to `ariaLabel` on `blockparty/tabs-nav`
+4. Aligns saved HTML with blockparty-tabs `save()` output (ARIA roles, `is-active` / `is-hidden` classes)
+5. Updates posts with `wp_slash()` on content
+6. Logs migrated / skipped counts
+
+### Revisions
+
+Only the scanned post types are migrated (public REST post types + `wp_block` by default). **Revisions are not included** unless you pass them explicitly:
+
+```bash
+wp blockparty-tabs migrate-from-tabs-block --post-type=revision
+```
+
+### Duplicate Post (Yoast)
+
+If [Yoast Duplicate Post](https://wordpress.org/plugins/duplicate-post/) is active, updating a Rewrite & Republish **copy** via `wp_update_post()` can abort the WP-CLI run.
+
+Preferred workaround: skip that plugin for the migration only:
+
+```bash
+wp --skip-plugins=duplicate-post blockparty-tabs migrate-from-tabs-block --url=https://example.com/
+```
+
+## Front-end checklist
+
+- Update theme allowlists from `beapi/tabs*` to `blockparty/tabs*`
+- Update theme SCSS selectors from `.wp-block-beapi-tabs` to `.wp-block-blockparty-tabs`
+- Smoke-test top alignment and sidebar layouts, keyboard navigation, and nested tabs

blockparty-tabs.php

@@ -14,6 +14,12 @@
 
 namespace Blockparty\Tabs;
 
+use Blockparty\Tabs\Cli\MigrateFromTabsBlockCommand;
+
+if ( is_readable( __DIR__ . '/vendor/autoload.php' ) ) {
+	include_once __DIR__ . '/vendor/autoload.php';
+}
+
 define( 'BLOCKPARTY_TABS_VERSION', '2.0.1' );
 define( 'BLOCKPARTY_TABS_URL', plugin_dir_url( __FILE__ ) );
 define( 'BLOCKPARTY_TABS_DIR', plugin_dir_path( __FILE__ ) );
@@ -174,3 +180,7 @@ function register_react_jsx_runtime( $scripts ): void {
 }
 
 add_action( 'wp_default_scripts', __NAMESPACE__ . '\\register_react_jsx_runtime' );
+
+if ( defined( 'WP_CLI' ) && WP_CLI && class_exists( MigrateFromTabsBlockCommand::class ) ) {
+	\WP_CLI::add_command( 'blockparty-tabs migrate-from-tabs-block', MigrateFromTabsBlockCommand::class );
+}

composer.json

@@ -1,50 +1,60 @@
 {
-  "name": "beapi/blockparty-tabs",
-  "description": "Accessible Tabs block for WordPress gutenberg.",
-  "type": "wordpress-plugin",
-  "keywords": ["wordpress", "plugin", "tabs", "gutenberg"],
-  "license": "GPL-2.0-or-later",
-  "authors": [
-    {
-      "name": "BeAPI",
-      "email": "technique@beapi.fr"
-    }
-  ],
-  "config": {
-    "optimize-autoloader": true,
-    "preferred-install": "dist",
-    "sort-packages": true,
-    "allow-plugins": {
-      "dealerdirect/phpcodesniffer-composer-installer": true,
-      "composer/installers": true,
-      "phpro/grumphp-shim": true
-    },
-    "platform": {
-      "php": "8.1.99"
-    }
-  },
-  "require": {
-    "php": "^8.1",
-    "composer/installers": "^1.0 || ^2.0"
-  },
-  "require-dev": {
-    "dealerdirect/phpcodesniffer-composer-installer": "^1.0",
-    "overtrue/phplint": "^9.1",
-    "php-parallel-lint/php-parallel-lint": "^1.3",
-    "phpcompatibility/phpcompatibility-wp": "^2.1",
-    "phpro/grumphp-shim": "^1.5",
-    "phpunit/phpunit": "9.6.37",
-    "roave/security-advisories": "dev-latest",
-    "wp-coding-standards/wpcs": "^3.0",
-    "wp-phpunit/wp-phpunit": "7.1.1",
-    "yoast/phpunit-polyfills": "4.0.0"
-  },
-  "scripts": {
-    "cs": "./vendor/bin/phpcs",
-    "cb": "./vendor/bin/phpcbf"
-  },
-  "scripts-descriptions": {
-    "cs": "Run PHP CodeSniffer on codebase using custom ruleset.",
-    "cb": "Run PHP Code Beautifier and Fixer on codebase using custom ruleset."
-  }
-}
+	"name": "beapi/blockparty-tabs",
+	"description": "Accessible Tabs block for WordPress gutenberg.",
+	"type": "wordpress-plugin",
+	"keywords": [
+		"wordpress",
+		"plugin",
+		"tabs",
+		"gutenberg"
+	],
+	"license": "GPL-2.0-or-later",
+	"authors": [
+		{
+			"name": "BeAPI",
+			"email": "technique@beapi.fr"
+		}
+	],
+	"config": {
+		"optimize-autoloader": true,
+		"preferred-install": "dist",
+		"sort-packages": true,
+		"allow-plugins": {
+			"dealerdirect/phpcodesniffer-composer-installer": true,
+			"composer/installers": true,
+			"phpro/grumphp-shim": true
+		},
+		"platform": {
+			"php": "8.1.99"
+		}
+	},
+	"autoload": {
+		"psr-4": {
+			"Blockparty\\Tabs\\": "includes/"
+		}
+	},
+	"require": {
+		"php": "^8.1",
+		"composer/installers": "^1.0 || ^2.0"
+	},
+	"require-dev": {
+		"dealerdirect/phpcodesniffer-composer-installer": "^1.0",
+		"overtrue/phplint": "^9.1",
+		"php-parallel-lint/php-parallel-lint": "^1.3",
+		"phpcompatibility/phpcompatibility-wp": "^2.1",
+		"phpro/grumphp-shim": "^1.5",
+		"phpunit/phpunit": "9.6.37",
+		"roave/security-advisories": "dev-latest",
+		"wp-coding-standards/wpcs": "^3.0",
+		"wp-phpunit/wp-phpunit": "7.1.1",
+		"yoast/phpunit-polyfills": "4.0.0"
+	},
+	"scripts": {
+		"cs": "./vendor/bin/phpcs",
+		"cb": "./vendor/bin/phpcbf"
+	},
+	"scripts-descriptions": {
+		"cs": "Run PHP CodeSniffer on codebase using custom ruleset.",
+		"cb": "Run PHP Code Beautifier and Fixer on codebase using custom ruleset."
+	}
+}