@emdash-cms/gutenberg-to-portable-text 0.0.1

package/dist/chunk-DQk6qfdC.mjs

@@ -0,0 +1,18 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (!no_symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
+
+//#endregion
+export { __exportAll as t };

package/dist/index.d.mts

@@ -0,0 +1,431 @@
+//#region src/types.d.ts
+/**
+ * Types for Gutenberg to Portable Text conversion
+ */
+/**
+ * Gutenberg block as parsed by @wordpress/block-serialization-default-parser
+ */
+interface GutenbergBlock {
+  /** Block name like "core/paragraph" or null for freeform HTML */
+  blockName: string | null;
+  /** Block attributes from the JSON comment */
+  attrs: Record<string, unknown>;
+  /** Inner HTML content */
+  innerHTML: string;
+  /** Nested blocks (for columns, groups, etc.) */
+  innerBlocks: GutenbergBlock[];
+  /** Content parts between inner blocks */
+  innerContent: Array<string | null>;
+}
+/**
+ * Portable Text span (inline text with marks)
+ */
+interface PortableTextSpan {
+  _type: "span";
+  _key: string;
+  text: string;
+  marks?: string[];
+}
+/**
+ * Portable Text mark definition (for links, annotations)
+ */
+interface PortableTextMarkDef {
+  _type: string;
+  _key: string;
+  [key: string]: unknown;
+}
+/**
+ * Portable Text text block
+ */
+interface PortableTextTextBlock {
+  _type: "block";
+  _key: string;
+  style?: "normal" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "blockquote";
+  listItem?: "bullet" | "number";
+  level?: number;
+  children: PortableTextSpan[];
+  markDefs?: PortableTextMarkDef[];
+}
+/**
+ * Portable Text image block
+ */
+interface PortableTextImageBlock {
+  _type: "image";
+  _key: string;
+  asset: {
+    _type: "reference";
+    _ref: string;
+    url?: string;
+  };
+  alt?: string;
+  caption?: string;
+  alignment?: "left" | "center" | "right" | "wide" | "full";
+  link?: string;
+}
+/**
+ * Portable Text code block
+ */
+interface PortableTextCodeBlock {
+  _type: "code";
+  _key: string;
+  code: string;
+  language?: string;
+}
+/**
+ * Portable Text embed block (YouTube, Twitter, etc.)
+ */
+interface PortableTextEmbedBlock {
+  _type: "embed";
+  _key: string;
+  url: string;
+  provider?: string;
+  html?: string;
+}
+/**
+ * Portable Text gallery block
+ */
+interface PortableTextGalleryBlock {
+  _type: "gallery";
+  _key: string;
+  images: Array<{
+    _type: "image";
+    _key: string;
+    asset: {
+      _type: "reference";
+      _ref: string;
+      url?: string;
+    };
+    alt?: string;
+    caption?: string;
+  }>;
+  columns?: number;
+}
+/**
+ * Portable Text columns block
+ */
+interface PortableTextColumnsBlock {
+  _type: "columns";
+  _key: string;
+  columns: Array<{
+    _type: "column";
+    _key: string;
+    content: PortableTextBlock[];
+  }>;
+}
+/**
+ * Portable Text break/divider block
+ */
+interface PortableTextBreakBlock {
+  _type: "break";
+  _key: string;
+  style: "lineBreak";
+}
+/**
+ * Portable Text table block
+ */
+interface PortableTextTableBlock {
+  _type: "table";
+  _key: string;
+  rows: Array<{
+    _type: "tableRow";
+    _key: string;
+    cells: Array<{
+      _type: "tableCell";
+      _key: string;
+      content: PortableTextSpan[];
+      markDefs?: PortableTextMarkDef[];
+      isHeader?: boolean;
+    }>;
+  }>;
+  hasHeaderRow?: boolean;
+}
+/**
+ * Fallback HTML block for unconvertible content
+ */
+interface PortableTextHtmlBlock {
+  _type: "htmlBlock";
+  _key: string;
+  html: string;
+  originalBlockName?: string | null;
+  originalAttrs?: Record<string, unknown>;
+}
+/**
+ * Portable Text button block
+ */
+interface PortableTextButtonBlock {
+  _type: "button";
+  _key: string;
+  text: string;
+  url?: string;
+  style?: "default" | "outline" | "fill";
+}
+/**
+ * Portable Text buttons container block
+ */
+interface PortableTextButtonsBlock {
+  _type: "buttons";
+  _key: string;
+  buttons: PortableTextButtonBlock[];
+  layout?: "horizontal" | "vertical";
+}
+/**
+ * Portable Text cover block (image/video with text overlay)
+ */
+interface PortableTextCoverBlock {
+  _type: "cover";
+  _key: string;
+  backgroundImage?: string;
+  backgroundVideo?: string;
+  overlayColor?: string;
+  overlayOpacity?: number;
+  content: PortableTextBlock[];
+  minHeight?: string;
+  alignment?: "left" | "center" | "right";
+}
+/**
+ * Portable Text file download block
+ */
+interface PortableTextFileBlock {
+  _type: "file";
+  _key: string;
+  url: string;
+  filename?: string;
+  showDownloadButton?: boolean;
+}
+/**
+ * Portable Text pullquote block
+ */
+interface PortableTextPullquoteBlock {
+  _type: "pullquote";
+  _key: string;
+  text: string;
+  citation?: string;
+}
+/**
+ * Union of all Portable Text block types
+ */
+type PortableTextBlock = PortableTextTextBlock | PortableTextImageBlock | PortableTextCodeBlock | PortableTextEmbedBlock | PortableTextGalleryBlock | PortableTextColumnsBlock | PortableTextBreakBlock | PortableTextTableBlock | PortableTextHtmlBlock | PortableTextButtonBlock | PortableTextButtonsBlock | PortableTextCoverBlock | PortableTextFileBlock | PortableTextPullquoteBlock;
+/**
+ * Options for the conversion
+ */
+interface ConvertOptions {
+  /** Map of WordPress media IDs to EmDash media IDs/URLs */
+  mediaMap?: Map<number, string>;
+  /** Custom block transformers */
+  customTransformers?: Record<string, BlockTransformer>;
+  /** Whether to generate keys (default: true) */
+  generateKeys?: boolean;
+  /** Custom key generator */
+  keyGenerator?: () => string;
+}
+/**
+ * Block transformer function
+ */
+type BlockTransformer = (block: GutenbergBlock, options: ConvertOptions, context: TransformContext) => PortableTextBlock[];
+/**
+ * Context passed to transformers
+ */
+interface TransformContext {
+  /** Transform child blocks recursively */
+  transformBlocks: (blocks: GutenbergBlock[]) => PortableTextBlock[];
+  /** Parse inline HTML to spans */
+  parseInlineContent: (html: string) => {
+    children: PortableTextSpan[];
+    markDefs: PortableTextMarkDef[];
+  };
+  /** Generate a unique key */
+  generateKey: () => string;
+}
+//#endregion
+//#region src/transformers/index.d.ts
+/**
+ * Default block transformers for core WordPress blocks
+ */
+declare const defaultTransformers: Record<string, BlockTransformer>;
+/**
+ * Fallback transformer for unknown blocks
+ * Stores the original HTML for manual review
+ */
+declare const fallbackTransformer: BlockTransformer;
+declare namespace core_d_exports {
+  export { button, buttons, code, columns, cover, file, gallery, group, heading, html, image, list, mediaText, more, nextpage, paragraph, preformatted, pullquote, quote, separator, shortcode, table, verse };
+}
+/**
+ * core/paragraph → block with style "normal"
+ */
+declare const paragraph: BlockTransformer;
+/**
+ * core/heading → block with style "h1"-"h6"
+ */
+declare const heading: BlockTransformer;
+/**
+ * core/list → blocks with listItem
+ *
+ * Handles both old format (HTML list) and new format (innerBlocks with list-item)
+ */
+declare const list: BlockTransformer;
+/**
+ * core/quote → block with style "blockquote"
+ */
+declare const quote: BlockTransformer;
+/**
+ * core/image → image block
+ */
+declare const image: BlockTransformer;
+/**
+ * core/code → code block
+ */
+declare const code: BlockTransformer;
+/**
+ * core/preformatted → code block (no syntax highlighting)
+ */
+declare const preformatted: BlockTransformer;
+/**
+ * core/separator / core/spacer → break block
+ */
+declare const separator: BlockTransformer;
+/**
+ * core/gallery → gallery block
+ */
+declare const gallery: BlockTransformer;
+/**
+ * core/columns → columns block
+ */
+declare const columns: BlockTransformer;
+/**
+ * core/group → flatten children (no special container)
+ */
+declare const group: BlockTransformer;
+/**
+ * core/table → table block
+ */
+declare const table: BlockTransformer;
+/**
+ * core/button → button block
+ */
+declare const button: BlockTransformer;
+/**
+ * core/buttons → buttons container block
+ */
+declare const buttons: BlockTransformer;
+/**
+ * core/cover → cover block
+ */
+declare const cover: BlockTransformer;
+/**
+ * core/file → file block
+ */
+declare const file: BlockTransformer;
+/**
+ * core/pullquote → pullquote block
+ */
+declare const pullquote: BlockTransformer;
+/**
+ * core/html → htmlBlock (pass through)
+ */
+declare const html: BlockTransformer;
+/**
+ * core/verse → code block (preserves whitespace like preformatted)
+ */
+declare const verse: BlockTransformer;
+/**
+ * core/more → break block with "readMore" style
+ */
+declare const more: BlockTransformer;
+/**
+ * core/nextpage → break block with page break indicator
+ */
+declare const nextpage: BlockTransformer;
+/**
+ * core/shortcode → htmlBlock (preserve for manual handling)
+ */
+declare const shortcode: BlockTransformer;
+/**
+ * core/media-text → columns block with 2 columns
+ */
+declare const mediaText: BlockTransformer;
+declare namespace embed_d_exports {
+  export { audio, embed, twitter, video, vimeo, youtube };
+}
+/**
+ * core/embed and variants → embed block
+ */
+declare const embed: BlockTransformer;
+/**
+ * core-embed/youtube → embed block
+ */
+declare const youtube: BlockTransformer;
+/**
+ * core-embed/twitter → embed block
+ */
+declare const twitter: BlockTransformer;
+/**
+ * core-embed/vimeo → embed block
+ */
+declare const vimeo: BlockTransformer;
+/**
+ * core/video → embed block (self-hosted video)
+ */
+declare const video: BlockTransformer;
+/**
+ * core/audio → embed block (self-hosted audio)
+ */
+declare const audio: BlockTransformer;
+//#endregion
+//#region src/inline.d.ts
+interface ParseResult {
+  children: PortableTextSpan[];
+  markDefs: PortableTextMarkDef[];
+}
+/**
+ * Parse inline HTML content into Portable Text spans
+ */
+declare function parseInlineContent(html: string, generateKey: () => string): ParseResult;
+/**
+ * Extract plain text from HTML (for alt text, captions)
+ */
+declare function extractText(html: string): string;
+/**
+ * Extract alt text from an img element in HTML
+ */
+declare function extractAlt(html: string): string | undefined;
+/**
+ * Extract caption from a figcaption element
+ */
+declare function extractCaption(html: string): string | undefined;
+/**
+ * Extract src from an img element
+ */
+declare function extractSrc(html: string): string | undefined;
+//#endregion
+//#region src/index.d.ts
+/**
+ * Convert WordPress Gutenberg content to Portable Text
+ *
+ * @param content - WordPress post content (HTML with Gutenberg block comments)
+ * @param options - Conversion options
+ * @returns Array of Portable Text blocks
+ *
+ * @example
+ * ```ts
+ * const portableText = gutenbergToPortableText(`
+ *   <!-- wp:paragraph -->
+ *   <p>Hello <strong>world</strong>!</p>
+ *   <!-- /wp:paragraph -->
+ * `);
+ * // → [{ _type: "block", style: "normal", children: [...] }]
+ * ```
+ */
+declare function gutenbergToPortableText(content: string, options?: ConvertOptions): PortableTextBlock[];
+/**
+ * Convert plain HTML (classic editor) to Portable Text
+ */
+declare function htmlToPortableText(html: string, options?: ConvertOptions): PortableTextBlock[];
+/**
+ * Parse Gutenberg blocks without converting to Portable Text
+ * Useful for inspection and debugging
+ */
+declare function parseGutenbergBlocks(content: string): GutenbergBlock[];
+//#endregion
+export { type BlockTransformer, type ConvertOptions, type GutenbergBlock, type PortableTextBlock, type PortableTextBreakBlock, type PortableTextButtonBlock, type PortableTextButtonsBlock, type PortableTextCodeBlock, type PortableTextColumnsBlock, type PortableTextCoverBlock, type PortableTextEmbedBlock, type PortableTextFileBlock, type PortableTextGalleryBlock, type PortableTextHtmlBlock, type PortableTextImageBlock, type PortableTextMarkDef, type PortableTextPullquoteBlock, type PortableTextSpan, type PortableTextTextBlock, type TransformContext, core_d_exports as coreTransformers, defaultTransformers, embed_d_exports as embedTransformers, extractAlt, extractCaption, extractSrc, extractText, fallbackTransformer, gutenbergToPortableText, htmlToPortableText, parseGutenbergBlocks, parseInlineContent };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/transformers/index.ts","../src/transformers/core.ts","../src/transformers/embed.ts","../src/inline.ts","../src/index.ts"],"mappings":"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"}