wp-migrate-core 0.1.0-demo

package/dist/src/types.d.ts

@@ -0,0 +1,83 @@
+export type OutputTarget = "astro" | "next" | "nuxt";
+export type WordPressContentType = "page" | "post";
+export type WordPressStatus = "publish" | "draft" | "future" | "pending" | "private" | "trash" | "inherit" | "unknown";
+export type SourceEditor = "classic" | "gutenberg" | "elementor" | "mixed";
+export type ConversionDisposition = "native" | "legacy-html" | "manual" | "blocked";
+export type MigrationNodeKind = "root" | "section" | "group" | "columns" | "column" | "paragraph" | "heading" | "list" | "quote" | "code" | "html" | "image" | "gallery" | "button" | "separator" | "spacer" | "embed" | "shortcode" | "form" | "query" | "unknown";
+export interface MigrationNode {
+    readonly id: string;
+    readonly source: "classic" | "gutenberg" | "elementor" | "shortcode";
+    readonly sourceType: string;
+    readonly kind: MigrationNodeKind;
+    readonly conversion: ConversionDisposition;
+    readonly attributes: Readonly<Record<string, unknown>>;
+    readonly children: readonly MigrationNode[];
+    readonly text?: string;
+    readonly rawHtml?: string;
+}
+export type MigrationIssueSeverity = "warning" | "blocker";
+export type MigrationIssueCode = "WXR_NO_ITEMS" | "WXR_ITEM_MISSING_ID" | "GUTENBERG_UNCLOSED_BLOCK" | "GUTENBERG_UNMATCHED_CLOSE" | "GUTENBERG_INVALID_ATTRIBUTES" | "GUTENBERG_DYNAMIC_BLOCK" | "GUTENBERG_MEDIA_UNSUPPORTED" | "GUTENBERG_UNKNOWN_BLOCK" | "SHORTCODE_UNSUPPORTED" | "ELEMENTOR_INVALID_DATA" | "ELEMENTOR_FORM_UNSUPPORTED" | "ELEMENTOR_QUERY_UNSUPPORTED" | "ELEMENTOR_IMAGE_REMOTE_MEDIA" | "ELEMENTOR_BUTTON_UNSAFE_URL" | "ELEMENTOR_WIDGET_UNKNOWN";
+export interface MigrationIssue {
+    readonly id: string;
+    readonly severity: MigrationIssueSeverity;
+    readonly code: MigrationIssueCode;
+    readonly sourceId: string;
+    readonly route?: string;
+    readonly nodeId?: string;
+    readonly title: string;
+    readonly message: string;
+    readonly evidence?: string;
+    readonly requiredAction: string;
+}
+export interface WordPressTerm {
+    readonly domain: string;
+    readonly nicename: string;
+    readonly name: string;
+}
+export type WordPressPostMeta = Readonly<Record<string, readonly string[]>>;
+export interface ContentRecord {
+    readonly sourceId: string;
+    readonly wordpressId: number;
+    readonly type: WordPressContentType;
+    readonly status: WordPressStatus;
+    readonly title: string;
+    readonly slug: string;
+    readonly route?: string;
+    readonly publishedAt?: string;
+    readonly modifiedAt?: string;
+    readonly author?: string;
+    readonly editor: SourceEditor;
+    readonly rawContent: string;
+    readonly meta: WordPressPostMeta;
+    readonly terms: readonly WordPressTerm[];
+    readonly nodes: readonly MigrationNode[];
+    readonly issues: readonly MigrationIssue[];
+}
+export interface MigrationSummary {
+    readonly records: number;
+    readonly pages: number;
+    readonly posts: number;
+    readonly nodes: number;
+    readonly nativeNodes: number;
+    readonly manualNodes: number;
+    readonly blockedNodes: number;
+    readonly reviewItems: number;
+    readonly warnings: number;
+    readonly blockers: number;
+}
+export interface MigrationProject {
+    readonly site: {
+        readonly title: string;
+        readonly url?: string;
+    };
+    readonly source: {
+        readonly title?: string;
+        readonly url?: string;
+    };
+    readonly records: readonly ContentRecord[];
+    readonly issues: readonly MigrationIssue[];
+    readonly summary: MigrationSummary;
+}
+export interface InspectOptions {
+    readonly includeDrafts?: boolean;
+}

