@spatika/editor 1.5.0 → 1.6.0

package/dist/composites/AiCommandDock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AiCommandDock.d.ts","sourceRoot":"","sources":["../../src/composites/AiCommandDock.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAgB3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAI5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAoB3D,KAAK,kBAAkB,GAAG;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC/B,KAAK,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,kBAAkB,sCAwF9F"}
+{"version":3,"file":"AiCommandDock.d.ts","sourceRoot":"","sources":["../../src/composites/AiCommandDock.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAgB3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAI5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAoB3D,KAAK,kBAAkB,GAAG;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC/B,KAAK,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,kBAAkB,sCA2F9F"}

package/dist/composites/AiCommandDock.js

@@ -55,8 +55,10 @@ export function AiCommandDock({ editor, config, actions, onRun, className }) {
     if (!editor)
         return null;
     return (_jsxs("div", { ref: rootRef, className: cn("spk-editor-ai-dock", className), children: [open ? (_jsx(AiCommandPanel, { id: panelId, title: title, actions: commandActions, hasSelection: hasSelection, onSelect: (actionId) => runAction(actionId), className: "spk-editor-ai-dock-panel" })) : null, promptConfig.enabled ? (_jsxs("div", { className: "spk-editor-ai-dock-bar", role: "search", children: [_jsx("button", { type: "button", className: cn("spk-editor-ai-dock-trigger", open && "spk-editor-ai-dock-trigger--active"), "aria-label": "AI commands", "aria-expanded": open, "aria-controls": open ? panelId : undefined, onClick: () => setOpen((value) => !value), children: _jsx(Sparkles, { className: "size-4" }) }), _jsxs("label", { className: "spk-editor-ai-dock-field", children: [_jsx("span", { className: "sr-only", children: promptConfig.placeholder }), _jsx("input", { type: "text", className: "spk-editor-ai-dock-input", value: prompt, placeholder: promptConfig.placeholder, onFocus: () => setOpen(true), onChange: (event) => setPrompt(event.target.value), onKeyDown: (event) => {
-                                    if (event.key === "Enter")
+                                    if (event.key === "Enter") {
+                                        event.preventDefault();
                                         submitPrompt();
+                                    }
                                     if (event.key === "Escape")
                                         setOpen(false);
                                 } })] }), _jsx("button", { type: "button", className: "spk-editor-ai-dock-submit", "aria-label": promptConfig.submitLabel, disabled: !prompt.trim(), onClick: submitPrompt, children: _jsx(ArrowUp, { className: "size-4" }) })] })) : null] }));

package/dist/composites/SpatikaEditor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SpatikaEditor.d.ts","sourceRoot":"","sources":["../../src/composites/SpatikaEditor.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,mBAAmB,EAAsB,MAAM,cAAc,CAAC;AAmB5E,eAAO,MAAM,aAAa;;;;;;;;;;;uDA2QzB,CAAC"}
+{"version":3,"file":"SpatikaEditor.d.ts","sourceRoot":"","sources":["../../src/composites/SpatikaEditor.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,mBAAmB,EAAsB,MAAM,cAAc,CAAC;AAmB5E,eAAO,MAAM,aAAa;;;;;;;;;;;uDA+QzB,CAAC"}

package/dist/composites/SpatikaEditor.js

@@ -43,6 +43,11 @@ export const SpatikaEditor = forwardRef(function SpatikaEditor({ value, onChange
         getHTML: () => editor?.getHTML() ?? "",
         getJSON: () => editor?.getJSON(),
         expandFullscreen: () => setFullscreen(true),
+        insertImage: (url) => {
+            if (!url.trim() || !editor)
+                return;
+            editor.chain().focus().setImage({ src: url }).run();
+        },
     }), [editor]);
     const toolbarConfig = { ...DEFAULT_TOOLBAR, ...toolbar };
     const allSlashCommands = useMemo(() => [...defaultSlashCommands(), ...(slashCommands ?? [])], [slashCommands]);

package/dist/composites/TableGridPicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TableGridPicker.d.ts","sourceRoot":"","sources":["../../src/composites/TableGridPicker.tsx"],"names":[],"mappings":"AAIA,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,KAAK,oBAAoB,GAAG;IAC1B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,KAAK,IAAI,CAAC;CACxE,CAAC;AAeF,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,EAAE,oBAAoB,+BAgHjE"}
+{"version":3,"file":"TableGridPicker.d.ts","sourceRoot":"","sources":["../../src/composites/TableGridPicker.tsx"],"names":[],"mappings":"AAIA,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,KAAK,oBAAoB,GAAG;IAC1B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,KAAK,IAAI,CAAC;CACxE,CAAC;AAeF,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,EAAE,oBAAoB,+BAsHjE"}

package/dist/composites/TableGridPicker.js

@@ -47,8 +47,14 @@ export function TableGridPicker({ onInsert }) {
                 }) }), _jsxs("div", { className: "spk-editor-table-picker-size", children: [_jsxs("label", { className: "spk-editor-table-picker-size-field", children: [_jsx(Columns3, { className: "size-4", "aria-hidden": "true" }), _jsx("span", { className: "sr-only", children: "Columns" }), _jsx("input", { type: "number", min: 1, max: TABLE_COLS_MAX, className: "spk-editor-table-picker-size-input", value: previewCols, onChange: (event) => {
                                     setHover(null);
                                     setCols(clampDimension(Number.parseInt(event.target.value, 10) || 1, TABLE_COLS_MAX));
+                                }, onKeyDown: (event) => {
+                                    if (event.key === "Enter")
+                                        event.preventDefault();
                                 } })] }), _jsx("span", { className: "spk-editor-table-picker-size-sep", "aria-hidden": "true", children: "\u00D7" }), _jsxs("label", { className: "spk-editor-table-picker-size-field", children: [_jsx(Rows3, { className: "size-4", "aria-hidden": "true" }), _jsx("span", { className: "sr-only", children: "Rows" }), _jsx("input", { type: "number", min: 1, max: TABLE_ROWS_MAX, className: "spk-editor-table-picker-size-input", value: previewRows, onChange: (event) => {
                                     setHover(null);
                                     setRows(clampDimension(Number.parseInt(event.target.value, 10) || 1, TABLE_ROWS_MAX));
+                                }, onKeyDown: (event) => {
+                                    if (event.key === "Enter")
+                                        event.preventDefault();
                                 } })] })] }), _jsxs("label", { className: "spk-editor-toolbar-popover-check", children: [_jsx("input", { type: "checkbox", checked: withHeaderRow, onChange: (event) => setWithHeaderRow(event.target.checked) }), _jsx("span", { children: "Header row" })] }), _jsxs("button", { type: "button", className: "spk-editor-toolbar-popover-btn spk-editor-toolbar-popover-btn--primary spk-editor-table-picker-insert", onClick: () => onInsert(previewRows, previewCols, withHeaderRow), children: ["Insert ", previewCols, " \u00D7 ", previewRows, " table"] })] }));
 }

