@iamsaroj/smart-ui 0.2.0

package/dist/lexical-text-editor/plugins/toolbar/use-insert-commands.js

@@ -0,0 +1,29 @@
+"use client";
+import { useEffect } from "react";
+import { $getSelection, $isRangeSelection, COMMAND_PRIORITY_EDITOR, } from "lexical";
+import { $insertNodeToNearestRoot, mergeRegister } from "@lexical/utils";
+import { $createImageNode, INSERT_IMAGE_COMMAND } from "../../nodes/image-node";
+import { $createPageBreakNode, INSERT_PAGE_BREAK_COMMAND, } from "../../nodes/page-break-node";
+/**
+ * Registers the block-level insert commands the {@link InsertMenu} dispatches.
+ * Uses `$insertNodeToNearestRoot` (not `$insertNodes`) so block-level decorators
+ * land at the root — same as the Lexical playground. Co-located with the insert
+ * menu that triggers them.
+ */
+export const useRegisterInsertCommands = (editor) => {
+    useEffect(() => {
+        return mergeRegister(editor.registerCommand(INSERT_IMAGE_COMMAND, ({ src, alt, maxWidth }) => {
+            const node = $createImageNode({ src, alt, maxWidth });
+            $insertNodeToNearestRoot(node);
+            return true;
+        }, COMMAND_PRIORITY_EDITOR), editor.registerCommand(INSERT_PAGE_BREAK_COMMAND, () => {
+            const selection = $getSelection();
+            if (!$isRangeSelection(selection))
+                return false;
+            const node = $createPageBreakNode();
+            $insertNodeToNearestRoot(node);
+            return true;
+        }, COMMAND_PRIORITY_EDITOR));
+    }, [editor]);
+};
+//# sourceMappingURL=use-insert-commands.js.map

package/dist/lexical-text-editor/plugins/toolbar/use-insert-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-insert-commands.js","sourceRoot":"","sources":["../../../../src/lexical-text-editor/plugins/toolbar/use-insert-commands.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACjC,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,uBAAuB,GAExB,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAExE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC/E,OAAO,EACL,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,6BAA6B,CAAA;AAEpC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,MAAqB,EAAE,EAAE;IACjE,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,aAAa,CAClB,MAAM,CAAC,eAAe,CACpB,oBAAoB,EACpB,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE;YACzB,MAAM,IAAI,GAAG,gBAAgB,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAA;YACrD,wBAAwB,CAAC,IAAI,CAAC,CAAA;YAC9B,OAAO,IAAI,CAAA;QACb,CAAC,EACD,uBAAuB,CACxB,EACD,MAAM,CAAC,eAAe,CACpB,yBAAyB,EACzB,GAAG,EAAE;YACH,MAAM,SAAS,GAAG,aAAa,EAAE,CAAA;YACjC,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC;gBAAE,OAAO,KAAK,CAAA;YAC/C,MAAM,IAAI,GAAG,oBAAoB,EAAE,CAAA;YACnC,wBAAwB,CAAC,IAAI,CAAC,CAAA;YAC9B,OAAO,IAAI,CAAA;QACb,CAAC,EACD,uBAAuB,CACxB,CACF,CAAA;IACH,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;AACd,CAAC,CAAA"}

package/dist/lexical-text-editor/plugins/toolbar/use-toolbar-state.d.ts

@@ -0,0 +1,30 @@
+import { type ElementFormatType, type LexicalEditor, type NodeKey } from "lexical";
+import type { BlockType } from "./constants";
+/** Everything the toolbar derives from the current selection / editor state. */
+export interface ToolbarState {
+    canUndo: boolean;
+    canRedo: boolean;
+    blockType: BlockType;
+    selectedElementKey: NodeKey | null;
+    codeLanguage: string;
+    fontSize: string;
+    fontFamily: string;
+    isBold: boolean;
+    isItalic: boolean;
+    isUnderline: boolean;
+    isStrikethrough: boolean;
+    isCode: boolean;
+    isSuperscript: boolean;
+    isSubscript: boolean;
+    isHighlight: boolean;
+    elementFormat: ElementFormatType;
+    isLink: boolean;
+}
+/**
+ * Subscribes to the editor and returns the selection-derived toolbar state.
+ * Reads on every selection change and editor update — the single source that
+ * every toolbar section renders its active/enabled state from. Extracted from
+ * `ToolbarPlugin` so the sections stay presentational.
+ */
+export declare const useToolbarState: (editor: LexicalEditor) => ToolbarState;
+//# sourceMappingURL=use-toolbar-state.d.ts.map

