magic-editor-x 2.2.0 → 2.3.1

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 (94) hide show
  1. package/CHANGELOG.md +85 -0
  2. package/README.md +493 -168
  3. package/dist/admin/{ConfigurationPage-YvnPnna6.js → ConfigurationPage-CFP3lp9p.js} +479 -50
  4. package/dist/admin/{ConfigurationPage-3Dir3dAf.mjs → ConfigurationPage-CYGDLjM7.mjs} +450 -21
  5. package/dist/admin/ConfirmAction-DuQwvRYi.mjs +125 -0
  6. package/dist/admin/ConfirmAction-zLuIFj8t.js +124 -0
  7. package/dist/admin/{CustomBlocksPage-CR2BaP9O.mjs → CustomBlocksPage-B5Q33N-s.mjs} +92 -41
  8. package/dist/admin/{CustomBlocksPage-BiiL2ORG.js → CustomBlocksPage-DzPOSpfn.js} +135 -84
  9. package/dist/admin/DraftSync-BIA8cZgA.js +11 -0
  10. package/dist/admin/DraftSync-CUxOMG-E.mjs +12 -0
  11. package/dist/admin/TemplatesPage-4A8JNO_Z.mjs +993 -0
  12. package/dist/admin/TemplatesPage-BVkgafCK.js +993 -0
  13. package/dist/admin/{de-BmmLBJli.mjs → de-1cFMs-4c.mjs} +2 -0
  14. package/dist/admin/{de-BteRx2iA.js → de-2Ie5jy7j.js} +79 -1
  15. package/dist/admin/{de-62Vxb2iw.js → de-B1X46JJZ.js} +205 -2
  16. package/dist/admin/{de-CFX5atOk.mjs → de-BMY2LBaa.mjs} +79 -1
  17. package/dist/admin/{de-Bt6pYIWi.mjs → de-BUS1hUw0.mjs} +145 -0
  18. package/dist/admin/{de-CVbi685U.js → de-C3AsGauQ.js} +145 -0
  19. package/dist/admin/{de-BVvwSYYO.mjs → de-DOiGaTNX.mjs} +205 -2
  20. package/dist/admin/{de-DaJwN6nk.js → de-Dn8athM8.js} +2 -0
  21. package/dist/admin/{en-CyjAcccB.js → en-Ah-Cw0Wd.js} +79 -1
  22. package/dist/admin/{en-BX362fTp.js → en-BkEjpC3i.js} +145 -0
  23. package/dist/admin/{en-VlkaIzrM.js → en-CDg_18Bt.js} +205 -2
  24. package/dist/admin/{en-Cn78RZs-.js → en-CIZ5Ggod.js} +2 -0
  25. package/dist/admin/{en-Cg2Ak5Cr.mjs → en-CU6UzV4g.mjs} +205 -2
  26. package/dist/admin/{en-ea0tfA5i.mjs → en-CvFiqti2.mjs} +79 -1
  27. package/dist/admin/{en-D7mZWLGp.mjs → en-Dc9y-6n9.mjs} +2 -0
  28. package/dist/admin/{en-B_HltUxZ.mjs → en-GCzgS9Aw.mjs} +145 -0
  29. package/dist/admin/{es-BT9oAcHf.js → es-BCpJmUEM.js} +205 -2
  30. package/dist/admin/{es-C9-cXdb6.mjs → es-BmfffNM2.mjs} +205 -2
  31. package/dist/admin/{es-BmGtLkJD.js → es-C4IRHV5d.js} +2 -0
  32. package/dist/admin/{es-CHHEZi44.js → es-C4pEnDRv.js} +145 -0
  33. package/dist/admin/{es-C8GZFGjv.js → es-Cr8JH85N.js} +79 -1
  34. package/dist/admin/{es-joykG5I9.mjs → es-D2Kw6E4N.mjs} +2 -0
  35. package/dist/admin/{es-CrhwOq-5.mjs → es-DHBBZKl2.mjs} +145 -0
  36. package/dist/admin/{es-CEi_ycX8.mjs → es-DbKHZz5l.mjs} +79 -1
  37. package/dist/admin/{fr-CrzxGe5e.mjs → fr-BOvvfEH7.mjs} +2 -0
  38. package/dist/admin/{fr-B3SL0TBV.js → fr-C2aLSwEu.js} +145 -0
  39. package/dist/admin/{fr-BAMSvQbR.mjs → fr-DQJ_7aq5.mjs} +79 -1
  40. package/dist/admin/{fr-DpU_qiXR.mjs → fr-DZd2XJP6.mjs} +205 -2
  41. package/dist/admin/{fr-5djKfQ3s.mjs → fr-Dvq4xk2e.mjs} +145 -0
  42. package/dist/admin/{fr-oRCJNdeJ.js → fr-OJ4VW1kh.js} +79 -1
  43. package/dist/admin/{fr-D6KJqPWi.js → fr-ZcN0yM_2.js} +205 -2
  44. package/dist/admin/{fr-Ct_uPqxV.js → fr-Zkb8vfjN.js} +2 -0
  45. package/dist/admin/{EditorField-Diq1j8kc.js → index-DQVE0ymw.js} +13712 -6767
  46. package/dist/admin/index-DR8sHkTk.js +1940 -0
  47. package/dist/admin/index-My6FjjHB.mjs +1939 -0
  48. package/dist/admin/{EditorField-B8pyAxPE.mjs → index-k8_a5o1A.mjs} +10223 -3278
  49. package/dist/admin/index.js +1 -1
  50. package/dist/admin/index.mjs +2 -2
  51. package/dist/admin/{pt-chN2jrXl.js → pt-1IUyx6ae.js} +2 -0
  52. package/dist/admin/{pt-CQrfqsCN.mjs → pt-BSLzA17U.mjs} +79 -1
  53. package/dist/admin/{pt-jUqOR7Xh.mjs → pt-C3UdeIpd.mjs} +205 -2
  54. package/dist/admin/{pt-BOrl6x-r.js → pt-CImqDnLB.js} +205 -2
  55. package/dist/admin/{pt-BdnY2Cth.mjs → pt-CilDggGF.mjs} +145 -0
  56. package/dist/admin/{pt-tUeJ2Ywd.js → pt-D0I0_JYs.js} +79 -1
  57. package/dist/admin/{pt-EVwCuBUK.js → pt-DX0OAIoL.js} +145 -0
  58. package/dist/admin/{pt-Ga-4Hsv0.mjs → pt-etwsg3G4.mjs} +2 -0
  59. package/dist/admin/useBreakpoint-D30eNTkF.js +37 -0
  60. package/dist/admin/useBreakpoint-DCfn6pDG.mjs +38 -0
  61. package/dist/admin/useT-Cmg1jwwG.mjs +65 -0
  62. package/dist/admin/{useT-BWZ_-Hel.js → useT-DNphiBQR.js} +4 -70
  63. package/dist/blocks/index.d.mts +167 -0
  64. package/dist/blocks/index.d.ts +167 -0
  65. package/dist/blocks/index.js +631 -0
  66. package/dist/blocks/index.mjs +609 -0
  67. package/dist/react/index.d.mts +39 -0
  68. package/dist/react/index.d.ts +39 -0
  69. package/dist/react/index.js +2687 -0
  70. package/dist/react/index.mjs +2657 -0
  71. package/dist/render/index.d.mts +131 -5
  72. package/dist/render/index.d.ts +131 -5
  73. package/dist/render/index.js +1679 -181
  74. package/dist/render/index.mjs +1679 -181
  75. package/dist/server/index.js +10645 -3716
  76. package/dist/server/index.mjs +10645 -3716
  77. package/dist/vue/index.d.mts +41 -0
  78. package/dist/vue/index.d.ts +41 -0
  79. package/dist/vue/index.js +2630 -0
  80. package/dist/vue/index.mjs +2610 -0
  81. package/package.json +30 -6
  82. package/schema/magic-editor-x.schema.json +540 -1
  83. package/types/blocks.d.ts +167 -0
  84. package/types/index.d.ts +127 -0
  85. package/types/react.d.ts +39 -0
  86. package/types/render.d.ts +131 -5
  87. package/types/vue.d.ts +41 -0
  88. package/dist/admin/api-Dsq53giv.js +0 -37
  89. package/dist/admin/api-RZ0Fz0BD.mjs +0 -38
  90. package/dist/admin/index-C-lyON1B.mjs +0 -303
  91. package/dist/admin/index-iA0lued_.js +0 -302
  92. package/dist/admin/sanitize-Cb4jvBhj.js +0 -628
  93. package/dist/admin/sanitize-ClkX823p.mjs +0 -627
  94. package/dist/admin/useT-pvHmgBFj.mjs +0 -131
