magic-editor-x 2.3.1 → 2.5.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 (106) hide show
  1. package/CHANGELOG.md +125 -0
  2. package/README.md +428 -148
  3. package/bin/magic-editor-x.mjs +55 -8
  4. package/dist/admin/AuditPage-Be78C7EC.mjs +382 -0
  5. package/dist/admin/AuditPage-iQzpjH8H.js +382 -0
  6. package/dist/admin/{ConfigurationPage-CYGDLjM7.mjs → ConfigurationPage-C9CPBfWy.mjs} +405 -10
  7. package/dist/admin/{ConfigurationPage-CFP3lp9p.js → ConfigurationPage-DefuBeYO.js} +415 -20
  8. package/dist/admin/ConfirmAction-CUhpngYU.js +71 -0
  9. package/dist/admin/ConfirmAction-CZjpduc3.mjs +72 -0
  10. package/dist/admin/Content-BttG50Mc.mjs +360 -0
  11. package/dist/admin/Content-V5MRBsI3.js +362 -0
  12. package/dist/admin/{CustomBlocksPage-B5Q33N-s.mjs → CustomBlocksPage-DB5nnCsn.mjs} +8 -5
  13. package/dist/admin/{CustomBlocksPage-DzPOSpfn.js → CustomBlocksPage-Dg2rM3F4.js} +26 -23
  14. package/dist/admin/EntryWidgets-B8YA0Zxy.mjs +199 -0
  15. package/dist/admin/EntryWidgets-BcXAAx3F.js +201 -0
  16. package/dist/admin/MentionsWidget-CJPZDk9Z.mjs +225 -0
  17. package/dist/admin/MentionsWidget-DUz6YVIG.js +227 -0
  18. package/dist/admin/{useT-Cmg1jwwG.mjs → SectionCard-8ZNHkvn9.mjs} +2 -12
  19. package/dist/admin/{useT-DNphiBQR.js → SectionCard-Bs-xiiH1.js} +0 -10
  20. package/dist/admin/{TemplatesPage-4A8JNO_Z.mjs → TemplatesPage-VsZ_Mc0R.mjs} +307 -10
  21. package/dist/admin/{TemplatesPage-BVkgafCK.js → TemplatesPage-dx4_yd_t.js} +321 -24
  22. package/dist/admin/{ConfirmAction-zLuIFj8t.js → api-4AYzwS4-.js} +28 -71
  23. package/dist/admin/{ConfirmAction-DuQwvRYi.mjs → api-CcTYyckq.mjs} +28 -71
  24. package/dist/admin/auditText-DIIYVR6k.mjs +110 -0
  25. package/dist/admin/auditText-DUhWu2Nx.js +109 -0
  26. package/dist/admin/comments-C7P41lan.js +86 -0
  27. package/dist/admin/comments-hfIbLQNO.mjs +87 -0
  28. package/dist/admin/{de-B1X46JJZ.js → de-B6rdcOqQ.js} +293 -5
  29. package/dist/admin/{de-1cFMs-4c.mjs → de-BWfR2jTg.mjs} +8 -1
  30. package/dist/admin/{de-BUS1hUw0.mjs → de-Bip0sBRT.mjs} +158 -1
  31. package/dist/admin/{de-Dn8athM8.js → de-BrPR4sUB.js} +8 -1
  32. package/dist/admin/{de-DOiGaTNX.mjs → de-CQA8hOpl.mjs} +293 -5
  33. package/dist/admin/{de-C3AsGauQ.js → de-CnnxKXj7.js} +158 -1
  34. package/dist/admin/{de-2Ie5jy7j.js → de-Dss5POqk.js} +53 -3
  35. package/dist/admin/{de-BMY2LBaa.mjs → de-zgHCYTLH.mjs} +53 -3
  36. package/dist/admin/{en-CIZ5Ggod.js → en--JjAHbpP.js} +8 -1
  37. package/dist/admin/{en-CU6UzV4g.mjs → en-BCKaVgBM.mjs} +293 -5
  38. package/dist/admin/{en-Ah-Cw0Wd.js → en-CJ17Sp_e.js} +53 -3
  39. package/dist/admin/{en-CDg_18Bt.js → en-CbGkcq0Q.js} +293 -5
  40. package/dist/admin/{en-GCzgS9Aw.mjs → en-Cd6Jk-J0.mjs} +158 -1
  41. package/dist/admin/{en-BkEjpC3i.js → en-D69Fe9ZO.js} +158 -1
  42. package/dist/admin/{en-Dc9y-6n9.mjs → en-Dr58wBAo.mjs} +8 -1
  43. package/dist/admin/{en-CvFiqti2.mjs → en-Uhm7OouM.mjs} +53 -3
  44. package/dist/admin/entry-panel-events-0msyPrAD.js +18 -0
  45. package/dist/admin/entry-panel-events-XRuUoLZ9.mjs +19 -0
  46. package/dist/admin/{es-D2Kw6E4N.mjs → es-B2Hkkbw9.mjs} +8 -1
  47. package/dist/admin/{es-DbKHZz5l.mjs → es-BMkmfH88.mjs} +53 -3
  48. package/dist/admin/{es-DHBBZKl2.mjs → es-Bz8d72Fa.mjs} +158 -1
  49. package/dist/admin/{es-BCpJmUEM.js → es-C8UotT8O.js} +293 -5
  50. package/dist/admin/{es-C4pEnDRv.js → es-CcEDZpVQ.js} +158 -1
  51. package/dist/admin/{es-Cr8JH85N.js → es-DJm3HFJt.js} +53 -3
  52. package/dist/admin/{es-C4IRHV5d.js → es-YvaTAtqY.js} +8 -1
  53. package/dist/admin/{es-BmfffNM2.mjs → es-pvPfNAld.mjs} +293 -5
  54. package/dist/admin/{fr-BOvvfEH7.mjs → fr-BvPjRiwr.mjs} +8 -1
  55. package/dist/admin/{fr-Dvq4xk2e.mjs → fr-CKHZ0xxU.mjs} +158 -1
  56. package/dist/admin/{fr-OJ4VW1kh.js → fr-CRM9VuAq.js} +53 -3
  57. package/dist/admin/{fr-DQJ_7aq5.mjs → fr-CrIHmKYX.mjs} +53 -3
  58. package/dist/admin/{fr-C2aLSwEu.js → fr-Cx29jQ_g.js} +158 -1
  59. package/dist/admin/{fr-DZd2XJP6.mjs → fr-D4tL6Ag2.mjs} +293 -5
  60. package/dist/admin/{fr-Zkb8vfjN.js → fr-Di-U-rAH.js} +8 -1
  61. package/dist/admin/{fr-ZcN0yM_2.js → fr-DrUYv2jh.js} +293 -5
  62. package/dist/admin/{index-k8_a5o1A.mjs → index-C4ksUkEm.mjs} +20059 -10130
  63. package/dist/admin/{index-DQVE0ymw.js → index-C5D3VqLq.js} +21272 -11344
  64. package/dist/admin/index-CMYCZWOh.mjs +3752 -0
  65. package/dist/admin/index-DRyctF9s.js +3753 -0
  66. package/dist/admin/index.js +2 -1
  67. package/dist/admin/index.mjs +3 -2
  68. package/dist/admin/math-D6jmskGS.js +49 -0
  69. package/dist/admin/math-DntdSWKX.mjs +47 -0
  70. package/dist/admin/{pt-CilDggGF.mjs → pt-B8x7v-Xw.mjs} +158 -1
  71. package/dist/admin/{pt-DX0OAIoL.js → pt-BYn2xx78.js} +158 -1
  72. package/dist/admin/{pt-CImqDnLB.js → pt-CojQcz-p.js} +293 -5
  73. package/dist/admin/{pt-C3UdeIpd.mjs → pt-CuoIihKx.mjs} +293 -5
  74. package/dist/admin/{pt-1IUyx6ae.js → pt-CzrN_3ui.js} +8 -1
  75. package/dist/admin/{pt-BSLzA17U.mjs → pt-DDlPJYtB.mjs} +53 -3
  76. package/dist/admin/{pt-D0I0_JYs.js → pt-DPVAycXJ.js} +53 -3
  77. package/dist/admin/{pt-etwsg3G4.mjs → pt-DdGagO99.mjs} +8 -1
  78. package/dist/admin/useT-Bpw__IXT.js +12 -0
  79. package/dist/admin/useT-Cb-R3kyA.mjs +13 -0
  80. package/dist/blocks/index.d.mts +126 -0
  81. package/dist/blocks/index.d.ts +126 -0
  82. package/dist/blocks/index.js +184 -4
  83. package/dist/blocks/index.mjs +184 -4
  84. package/dist/math/index.d.mts +27 -0
  85. package/dist/math/index.d.ts +27 -0
  86. package/dist/math/index.js +168 -0
  87. package/dist/math/index.mjs +138 -0
  88. package/dist/react/index.js +1650 -759
  89. package/dist/react/index.mjs +1650 -759
  90. package/dist/render/index.d.mts +48 -0
  91. package/dist/render/index.d.ts +48 -0
  92. package/dist/render/index.js +1755 -773
  93. package/dist/render/index.mjs +1755 -773
  94. package/dist/server/index.js +29475 -18462
  95. package/dist/server/index.mjs +29475 -18462
  96. package/dist/server/mcp-worker.js +11319 -0
  97. package/dist/vue/index.js +1650 -759
  98. package/dist/vue/index.mjs +1650 -759
  99. package/package.json +14 -8
  100. package/schema/magic-editor-x.schema.json +135 -2
  101. package/types/blocks.d.ts +126 -0
  102. package/types/index.d.ts +52 -1
  103. package/types/math.d.ts +27 -0
  104. package/types/render.d.ts +48 -0
  105. package/dist/admin/index-DR8sHkTk.js +0 -1940
  106. package/dist/admin/index-My6FjjHB.mjs +0 -1939
