@vicacha-devs/astro-tiptap-blocks 1.2.0 → 1.2.1

package/dist/lib/sanitize/sanitize.js

@@ -1,3 +1,5 @@
+import { normalizeEmbedUrl } from "./sanitize-format";
+export * from "./sanitize-format";
 const SAFE_URL_PROTOCOLS = [
     "http:",
     "https:",
@@ -18,19 +20,30 @@ const HTML_ENTITIES = {
     "'": "'",
     " ": " ",
 };
+const safeFromCodePoint = (code, fallback) => {
+    if (!Number.isInteger(code) ||
+        code < 0 ||
+        code > 0x10ffff ||
+        (code >= 0xd800 && code <= 0xdfff)) {
+        return fallback;
+    }
+    return String.fromCodePoint(code);
+};
 export const decodeHtmlEntities = (text) => text
-    .replace(/&(?:amp|lt|gt|quot|#39|apos|nbsp);/g, (match) => HTML_ENTITIES[match] ?? match)
-    .replace(/&#(\d+);/g, (_, dec) => String.fromCharCode(Number(dec)))
-    .replace(/&#x([0-9a-fA-F]+);/g, (_, hex) => String.fromCharCode(parseInt(hex, 16)));
+    .replace(/&(?:amp|lt|gt|quot|#39|apos|nbsp);/gi, (match) => HTML_ENTITIES[match.toLowerCase()] ?? match)
+    .replace(/&#(\d+);/g, (match, dec) => safeFromCodePoint(Number(dec), match))
+    .replace(/&#x([0-9a-fA-F]+);/g, (match, hex) => safeFromCodePoint(parseInt(hex, 16), match));
 /**
  * Validates and sanitizes a URL for safe rendering in `href` or `src` attributes.
- * Blocks `javascript:`, `vbscript:`, `data:text/html`, `data:image/svg+xml`, and `//` protocol-relative URLs.
+ * Blocks `javascript:`, `vbscript:`, `data:text/html`, `data:image/svg+xml`, and `//` or `/\` protocol-relative URLs.
  */
 export const sanitizeTiptapUrl = (rawUrl) => {
     if (!rawUrl || typeof rawUrl !== "string")
         return "#";
-    const trimmed = decodeHtmlEntities(rawUrl).trim();
-    if (!trimmed || trimmed.startsWith("//"))
+    const trimmed = decodeHtmlEntities(rawUrl)
+        .replace(/[\u0000-\u001F\u007F-\u009F]+/g, "")
+        .trim();
+    if (!trimmed || /^[/\\]{2}|^\\/.test(trimmed))
         return "#";
     if (trimmed.startsWith("/") ||
         trimmed.startsWith("#") ||
@@ -38,7 +51,7 @@ export const sanitizeTiptapUrl = (rawUrl) => {
         trimmed.startsWith("../")) {
         return trimmed;
     }
-    const normalized = trimmed.replace(/[\u0000-\u001F\u007F-\u009F\s]+/g, "").toLowerCase();
+    const normalized = trimmed.replace(/\s+/g, "").toLowerCase();
     if (normalized.startsWith("javascript:") || normalized.startsWith("vbscript:"))
         return "#";
     if (normalized.startsWith("data:"))
@@ -53,7 +66,7 @@ export const sanitizeTiptapUrl = (rawUrl) => {
         return SAFE_URL_PROTOCOLS.includes(parsed.protocol.toLowerCase()) ? trimmed : "#";
     }
     catch {
-        return !trimmed.includes(":") ? trimmed : "#";
+        return !trimmed.includes(":") && !trimmed.includes("\\") ? trimmed : "#";
     }
 };
 /**
@@ -65,12 +78,37 @@ export const resolveTiptapMediaUrl = (rawUrl, options) => {
         return "#";
     const custom = options?.resolveMediaUrl ? options.resolveMediaUrl(rawUrl) : rawUrl;
     const candidate = (custom ?? rawUrl).trim();
-    if (options?.mediaBaseUrl && candidate.startsWith("/") && !candidate.startsWith("//")) {
+    if (options?.mediaBaseUrl && candidate.startsWith("/") && !/^[/\\]{2}/.test(candidate)) {
         const base = options.mediaBaseUrl.trim().replace(/\/+$/, "");
         return sanitizeTiptapUrl(`${base}${candidate}`);
     }
     return sanitizeTiptapUrl(candidate);
 };
+/**
+ * Sanitizes a responsive `srcset` attribute string by validating and resolving every candidate URL.
+ */
+export const sanitizeTiptapSrcset = (rawSrcset, options) => {
+    if (!rawSrcset || typeof rawSrcset !== "string")
+        return undefined;
+    const safeParts = [];
+    for (const entry of rawSrcset.split(",")) {
+        const tokens = entry.trim().split(/\s+/).filter(Boolean);
+        if (tokens.length === 0 || tokens.length > 2)
+            continue;
+        const safeUrl = resolveTiptapMediaUrl(tokens[0], options);
+        if (safeUrl === "#")
+            continue;
+        if (tokens.length === 2) {
+            if (!/^\d+(?:\.\d+)?[wx]$/i.test(tokens[1]))
+                continue;
+            safeParts.push(`${safeUrl} ${tokens[1]}`);
+        }
+        else {
+            safeParts.push(safeUrl);
+        }
+    }
+    return safeParts.length > 0 ? safeParts.join(", ") : undefined;
+};
 /**
  * Enforces HTTPS-only URLs and optional domain allowlist for sandboxed `<iframe>` embeds.
  */
@@ -79,7 +117,7 @@ export const sanitizeTiptapIframeUrl = (rawUrl, allowedDomains) => {
     if (safe === "#")
         return "#";
     try {
-        const parsed = new URL(safe);
+        const parsed = new URL(normalizeEmbedUrl(safe));
         if (parsed.protocol.toLowerCase() !== "https:")
             return "#";
         if (allowedDomains && allowedDomains.length > 0) {
@@ -97,111 +135,3 @@ export const sanitizeTiptapIframeUrl = (rawUrl, allowedDomains) => {
         return "#";
     }
 };
-const SAFE_COLOR_REGEX = /^(#[0-9a-fA-F]{3,8}|(?:rgb|rgba|hsl|hsla)\(\s*[\d.,%\s/]+\)|var\(--[a-zA-Z0-9_-]+\)|[a-zA-Z]{3,20})$/;
-const SAFE_DIMENSION_REGEX = /^\d+(?:\.\d+)?(?:px|rem|em|%|pt|ch|vh|vw)?$/;
-const SAFE_FONT_FAMILY_REGEX = /^[a-zA-Z0-9\s,'"-]+$/;
-export const sanitizeCssColor = (color) => {
-    if (!color || typeof color !== "string")
-        return null;
-    const trimmed = color.trim();
-    return SAFE_COLOR_REGEX.test(trimmed) ? trimmed : null;
-};
-export const sanitizeCssDimension = (val) => {
-    if (!val || typeof val !== "string")
-        return null;
-    const trimmed = val.trim();
-    return SAFE_DIMENSION_REGEX.test(trimmed) ? trimmed : null;
-};
-export const sanitizeCssFontFamily = (font) => {
-    if (!font || typeof font !== "string")
-        return null;
-    const trimmed = font.trim();
-    return SAFE_FONT_FAMILY_REGEX.test(trimmed) && !/url\(|expression\(|;/i.test(trimmed)
-        ? trimmed
-        : null;
-};
-export const sanitizeTextStyleAttrs = (attrs) => {
-    if (!attrs)
-        return undefined;
-    const color = sanitizeCssColor(attrs.color);
-    const fontFamily = sanitizeCssFontFamily(attrs.fontFamily);
-    const fontSize = sanitizeCssDimension(attrs.fontSize);
-    const lineHeight = sanitizeCssDimension(attrs.lineHeight);
-    if (!color && !fontFamily && !fontSize && !lineHeight)
-        return undefined;
-    return {
-        ...(color ? { color } : {}),
-        ...(fontFamily ? { fontFamily } : {}),
-        ...(fontSize ? { fontSize } : {}),
-        ...(lineHeight ? { lineHeight } : {}),
-    };
-};
-export const buildSafeInlineStyle = (attrs) => {
-    const safe = sanitizeTextStyleAttrs(attrs);
-    if (!safe)
-        return undefined;
-    const parts = [];
-    if (safe.color)
-        parts.push(`color: ${safe.color}`);
-    if (safe.fontFamily)
-        parts.push(`font-family: ${safe.fontFamily}`);
-    if (safe.fontSize)
-        parts.push(`font-size: ${safe.fontSize}`);
-    if (safe.lineHeight)
-        parts.push(`line-height: ${safe.lineHeight}`);
-    return parts.length > 0 ? parts.join("; ") : undefined;
-};
-export const slugifyHeadingText = (text) => text
-    .toLowerCase()
-    .trim()
-    .replace(/[^\w\s-]/g, "")
-    .replace(/[\s_-]+/g, "-")
-    .replace(/^-+|-+$/g, "") || "section";
-export const formatFileSize = (bytes) => {
-    const num = typeof bytes === "string" ? Number(bytes) : bytes;
-    if (!num || Number.isNaN(num) || num <= 0)
-        return "";
-    if (num < 1024)
-        return `${num} B`;
-    if (num < 1024 * 1024)
-        return `${(num / 1024).toFixed(1)} KB`;
-    return `${(num / (1024 * 1024)).toFixed(1)} MB`;
-};
-const LATEX_SYMBOLS = [
-    [/\\alpha(?![a-zA-Z])/g, "α"],
-    [/\\beta(?![a-zA-Z])/g, "β"],
-    [/\\gamma(?![a-zA-Z])/g, "γ"],
-    [/\\delta(?![a-zA-Z])/g, "δ"],
-    [/\\pi(?![a-zA-Z])/g, "π"],
-    [/\\theta(?![a-zA-Z])/g, "θ"],
-    [/\\lambda(?![a-zA-Z])/g, "λ"],
-    [/\\sigma(?![a-zA-Z])/g, "σ"],
-    [/\\omega(?![a-zA-Z])/g, "ω"],
-    [/\\infty(?![a-zA-Z])/g, "∞"],
-    [/\\sum(?![a-zA-Z])/g, "∑"],
-    [/\\prod(?![a-zA-Z])/g, "∏"],
-    [/\\int(?![a-zA-Z])/g, "∫"],
-    [/\\sqrt\{([^}]+)\}/g, "√($1)"],
-    [/\\sqrt(?![a-zA-Z])/g, "√"],
-    [/\\frac\{([^}]+)\}\{([^}]+)\}/g, "($1)/($2)"],
-    [/\\pm(?![a-zA-Z])/g, "±"],
-    [/\\times(?![a-zA-Z])/g, "×"],
-    [/\\div(?![a-zA-Z])/g, "÷"],
-    [/\\cdot(?![a-zA-Z])/g, "·"],
-    [/\\neq(?![a-zA-Z])/g, "≠"],
-    [/\\leq(?![a-zA-Z])/g, "≤"],
-    [/\\geq(?![a-zA-Z])/g, "≥"],
-    [/\\approx(?![a-zA-Z])/g, "≈"],
-    [/\\rightarrow(?![a-zA-Z])|\\to(?![a-zA-Z])/g, "→"],
-    [/\\leftarrow(?![a-zA-Z])/g, "←"],
-    [/\\Rightarrow(?![a-zA-Z])/g, "⇒"],
-];
-export const formatLatexPreview = (latex) => {
-    if (!latex)
-        return "";
-    let result = latex.trim();
-    for (const [pattern, replacement] of LATEX_SYMBOLS) {
-        result = result.replace(pattern, replacement);
-    }
-    return result;
-};

package/dist/lib/theme/theme-default.d.ts

@@ -0,0 +1,2 @@
+import type { TiptapBlockTheme } from "../../types";
+export declare const TiptapBlockThemeDefault: TiptapBlockTheme;

package/dist/lib/theme/theme-default.js

@@ -0,0 +1,119 @@
+export const TiptapBlockThemeDefault = {
+    default: "",
+    heading: {
+        default: "font-bold tracking-tight leading-tight",
+        h1: "text-4xl mt-8 mb-4",
+        h2: "text-3xl mt-7 mb-3",
+        h3: "text-2xl mt-6 mb-3",
+        h4: "text-xl mt-5 mb-2",
+        h5: "text-lg mt-4 mb-2",
+        h6: "text-base mt-3 mb-2",
+    },
+    paragraph: {
+        default: "text-base leading-relaxed my-4",
+        link: "underline underline-offset-4 hover:opacity-80 transition-opacity",
+        bold: "font-bold",
+        italic: "italic",
+        underline: "underline",
+        strikethrough: "line-through",
+        code: "font-mono text-sm px-1.5 py-0.5 rounded bg-black/5 dark:bg-white/10",
+        highlight: "bg-yellow-200/70 dark:bg-yellow-500/30 px-1 rounded",
+        subscript: "text-xs align-sub",
+        superscript: "text-xs align-super",
+        abbr: "underline decoration-dotted cursor-help",
+        language: "",
+        linker: "inline-flex items-center gap-1 underline underline-offset-4 font-medium hover:opacity-80",
+        mathInline: "font-mono text-sm px-1.5 py-0.5 rounded bg-indigo-500/10 text-indigo-700 dark:text-indigo-300",
+    },
+    leadParagraph: { default: "text-xl leading-relaxed my-5 opacity-90 font-normal" },
+    quote: { default: "border-s-4 ps-4 italic my-6 opacity-90" },
+    informationPane: {
+        default: "my-6 p-4 rounded-lg border-s-4",
+        info: "bg-blue-500/10 border-blue-500 text-blue-950 dark:text-blue-100",
+        success: "bg-emerald-500/10 border-emerald-500 text-emerald-950 dark:text-emerald-100",
+        warning: "bg-amber-500/10 border-amber-500 text-amber-950 dark:text-amber-100",
+        danger: "bg-rose-500/10 border-rose-500 text-rose-950 dark:text-rose-100",
+        neutral: "bg-neutral-500/10 border-neutral-500 text-neutral-900 dark:text-neutral-100",
+        tip: "bg-purple-500/10 border-purple-500 text-purple-950 dark:text-purple-100",
+        title: "font-semibold mb-1 block",
+        body: "space-y-2 text-sm leading-relaxed",
+    },
+    conversationHistory: {
+        default: "my-6 p-4 rounded-lg border bg-black/[0.02] dark:bg-white/[0.03]",
+        header: "flex items-center justify-between gap-2 mb-2 text-xs opacity-75",
+        author: "font-semibold",
+        timestamp: "font-mono",
+        body: "space-y-2 text-sm",
+    },
+    details: {
+        default: "my-6 rounded-lg border p-4",
+        summary: "font-semibold cursor-pointer select-none",
+        content: "mt-3 space-y-2",
+    },
+    columns: {
+        default: "my-6 grid gap-6 md:grid-cols-2",
+        column: "min-w-0 space-y-4",
+    },
+    list: {
+        default: "my-4 ps-6 space-y-2",
+        ordered: "list-decimal",
+        unordered: "list-disc",
+        item: "leading-relaxed",
+    },
+    taskList: {
+        default: "my-4 space-y-2 list-none ps-0",
+        item: "flex items-start gap-2.5 leading-relaxed",
+        checkbox: "mt-1.5 h-4 w-4 rounded border accent-current",
+        content: "flex-1",
+        checked: "line-through opacity-70",
+    },
+    code: {
+        default: "font-mono text-sm p-4 my-6 rounded-lg overflow-x-auto bg-neutral-900 text-neutral-100",
+        line: "block",
+    },
+    image: {
+        default: "my-6",
+        image: "max-w-full h-auto rounded-lg",
+        caption: "text-sm opacity-75 mt-2 text-center",
+    },
+    video: {
+        default: "my-6",
+        video: "w-full rounded-lg",
+        iframe: "w-full aspect-video rounded-lg border-0",
+        caption: "text-sm opacity-75 mt-2 text-center",
+    },
+    audio: {
+        default: "my-6",
+        audio: "w-full",
+        caption: "text-sm opacity-75 mt-2 text-center",
+    },
+    attachment: {
+        default: "my-4 flex items-center justify-between gap-4 p-3.5 rounded-lg border",
+        badge: "px-2 py-1 text-xs font-mono font-bold uppercase rounded bg-black/10 dark:bg-white/10",
+        title: "font-medium text-sm truncate",
+        meta: "text-xs opacity-70",
+        button: "text-xs font-semibold underline underline-offset-4 shrink-0",
+    },
+    iframe: { default: "my-6", iframe: "w-full rounded-lg border" },
+    mathematics: {
+        default: "my-6 p-4 rounded-lg bg-black/[0.03] dark:bg-white/[0.04] overflow-x-auto text-center",
+        formula: "font-mono text-base",
+    },
+    tableOfContents: {
+        default: "my-6 p-4 rounded-lg border bg-black/[0.02] dark:bg-white/[0.02]",
+        title: "font-semibold text-sm uppercase tracking-wider opacity-75 mb-2",
+        list: "space-y-1.5 text-sm list-none ps-0",
+        item: "leading-snug",
+        link: "underline underline-offset-4 hover:opacity-80",
+    },
+    pageBreak: { default: "my-8 border-t-2 border-dashed opacity-30 print:break-after-page" },
+    table: {
+        default: "w-full border-collapse my-6 text-sm",
+        head: "border-b-2",
+        body: "divide-y",
+        row: "transition-colors",
+        headerCell: "px-4 py-3 text-start font-semibold",
+        cell: "px-4 py-3 align-top",
+    },
+    hr: { default: "my-8 border-t opacity-20" },
+};

package/dist/lib/theme/theme.d.ts

@@ -1,5 +1,7 @@
 import type { TiptapBlockTheme, TiptapBlockThemeProperty, TiptapBlockThemePropertyValue, TiptapBlockUserTheme } from "../../types";
-export declare const TiptapBlockThemeDefault: TiptapBlockTheme;
+import { TiptapBlockThemeDefault } from "./theme-default";
+export { TiptapBlockThemeDefault };
+export declare const mapNodeTypeToThemeKey: (nodeType: string) => string;
 export declare const getPropertyClass: (value: TiptapBlockThemePropertyValue) => string;
 export declare const renderPropertyClasses: <T extends TiptapBlockThemeProperty>(theme: T, key?: keyof Omit<T, "default"> | Array<keyof Omit<T, "default">>) => string;
 export declare const buildThemeObject: (userTheme?: TiptapBlockUserTheme, defaultTheme?: TiptapBlockTheme) => TiptapBlockTheme;

package/dist/lib/theme/theme.js

@@ -1,122 +1,14 @@
-export const TiptapBlockThemeDefault = {
-    default: "",
-    heading: {
-        default: "font-bold tracking-tight leading-tight",
-        h1: "text-4xl mt-8 mb-4",
-        h2: "text-3xl mt-7 mb-3",
-        h3: "text-2xl mt-6 mb-3",
-        h4: "text-xl mt-5 mb-2",
-        h5: "text-lg mt-4 mb-2",
-        h6: "text-base mt-3 mb-2",
-    },
-    paragraph: {
-        default: "text-base leading-relaxed my-4",
-        link: "underline underline-offset-4 hover:opacity-80 transition-opacity",
-        bold: "font-bold",
-        italic: "italic",
-        underline: "underline",
-        strikethrough: "line-through",
-        code: "font-mono text-sm px-1.5 py-0.5 rounded bg-black/5 dark:bg-white/10",
-        highlight: "bg-yellow-200/70 dark:bg-yellow-500/30 px-1 rounded",
-        subscript: "text-xs align-sub",
-        superscript: "text-xs align-super",
-        abbr: "underline decoration-dotted cursor-help",
-        language: "",
-        linker: "inline-flex items-center gap-1 underline underline-offset-4 font-medium hover:opacity-80",
-        mathInline: "font-mono text-sm px-1.5 py-0.5 rounded bg-indigo-500/10 text-indigo-700 dark:text-indigo-300",
-    },
-    leadParagraph: { default: "text-xl leading-relaxed my-5 opacity-90 font-normal" },
-    quote: { default: "border-s-4 ps-4 italic my-6 opacity-90" },
-    informationPane: {
-        default: "my-6 p-4 rounded-lg border-s-4",
-        info: "bg-blue-500/10 border-blue-500 text-blue-950 dark:text-blue-100",
-        success: "bg-emerald-500/10 border-emerald-500 text-emerald-950 dark:text-emerald-100",
-        warning: "bg-amber-500/10 border-amber-500 text-amber-950 dark:text-amber-100",
-        danger: "bg-rose-500/10 border-rose-500 text-rose-950 dark:text-rose-100",
-        neutral: "bg-neutral-500/10 border-neutral-500 text-neutral-900 dark:text-neutral-100",
-        tip: "bg-purple-500/10 border-purple-500 text-purple-950 dark:text-purple-100",
-        title: "font-semibold mb-1 block",
-        body: "space-y-2 text-sm leading-relaxed",
-    },
-    conversationHistory: {
-        default: "my-6 p-4 rounded-lg border bg-black/[0.02] dark:bg-white/[0.03]",
-        header: "flex items-center justify-between gap-2 mb-2 text-xs opacity-75",
-        author: "font-semibold",
-        timestamp: "font-mono",
-        body: "space-y-2 text-sm",
-    },
-    details: {
-        default: "my-6 rounded-lg border p-4",
-        summary: "font-semibold cursor-pointer select-none",
-        content: "mt-3 space-y-2",
-    },
-    columns: {
-        default: "my-6 grid gap-6 md:grid-cols-2",
-        column: "min-w-0 space-y-4",
-    },
-    list: {
-        default: "my-4 ps-6 space-y-2",
-        ordered: "list-decimal",
-        unordered: "list-disc",
-        item: "leading-relaxed",
-    },
-    taskList: {
-        default: "my-4 space-y-2 list-none ps-0",
-        item: "flex items-start gap-2.5 leading-relaxed",
-        checkbox: "mt-1.5 h-4 w-4 rounded border accent-current",
-        content: "flex-1",
-        checked: "line-through opacity-70",
-    },
-    code: {
-        default: "font-mono text-sm p-4 my-6 rounded-lg overflow-x-auto bg-neutral-900 text-neutral-100",
-        line: "block",
-    },
-    image: {
-        default: "my-6",
-        image: "max-w-full h-auto rounded-lg",
-        caption: "text-sm opacity-75 mt-2 text-center",
-    },
-    video: {
-        default: "my-6",
-        video: "w-full rounded-lg",
-        iframe: "w-full aspect-video rounded-lg border-0",
-        caption: "text-sm opacity-75 mt-2 text-center",
-    },
-    audio: {
-        default: "my-6",
-        audio: "w-full",
-        caption: "text-sm opacity-75 mt-2 text-center",
-    },
-    attachment: {
-        default: "my-4 flex items-center justify-between gap-4 p-3.5 rounded-lg border",
-        badge: "px-2 py-1 text-xs font-mono font-bold uppercase rounded bg-black/10 dark:bg-white/10",
-        title: "font-medium text-sm truncate",
-        meta: "text-xs opacity-70",
-        button: "text-xs font-semibold underline underline-offset-4 shrink-0",
-    },
-    iframe: { default: "my-6", iframe: "w-full rounded-lg border" },
-    mathematics: {
-        default: "my-6 p-4 rounded-lg bg-black/[0.03] dark:bg-white/[0.04] overflow-x-auto text-center",
-        formula: "font-mono text-base",
-    },
-    tableOfContents: {
-        default: "my-6 p-4 rounded-lg border bg-black/[0.02] dark:bg-white/[0.02]",
-        title: "font-semibold text-sm uppercase tracking-wider opacity-75 mb-2",
-        list: "space-y-1.5 text-sm list-none ps-0",
-        item: "leading-snug",
-        link: "underline underline-offset-4 hover:opacity-80",
-    },
-    pageBreak: { default: "my-8 border-t-2 border-dashed opacity-30 print:break-after-page" },
-    table: {
-        default: "w-full border-collapse my-6 text-sm",
-        head: "border-b-2",
-        body: "divide-y",
-        row: "transition-colors",
-        headerCell: "px-4 py-3 text-start font-semibold",
-        cell: "px-4 py-3 align-top",
-    },
-    hr: { default: "my-8 border-t opacity-20" },
+import { TiptapBlockThemeDefault } from "./theme-default";
+export { TiptapBlockThemeDefault };
+const NODE_TYPE_TO_THEME_KEY = {
+    blockquote: "quote",
+    layoutContainer: "columns",
+    codeBlock: "code",
+    bulletList: "list",
+    orderedList: "list",
+    horizontalRule: "hr",
 };
+export const mapNodeTypeToThemeKey = (nodeType) => NODE_TYPE_TO_THEME_KEY[nodeType] ?? nodeType;
 export const getPropertyClass = (value) => {
     if (!value)
         return "";

package/dist/types/custom.d.ts

@@ -1,6 +1,25 @@
 import type { AstroComponentFactory } from "astro/runtime/server/index.js";
 import type { DeepPartial } from "./common";
 import type { TiptapBlockThemeCustomComponents } from "./theme";
+import type { TiptapInternalLinkResolver, TiptapMediaUrlResolver } from "./tiptap-inline";
 export type TiptapBlockUserComponents = DeepPartial<TiptapBlockThemeCustomComponents> & {
     [customBlockType: string]: AstroComponentFactory | undefined;
 };
+export type TiptapRenderContextProps = {
+    /** Optional custom Astro block component overrides. @default {} */
+    customBlocks?: TiptapBlockUserComponents;
+    /** Renders an accessible `#` permalink anchor inside headings. @default false */
+    headingAnchors?: boolean;
+    /** Adds `data-line-number` attributes to code blocks. @default false */
+    showCodeLineNumbers?: boolean;
+    /** Renders a header bar with copy button on code blocks. @default false */
+    copyableCodeBlocks?: boolean;
+    /** Optional media base URL prefixed to relative `/uploads/...` media URLs. */
+    mediaBaseUrl?: string;
+    /** Optional custom resolver for media URLs before sanitization. */
+    resolveMediaUrl?: TiptapMediaUrlResolver;
+    /** Optional domain allowlist for HTTPS `<iframe>` and video embeds. */
+    allowedIframeDomains?: ReadonlyArray<string>;
+    /** Optional callback to resolve internal links (`tiptap://collectionName/documentId` and `linker` nodes). */
+    resolveInternalLink?: TiptapInternalLinkResolver;
+};

package/dist/types/tiptap-inline.d.ts

@@ -92,3 +92,4 @@ export type TiptapInternalLinkContext = {
     label?: string | null;
 };
 export type TiptapInternalLinkResolver = (link: TiptapInternalLinkContext) => string;
+export type TiptapMediaUrlResolver = (url: string) => string | null | undefined;

package/dist/types/tiptap-media.d.ts

@@ -0,0 +1,146 @@
+import type { TiptapBlockNode } from "./tiptap";
+import type { TiptapElementAlign, TiptapHeadingLevel, TiptapInternalLinkResolver, TiptapMediaUrlResolver } from "./tiptap-inline";
+export type TiptapMediaCommonAttrs = {
+    "data-align"?: TiptapElementAlign | null;
+    "data-asset-id"?: string | number | null;
+    "data-document-id"?: string | null;
+};
+export type TiptapImageNode = {
+    type: "image";
+    attrs: TiptapMediaCommonAttrs & {
+        src: string;
+        alt?: string | null;
+        title?: string | null;
+        caption?: string | null;
+        width?: number | string | null;
+        height?: number | string | null;
+        srcset?: string | null;
+        sizes?: string | null;
+        loading?: "lazy" | "eager" | null;
+        decoding?: "async" | "sync" | "auto" | null;
+        fetchpriority?: "high" | "low" | "auto" | null;
+    };
+};
+export type TiptapVideoNode = {
+    type: "video";
+    attrs: TiptapMediaCommonAttrs & {
+        src: string;
+        embedType?: "embed" | "file" | null;
+        title?: string | null;
+        caption?: string | null;
+        width?: number | string | null;
+        height?: number | string | null;
+        mime?: string | null;
+    };
+};
+export type TiptapAudioNode = {
+    type: "audio";
+    attrs: TiptapMediaCommonAttrs & {
+        src: string;
+        title?: string | null;
+        caption?: string | null;
+        mime?: string | null;
+    };
+};
+export type TiptapAttachmentNode = {
+    type: "attachment";
+    attrs: TiptapMediaCommonAttrs & {
+        href: string;
+        filename?: string | null;
+        title?: string | null;
+        size?: number | string | null;
+        mime?: string | null;
+        ext?: string | null;
+    };
+};
+export type TiptapIframeNode = {
+    type: "iframe";
+    attrs: {
+        "src": string;
+        "title"?: string | null;
+        "width"?: number | string | null;
+        "height"?: number | string | null;
+        "data-align"?: TiptapElementAlign | null;
+    };
+};
+export type TiptapMediaBlockAttrs = TiptapMediaCommonAttrs & {
+    src?: string;
+    href?: string;
+    embedType?: "embed" | "file" | null;
+    title?: string | null;
+    caption?: string | null;
+    filename?: string | null;
+    size?: number | string | null;
+    mime?: string | null;
+    ext?: string | null;
+    width?: number | string | null;
+    height?: number | string | null;
+};
+export type TiptapCustomBlockNode = {
+    type: string;
+    attrs?: Record<string, unknown>;
+    content?: Array<TiptapBlockNode>;
+};
+export type TiptapTocHeadingItem = {
+    id: string;
+    text: string;
+    level: TiptapHeadingLevel;
+};
+export type TiptapTableOfContentsNode = {
+    type: "tableOfContents";
+    attrs?: {
+        headings?: Array<TiptapTocHeadingItem>;
+        title?: string | null;
+    };
+};
+export type TiptapPageBreakNode = {
+    type: "pageBreak";
+};
+export type TiptapHorizontalRuleNode = {
+    type: "horizontalRule";
+};
+export type TiptapTableCellNode = {
+    type: "tableHeader" | "tableCell";
+    attrs?: {
+        colspan?: number;
+        rowspan?: number;
+        colwidth?: Array<number> | null;
+        backgroundColor?: string | null;
+    };
+    content?: Array<TiptapBlockNode>;
+};
+export type TiptapTableRowNode = {
+    type: "tableRow";
+    content?: Array<TiptapTableCellNode>;
+};
+export type TiptapTableNode = {
+    type: "table";
+    content?: Array<TiptapTableRowNode>;
+};
+export type TiptapDocStats = {
+    words: number;
+    characters: number;
+    readingTimeMinutes: number;
+    readingTime?: string;
+    wordsPerMinute?: number;
+};
+export type TiptapDocNode = {
+    type: "doc";
+    content: Array<TiptapBlockNode>;
+    words?: number;
+    characters?: number;
+    readingTimeMinutes?: number;
+    readingTime?: string;
+    stats?: TiptapDocStats;
+};
+export type TiptapContentInput = TiptapDocNode | {
+    type: "doc";
+    content: Array<TiptapBlockNode | TiptapCustomBlockNode>;
+} | Array<TiptapBlockNode | TiptapCustomBlockNode> | string | ReadonlyArray<string> | null | undefined;
+export type TiptapParserOptions = {
+    allowedIframeDomains?: ReadonlyArray<string>;
+    resolveInternalLink?: TiptapInternalLinkResolver;
+    mediaBaseUrl?: string;
+    resolveMediaUrl?: TiptapMediaUrlResolver;
+};
+export type { TiptapMediaUrlResolver };

package/dist/types/tiptap-media.js

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