package/dist/lexical-text-editor/plugins/toolbar/use-toolbar-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-toolbar-state.d.ts","sourceRoot":"","sources":["../../../../src/lexical-text-editor/plugins/toolbar/use-toolbar-state.ts"],"names":[],"mappings":"AAGA,OAAO,EAOL,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,OAAO,EAEb,MAAM,SAAS,CAAA;AAYhB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAU5C,gFAAgF;AAChF,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,SAAS,CAAA;IACpB,kBAAkB,EAAE,OAAO,GAAG,IAAI,CAAA;IAClC,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;IACjB,WAAW,EAAE,OAAO,CAAA;IACpB,eAAe,EAAE,OAAO,CAAA;IACxB,MAAM,EAAE,OAAO,CAAA;IACf,aAAa,EAAE,OAAO,CAAA;IACtB,WAAW,EAAE,OAAO,CAAA;IACpB,WAAW,EAAE,OAAO,CAAA;IACpB,aAAa,EAAE,iBAAiB,CAAA;IAChC,MAAM,EAAE,OAAO,CAAA;CAChB;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,aAAa,KAAG,YAoIvD,CAAA"}

package/dist/lexical-text-editor/plugins/toolbar/use-toolbar-state.js

@@ -0,0 +1,128 @@
+"use client";
+import { useCallback, useEffect, useState } from "react";
+import { $getSelection, $isRangeSelection, $isRootOrShadowRoot, CAN_REDO_COMMAND, CAN_UNDO_COMMAND, COMMAND_PRIORITY_CRITICAL, SELECTION_CHANGE_COMMAND, } from "lexical";
+import { $isHeadingNode } from "@lexical/rich-text";
+import { $isListNode, ListNode } from "@lexical/list";
+import { $isLinkNode } from "@lexical/link";
+import { $isCodeNode } from "@lexical/code";
+import { $getSelectionStyleValueForProperty } from "@lexical/selection";
+import { $findMatchingParent, $getNearestNodeOfType, mergeRegister, } from "@lexical/utils";
+/** The anchor/focus node the selection resolves to, or `null` for a non-range. */
+const getSelectedNode = (selection) => {
+    if (!$isRangeSelection(selection))
+        return null;
+    const anchor = selection.anchor.getNode();
+    const focus = selection.focus.getNode();
+    return anchor === focus ? anchor : selection.isBackward() ? focus : anchor;
+};
+/**
+ * Subscribes to the editor and returns the selection-derived toolbar state.
+ * Reads on every selection change and editor update — the single source that
+ * every toolbar section renders its active/enabled state from. Extracted from
+ * `ToolbarPlugin` so the sections stay presentational.
+ */
+export const useToolbarState = (editor) => {
+    const [canUndo, setCanUndo] = useState(false);
+    const [canRedo, setCanRedo] = useState(false);
+    const [blockType, setBlockType] = useState("paragraph");
+    const [selectedElementKey, setSelectedElementKey] = useState(null);
+    const [codeLanguage, setCodeLanguage] = useState("");
+    const [fontSize, setFontSize] = useState("");
+    const [fontFamily, setFontFamily] = useState("");
+    const [isBold, setIsBold] = useState(false);
+    const [isItalic, setIsItalic] = useState(false);
+    const [isUnderline, setIsUnderline] = useState(false);
+    const [isStrikethrough, setIsStrikethrough] = useState(false);
+    const [isCode, setIsCode] = useState(false);
+    const [isSuperscript, setIsSuperscript] = useState(false);
+    const [isSubscript, setIsSubscript] = useState(false);
+    const [isHighlight, setIsHighlight] = useState(false);
+    const [elementFormat, setElementFormat] = useState("left");
+    const [isLink, setIsLink] = useState(false);
+    const $updateToolbar = useCallback(() => {
+        const selection = $getSelection();
+        if (!$isRangeSelection(selection))
+            return;
+        setIsBold(selection.hasFormat("bold"));
+        setIsItalic(selection.hasFormat("italic"));
+        setIsUnderline(selection.hasFormat("underline"));
+        setIsStrikethrough(selection.hasFormat("strikethrough"));
+        setIsCode(selection.hasFormat("code"));
+        setIsSuperscript(selection.hasFormat("superscript"));
+        setIsSubscript(selection.hasFormat("subscript"));
+        setIsHighlight(selection.hasFormat("highlight"));
+        setFontSize($getSelectionStyleValueForProperty(selection, "font-size", ""));
+        setFontFamily($getSelectionStyleValueForProperty(selection, "font-family", ""));
+        const node = getSelectedNode(selection);
+        if (node) {
+            const parent = node.getParent();
+            setIsLink($isLinkNode(parent) || $isLinkNode(node));
+        }
+        const anchorNode = selection.anchor.getNode();
+        let element = anchorNode.getKey() === "root"
+            ? anchorNode
+            : $findMatchingParent(anchorNode, (e) => {
+                const p = e.getParent();
+                return p !== null && $isRootOrShadowRoot(p);
+            });
+        if (element === null)
+            element = anchorNode.getTopLevelElementOrThrow();
+        setSelectedElementKey(element.getKey());
+        if ($isListNode(element)) {
+            const parentList = $getNearestNodeOfType(anchorNode, ListNode);
+            const listType = parentList
+                ? parentList.getListType()
+                : element.getListType();
+            setBlockType(listType === "bullet"
+                ? "bullet"
+                : listType === "check"
+                    ? "check"
+                    : "number");
+        }
+        else if ($isHeadingNode(element)) {
+            setBlockType(element.getTag());
+        }
+        else {
+            setBlockType(element.getType());
+            if ($isCodeNode(element)) {
+                setCodeLanguage(element.getLanguage() || "");
+            }
+        }
+        const anchorParent = selection.anchor.getNode().getParent();
+        setElementFormat(anchorParent?.getFormatType?.() ?? "left");
+    }, []);
+    useEffect(() => {
+        return mergeRegister(editor.registerCommand(SELECTION_CHANGE_COMMAND, () => {
+            $updateToolbar();
+            return false;
+        }, COMMAND_PRIORITY_CRITICAL), editor.registerCommand(CAN_UNDO_COMMAND, (p) => {
+            setCanUndo(p);
+            return false;
+        }, COMMAND_PRIORITY_CRITICAL), editor.registerCommand(CAN_REDO_COMMAND, (p) => {
+            setCanRedo(p);
+            return false;
+        }, COMMAND_PRIORITY_CRITICAL), editor.registerUpdateListener(({ editorState }) => {
+            editorState.read(() => $updateToolbar());
+        }));
+    }, [editor, $updateToolbar]);
+    return {
+        canUndo,
+        canRedo,
+        blockType,
+        selectedElementKey,
+        codeLanguage,
+        fontSize,
+        fontFamily,
+        isBold,
+        isItalic,
+        isUnderline,
+        isStrikethrough,
+        isCode,
+        isSuperscript,
+        isSubscript,
+        isHighlight,
+        elementFormat,
+        isLink,
+    };
+};
+//# sourceMappingURL=use-toolbar-state.js.map