@@ -166,8 +166,56 @@ 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 };
189
+ /**
190
+ * Inline annotations (2.5, `defineInlineAnnotation` from `magic-editor-x/blocks`):
191
+ * `<span data-mex-annotation="name">` is rendered with the definition's
192
+ * `render` (one validated wrapper element around the text). These
193
+ * definitions replace the bundle's registry for that call; the built-in
194
+ * `abbreviation` (`<abbr title>`) is always known. Unknown annotations get
195
+ * `<span class="mex-annotation mex-annotation-<name>" data-mex-annotation …>`.
196
+ * Pass a stable array. Text and Markdown output keep the text only.
197
+ */
198
+ annotations?: ReadonlyArray<import('./blocks.js').InlineAnnotationDefinition>;
199
+ /**
200
+ * Value of an annotation for its `render` (`resolved`), e.g. a glossary
201
+ * definition looked up by the caller. A string (max 2000 characters) or a
202
+ * plain object; anything else, or a throw, is ignored. Content API output
203
+ * (`?mex=`) and GraphQL `…Rendered` pass the results of the definitions'
204
+ * server-side `resolve`.
205
+ */
206
+ resolveAnnotation?: (annotation: {
207
+ name: string;
208
+ attrs: Record<string, string>;
209
+ text: string;
210
+ }) => string | Record<string, unknown> | null | undefined;
169
211
  }
