@artinstack/migrator 0.1.5 → 0.1.7

package/README.md

@@ -15,7 +15,8 @@ src/
   normalizer/       Canonical DTOs + portable idempotency types
   sinks/            filesystem export, MigrationSink interface
   cli/              artinstack-migrate
-  transformers/     HtmlToGrapes, css-to-styles, rewrite-inline-images
+  transformers/     HtmlToGrapes, css-to-styles, inline image rewrite, media ref expand
+  lib/              content-asset-urls, migration-media-ref, origin-url-rewrite
 ```
 
 ## Install
@@ -114,6 +115,31 @@ Each file contains an array of normalized DTOs (`NormalizedPost`, `NormalizedPag
 
 Per-platform export file formats and API client usage are documented in [docs/architecture.md](./docs/architecture.md).
 
+## Migration media refs
+
+WordPress `contentHtml` is stamped with `artinstack-migration://asset/…` refs by default (not CDN URLs). Rationale, ref format, and OSS/host split: [docs/architecture.md § Migration media refs](./docs/architecture.md#migration-media-refs).
+
+**Host — expand refs before persist** (`htmlToGrapes`, hero promotion, sink write):
+
+```ts
+import {
+  expandMigrationMediaRefs,
+  formatMigrationMediaRef,
+  isMigrationMediaRef,
+  parseMigrationMediaRef,
+  rewriteInlineImages,
+  stampMigrationMediaRefs,
+} from "@artinstack/migrator";
+
+const { html, unresolved } = expandMigrationMediaRefs(contentHtml, (sourceId) =>
+  lookupPublicUrl(sourceId), // migration_entities → CDN
+);
+```
+
+**CLI / JSON export:** use `--rewrite-gateway` + `--rewrite-public` so gateway uploads normalize before refs are stamped. Unresolved upload URLs stay in HTML and appear in `conflicts.json` as `unresolvedInlineImages`.
+
+**Tests:** `fixtures/wordpress/pages-export.test.ts` (naikonpixels pages WXR).
+
 ## Development
 
 ```bash
@@ -129,6 +155,8 @@ pnpm dev          # watch build
 |-------|------------------------|------------------|
 | Parsers + normalizer DTOs | Yes | No |
 | WordPress builder flattening + origin URL rewrite (pre-DTO) | Yes | Optional same config on adapter input |
+| Stamp `artinstack-migration://asset/…` refs in content HTML | Yes | No |
+| Expand refs → CDN URLs at persist | Exported helper | Call site + DB lookup |
 | CLI + filesystem JSON export | Yes | No |
 | `MigrationSink` interface | Yes | Implementation |
 | Dynamic shortcodes (`[portfolio]`, `[recent_posts]`), forms, sanitize | No | Yes |

package/dist/chunk-BOYB6XRA.js

@@ -0,0 +1,175 @@
+import {
+  normalizeAssetUrl
+} from "./chunk-XYP3VYDH.js";
+
+// src/lib/migration-media-ref.ts
+var MIGRATION_MEDIA_REF_SCHEME = "artinstack-migration://asset/";
+function formatMigrationMediaRef(sourceAssetId) {
+  return `${MIGRATION_MEDIA_REF_SCHEME}${encodeURIComponent(sourceAssetId)}`;
+}
+function isMigrationMediaRef(value) {
+  return value.trim().startsWith(MIGRATION_MEDIA_REF_SCHEME);
+}
+function parseMigrationMediaRef(value) {
+  const trimmed = value.trim();
+  if (!trimmed.startsWith(MIGRATION_MEDIA_REF_SCHEME)) return void 0;
+  const encoded = trimmed.slice(MIGRATION_MEDIA_REF_SCHEME.length);
+  if (!encoded) return void 0;
+  try {
+    return decodeURIComponent(encoded);
+  } catch {
+    return void 0;
+  }
+}
+function createMigrationMediaRefReplaceWith() {
+  return (ref) => {
+    if (!ref.sourceAssetId) return "";
+    return formatMigrationMediaRef(ref.sourceAssetId);
+  };
+}
+
+// src/lib/migration-media-url-index.ts
+function urlPathname(url) {
+  try {
+    return new URL(url, "http://migration.local").pathname;
+  } catch {
+    return void 0;
+  }
+}
+function buildMigrationMediaUrlIndex(entries) {
+  const index = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    index.set(entry.sourceUrl, entry.sourceId);
+    const normalized = normalizeAssetUrl(entry.sourceUrl);
+    if (normalized) index.set(normalized, entry.sourceId);
+    const pathname = urlPathname(entry.sourceUrl);
+    if (pathname) index.set(pathname, entry.sourceId);
+  }
+  return index;
+}
+function resolveMigrationMediaSourceId(src, urlIndex) {
+  const normalized = normalizeAssetUrl(src);
+  if (!normalized) return void 0;
+  return urlIndex.get(normalized) ?? urlIndex.get(src) ?? (urlPathname(normalized) ? urlIndex.get(urlPathname(normalized)) : void 0);
+}
+
+// src/transformers/rewrite-inline-images.ts
+import * as cheerio from "cheerio";
+var BACKGROUND_IMAGE_URL_PATTERN = /background(?:-image)?\s*:[^;]*?url\s*\(\s*(['"]?)([^'")]+)\1\s*\)/gi;
+function resolveRewriteOptions(options) {
+  const replaceWith = options.replaceWith ?? createMigrationMediaRefReplaceWith();
+  const requireUploaded = options.requireUploaded ?? Boolean(options.replaceWith);
+  return { replaceWith, requireUploaded };
+}
+function tryRewriteUrl(src, options, uploadedBySourceId, referencedSources, unresolved) {
+  const normalized = normalizeAssetUrl(src);
+  if (!normalized) return void 0;
+  if (isMigrationMediaRef(normalized)) {
+    referencedSources.add(normalized);
+    return normalized;
+  }
+  referencedSources.add(normalized);
+  const ref = options.resolveAsset(normalized);
+  if (!ref?.sourceAssetId) {
+    unresolved.add(normalized);
+    return void 0;
+  }
+  const { replaceWith, requireUploaded } = resolveRewriteOptions(options);
+  const uploaded = uploadedBySourceId.get(ref.sourceAssetId);
+  if (requireUploaded && !uploaded) {
+    unresolved.add(normalized);
+    return void 0;
+  }
+  return replaceWith(ref, uploaded);
+}
+function rewriteBackgroundUrlsInStyle(style, options, uploadedBySourceId, referencedSources, unresolved) {
+  return style.replace(BACKGROUND_IMAGE_URL_PATTERN, (full, quote, rawUrl) => {
+    const replaced = tryRewriteUrl(rawUrl.trim(), options, uploadedBySourceId, referencedSources, unresolved);
+    if (!replaced) return full;
+    const urlCall = quote ? `url(${quote}${replaced}${quote})` : `url(${replaced})`;
+    return full.replace(/url\s*\(\s*(['"]?)([^'")]+)\1\s*\)/i, urlCall);
+  });
+}
+function rewriteSrcset(srcset, options, uploadedBySourceId, referencedSources, unresolved) {
+  return srcset.split(",").map((entry) => {
+    const trimmed = entry.trim();
+    if (!trimmed) return entry;
+    const [urlPart, descriptor] = trimmed.split(/\s+/, 2);
+    const replaced = tryRewriteUrl(urlPart ?? "", options, uploadedBySourceId, referencedSources, unresolved);
+    if (!replaced) return entry;
+    return descriptor ? `${replaced} ${descriptor}` : replaced;
+  }).join(", ");
+}
+function rewriteInlineImages(html, options, uploadedBySourceId) {
+  if (!html.trim()) {
+    return { html, referencedSources: [], unresolved: [] };
+  }
+  const $ = cheerio.load(html, { xml: false });
+  const referencedSources = /* @__PURE__ */ new Set();
+  const unresolved = /* @__PURE__ */ new Set();
+  $("img").each((_, element) => {
+    const img = $(element);
+    const src = img.attr("src")?.trim();
+    if (src && !src.startsWith("data:")) {
+      const replaced = tryRewriteUrl(src, options, uploadedBySourceId, referencedSources, unresolved);
+      if (replaced) img.attr("src", replaced);
+    }
+    const srcset = img.attr("srcset")?.trim();
+    if (srcset) {
+      img.attr("srcset", rewriteSrcset(srcset, options, uploadedBySourceId, referencedSources, unresolved));
+    }
+  });
+  $("[data-bg-image]").each((_, element) => {
+    const node = $(element);
+    const bgImage = node.attr("data-bg-image")?.trim();
+    if (!bgImage || bgImage.startsWith("data:")) return;
+    const replaced = tryRewriteUrl(bgImage, options, uploadedBySourceId, referencedSources, unresolved);
+    if (replaced) node.attr("data-bg-image", replaced);
+  });
+  $("[style]").each((_, element) => {
+    const node = $(element);
+    const style = node.attr("style");
+    if (!style?.includes("background")) return;
+    const rewritten = rewriteBackgroundUrlsInStyle(
+      style,
+      options,
+      uploadedBySourceId,
+      referencedSources,
+      unresolved
+    );
+    if (rewritten !== style) node.attr("style", rewritten);
+  });
+  return {
+    html: $.root().html() ?? html,
+    referencedSources: [...referencedSources],
+    unresolved: [...unresolved]
+  };
+}
+function stampMigrationMediaRefs(html, options) {
+  return rewriteInlineImages(
+    html,
+    {
+      resolveAsset: (src) => {
+        const sourceAssetId = resolveMigrationMediaSourceId(src, options.urlToSourceId);
+        if (!sourceAssetId) return void 0;
+        return { originalSrc: src, sourceAssetId };
+      },
+      replaceWith: options.replaceWith,
+      requireUploaded: options.requireUploaded ?? false
+    },
+    /* @__PURE__ */ new Map()
+  );
+}
+
+export {
+  MIGRATION_MEDIA_REF_SCHEME,
+  formatMigrationMediaRef,
+  isMigrationMediaRef,
+  parseMigrationMediaRef,
+  createMigrationMediaRefReplaceWith,
+  buildMigrationMediaUrlIndex,
+  resolveMigrationMediaSourceId,
+  rewriteInlineImages,
+  stampMigrationMediaRefs
+};
+//# sourceMappingURL=chunk-BOYB6XRA.js.map

package/dist/chunk-BOYB6XRA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/migration-media-ref.ts","../src/lib/migration-media-url-index.ts","../src/transformers/rewrite-inline-images.ts"],"sourcesContent":["/** Pseudo-URL scheme for portable migration asset pointers (not WordPress shortcodes). */\nexport const MIGRATION_MEDIA_REF_SCHEME = \"artinstack-migration://asset/\";\n\n/** Build `artinstack-migration://asset/{sourceId}` (percent-encodes the normalizer source id). */\nexport function formatMigrationMediaRef(sourceAssetId: string): string {\n  return `${MIGRATION_MEDIA_REF_SCHEME}${encodeURIComponent(sourceAssetId)}`;\n}\n\nexport function isMigrationMediaRef(value: string): boolean {\n  return value.trim().startsWith(MIGRATION_MEDIA_REF_SCHEME);\n}\n\n/** Parse a migration media ref back to the normalizer `sourceId`, or `undefined` if not a ref. */\nexport function parseMigrationMediaRef(value: string): string | undefined {\n  const trimmed = value.trim();\n  if (!trimmed.startsWith(MIGRATION_MEDIA_REF_SCHEME)) return undefined;\n  const encoded = trimmed.slice(MIGRATION_MEDIA_REF_SCHEME.length);\n  if (!encoded) return undefined;\n  try {\n    return decodeURIComponent(encoded);\n  } catch {\n    return undefined;\n  }\n}\n\n/** Default `replaceWith` for `rewriteInlineImages` / `stampMigrationMediaRefs` (OSS-14). */\nexport function createMigrationMediaRefReplaceWith(): (\n  ref: { sourceAssetId?: string },\n) => string {\n  return (ref) => {\n    if (!ref.sourceAssetId) return \"\";\n    return formatMigrationMediaRef(ref.sourceAssetId);\n  };\n}\n","import { normalizeAssetUrl } from \"./content-asset-urls.js\";\n\nfunction urlPathname(url: string): string | undefined {\n  try {\n    return new URL(url, \"http://migration.local\").pathname;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Map normalized upload URLs (and pathnames) → normalizer `sourceId`.\n * Attachment ids are WXR `post_id` strings; inline discoveries use `url:{src}`.\n */\nexport function buildMigrationMediaUrlIndex(\n  entries: Iterable<{ sourceUrl: string; sourceId: string }>,\n): Map<string, string> {\n  const index = new Map<string, string>();\n\n  for (const entry of entries) {\n    index.set(entry.sourceUrl, entry.sourceId);\n    const normalized = normalizeAssetUrl(entry.sourceUrl);\n    if (normalized) index.set(normalized, entry.sourceId);\n    const pathname = urlPathname(entry.sourceUrl);\n    if (pathname) index.set(pathname, entry.sourceId);\n  }\n\n  return index;\n}\n\nexport function resolveMigrationMediaSourceId(\n  src: string,\n  urlIndex: Map<string, string>,\n): string | undefined {\n  const normalized = normalizeAssetUrl(src);\n  if (!normalized) return undefined;\n\n  return (\n    urlIndex.get(normalized) ??\n    urlIndex.get(src) ??\n    (urlPathname(normalized) ? urlIndex.get(urlPathname(normalized)!) : undefined)\n  );\n}\n","import * as cheerio from \"cheerio\";\n\nimport { normalizeAssetUrl } from \"../lib/content-asset-urls.js\";\nimport {\n  createMigrationMediaRefReplaceWith,\n  isMigrationMediaRef,\n} from \"../lib/migration-media-ref.js\";\nimport {\n  buildMigrationMediaUrlIndex,\n  resolveMigrationMediaSourceId,\n} from \"../lib/migration-media-url-index.js\";\n\nexport interface RewriteInlineImageRef {\n  originalSrc: string;\n  sourceAssetId?: string;\n}\n\nexport interface UploadedAssetRef {\n  targetId: string;\n  publicUrl?: string;\n}\n\nexport interface RewriteInlineImagesOptions {\n  resolveAsset: (src: string) => RewriteInlineImageRef | undefined;\n  /**\n   * Replace a resolved source id with a migration ref or CDN URL.\n   * When omitted, defaults to OSS-14 `artinstack-migration://asset/…` refs.\n   */\n  replaceWith?: (ref: RewriteInlineImageRef, uploaded?: UploadedAssetRef) => string;\n  /**\n   * When true, skip URLs that cannot be matched to an uploaded vault target.\n   * Default: false when using migration refs; true when a custom `replaceWith` is supplied.\n   */\n  requireUploaded?: boolean;\n}\n\nexport interface RewriteInlineImagesResult {\n  html: string;\n  referencedSources: string[];\n  unresolved: string[];\n}\n\n/** Inline CSS `background` / `background-image: url(…)` (quoted or bare). */\nconst BACKGROUND_IMAGE_URL_PATTERN =\n  /background(?:-image)?\\s*:[^;]*?url\\s*\\(\\s*(['\"]?)([^'\")]+)\\1\\s*\\)/gi;\n\nfunction resolveRewriteOptions(\n  options: RewriteInlineImagesOptions,\n): Required<Pick<RewriteInlineImagesOptions, \"replaceWith\" | \"requireUploaded\">> {\n  const replaceWith = options.replaceWith ?? createMigrationMediaRefReplaceWith();\n  const requireUploaded = options.requireUploaded ?? Boolean(options.replaceWith);\n  return { replaceWith, requireUploaded };\n}\n\nfunction tryRewriteUrl(\n  src: string,\n  options: RewriteInlineImagesOptions,\n  uploadedBySourceId: Map<string, UploadedAssetRef>,\n  referencedSources: Set<string>,\n  unresolved: Set<string>,\n): string | undefined {\n  const normalized = normalizeAssetUrl(src);\n  if (!normalized) return undefined;\n\n  if (isMigrationMediaRef(normalized)) {\n    referencedSources.add(normalized);\n    return normalized;\n  }\n\n  referencedSources.add(normalized);\n  const ref = options.resolveAsset(normalized);\n  if (!ref?.sourceAssetId) {\n    unresolved.add(normalized);\n    return undefined;\n  }\n\n  const { replaceWith, requireUploaded } = resolveRewriteOptions(options);\n  const uploaded = uploadedBySourceId.get(ref.sourceAssetId);\n  if (requireUploaded && !uploaded) {\n    unresolved.add(normalized);\n    return undefined;\n  }\n\n  return replaceWith(ref, uploaded);\n}\n\nfunction rewriteBackgroundUrlsInStyle(\n  style: string,\n  options: RewriteInlineImagesOptions,\n  uploadedBySourceId: Map<string, UploadedAssetRef>,\n  referencedSources: Set<string>,\n  unresolved: Set<string>,\n): string {\n  return style.replace(BACKGROUND_IMAGE_URL_PATTERN, (full, quote: string, rawUrl: string) => {\n    const replaced = tryRewriteUrl(rawUrl.trim(), options, uploadedBySourceId, referencedSources, unresolved);\n    if (!replaced) return full;\n\n    const urlCall = quote\n      ? `url(${quote}${replaced}${quote})`\n      : `url(${replaced})`;\n    return full.replace(/url\\s*\\(\\s*(['\"]?)([^'\")]+)\\1\\s*\\)/i, urlCall);\n  });\n}\n\nfunction rewriteSrcset(\n  srcset: string,\n  options: RewriteInlineImagesOptions,\n  uploadedBySourceId: Map<string, UploadedAssetRef>,\n  referencedSources: Set<string>,\n  unresolved: Set<string>,\n): string {\n  return srcset\n    .split(\",\")\n    .map((entry) => {\n      const trimmed = entry.trim();\n      if (!trimmed) return entry;\n      const [urlPart, descriptor] = trimmed.split(/\\s+/, 2);\n      const replaced = tryRewriteUrl(urlPart ?? \"\", options, uploadedBySourceId, referencedSources, unresolved);\n      if (!replaced) return entry;\n      return descriptor ? `${replaced} ${descriptor}` : replaced;\n    })\n    .join(\", \");\n}\n\n/** Rewrite `<img src>` / `srcset`, `data-bg-image`, and inline CSS backgrounds using uploaded asset targets. */\nexport function rewriteInlineImages(\n  html: string,\n  options: RewriteInlineImagesOptions,\n  uploadedBySourceId: Map<string, UploadedAssetRef>,\n): RewriteInlineImagesResult {\n  if (!html.trim()) {\n    return { html, referencedSources: [], unresolved: [] };\n  }\n\n  const $ = cheerio.load(html, { xml: false });\n  const referencedSources = new Set<string>();\n  const unresolved = new Set<string>();\n\n  $(\"img\").each((_, element) => {\n    const img = $(element);\n    const src = img.attr(\"src\")?.trim();\n    if (src && !src.startsWith(\"data:\")) {\n      const replaced = tryRewriteUrl(src, options, uploadedBySourceId, referencedSources, unresolved);\n      if (replaced) img.attr(\"src\", replaced);\n    }\n\n    const srcset = img.attr(\"srcset\")?.trim();\n    if (srcset) {\n      img.attr(\"srcset\", rewriteSrcset(srcset, options, uploadedBySourceId, referencedSources, unresolved));\n    }\n  });\n\n  $(\"[data-bg-image]\").each((_, element) => {\n    const node = $(element);\n    const bgImage = node.attr(\"data-bg-image\")?.trim();\n    if (!bgImage || bgImage.startsWith(\"data:\")) return;\n    const replaced = tryRewriteUrl(bgImage, options, uploadedBySourceId, referencedSources, unresolved);\n    if (replaced) node.attr(\"data-bg-image\", replaced);\n  });\n\n  $(\"[style]\").each((_, element) => {\n    const node = $(element);\n    const style = node.attr(\"style\");\n    if (!style?.includes(\"background\")) return;\n    const rewritten = rewriteBackgroundUrlsInStyle(\n      style,\n      options,\n      uploadedBySourceId,\n      referencedSources,\n      unresolved,\n    );\n    if (rewritten !== style) node.attr(\"style\", rewritten);\n  });\n\n  return {\n    html: $.root().html() ?? html,\n    referencedSources: [...referencedSources],\n    unresolved: [...unresolved],\n  };\n}\n\nexport interface StampMigrationMediaRefsOptions {\n  /** Pre-built url/pathname → sourceId map (from attachments + inline assets). */\n  urlToSourceId: Map<string, string>;\n  replaceWith?: RewriteInlineImagesOptions[\"replaceWith\"];\n  requireUploaded?: boolean;\n}\n\n/**\n * OSS-14 — replace resolved `wp-content/uploads` URLs with `artinstack-migration://asset/…`\n * refs. Does not invent refs for unknown URLs (left unchanged + listed in `unresolved`).\n */\nexport function stampMigrationMediaRefs(\n  html: string,\n  options: StampMigrationMediaRefsOptions,\n): RewriteInlineImagesResult {\n  return rewriteInlineImages(\n    html,\n    {\n      resolveAsset: (src) => {\n        const sourceAssetId = resolveMigrationMediaSourceId(src, options.urlToSourceId);\n        if (!sourceAssetId) return undefined;\n        return { originalSrc: src, sourceAssetId };\n      },\n      replaceWith: options.replaceWith,\n      requireUploaded: options.requireUploaded ?? false,\n    },\n    new Map(),\n  );\n}\n\n/** Build a url index from attachment rows and/or normalized assets. */\nexport { buildMigrationMediaUrlIndex };\n"],"mappings":"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","names":[]}

package/dist/{chunk-XUBCG3IA.js → chunk-KF7G7DM6.js}

@@ -6,11 +6,16 @@ import {
   sanitizeSlug,
   summarizeSquarespaceExport,
   validateSquarespaceExportFile
-} from "./chunk-YLFVYPB3.js";
+} from "./chunk-MDSY3FEZ.js";
+import {
+  buildMigrationMediaUrlIndex,
+  stampMigrationMediaRefs
+} from "./chunk-BOYB6XRA.js";
 import {
   discoverContentAssetUrls,
-  normalizeAssetUrl
-} from "./chunk-2PNSVE5Y.js";
+  normalizeAssetUrl,
+  resolveFeaturedContentAssetUrl
+} from "./chunk-XYP3VYDH.js";
 
 // src/lib/origin-url-rewrite.ts
 function rewriteOriginUrlsInText(text, config) {
@@ -75,6 +80,20 @@ function extractQuotedParam(params, name) {
 function escapeLayoutAttr(value) {
   return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
 }
+function parseFractionWidth(fraction) {
+  if (!fraction?.trim()) return void 0;
+  const trimmed = fraction.trim();
+  const match = trimmed.match(/^(\d+)\s*\/\s*(\d+)$/);
+  if (!match) return void 0;
+  const numerator = Number(match[1]);
+  const denominator = Number(match[2]);
+  if (!Number.isFinite(numerator) || !Number.isFinite(denominator) || denominator <= 0) {
+    return void 0;
+  }
+  const percent = numerator / denominator * 100;
+  const rounded = Math.round(percent * 100) / 100;
+  return `${rounded % 1 === 0 ? rounded.toFixed(0) : rounded}%`;
+}
 function parseRowLayoutCols(layout) {
   if (!layout?.trim()) return void 0;
   const parts = layout.split("+").map((part) => part.trim()).filter(Boolean);
@@ -94,6 +113,12 @@ function openRowDiv(params, colsParamName) {
   if (cols) attrs.push(`data-cols="${cols}"`);
   return `<div ${attrs.join(" ")}>`;
 }
+function openColumnDiv(params, widthParamName) {
+  const attrs = ['data-layout="column"'];
+  const width = parseFractionWidth(extractQuotedParam(params, widthParamName ?? "width"));
+  if (width) attrs.push(`data-col-width="${width}"`);
+  return `<div ${attrs.join(" ")}>`;
+}
 function applyPrefixedLayoutMap(content, map) {
   let html = content;
   html = html.replace(map.sectionRegex, (_, params) => openSectionDiv(params, map.bgParamName));
@@ -124,14 +149,49 @@ function applyFractionalLayoutMap(content, map) {
   }
   return html;
 }
+function applyExtendedPrefixedLayoutMap(content, map) {
+  let html = content;
+  const levels = [...map.levels].sort((left, right) => {
+    const leftMax = Math.max(...left.tokens.map((token) => token.length));
+    const rightMax = Math.max(...right.tokens.map((token) => token.length));
+    return rightMax - leftMax;
+  });
+  for (const level of levels) {
+    const tokens = [...level.tokens].sort((left, right) => right.length - left.length);
+    for (const token of tokens) {
+      const openRegex = new RegExp(`\\[${escapeRegExp(token)}\\b([^\\]]*)\\]`, "gi");
+      const closeRegex = new RegExp(`\\[\\/${escapeRegExp(token)}\\b[^\\]]*\\]`, "gi");
+      html = html.replace(openRegex, (_, params) => {
+        switch (level.role) {
+          case "section":
+            return openSectionDiv(params, level.bgParamName);
+          case "row":
+            return openRowDiv(params, level.colsParamName);
+          case "column":
+            return openColumnDiv(params, level.widthParamName);
+        }
+      });
+      html = html.replace(closeRegex, "</div>");
+    }
+  }
+  return html;
+}
 function applyStructuralLayoutMap(content, map) {
   switch (map.kind) {
     case "prefixed":
       return applyPrefixedLayoutMap(content, map);
     case "fractional":
       return applyFractionalLayoutMap(content, map);
+    case "extended-prefixed":
+      return applyExtendedPrefixedLayoutMap(content, map);
   }
 }
+function collectLayoutMaps(theme) {
+  const maps = [];
+  if (theme.layoutMap) maps.push(theme.layoutMap);
+  if (theme.layoutMaps?.length) maps.push(...theme.layoutMaps);
+  return maps;
+}
 function extractShortcodeParam(params, names) {
   for (const name of names) {
     const value = extractQuotedParam(params, name);
@@ -282,8 +342,8 @@ function flattenWordPressBuilders(content, options = {}) {
     for (const rule of theme.iconImageRules ?? []) {
       html = convertIconImageRule(html, rule);
     }
-    if (theme.layoutMap) {
-      html = applyStructuralLayoutMap(html, theme.layoutMap);
+    for (const layoutMap of collectLayoutMaps(theme)) {
+      html = applyStructuralLayoutMap(html, layoutMap);
     }
     for (const prefix of theme.scaffoldingPrefixes ?? []) {
       html = stripScaffoldingPrefix(html, prefix);
@@ -482,8 +542,8 @@ function resolveFeaturedAssetSourceId(thumbnailId, attachmentIndex, contentHtml)
   if (thumbnailId && attachmentIndex.has(thumbnailId)) {
     return thumbnailId;
   }
-  const firstInline = discoverContentAssetUrls(contentHtml)[0];
-  return firstInline ? `url:${firstInline}` : void 0;
+  const featuredUrl = resolveFeaturedContentAssetUrl(contentHtml);
+  return featuredUrl ? `url:${featuredUrl}` : void 0;
 }
 function maybeRewriteUrl(url, config) {
   if (!url) return void 0;
@@ -497,6 +557,12 @@ async function* enumerateWxrEntities(options) {
   const { categories, tags } = collectTaxonomies(items);
   const seenAssetUrls = /* @__PURE__ */ new Set();
   const emittedAttachmentIds = /* @__PURE__ */ new Set();
+  const attachmentUrlIndex = buildMigrationMediaUrlIndex(
+    [...attachmentIndex.entries()].map(([sourceId, entry]) => ({
+      sourceId,
+      sourceUrl: entry.sourceUrl
+    }))
+  );
   for (const category of categories.values()) {
     yield category;
   }
@@ -522,18 +588,28 @@ async function* enumerateWxrEntities(options) {
     const id = textValue(item.post_id);
     const link = maybeRewriteUrl(textValue(item.link), options.originUrlRewrite);
     const slug = sanitizeSlug(textValue(item.post_name) || textValue(item.title) || id);
-    const contentHtml = preprocessContent(getContentEncoded(item), options);
+    let contentHtml = preprocessContent(getContentEncoded(item), options);
     if (postType === "page" && options.skipWooCommerceStubPages !== false && isWooCommerceStubPage(slug, contentHtml)) {
       continue;
     }
-    for (const asset of collectInlineAssets(
+    const inlineAssets = collectInlineAssets(
       contentHtml,
       attachmentIndex,
       seenAssetUrls,
       options.exportedAt
-    )) {
+    );
+    for (const asset of inlineAssets) {
       yield asset;
     }
+    if (options.stampMigrationMediaRefs !== false) {
+      const urlIndex = new Map(attachmentUrlIndex);
+      for (const asset of inlineAssets) {
+        urlIndex.set(asset.sourceUrl, asset.sourceId);
+        const normalized = normalizeAssetUrl(asset.sourceUrl);
+        if (normalized) urlIndex.set(normalized, asset.sourceId);
+      }
+      contentHtml = stampMigrationMediaRefs(contentHtml, { urlToSourceId: urlIndex }).html;
+    }
     const categorySlugs = [];
     const tagSlugs = [];
     for (const cat of asArray(item.category)) {
@@ -2621,4 +2697,4 @@ export {
   wixAdapter,
   getAdapter
 };
-//# sourceMappingURL=chunk-XUBCG3IA.js.map
+//# sourceMappingURL=chunk-KF7G7DM6.js.map