@aruzone/aze-forge 0.1.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/LICENSE +21 -0
- package/README.md +408 -0
- package/dist/acceptance.d.ts +48 -0
- package/dist/acceptance.js +180 -0
- package/dist/acceptance.js.map +1 -0
- package/dist/assets.d.ts +19 -0
- package/dist/assets.js +509 -0
- package/dist/assets.js.map +1 -0
- package/dist/atomic-write.d.ts +1 -0
- package/dist/atomic-write.js +23 -0
- package/dist/atomic-write.js.map +1 -0
- package/dist/callout.d.ts +27 -0
- package/dist/callout.js +78 -0
- package/dist/callout.js.map +1 -0
- package/dist/capabilities-json.d.ts +4 -0
- package/dist/capabilities-json.js +225 -0
- package/dist/capabilities-json.js.map +1 -0
- package/dist/capabilities.d.ts +110 -0
- package/dist/capabilities.js +270 -0
- package/dist/capabilities.js.map +1 -0
- package/dist/cli.d.ts +2 -0
- package/dist/cli.js +1096 -0
- package/dist/cli.js.map +1 -0
- package/dist/compiler.d.ts +3 -0
- package/dist/compiler.js +1034 -0
- package/dist/compiler.js.map +1 -0
- package/dist/configuration-error.d.ts +4 -0
- package/dist/configuration-error.js +9 -0
- package/dist/configuration-error.js.map +1 -0
- package/dist/diagnostics-json.d.ts +23 -0
- package/dist/diagnostics-json.js +143 -0
- package/dist/diagnostics-json.js.map +1 -0
- package/dist/diagnostics.d.ts +16 -0
- package/dist/diagnostics.js +154 -0
- package/dist/diagnostics.js.map +1 -0
- package/dist/equation.d.ts +74 -0
- package/dist/equation.js +485 -0
- package/dist/equation.js.map +1 -0
- package/dist/font.d.ts +19 -0
- package/dist/font.js +75 -0
- package/dist/font.js.map +1 -0
- package/dist/format.d.ts +2 -0
- package/dist/format.js +308 -0
- package/dist/format.js.map +1 -0
- package/dist/hash.d.ts +5 -0
- package/dist/hash.js +189 -0
- package/dist/hash.js.map +1 -0
- package/dist/help.d.ts +9 -0
- package/dist/help.js +102 -0
- package/dist/help.js.map +1 -0
- package/dist/html-fragment.d.ts +7 -0
- package/dist/html-fragment.js +70 -0
- package/dist/html-fragment.js.map +1 -0
- package/dist/index.d.ts +39 -0
- package/dist/index.js +32 -0
- package/dist/index.js.map +1 -0
- package/dist/markdown.d.ts +14 -0
- package/dist/markdown.js +425 -0
- package/dist/markdown.js.map +1 -0
- package/dist/mermaid-browser.d.ts +43 -0
- package/dist/mermaid-browser.js +358 -0
- package/dist/mermaid-browser.js.map +1 -0
- package/dist/mermaid.d.ts +84 -0
- package/dist/mermaid.js +740 -0
- package/dist/mermaid.js.map +1 -0
- package/dist/model.d.ts +406 -0
- package/dist/model.js +2 -0
- package/dist/model.js.map +1 -0
- package/dist/parse.d.ts +3 -0
- package/dist/parse.js +1374 -0
- package/dist/parse.js.map +1 -0
- package/dist/preview-server.d.ts +39 -0
- package/dist/preview-server.js +156 -0
- package/dist/preview-server.js.map +1 -0
- package/dist/preview-shell.d.ts +29 -0
- package/dist/preview-shell.js +102 -0
- package/dist/preview-shell.js.map +1 -0
- package/dist/reference-validation.d.ts +7 -0
- package/dist/reference-validation.js +42 -0
- package/dist/reference-validation.js.map +1 -0
- package/dist/registry.d.ts +29 -0
- package/dist/registry.js +384 -0
- package/dist/registry.js.map +1 -0
- package/dist/render-html.d.ts +24 -0
- package/dist/render-html.js +149 -0
- package/dist/render-html.js.map +1 -0
- package/dist/render-pdf.d.ts +64 -0
- package/dist/render-pdf.js +503 -0
- package/dist/render-pdf.js.map +1 -0
- package/dist/render-png.d.ts +32 -0
- package/dist/render-png.js +427 -0
- package/dist/render-png.js.map +1 -0
- package/dist/render-svg.d.ts +23 -0
- package/dist/render-svg.js +243 -0
- package/dist/render-svg.js.map +1 -0
- package/dist/runtime-support.d.ts +26 -0
- package/dist/runtime-support.js +62 -0
- package/dist/runtime-support.js.map +1 -0
- package/dist/source-map.d.ts +12 -0
- package/dist/source-map.js +75 -0
- package/dist/source-map.js.map +1 -0
- package/dist/table.d.ts +22 -0
- package/dist/table.js +90 -0
- package/dist/table.js.map +1 -0
- package/dist/theme.d.ts +6 -0
- package/dist/theme.js +89 -0
- package/dist/theme.js.map +1 -0
- package/dist/tool-version.d.ts +3 -0
- package/dist/tool-version.js +3 -0
- package/dist/tool-version.js.map +1 -0
- package/dist/type-guards.d.ts +1 -0
- package/dist/type-guards.js +4 -0
- package/dist/type-guards.js.map +1 -0
- package/dist/validate-document.d.ts +2 -0
- package/dist/validate-document.js +248 -0
- package/dist/validate-document.js.map +1 -0
- package/dist/version.d.ts +37 -0
- package/dist/version.js +111 -0
- package/dist/version.js.map +1 -0
- package/dist/watch-dependencies.d.ts +15 -0
- package/dist/watch-dependencies.js +93 -0
- package/dist/watch-dependencies.js.map +1 -0
- package/dist/watch-events.d.ts +51 -0
- package/dist/watch-events.js +27 -0
- package/dist/watch-events.js.map +1 -0
- package/dist/watch-loop.d.ts +39 -0
- package/dist/watch-loop.js +117 -0
- package/dist/watch-loop.js.map +1 -0
- package/package.json +70 -0
- package/schemas/acceptance.json +104 -0
- package/schemas/capabilities.json +491 -0
- package/schemas/diagnostics.json +219 -0
- package/schemas/version.json +167 -0
package/dist/registry.js
ADDED
|
@@ -0,0 +1,384 @@
|
|
|
1
|
+
import { calloutHtmlBlockRenderer, calloutPlugin } from "./callout.js";
|
|
2
|
+
import { CompilerConfigurationError } from "./configuration-error.js";
|
|
3
|
+
import { equationHtmlBlockRenderer, equationPlugin, htmlRendererDescriptor, } from "./equation.js";
|
|
4
|
+
import { tableHtmlBlockRenderer, tablePlugin } from "./table.js";
|
|
5
|
+
import { mermaidHtmlBlockRenderer, mermaidPlugin, } from "./mermaid.js";
|
|
6
|
+
import { svgBlockRenderers, svgRendererDescriptor, } from "./render-svg.js";
|
|
7
|
+
import { pdfBlockRenderers, pdfRendererDescriptor, } from "./render-pdf.js";
|
|
8
|
+
import { pngBlockRenderers, pngRendererDescriptor, } from "./render-png.js";
|
|
9
|
+
export const REGISTRY_CONFORMANCE_SEAM_VERSION = "1.0.0";
|
|
10
|
+
const SEMVER = /^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)$/;
|
|
11
|
+
const PLUGIN_TYPE = /^(?:@[a-z0-9-]+(?:\/[a-z][a-z0-9-]*)?|[a-z][a-z0-9]*(?:-[a-z0-9]+)*)$/;
|
|
12
|
+
const ADAPTER_ID = /^(?:@[a-z0-9-]+(?:\/[a-z][a-z0-9-.]*)?|[a-z][a-z0-9]*(?:[.-][a-z0-9]+)*(?:\/[a-z0-9]+(?:[.-][a-z0-9]+)*)?)$/;
|
|
13
|
+
const RENDERER_CAPABILITY = {
|
|
14
|
+
browser: true,
|
|
15
|
+
filesystem: true,
|
|
16
|
+
subprocess: true,
|
|
17
|
+
};
|
|
18
|
+
const NAMESPACE = /^[a-z][a-z0-9]*(?:\.[a-z][a-z0-9]*)*$/;
|
|
19
|
+
export function getBuiltInRegistry() {
|
|
20
|
+
return Object.freeze({
|
|
21
|
+
plugins: Object.freeze([
|
|
22
|
+
equationPlugin,
|
|
23
|
+
calloutPlugin,
|
|
24
|
+
mermaidPlugin,
|
|
25
|
+
tablePlugin,
|
|
26
|
+
]),
|
|
27
|
+
blockRenderers: Object.freeze([
|
|
28
|
+
equationHtmlBlockRenderer,
|
|
29
|
+
calloutHtmlBlockRenderer,
|
|
30
|
+
mermaidHtmlBlockRenderer,
|
|
31
|
+
tableHtmlBlockRenderer,
|
|
32
|
+
...svgBlockRenderers,
|
|
33
|
+
...pngBlockRenderers,
|
|
34
|
+
...pdfBlockRenderers,
|
|
35
|
+
]),
|
|
36
|
+
renderers: Object.freeze([
|
|
37
|
+
htmlRendererDescriptor,
|
|
38
|
+
svgRendererDescriptor,
|
|
39
|
+
pngRendererDescriptor,
|
|
40
|
+
pdfRendererDescriptor,
|
|
41
|
+
]),
|
|
42
|
+
});
|
|
43
|
+
}
|
|
44
|
+
export function satisfiesSemverRange(version, range) {
|
|
45
|
+
const trimmed = range.trim();
|
|
46
|
+
if (trimmed === version)
|
|
47
|
+
return true;
|
|
48
|
+
const caret = /^\^(\d+)\.(\d+)\.(\d+)$/.exec(trimmed);
|
|
49
|
+
const current = /^(\d+)\.(\d+)\.(\d+)$/.exec(version);
|
|
50
|
+
if (caret === null || current === null)
|
|
51
|
+
return false;
|
|
52
|
+
const base = [caret[1], caret[2], caret[3]].map(Number);
|
|
53
|
+
const mine = [current[1], current[2], current[3]].map(Number);
|
|
54
|
+
const atLeastBase = mine[0] !== base[0]
|
|
55
|
+
? (mine[0] ?? 0) > (base[0] ?? 0)
|
|
56
|
+
: mine[1] !== base[1]
|
|
57
|
+
? (mine[1] ?? 0) > (base[1] ?? 0)
|
|
58
|
+
: (mine[2] ?? 0) >= (base[2] ?? 0);
|
|
59
|
+
if (!atLeastBase)
|
|
60
|
+
return false;
|
|
61
|
+
if (base[0] !== 0)
|
|
62
|
+
return mine[0] === base[0];
|
|
63
|
+
if (base[1] !== 0)
|
|
64
|
+
return mine[0] === 0 && mine[1] === base[1];
|
|
65
|
+
return mine[0] === 0 && mine[1] === 0 && mine[2] === base[2];
|
|
66
|
+
}
|
|
67
|
+
export function isWellFormedVersionRange(range) {
|
|
68
|
+
const trimmed = range.trim();
|
|
69
|
+
if (SEMVER.test(trimmed))
|
|
70
|
+
return true;
|
|
71
|
+
return /^\^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)$/.test(trimmed);
|
|
72
|
+
}
|
|
73
|
+
function rangeBaseVersion(range) {
|
|
74
|
+
const trimmed = range.trim();
|
|
75
|
+
if (trimmed.startsWith("^"))
|
|
76
|
+
return trimmed.slice(1);
|
|
77
|
+
return trimmed;
|
|
78
|
+
}
|
|
79
|
+
function versionRangesOverlap(first, second) {
|
|
80
|
+
return (satisfiesSemverRange(rangeBaseVersion(first), second) ||
|
|
81
|
+
satisfiesSemverRange(rangeBaseVersion(second), first));
|
|
82
|
+
}
|
|
83
|
+
function isSchemaObject(value) {
|
|
84
|
+
if (typeof value !== "object" || value === null || Array.isArray(value)) {
|
|
85
|
+
return false;
|
|
86
|
+
}
|
|
87
|
+
if (!("$id" in value) || !("type" in value))
|
|
88
|
+
return false;
|
|
89
|
+
return (typeof value.$id === "string" &&
|
|
90
|
+
value.$id.length > 0 &&
|
|
91
|
+
value.type === "object");
|
|
92
|
+
}
|
|
93
|
+
export function validateRegistry(plugins, blockRenderers, renderers) {
|
|
94
|
+
const violations = [];
|
|
95
|
+
const sortedPlugins = [...plugins].sort((a, b) => a.descriptor.type < b.descriptor.type ? -1 : 1);
|
|
96
|
+
const seenTypes = new Set();
|
|
97
|
+
const seenNamespaces = new Set();
|
|
98
|
+
for (const plugin of sortedPlugins) {
|
|
99
|
+
const d = plugin.descriptor;
|
|
100
|
+
const key = `plugin:${d.type}`;
|
|
101
|
+
if (!PLUGIN_TYPE.test(d.type)) {
|
|
102
|
+
violations.push({
|
|
103
|
+
key,
|
|
104
|
+
code: "azeforge.config#invalid-plugin-type",
|
|
105
|
+
message: `Plugin type "${d.type}" is not a valid Plugin identity.`,
|
|
106
|
+
});
|
|
107
|
+
}
|
|
108
|
+
if (!SEMVER.test(d.version)) {
|
|
109
|
+
violations.push({
|
|
110
|
+
key: `${key}:version`,
|
|
111
|
+
code: "azeforge.config#invalid-plugin-version",
|
|
112
|
+
message: `Plugin "${d.type}" version "${d.version}" is not SemVer.`,
|
|
113
|
+
});
|
|
114
|
+
}
|
|
115
|
+
if (seenTypes.has(d.type)) {
|
|
116
|
+
violations.push({
|
|
117
|
+
key,
|
|
118
|
+
code: "azeforge.config#duplicate-plugin",
|
|
119
|
+
message: `Plugin type "${d.type}" is registered more than once.`,
|
|
120
|
+
});
|
|
121
|
+
}
|
|
122
|
+
seenTypes.add(d.type);
|
|
123
|
+
if (!NAMESPACE.test(d.diagnosticNamespace)) {
|
|
124
|
+
violations.push({
|
|
125
|
+
key: `${key}:namespace`,
|
|
126
|
+
code: "azeforge.config#invalid-namespace",
|
|
127
|
+
message: `Plugin "${d.type}" namespace is malformed.`,
|
|
128
|
+
});
|
|
129
|
+
}
|
|
130
|
+
else if (seenNamespaces.has(d.diagnosticNamespace)) {
|
|
131
|
+
violations.push({
|
|
132
|
+
key: `${key}:namespace`,
|
|
133
|
+
code: "azeforge.config#duplicate-namespace",
|
|
134
|
+
message: `Diagnostic namespace "${d.diagnosticNamespace}" is registered more than once.`,
|
|
135
|
+
});
|
|
136
|
+
}
|
|
137
|
+
else {
|
|
138
|
+
seenNamespaces.add(d.diagnosticNamespace);
|
|
139
|
+
}
|
|
140
|
+
if (!isSchemaObject(d.sourceSchema)) {
|
|
141
|
+
violations.push({
|
|
142
|
+
key: `${key}:source-schema`,
|
|
143
|
+
code: "azeforge.config#invalid-schema",
|
|
144
|
+
message: `Plugin "${d.type}" sourceSchema is not a valid JSON Schema.`,
|
|
145
|
+
});
|
|
146
|
+
}
|
|
147
|
+
if (!isSchemaObject(d.dataSchema)) {
|
|
148
|
+
violations.push({
|
|
149
|
+
key: `${key}:data-schema`,
|
|
150
|
+
code: "azeforge.config#invalid-schema",
|
|
151
|
+
message: `Plugin "${d.type}" dataSchema is not a valid JSON Schema.`,
|
|
152
|
+
});
|
|
153
|
+
}
|
|
154
|
+
if (typeof d.bodySyntax?.id !== "string" ||
|
|
155
|
+
d.bodySyntax.id.length === 0 ||
|
|
156
|
+
typeof d.bodySyntax?.version !== "string" ||
|
|
157
|
+
!SEMVER.test(d.bodySyntax.version)) {
|
|
158
|
+
violations.push({
|
|
159
|
+
key: `${key}:body-syntax`,
|
|
160
|
+
code: "azeforge.config#invalid-schema",
|
|
161
|
+
message: `Plugin "${d.type}" bodySyntax identity is invalid.`,
|
|
162
|
+
});
|
|
163
|
+
}
|
|
164
|
+
}
|
|
165
|
+
const sortedRenderers = [...renderers].sort((a, b) => a.id === b.id
|
|
166
|
+
? a.version < b.version
|
|
167
|
+
? -1
|
|
168
|
+
: 1
|
|
169
|
+
: a.id < b.id
|
|
170
|
+
? -1
|
|
171
|
+
: 1);
|
|
172
|
+
const seenRendererKeys = new Set();
|
|
173
|
+
const formatOwners = new Map();
|
|
174
|
+
for (const renderer of sortedRenderers) {
|
|
175
|
+
const key = `renderer:${renderer.id}@${renderer.version}`;
|
|
176
|
+
if (!ADAPTER_ID.test(renderer.id)) {
|
|
177
|
+
violations.push({
|
|
178
|
+
key,
|
|
179
|
+
code: "azeforge.config#invalid-renderer-id",
|
|
180
|
+
message: `Renderer ID "${renderer.id}" is invalid.`,
|
|
181
|
+
});
|
|
182
|
+
}
|
|
183
|
+
if (!SEMVER.test(renderer.version)) {
|
|
184
|
+
violations.push({
|
|
185
|
+
key,
|
|
186
|
+
code: "azeforge.config#invalid-renderer-version",
|
|
187
|
+
message: `Renderer "${renderer.id}" version is not SemVer.`,
|
|
188
|
+
});
|
|
189
|
+
}
|
|
190
|
+
if (seenRendererKeys.has(key)) {
|
|
191
|
+
violations.push({
|
|
192
|
+
key,
|
|
193
|
+
code: "azeforge.config#duplicate-renderer",
|
|
194
|
+
message: `Renderer "${renderer.id}@${renderer.version}" is registered more than once.`,
|
|
195
|
+
});
|
|
196
|
+
}
|
|
197
|
+
seenRendererKeys.add(key);
|
|
198
|
+
if (!Array.isArray(renderer.capabilities) ||
|
|
199
|
+
renderer.capabilities.some((capability, index) => RENDERER_CAPABILITY[capability] !== true ||
|
|
200
|
+
renderer.capabilities.indexOf(capability) !== index)) {
|
|
201
|
+
violations.push({
|
|
202
|
+
key: `${key}:capabilities`,
|
|
203
|
+
code: "azeforge.config#invalid-renderer-capability",
|
|
204
|
+
message: `Renderer "${renderer.id}" has invalid capability declarations.`,
|
|
205
|
+
});
|
|
206
|
+
}
|
|
207
|
+
for (const format of renderer.formats) {
|
|
208
|
+
const owner = formatOwners.get(format);
|
|
209
|
+
if (owner !== undefined && owner !== renderer.id) {
|
|
210
|
+
violations.push({
|
|
211
|
+
key: `renderer-format:${format}`,
|
|
212
|
+
code: "azeforge.config#ambiguous-renderer",
|
|
213
|
+
message: `Artifact format "${format}" maps to more than one Renderer.`,
|
|
214
|
+
});
|
|
215
|
+
}
|
|
216
|
+
else {
|
|
217
|
+
formatOwners.set(format, renderer.id);
|
|
218
|
+
}
|
|
219
|
+
}
|
|
220
|
+
}
|
|
221
|
+
const pluginByType = new Map(plugins.map((plugin) => [plugin.descriptor.type, plugin.descriptor]));
|
|
222
|
+
const rendererById = new Map(renderers.map((r) => [r.id, r]));
|
|
223
|
+
const sortedBlockRenderers = [...blockRenderers].sort((a, b) => a.descriptor.id < b.descriptor.id ? -1 : 1);
|
|
224
|
+
const seenBlockRendererIds = new Set();
|
|
225
|
+
const seenMatches = new Map();
|
|
226
|
+
for (const blockRenderer of sortedBlockRenderers) {
|
|
227
|
+
const d = blockRenderer.descriptor;
|
|
228
|
+
const key = `block-renderer:${d.id}`;
|
|
229
|
+
if (!ADAPTER_ID.test(d.id)) {
|
|
230
|
+
violations.push({
|
|
231
|
+
key,
|
|
232
|
+
code: "azeforge.config#invalid-block-renderer-id",
|
|
233
|
+
message: `Block-renderer ID "${d.id}" is invalid.`,
|
|
234
|
+
});
|
|
235
|
+
}
|
|
236
|
+
if (!SEMVER.test(d.version)) {
|
|
237
|
+
violations.push({
|
|
238
|
+
key: `${key}:version`,
|
|
239
|
+
code: "azeforge.config#invalid-block-renderer-version",
|
|
240
|
+
message: `Block renderer "${d.id}" version is not SemVer.`,
|
|
241
|
+
});
|
|
242
|
+
}
|
|
243
|
+
if (seenBlockRendererIds.has(d.id)) {
|
|
244
|
+
violations.push({
|
|
245
|
+
key,
|
|
246
|
+
code: "azeforge.config#duplicate-block-renderer",
|
|
247
|
+
message: `Block renderer "${d.id}" is registered more than once.`,
|
|
248
|
+
});
|
|
249
|
+
}
|
|
250
|
+
seenBlockRendererIds.add(d.id);
|
|
251
|
+
if (!pluginByType.has(d.blockType)) {
|
|
252
|
+
violations.push({
|
|
253
|
+
key: `${key}:block-type`,
|
|
254
|
+
code: "azeforge.config#unknown-block-type",
|
|
255
|
+
message: `Block renderer "${d.id}" targets unknown Block type "${d.blockType}".`,
|
|
256
|
+
});
|
|
257
|
+
}
|
|
258
|
+
if (!rendererById.has(d.rendererId)) {
|
|
259
|
+
violations.push({
|
|
260
|
+
key: `${key}:renderer`,
|
|
261
|
+
code: "azeforge.config#unknown-renderer",
|
|
262
|
+
message: `Block renderer "${d.id}" targets unknown Renderer "${d.rendererId}".`,
|
|
263
|
+
});
|
|
264
|
+
}
|
|
265
|
+
if (!isWellFormedVersionRange(d.pluginVersionRange) ||
|
|
266
|
+
!isWellFormedVersionRange(d.rendererVersionRange)) {
|
|
267
|
+
violations.push({
|
|
268
|
+
key: `${key}:range`,
|
|
269
|
+
code: "azeforge.config#invalid-compatibility-range",
|
|
270
|
+
message: `Block renderer "${d.id}" declares an invalid compatibility range.`,
|
|
271
|
+
});
|
|
272
|
+
}
|
|
273
|
+
const matchKey = `${d.blockType}::${d.rendererId}`;
|
|
274
|
+
const previous = seenMatches.get(matchKey) ?? [];
|
|
275
|
+
if (previous.some((range) => versionRangesOverlap(range, d.pluginVersionRange))) {
|
|
276
|
+
violations.push({
|
|
277
|
+
key: `${key}:overlap`,
|
|
278
|
+
code: "azeforge.config#overlapping-block-renderer",
|
|
279
|
+
message: `Block renderer "${d.id}" overlaps for Block type "${d.blockType}".`,
|
|
280
|
+
});
|
|
281
|
+
}
|
|
282
|
+
seenMatches.set(matchKey, [...previous, d.pluginVersionRange]);
|
|
283
|
+
if (typeof blockRenderer.render !== "function") {
|
|
284
|
+
violations.push({
|
|
285
|
+
key: `${key}:implementation`,
|
|
286
|
+
code: "azeforge.config#invalid-block-renderer",
|
|
287
|
+
message: `Block renderer "${d.id}" has no render implementation.`,
|
|
288
|
+
});
|
|
289
|
+
}
|
|
290
|
+
}
|
|
291
|
+
violations.sort((a, b) => (a.key < b.key ? -1 : a.key > b.key ? 1 : 0));
|
|
292
|
+
const first = violations[0];
|
|
293
|
+
if (first !== undefined) {
|
|
294
|
+
throw new CompilerConfigurationError(first.code, first.message);
|
|
295
|
+
}
|
|
296
|
+
}
|
|
297
|
+
export function resolveRegistry(options) {
|
|
298
|
+
const builtIn = getBuiltInRegistry();
|
|
299
|
+
const plugins = Object.freeze([...(options.plugins ?? builtIn.plugins)]);
|
|
300
|
+
const blockRenderers = Object.freeze([
|
|
301
|
+
...(options.blockRenderers ?? builtIn.blockRenderers),
|
|
302
|
+
]);
|
|
303
|
+
const renderers = Object.freeze([...(options.renderers ?? builtIn.renderers)]);
|
|
304
|
+
validateRegistry(plugins, blockRenderers, renderers);
|
|
305
|
+
return Object.freeze({ plugins, blockRenderers, renderers });
|
|
306
|
+
}
|
|
307
|
+
/**
|
|
308
|
+
* Reusable conformance seam: verifies descriptors are inert, immutable,
|
|
309
|
+
* and versioned. Built-in equation Plugin plus HTML Block renderer must
|
|
310
|
+
* pass; third-party registries reuse the same entry point.
|
|
311
|
+
*/
|
|
312
|
+
export function assertRegistryDescriptorsImmutable(registry) {
|
|
313
|
+
const failures = [];
|
|
314
|
+
for (const plugin of registry.plugins) {
|
|
315
|
+
if (!Object.isFrozen(plugin) || !Object.isFrozen(plugin.descriptor)) {
|
|
316
|
+
failures.push(`plugin:${plugin.descriptor.type}:mutable`);
|
|
317
|
+
}
|
|
318
|
+
if (!SEMVER.test(plugin.descriptor.version)) {
|
|
319
|
+
failures.push(`plugin:${plugin.descriptor.type}:unversioned`);
|
|
320
|
+
}
|
|
321
|
+
if (typeof plugin.descriptor.render !== "undefined") {
|
|
322
|
+
failures.push(`plugin:${plugin.descriptor.type}:renders`);
|
|
323
|
+
}
|
|
324
|
+
}
|
|
325
|
+
for (const blockRenderer of registry.blockRenderers) {
|
|
326
|
+
if (!Object.isFrozen(blockRenderer) ||
|
|
327
|
+
!Object.isFrozen(blockRenderer.descriptor)) {
|
|
328
|
+
failures.push(`block-renderer:${blockRenderer.descriptor.id}:mutable`);
|
|
329
|
+
}
|
|
330
|
+
if (!SEMVER.test(blockRenderer.descriptor.version)) {
|
|
331
|
+
failures.push(`block-renderer:${blockRenderer.descriptor.id}:unversioned`);
|
|
332
|
+
}
|
|
333
|
+
}
|
|
334
|
+
for (const renderer of registry.renderers) {
|
|
335
|
+
if (!Object.isFrozen(renderer)) {
|
|
336
|
+
failures.push(`renderer:${renderer.id}:mutable`);
|
|
337
|
+
}
|
|
338
|
+
}
|
|
339
|
+
if (failures.length > 0) {
|
|
340
|
+
throw new CompilerConfigurationError("azeforge.config#mutable-descriptor", `Registry descriptors failed conformance: ${failures.sort().join(", ")}.`);
|
|
341
|
+
}
|
|
342
|
+
}
|
|
343
|
+
function deepFreeze(value, seen = new Set()) {
|
|
344
|
+
if (typeof value !== "object" || value === null)
|
|
345
|
+
return;
|
|
346
|
+
if (seen.has(value) || Object.isFrozen(value))
|
|
347
|
+
return;
|
|
348
|
+
seen.add(value);
|
|
349
|
+
for (const entry of Object.values(value))
|
|
350
|
+
deepFreeze(entry, seen);
|
|
351
|
+
Object.freeze(value);
|
|
352
|
+
}
|
|
353
|
+
/**
|
|
354
|
+
* Defensive immutable snapshot for Compiler construction. Built-in
|
|
355
|
+
* descriptors are already frozen; custom descriptors are cloned and
|
|
356
|
+
* frozen so downstream reads observe immutability without mutating
|
|
357
|
+
* caller-owned objects.
|
|
358
|
+
*/
|
|
359
|
+
export function freezeRegistryForCompiler(registry) {
|
|
360
|
+
return Object.freeze({
|
|
361
|
+
plugins: Object.freeze(registry.plugins.map((plugin) => Object.freeze({
|
|
362
|
+
...plugin,
|
|
363
|
+
descriptor: (() => {
|
|
364
|
+
const descriptor = structuredClone(plugin.descriptor);
|
|
365
|
+
deepFreeze(descriptor);
|
|
366
|
+
return descriptor;
|
|
367
|
+
})(),
|
|
368
|
+
}))),
|
|
369
|
+
blockRenderers: Object.freeze(registry.blockRenderers.map((blockRenderer) => Object.freeze({
|
|
370
|
+
...blockRenderer,
|
|
371
|
+
descriptor: (() => {
|
|
372
|
+
const descriptor = structuredClone(blockRenderer.descriptor);
|
|
373
|
+
deepFreeze(descriptor);
|
|
374
|
+
return descriptor;
|
|
375
|
+
})(),
|
|
376
|
+
}))),
|
|
377
|
+
renderers: Object.freeze(registry.renderers.map((renderer) => {
|
|
378
|
+
const snapshot = structuredClone(renderer);
|
|
379
|
+
deepFreeze(snapshot);
|
|
380
|
+
return Object.freeze(snapshot);
|
|
381
|
+
})),
|
|
382
|
+
});
|
|
383
|
+
}
|
|
384
|
+
//# sourceMappingURL=registry.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import type { EmbeddedFontFace } from "./font.js";
|
|
2
|
+
import type { Artifact, AssetManifestEntry, AzeDocument, BlockRendererContext, CalloutBlock, ContentHash, EquationBlock, JsonValue, TableBlock, MermaidBlock, Theme } from "./model.js";
|
|
3
|
+
export declare const HTML_MIME_TYPE = "text/html; charset=utf-8";
|
|
4
|
+
export declare const HTML_PROFILE = "azeforge.html.self-contained/v1";
|
|
5
|
+
export declare const HTML_SERIALIZER: "azeforge-html/v2";
|
|
6
|
+
export declare const HTML_MAX_BYTES: number;
|
|
7
|
+
export declare class ArtifactLimitError extends Error {
|
|
8
|
+
readonly byteLength: number;
|
|
9
|
+
constructor(byteLength: number);
|
|
10
|
+
}
|
|
11
|
+
export interface HtmlPluginRenderers {
|
|
12
|
+
readonly renderCallout?: (block: CalloutBlock, context: BlockRendererContext) => string;
|
|
13
|
+
readonly renderTable?: (block: TableBlock, context: BlockRendererContext) => string;
|
|
14
|
+
}
|
|
15
|
+
export declare function documentTitle(document: AzeDocument): string;
|
|
16
|
+
export interface HtmlLayout {
|
|
17
|
+
readonly title: string;
|
|
18
|
+
readonly description: string;
|
|
19
|
+
readonly css: string;
|
|
20
|
+
readonly body: string;
|
|
21
|
+
readonly fingerprintDependencies: JsonValue;
|
|
22
|
+
}
|
|
23
|
+
export declare function createHtmlLayout(document: AzeDocument, theme: Theme, fontFaces: readonly EmbeddedFontFace[], equationFragments?: ReadonlyMap<EquationBlock, string>, equationDependencyClosure?: JsonValue, mermaidFragments?: ReadonlyMap<MermaidBlock, string>, mermaidDependencyClosure?: JsonValue, pluginRenderers?: HtmlPluginRenderers): HtmlLayout;
|
|
24
|
+
export declare function renderHtml(document: AzeDocument, contentHash: ContentHash, theme: Theme, fontFaces: readonly EmbeddedFontFace[], equationFragments?: ReadonlyMap<EquationBlock, string>, equationDependencyClosure?: JsonValue, mermaidFragments?: ReadonlyMap<MermaidBlock, string>, mermaidDependencyClosure?: JsonValue, pluginRenderers?: HtmlPluginRenderers, assetManifest?: readonly AssetManifestEntry[]): Promise<Artifact>;
|
|
@@ -0,0 +1,149 @@
|
|
|
1
|
+
import { assetManifestHash } from "./assets.js";
|
|
2
|
+
import { renderCalloutFragment } from "./callout.js";
|
|
3
|
+
import { KATEX_VERSION, getKatexCss } from "./equation.js";
|
|
4
|
+
import { MERMAID_VERSION } from "./mermaid.js";
|
|
5
|
+
import { artifactBytesHash, canonicalJson, sha256 } from "./hash.js";
|
|
6
|
+
import { escapeHtml, renderInlineHtml } from "./html-fragment.js";
|
|
7
|
+
import { inlineTextValue } from "./markdown.js";
|
|
8
|
+
import { renderTableFragment } from "./table.js";
|
|
9
|
+
export const HTML_MIME_TYPE = "text/html; charset=utf-8";
|
|
10
|
+
export const HTML_PROFILE = "azeforge.html.self-contained/v1";
|
|
11
|
+
export const HTML_SERIALIZER = "azeforge-html/v2";
|
|
12
|
+
export const HTML_MAX_BYTES = 64 * 1024 * 1024;
|
|
13
|
+
export class ArtifactLimitError extends Error {
|
|
14
|
+
byteLength;
|
|
15
|
+
constructor(byteLength) {
|
|
16
|
+
super(`HTML Artifact is ${byteLength} bytes; the limit is ${HTML_MAX_BYTES} bytes.`);
|
|
17
|
+
this.name = "ArtifactLimitError";
|
|
18
|
+
this.byteLength = byteLength;
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
export function documentTitle(document) {
|
|
22
|
+
const metadataTitle = document.metadata.title?.trim();
|
|
23
|
+
if (metadataTitle !== undefined && metadataTitle !== "")
|
|
24
|
+
return metadataTitle;
|
|
25
|
+
const firstHeading = document.blocks.find((block) => block.kind === "heading");
|
|
26
|
+
if (firstHeading?.kind !== "heading")
|
|
27
|
+
return "AzeForge document";
|
|
28
|
+
const text = inlineTextValue(firstHeading.children).trim();
|
|
29
|
+
return text === "" ? "AzeForge document" : text;
|
|
30
|
+
}
|
|
31
|
+
function idAttribute(id) {
|
|
32
|
+
return id === undefined ? "" : ` id="${escapeHtml(id)}"`;
|
|
33
|
+
}
|
|
34
|
+
function renderBlock(block, context) {
|
|
35
|
+
switch (block.kind) {
|
|
36
|
+
case "equation":
|
|
37
|
+
return (context.equationFragments.get(block) ?? '<figure class="aze-equation"></figure>');
|
|
38
|
+
case "mermaid":
|
|
39
|
+
return (context.mermaidFragments.get(block) ??
|
|
40
|
+
'<figure class="aze-mermaid"></figure>');
|
|
41
|
+
case "heading":
|
|
42
|
+
return `<h${block.level}${idAttribute(block.id)}>${renderInlineHtml(block.children)}</h${block.level}>`;
|
|
43
|
+
case "paragraph":
|
|
44
|
+
return `<p${idAttribute(block.id)}>${renderInlineHtml(block.children)}</p>`;
|
|
45
|
+
case "thematicBreak":
|
|
46
|
+
return `<hr${idAttribute(block.id)}>`;
|
|
47
|
+
case "blockquote":
|
|
48
|
+
return `<blockquote${idAttribute(block.id)}>${renderBlocks(block.children, context)}</blockquote>`;
|
|
49
|
+
case "list": {
|
|
50
|
+
const tag = block.ordered ? "ol" : "ul";
|
|
51
|
+
const start = block.ordered && block.start !== undefined ? ` start="${block.start}"` : "";
|
|
52
|
+
const items = block.items
|
|
53
|
+
.map((item) => `<li>${renderBlocks(item.blocks, context)}</li>`)
|
|
54
|
+
.join("");
|
|
55
|
+
return `<${tag}${idAttribute(block.id)}${start}>${items}</${tag}>`;
|
|
56
|
+
}
|
|
57
|
+
case "code": {
|
|
58
|
+
const language = block.language === undefined ? "" : ` class="language-${escapeHtml(block.language)}"`;
|
|
59
|
+
return `<pre${idAttribute(block.id)}><code${language}>${escapeHtml(block.value)}</code></pre>`;
|
|
60
|
+
}
|
|
61
|
+
case "table":
|
|
62
|
+
return context.renderTable(block, {
|
|
63
|
+
...(context.sourceName === undefined ? {} : { sourceName: context.sourceName }),
|
|
64
|
+
renderBlocks: (children) => renderBlocks(children, context),
|
|
65
|
+
});
|
|
66
|
+
case "callout":
|
|
67
|
+
return context.renderCallout(block, {
|
|
68
|
+
...(context.sourceName === undefined ? {} : { sourceName: context.sourceName }),
|
|
69
|
+
renderBlocks: (children) => renderBlocks(children, context),
|
|
70
|
+
});
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
function renderBlocks(blocks, context) {
|
|
74
|
+
return blocks.map((block) => renderBlock(block, context)).join("");
|
|
75
|
+
}
|
|
76
|
+
function embeddedFontCss(fontFaces) {
|
|
77
|
+
return fontFaces
|
|
78
|
+
.map((font) => {
|
|
79
|
+
const family = font.family.includes(" ") ? `"${font.family}"` : font.family;
|
|
80
|
+
return `@font-face{font-family:${family};font-style:normal;font-weight:${font.weight};font-display:block;src:url(data:font/woff2;base64,${font.data}) format("woff2");unicode-range:${font.unicodeRange}}`;
|
|
81
|
+
})
|
|
82
|
+
.join("");
|
|
83
|
+
}
|
|
84
|
+
function themeCss(theme) {
|
|
85
|
+
const { colors, geometry, typography } = theme;
|
|
86
|
+
const colorScheme = theme.colorScheme;
|
|
87
|
+
return `:root{color-scheme:${colorScheme};background:${colors.background};color:${colors.foreground};font-family:${typography.proseFontFamily};font-weight:${typography.bodyFontWeight};line-height:${typography.lineHeight};font-size:11pt}}*{box-sizing:border-box}body{margin:0;background:${colors.background}}main{max-width:${geometry.canvasWidthPx}px;margin:0 auto;padding:${geometry.paddingPx}px}article{max-width:${geometry.contentWidthPx}px;margin:0 auto}h1,h2,h3,h4,h5,h6{font-weight:${typography.headingFontWeight};line-height:${typography.headingLineHeight}}h1{font-size:20pt;margin:.9em 0 .45em}h2{font-size:16pt;margin:1em 0 .5em}h3{font-size:13pt;margin:1em 0 .5em}h4,h5,h6{font-size:11pt;margin:1.1em 0 .55em}p{margin:${typography.paragraphSpacingEm}em 0;color:${colors.foreground}}a{color:inherit}img{max-width:100%;height:auto}hr{border:none;border-top:1px solid ${colors.muted};margin:1.5em 0}blockquote{margin:1em 0;padding:0 0 0 1em;border-left:3px solid ${colors.muted}}ul,ol{margin:1em 0;padding-left:2em}li{margin:0.25em 0}li>p{margin:0.25em 0}pre{margin:1em 0;padding:1em;overflow-x:auto;background:rgba(127,127,127,.08)}pre code{font-family:"JetBrains Mono",Inter}code{font-family:"JetBrains Mono",Inter;font-size:.9em}table{border-collapse:collapse;margin:1em 0;width:100%}caption{caption-side:top;text-align:left;font-weight:${typography.headingFontWeight};padding:.5em 0}th,td{border:1px solid ${colors.muted};padding:.5em .75em;text-align:left}thead th{background:rgba(127,127,127,.08)}figure.aze-table{margin:1em 0}.aze-callout{margin:1em 0;padding:.75em 1em;border:1px solid ${colors.muted};border-left-width:4px}.aze-callout-title{margin:0 0 .5em;font-weight:${typography.headingFontWeight}}.aze-callout-body>:first-child{margin-top:0}.aze-callout-body>:last-child{margin-bottom:0}`;
|
|
88
|
+
}
|
|
89
|
+
export function createHtmlLayout(document, theme, fontFaces, equationFragments = new Map(), equationDependencyClosure = { katex: KATEX_VERSION }, mermaidFragments = new Map(), mermaidDependencyClosure = { mermaid: MERMAID_VERSION }, pluginRenderers = {}) {
|
|
90
|
+
const renderCallout = pluginRenderers.renderCallout ?? renderCalloutFragment;
|
|
91
|
+
const renderTable = pluginRenderers.renderTable ?? ((block) => renderTableFragment(block));
|
|
92
|
+
const context = {
|
|
93
|
+
equationFragments,
|
|
94
|
+
mermaidFragments,
|
|
95
|
+
renderCallout,
|
|
96
|
+
renderTable,
|
|
97
|
+
};
|
|
98
|
+
return {
|
|
99
|
+
title: escapeHtml(documentTitle(document)),
|
|
100
|
+
description: "AzeForge whole-Document Artifact",
|
|
101
|
+
css: `${embeddedFontCss(fontFaces)}${themeCss(theme)}${getKatexCss()}.aze-equation{margin:1em 0;text-align:center}.aze-equation[data-align="left"]{text-align:left}.aze-equation[data-align="right"]{text-align:right}.aze-mermaid{margin:1em 0}.aze-mermaid svg{display:block;max-width:100%;height:auto;margin:0 auto}`,
|
|
102
|
+
body: `<main><article>${renderBlocks(document.blocks, context)}</article></main>`,
|
|
103
|
+
fingerprintDependencies: {
|
|
104
|
+
theme: theme,
|
|
105
|
+
fonts: fontFaces.map(({ name, weight, sourceHash }) => ({
|
|
106
|
+
name,
|
|
107
|
+
weight,
|
|
108
|
+
sourceHash,
|
|
109
|
+
})),
|
|
110
|
+
equations: equationDependencyClosure,
|
|
111
|
+
diagrams: mermaidDependencyClosure,
|
|
112
|
+
prose: {
|
|
113
|
+
serializer: "azeforge-prose/v1",
|
|
114
|
+
callout: "1.0.0",
|
|
115
|
+
table: "1.0.0",
|
|
116
|
+
},
|
|
117
|
+
},
|
|
118
|
+
};
|
|
119
|
+
}
|
|
120
|
+
export async function renderHtml(document, contentHash, theme, fontFaces, equationFragments = new Map(), equationDependencyClosure = { katex: KATEX_VERSION }, mermaidFragments = new Map(), mermaidDependencyClosure = { mermaid: MERMAID_VERSION }, pluginRenderers = {}, assetManifest = []) {
|
|
121
|
+
const layout = createHtmlLayout(document, theme, fontFaces, equationFragments, equationDependencyClosure, mermaidFragments, mermaidDependencyClosure, pluginRenderers);
|
|
122
|
+
const rendererFingerprint = sha256(canonicalJson({
|
|
123
|
+
renderer: { id: "html", version: "1.0.0", serializer: HTML_SERIALIZER },
|
|
124
|
+
profile: HTML_PROFILE,
|
|
125
|
+
...layout.fingerprintDependencies,
|
|
126
|
+
}));
|
|
127
|
+
const html = `<!doctype html>\n<html lang="und"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta http-equiv="Content-Security-Policy" content="default-src 'none'; style-src 'unsafe-inline'; img-src data:; font-src data:"><meta name="azeforge-content-hash" content="${contentHash}"><title>${layout.title}</title><style>${layout.css}</style></head><body>${layout.body}</body></html>\n`;
|
|
128
|
+
const bytes = new TextEncoder().encode(html);
|
|
129
|
+
if (bytes.byteLength > HTML_MAX_BYTES) {
|
|
130
|
+
throw new ArtifactLimitError(bytes.byteLength);
|
|
131
|
+
}
|
|
132
|
+
const artifactHash = artifactBytesHash(bytes);
|
|
133
|
+
return {
|
|
134
|
+
bytes,
|
|
135
|
+
metadata: {
|
|
136
|
+
format: "html",
|
|
137
|
+
mimeType: HTML_MIME_TYPE,
|
|
138
|
+
profile: HTML_PROFILE,
|
|
139
|
+
byteLength: bytes.byteLength,
|
|
140
|
+
contentHash,
|
|
141
|
+
assetManifestHash: assetManifestHash(assetManifest),
|
|
142
|
+
rendererFingerprint,
|
|
143
|
+
artifactHash,
|
|
144
|
+
theme: { id: theme.id, version: theme.version },
|
|
145
|
+
cssDimensions: { ...theme.geometry },
|
|
146
|
+
},
|
|
147
|
+
};
|
|
148
|
+
}
|
|
149
|
+
//# sourceMappingURL=render-html.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"render-html.js","sourceRoot":"","sources":["../src/render-html.ts"],"names":[],"mappings":"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"}
|