package/dist/lexical-text-editor/plugins/toolbar/use-toolbar-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-toolbar-state.js","sourceRoot":"","sources":["../../../../src/lexical-text-editor/plugins/toolbar/use-toolbar-state.ts"],"names":[],"mappings":"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"}

package/dist/lexical-text-editor/plugins/toolbar-plugin.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The rich-text editor toolbar. A thin composition layer: it reads the
+ * selection-derived state from {@link useToolbarState}, owns the single
+ * open-menu + history-command wiring, and lays out the section components
+ * (`toolbar/*`). Each section owns its own commands and internal state.
+ */
+export declare const ToolbarPlugin: () => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=toolbar-plugin.d.ts.map

package/dist/lexical-text-editor/plugins/toolbar-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbar-plugin.d.ts","sourceRoot":"","sources":["../../../src/lexical-text-editor/plugins/toolbar-plugin.tsx"],"names":[],"mappings":"AA4BA;;;;;GAKG;AACH,eAAO,MAAM,aAAa,+CAuHzB,CAAA"}

package/dist/lexical-text-editor/plugins/toolbar-plugin.js

@@ -0,0 +1,51 @@
+"use client";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useState } from "react";
+import { $getSelection, $isRangeSelection, INDENT_CONTENT_COMMAND, OUTDENT_CONTENT_COMMAND, REDO_COMMAND, UNDO_COMMAND, } from "lexical";
+import { $patchStyleText } from "@lexical/selection";
+import { useLexicalComposerContext } from "@lexical/react/LexicalComposerContext";
+import { Eraser, Indent, Outdent, Redo2, Undo2 } from "lucide-react";
+import { ALL_TEXT_FORMATS } from "./toolbar/constants";
+import { ToolbarButton, ToolbarSeparator } from "./toolbar/primitives";
+import { useToolbarState } from "./toolbar/use-toolbar-state";
+import { useRegisterInsertCommands } from "./toolbar/use-insert-commands";
+import { BlockFormatMenu, CodeLanguageControl, } from "./toolbar/block-format-menu";
+import { InlineMarks } from "./toolbar/inline-marks";
+import { InsertMenu } from "./toolbar/insert-menu";
+import { AlignControls } from "./toolbar/align-menu";
+import { LinkEditor } from "./toolbar/link-editor";
+/**
+ * The rich-text editor toolbar. A thin composition layer: it reads the
+ * selection-derived state from {@link useToolbarState}, owns the single
+ * open-menu + history-command wiring, and lays out the section components
+ * (`toolbar/*`). Each section owns its own commands and internal state.
+ */
+export const ToolbarPlugin = () => {
+    const [editor] = useLexicalComposerContext();
+    const state = useToolbarState(editor);
+    useRegisterInsertCommands(editor);
+    const [openMenu, setOpenMenu] = useState(null);
+    const toggleMenu = useCallback((name) => setOpenMenu((prev) => (prev === name ? null : name)), []);
+    const closeMenu = useCallback(() => setOpenMenu(null), []);
+    const menu = { openMenu, toggleMenu, closeMenu };
+    const clearFormatting = useCallback(() => {
+        editor.update(() => {
+            const selection = $getSelection();
+            if (!$isRangeSelection(selection))
+                return;
+            ALL_TEXT_FORMATS.forEach((fmt) => {
+                if (selection.hasFormat(fmt))
+                    selection.formatText(fmt);
+            });
+            $patchStyleText(selection, {
+                "font-size": null,
+                "font-family": null,
+                color: null,
+                "background-color": null,
+            });
+        });
+    }, [editor]);
+    const isCodeBlock = state.blockType === "code";
+    return (_jsxs("div", { className: "flex flex-wrap items-center gap-0.5 border-b border-border bg-muted/30 px-2 py-1", onMouseDown: (e) => e.preventDefault(), children: [_jsx(ToolbarButton, { title: "Undo (Ctrl+Z)", disabled: !state.canUndo, onClick: () => editor.dispatchCommand(UNDO_COMMAND, undefined), children: _jsx(Undo2, {}) }), _jsx(ToolbarButton, { title: "Redo (Ctrl+Y)", disabled: !state.canRedo, onClick: () => editor.dispatchCommand(REDO_COMMAND, undefined), children: _jsx(Redo2, {}) }), _jsx(ToolbarSeparator, {}), _jsx(BlockFormatMenu, { editor: editor, blockType: state.blockType, menu: menu }), isCodeBlock ? (_jsxs(_Fragment, { children: [_jsx(ToolbarSeparator, {}), _jsx(CodeLanguageControl, { editor: editor, language: state.codeLanguage, elementKey: state.selectedElementKey, menu: menu })] })) : (_jsxs(_Fragment, { children: [_jsx(ToolbarSeparator, {}), _jsx(InlineMarks, { editor: editor, state: state, menu: menu })] })), _jsx(ToolbarSeparator, {}), _jsx(ToolbarButton, { title: "Clear formatting", onClick: clearFormatting, children: _jsx(Eraser, {}) }), _jsx(ToolbarButton, { title: "Outdent", onClick: () => editor.dispatchCommand(OUTDENT_CONTENT_COMMAND, undefined), children: _jsx(Outdent, {}) }), _jsx(ToolbarButton, { title: "Indent", onClick: () => editor.dispatchCommand(INDENT_CONTENT_COMMAND, undefined), children: _jsx(Indent, {}) }), _jsx(ToolbarSeparator, {}), _jsx(InsertMenu, { editor: editor, menu: menu }), _jsx(ToolbarSeparator, {}), _jsx(AlignControls, { editor: editor, elementFormat: state.elementFormat }), _jsx(ToolbarSeparator, {}), _jsx(LinkEditor, { editor: editor, isLink: state.isLink })] }));
+};
+//# sourceMappingURL=toolbar-plugin.js.map

