@particle-academy/react-fancy 4.9.0 → 4.10.0

package/dist/index.d.cts

@@ -2062,6 +2062,17 @@ interface EditorProps {
     defaultValue?: string;
     onChange?: (value: string) => void;
     outputFormat?: "html" | "markdown";
+    /**
+     * The format of the INCOMING `value` / `defaultValue`. Default `"auto"`
+     * keeps the historical sniff (`detectFormat`) — but real-world markdown that
+     * merely mentions HTML-ish snippets (`<code>`, `<table`, …) flips the sniff
+     * to html and renders as a wall of text. Callers with a KNOWN format
+     * (file-typed content, values previously emitted with
+     * `outputFormat="markdown"`) should declare it; explicit values bypass the
+     * sniff entirely — in edit mode AND view mode.
+     * @default "auto"
+     */
+    valueFormat?: "markdown" | "html" | "auto";
     lineSpacing?: number;
     placeholder?: string;
     /**
@@ -2099,7 +2110,7 @@ declare namespace EditorContent {
     var displayName: string;
 }
 
-declare function EditorRoot({ children, className, value: controlledValue, defaultValue, onChange, outputFormat, lineSpacing, placeholder, mode: modeProp, extensions: instanceExtensions, unsafe, }: EditorProps): react.JSX.Element;
+declare function EditorRoot({ children, className, value: controlledValue, defaultValue, onChange, outputFormat, valueFormat, lineSpacing, placeholder, mode: modeProp, extensions: instanceExtensions, unsafe, }: EditorProps): react.JSX.Element;
 declare const Editor: typeof EditorRoot & {
     Toolbar: typeof EditorToolbar & {
         Separator: typeof EditorToolbarSeparator;

package/dist/index.d.ts

@@ -2062,6 +2062,17 @@ interface EditorProps {
     defaultValue?: string;
     onChange?: (value: string) => void;
     outputFormat?: "html" | "markdown";
+    /**
+     * The format of the INCOMING `value` / `defaultValue`. Default `"auto"`
+     * keeps the historical sniff (`detectFormat`) — but real-world markdown that
+     * merely mentions HTML-ish snippets (`<code>`, `<table`, …) flips the sniff
+     * to html and renders as a wall of text. Callers with a KNOWN format
+     * (file-typed content, values previously emitted with
+     * `outputFormat="markdown"`) should declare it; explicit values bypass the
+     * sniff entirely — in edit mode AND view mode.
+     * @default "auto"
+     */
+    valueFormat?: "markdown" | "html" | "auto";
     lineSpacing?: number;
     placeholder?: string;
     /**
@@ -2099,7 +2110,7 @@ declare namespace EditorContent {
     var displayName: string;
 }
 
-declare function EditorRoot({ children, className, value: controlledValue, defaultValue, onChange, outputFormat, lineSpacing, placeholder, mode: modeProp, extensions: instanceExtensions, unsafe, }: EditorProps): react.JSX.Element;
+declare function EditorRoot({ children, className, value: controlledValue, defaultValue, onChange, outputFormat, valueFormat, lineSpacing, placeholder, mode: modeProp, extensions: instanceExtensions, unsafe, }: EditorProps): react.JSX.Element;
 declare const Editor: typeof EditorRoot & {
     Toolbar: typeof EditorToolbar & {
         Separator: typeof EditorToolbarSeparator;

package/dist/index.js

@@ -11654,11 +11654,10 @@ function ContentRenderer({
   );
 }
 ContentRenderer.displayName = "ContentRenderer";
-function toHtml(value, outputFormat, unsafe) {
+function toHtml(value, outputFormat, unsafe, valueFormat = "auto") {
   if (!value) return "";
   const raw = (() => {
-    if (outputFormat === "html") return value;
-    const format = detectFormat(value);
+    const format = valueFormat !== "auto" ? valueFormat : outputFormat === "html" ? "html" : detectFormat(value);
     if (format === "html") return value;
     return marked.parse(value, { async: false }).trim();
   })();
@@ -11671,6 +11670,7 @@ function EditorRoot({
   defaultValue = "",
   onChange,
   outputFormat = "html",
+  valueFormat = "auto",
   lineSpacing = 1.6,
   placeholder,
   mode: modeProp,
@@ -11682,13 +11682,13 @@ function EditorRoot({
   const mode = useFieldMode(modeProp);
   const isView = mode === "view";
   const initialHtml = useMemo(
-    () => toHtml(value, outputFormat, unsafe),
+    () => toHtml(value, outputFormat, unsafe, valueFormat),
     // Seed the contentEditable from the LIVE value when (re)entering edit mode.
     // EditorContent reads this once on mount, and it only mounts in edit mode —
     // so this captures the current value on view→edit, not a stale mount snapshot,
     // and does NOT re-run on every keystroke.
     // eslint-disable-next-line react-hooks/exhaustive-deps
-    [isView, outputFormat, unsafe]
+    [isView, outputFormat, unsafe, valueFormat]
   );
   const extensions = useMemo(
     () => mergeExtensions(instanceExtensions),
@@ -11765,7 +11765,7 @@ function EditorRoot({
           ContentRenderer,
           {
             value,
-            format: outputFormat,
+            format: valueFormat !== "auto" ? valueFormat : outputFormat,
             lineSpacing,
             extensions: instanceExtensions,
             unsafe,