@artinstack/migrator 0.1.5 → 0.1.7

package/dist/chunk-XYP3VYDH.js

@@ -0,0 +1,159 @@
+// src/lib/content-asset-urls.ts
+import * as cheerio from "cheerio";
+var IMAGE_EXTENSIONS = "jpe?g|png|gif|webp|avif|svg";
+var IMAGE_EXTENSION_PATTERN = new RegExp(String.raw`\.(?:${IMAGE_EXTENSIONS})\b`, "i");
+var QUOTED_IMAGE_PATH = String.raw`[^"']+\.(?:${IMAGE_EXTENSIONS})(?:\?[^"'#]*)?(?:#.*)?`;
+var SHORTCODE_IMAGE_PARAM_PATTERN = new RegExp(
+  String.raw`\b(?:image|bg_image|background_image|url)\s*=\s*["'](${QUOTED_IMAGE_PATH})["']`,
+  "gi"
+);
+var BARE_SRC_PARAM_PATTERN = new RegExp(
+  String.raw`\bsrc\s*=\s*["'](${QUOTED_IMAGE_PATH})["']`,
+  "gi"
+);
+var DATA_BG_IMAGE_PATTERN = /\bdata-bg-image\s*=\s*["']([^"']+)["']/gi;
+var BACKGROUND_IMAGE_URL_PATTERN = /background(?:-image)?\s*:[^;]*?url\s*\(\s*(['"]?)([^'")]+)\1\s*\)/gi;
+var HERO_URL_PARAM_PATTERN = new RegExp(
+  String.raw`\b(?:bg_image|background_image)\s*=\s*["'](${QUOTED_IMAGE_PATH})["']`,
+  "gi"
+);
+var INLINE_IMAGE_PARAM_PATTERN = new RegExp(
+  String.raw`\bimage\s*=\s*["'](${QUOTED_IMAGE_PATH})["']`,
+  "gi"
+);
+var IMG_TAG_SRC_PATTERN = /<img\b[^>]*\bsrc\s*=\s*["']([^"']+)["']/gi;
+function ingestLikelyImageUrl(urls, raw) {
+  const normalized = normalizeAssetUrl(raw ?? "");
+  if (normalized && isLikelyImageUrl(normalized)) {
+    urls.add(normalized);
+  }
+}
+function extractImgTagSrcs(content) {
+  if (!content.trim()) return [];
+  const $ = cheerio.load(content, { xml: false });
+  const srcs = [];
+  $("img[src]").each((_, el) => {
+    const src = $(el).attr("src")?.trim();
+    if (src) srcs.push(src);
+  });
+  return srcs;
+}
+function hasImageExtension(value) {
+  const withoutHash = value.split("#", 1)[0] ?? value;
+  const withoutQuery = withoutHash.split("?", 1)[0] ?? withoutHash;
+  return IMAGE_EXTENSION_PATTERN.test(withoutQuery);
+}
+function extractDataBgImageUrls(content) {
+  const urls = [];
+  for (const match of content.matchAll(DATA_BG_IMAGE_PATTERN)) {
+    const raw = match[1]?.trim();
+    if (raw) urls.push(raw);
+  }
+  return urls;
+}
+function extractCssBackgroundImageUrls(content) {
+  const urls = [];
+  for (const match of content.matchAll(BACKGROUND_IMAGE_URL_PATTERN)) {
+    const raw = match[2]?.trim();
+    if (raw) urls.push(raw);
+  }
+  return urls;
+}
+function discoverRawImgSrcs(content) {
+  return extractImgTagSrcs(content).filter((src) => !src.startsWith("data:"));
+}
+function normalizeAssetUrl(raw) {
+  const trimmed = raw.trim();
+  if (!trimmed || trimmed.startsWith("data:")) return void 0;
+  if (trimmed.startsWith("//")) return `https:${trimmed}`;
+  return trimmed;
+}
+function isLikelyImageUrl(url) {
+  if (!url || url.startsWith("data:")) return false;
+  if (url.startsWith("/")) {
+    return hasImageExtension(url);
+  }
+  if (!/^https?:\/\//i.test(url)) return false;
+  try {
+    const { pathname } = new URL(url);
+    if (hasImageExtension(pathname)) return true;
+  } catch {
+  }
+  return hasImageExtension(url);
+}
+function pushFeaturedCandidate(candidates, raw, index, tier) {
+  const normalized = normalizeAssetUrl(raw ?? "");
+  if (!normalized || !isLikelyImageUrl(normalized)) return;
+  candidates.push({ url: normalized, index, tier });
+}
+function collectFeaturedAssetCandidates(content) {
+  const candidates = [];
+  for (const match of content.matchAll(DATA_BG_IMAGE_PATTERN)) {
+    pushFeaturedCandidate(candidates, match[1], match.index ?? 0, 0);
+  }
+  for (const match of content.matchAll(BACKGROUND_IMAGE_URL_PATTERN)) {
+    pushFeaturedCandidate(candidates, match[2], match.index ?? 0, 0);
+  }
+  for (const match of content.matchAll(HERO_URL_PARAM_PATTERN)) {
+    pushFeaturedCandidate(candidates, match[1], match.index ?? 0, 0);
+  }
+  for (const match of content.matchAll(IMG_TAG_SRC_PATTERN)) {
+    pushFeaturedCandidate(candidates, match[1], match.index ?? 0, 1);
+  }
+  for (const match of content.matchAll(INLINE_IMAGE_PARAM_PATTERN)) {
+    pushFeaturedCandidate(candidates, match[1], match.index ?? 0, 1);
+  }
+  return candidates;
+}
+function discoverFeaturedAssetCandidateUrls(content) {
+  if (!content.trim()) return [];
+  const ranked = [...collectFeaturedAssetCandidates(content)].sort((left, right) => {
+    if (left.tier !== right.tier) return left.tier - right.tier;
+    return left.index - right.index;
+  });
+  const urls = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const candidate of ranked) {
+    if (seen.has(candidate.url)) continue;
+    seen.add(candidate.url);
+    urls.push(candidate.url);
+  }
+  return urls;
+}
+function resolveFeaturedContentAssetUrl(content) {
+  return discoverFeaturedAssetCandidateUrls(content)[0];
+}
+function discoverContentAssetUrls(content) {
+  if (!content.trim()) return [];
+  const urls = /* @__PURE__ */ new Set();
+  for (const raw of extractImgTagSrcs(content)) {
+    ingestLikelyImageUrl(urls, raw);
+  }
+  for (const match of content.matchAll(SHORTCODE_IMAGE_PARAM_PATTERN)) {
+    ingestLikelyImageUrl(urls, match[1]);
+  }
+  for (const match of content.matchAll(BARE_SRC_PARAM_PATTERN)) {
+    ingestLikelyImageUrl(urls, match[1]);
+  }
+  for (const raw of extractDataBgImageUrls(content)) {
+    ingestLikelyImageUrl(urls, raw);
+  }
+  for (const raw of extractCssBackgroundImageUrls(content)) {
+    ingestLikelyImageUrl(urls, raw);
+  }
+  return [...urls];
+}
+function extractInlineImageSrcs(content) {
+  return discoverContentAssetUrls(content);
+}
+
+export {
+  discoverRawImgSrcs,
+  normalizeAssetUrl,
+  isLikelyImageUrl,
+  discoverFeaturedAssetCandidateUrls,
+  resolveFeaturedContentAssetUrl,
+  discoverContentAssetUrls,
+  extractInlineImageSrcs
+};
+//# sourceMappingURL=chunk-XYP3VYDH.js.map

package/dist/chunk-XYP3VYDH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/content-asset-urls.ts"],"sourcesContent":["import * as cheerio from \"cheerio\";\n\nconst IMAGE_EXTENSIONS = \"jpe?g|png|gif|webp|avif|svg\";\n/** Image file extension in a path or URL (allows trailing `?query` / `#hash`). */\nconst IMAGE_EXTENSION_PATTERN = new RegExp(String.raw`\\.(?:${IMAGE_EXTENSIONS})\\b`, \"i\");\n\n/** Captured value must contain an image extension — skips `url=\"…/about\"`, `<iframe src=\"…youtube…\">`, etc. */\nconst QUOTED_IMAGE_PATH = String.raw`[^\"']+\\.(?:${IMAGE_EXTENSIONS})(?:\\?[^\"'#]*)?(?:#.*)?`;\n\nconst SHORTCODE_IMAGE_PARAM_PATTERN = new RegExp(\n  String.raw`\\b(?:image|bg_image|background_image|url)\\s*=\\s*[\"'](${QUOTED_IMAGE_PATH})[\"']`,\n  \"gi\",\n);\n\n/** Bare `src=\"…jpg\"` outside `<img>` (shortcode fragments); `<img src>` handled by cheerio. */\nconst BARE_SRC_PARAM_PATTERN = new RegExp(\n  String.raw`\\bsrc\\s*=\\s*[\"'](${QUOTED_IMAGE_PATH})[\"']`,\n  \"gi\",\n);\n\nconst DATA_BG_IMAGE_PATTERN = /\\bdata-bg-image\\s*=\\s*[\"']([^\"']+)[\"']/gi;\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\nconst HERO_URL_PARAM_PATTERN = new RegExp(\n  String.raw`\\b(?:bg_image|background_image)\\s*=\\s*[\"'](${QUOTED_IMAGE_PATH})[\"']`,\n  \"gi\",\n);\n\nconst INLINE_IMAGE_PARAM_PATTERN = new RegExp(\n  String.raw`\\bimage\\s*=\\s*[\"'](${QUOTED_IMAGE_PATH})[\"']`,\n  \"gi\",\n);\n\nconst IMG_TAG_SRC_PATTERN = /<img\\b[^>]*\\bsrc\\s*=\\s*[\"']([^\"']+)[\"']/gi;\n\ninterface FeaturedAssetCandidate {\n  url: string;\n  index: number;\n  tier: 0 | 1;\n}\n\nfunction ingestLikelyImageUrl(urls: Set<string>, raw: string | undefined): void {\n  const normalized = normalizeAssetUrl(raw ?? \"\");\n  if (normalized && isLikelyImageUrl(normalized)) {\n    urls.add(normalized);\n  }\n}\n\nfunction extractImgTagSrcs(content: string): string[] {\n  if (!content.trim()) return [];\n  const $ = cheerio.load(content, { xml: false });\n  const srcs: string[] = [];\n  $(\"img[src]\").each((_, el) => {\n    const src = $(el).attr(\"src\")?.trim();\n    if (src) srcs.push(src);\n  });\n  return srcs;\n}\n\nfunction hasImageExtension(value: string): boolean {\n  const withoutHash = value.split(\"#\", 1)[0] ?? value;\n  const withoutQuery = withoutHash.split(\"?\", 1)[0] ?? withoutHash;\n  return IMAGE_EXTENSION_PATTERN.test(withoutQuery);\n}\n\nfunction extractDataBgImageUrls(content: string): string[] {\n  const urls: string[] = [];\n  for (const match of content.matchAll(DATA_BG_IMAGE_PATTERN)) {\n    const raw = match[1]?.trim();\n    if (raw) urls.push(raw);\n  }\n  return urls;\n}\n\nfunction extractCssBackgroundImageUrls(content: string): string[] {\n  const urls: string[] = [];\n  for (const match of content.matchAll(BACKGROUND_IMAGE_URL_PATTERN)) {\n    const raw = match[2]?.trim();\n    if (raw) urls.push(raw);\n  }\n  return urls;\n}\n\n/** All `<img src>` values (including those not ingested as vault assets). */\nexport function discoverRawImgSrcs(content: string): string[] {\n  return extractImgTagSrcs(content).filter((src) => !src.startsWith(\"data:\"));\n}\n\n/** Normalize protocol-relative and trim; skip data URIs. */\nexport function normalizeAssetUrl(raw: string): string | undefined {\n  const trimmed = raw.trim();\n  if (!trimmed || trimmed.startsWith(\"data:\")) return undefined;\n  if (trimmed.startsWith(\"//\")) return `https:${trimmed}`;\n  return trimmed;\n}\n\n/** Heuristic: URL likely points at a raster/vector image asset, not a page link. */\nexport function isLikelyImageUrl(url: string): boolean {\n  if (!url || url.startsWith(\"data:\")) return false;\n\n  if (url.startsWith(\"/\")) {\n    return hasImageExtension(url);\n  }\n\n  if (!/^https?:\\/\\//i.test(url)) return false;\n\n  try {\n    const { pathname } = new URL(url);\n    if (hasImageExtension(pathname)) return true;\n  } catch {\n    // fall through — malformed absolute URL\n  }\n\n  return hasImageExtension(url);\n}\n\nfunction pushFeaturedCandidate(\n  candidates: FeaturedAssetCandidate[],\n  raw: string | undefined,\n  index: number,\n  tier: 0 | 1,\n): void {\n  const normalized = normalizeAssetUrl(raw ?? \"\");\n  if (!normalized || !isLikelyImageUrl(normalized)) return;\n  candidates.push({ url: normalized, index, tier });\n}\n\nfunction collectFeaturedAssetCandidates(content: string): FeaturedAssetCandidate[] {\n  const candidates: FeaturedAssetCandidate[] = [];\n\n  for (const match of content.matchAll(DATA_BG_IMAGE_PATTERN)) {\n    pushFeaturedCandidate(candidates, match[1], match.index ?? 0, 0);\n  }\n  for (const match of content.matchAll(BACKGROUND_IMAGE_URL_PATTERN)) {\n    pushFeaturedCandidate(candidates, match[2], match.index ?? 0, 0);\n  }\n  for (const match of content.matchAll(HERO_URL_PARAM_PATTERN)) {\n    pushFeaturedCandidate(candidates, match[1], match.index ?? 0, 0);\n  }\n  for (const match of content.matchAll(IMG_TAG_SRC_PATTERN)) {\n    pushFeaturedCandidate(candidates, match[1], match.index ?? 0, 1);\n  }\n  for (const match of content.matchAll(INLINE_IMAGE_PARAM_PATTERN)) {\n    pushFeaturedCandidate(candidates, match[1], match.index ?? 0, 1);\n  }\n\n  return candidates;\n}\n\n/**\n * Ordered featured-image candidates when `_thumbnail_id` is missing — heroes\n * (`data-bg-image`, CSS backgrounds, `bg_image=`) before inline assets; within\n * each tier, first in document order wins. Filename tokens (`_w`, `_2048`, …)\n * are not interpreted as quality signals.\n */\nexport function discoverFeaturedAssetCandidateUrls(content: string): string[] {\n  if (!content.trim()) return [];\n\n  const ranked = [...collectFeaturedAssetCandidates(content)].sort((left, right) => {\n    if (left.tier !== right.tier) return left.tier - right.tier;\n    return left.index - right.index;\n  });\n\n  const urls: string[] = [];\n  const seen = new Set<string>();\n  for (const candidate of ranked) {\n    if (seen.has(candidate.url)) continue;\n    seen.add(candidate.url);\n    urls.push(candidate.url);\n  }\n  return urls;\n}\n\n/** Best featured-image URL from post/page HTML when attachment id is unavailable. */\nexport function resolveFeaturedContentAssetUrl(content: string): string | undefined {\n  return discoverFeaturedAssetCandidateUrls(content)[0];\n}\n\n/**\n * Generic content-discovery pass: collect image URLs from HTML `<img>` tags,\n * section hero markers (`data-bg-image`), inline CSS backgrounds, and common\n * shortcode/builder attributes (`src=`, `image=`, `bg_image=`, …) without\n * parsing builder-specific structure (Tatsu, Elementor, etc.).\n */\nexport function discoverContentAssetUrls(content: string): string[] {\n  if (!content.trim()) return [];\n\n  const urls = new Set<string>();\n\n  for (const raw of extractImgTagSrcs(content)) {\n    ingestLikelyImageUrl(urls, raw);\n  }\n\n  for (const match of content.matchAll(SHORTCODE_IMAGE_PARAM_PATTERN)) {\n    ingestLikelyImageUrl(urls, match[1]);\n  }\n\n  for (const match of content.matchAll(BARE_SRC_PARAM_PATTERN)) {\n    ingestLikelyImageUrl(urls, match[1]);\n  }\n\n  for (const raw of extractDataBgImageUrls(content)) {\n    ingestLikelyImageUrl(urls, raw);\n  }\n\n  for (const raw of extractCssBackgroundImageUrls(content)) {\n    ingestLikelyImageUrl(urls, raw);\n  }\n\n  return [...urls];\n}\n\n/** @deprecated Use discoverContentAssetUrls — kept for call-site clarity during transition. */\nexport function extractInlineImageSrcs(content: string): string[] {\n  return discoverContentAssetUrls(content);\n}\n"],"mappings":"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","names":[]}

package/dist/cli/index.js

@@ -2,7 +2,7 @@
 import {
   createWpContentGatewayRewrite,
   getAdapter
-} from "../chunk-XUBCG3IA.js";
+} from "../chunk-KF7G7DM6.js";
 import {
   analyzeConflicts,
   buildMigrationReport,
@@ -17,12 +17,12 @@ import {
   runMigration,
   staleUrlsFromEstimate,
   writeFilesystemExport
-} from "../chunk-YLFVYPB3.js";
+} from "../chunk-MDSY3FEZ.js";
 import {
   collectEntities
 } from "../chunk-HI7JHWZU.js";