package/dist/lexical-text-editor/plugins/toolbar-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbar-plugin.js","sourceRoot":"","sources":["../../../src/lexical-text-editor/plugins/toolbar-plugin.tsx"],"names":[],"mappings":"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"}

package/dist/lexical-text-editor/sanitize.d.ts

@@ -0,0 +1,24 @@
+import * as React from "react";
+/**
+ * Sanitize an HTML string produced by (or destined for) {@link SmartTextEditor}
+ * in `"html"` mode. Strips scripts, event handlers, and unsafe URLs while
+ * preserving legitimate editor output unchanged.
+ */
+export declare const sanitizeEditorHtml: (html: string) => string;
+/** Props for {@link SafeEditorHtml}. */
+export interface SafeEditorHtmlProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "dangerouslySetInnerHTML"> {
+    /** The stored editor HTML to sanitize and render. */
+    html: string;
+}
+/**
+ * Render stored {@link SmartTextEditor} HTML safely. Sanitizes with
+ * {@link sanitizeEditorHtml} and is the **only** place in the library that uses
+ * `dangerouslySetInnerHTML`. Extra props spread onto the wrapping `<div>`.
+ *
+ * @example
+ * ```tsx
+ * <SafeEditorHtml html={storedHtml} className="prose" />
+ * ```
+ */
+export declare const SafeEditorHtml: ({ html, ...divProps }: SafeEditorHtmlProps) => React.JSX.Element;
+//# sourceMappingURL=sanitize.d.ts.map

package/dist/lexical-text-editor/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/lexical-text-editor/sanitize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAgH9B;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,MASjD,CAAA;AAED,wCAAwC;AACxC,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAC/C,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EACpC,yBAAyB,CAC1B;IACC,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,GAAI,uBAG5B,mBAAmB,KAAG,KAAK,CAAC,GAAG,CAAC,OAMlC,CAAA"}

