@devalok/shilp-sutra 0.49.4 → 0.50.0

package/dist/composed/rich-text-editor.d.ts

@@ -1,4 +1,5 @@
 "use client";
+import { Editor } from '@tiptap/react';
 import { EmojiSet } from './emoji-picker';
 import * as React from 'react';
 export type ToolbarItem = 'bold' | 'italic' | 'underline' | 'strike' | 'highlight' | 'h2' | 'h3' | 'blockquote' | 'bulletList' | 'orderedList' | 'taskList' | 'codeBlock' | 'link' | 'image' | 'file' | 'hr' | 'alignLeft' | 'alignCenter' | 'alignRight' | 'emoji' | 'undo' | 'redo';
@@ -10,14 +11,20 @@ export interface MentionItem {
 /**
  * A Tiptap-powered rich text editor with a configurable toolbar, @mentions,
  * emoji suggestions, file/image uploads, and task lists.
- * Outputs sanitized HTML via `onChange`.
+ *
+ * Emits HTML by default, or Markdown when `format="markdown"`. NOTE: the HTML
+ * output is the editor's raw HTML and is NOT sanitized — do not render it as
+ * untrusted content without sanitizing it first. Storing Markdown (and
+ * rendering via MarkdownViewer) sidesteps that risk entirely.
  */
 export interface RichTextEditorProps extends Omit<React.ComponentPropsWithoutRef<'div'>, 'onChange' | 'content'> {
-    /** Initial HTML content. Updates are NOT reactive — use `onChange` for controlled state. */
+    /** Content format read and emitted. `markdown` for Markdown in/out; `html` uses HTML. @default 'html' */
+    format?: 'html' | 'markdown';
+    /** Initial content, interpreted per `format`. Updates are NOT reactive — use `onChange` for controlled state. */
     content?: string;
     placeholder?: string;
-    /** Called with the editor's HTML string whenever content changes. */
-    onChange?: (html: string) => void;
+    /** Called with the editor content (HTML, or Markdown when `format="markdown"`) whenever it changes. */
+    onChange?: (value: string) => void;
     className?: string;
     /** Set to false to render in read-only mode (e.g. for previewing). */
     editable?: boolean;
@@ -39,12 +46,80 @@ export interface RichTextEditorProps extends Omit<React.ComponentPropsWithoutRef
     onMentionSelect?: (item: MentionItem) => void;
     /** Emoji art style. @default 'native' */
     emojiSet?: EmojiSet;
+    /** Show a source-view toggle (raw Markdown ⇄ visual) in the top-right of the default editor. @default false */
+    sourceToggle?: boolean;
+    /** Controlled source-view state — drive it from an external button. */
+    sourceMode?: boolean;
+    /** Uncontrolled initial source-view state. @default false */
+    defaultSourceMode?: boolean;
+    /** Called when the source view toggles (raw Markdown ⇄ visual). */
+    onSourceModeChange?: (source: boolean) => void;
 }
-declare const RichTextEditor: React.ForwardRefExoticComponent<RichTextEditorProps & React.RefAttributes<HTMLDivElement>>;
+interface RTEContextValue {
+    editor: Editor;
+    toolbar?: ToolbarItem[];
+    editable: boolean;
+    onImageClick: () => void;
+    onFileClick?: () => void;
+    onEmojiClick: () => void;
+    /** Raw-Markdown source view active. */
+    sourceMode: boolean;
+    setSourceMode: (source: boolean) => void;
+    toggleSource: () => void;
+    sourceText: string;
+    onSourceChange: (value: string) => void;
+}
+/** Access the editor + toolbar wiring inside a `<RichTextEditor.Provider>`. */
+declare function useRichTextEditor(): RTEContextValue;
+export interface RichTextEditorProviderProps extends RichTextEditorProps {
+    children?: React.ReactNode;
+}
+/**
+ * Owns the Tiptap editor + all upload/emoji/mention plumbing and provides it to
+ * `RichTextEditor.Toolbar` / `RichTextEditor.Content`. Compose your own layout
+ * (toolbar top/bottom/floating, or bring your own) around these slots, or use
+ * `<RichTextEditor>` for the batteries-included default.
+ */
+declare const RichTextEditorProvider: React.ForwardRefExoticComponent<RichTextEditorProviderProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * The formatting toolbar. Reads the editor from `<RichTextEditor.Provider>`.
+ * In source view the format controls hide but `trailing` (e.g. the source
+ * toggle) stays, so the bar persists.
+ */
+declare function RichTextEditorToolbarSlot({ trailing }: {
+    trailing?: React.ReactNode;
+}): React.JSX.Element | null;
+declare namespace RichTextEditorToolbarSlot {
+    var displayName: string;
+}
+/** The content area — the visual editor, or a raw-Markdown textarea in source view. */
+declare function RichTextEditorContentSlot(): React.JSX.Element;
+declare namespace RichTextEditorContentSlot {
+    var displayName: string;
+}
+/**
+ * A source-view toggle (raw Markdown ⇄ visual). Text + icon by default;
+ * pass `iconOnly` for a compact button. Place it anywhere inside a Provider.
+ */
+declare function RichTextEditorSourceToggleSlot({ className, iconOnly }: {
+    className?: string;
+    iconOnly?: boolean;
+}): React.JSX.Element;
+declare namespace RichTextEditorSourceToggleSlot {
+    var displayName: string;
+}
+declare const RichTextEditor: React.ForwardRefExoticComponent<RichTextEditorProps & React.RefAttributes<HTMLDivElement>> & {
+    Provider: React.ForwardRefExoticComponent<RichTextEditorProviderProps & React.RefAttributes<HTMLDivElement>>;
+    Toolbar: typeof RichTextEditorToolbarSlot;
+    Content: typeof RichTextEditorContentSlot;
+    SourceToggle: typeof RichTextEditorSourceToggleSlot;
+};
 export interface RichTextViewerProps extends Omit<React.ComponentPropsWithoutRef<'div'>, 'content'> {
     content: string;
+    /** Content format. `markdown` parses Markdown; `html` (default) parses HTML. @default 'html' */
+    format?: 'html' | 'markdown';
     className?: string;
 }
 declare const RichTextViewer: React.ForwardRefExoticComponent<RichTextViewerProps & React.RefAttributes<HTMLDivElement>>;
-export { RichTextEditor, RichTextViewer };
+export { RichTextEditor, RichTextEditorProvider, RichTextEditorToolbarSlot as RichTextEditorToolbar, RichTextEditorContentSlot as RichTextEditorContent, RichTextEditorSourceToggleSlot as RichTextEditorSourceToggle, useRichTextEditor, RichTextViewer, };
 //# sourceMappingURL=rich-text-editor.d.ts.map

package/dist/composed/rich-text-editor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rich-text-editor.d.ts","sourceRoot":"","sources":["../../src/composed/rich-text-editor.tsx"],"names":[],"mappings":"AAkCA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAM9B,OAAO,KAAK,EAAa,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAuUzD,MAAM,MAAM,WAAW,GACnB,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GACxD,IAAI,GAAG,IAAI,GAAG,YAAY,GAC1B,YAAY,GAAG,aAAa,GAAG,UAAU,GAAG,WAAW,GACvD,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,GAChC,WAAW,GAAG,aAAa,GAAG,YAAY,GAC1C,OAAO,GAAG,MAAM,GAAG,MAAM,CAAA;AAE7B,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAC9G,4FAA4F;IAC5F,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,sGAAsG;IACtG,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAC/C,oGAAoG;IACpG,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACnF,+DAA+D;IAC/D,OAAO,CAAC,EAAE,WAAW,EAAE,CAAA;IACvB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;IACxB,0EAA0E;IAC1E,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA;IAC3D,sEAAsE;IACtE,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAA;IAC7C,yCAAyC;IACzC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB;AAED,QAAA,MAAM,cAAc,4FAwPnB,CAAA;AAID,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IACjG,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,QAAA,MAAM,cAAc,4FAuDnB,CAAA;AAID,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,CAAA"}
+{"version":3,"file":"rich-text-editor.d.ts","sourceRoot":"","sources":["../../src/composed/rich-text-editor.tsx"],"names":[],"mappings":"AAkCA,OAAO,EAAE,KAAK,MAAM,EAA2C,MAAM,eAAe,CAAA;AAGpF,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAM9B,OAAO,KAAK,EAAa,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AA+UzD,MAAM,MAAM,WAAW,GACnB,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GACxD,IAAI,GAAG,IAAI,GAAG,YAAY,GAC1B,YAAY,GAAG,aAAa,GAAG,UAAU,GAAG,WAAW,GACvD,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,GAChC,WAAW,GAAG,aAAa,GAAG,YAAY,GAC1C,OAAO,GAAG,MAAM,GAAG,MAAM,CAAA;AAE7B,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAC9G,yGAAyG;IACzG,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAAA;IAC5B,iHAAiH;IACjH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,uGAAuG;IACvG,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,sGAAsG;IACtG,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAC/C,oGAAoG;IACpG,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACnF,+DAA+D;IAC/D,OAAO,CAAC,EAAE,WAAW,EAAE,CAAA;IACvB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;IACxB,0EAA0E;IAC1E,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA;IAC3D,sEAAsE;IACtE,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAA;IAC7C,yCAAyC;IACzC,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,+GAA+G;IAC/G,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,uEAAuE;IACvE,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,mEAAmE;IACnE,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAA;CAC/C;AAID,UAAU,eAAe;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,WAAW,EAAE,CAAA;IACvB,QAAQ,EAAE,OAAO,CAAA;IACjB,YAAY,EAAE,MAAM,IAAI,CAAA;IACxB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;IACxB,YAAY,EAAE,MAAM,IAAI,CAAA;IACxB,uCAAuC;IACvC,UAAU,EAAE,OAAO,CAAA;IACnB,aAAa,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAA;IACxC,YAAY,EAAE,MAAM,IAAI,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACxC;AAID,+EAA+E;AAC/E,iBAAS,iBAAiB,IAAI,eAAe,CAI5C;AAED,MAAM,WAAW,2BAA4B,SAAQ,mBAAmB;IACtE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC3B;AAED;;;;;GAKG;AACH,QAAA,MAAM,sBAAsB,oGAuS3B,CAAA;AAID;;;;GAIG;AACH,iBAAS,yBAAyB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,4BAgB9E;kBAhBQ,yBAAyB;;;AAmBlC,uFAAuF;AACvF,iBAAS,yBAAyB,sBAuBjC;kBAvBQ,yBAAyB;;;AA0BlC;;;GAGG;AACH,iBAAS,8BAA8B,CAAC,EAAE,SAAS,EAAE,QAAgB,EAAE,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,qBAkClH;kBAlCQ,8BAA8B;;;AA2DvC,QAAA,MAAM,cAAc;;;;;CAKlB,CAAA;AAEF,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IACjG,OAAO,EAAE,MAAM,CAAA;IACf,gGAAgG;IAChG,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAAA;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,QAAA,MAAM,cAAc,4FAyDnB,CAAA;AAID,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,yBAAyB,IAAI,qBAAqB,EAClD,yBAAyB,IAAI,qBAAqB,EAClD,8BAA8B,IAAI,0BAA0B,EAC5D,iBAAiB,EACjB,cAAc,GACf,CAAA"}