-import "../chunk-S7TRWILI.js";
-import "../chunk-2PNSVE5Y.js";
+import "../chunk-BOYB6XRA.js";
+import "../chunk-XYP3VYDH.js";
 
 // src/cli/index.ts
 import { writeFile } from "fs/promises";

package/dist/index-Dp6nqBqe.d.ts

@@ -0,0 +1,177 @@
+import { z } from 'zod';
+import { l as ValidationResult } from './types-DWOP8Dcy.js';
+import './rewrite-inline-images-Bq16bJA5.js';
+
+/**
+ * Map normalized upload URLs (and pathnames) → normalizer `sourceId`.
+ * Attachment ids are WXR `post_id` strings; inline discoveries use `url:{src}`.
+ */
+declare function buildMigrationMediaUrlIndex(entries: Iterable<{
+    sourceUrl: string;
+    sourceId: string;
+}>): Map<string, string>;
+declare function resolveMigrationMediaSourceId(src: string, urlIndex: Map<string, string>): string | undefined;
+
+type LayoutKind = "section" | "row" | "column";
+/** Map OSS-2 `data-layout` markers to Grapes component types (host may override). */
+interface LayoutTypeMap {
+    section?: string;
+    row?: string;
+    column?: string;
+}
+interface HtmlToGrapesOptions {
+    /** Map source class names to Grapes component types. */
+    componentMap?: Record<string, string>;
+    /** Map HTML tag names to Grapes component types (e.g. `h2` → `heading`). */
+    tagMap?: Record<string, string>;
+    /** Map `data-layout` section/row/column markers to Grapes component types. */
+    layoutTypeMap?: LayoutTypeMap;
+}
+interface GrapesStyleRule {
+    selectors: string[];
+    style: Record<string, string>;
+}
+interface GrapesComponent {
+    type: string;
+    tagName?: string;
+    attributes?: Record<string, string>;
+    classes?: string[];
+    components?: GrapesComponent[];
+    content?: string;
+    void?: boolean;
+}
+interface GrapesProjectSnapshot {
+    content: GrapesComponent[];
+    styles: GrapesStyleRule[];
+    contentHtml?: string;
+    contentCss?: string;
+}
+
+/** Cheerio HTML walk → Grapes `content` + root `styles`. */
+declare function htmlToGrapes(html: string, options?: HtmlToGrapesOptions): GrapesProjectSnapshot;
+
+/** ProseMirror / Tiptap mark (inline formatting). */
+interface TiptapMark {
+    type: string;
+    attrs?: Record<string, string>;
+}
+/** ProseMirror / Tiptap node — text nodes use `text`; others use `content`. */
+interface TiptapNode {
+    type: string;
+    attrs?: Record<string, unknown>;
+    content?: TiptapNode[];
+    marks?: TiptapMark[];
+    text?: string;
+}
+/** Root Tiptap document (`content_json` shape). */
+interface TiptapDoc {
+    type: "doc";
+    content: TiptapNode[];
+}
+interface HtmlToTiptapOptions {
+    /**
+     * Unwrap OSS-2 `data-layout` scaffolding (section/row/column divs) into prose blocks.
+     * @default true
+     */
+    unwrapLayoutMarkers?: boolean;
+}
+
+/** Cheerio HTML walk → Tiptap / ProseMirror `doc` JSON for blog `content_json`. */
+declare function htmlToTiptap(html: string, options?: HtmlToTiptapOptions): TiptapDoc;
+
+/** Parse `<style>` blocks and class rules into Grapes root `styles[]`. */
+declare function cssToStyles(css: string): GrapesStyleRule[];
+
+declare const grapesStyleRuleSchema: z.ZodObject<{
+    selectors: z.ZodArray<z.ZodString, "many">;
+    style: z.ZodRecord<z.ZodString, z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    style: Record<string, string>;
+    selectors: string[];
+}, {
+    style: Record<string, string>;
+    selectors: string[];
+}>;
+declare const grapesComponentSchema: z.ZodType<GrapesComponent>;
+declare const grapesProjectSnapshotSchema: z.ZodObject<{
+    content: z.ZodArray<z.ZodType<GrapesComponent, z.ZodTypeDef, GrapesComponent>, "many">;
+    styles: z.ZodArray<z.ZodObject<{
+        selectors: z.ZodArray<z.ZodString, "many">;
+        style: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        style: Record<string, string>;
+        selectors: string[];
+    }, {
+        style: Record<string, string>;
+        selectors: string[];
+    }>, "many">;
+    contentHtml: z.ZodOptional<z.ZodString>;
+    contentCss: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    content: GrapesComponent[];
+    styles: {
+        style: Record<string, string>;
+        selectors: string[];
+    }[];
+    contentHtml?: string | undefined;
+    contentCss?: string | undefined;
+}, {
+    content: GrapesComponent[];
+    styles: {
+        style: Record<string, string>;
+        selectors: string[];
+    }[];
+    contentHtml?: string | undefined;
+    contentCss?: string | undefined;
+}>;
+interface ValidateGrapesProjectSnapshotOptions {
+    /** When set, every component `type` in the tree must be in this allowlist. */
+    allowedComponentTypes?: string[];
+}
+/**
+ * Opt-in structural check for a Grapes project snapshot (not a full Grapes editor project file).
+ * Does not validate host-specific component registries unless `allowedComponentTypes` is passed.
+ */
+declare function validateGrapesProjectSnapshot(snapshot: unknown, options?: ValidateGrapesProjectSnapshotOptions): ValidationResult;
+
+declare const tiptapMarkSchema: z.ZodObject<{
+    type: z.ZodString;
+    attrs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    attrs?: Record<string, string> | undefined;
+}, {
+    type: string;
+    attrs?: Record<string, string> | undefined;
+}>;
+declare const tiptapNodeSchema: z.ZodType<TiptapNode>;
+declare const tiptapDocSchema: z.ZodObject<{
+    type: z.ZodLiteral<"doc">;
+    content: z.ZodArray<z.ZodType<TiptapNode, z.ZodTypeDef, TiptapNode>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "doc";
+    content: TiptapNode[];
+}, {
+    type: "doc";
+    content: TiptapNode[];
+}>;
+interface ValidateTiptapDocOptions {
+    /** When set, every node `type` in the tree must be in this allowlist. */
+    allowedNodeTypes?: string[];
+    /** When set, every mark `type` must be in this allowlist. */
+    allowedMarkTypes?: string[];
+}
+/** Opt-in structural check for a Tiptap / ProseMirror document. */
+declare function validateTiptapDoc(doc: unknown, options?: ValidateTiptapDocOptions): ValidationResult;
+
+interface ExpandMigrationMediaRefsResult {
+    html: string;
+    unresolved: string[];
+}
+/**
+ * Expand OSS-14 `artinstack-migration://asset/…` refs to host CDN URLs.
+ * Lookup (`migration_entities` → `publicUrl`) is host-supplied via `resolvePublicUrl`.
+ */
+declare function expandMigrationMediaRefs(html: string, resolvePublicUrl: (sourceId: string) => string | undefined): ExpandMigrationMediaRefsResult;
+
+export { type ExpandMigrationMediaRefsResult as E, type GrapesComponent as G, type HtmlToGrapesOptions as H, type LayoutKind as L, type TiptapDoc as T, type ValidateGrapesProjectSnapshotOptions as V, type GrapesProjectSnapshot as a, type GrapesStyleRule as b, type HtmlToTiptapOptions as c, type LayoutTypeMap as d, type TiptapMark as e, type TiptapNode as f, type ValidateTiptapDocOptions as g, buildMigrationMediaUrlIndex as h, cssToStyles as i, expandMigrationMediaRefs as j, grapesComponentSchema as k, grapesProjectSnapshotSchema as l, grapesStyleRuleSchema as m, htmlToGrapes as n, htmlToTiptap as o, tiptapMarkSchema as p, tiptapNodeSchema as q, resolveMigrationMediaSourceId as r, validateTiptapDoc as s, tiptapDocSchema as t, validateGrapesProjectSnapshot as v };