package/dist/lexical-text-editor/sanitize.js

@@ -0,0 +1,140 @@
+import * as React from "react";
+import DOMPurify from "dompurify";
+/**
+ * HTML sanitization for {@link SmartTextEditor}'s `"html"` format.
+ *
+ * The editor round-trips **raw HTML** — it parses an initial HTML value with
+ * `$generateNodesFromDOM` and emits HTML via `$generateHtmlFromNodes`. Any app
+ * that persists that HTML and later renders it back is exposed to **stored
+ * XSS** unless the HTML is sanitized. This module is the library's answer to
+ * that contract:
+ *
+ * - {@link sanitizeEditorHtml} — a DOMPurify pass with an allow-list scoped to
+ *   exactly what the editor's node set can produce (headings, lists, links,
+ *   images, code blocks, tables, `<hr>`/page-break markup, inline formatting).
+ *   It is applied to **inbound** HTML inside `SmartTextEditor` automatically.
+ * - {@link SafeEditorHtml} — a component for rendering stored editor HTML back
+ *   out. This is the **only** sanctioned `dangerouslySetInnerHTML` site.
+ *
+ * Links are hardened: every `<a>` is forced to `rel="noopener noreferrer
+ * nofollow"` and `target="_blank"`, and `javascript:`/`data:` (non-image) URLs
+ * are dropped by DOMPurify's URI policy.
+ */
+/** Tags the editor's node set can emit. Everything else is stripped. */
+const ALLOWED_TAGS = [
+    // block text
+    "p",
+    "br",
+    "blockquote",
+    "h1",
+    "h2",
+    "h3",
+    "h4",
+    "h5",
+    "h6",
+    // lists (incl. Lexical check lists, which are <li> with classes)
+    "ul",
+    "ol",
+    "li",
+    // links
+    "a",
+    // inline formatting
+    "strong",
+    "b",
+    "em",
+    "i",
+    "u",
+    "s",
+    "sub",
+    "sup",
+    "span",
+    "mark",
+    // code
+    "code",
+    "pre",
+    // media / rules
+    "img",
+    "hr",
+    // tables
+    "table",
+    "thead",
+    "tbody",
+    "tfoot",
+    "tr",
+    "td",
+    "th",
+    "colgroup",
+    "col",
+];
+/**
+ * Attributes the editor emits. `style`/`class` carry Lexical's formatting
+ * (text color, alignment, code-highlight token classes, image `max-width`, the
+ * page-break rule). DOMPurify still sanitizes `style` values (drops `url()`
+ * javascript / expressions) and the URI policy still guards `href`/`src`.
+ */
+const ALLOWED_ATTR = [
+    "href",
+    "target",
+    "rel",
+    "src",
+    "alt",
+    "title",
+    "dir",
+    "class",
+    "style",
+    "colspan",
+    "rowspan",
+    "width",
+    "height",
+    "start",
+    "type",
+    "value",
+    "data-lexical-page-break",
+];
+let hookRegistered = false;
+/** Force link hardening once — DOMPurify hooks are process-global. */
+const ensureLinkHardeningHook = () => {
+    if (hookRegistered)
+        return;
+    hookRegistered = true;
+    DOMPurify.addHook("afterSanitizeAttributes", (node) => {
+        if (node.nodeName === "A" && node instanceof Element) {
+            // Only harden real links; DOMPurify has already dropped unsafe hrefs.
+            node.setAttribute("rel", "noopener noreferrer nofollow");
+            node.setAttribute("target", "_blank");
+        }
+    });
+};
+/**
+ * Sanitize an HTML string produced by (or destined for) {@link SmartTextEditor}
+ * in `"html"` mode. Strips scripts, event handlers, and unsafe URLs while
+ * preserving legitimate editor output unchanged.
+ */
+export const sanitizeEditorHtml = (html) => {
+    ensureLinkHardeningHook();
+    return DOMPurify.sanitize(html, {
+        ALLOWED_TAGS,
+        ALLOWED_ATTR,
+        // `<img>` permits `data:` URIs by DOMPurify's default policy (the editor's
+        // ImageNode can embed them); `javascript:` stays blocked everywhere.
+        ALLOW_DATA_ATTR: false,
+    });
+};
+/**
+ * Render stored {@link SmartTextEditor} HTML safely. Sanitizes with
+ * {@link sanitizeEditorHtml} and is the **only** place in the library that uses
+ * `dangerouslySetInnerHTML`. Extra props spread onto the wrapping `<div>`.
+ *
+ * @example
+ * ```tsx
+ * <SafeEditorHtml html={storedHtml} className="prose" />
+ * ```
+ */
+export const SafeEditorHtml = ({ html, ...divProps }) => {
+    const clean = React.useMemo(() => sanitizeEditorHtml(html), [html]);
+    return React.createElement("div", {
+        ...divProps,
+        dangerouslySetInnerHTML: { __html: clean },
+    });
+};
+//# sourceMappingURL=sanitize.js.map

