magic-editor-x 2.3.1 → 2.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (84) hide show
  1. package/CHANGELOG.md +74 -0
  2. package/README.md +299 -142
  3. package/dist/admin/AuditPage-C2u6z4aN.js +381 -0
  4. package/dist/admin/AuditPage-guB0SiGS.mjs +381 -0
  5. package/dist/admin/{ConfigurationPage-CFP3lp9p.js → ConfigurationPage-D6uya-J1.js} +228 -13
  6. package/dist/admin/{ConfigurationPage-CYGDLjM7.mjs → ConfigurationPage-DiEpF1Rr.mjs} +222 -7
  7. package/dist/admin/ConfirmAction-CUhpngYU.js +71 -0
  8. package/dist/admin/ConfirmAction-CZjpduc3.mjs +72 -0
  9. package/dist/admin/{CustomBlocksPage-B5Q33N-s.mjs → CustomBlocksPage-Byt10-6c.mjs} +6 -4
  10. package/dist/admin/{CustomBlocksPage-DzPOSpfn.js → CustomBlocksPage-DP3h_wNd.js} +21 -19
  11. package/dist/admin/MentionsWidget-C2OCAmqq.js +227 -0
  12. package/dist/admin/MentionsWidget-sMkM9mHX.mjs +225 -0
  13. package/dist/admin/{TemplatesPage-BVkgafCK.js → TemplatesPage-DrSJdteI.js} +313 -17
  14. package/dist/admin/{TemplatesPage-4A8JNO_Z.mjs → TemplatesPage-Yp4OqFE2.mjs} +305 -9
  15. package/dist/admin/{ConfirmAction-DuQwvRYi.mjs → api-2ZRpHM3d.mjs} +19 -70
  16. package/dist/admin/{ConfirmAction-zLuIFj8t.js → api-bix9RLLI.js} +19 -70
  17. package/dist/admin/auditText-DIIYVR6k.mjs +110 -0
  18. package/dist/admin/auditText-DUhWu2Nx.js +109 -0
  19. package/dist/admin/comments-C7P41lan.js +86 -0
  20. package/dist/admin/comments-hfIbLQNO.mjs +87 -0
  21. package/dist/admin/{de-BMY2LBaa.mjs → de-BNPIGqhs.mjs} +41 -2
  22. package/dist/admin/{de-2Ie5jy7j.js → de-BhhGss1l.js} +41 -2
  23. package/dist/admin/{de-DOiGaTNX.mjs → de-CKz6CG3V.mjs} +191 -5
  24. package/dist/admin/{de-C3AsGauQ.js → de-CbBDnXeT.js} +140 -1
  25. package/dist/admin/{de-BUS1hUw0.mjs → de-DiCZrmH8.mjs} +140 -1
  26. package/dist/admin/{de-B1X46JJZ.js → de-zcV8D7nt.js} +191 -5
  27. package/dist/admin/{en-Ah-Cw0Wd.js → en-B9ApE1y1.js} +41 -2
  28. package/dist/admin/{en-CDg_18Bt.js → en-BMWhILnj.js} +191 -5
  29. package/dist/admin/{en-BkEjpC3i.js → en-CpehF0Kv.js} +140 -1
  30. package/dist/admin/{en-GCzgS9Aw.mjs → en-DCPMqFIa.mjs} +140 -1
  31. package/dist/admin/{en-CU6UzV4g.mjs → en-cYzqbASF.mjs} +191 -5
  32. package/dist/admin/{en-CvFiqti2.mjs → en-gFLeK9Ng.mjs} +41 -2
  33. package/dist/admin/{es-DbKHZz5l.mjs → es-BmwBgEgz.mjs} +41 -2
  34. package/dist/admin/{es-Cr8JH85N.js → es-C0W31rl8.js} +41 -2
  35. package/dist/admin/{es-BCpJmUEM.js → es-CQPh8PXw.js} +191 -5
  36. package/dist/admin/{es-C4pEnDRv.js → es-CawpzwyC.js} +140 -1
  37. package/dist/admin/{es-DHBBZKl2.mjs → es-Chs37IBR.mjs} +140 -1
  38. package/dist/admin/{es-BmfffNM2.mjs → es-DCamt1ek.mjs} +191 -5
  39. package/dist/admin/{fr-DQJ_7aq5.mjs → fr-CMWBNE5D.mjs} +41 -2
  40. package/dist/admin/{fr-C2aLSwEu.js → fr-COOsqexl.js} +140 -1
  41. package/dist/admin/{fr-Dvq4xk2e.mjs → fr-Dp5-XP29.mjs} +140 -1
  42. package/dist/admin/{fr-ZcN0yM_2.js → fr-DpC44Ol8.js} +191 -5
  43. package/dist/admin/{fr-OJ4VW1kh.js → fr-iGeIfEcU.js} +41 -2
  44. package/dist/admin/{fr-DZd2XJP6.mjs → fr-oW0t8bT5.mjs} +191 -5
  45. package/dist/admin/{index-DQVE0ymw.js → index-64wc26Bl.js} +17467 -10369
  46. package/dist/admin/{index-k8_a5o1A.mjs → index-BVjf1gVC.mjs} +13786 -6687
  47. package/dist/admin/{index-DR8sHkTk.js → index-D6Z7i8ba.js} +1003 -53
  48. package/dist/admin/{index-My6FjjHB.mjs → index-D_Fv8Non.mjs} +1032 -82
  49. package/dist/admin/index.js +2 -1
  50. package/dist/admin/index.mjs +3 -2
  51. package/dist/admin/math-CIQ4Z_mY.mjs +47 -0
  52. package/dist/admin/math-vsK_06ZR.js +49 -0
  53. package/dist/admin/{pt-D0I0_JYs.js → pt-BHmXk2d9.js} +41 -2
  54. package/dist/admin/{pt-CImqDnLB.js → pt-Bo0Pm_Pt.js} +191 -5
  55. package/dist/admin/{pt-CilDggGF.mjs → pt-DALDvfBn.mjs} +140 -1
  56. package/dist/admin/{pt-BSLzA17U.mjs → pt-DFNgZ5_k.mjs} +41 -2
  57. package/dist/admin/{pt-DX0OAIoL.js → pt-DXy7G1x7.js} +140 -1
  58. package/dist/admin/{pt-C3UdeIpd.mjs → pt-uGpfRQLC.mjs} +191 -5
  59. package/dist/admin/{useT-DNphiBQR.js → useT-BXJLIPN4.js} +1 -1
  60. package/dist/admin/{useT-Cmg1jwwG.mjs → useT-CLPhBmBC.mjs} +1 -1
  61. package/dist/blocks/index.d.mts +2 -0
  62. package/dist/blocks/index.d.ts +2 -0
  63. package/dist/blocks/index.js +13 -2
  64. package/dist/blocks/index.mjs +13 -2
  65. package/dist/math/index.d.mts +27 -0
  66. package/dist/math/index.d.ts +27 -0
  67. package/dist/math/index.js +164 -0
  68. package/dist/math/index.mjs +134 -0
  69. package/dist/react/index.js +673 -91
  70. package/dist/react/index.mjs +673 -91
  71. package/dist/render/index.d.mts +26 -0
  72. package/dist/render/index.d.ts +26 -0
  73. package/dist/render/index.js +779 -106
  74. package/dist/render/index.mjs +779 -106
  75. package/dist/server/index.js +10419 -4103
  76. package/dist/server/index.mjs +10419 -4103
  77. package/dist/vue/index.js +673 -91
  78. package/dist/vue/index.mjs +673 -91
  79. package/package.json +8 -2
  80. package/schema/magic-editor-x.schema.json +127 -2
  81. package/types/blocks.d.ts +2 -0
  82. package/types/index.d.ts +42 -0
  83. package/types/math.d.ts +27 -0
  84. package/types/render.d.ts +26 -0
