@kopexa/tiptap 17.0.17 → 17.2.0

package/dist/context/editor-file-context.d.ts

@@ -0,0 +1,70 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+interface EditorFileHandler {
+    /**
+     * Upload a file and return a reference string.
+     * The reference format is determined by the backend (e.g., UUID, custom scheme).
+     * @param file The file to upload
+     * @param onProgress Optional progress callback (0-100)
+     * @returns Promise resolving to a reference string
+     */
+    upload: (file: File, onProgress?: (percent: number) => void) => Promise<string>;
+    /**
+     * Resolve a reference to a displayable URL.
+     * Typically returns a signed URL from your storage backend.
+     * @param ref The reference string from upload
+     * @returns Promise resolving to a displayable URL
+     */
+    resolve: (ref: string) => Promise<string>;
+    /**
+     * Check if a src string is a reference that needs resolving.
+     * Returns false for already-valid URLs (https://, data:, etc.)
+     * @param src The src attribute value
+     * @returns true if this needs to be resolved
+     */
+    isReference: (src: string) => boolean;
+}
+interface EditorFileContextValue extends EditorFileHandler {
+    /**
+     * Whether file handling is available
+     */
+    isAvailable: true;
+}
+interface EditorFileProviderProps {
+    children: ReactNode;
+    /**
+     * Upload handler - called when user pastes/drops a file
+     */
+    onUpload: EditorFileHandler["upload"];
+    /**
+     * Resolve handler - called to get displayable URL from reference
+     */
+    onResolve: EditorFileHandler["resolve"];
+    /**
+     * Check if src needs resolving (default: not starting with http/https/data)
+     */
+    isReference?: EditorFileHandler["isReference"];
+    /**
+     * Cache TTL buffer in ms (default: 2 minutes)
+     * URLs are refreshed this much before actual expiry
+     */
+    cacheBuffer?: number;
+    /**
+     * Default cache TTL in ms if not determined from response (default: 10 minutes)
+     */
+    defaultCacheTtl?: number;
+}
+declare function EditorFileProvider({ children, onUpload, onResolve, isReference, cacheBuffer, defaultCacheTtl, }: EditorFileProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Hook to access file handling capabilities.
+ * Returns null if no EditorFileProvider is present (files not supported).
+ */
+declare function useEditorFile(): EditorFileContextValue | null;
+/**
+ * Hook that throws if file handling is not available.
+ * Use this in components that require file support.
+ */
+declare function useEditorFileRequired(): EditorFileContextValue;
+
+export { type EditorFileHandler, EditorFileProvider, type EditorFileProviderProps, useEditorFile, useEditorFileRequired };

package/dist/context/editor-file-context.js

@@ -0,0 +1,96 @@
+"use client";
+"use strict";
+"use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/context/editor-file-context.tsx
+var editor_file_context_exports = {};
+__export(editor_file_context_exports, {
+  EditorFileProvider: () => EditorFileProvider,
+  useEditorFile: () => useEditorFile,
+  useEditorFileRequired: () => useEditorFileRequired
+});
+module.exports = __toCommonJS(editor_file_context_exports);
+var import_react = require("react");
+var import_jsx_runtime = require("react/jsx-runtime");
+var EditorFileContext = (0, import_react.createContext)(null);
+var DEFAULT_CACHE_BUFFER = 2 * 60 * 1e3;
+var DEFAULT_CACHE_TTL = 10 * 60 * 1e3;
+var defaultIsReference = (src) => {
+  if (!src) return false;
+  if (src.startsWith("http://") || src.startsWith("https://")) return false;
+  if (src.startsWith("data:")) return false;
+  if (src.startsWith("blob:")) return false;
+  return true;
+};
+function EditorFileProvider({
+  children,
+  onUpload,
+  onResolve,
+  isReference = defaultIsReference,
+  cacheBuffer = DEFAULT_CACHE_BUFFER,
+  defaultCacheTtl = DEFAULT_CACHE_TTL
+}) {
+  const cacheRef = (0, import_react.useRef)(/* @__PURE__ */ new Map());
+  const resolve = (0, import_react.useCallback)(
+    async (ref) => {
+      const cache = cacheRef.current;
+      const now = Date.now();
+      const cached = cache.get(ref);
+      if (cached && cached.expiresAt > now + cacheBuffer) {
+        return cached.url;
+      }
+      const url = await onResolve(ref);
+      cache.set(ref, {
+        url,
+        expiresAt: now + defaultCacheTtl
+      });
+      return url;
+    },
+    [onResolve, cacheBuffer, defaultCacheTtl]
+  );
+  const value = (0, import_react.useMemo)(
+    () => ({
+      isAvailable: true,
+      upload: onUpload,
+      resolve,
+      isReference
+    }),
+    [onUpload, resolve, isReference]
+  );
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(EditorFileContext.Provider, { value, children });
+}
+function useEditorFile() {
+  return (0, import_react.useContext)(EditorFileContext);
+}
+function useEditorFileRequired() {
+  const context = (0, import_react.useContext)(EditorFileContext);
+  if (!context) {
+    throw new Error(
+      "useEditorFileRequired must be used within an EditorFileProvider"
+    );
+  }
+  return context;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  EditorFileProvider,
+  useEditorFile,
+  useEditorFileRequired
+});

