@particle-academy/react-fancy 4.9.0 → 4.11.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { ButtonHTMLAttributes, AnchorHTMLAttributes, ReactNode, InputHTMLAttributes, TextareaHTMLAttributes, SelectHTMLAttributes, FormHTMLAttributes, TdHTMLAttributes, HTMLAttributes, ComponentType, CSSProperties, ReactElement, RefObject } from 'react';
+import { ButtonHTMLAttributes, ElementType, AnchorHTMLAttributes, ReactNode, InputHTMLAttributes, TextareaHTMLAttributes, SelectHTMLAttributes, FormHTMLAttributes, TdHTMLAttributes, HTMLAttributes, ComponentType, CSSProperties, ReactElement, RefObject } from 'react';
 import { ClassValue } from 'clsx';
 
 type Size = "xs" | "sm" | "md" | "lg" | "xl";
@@ -59,6 +59,14 @@ interface ButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "col
     disabled?: boolean;
     /** Render as anchor tag */
     href?: string;
+    /**
+     * Anchor-mode element override — the component to render INSTEAD of the
+     * plain `<a>` when `href` is set, e.g. a router's `<Link>` (Inertia, React
+     * Router, Next) so the button navigates client-side. Receives `href`,
+     * `className`, and the forwarded rest props. Ignored without `href` or when
+     * `disabled` (the plain `<button>` renders as always).
+     */
+    as?: ElementType;
     /** Anchor `target` — only applies in `href` (anchor) mode. */
     target?: AnchorHTMLAttributes<HTMLAnchorElement>["target"];
     /** Anchor `rel` — only applies in `href` (anchor) mode. */
@@ -2062,6 +2070,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 +2118,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

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { ButtonHTMLAttributes, AnchorHTMLAttributes, ReactNode, InputHTMLAttributes, TextareaHTMLAttributes, SelectHTMLAttributes, FormHTMLAttributes, TdHTMLAttributes, HTMLAttributes, ComponentType, CSSProperties, ReactElement, RefObject } from 'react';
+import { ButtonHTMLAttributes, ElementType, AnchorHTMLAttributes, ReactNode, InputHTMLAttributes, TextareaHTMLAttributes, SelectHTMLAttributes, FormHTMLAttributes, TdHTMLAttributes, HTMLAttributes, ComponentType, CSSProperties, ReactElement, RefObject } from 'react';
 import { ClassValue } from 'clsx';
 
 type Size = "xs" | "sm" | "md" | "lg" | "xl";
@@ -59,6 +59,14 @@ interface ButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "col
     disabled?: boolean;
     /** Render as anchor tag */
     href?: string;
+    /**
+     * Anchor-mode element override — the component to render INSTEAD of the
+     * plain `<a>` when `href` is set, e.g. a router's `<Link>` (Inertia, React
+     * Router, Next) so the button navigates client-side. Receives `href`,
+     * `className`, and the forwarded rest props. Ignored without `href` or when
+     * `disabled` (the plain `<button>` renders as always).
+     */
+    as?: ElementType;
     /** Anchor `target` — only applies in `href` (anchor) mode. */
     target?: AnchorHTMLAttributes<HTMLAnchorElement>["target"];
     /** Anchor `rel` — only applies in `href` (anchor) mode. */
@@ -2062,6 +2070,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 +2118,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

@@ -2419,6 +2419,7 @@ var Button = forwardRef(
     loading = false,
     disabled,
     href,
+    as: As,
     responsive,
     labelClassName,
     ...props
@@ -2581,11 +2582,12 @@ var Button = forwardRef(
       trailingElements
     ] });
     const safeHref = sanitizeHref(href);
+    const Anchor = As ?? "a";
     const buttonEl = safeHref && !disabled ? (
       // Anchor mode forwards the same rest props as the <button> branch so
       // onClick / target / rel / ref / ARIA / data-* reach the <a> (issue #7).
       /* @__PURE__ */ jsx(
-        "a",
+        Anchor,
         {
           ref,
           href: safeHref,
@@ -11654,11 +11656,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 +11672,7 @@ function EditorRoot({
   defaultValue = "",
   onChange,
   outputFormat = "html",
+  valueFormat = "auto",
   lineSpacing = 1.6,
   placeholder,
   mode: modeProp,
@@ -11682,13 +11684,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 +11767,7 @@ function EditorRoot({
           ContentRenderer,
           {
             value,
-            format: outputFormat,
+            format: valueFormat !== "auto" ? valueFormat : outputFormat,
             lineSpacing,
             extensions: instanceExtensions,
             unsafe,