package/dist/lexical-text-editor/sanitize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../../src/lexical-text-editor/sanitize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,SAAS,MAAM,WAAW,CAAA;AAEjC;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,wEAAwE;AACxE,MAAM,YAAY,GAAG;IACnB,aAAa;IACb,GAAG;IACH,IAAI;IACJ,YAAY;IACZ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,iEAAiE;IACjE,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,QAAQ;IACR,GAAG;IACH,oBAAoB;IACpB,QAAQ;IACR,GAAG;IACH,IAAI;IACJ,GAAG;IACH,GAAG;IACH,GAAG;IACH,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,KAAK;IACL,gBAAgB;IAChB,KAAK;IACL,IAAI;IACJ,SAAS;IACT,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,UAAU;IACV,KAAK;CACN,CAAA;AAED;;;;;GAKG;AACH,MAAM,YAAY,GAAG;IACnB,MAAM;IACN,QAAQ;IACR,KAAK;IACL,KAAK;IACL,KAAK;IACL,OAAO;IACP,KAAK;IACL,OAAO;IACP,OAAO;IACP,SAAS;IACT,SAAS;IACT,OAAO;IACP,QAAQ;IACR,OAAO;IACP,MAAM;IACN,OAAO;IACP,yBAAyB;CAC1B,CAAA;AAED,IAAI,cAAc,GAAG,KAAK,CAAA;AAE1B,sEAAsE;AACtE,MAAM,uBAAuB,GAAG,GAAS,EAAE;IACzC,IAAI,cAAc;QAAE,OAAM;IAC1B,cAAc,GAAG,IAAI,CAAA;IACrB,SAAS,CAAC,OAAO,CAAC,yBAAyB,EAAE,CAAC,IAAI,EAAE,EAAE;QACpD,IAAI,IAAI,CAAC,QAAQ,KAAK,GAAG,IAAI,IAAI,YAAY,OAAO,EAAE,CAAC;YACrD,sEAAsE;YACtE,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,8BAA8B,CAAC,CAAA;YACxD,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;QACvC,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAU,EAAE;IACzD,uBAAuB,EAAE,CAAA;IACzB,OAAO,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE;QAC9B,YAAY;QACZ,YAAY;QACZ,2EAA2E;QAC3E,qEAAqE;QACrE,eAAe,EAAE,KAAK;KACvB,CAAC,CAAA;AACJ,CAAC,CAAA;AAWD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAC7B,IAAI,EACJ,GAAG,QAAQ,EACS,EAAqB,EAAE;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAA;IACnE,OAAO,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE;QAChC,GAAG,QAAQ;QACX,uBAAuB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;KAC3C,CAAC,CAAA;AACJ,CAAC,CAAA"}

package/dist/lib/format.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Small, dependency-free formatting helpers shared across data-display and
+ * dashboard components. Pure functions — straightforward to unit test.
+ */
+/** Format a number with locale-aware grouping (e.g. `1234567` → `"1,234,567"`). */
+export declare const formatNumber: (value: number, options?: Intl.NumberFormatOptions) => string;
+/** Format a number as currency (defaults to USD). */
+export declare const formatCurrency: (value: number, currency?: string, locale?: string) => string;
+/** Compact notation for large numbers (e.g. `12500` → `"12.5K"`). */
+export declare const formatCompact: (value: number) => string;
+/** Format a 0–1 ratio (or arbitrary number) as a percentage string. */
+export declare const formatPercent: (value: number, fractionDigits?: number) => string;
+/** Truncate a string to `maxLength`, appending an ellipsis when shortened. */
+export declare const truncate: (value: string, maxLength: number) => string;
+/** Build initials from a name (e.g. `"Ada Lovelace"` → `"AL"`). */
+export declare const getInitials: (name: string, maxChars?: number) => string;
+//# sourceMappingURL=format.d.ts.map

package/dist/lib/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/lib/format.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mFAAmF;AACnF,eAAO,MAAM,YAAY,GACvB,OAAO,MAAM,EACb,UAAU,IAAI,CAAC,mBAAmB,KACjC,MAAiE,CAAA;AAEpE,qDAAqD;AACrD,eAAO,MAAM,cAAc,GACzB,OAAO,MAAM,EACb,iBAAgB,EAChB,SAAS,MAAM,KACd,MAKe,CAAA;AAElB,qEAAqE;AACrE,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,KAAG,MAI5B,CAAA;AAElB,uEAAuE;AACvE,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,EAAE,uBAAkB,KAAG,MAKhD,CAAA;AAElB,8EAA8E;AAC9E,eAAO,MAAM,QAAQ,GAAI,OAAO,MAAM,EAAE,WAAW,MAAM,KAAG,MAG3D,CAAA;AAED,mEAAmE;AACnE,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,iBAAY,KAAG,MASxD,CAAA"}

