magic-editor-x 2.2.0 → 2.3.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.
- package/CHANGELOG.md +72 -0
- package/README.md +493 -168
- package/dist/admin/{ConfigurationPage-3Dir3dAf.mjs → ConfigurationPage-BxLHIQdo.mjs} +450 -21
- package/dist/admin/{ConfigurationPage-YvnPnna6.js → ConfigurationPage-C-UktL1x.js} +479 -50
- package/dist/admin/ConfirmAction-DuQwvRYi.mjs +125 -0
- package/dist/admin/ConfirmAction-zLuIFj8t.js +124 -0
- package/dist/admin/{CustomBlocksPage-BiiL2ORG.js → CustomBlocksPage-CxcTfdOT.js} +135 -84
- package/dist/admin/{CustomBlocksPage-CR2BaP9O.mjs → CustomBlocksPage-D8aMbVXc.mjs} +92 -41
- package/dist/admin/DraftSync-BIA8cZgA.js +11 -0
- package/dist/admin/DraftSync-CUxOMG-E.mjs +12 -0
- package/dist/admin/TemplatesPage-Hn6gyu2l.js +993 -0
- package/dist/admin/TemplatesPage-jhYi6Zdf.mjs +993 -0
- package/dist/admin/{de-BmmLBJli.mjs → de-1cFMs-4c.mjs} +2 -0
- package/dist/admin/{de-BteRx2iA.js → de-2Ie5jy7j.js} +79 -1
- package/dist/admin/{de-62Vxb2iw.js → de-B1X46JJZ.js} +205 -2
- package/dist/admin/{de-CFX5atOk.mjs → de-BMY2LBaa.mjs} +79 -1
- package/dist/admin/{de-Bt6pYIWi.mjs → de-BUS1hUw0.mjs} +145 -0
- package/dist/admin/{de-CVbi685U.js → de-C3AsGauQ.js} +145 -0
- package/dist/admin/{de-BVvwSYYO.mjs → de-DOiGaTNX.mjs} +205 -2
- package/dist/admin/{de-DaJwN6nk.js → de-Dn8athM8.js} +2 -0
- package/dist/admin/{en-CyjAcccB.js → en-Ah-Cw0Wd.js} +79 -1
- package/dist/admin/{en-BX362fTp.js → en-BkEjpC3i.js} +145 -0
- package/dist/admin/{en-VlkaIzrM.js → en-CDg_18Bt.js} +205 -2
- package/dist/admin/{en-Cn78RZs-.js → en-CIZ5Ggod.js} +2 -0
- package/dist/admin/{en-Cg2Ak5Cr.mjs → en-CU6UzV4g.mjs} +205 -2
- package/dist/admin/{en-ea0tfA5i.mjs → en-CvFiqti2.mjs} +79 -1
- package/dist/admin/{en-D7mZWLGp.mjs → en-Dc9y-6n9.mjs} +2 -0
- package/dist/admin/{en-B_HltUxZ.mjs → en-GCzgS9Aw.mjs} +145 -0
- package/dist/admin/{es-BT9oAcHf.js → es-BCpJmUEM.js} +205 -2
- package/dist/admin/{es-C9-cXdb6.mjs → es-BmfffNM2.mjs} +205 -2
- package/dist/admin/{es-BmGtLkJD.js → es-C4IRHV5d.js} +2 -0
- package/dist/admin/{es-CHHEZi44.js → es-C4pEnDRv.js} +145 -0
- package/dist/admin/{es-C8GZFGjv.js → es-Cr8JH85N.js} +79 -1
- package/dist/admin/{es-joykG5I9.mjs → es-D2Kw6E4N.mjs} +2 -0
- package/dist/admin/{es-CrhwOq-5.mjs → es-DHBBZKl2.mjs} +145 -0
- package/dist/admin/{es-CEi_ycX8.mjs → es-DbKHZz5l.mjs} +79 -1
- package/dist/admin/{fr-CrzxGe5e.mjs → fr-BOvvfEH7.mjs} +2 -0
- package/dist/admin/{fr-B3SL0TBV.js → fr-C2aLSwEu.js} +145 -0
- package/dist/admin/{fr-BAMSvQbR.mjs → fr-DQJ_7aq5.mjs} +79 -1
- package/dist/admin/{fr-DpU_qiXR.mjs → fr-DZd2XJP6.mjs} +205 -2
- package/dist/admin/{fr-5djKfQ3s.mjs → fr-Dvq4xk2e.mjs} +145 -0
- package/dist/admin/{fr-oRCJNdeJ.js → fr-OJ4VW1kh.js} +79 -1
- package/dist/admin/{fr-D6KJqPWi.js → fr-ZcN0yM_2.js} +205 -2
- package/dist/admin/{fr-Ct_uPqxV.js → fr-Zkb8vfjN.js} +2 -0
- package/dist/admin/index-BHBRr562.js +1940 -0
- package/dist/admin/index-CQk1XeNb.mjs +1939 -0
- package/dist/admin/{EditorField-Diq1j8kc.js → index-Cm-fFUhE.js} +13704 -6766
- package/dist/admin/{EditorField-B8pyAxPE.mjs → index-XgfwqLfV.mjs} +10203 -3265
- package/dist/admin/index.js +1 -1
- package/dist/admin/index.mjs +2 -2
- package/dist/admin/{pt-chN2jrXl.js → pt-1IUyx6ae.js} +2 -0
- package/dist/admin/{pt-CQrfqsCN.mjs → pt-BSLzA17U.mjs} +79 -1
- package/dist/admin/{pt-jUqOR7Xh.mjs → pt-C3UdeIpd.mjs} +205 -2
- package/dist/admin/{pt-BOrl6x-r.js → pt-CImqDnLB.js} +205 -2
- package/dist/admin/{pt-BdnY2Cth.mjs → pt-CilDggGF.mjs} +145 -0
- package/dist/admin/{pt-tUeJ2Ywd.js → pt-D0I0_JYs.js} +79 -1
- package/dist/admin/{pt-EVwCuBUK.js → pt-DX0OAIoL.js} +145 -0
- package/dist/admin/{pt-Ga-4Hsv0.mjs → pt-etwsg3G4.mjs} +2 -0
- package/dist/admin/useBreakpoint-D30eNTkF.js +37 -0
- package/dist/admin/useBreakpoint-DCfn6pDG.mjs +38 -0
- package/dist/admin/useT-CmaeZbCr.mjs +65 -0
- package/dist/admin/{useT-BWZ_-Hel.js → useT-D3sM9Zf7.js} +4 -70
- package/dist/blocks/index.d.mts +167 -0
- package/dist/blocks/index.d.ts +167 -0
- package/dist/blocks/index.js +631 -0
- package/dist/blocks/index.mjs +609 -0
- package/dist/react/index.d.mts +39 -0
- package/dist/react/index.d.ts +39 -0
- package/dist/react/index.js +2687 -0
- package/dist/react/index.mjs +2657 -0
- package/dist/render/index.d.mts +131 -5
- package/dist/render/index.d.ts +131 -5
- package/dist/render/index.js +1679 -181
- package/dist/render/index.mjs +1679 -181
- package/dist/server/index.js +10645 -3716
- package/dist/server/index.mjs +10645 -3716
- package/dist/vue/index.d.mts +41 -0
- package/dist/vue/index.d.ts +41 -0
- package/dist/vue/index.js +2630 -0
- package/dist/vue/index.mjs +2610 -0
- package/package.json +30 -6
- package/schema/magic-editor-x.schema.json +540 -1
- package/types/blocks.d.ts +167 -0
- package/types/index.d.ts +127 -0
- package/types/react.d.ts +39 -0
- package/types/render.d.ts +131 -5
- package/types/vue.d.ts +41 -0
- package/dist/admin/api-Dsq53giv.js +0 -37
- package/dist/admin/api-RZ0Fz0BD.mjs +0 -38
- package/dist/admin/index-C-lyON1B.mjs +0 -303
- package/dist/admin/index-iA0lued_.js +0 -302
- package/dist/admin/sanitize-Cb4jvBhj.js +0 -628
- package/dist/admin/sanitize-ClkX823p.mjs +0 -627
- 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
|
+
}>;
|