package/dist/src/types.js

@@ -0,0 +1 @@
+export {};

package/fixtures/demo-wordpress.xml

@@ -0,0 +1,111 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<rss version="2.0"
+  xmlns:content="http://purl.org/rss/1.0/modules/content/"
+  xmlns:wp="http://wordpress.org/export/1.2/"
+  xmlns:dc="http://purl.org/dc/elements/1.1/"
+  xmlns:excerpt="http://wordpress.org/export/1.2/excerpt/">
+  <channel>
+    <title>Bright Path Plumbing</title>
+    <link>https://brightpath.example</link>
+    <description>Demo migration fixture</description>
+    <wp:base_site_url>https://brightpath.example</wp:base_site_url>
+    <wp:base_blog_url>https://brightpath.example</wp:base_blog_url>
+
+    <item>
+      <title>Home</title>
+      <link>https://brightpath.example/</link>
+      <dc:creator><![CDATA[niko]]></dc:creator>
+      <content:encoded><![CDATA[
+<!-- wp:group {"layout":{"type":"constrained"}} -->
+<div class="wp-block-group">
+  <!-- wp:heading {"level":1} --><h1>Plumbing without the runaround</h1><!-- /wp:heading -->
+  <!-- wp:paragraph --><p>Clear prices, scheduled arrivals and repairs that last.</p><!-- /wp:paragraph -->
+  <!-- wp:buttons --><div class="wp-block-buttons"><!-- wp:button --><div class="wp-block-button"><a class="wp-block-button__link" href="/contact/">Request a quote</a></div><!-- /wp:button --></div><!-- /wp:buttons -->
+</div>
+<!-- /wp:group -->
+<!-- wp:latest-posts {"postsToShow":3,"displayPostDate":true} /-->
+      ]]></content:encoded>
+      <excerpt:encoded><![CDATA[Local plumbing services.]]></excerpt:encoded>
+      <wp:post_id>10</wp:post_id>
+      <wp:post_date>2026-06-01 09:00:00</wp:post_date>
+      <wp:post_name>home</wp:post_name>
+      <wp:status>publish</wp:status>
+      <wp:post_type>page</wp:post_type>
+    </item>
+
+    <item>
+      <title>Services</title>
+      <link>https://brightpath.example/services/</link>
+      <dc:creator><![CDATA[niko]]></dc:creator>
+      <content:encoded><![CDATA[]]></content:encoded>
+      <wp:post_id>11</wp:post_id>
+      <wp:post_date>2026-06-02 09:00:00</wp:post_date>
+      <wp:post_name>services</wp:post_name>
+      <wp:status>publish</wp:status>
+      <wp:post_type>page</wp:post_type>
+      <wp:postmeta>
+        <wp:meta_key><![CDATA[_elementor_edit_mode]]></wp:meta_key>
+        <wp:meta_value><![CDATA[builder]]></wp:meta_value>
+      </wp:postmeta>
+      <wp:postmeta>
+        <wp:meta_key><![CDATA[_elementor_data]]></wp:meta_key>
+        <wp:meta_value><![CDATA[[
+          {
+            "id":"hero01",
+            "elType":"container",
+            "settings":{"content_width":"boxed","padding":{"unit":"px","top":"72","right":"24","bottom":"72","left":"24"}},
+            "elements":[
+              {"id":"h001","elType":"widget","widgetType":"heading","settings":{"title":"Repairs, installations and maintenance","header_size":"h1"},"elements":[]},
+              {"id":"t001","elType":"widget","widgetType":"text-editor","settings":{"editor":"<p>Residential plumbing handled by licensed technicians.</p>"},"elements":[]},
+              {"id":"b001","elType":"widget","widgetType":"button","settings":{"text":"Request a quote","link":{"url":"/contact/"}},"elements":[]}
+            ]
+          },
+          {
+            "id":"services01",
+            "elType":"container",
+            "settings":{"flex_direction":"row"},
+            "elements":[
+              {"id":"i001","elType":"widget","widgetType":"image","settings":{"image":{"url":"https://brightpath.example/wp-content/uploads/2026/05/repair.jpg","id":301},"image_size":"large"},"elements":[]},
+              {"id":"p001","elType":"widget","widgetType":"posts","settings":{"posts_per_page":3,"orderby":"menu_order"},"elements":[]},
+              {"id":"x001","elType":"widget","widgetType":"essential-addons-testimonial-slider","settings":{"autoplay":"yes"},"elements":[]}
+            ]
+          }
+        ]]]></wp:meta_value>
+      </wp:postmeta>
+    </item>
+
+    <item>
+      <title>Contact</title>
+      <link>https://brightpath.example/contact/</link>
+      <dc:creator><![CDATA[niko]]></dc:creator>
+      <content:encoded><![CDATA[
+<!-- wp:heading --><h2>Request a quote</h2><!-- /wp:heading -->
+<!-- wp:paragraph --><p>Tell us what needs attention.</p><!-- /wp:paragraph -->
+[gravityform id="4" title="false" description="false"]
+      ]]></content:encoded>
+      <wp:post_id>12</wp:post_id>
+      <wp:post_date>2026-06-03 09:00:00</wp:post_date>
+      <wp:post_name>contact</wp:post_name>
+      <wp:status>publish</wp:status>
+      <wp:post_type>page</wp:post_type>
+    </item>
+
+    <item>
+      <title>How to stop a leaking tap</title>
+      <link>https://brightpath.example/guides/stop-a-leaking-tap/</link>
+      <dc:creator><![CDATA[niko]]></dc:creator>
+      <category domain="category" nicename="guides"><![CDATA[Guides]]></category>
+      <content:encoded><![CDATA[
+<!-- wp:heading --><h2>Find the shut-off valve</h2><!-- /wp:heading -->
+<!-- wp:paragraph --><p>Turn off the local valve before removing the tap handle.</p><!-- /wp:paragraph -->
+<!-- wp:image {"id":302,"sizeSlug":"large"} --><figure class="wp-block-image size-large"><img src="https://brightpath.example/wp-content/uploads/2026/05/tap.jpg" alt="Tap handle removed" /></figure><!-- /wp:image -->
+<!-- wp:quote --><blockquote class="wp-block-quote"><p>Do not force a seized valve.</p></blockquote><!-- /wp:quote -->
+      ]]></content:encoded>
+      <wp:post_id>20</wp:post_id>
+      <wp:post_date>2026-06-04 09:00:00</wp:post_date>
+      <wp:post_name>stop-a-leaking-tap</wp:post_name>
+      <wp:status>publish</wp:status>
+      <wp:post_type>post</wp:post_type>
+    </item>
+  </channel>
+</rss>

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "wp-migrate-core",
+  "version": "0.1.0-demo",
+  "description": "Turn a WordPress WXR export into an Astro handoff, with a repair queue for the parts that still need a human.",
+  "keywords": [
+    "wordpress",
+    "wordpress-migration",
+    "wxr",
+    "astro",
+    "elementor",
+    "gutenberg",
+    "cli",
+    "typescript"
+  ],
+  "type": "module",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "bin": {
+    "wp-migrate-core": "dist/src/cli.js"
+  },
+  "files": [
+    "dist/src",
+    "fixtures/demo-wordpress.xml"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "npm run build && node --test dist/**/*.test.js",
+    "demo": "npm run build && node dist/src/cli.js demo",
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "prepack": "npm run clean && npm run build",
+    "prepublishOnly": "npm test"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^7.0.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lame13/wp-migrate-core.git"
+  },
+  "bugs": {
+    "url": "https://github.com/lame13/wp-migrate-core/issues"
+  },
+  "homepage": "https://indexlane.dev",
+  "publishConfig": {
+    "access": "public",
+    "tag": "demo"
+  }
+}