@@ -166,8 +166,34 @@ export interface RenderOptions {
166
166
  * come expanded.
167
167
  */
168
168
  synced?: SyncedSources;
169
+ /**
170
+ * Math (2.4): renders TeX of math blocks and inline math. Return MathML
171
+ * (string) or render nodes; the result is parsed through a strict MathML
172
+ * allow-list (MathML Core elements, no href, style, id or event
173
+ * attributes). `renderMath` from `magic-editor-x/math` (Temml) fits.
174
+ * Without it, or when it returns nothing usable, the TeX source is written
175
+ * between `\\( \\)` / `\\[ \\]` in `<span|div class="mex-math" data-mex-math>`
176
+ * for client-side auto-render. Text output is the TeX source; Markdown
177
+ * `$…$` / `$$…$$`.
178
+ */
179
+ math?: MathRenderer;
180
+ /**
181
+ * Footnotes (2.4): numbered references `<sup class="mex-footnote-ref"><a href="#<prefix>fn-<id>">n</a></sup>`
182
+ * and a list `<section class="mex-footnotes">` after the content. `label`
183
+ * names the list (default 'Footnotes'), `backLabel` the back links
184
+ * (`{n}` = number, default 'Back to reference {n}'), `prefix` starts every id
185
+ * (default 'mex-'; use one per field when several fields render on a page).
186
+ * Text output: `[n]` and a list; Markdown: GFM `[^n]` footnotes.
187
+ */
188
+ footnotes?: { label?: string; backLabel?: string; prefix?: string };
169
189
  }