package/dist/lib/format.js

@@ -0,0 +1,40 @@
+/**
+ * Small, dependency-free formatting helpers shared across data-display and
+ * dashboard components. Pure functions — straightforward to unit test.
+ */
+/** Format a number with locale-aware grouping (e.g. `1234567` → `"1,234,567"`). */
+export const formatNumber = (value, options) => new Intl.NumberFormat(undefined, options).format(value);
+/** Format a number as currency (defaults to USD). */
+export const formatCurrency = (value, currency = "USD", locale) => new Intl.NumberFormat(locale, {
+    style: "currency",
+    currency,
+    maximumFractionDigits: 2,
+}).format(value);
+/** Compact notation for large numbers (e.g. `12500` → `"12.5K"`). */
+export const formatCompact = (value) => new Intl.NumberFormat(undefined, {
+    notation: "compact",
+    maximumFractionDigits: 1,
+}).format(value);
+/** Format a 0–1 ratio (or arbitrary number) as a percentage string. */
+export const formatPercent = (value, fractionDigits = 1) => new Intl.NumberFormat(undefined, {
+    style: "percent",
+    minimumFractionDigits: fractionDigits,
+    maximumFractionDigits: fractionDigits,
+}).format(value);
+/** Truncate a string to `maxLength`, appending an ellipsis when shortened. */
+export const truncate = (value, maxLength) => {
+    if (value.length <= maxLength)
+        return value;
+    return `${value.slice(0, Math.max(0, maxLength - 1)).trimEnd()}…`;
+};
+/** Build initials from a name (e.g. `"Ada Lovelace"` → `"AL"`). */
+export const getInitials = (name, maxChars = 2) => {
+    const parts = name.trim().split(/\s+/).filter(Boolean);
+    if (parts.length === 0)
+        return "";
+    return parts
+        .slice(0, maxChars)
+        .map((part) => part.charAt(0).toUpperCase())
+        .join("");
+};
+//# sourceMappingURL=format.js.map

package/dist/lib/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/lib/format.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mFAAmF;AACnF,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,KAAa,EACb,OAAkC,EAC1B,EAAE,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAEpE,qDAAqD;AACrD,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,KAAa,EACb,QAAQ,GAAG,KAAK,EAChB,MAAe,EACP,EAAE,CACV,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE;IAC5B,KAAK,EAAE,UAAU;IACjB,QAAQ;IACR,qBAAqB,EAAE,CAAC;CACzB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAElB,qEAAqE;AACrE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAa,EAAU,EAAE,CACrD,IAAI,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE;IAC/B,QAAQ,EAAE,SAAS;IACnB,qBAAqB,EAAE,CAAC;CACzB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAElB,uEAAuE;AACvE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAa,EAAE,cAAc,GAAG,CAAC,EAAU,EAAE,CACzE,IAAI,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE;IAC/B,KAAK,EAAE,SAAS;IAChB,qBAAqB,EAAE,cAAc;IACrC,qBAAqB,EAAE,cAAc;CACtC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAElB,8EAA8E;AAC9E,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,SAAiB,EAAU,EAAE;IACnE,IAAI,KAAK,CAAC,MAAM,IAAI,SAAS;QAAE,OAAO,KAAK,CAAA;IAC3C,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAA;AACnE,CAAC,CAAA;AAED,mEAAmE;AACnE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,QAAQ,GAAG,CAAC,EAAU,EAAE;IAChE,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAEtD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAEjC,OAAO,KAAK;SACT,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC;SAClB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC3C,IAAI,CAAC,EAAE,CAAC,CAAA;AACb,CAAC,CAAA"}

package/dist/lib/leading-space.d.ts

@@ -0,0 +1,28 @@
+import type * as React from "react";
+/**
+ * Guard that keeps input-like controls from *starting* with whitespace: the
+ * Space key is ignored while the caret sits at the very start of the value
+ * (a held, auto-repeating space bar stays blocked because the caret never
+ * moves), and leading whitespace that arrives another way — paste, drop,
+ * autofill — is stripped before `onChange` sees it. Once a real first
+ * character exists, spaces behave normally.
+ */
+type TextControl = HTMLInputElement | HTMLTextAreaElement;
+export interface LeadingSpaceGuardHandlers<T extends TextControl> {
+    onKeyDown?: React.KeyboardEventHandler<T>;
+    onChange?: React.ChangeEventHandler<T>;
+}
+/** Removes the leading whitespace a guarded value may not begin with. */
+export declare const stripLeadingSpaces: (value: string) => string;
+/**
+ * Wraps a control's `onKeyDown`/`onChange` with the leading-space guard.
+ * Pass `allowLeadingSpace: true` to opt out — the handlers are returned
+ * untouched.
+ *
+ * Note: input types without selection support (`email`, `number`) report the
+ * caret as `null`, which the guard treats as position 0 — every space is
+ * blocked there, matching what those types accept anyway.
+ */
+export declare function withLeadingSpaceGuard<T extends TextControl>({ onKeyDown, onChange }: LeadingSpaceGuardHandlers<T>, allowLeadingSpace?: boolean): LeadingSpaceGuardHandlers<T>;
+export {};
+//# sourceMappingURL=leading-space.d.ts.map