package/dist/context/editor-file-context.mjs

@@ -0,0 +1,12 @@
+"use client";
+"use client";
+import {
+  EditorFileProvider,
+  useEditorFile,
+  useEditorFileRequired
+} from "../chunk-VRQ6OSAZ.mjs";
+export {
+  EditorFileProvider,
+  useEditorFile,
+  useEditorFileRequired
+};

package/dist/extensions/callout/callout-settings.d.mts

@@ -0,0 +1,13 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { Editor } from '@tiptap/react';
+import { CalloutAttrs as CalloutNodeAttrs } from './index.mjs';
+import '@tiptap/core';
+
+interface CalloutSettingsProps {
+    editor: Editor;
+    attrs: CalloutNodeAttrs;
+    getPos: () => number | undefined;
+}
+declare function CalloutSettings({ editor, attrs, getPos, }: CalloutSettingsProps): react_jsx_runtime.JSX.Element | null;
+
+export { CalloutSettings };

package/dist/extensions/callout/callout-settings.d.ts

@@ -0,0 +1,13 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { Editor } from '@tiptap/react';
+import { CalloutAttrs as CalloutNodeAttrs } from './index.js';
+import '@tiptap/core';
+
+interface CalloutSettingsProps {
+    editor: Editor;
+    attrs: CalloutNodeAttrs;
+    getPos: () => number | undefined;
+}
+declare function CalloutSettings({ editor, attrs, getPos, }: CalloutSettingsProps): react_jsx_runtime.JSX.Element | null;
+
+export { CalloutSettings };

package/dist/extensions/callout/callout-settings.js