170
190
 
191
+ /** Renders TeX: MathML markup or render nodes; null/undefined for the fallback. */
192
+ export type MathRenderer = (
193
+ tex: string,
194
+ options: { display: boolean }
195
+ ) => string | RenderNode | ReadonlyArray<RenderNode> | null | undefined;
196
+
171
197
  /** A synced block source: an Editor.js document or its block array. */
172
198
  export type SyncedSource = { blocks: ReadonlyArray<unknown> } | ReadonlyArray<unknown>;
173
199
  /** Sources of synced blocks by reference (the source's documentId). */
@@ -166,8 +166,34 @@ export interface RenderOptions {
166
166
  * come expanded.
167
167
  */
168
168
  synced?: SyncedSources;
169
+ /**
170
+ * Math (2.4): renders TeX of math blocks and inline math. Return MathML
171
+ * (string) or render nodes; the result is parsed through a strict MathML
172
+ * allow-list (MathML Core elements, no href, style, id or event
173
+ * attributes). `renderMath` from `magic-editor-x/math` (Temml) fits.
174
+ * Without it, or when it returns nothing usable, the TeX source is written
175
+ * between `\\( \\)` / `\\[ \\]` in `<span|div class="mex-math" data-mex-math>`
176
+ * for client-side auto-render. Text output is the TeX source; Markdown
177
+ * `$…$` / `$$…$$`.
178
+ */
179
+ math?: MathRenderer;
180
+ /**
181
+ * Footnotes (2.4): numbered references `<sup class="mex-footnote-ref"><a href="#<prefix>fn-<id>">n</a></sup>`
182
+ * and a list `<section class="mex-footnotes">` after the content. `label`
183
+ * names the list (default 'Footnotes'), `backLabel` the back links
184
+ * (`{n}` = number, default 'Back to reference {n}'), `prefix` starts every id
185
+ * (default 'mex-'; use one per field when several fields render on a page).
186
+ * Text output: `[n]` and a list; Markdown: GFM `[^n]` footnotes.
187
+ */
188
+ footnotes?: { label?: string; backLabel?: string; prefix?: string };
169
189
  }
170
190
 
191
+ /** Renders TeX: MathML markup or render nodes; null/undefined for the fallback. */
192
+ export type MathRenderer = (
193
+ tex: string,
194
+ options: { display: boolean }
195
+ ) => string | RenderNode | ReadonlyArray<RenderNode> | null | undefined;
196
+
171
197
  /** A synced block source: an Editor.js document or its block array. */
172
198
  export type SyncedSource = { blocks: ReadonlyArray<unknown> } | ReadonlyArray<unknown>;
173
199
  /** Sources of synced blocks by reference (the source's documentId). */