@@ -0,0 +1,167 @@
1
+ /**
2
+ * Custom block SDK (`magic-editor-x/blocks`): one definition per block type
3
+ * for the server, the admin editor tool and the renderers.
4
+ */
5
+
6
+ import type { HtmlHelpers, RenderNode, RenderBlock } from '../render/index.js';
7
+
8
+ export type BlockFieldType = 'text' | 'inline' | 'url' | 'enum' | 'number' | 'boolean' | 'array' | 'object';
9
+
10
+ interface FieldBase {
11
+ /** Human-readable name (JSON Schema `title`, at most 100 characters). */
12
+ label?: string;
13
+ }
14
+ /** Plain text, cut to `max` (default 1000, at most 100000). Rendering escapes it. */
15
+ export interface TextField extends FieldBase {
16
+ type: 'text';
17
+ max?: number;
18
+ multiline?: boolean;
19
+ default?: string;
20
+ }
21
+ /** Inline HTML through the shared inline policy (input cut to `max`, default 10000). */
22
+ export interface InlineField extends FieldBase {
23
+ type: 'inline';
24
+ max?: number;
25
+ default?: string;
26
+ }
27
+ /** URL checked with `sanitizeUrl` (`schemes` default http/https, site-relative allowed unless `relative: false`); '' when not allowed. */
28
+ export interface UrlField extends FieldBase {
29
+ type: 'url';
30
+ schemes?: Array<'http' | 'https' | 'mailto' | 'tel'>;
31
+ relative?: boolean;
32
+ }
33
+ /** One of `values` (1 to 100 strings); invalid values become `default` (first value). */
34
+ export interface EnumField<V extends string = string> extends FieldBase {
35
+ type: 'enum';
36
+ values: readonly V[];
37
+ default?: V;
38
+ }
39
+ /** Finite number in `min..max`; invalid values become `default` (the key is omitted without one). */
40
+ export interface NumberField extends FieldBase {
41
+ type: 'number';
42
+ min?: number;
43
+ max?: number;
44
+ integer?: boolean;
45
+ default?: number;
46
+ }
47
+ export interface BooleanField extends FieldBase {
48
+ type: 'boolean';
49
+ default?: boolean;
50
+ }
51
+ /** At most `max` items (default 50, at most 500); items of another type are dropped. */
52
+ export interface ArrayField extends FieldBase {
53
+ type: 'array';
54
+ items: BlockField;
55
+ max?: number;
56
+ }
57
+ export interface ObjectField extends FieldBase {
58
+ type: 'object';
59
+ fields: BlockSchema;
60
+ }
61
+ export type BlockField =
62
+ TextField | InlineField | UrlField | EnumField | NumberField | BooleanField | ArrayField | ObjectField;
63
+
64
+ /** Field descriptors by key (1 to 50 keys matching `/^[A-Za-z][A-Za-z0-9_]{0,63}$/`, nesting at most 4 levels). */
65
+ export type BlockSchema = Record<string, BlockField>;
66
+
67
+ /** Stored value type of one field. */
68
+ export type FieldValue<F> =
69
+ F extends EnumField<infer V>
70
+ ? V
71
+ : F extends TextField | InlineField | UrlField
72
+ ? string
73
+ : F extends NumberField
74
+ ? number
75
+ : F extends BooleanField
76
+ ? boolean
77
+ : F extends ArrayField
78
+ ? Array<FieldValue<F['items']>>
79
+ : F extends ObjectField
80
+ ? BlockData<F['fields']>
81
+ : unknown;
82
+
83
+ /** Stored `data` of a block with this schema (numbers without a default may be missing). */
84
+ export type BlockData<S extends BlockSchema> = { [K in keyof S]: FieldValue<S[K]> };
85
+
86
+ export interface BlockTextHelpers {
87
+ /** Plain text of inline HTML. */
88
+ text(html: unknown): string;
89
+ }
90
+ export interface BlockMarkdownHelpers extends BlockTextHelpers {
91
+ /** Escapes Markdown punctuation. */
92
+ escape(text: unknown): string;
93
+ /** Markdown of inline HTML (links resolved with `options.links`). */
94
+ inline(html: unknown): string;
95
+ }
96
+
97
+ export interface BlockDefinitionInput<S extends BlockSchema = BlockSchema> {
98
+ /** Block type: `/^[A-Za-z][A-Za-z0-9_-]{1,49}$/`, not a built-in tool name (`RESERVED_BLOCK_NAMES`). */
99
+ name: string;
100
+ /** Integer 1 to 1000000 (default 1); shown in Settings > Custom blocks. */
101
+ version?: number;
102
+ title?: string;
103
+ description?: string;
104
+ schema: S;
105
+ /** Extra cleaning after the schema; its result is cleaned by the schema again. A throw keeps the schema-clean data. */
106
+ sanitize?: (
107
+ data: BlockData<S>,
108
+ helpers: {
109
+ sanitizeUrl(value: unknown, options?: { schemes?: string[]; allowRelative?: boolean }): string;
110
+ }
111
+ ) => BlockData<S>;
112
+ /** Plain text (renderText, search snippets); default: text and inline fields, one per line. */
113
+ text?: (data: BlockData<S>, helpers: BlockTextHelpers) => string;
114
+ /** Markdown (renderMarkdown); escape what you output. Default: text and inline fields as paragraphs. */
115
+ markdown?: (data: BlockData<S>, helpers: BlockMarkdownHelpers) => string;
116
+ /**
117
+ * Render-tree output (HTML, React, Vue): return nodes made with `helpers.h`,
118
+ * `helpers.textNode`, `helpers.inlineNodes` (validated like overrides), `[]`
119
+ * for nothing, or null/undefined for the default rendering. A string is used
120
+ * only with `rawHtml: 'allow'` + `sanitizeRaw`.
121
+ */
122
+ render?: (
123
+ block: RenderBlock & { data: BlockData<S> },
124
+ helpers: HtmlHelpers
125
+ ) => RenderNode | Array<RenderNode | string> | string | null | undefined;
126
+ /** Named presets that include the block (`full` always does). */
127
+ presets?: Array<'article' | 'basic' | 'minimal'>;
128
+ }
129
+
130
+ export type BlockDefinition<S extends BlockSchema = BlockSchema> = Readonly<
131
+ Omit<BlockDefinitionInput<S>, 'version' | 'presets'> & {
132
+ version: number;
133
+ presets: ReadonlyArray<'article' | 'basic' | 'minimal'>;
134
+ }
135
+ >;
136
+
137
+ /** Validates and freezes a definition; throws `BlockDefinitionError` with a clear message. */
138
+ export function defineBlock<const S extends BlockSchema>(
139
+ definition: BlockDefinitionInput<S>
140
+ ): BlockDefinition<S>;
141
+ /** JSON Schema (2020-12) of the block's stored `data`. */
142
+ export function blockJsonSchema(
143
+ definition: BlockDefinition<any> | BlockDefinitionInput<any>
144
+ ): Record<string, unknown>;
145
+ /** Problem with a block name, or null when it can be used. */
146
+ export function blockNameProblem(name: unknown): string | null;
147
+
148
+ export class BlockDefinitionError extends Error {
149
+ name: 'BlockDefinitionError';
150
+ code: 'INVALID_DEFINITION' | 'RESERVED_NAME' | 'NAME_TAKEN' | 'REGISTRY_SEALED';
151
+ }
152
+
153
+ export const BLOCK_FIELD_TYPES: readonly BlockFieldType[];
154
+ export const BLOCK_PRESETS: readonly ['article', 'basic', 'minimal'];
155
+ export const RESERVED_BLOCK_NAMES: readonly string[];
156
+ export const BLOCK_LIMITS: Readonly<{
157
+ maxFields: number;
158
+ maxDepth: number;
159
+ maxText: number;
160
+ defaultText: number;
161
+ defaultInline: number;
162
+ maxItems: number;
163
+ defaultItems: number;
164
+ maxEnumValues: number;
165
+ maxValues: number;
166
+ maxUrl: number;
167
+ }>;