package/dist/lib/leading-space.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leading-space.d.ts","sourceRoot":"","sources":["../../src/lib/leading-space.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAA;AAEnC;;;;;;;GAOG;AAEH,KAAK,WAAW,GAAG,gBAAgB,GAAG,mBAAmB,CAAA;AAEzD,MAAM,WAAW,yBAAyB,CAAC,CAAC,SAAS,WAAW;IAC9D,SAAS,CAAC,EAAE,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAA;IACzC,QAAQ,CAAC,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAA;CACvC;AAED,yEAAyE;AACzE,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,WAA8B,CAAA;AAE9E;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,WAAW,EACzD,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,yBAAyB,CAAC,CAAC,CAAC,EACrD,iBAAiB,CAAC,EAAE,OAAO,GAC1B,yBAAyB,CAAC,CAAC,CAAC,CAoB9B"}

package/dist/lib/leading-space.js

@@ -0,0 +1,34 @@
+/** Removes the leading whitespace a guarded value may not begin with. */
+export const stripLeadingSpaces = (value) => value.replace(/^\s+/, "");
+/**
+ * Wraps a control's `onKeyDown`/`onChange` with the leading-space guard.
+ * Pass `allowLeadingSpace: true` to opt out — the handlers are returned
+ * untouched.
+ *
+ * Note: input types without selection support (`email`, `number`) report the
+ * caret as `null`, which the guard treats as position 0 — every space is
+ * blocked there, matching what those types accept anyway.
+ */
+export function withLeadingSpaceGuard({ onKeyDown, onChange }, allowLeadingSpace) {
+    if (allowLeadingSpace)
+        return { onKeyDown, onChange };
+    return {
+        onKeyDown: (e) => {
+            // Block only when the space would become the first character: the caret
+            // (or the start of a selection about to be replaced) is at position 0.
+            if (e.key === " " && (e.currentTarget.selectionStart ?? 0) === 0) {
+                e.preventDefault();
+                return;
+            }
+            onKeyDown?.(e);
+        },
+        onChange: (e) => {
+            const value = e.currentTarget.value;
+            const stripped = stripLeadingSpaces(value);
+            if (stripped !== value)
+                e.currentTarget.value = stripped;
+            onChange?.(e);
+        },
+    };
+}
+//# sourceMappingURL=leading-space.js.map

package/dist/lib/leading-space.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leading-space.js","sourceRoot":"","sources":["../../src/lib/leading-space.ts"],"names":[],"mappings":"AAkBA,yEAAyE;AACzE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AAE9E;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CACnC,EAAE,SAAS,EAAE,QAAQ,EAAgC,EACrD,iBAA2B;IAE3B,IAAI,iBAAiB;QAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAA;IAErD,OAAO;QACL,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE;YACf,wEAAwE;YACxE,uEAAuE;YACvE,IAAI,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,cAAc,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjE,CAAC,CAAC,cAAc,EAAE,CAAA;gBAClB,OAAM;YACR,CAAC;YACD,SAAS,EAAE,CAAC,CAAC,CAAC,CAAA;QAChB,CAAC;QACD,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE;YACd,MAAM,KAAK,GAAG,CAAC,CAAC,aAAa,CAAC,KAAK,CAAA;YACnC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAA;YAC1C,IAAI,QAAQ,KAAK,KAAK;gBAAE,CAAC,CAAC,aAAa,CAAC,KAAK,GAAG,QAAQ,CAAA;YACxD,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAA;QACf,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/lib/utils.d.ts

@@ -0,0 +1,3 @@
+import { type ClassValue } from "clsx";
+export declare const cn: (...inputs: ClassValue[]) => string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/lib/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,MAAM,CAAA;AAG5C,eAAO,MAAM,EAAE,GAAI,GAAG,QAAQ,UAAU,EAAE,WAA0B,CAAA"}

package/dist/lib/utils.js

@@ -0,0 +1,4 @@
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+export const cn = (...inputs) => twMerge(clsx(inputs));
+//# sourceMappingURL=utils.js.map

package/dist/lib/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAmB,MAAM,MAAM,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAExC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAoB,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA"}