package/dist/index.d.ts

@@ -3,9 +3,9 @@ export { A as AdapterContext, E as EntityKey, h as EntityType, i as MigrationCur
 export { EntityState, MigrationCheckpoint, TrackedEntity, buildPortfolioMediaLinks, isTerminalState, normalizedAssetExifSchema, normalizedAssetSchema, normalizedCategorySchema, normalizedEntitySchema, normalizedPageSchema, normalizedPortfolioSchema, normalizedPostSchema, normalizedTagSchema, shouldProcessEntity, sourceMetadataSchema, validateNormalizedAsset, validateNormalizedCategory, validateNormalizedEntity, validateNormalizedPage, validateNormalizedPortfolio, validateNormalizedPost, validateNormalizedTag } from './normalizer/index.js';
 export { B as BundleCounts, E as EntityBundle, b as bundleCounts, c as collectEntities, e as emptyBundle } from './bundle-uAAHehbv.js';
 export { ConflictReport, DryRunOptions, DryRunResult, FALLBACK_ASSET_BYTES, FilesystemMigrationSink, MIGRATION_WRITE_STAGES, MigrationRedirect, MigrationReport, MigrationRunMode, MigrationRunOptions, MigrationRunResult, MigrationSink, MigrationWriteStage, StorageEstimate, UploadAssetInput, UploadAssetResult, WriteFilesystemOptions, analyzeConflicts, buildMigrationReport, buildRedirectMap, bundleToCombinedJson, createFilesystemMigrationSink, detectRedirectLoops, emptyConflictReport, estimateStorage, hasBlockingConflicts, hasWarnings, portfolioMediaMatchesBundle, runDryRun, runMigration, runMigrationFromBundle, staleUrlsFromEstimate, writeFilesystemExport } from './sinks/index.js';
-export { R as RewriteInlineImageRef, a as RewriteInlineImagesOptions, b as RewriteInlineImagesResult, U as UploadedAssetRef, r as rewriteInlineImages } from './rewrite-inline-images-BckVKPbh.js';
-export { GrapesComponent, GrapesProjectSnapshot, GrapesStyleRule, HtmlToGrapesOptions, HtmlToTiptapOptions, LayoutKind, LayoutTypeMap, TiptapDoc, TiptapMark, TiptapNode, ValidateGrapesProjectSnapshotOptions, ValidateTiptapDocOptions, cssToStyles, grapesComponentSchema, grapesProjectSnapshotSchema, grapesStyleRuleSchema, htmlToGrapes, htmlToTiptap, tiptapDocSchema, tiptapMarkSchema, tiptapNodeSchema, validateGrapesProjectSnapshot, validateTiptapDoc } from './transformers/index.js';
-export { discoverContentAssetUrls, discoverRawImgSrcs, extractInlineImageSrcs, isLikelyImageUrl, normalizeAssetUrl } from './lib/index.js';
+export { R as RewriteInlineImageRef, a as RewriteInlineImagesOptions, b as RewriteInlineImagesResult, S as StampMigrationMediaRefsOptions, U as UploadedAssetRef, r as rewriteInlineImages, s as stampMigrationMediaRefs } from './rewrite-inline-images-Bq16bJA5.js';
+export { E as ExpandMigrationMediaRefsResult, G as GrapesComponent, a as GrapesProjectSnapshot, b as GrapesStyleRule, H as HtmlToGrapesOptions, c as HtmlToTiptapOptions, L as LayoutKind, d as LayoutTypeMap, T as TiptapDoc, e as TiptapMark, f as TiptapNode, V as ValidateGrapesProjectSnapshotOptions, g as ValidateTiptapDocOptions, h as buildMigrationMediaUrlIndex, i as cssToStyles, j as expandMigrationMediaRefs, k as grapesComponentSchema, l as grapesProjectSnapshotSchema, m as grapesStyleRuleSchema, n as htmlToGrapes, o as htmlToTiptap, r as resolveMigrationMediaSourceId, t as tiptapDocSchema, p as tiptapMarkSchema, q as tiptapNodeSchema, v as validateGrapesProjectSnapshot, s as validateTiptapDoc } from './index-Dp6nqBqe.js';
+export { discoverContentAssetUrls, discoverFeaturedAssetCandidateUrls, discoverRawImgSrcs, extractInlineImageSrcs, isLikelyImageUrl, normalizeAssetUrl, resolveFeaturedContentAssetUrl } from './lib/index.js';
 import { z } from 'zod';
 import 'node:stream';
 
@@ -521,4 +521,16 @@ declare const wixAdapter: MigrationAdapter;
 
 declare function getAdapter(platform: MigrationPlatform): MigrationAdapter;
 
-export { MigrationAdapter, MigrationPlatform, type OriginUrlRewriteConfig, type OriginUrlRewriteRule, SMUGMUG_API_BASE, SMUGMUG_OAUTH_ENDPOINTS, SQUARESPACE_JSON_FORMAT, SmugMugApiClient, type SmugMugClientOptions, type SmugMugCredentials, type SquarespaceClientOptions, type SquarespaceCollectTarget, SquarespaceCollectionClient, WixCollectionClient, WixPageSnapshotCollector, buildJsonPrettyUrl, buildSmugMugAuthorizationHeader, createWpContentGatewayRewrite, getAdapter, mapJsonPrettyWire, readSmugMugCredentialsFromEnv, rewriteOriginUrlsInText, signSmugMugOAuthRequest, smugMugCredentialsSchema, smugmugAdapter, squarespaceAdapter, wixAdapter, wordpressAdapter };
+/** Pseudo-URL scheme for portable migration asset pointers (not WordPress shortcodes). */
+declare const MIGRATION_MEDIA_REF_SCHEME = "artinstack-migration://asset/";
+/** Build `artinstack-migration://asset/{sourceId}` (percent-encodes the normalizer source id). */
+declare function formatMigrationMediaRef(sourceAssetId: string): string;
+declare function isMigrationMediaRef(value: string): boolean;
+/** Parse a migration media ref back to the normalizer `sourceId`, or `undefined` if not a ref. */
+declare function parseMigrationMediaRef(value: string): string | undefined;
+/** Default `replaceWith` for `rewriteInlineImages` / `stampMigrationMediaRefs` (OSS-14). */
+declare function createMigrationMediaRefReplaceWith(): (ref: {
+    sourceAssetId?: string;
+}) => string;
+
+export { MIGRATION_MEDIA_REF_SCHEME, MigrationAdapter, MigrationPlatform, type OriginUrlRewriteConfig, type OriginUrlRewriteRule, SMUGMUG_API_BASE, SMUGMUG_OAUTH_ENDPOINTS, SQUARESPACE_JSON_FORMAT, SmugMugApiClient, type SmugMugClientOptions, type SmugMugCredentials, type SquarespaceClientOptions, type SquarespaceCollectTarget, SquarespaceCollectionClient, WixCollectionClient, WixPageSnapshotCollector, buildJsonPrettyUrl, buildSmugMugAuthorizationHeader, createMigrationMediaRefReplaceWith, createWpContentGatewayRewrite, formatMigrationMediaRef, getAdapter, isMigrationMediaRef, mapJsonPrettyWire, parseMigrationMediaRef, readSmugMugCredentialsFromEnv, rewriteOriginUrlsInText, signSmugMugOAuthRequest, smugMugCredentialsSchema, smugmugAdapter, squarespaceAdapter, wixAdapter, wordpressAdapter };

package/dist/index.js

@@ -15,7 +15,7 @@ import {
   squarespaceAdapter,
   wixAdapter,
   wordpressAdapter
-} from "./chunk-XUBCG3IA.js";
+} from "./chunk-KF7G7DM6.js";
 import {
   normalizedAssetExifSchema,
   normalizedAssetSchema,
@@ -58,7 +58,7 @@ import {
   runMigrationFromBundle,
   staleUrlsFromEstimate,
   writeFilesystemExport
-} from "./chunk-YLFVYPB3.js";
+} from "./chunk-MDSY3FEZ.js";
 import {
   buildPortfolioMediaLinks,
   bundleCounts,
@@ -70,6 +70,7 @@ import {
 } from "./chunk-HI7JHWZU.js";
 import {
   cssToStyles,
+  expandMigrationMediaRefs,
   grapesComponentSchema,
   grapesProjectSnapshotSchema,
   grapesStyleRuleSchema,
@@ -80,20 +81,31 @@ import {
   tiptapNodeSchema,
   validateGrapesProjectSnapshot,
   validateTiptapDoc
-} from "./chunk-CIOYDRY5.js";
+} from "./chunk-S4XYG4SM.js";
 import {
-  rewriteInlineImages
-} from "./chunk-S7TRWILI.js";
+  MIGRATION_MEDIA_REF_SCHEME,
+  buildMigrationMediaUrlIndex,
+  createMigrationMediaRefReplaceWith,
+  formatMigrationMediaRef,
+  isMigrationMediaRef,
+  parseMigrationMediaRef,
+  resolveMigrationMediaSourceId,
+  rewriteInlineImages,
+  stampMigrationMediaRefs
+} from "./chunk-BOYB6XRA.js";
 import {
   discoverContentAssetUrls,
+  discoverFeaturedAssetCandidateUrls,
   discoverRawImgSrcs,
   extractInlineImageSrcs,
   isLikelyImageUrl,
-  normalizeAssetUrl
-} from "./chunk-2PNSVE5Y.js";
+  normalizeAssetUrl,
+  resolveFeaturedContentAssetUrl
+} from "./chunk-XYP3VYDH.js";
 export {
   FALLBACK_ASSET_BYTES,
   FilesystemMigrationSink,
+  MIGRATION_MEDIA_REF_SCHEME,
   MIGRATION_WRITE_STAGES,
   SMUGMUG_API_BASE,
   SMUGMUG_OAUTH_ENDPOINTS,
@@ -104,6 +116,7 @@ export {
   WixPageSnapshotCollector,
   analyzeConflicts,
   buildJsonPrettyUrl,
+  buildMigrationMediaUrlIndex,
   buildMigrationReport,
   buildPortfolioMediaLinks,
   buildRedirectMap,
@@ -112,16 +125,20 @@ export {
   bundleToCombinedJson,
   collectEntities,
   createFilesystemMigrationSink,
+  createMigrationMediaRefReplaceWith,
   createWpContentGatewayRewrite,
   cssToStyles,
   detectRedirectLoops,
   discoverContentAssetUrls,
+  discoverFeaturedAssetCandidateUrls,
   discoverRawImgSrcs,
   emptyBundle,
   emptyConflictReport,
   entityKey,
   estimateStorage,
+  expandMigrationMediaRefs,
   extractInlineImageSrcs,
+  formatMigrationMediaRef,
   getAdapter,
   grapesComponentSchema,
   grapesProjectSnapshotSchema,
@@ -131,6 +148,7 @@ export {
   htmlToGrapes,
   htmlToTiptap,
   isLikelyImageUrl,
+  isMigrationMediaRef,
   isTerminalState,
   mapJsonPrettyWire,
   normalizeAssetUrl,
@@ -142,8 +160,11 @@ export {
   normalizedPortfolioSchema,
   normalizedPostSchema,
   normalizedTagSchema,
+  parseMigrationMediaRef,
   portfolioMediaMatchesBundle,
   readSmugMugCredentialsFromEnv,
+  resolveFeaturedContentAssetUrl,
+  resolveMigrationMediaSourceId,
   rewriteInlineImages,
   rewriteOriginUrlsInText,
   runDryRun,
@@ -156,6 +177,7 @@ export {
   sourceMetadataSchema,
   squarespaceAdapter,
   staleUrlsFromEstimate,
+  stampMigrationMediaRefs,
   tiptapDocSchema,
   tiptapMarkSchema,
   tiptapNodeSchema,

package/dist/lib/index.d.ts

@@ -5,12 +5,22 @@ declare function normalizeAssetUrl(raw: string): string | undefined;
 /** Heuristic: URL likely points at a raster/vector image asset, not a page link. */
 declare function isLikelyImageUrl(url: string): boolean;
 /**
- * Generic content-discovery pass: collect image URLs from HTML `<img>` tags and
- * common shortcode/builder attributes (`src=`, `image=`, `url=`) without parsing
- * builder-specific structure (Tatsu, Elementor, etc.).
+ * Ordered featured-image candidates when `_thumbnail_id` is missing — heroes
+ * (`data-bg-image`, CSS backgrounds, `bg_image=`) before inline assets; within
+ * each tier, first in document order wins. Filename tokens (`_w`, `_2048`, …)
+ * are not interpreted as quality signals.
+ */
+declare function discoverFeaturedAssetCandidateUrls(content: string): string[];
+/** Best featured-image URL from post/page HTML when attachment id is unavailable. */
+declare function resolveFeaturedContentAssetUrl(content: string): string | undefined;
+/**
+ * Generic content-discovery pass: collect image URLs from HTML `<img>` tags,
+ * section hero markers (`data-bg-image`), inline CSS backgrounds, and common
+ * shortcode/builder attributes (`src=`, `image=`, `bg_image=`, …) without
+ * parsing builder-specific structure (Tatsu, Elementor, etc.).
  */
 declare function discoverContentAssetUrls(content: string): string[];
 /** @deprecated Use discoverContentAssetUrls — kept for call-site clarity during transition. */
 declare function extractInlineImageSrcs(content: string): string[];
 
-export { discoverContentAssetUrls, discoverRawImgSrcs, extractInlineImageSrcs, isLikelyImageUrl, normalizeAssetUrl };
+export { discoverContentAssetUrls, discoverFeaturedAssetCandidateUrls, discoverRawImgSrcs, extractInlineImageSrcs, isLikelyImageUrl, normalizeAssetUrl, resolveFeaturedContentAssetUrl };

package/dist/lib/index.js

@@ -1,15 +1,19 @@
 import {
   discoverContentAssetUrls,
+  discoverFeaturedAssetCandidateUrls,
   discoverRawImgSrcs,
   extractInlineImageSrcs,
   isLikelyImageUrl,
-  normalizeAssetUrl
-} from "../chunk-2PNSVE5Y.js";
+  normalizeAssetUrl,
+  resolveFeaturedContentAssetUrl
+} from "../chunk-XYP3VYDH.js";
 export {
   discoverContentAssetUrls,
+  discoverFeaturedAssetCandidateUrls,
   discoverRawImgSrcs,
   extractInlineImageSrcs,
   isLikelyImageUrl,
-  normalizeAssetUrl
+  normalizeAssetUrl,
+  resolveFeaturedContentAssetUrl
 };
 //# sourceMappingURL=index.js.map

package/dist/rewrite-inline-images-Bq16bJA5.d.ts

@@ -0,0 +1,41 @@
+interface RewriteInlineImageRef {
+    originalSrc: string;
+    sourceAssetId?: string;
+}
+interface UploadedAssetRef {
+    targetId: string;
+    publicUrl?: string;
+}
+interface RewriteInlineImagesOptions {
+    resolveAsset: (src: string) => RewriteInlineImageRef | undefined;
+    /**
+     * Replace a resolved source id with a migration ref or CDN URL.
+     * When omitted, defaults to OSS-14 `artinstack-migration://asset/…` refs.
+     */
+    replaceWith?: (ref: RewriteInlineImageRef, uploaded?: UploadedAssetRef) => string;
+    /**
+     * When true, skip URLs that cannot be matched to an uploaded vault target.
+     * Default: false when using migration refs; true when a custom `replaceWith` is supplied.
+     */
+    requireUploaded?: boolean;
+}
+interface RewriteInlineImagesResult {
+    html: string;
+    referencedSources: string[];
+    unresolved: string[];
+}
+/** Rewrite `<img src>` / `srcset`, `data-bg-image`, and inline CSS backgrounds using uploaded asset targets. */
+declare function rewriteInlineImages(html: string, options: RewriteInlineImagesOptions, uploadedBySourceId: Map<string, UploadedAssetRef>): RewriteInlineImagesResult;
+interface StampMigrationMediaRefsOptions {
+    /** Pre-built url/pathname → sourceId map (from attachments + inline assets). */
+    urlToSourceId: Map<string, string>;
+    replaceWith?: RewriteInlineImagesOptions["replaceWith"];
+    requireUploaded?: boolean;
+}
+/**
+ * OSS-14 — replace resolved `wp-content/uploads` URLs with `artinstack-migration://asset/…`
+ * refs. Does not invent refs for unknown URLs (left unchanged + listed in `unresolved`).
+ */
+declare function stampMigrationMediaRefs(html: string, options: StampMigrationMediaRefsOptions): RewriteInlineImagesResult;
+
+export { type RewriteInlineImageRef as R, type StampMigrationMediaRefsOptions as S, type UploadedAssetRef as U, type RewriteInlineImagesOptions as a, type RewriteInlineImagesResult as b, rewriteInlineImages as r, stampMigrationMediaRefs as s };

package/dist/sinks/index.d.ts

@@ -1,7 +1,7 @@
 import { d as NormalizedCategory, e as NormalizedTag, b as NormalizedAsset, c as NormalizedPortfolio, N as NormalizedPost, a as NormalizedPage, P as PortfolioMediaLink, E as EntityKey, f as NormalizedEntity, g as MigrationPlatform, M as MigrationAdapter } from '../types-DWOP8Dcy.js';
 import { Readable } from 'node:stream';
-import { a as RewriteInlineImagesOptions } from '../rewrite-inline-images-BckVKPbh.js';
-export { b as RewriteInlineImagesResult, r as rewriteInlineImages } from '../rewrite-inline-images-BckVKPbh.js';
+import { a as RewriteInlineImagesOptions } from '../rewrite-inline-images-Bq16bJA5.js';
+export { b as RewriteInlineImagesResult, r as rewriteInlineImages } from '../rewrite-inline-images-Bq16bJA5.js';
 import { E as EntityBundle } from '../bundle-uAAHehbv.js';
 
 interface CreatePostResult {

package/dist/sinks/index.js

@@ -18,12 +18,12 @@ import {
   runMigrationFromBundle,
   staleUrlsFromEstimate,
   writeFilesystemExport
-} from "../chunk-YLFVYPB3.js";
+} from "../chunk-MDSY3FEZ.js";
 import "../chunk-HI7JHWZU.js";
 import {
   rewriteInlineImages
-} from "../chunk-S7TRWILI.js";
-import "../chunk-2PNSVE5Y.js";
+} from "../chunk-BOYB6XRA.js";
+import "../chunk-XYP3VYDH.js";
 export {
   FALLBACK_ASSET_BYTES,
   FilesystemMigrationSink,