@@ -0,0 +1,206 @@
+"use client";
+"use strict";
+"use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/extensions/callout/callout-settings.tsx
+var callout_settings_exports = {};
+__export(callout_settings_exports, {
+  CalloutSettings: () => CalloutSettings
+});
+module.exports = __toCommonJS(callout_settings_exports);
+var import_button = require("@kopexa/button");
+var import_dialog = require("@kopexa/dialog");
+var import_icons = require("@kopexa/icons");
+var import_input = require("@kopexa/input");
+var import_label = require("@kopexa/label");
+var import_select = require("@kopexa/select");
+var import_react = require("react");
+var import_react_intl2 = require("react-intl");
+
+// src/extensions/callout/messages.ts
+var import_react_intl = require("react-intl");
+var messages = (0, import_react_intl.defineMessages)({
+  settings: {
+    id: "editor.callout.settings",
+    defaultMessage: "Settings",
+    description: "Settings button label"
+  },
+  variant: {
+    id: "editor.callout.variant",
+    defaultMessage: "Variant",
+    description: "Variant setting label"
+  },
+  variant_default: {
+    id: "editor.callout.variant_default",
+    defaultMessage: "Default",
+    description: "Default variant option"
+  },
+  variant_info: {
+    id: "editor.callout.variant_info",
+    defaultMessage: "Info",
+    description: "Info variant option"
+  },
+  variant_success: {
+    id: "editor.callout.variant_success",
+    defaultMessage: "Success",
+    description: "Success variant option"
+  },
+  variant_warning: {
+    id: "editor.callout.variant_warning",
+    defaultMessage: "Warning",
+    description: "Warning variant option"
+  },
+  variant_destructive: {
+    id: "editor.callout.variant_destructive",
+    defaultMessage: "Error",
+    description: "Destructive/Error variant option"
+  },
+  title: {
+    id: "editor.callout.title",
+    defaultMessage: "Title",
+    description: "Title input label"
+  },
+  title_placeholder: {
+    id: "editor.callout.title_placeholder",
+    defaultMessage: "Optional title...",
+    description: "Title input placeholder"
+  },
+  save: {
+    id: "editor.callout.save",
+    defaultMessage: "Save",
+    description: "Save button label"
+  },
+  cancel: {
+    id: "editor.callout.cancel",
+    defaultMessage: "Cancel",
+    description: "Cancel button label"
+  }
+});
+
+// src/extensions/callout/callout-settings.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+var VARIANTS = [
+  { value: "default", messageKey: "variant_default" },
+  { value: "info", messageKey: "variant_info" },
+  { value: "success", messageKey: "variant_success" },
+  { value: "warning", messageKey: "variant_warning" },
+  { value: "destructive", messageKey: "variant_destructive" }
+];
+function CalloutSettings({
+  editor,
+  attrs,
+  getPos
+}) {
+  const intl = (0, import_react_intl2.useIntl)();
+  const [isOpen, setIsOpen] = (0, import_react.useState)(false);
+  const [localAttrs, setLocalAttrs] = (0, import_react.useState)(attrs);
+  (0, import_react.useEffect)(() => {
+    if (isOpen) {
+      setLocalAttrs(attrs);
+    }
+  }, [isOpen, attrs]);
+  const handleSave = (0, import_react.useCallback)(() => {
+    const pos = getPos();
+    if (pos === void 0) return;
+    editor.view.dispatch(
+      editor.state.tr.setNodeMarkup(pos, void 0, localAttrs)
+    );
+    setIsOpen(false);
+  }, [editor, localAttrs, getPos]);
+  const handleCancel = (0, import_react.useCallback)(() => {
+    setLocalAttrs(attrs);
+    setIsOpen(false);
+  }, [attrs]);
+  const handleVariantChange = (0, import_react.useCallback)((value) => {
+    setLocalAttrs((prev) => ({
+      ...prev,
+      variant: String(value)
+    }));
+  }, []);
+  const handleTitleChange = (0, import_react.useCallback)(
+    (e) => {
+      const value = e.target.value;
+      setLocalAttrs((prev) => ({
+        ...prev,
+        title: value || null
+      }));
+    },
+    []
+  );
+  if (!editor.isEditable) {
+    return null;
+  }
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_jsx_runtime.Fragment, { children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+      import_button.IconButton,
+      {
+        size: "sm",
+        variant: "ghost",
+        "aria-label": intl.formatMessage(messages.settings),
+        onClick: (e) => {
+          e.stopPropagation();
+          e.preventDefault();
+          setIsOpen(true);
+        },
+        children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_icons.SettingsIcon, { className: "size-3.5" })
+      }
+    ),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dialog.Dialog.Root, { open: isOpen, onOpenChange: setIsOpen, size: "sm", children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_dialog.Dialog.Content, { children: [
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dialog.Dialog.Header, { children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dialog.Dialog.Title, { children: intl.formatMessage(messages.settings) }) }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dialog.Dialog.Body, { children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "space-y-4", children: [
+        /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "space-y-1.5", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_label.Label, { className: "text-sm", children: intl.formatMessage(messages.variant) }),
+          /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+            import_select.Select,
+            {
+              size: "sm",
+              value: localAttrs.variant,
+              onValueChange: handleVariantChange,
+              children: [
+                /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_select.Select.Trigger, { children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_select.Select.Value, {}) }),
+                /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_select.Select.Content, { children: VARIANTS.map((v) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_select.Select.Item, { value: v.value, children: intl.formatMessage(messages[v.messageKey]) }, v.value)) })
+              ]
+            }
+          )
+        ] }),
+        /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "space-y-1.5", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_label.Label, { className: "text-sm", children: intl.formatMessage(messages.title) }),
+          /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+            import_input.Input,
+            {
+              size: "sm",
+              value: localAttrs.title || "",
+              onChange: handleTitleChange,
+              placeholder: intl.formatMessage(messages.title_placeholder)
+            }
+          )
+        ] })
+      ] }) }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_dialog.Dialog.Footer, { children: [
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_button.Button, { variant: "ghost", onClick: handleCancel, children: intl.formatMessage(messages.cancel) }),
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_button.Button, { onClick: handleSave, children: intl.formatMessage(messages.save) })
+      ] })
+    ] }) })
+  ] });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CalloutSettings
+});

package/dist/extensions/callout/callout-settings.mjs

@@ -0,0 +1,9 @@
+"use client";
+"use client";
+import {
+  CalloutSettings
+} from "../../chunk-N4CT5RNC.mjs";
+import "../../chunk-JCV5SEKN.mjs";
+export {
+  CalloutSettings
+};

package/dist/extensions/callout/callout-view.d.mts

@@ -0,0 +1,12 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { NodeViewProps } from '@tiptap/react';
+
+/**
+ * Callout NodeView Component
+ *
+ * Renders a callout block with variant-specific styling.
+ * Supports editable content inside the callout.
+ */
+declare function CalloutNodeView({ editor, node, getPos }: NodeViewProps): react_jsx_runtime.JSX.Element;
+
+export { CalloutNodeView, CalloutNodeView as default };

package/dist/extensions/callout/callout-view.d.ts

@@ -0,0 +1,12 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { NodeViewProps } from '@tiptap/react';
+
+/**
+ * Callout NodeView Component
+ *
+ * Renders a callout block with variant-specific styling.
+ * Supports editable content inside the callout.
+ */
+declare function CalloutNodeView({ editor, node, getPos }: NodeViewProps): react_jsx_runtime.JSX.Element;
+
+export { CalloutNodeView, CalloutNodeView as default };