170
212
 
213
+ /** Renders TeX: MathML markup or render nodes; null/undefined for the fallback. */
214
+ export type MathRenderer = (
215
+ tex: string,
216
+ options: { display: boolean }
217
+ ) => string | RenderNode | ReadonlyArray<RenderNode> | null | undefined;
218
+
171
219
  /** A synced block source: an Editor.js document or its block array. */
172
220
  export type SyncedSource = { blocks: ReadonlyArray<unknown> } | ReadonlyArray<unknown>;
173
221
  /** Sources of synced blocks by reference (the source's documentId). */
@@ -166,8 +166,56 @@ 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 };
189
+ /**
190
+ * Inline annotations (2.5, `defineInlineAnnotation` from `magic-editor-x/blocks`):
191
+ * `<span data-mex-annotation="name">` is rendered with the definition's
192
+ * `render` (one validated wrapper element around the text). These
193
+ * definitions replace the bundle's registry for that call; the built-in
194
+ * `abbreviation` (`<abbr title>`) is always known. Unknown annotations get
195
+ * `<span class="mex-annotation mex-annotation-<name>" data-mex-annotation …>`.
196
+ * Pass a stable array. Text and Markdown output keep the text only.
197
+ */
198
+ annotations?: ReadonlyArray<import('./blocks.js').InlineAnnotationDefinition>;
199
+ /**
200
+ * Value of an annotation for its `render` (`resolved`), e.g. a glossary
201
+ * definition looked up by the caller. A string (max 2000 characters) or a
202
+ * plain object; anything else, or a throw, is ignored. Content API output
203
+ * (`?mex=`) and GraphQL `…Rendered` pass the results of the definitions'
204
+ * server-side `resolve`.
205
+ */
206
+ resolveAnnotation?: (annotation: {
207
+ name: string;
208
+ attrs: Record<string, string>;
209
+ text: string;
210
+ }) => string | Record<string, unknown> | null | undefined;
169
211
  }
170
212
 
213
+ /** Renders TeX: MathML markup or render nodes; null/undefined for the fallback. */
214
+ export type MathRenderer = (
215
+ tex: string,
216
+ options: { display: boolean }
217
+ ) => string | RenderNode | ReadonlyArray<RenderNode> | null | undefined;
218
+
171
219
  /** A synced block source: an Editor.js document or its block array. */
172
220
  export type SyncedSource = { blocks: ReadonlyArray<unknown> } | ReadonlyArray<unknown>;
173
221
  /** Sources of synced blocks by reference (the source's documentId). */