drf-react-by-schema 0.28.22 → 0.28.24

package/dist/utils/utils.js

@@ -67,6 +67,8 @@ exports.buildConditionalVisibleBySchema = buildConditionalVisibleBySchema;
 exports.showConditionalVisibleField = showConditionalVisibleField;
 exports.showConditionalVisibleFieldObj = showConditionalVisibleFieldObj;
 exports.getMapLibraries = getMapLibraries;
+exports.getRichTextLibraries = getRichTextLibraries;
+exports.getHtmlSanitizer = getHtmlSanitizer;
 exports.geometryValueToString = geometryValueToString;
 exports.parseGeoJSON = parseGeoJSON;
 const dayjs_1 = __importDefault(require("dayjs"));
@@ -992,6 +994,73 @@ function getMapLibraries() {
     }
     return null;
 }
+// --- Optional rich-text (Tiptap) support ------------------------------------
+// Fields flagged as ``model_html`` by the backend hold HTML. Editing them uses
+// Tiptap when the consuming app has it installed; otherwise the form falls back
+// to the multiline text field.
+let richTextLibraries;
+/**
+ * Detect whether the consuming app has installed `@tiptap/react` +
+ * `@tiptap/starter-kit`. Returns the pieces the editor needs, or null so
+ * callers can fall back to plain text editing.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function getRichTextLibraries() {
+    var _a;
+    if (richTextLibraries !== undefined) {
+        return richTextLibraries;
+    }
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const react = require('@tiptap/react');
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const starterKit = require('@tiptap/starter-kit');
+        const editor = react.useEditor;
+        const starterKitExtension = (_a = starterKit.default) !== null && _a !== void 0 ? _a : starterKit.StarterKit;
+        if (typeof editor === 'function' &&
+            typeof react.EditorContent !== 'undefined' &&
+            typeof starterKitExtension !== 'undefined') {
+            richTextLibraries = {
+                useEditor: react.useEditor,
+                useEditorState: react.useEditorState,
+                EditorContent: react.EditorContent,
+                StarterKit: starterKitExtension,
+            };
+        }
+        else {
+            richTextLibraries = null;
+        }
+    }
+    catch (_b) {
+        // @tiptap/react / @tiptap/starter-kit not installed -> plain text fallback
+        richTextLibraries = null;
+    }
+    return richTextLibraries;
+}
+let htmlSanitizer;
+/**
+ * Detect whether the consuming app has installed `dompurify`. HTML from the
+ * backend is only injected into the DOM when a sanitizer is available; without
+ * it, values are rendered as plain text.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function getHtmlSanitizer() {
+    var _a;
+    if (htmlSanitizer !== undefined) {
+        return htmlSanitizer;
+    }
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const dompurify = require('dompurify');
+        const sanitizer = (_a = dompurify.default) !== null && _a !== void 0 ? _a : dompurify;
+        htmlSanitizer = typeof (sanitizer === null || sanitizer === void 0 ? void 0 : sanitizer.sanitize) === 'function' ? sanitizer : null;
+    }
+    catch (_b) {
+        // dompurify not installed -> render HTML as plain text
+        htmlSanitizer = null;
+    }
+    return htmlSanitizer;
+}
 /** Normalize a GeoJSON value (object, JSON string or null) to a string. */
 function geometryValueToString(value) {
     if (value === null || value === undefined)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drf-react-by-schema",
-  "version": "0.28.22",
+  "version": "0.28.24",
   "description": "Components and Tools for building a React App having Django Rest Framework (DRF) as server",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -85,8 +85,11 @@
     "@mui/material": "^6",
     "@mui/x-data-grid": "^7",
     "@mui/x-date-pickers": "^7",
+    "@tiptap/react": "^3.0.0",
+    "@tiptap/starter-kit": "^3.0.0",
     "axios": "^1",
     "dayjs": "^1",
+    "dompurify": "^3.0.0",
     "leaflet": "^1.9.0",
     "leaflet-draw": "^1.0.4",
     "react": "^18 || ^19",
@@ -98,6 +101,15 @@
     "yup": "^1"
   },
   "peerDependenciesMeta": {
+    "@tiptap/react": {
+      "optional": true
+    },
+    "@tiptap/starter-kit": {
+      "optional": true
+    },
+    "dompurify": {
+      "optional": true
+    },
     "leaflet": {
       "optional": true
     },