package/dist/composites/ToolbarInsertPanels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ToolbarInsertPanels.d.ts","sourceRoot":"","sources":["../../src/composites/ToolbarInsertPanels.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAKtD,KAAK,UAAU,GAAG;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF,KAAK,eAAe,GAAG,UAAU,GAAG;IAClC,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B,CAAC;AAEF,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,UAAU,+BAmD5D;AAMD,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,eAAe,+BA4G1E;AAED,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,UAAU,+BAe7D"}
+{"version":3,"file":"ToolbarInsertPanels.d.ts","sourceRoot":"","sources":["../../src/composites/ToolbarInsertPanels.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAKtD,KAAK,UAAU,GAAG;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF,KAAK,eAAe,GAAG,UAAU,GAAG;IAClC,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B,CAAC;AAQF,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,UAAU,+BAoD5D;AAUD,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,eAAe,+BAuK1E;AAED,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,UAAU,+BAe7D"}

package/dist/composites/ToolbarInsertPanels.js

@@ -1,9 +1,14 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { ImagePlus, Upload } from "lucide-react";
-import { useRef, useState } from "react";
+import { ImagePlus, Images, Upload } from "lucide-react";
+import { useEffect, useRef, useState } from "react";
 import { cn } from "../lib/cn";
 import { insertImageFilesIntoEditor } from "../lib/insert-editor-images";
 import { TableGridPicker } from "./TableGridPicker";
+function preventFormSubmitOnEnter(event) {
+    if (event.key === "Enter") {
+        event.preventDefault();
+    }
+}
 export function LinkInsertPanel({ editor, close }) {
     const previous = editor.getAttributes("link").href;
     const [url, setUrl] = useState(previous ?? "https://");
@@ -22,6 +27,7 @@ export function LinkInsertPanel({ editor, close }) {
         close();
     };
     return (_jsxs("div", { className: "spk-editor-toolbar-popover-form", children: [_jsxs("label", { className: "spk-editor-toolbar-popover-field", children: [_jsx("span", { children: "URL" }), _jsx("input", { type: "url", className: "spk-editor-toolbar-popover-input", value: url, placeholder: "https://", onChange: (event) => setUrl(event.target.value), onKeyDown: (event) => {
+                            preventFormSubmitOnEnter(event);
                             if (event.key === "Enter")
                                 apply();
                             if (event.key === "Escape")
@@ -31,6 +37,9 @@ export function LinkInsertPanel({ editor, close }) {
 function insertImageSrc(editor, src) {
     editor.chain().focus().setImage({ src }).run();
 }
+function resolveGalleryPhotoSrc(photo) {
+    return photo.thumbnailUrl?.trim() || photo.url;
+}
 export function ImageInsertPanel({ editor, close, config }) {
     const inputRef = useRef(null);
     const [url, setUrl] = useState("");
@@ -40,6 +49,11 @@ export function ImageInsertPanel({ editor, close, config }) {
     const maxSizeBytes = config?.maxSizeBytes ?? 5 * 1024 * 1024;
     const accept = config?.accept ?? "image/*";
     const limitMb = Math.round(maxSizeBytes / (1024 * 1024));
+    const galleryPhotos = config?.galleryPhotos ?? [];
+    const galleryEnabled = Boolean(config?.onGalleryOpen || galleryPhotos.length > 0);
+    useEffect(() => {
+        config?.onGalleryPrefetch?.();
+    }, [config]);
     const handleFiles = async (files) => {
         setError(null);
         const inserted = await insertImageFilesIntoEditor(editor, files, config);
@@ -56,7 +70,25 @@ export function ImageInsertPanel({ editor, close, config }) {
         insertImageSrc(editor, trimmed);
         close();
     };
-    return (_jsxs("div", { className: "spk-editor-toolbar-popover-form spk-editor-image-insert", children: [_jsxs("button", { type: "button", className: cn("spk-editor-image-dropzone", dragging && "spk-editor-image-dropzone--active"), onClick: () => inputRef.current?.click(), onDragEnter: (event) => {
+    const insertGalleryPhoto = (photoUrl) => {
+        if (!photoUrl.trim())
+            return;
+        insertImageSrc(editor, photoUrl);
+        close();
+    };
+    const openHostGallery = () => {
+        config?.onGalleryOpen?.();
+        close();
+    };
+    return (_jsxs("div", { className: "spk-editor-toolbar-popover-form spk-editor-image-insert", children: [galleryEnabled ? (_jsxs("div", { className: "spk-editor-image-gallery", children: [galleryPhotos.length > 0 ? (_jsx("div", { className: "spk-editor-image-gallery-grid", children: galleryPhotos.slice(0, 12).map((photo) => (_jsx("button", { type: "button", className: "spk-editor-image-gallery-item", onClick: (event) => {
+                                event.preventDefault();
+                                event.stopPropagation();
+                                insertGalleryPhoto(photo.url);
+                            }, children: _jsx("img", { src: resolveGalleryPhotoSrc(photo), alt: photo.alt ?? "Gallery photo" }) }, photo.id))) })) : (_jsx("p", { className: "spk-editor-image-gallery-empty", children: config?.galleryEmptyMessage ?? "No gallery photos available yet." })), config?.onGalleryOpen ? (_jsxs("button", { type: "button", className: "spk-editor-image-gallery-open", onClick: (event) => {
+                            event.preventDefault();
+                            event.stopPropagation();
+                            openHostGallery();
+                        }, children: [_jsx(Images, { className: "size-4", "aria-hidden": "true" }), config.galleryOpenLabel ?? "Open gallery"] })) : null] })) : null, galleryEnabled ? (_jsx("div", { className: "spk-editor-image-insert-divider", children: _jsx("span", { children: "or upload" }) })) : null, _jsxs("button", { type: "button", className: cn("spk-editor-image-dropzone", dragging && "spk-editor-image-dropzone--active"), onClick: () => inputRef.current?.click(), onDragEnter: (event) => {
                     event.preventDefault();
                     setDragging(true);
                 }, onDragOver: (event) => {
@@ -73,6 +105,7 @@ export function ImageInsertPanel({ editor, close, config }) {
                         void handleFiles(event.target.files);
                     }
                 } }), error ? _jsx("p", { className: "spk-editor-image-insert-error", children: error }) : null, _jsx("div", { className: "spk-editor-image-insert-divider", children: _jsx("span", { children: "or paste a URL" }) }), _jsxs("label", { className: "spk-editor-toolbar-popover-field", children: [_jsx("span", { children: "Image URL" }), _jsx("input", { type: "url", className: "spk-editor-toolbar-popover-input", value: url, placeholder: "https://example.com/photo.jpg", onChange: (event) => setUrl(event.target.value), onKeyDown: (event) => {
+                            preventFormSubmitOnEnter(event);
                             if (event.key === "Enter")
                                 insertFromUrl();
                             if (event.key === "Escape")

package/dist/index.d.ts

@@ -16,7 +16,7 @@ export { createSlashCommandExtension, defaultSlashCommands } from "./extensions/
 export { createMentionExtension } from "./extensions/mention";
 export { ResizableImage } from "./extensions/resizable-image";
 export { createAiActionExtension } from "./extensions/ai-action";
-export type { SpatikaEditorProps, SpatikaEditorHandle, SpatikaEditorToolbarConfig, SlashCommandItem, MentionContact, AiActionDefinition, AiCommandContext, AiCommandMenuConfig, AiCommandPromptConfig, ImageInsertConfig, PlaceholderConfig, UseSpatikaEditorOptions, } from "./lib/types";
+export type { SpatikaEditorProps, SpatikaEditorHandle, SpatikaEditorToolbarConfig, SlashCommandItem, MentionContact, AiActionDefinition, AiCommandContext, AiCommandMenuConfig, AiCommandPromptConfig, ImageInsertConfig, ImageInsertGalleryPhoto, PlaceholderConfig, UseSpatikaEditorOptions, } from "./lib/types";
 export { AI_PROMPT_ACTION_ID } from "./lib/types";
 export type { SlashCommandStorage } from "./extensions/slash-command";
 export type { MentionStorage } from "./extensions/mention";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEpF,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,yBAAyB,EACzB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAC/F,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,0BAA0B,EAC1B,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEpF,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,yBAAyB,EACzB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAC/F,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,0BAA0B,EAC1B,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/lib/types.d.ts

@@ -19,6 +19,12 @@ export type SpatikaEditorToolbarConfig = {
     /** Toolbar layout. Default "ribbon". */
     layout?: "ribbon" | "compact";
 };
+export type ImageInsertGalleryPhoto = {
+    id: string | number;
+    url: string;
+    thumbnailUrl?: string;
+    alt?: string;
+};
 export type ImageInsertConfig = {
     /** Maximum files per drop or picker action. Default 3. */
     maxFiles?: number;
@@ -28,6 +34,16 @@ export type ImageInsertConfig = {
     accept?: string;
     /** Host-owned upload handler. Defaults to inline base64 data URLs. */
     onUpload?: (file: File) => Promise<string>;
+    /** Optional quick-pick gallery shown above upload/URL controls. */
+    galleryPhotos?: ImageInsertGalleryPhoto[];
+    /** Called when the insert-image panel opens (e.g. prefetch gallery assets). */
+    onGalleryPrefetch?: () => void;
+    /** Opens a host gallery picker (full library). */
+    onGalleryOpen?: () => void;
+    /** Empty-state copy when `galleryPhotos` is empty but gallery is enabled. */
+    galleryEmptyMessage?: string;
+    /** Label for the host gallery action button. Default "Open gallery". */
+    galleryOpenLabel?: string;
 };
 export type SlashCommandItem = {
     id: string;
@@ -89,6 +105,7 @@ export type SpatikaEditorHandle = {
     getHTML: () => string;
     getJSON: () => unknown;
     expandFullscreen: () => void;
+    insertImage: (url: string) => void;
 };
 export type PlaceholderConfig = string | ((node: {
     type: string;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"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"}

package/dist/styles.css

@@ -721,6 +721,70 @@
   min-width: 16rem;
 }
 
+.spk-editor-image-gallery {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+
+.spk-editor-image-gallery-grid {
+  display: grid;
+  grid-template-columns: repeat(4, minmax(0, 1fr));
+  gap: 0.4rem;
+}
+
+.spk-editor-image-gallery-item {
+  position: relative;
+  aspect-ratio: 1;
+  overflow: hidden;
+  border: 2px solid transparent;
+  border-radius: 0.65rem;
+  background: color-mix(in oklab, var(--muted) 40%, transparent);
+  padding: 0;
+  cursor: pointer;
+}
+
+.spk-editor-image-gallery-item:hover {
+  border-color: color-mix(in oklab, var(--primary) 55%, transparent);
+}
+
+.spk-editor-image-gallery-item img {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+  display: block;
+}
+
+.spk-editor-image-gallery-empty {
+  margin: 0;
+  padding: 0.5rem 0.25rem;
+  font-size: 0.75rem;
+  line-height: 1.4;
+  color: var(--muted-foreground);
+  text-align: center;
+}
+
+.spk-editor-image-gallery-open {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.4rem;
+  width: 100%;
+  min-height: 2rem;
+  border: 1px solid color-mix(in oklab, var(--border) 80%, transparent);
+  border-radius: 0.65rem;
+  background: color-mix(in oklab, var(--muted) 24%, transparent);
+  color: var(--foreground);
+  font-size: 0.8125rem;
+  font-weight: 600;
+  cursor: pointer;
+}
+
+.spk-editor-image-gallery-open:hover {
+  border-color: color-mix(in oklab, var(--primary) 35%, var(--border));
+  background: color-mix(in oklab, var(--primary) 8%, transparent);
+}
+
 .spk-editor-image-dropzone {
   display: flex;
   flex-direction: column;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spatika/editor",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "license": "MIT",
   "description": "Spatika UI — Tiptap-powered rich text editor with glass theming, AI hooks, and extensible toolbar",
   "homepage": "https://spatika.sweyam.com",
@@ -58,7 +58,7 @@
     "react-dom": "^18.2.0 || ^19.0.0"
   },
   "dependencies": {
-    "@spatika/tokens": "1.5.0",
+    "@spatika/tokens": "1.6.0",
     "@tiptap/core": "^3.28.0",
     "@tiptap/extension-bubble-menu": "^3.28.0",
     "@tiptap/extension-color": "^3.30.5",

package/src/composites/AiCommandDock.tsx

@@ -115,10 +115,13 @@ export function AiCommandDock({ editor, config, actions, onRun, className }: AiC
               placeholder={promptConfig.placeholder}
               onFocus={() => setOpen(true)}
               onChange={(event) => setPrompt(event.target.value)}
-              onKeyDown={(event) => {
-                if (event.key === "Enter") submitPrompt();
-                if (event.key === "Escape") setOpen(false);
-              }}
+            onKeyDown={(event) => {
+              if (event.key === "Enter") {
+                event.preventDefault();
+                submitPrompt();
+              }
+              if (event.key === "Escape") setOpen(false);
+            }}
             />
           </label>
           <button

package/src/composites/SpatikaEditor.tsx

@@ -90,6 +90,10 @@ export const SpatikaEditor = forwardRef<SpatikaEditorHandle, SpatikaEditorProps>
         getHTML: () => editor?.getHTML() ?? "",
         getJSON: () => editor?.getJSON(),
         expandFullscreen: () => setFullscreen(true),
+        insertImage: (url: string) => {
+          if (!url.trim() || !editor) return;
+          editor.chain().focus().setImage({ src: url }).run();
+        },
       }),
       [editor],
     );

package/src/composites/TableGridPicker.tsx

@@ -97,6 +97,9 @@ export function TableGridPicker({ onInsert }: TableGridPickerProps) {
               setHover(null);
               setCols(clampDimension(Number.parseInt(event.target.value, 10) || 1, TABLE_COLS_MAX));
             }}
+            onKeyDown={(event) => {
+              if (event.key === "Enter") event.preventDefault();
+            }}
           />
         </label>
         <span className="spk-editor-table-picker-size-sep" aria-hidden="true">
@@ -115,6 +118,9 @@ export function TableGridPicker({ onInsert }: TableGridPickerProps) {
               setHover(null);
               setRows(clampDimension(Number.parseInt(event.target.value, 10) || 1, TABLE_ROWS_MAX));
             }}
+            onKeyDown={(event) => {
+              if (event.key === "Enter") event.preventDefault();
+            }}
           />
         </label>
       </div>

package/src/composites/ToolbarInsertPanels.test.tsx

@@ -57,4 +57,84 @@ describe("ToolbarInsertPanels", () => {
     });
     expect(close).toHaveBeenCalled();
   });
+
+  it("inserts a gallery photo from the quick-pick grid", async () => {
+    const editor = createEditor();
+    const close = vi.fn();
+    const onGalleryPrefetch = vi.fn();
+
+    render(
+      <ImageInsertPanel
+        editor={editor}
+        close={close}
+        config={{
+          galleryPhotos: [{ id: 1, url: "https://example.com/gallery.png", alt: "Gallery photo" }],
+          onGalleryPrefetch,
+          galleryOpenLabel: "Open full gallery",
+        }}
+      />,
+    );
+
+    expect(onGalleryPrefetch).toHaveBeenCalled();
+    await userEvent.click(screen.getByRole("button", { name: "Gallery photo" }));
+    expect(editor.chain).toHaveBeenCalled();
+    expect(close).toHaveBeenCalled();
+  });
+
+  it("opens the host gallery action from the insert panel", async () => {
+    const editor = createEditor();
+    const close = vi.fn();
+    const onGalleryOpen = vi.fn();
+
+    render(
+      <ImageInsertPanel
+        editor={editor}
+        close={close}
+        config={{ onGalleryOpen, galleryOpenLabel: "Open full gallery" }}
+      />,
+    );
+
+    await userEvent.click(screen.getByRole("button", { name: "Open full gallery" }));
+    expect(onGalleryOpen).toHaveBeenCalled();
+    expect(close).toHaveBeenCalled();
+  });
+
+  it("does not submit surrounding forms when pressing Enter in the URL field", async () => {
+    const editor = createEditor();
+    const close = vi.fn();
+    const onSubmit = vi.fn((event: SubmitEvent) => event.preventDefault());
+
+    render(
+      <form onSubmit={onSubmit}>
+        <ImageInsertPanel editor={editor} close={close} />
+      </form>,
+    );
+
+    const input = screen.getByLabelText("Image URL");
+    await userEvent.type(input, "https://example.com/a.png{enter}");
+    expect(onSubmit).not.toHaveBeenCalled();
+    expect(editor.chain).toHaveBeenCalled();
+  });
+
+  it("does not submit surrounding forms when clicking a gallery photo", async () => {
+    const editor = createEditor();
+    const close = vi.fn();
+    const onSubmit = vi.fn((event: SubmitEvent) => event.preventDefault());
+
+    render(
+      <form onSubmit={onSubmit}>
+        <ImageInsertPanel
+          editor={editor}
+          close={close}
+          config={{
+            galleryPhotos: [{ id: 1, url: "https://example.com/gallery.png", alt: "Gallery photo" }],
+          }}
+        />
+      </form>,
+    );
+
+    await userEvent.click(screen.getByRole("button", { name: "Gallery photo" }));
+    expect(onSubmit).not.toHaveBeenCalled();
+    expect(editor.chain).toHaveBeenCalled();
+  });
 });

package/src/composites/ToolbarInsertPanels.tsx

@@ -1,6 +1,6 @@
 import type { Editor } from "@tiptap/core";
-import { ImagePlus, Upload } from "lucide-react";
-import { useRef, useState } from "react";
+import { ImagePlus, Images, Upload } from "lucide-react";
+import { useEffect, useRef, useState } from "react";
 import type { ImageInsertConfig } from "../lib/types";
 import { cn } from "../lib/cn";
 import { insertImageFilesIntoEditor } from "../lib/insert-editor-images";
@@ -15,6 +15,12 @@ type ImagePanelProps = PanelProps & {
   config?: ImageInsertConfig;
 };
 
+function preventFormSubmitOnEnter(event: React.KeyboardEvent) {
+  if (event.key === "Enter") {
+    event.preventDefault();
+  }
+}
+
 export function LinkInsertPanel({ editor, close }: PanelProps) {
   const previous = editor.getAttributes("link").href as string | undefined;
   const [url, setUrl] = useState(previous ?? "https://");
@@ -45,6 +51,7 @@ export function LinkInsertPanel({ editor, close }: PanelProps) {
           placeholder="https://"
           onChange={(event) => setUrl(event.target.value)}
           onKeyDown={(event) => {
+            preventFormSubmitOnEnter(event);
             if (event.key === "Enter") apply();
             if (event.key === "Escape") close();
           }}
@@ -72,6 +79,10 @@ function insertImageSrc(editor: Editor, src: string) {
   editor.chain().focus().setImage({ src }).run();
 }
 
+function resolveGalleryPhotoSrc(photo: NonNullable<ImageInsertConfig["galleryPhotos"]>[number]) {
+  return photo.thumbnailUrl?.trim() || photo.url;
+}
+
 export function ImageInsertPanel({ editor, close, config }: ImagePanelProps) {
   const inputRef = useRef<HTMLInputElement>(null);
   const [url, setUrl] = useState("");
@@ -82,6 +93,12 @@ export function ImageInsertPanel({ editor, close, config }: ImagePanelProps) {
   const maxSizeBytes = config?.maxSizeBytes ?? 5 * 1024 * 1024;
   const accept = config?.accept ?? "image/*";
   const limitMb = Math.round(maxSizeBytes / (1024 * 1024));
+  const galleryPhotos = config?.galleryPhotos ?? [];
+  const galleryEnabled = Boolean(config?.onGalleryOpen || galleryPhotos.length > 0);
+
+  useEffect(() => {
+    config?.onGalleryPrefetch?.();
+  }, [config]);
 
   const handleFiles = async (files: FileList | File[]) => {
     setError(null);
@@ -100,8 +117,60 @@ export function ImageInsertPanel({ editor, close, config }: ImagePanelProps) {
     close();
   };
 
+  const insertGalleryPhoto = (photoUrl: string) => {
+    if (!photoUrl.trim()) return;
+    insertImageSrc(editor, photoUrl);
+    close();
+  };
+
+  const openHostGallery = () => {
+    config?.onGalleryOpen?.();
+    close();
+  };
+
   return (
     <div className="spk-editor-toolbar-popover-form spk-editor-image-insert">
+      {galleryEnabled ? (
+        <div className="spk-editor-image-gallery">
+          {galleryPhotos.length > 0 ? (
+            <div className="spk-editor-image-gallery-grid">
+              {galleryPhotos.slice(0, 12).map((photo) => (
+                <button
+                  key={photo.id}
+                  type="button"
+                  className="spk-editor-image-gallery-item"
+                  onClick={(event) => {
+                    event.preventDefault();
+                    event.stopPropagation();
+                    insertGalleryPhoto(photo.url);
+                  }}
+                >
+                  <img src={resolveGalleryPhotoSrc(photo)} alt={photo.alt ?? "Gallery photo"} />
+                </button>
+              ))}
+            </div>
+          ) : (
+            <p className="spk-editor-image-gallery-empty">
+              {config?.galleryEmptyMessage ?? "No gallery photos available yet."}
+            </p>
+          )}
+          {config?.onGalleryOpen ? (
+            <button type="button" className="spk-editor-image-gallery-open" onClick={(event) => {
+              event.preventDefault();
+              event.stopPropagation();
+              openHostGallery();
+            }}>
+              <Images className="size-4" aria-hidden="true" />
+              {config.galleryOpenLabel ?? "Open gallery"}
+            </button>
+          ) : null}
+        </div>
+      ) : null}
+      {galleryEnabled ? (
+        <div className="spk-editor-image-insert-divider">
+          <span>or upload</span>
+        </div>
+      ) : null}
       <button
         type="button"
         className={cn(
@@ -159,6 +228,7 @@ export function ImageInsertPanel({ editor, close, config }: ImagePanelProps) {
           placeholder="https://example.com/photo.jpg"
           onChange={(event) => setUrl(event.target.value)}
           onKeyDown={(event) => {
+            preventFormSubmitOnEnter(event);
             if (event.key === "Enter") insertFromUrl();
             if (event.key === "Escape") close();
           }}

package/src/index.ts

@@ -38,6 +38,7 @@ export type {
   AiCommandMenuConfig,
   AiCommandPromptConfig,
   ImageInsertConfig,
+  ImageInsertGalleryPhoto,
   PlaceholderConfig,
   UseSpatikaEditorOptions,
 } from "./lib/types";

package/src/lib/types.ts

@@ -21,6 +21,13 @@ export type SpatikaEditorToolbarConfig = {
   layout?: "ribbon" | "compact";
 };
 
+export type ImageInsertGalleryPhoto = {
+  id: string | number;
+  url: string;
+  thumbnailUrl?: string;
+  alt?: string;
+};
+
 export type ImageInsertConfig = {
   /** Maximum files per drop or picker action. Default 3. */
   maxFiles?: number;
@@ -30,6 +37,16 @@ export type ImageInsertConfig = {
   accept?: string;
   /** Host-owned upload handler. Defaults to inline base64 data URLs. */
   onUpload?: (file: File) => Promise<string>;
+  /** Optional quick-pick gallery shown above upload/URL controls. */
+  galleryPhotos?: ImageInsertGalleryPhoto[];
+  /** Called when the insert-image panel opens (e.g. prefetch gallery assets). */
+  onGalleryPrefetch?: () => void;
+  /** Opens a host gallery picker (full library). */
+  onGalleryOpen?: () => void;
+  /** Empty-state copy when `galleryPhotos` is empty but gallery is enabled. */
+  galleryEmptyMessage?: string;
+  /** Label for the host gallery action button. Default "Open gallery". */
+  galleryOpenLabel?: string;
 };
 
 export type SlashCommandItem = {
@@ -96,6 +113,7 @@ export type SpatikaEditorHandle = {
   getHTML: () => string;
   getJSON: () => unknown;
   expandFullscreen: () => void;
+  insertImage: (url: string) => void;
 };
 
 export type PlaceholderConfig =

package/src/styles/editor.css

@@ -721,6 +721,70 @@
   min-width: 16rem;
 }
 
+.spk-editor-image-gallery {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+
+.spk-editor-image-gallery-grid {
+  display: grid;
+  grid-template-columns: repeat(4, minmax(0, 1fr));
+  gap: 0.4rem;
+}
+
+.spk-editor-image-gallery-item {
+  position: relative;
+  aspect-ratio: 1;
+  overflow: hidden;
+  border: 2px solid transparent;
+  border-radius: 0.65rem;
+  background: color-mix(in oklab, var(--muted) 40%, transparent);
+  padding: 0;
+  cursor: pointer;
+}
+
+.spk-editor-image-gallery-item:hover {
+  border-color: color-mix(in oklab, var(--primary) 55%, transparent);
+}
+
+.spk-editor-image-gallery-item img {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+  display: block;
+}
+
+.spk-editor-image-gallery-empty {
+  margin: 0;
+  padding: 0.5rem 0.25rem;
+  font-size: 0.75rem;
+  line-height: 1.4;
+  color: var(--muted-foreground);
+  text-align: center;
+}
+
+.spk-editor-image-gallery-open {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.4rem;
+  width: 100%;
+  min-height: 2rem;
+  border: 1px solid color-mix(in oklab, var(--border) 80%, transparent);
+  border-radius: 0.65rem;
+  background: color-mix(in oklab, var(--muted) 24%, transparent);
+  color: var(--foreground);
+  font-size: 0.8125rem;
+  font-weight: 600;
+  cursor: pointer;
+}
+
+.spk-editor-image-gallery-open:hover {
+  border-color: color-mix(in oklab, var(--primary) 35%, var(--border));
+  background: color-mix(in oklab, var(--primary) 8%, transparent);
+}
+
 .spk-editor-image-dropzone {
   display: flex;
   flex-direction: column;