@monimesl/dot-dml-parser 0.1.0-alpha.21 → 0.1.0-alpha.24
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/dist/index.d.ts +1 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +45 -39
- package/dist/index.js.map +1 -1
- package/package.json +2 -2
package/dist/index.d.ts
CHANGED
|
@@ -22,8 +22,7 @@ interface ParseDmlOptions {
|
|
|
22
22
|
locations?: boolean;
|
|
23
23
|
whitespace?: 'trim' | 'collapse' | 'inline' | 'preserve';
|
|
24
24
|
}
|
|
25
|
-
|
|
26
|
-
declare function parseDmlToIR(dmlString: string, options?: ParseDmlOptions): DmlNode[];
|
|
25
|
+
declare function parseDmlToIR(source: string, options?: ParseDmlOptions): DmlNode[];
|
|
27
26
|
//#endregion
|
|
28
27
|
//#region src/errors.d.ts
|
|
29
28
|
export declare class DmlParseError extends SourceError {
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","names":[],"sources":["../src/ast.ts","../src/parse.ts","../src/errors.ts"],"mappings":";;UAEiB;WACN;WACA;WACA,QAAQ;WACR,YAAY;WACZ,UAAU;WACV,MAAM;;UAGA;WACN;WACA;WACA,MAAM;;KAGL,UAAU,iBAAiB;wBAEvB,cAAc,MAAM,UAAU,QAAQ;;;UCbrC;EACf;EACA;EACA
|
|
1
|
+
{"version":3,"file":"index.d.ts","names":[],"sources":["../src/ast.ts","../src/parse.ts","../src/errors.ts"],"mappings":";;UAEiB;WACN;WACA;WACA,QAAQ;WACR,YAAY;WACZ,UAAU;WACV,MAAM;;UAGA;WACN;WACA;WACA,MAAM;;KAGL,UAAU,iBAAiB;wBAEvB,cAAc,MAAM,UAAU,QAAQ;;;UCbrC;EACf;EACA;EACA;;iBAcO,aAAa,gBAAgB,UAAS,kBAAuB;;;qBCrBzD,sBAAsB;WACf"}
|
package/dist/index.js
CHANGED
|
@@ -8,38 +8,37 @@ var DmlParseError = class extends SourceError {
|
|
|
8
8
|
//#region src/parse.ts
|
|
9
9
|
const CLOSING_TAG = /<\/([^\s>]+)\s*>/g;
|
|
10
10
|
const OPAQUE_REGION = /<!--[\s\S]*?-->|<!\[CDATA\[[\s\S]*?]]>/g;
|
|
11
|
-
|
|
12
|
-
function parseDmlToIR(dmlString, options = {}) {
|
|
11
|
+
function parseDmlToIR(source, options = {}) {
|
|
13
12
|
const { file, locations = false, whitespace = "trim" } = options;
|
|
14
13
|
const roots = [];
|
|
15
|
-
const
|
|
14
|
+
const openTags = [];
|
|
16
15
|
let textBuffer = "";
|
|
17
16
|
let textStart = -1;
|
|
18
17
|
const matchedClosingTagOffsets = /* @__PURE__ */ new Set();
|
|
19
|
-
const locate = createLocator(
|
|
18
|
+
const locate = createLocator(source);
|
|
20
19
|
const errorAt = (message, offset) => {
|
|
21
20
|
return new DmlParseError(message, file, locate(offset));
|
|
22
21
|
};
|
|
22
|
+
const withLocation = (node, offset) => {
|
|
23
|
+
if (!locations) return node;
|
|
24
|
+
return {
|
|
25
|
+
...node,
|
|
26
|
+
loc: locate(offset)
|
|
27
|
+
};
|
|
28
|
+
};
|
|
23
29
|
const currentChildren = () => {
|
|
24
|
-
return
|
|
30
|
+
return openTags.at(-1)?.node.children ?? roots;
|
|
25
31
|
};
|
|
26
32
|
const flushText = () => {
|
|
27
33
|
if (textStart < 0) return;
|
|
28
34
|
const content = normalizeText(textBuffer, whitespace);
|
|
29
35
|
if (content.length > 0) {
|
|
30
|
-
let
|
|
31
|
-
if (
|
|
32
|
-
|
|
33
|
-
node = {
|
|
34
|
-
type: "Text",
|
|
35
|
-
content,
|
|
36
|
-
loc: locate(textStart + leadingWhitespace)
|
|
37
|
-
};
|
|
38
|
-
} else node = {
|
|
36
|
+
let contentStart = textStart;
|
|
37
|
+
if (whitespace !== "preserve") contentStart += leadingWhitespaceLength(textBuffer);
|
|
38
|
+
currentChildren().push(withLocation({
|
|
39
39
|
type: "Text",
|
|
40
40
|
content
|
|
41
|
-
};
|
|
42
|
-
currentChildren().push(node);
|
|
41
|
+
}, contentStart));
|
|
43
42
|
}
|
|
44
43
|
textBuffer = "";
|
|
45
44
|
textStart = -1;
|
|
@@ -52,31 +51,19 @@ function parseDmlToIR(dmlString, options = {}) {
|
|
|
52
51
|
start: parser.startIndex
|
|
53
52
|
};
|
|
54
53
|
},
|
|
55
|
-
onopentag(name,
|
|
54
|
+
onopentag(name, rawAttributes) {
|
|
56
55
|
unfinishedTag = void 0;
|
|
57
56
|
flushText();
|
|
58
|
-
const events =
|
|
59
|
-
const
|
|
60
|
-
for (const [attributeName, value] of Object.entries(attribs)) if (isEventProp(attributeName)) events[attributeName] = value;
|
|
61
|
-
else attributes[attributeName] = value;
|
|
62
|
-
let node;
|
|
63
|
-
if (locations) node = {
|
|
64
|
-
type: "Element",
|
|
65
|
-
tag: name,
|
|
66
|
-
attributes,
|
|
67
|
-
events,
|
|
68
|
-
children: [],
|
|
69
|
-
loc: locate(parser.startIndex)
|
|
70
|
-
};
|
|
71
|
-
else node = {
|
|
57
|
+
const { attributes, events } = splitEvents(rawAttributes);
|
|
58
|
+
const node = withLocation({
|
|
72
59
|
type: "Element",
|
|
73
60
|
tag: name,
|
|
74
61
|
attributes,
|
|
75
62
|
events,
|
|
76
63
|
children: []
|
|
77
|
-
};
|
|
64
|
+
}, parser.startIndex);
|
|
78
65
|
currentChildren().push(node);
|
|
79
|
-
|
|
66
|
+
openTags.push({
|
|
80
67
|
node,
|
|
81
68
|
start: parser.startIndex
|
|
82
69
|
});
|
|
@@ -84,11 +71,12 @@ function parseDmlToIR(dmlString, options = {}) {
|
|
|
84
71
|
onclosetag(name, isImplied) {
|
|
85
72
|
flushText();
|
|
86
73
|
if (unfinishedTag) throw errorAt(`<${unfinishedTag.name}> isn't finished: add \`>\` or \`/>\``, unfinishedTag.start);
|
|
87
|
-
const openTag =
|
|
74
|
+
const openTag = openTags.pop();
|
|
88
75
|
const openTagName = openTag.node.tag;
|
|
89
76
|
const selfClosing = parser.startIndex === openTag.start;
|
|
90
77
|
if (isImplied && !selfClosing) {
|
|
91
|
-
|
|
78
|
+
let found = "end of input";
|
|
79
|
+
if (parser.startIndex < source.length) found = `\`${source.slice(parser.startIndex, parser.endIndex + 1)}\``;
|
|
92
80
|
throw errorAt(`<${openTagName}> isn't closed: expected </${openTagName}>, found ${found}`, openTag.start);
|
|
93
81
|
}
|
|
94
82
|
if (name !== openTagName) throw errorAt(`</${name}> doesn't match <${openTagName}>: expected </${openTagName}>`, parser.startIndex);
|
|
@@ -112,25 +100,43 @@ function parseDmlToIR(dmlString, options = {}) {
|
|
|
112
100
|
decodeEntities: true,
|
|
113
101
|
recognizeCDATA: true
|
|
114
102
|
});
|
|
115
|
-
parser.write(
|
|
103
|
+
parser.write(source);
|
|
116
104
|
parser.end();
|
|
117
105
|
flushText();
|
|
118
|
-
const markupOnly =
|
|
106
|
+
const markupOnly = source.replace(OPAQUE_REGION, (region) => " ".repeat(region.length));
|
|
119
107
|
for (const closingTag of markupOnly.matchAll(CLOSING_TAG)) if (!matchedClosingTagOffsets.has(closingTag.index)) throw errorAt(`</${closingTag[1]}> has no matching opening tag`, closingTag.index);
|
|
120
108
|
return roots;
|
|
121
109
|
}
|
|
110
|
+
function splitEvents(rawAttributes) {
|
|
111
|
+
const attributes = {};
|
|
112
|
+
const events = {};
|
|
113
|
+
for (const [name, value] of Object.entries(rawAttributes)) if (isEventProp(name)) events[name] = value;
|
|
114
|
+
else attributes[name] = value;
|
|
115
|
+
return {
|
|
116
|
+
attributes,
|
|
117
|
+
events
|
|
118
|
+
};
|
|
119
|
+
}
|
|
122
120
|
function normalizeText(raw, mode) {
|
|
123
121
|
switch (mode) {
|
|
124
|
-
case "preserve":
|
|
122
|
+
case "preserve":
|
|
123
|
+
if (raw.trim() === "") return "";
|
|
124
|
+
return raw;
|
|
125
125
|
case "collapse": return raw.replace(/\s+/g, " ").trim();
|
|
126
126
|
case "inline": return inlineText(raw);
|
|
127
127
|
case "trim": return raw.trim();
|
|
128
128
|
}
|
|
129
129
|
}
|
|
130
130
|
function inlineText(raw) {
|
|
131
|
-
if (raw.trim() === "")
|
|
131
|
+
if (raw.trim() === "") {
|
|
132
|
+
if (raw.includes("\n")) return "";
|
|
133
|
+
return " ";
|
|
134
|
+
}
|
|
132
135
|
return raw.replace(/^\s*\n\s*/, "").replace(/\s*\n\s*$/, "").replace(/\s+/g, " ");
|
|
133
136
|
}
|
|
137
|
+
function leadingWhitespaceLength(text) {
|
|
138
|
+
return text.length - text.trimStart().length;
|
|
139
|
+
}
|
|
134
140
|
//#endregion
|
|
135
141
|
//#region src/ast.ts
|
|
136
142
|
function isElementNode(node) {
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","names":[],"sources":["../src/errors.ts","../src/parse.ts","../src/ast.ts"],"sourcesContent":["import { SourceError } from '@monimesl/dot-core';\n\nexport class DmlParseError extends SourceError {\n override readonly name = 'DmlParseError';\n}\n","import { Parser } from 'htmlparser2';\nimport { createLocator, isEventProp } from '@monimesl/dot-core';\n\nimport { DmlParseError } from './errors';\nimport type { DmlElementNode, DmlNode } from './ast';\n\nexport interface ParseDmlOptions {\n file?: string;\n locations?: boolean;\n whitespace?: 'trim' | 'collapse' | 'inline' | 'preserve';\n}\n\nconst CLOSING_TAG = /<\\/([^\\s>]+)\\s*>/g;\nconst OPAQUE_REGION = /<!--[\\s\\S]*?-->|<!\\[CDATA\\[[\\s\\S]*?]]>/g;\n\ninterface OpenTag {\n node: DmlElementNode;\n start: number;\n}\n\n/** Parses .dml markup into an IR tree, leaving `{{ }}` bindings as raw strings. */\nfunction parseDmlToIR(dmlString: string, options: ParseDmlOptions = {}): DmlNode[] {\n const { file, locations = false, whitespace = 'trim' } = options;\n const roots: DmlNode[] = [];\n const stack: OpenTag[] = [];\n let textBuffer = '';\n let textStart = -1;\n const matchedClosingTagOffsets = new Set<number>();\n const locate = createLocator(dmlString);\n const errorAt = (message: string, offset: number) => {\n return new DmlParseError(message, file, locate(offset));\n };\n const currentChildren = (): DmlNode[] => {\n return stack.at(-1)?.node.children ?? roots;\n };\n const flushText = (): void => {\n if (textStart < 0) {\n return;\n }\n const content = normalizeText(textBuffer, whitespace);\n if (content.length > 0) {\n let node: DmlNode;\n if (locations) {\n const leadingWhitespace =\n whitespace === 'preserve' ? 0 : textBuffer.length - textBuffer.trimStart().length;\n node = { type: 'Text', content, loc: locate(textStart + leadingWhitespace) };\n } else {\n node = { type: 'Text', content };\n }\n currentChildren().push(node);\n }\n textBuffer = '';\n textStart = -1;\n };\n // A tag whose name has been read but not its closing `>`.\n let unfinishedTag: { name: string; start: number } | undefined;\n const parser = new Parser(\n {\n onopentagname(name) {\n unfinishedTag = { name, start: parser.startIndex };\n },\n onopentag(name, attribs) {\n unfinishedTag = undefined;\n flushText();\n const events: Record<string, string> = {};\n const attributes: Record<string, string> = {};\n for (const [attributeName, value] of Object.entries(attribs)) {\n if (isEventProp(attributeName)) {\n events[attributeName] = value;\n } else {\n attributes[attributeName] = value;\n }\n }\n let node: DmlElementNode;\n if (locations) {\n node = {\n type: 'Element',\n tag: name,\n attributes,\n events,\n children: [],\n loc: locate(parser.startIndex),\n };\n } else {\n node = { type: 'Element', tag: name, attributes, events, children: [] };\n }\n currentChildren().push(node);\n stack.push({ node, start: parser.startIndex });\n },\n onclosetag(name, isImplied) {\n flushText();\n if (unfinishedTag) {\n throw errorAt(\n `<${unfinishedTag.name}> isn't finished: add \\`>\\` or \\`/>\\``,\n unfinishedTag.start,\n );\n }\n // htmlparser2 only reports closing tags it has seen open.\n const openTag = stack.pop()!;\n const openTagName = openTag.node.tag;\n const selfClosing = parser.startIndex === openTag.start;\n if (isImplied && !selfClosing) {\n const found =\n parser.startIndex >= dmlString.length\n ? 'end of input'\n : `\\`${dmlString.slice(parser.startIndex, parser.endIndex + 1)}\\``;\n throw errorAt(\n `<${openTagName}> isn't closed: expected </${openTagName}>, found ${found}`,\n openTag.start,\n );\n }\n if (name !== openTagName) {\n throw errorAt(\n `</${name}> doesn't match <${openTagName}>: expected </${openTagName}>`,\n parser.startIndex,\n );\n }\n if (!selfClosing) {\n matchedClosingTagOffsets.add(parser.startIndex);\n }\n },\n ontext(data) {\n // htmlparser2 splits text around entities; buffer until the next tag.\n if (textStart < 0) {\n textStart = parser.startIndex;\n }\n textBuffer += data;\n },\n oncomment() {\n flushText();\n },\n onprocessinginstruction() {\n flushText();\n },\n onerror(error) {\n throw errorAt(error.message, parser.startIndex);\n },\n },\n {\n xmlMode: true,\n decodeEntities: true,\n recognizeCDATA: true,\n },\n );\n\n parser.write(dmlString);\n parser.end();\n flushText();\n\n // htmlparser2 ignores unmatched closing tags instead of throwing, so we catch them here.\n // Comments and CDATA are blanked with spaces, not removed, so offsets still match the source.\n const markupOnly = dmlString.replace(OPAQUE_REGION, (region) => ' '.repeat(region.length));\n for (const closingTag of markupOnly.matchAll(CLOSING_TAG)) {\n if (!matchedClosingTagOffsets.has(closingTag.index)) {\n throw errorAt(`</${closingTag[1]!}> has no matching opening tag`, closingTag.index);\n }\n }\n return roots;\n}\n\nexport default parseDmlToIR;\n\nfunction normalizeText(raw: string, mode: NonNullable<ParseDmlOptions['whitespace']>): string {\n switch (mode) {\n case 'preserve':\n return raw.trim().length === 0 ? '' : raw;\n case 'collapse':\n return raw.replace(/\\s+/g, ' ').trim();\n case 'inline':\n return inlineText(raw);\n case 'trim':\n return raw.trim();\n }\n}\n\n// As text flows around inline elements: whitespace with a line break in it only lays out the markup,\n// so it goes, but a space on the same line as an element stays, as in `paid <Text>SLE 50</Text> today`.\nfunction inlineText(raw: string): string {\n if (raw.trim() === '') {\n return raw.includes('\\n') ? '' : ' ';\n }\n return raw\n .replace(/^\\s*\\n\\s*/, '')\n .replace(/\\s*\\n\\s*$/, '')\n .replace(/\\s+/g, ' ');\n}\n","import type { SourceLocation } from '@monimesl/dot-core';\n\nexport interface DmlElementNode {\n readonly type: 'Element';\n readonly tag: string;\n readonly events: Record<string, string>;\n readonly attributes: Record<string, string>;\n readonly children: DmlNode[];\n readonly loc?: SourceLocation;\n}\n\nexport interface DmlTextNode {\n readonly type: 'Text';\n readonly content: string;\n readonly loc?: SourceLocation;\n}\n\nexport type DmlNode = DmlElementNode | DmlTextNode;\n\nexport function isElementNode(node: DmlNode): node is DmlElementNode {\n return node.type === 'Element';\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.js","names":[],"sources":["../src/errors.ts","../src/parse.ts","../src/ast.ts"],"sourcesContent":["import { SourceError } from '@monimesl/dot-core';\n\nexport class DmlParseError extends SourceError {\n override readonly name = 'DmlParseError';\n}\n","import { Parser } from 'htmlparser2';\nimport { createLocator, isEventProp } from '@monimesl/dot-core';\n\nimport { DmlParseError } from './errors';\nimport type { DmlElementNode, DmlNode } from './ast';\n\nexport interface ParseDmlOptions {\n file?: string;\n locations?: boolean;\n whitespace?: 'trim' | 'collapse' | 'inline' | 'preserve';\n}\n\ntype WhitespaceMode = NonNullable<ParseDmlOptions['whitespace']>;\n\nconst CLOSING_TAG = /<\\/([^\\s>]+)\\s*>/g;\nconst OPAQUE_REGION = /<!--[\\s\\S]*?-->|<!\\[CDATA\\[[\\s\\S]*?]]>/g;\n\ninterface OpenTag {\n node: DmlElementNode;\n start: number;\n}\n\n// Parses .dml markup into a tree, leaving `{{ }}` bindings as raw strings.\nfunction parseDmlToIR(source: string, options: ParseDmlOptions = {}): DmlNode[] {\n const { file, locations = false, whitespace = 'trim' } = options;\n const roots: DmlNode[] = [];\n const openTags: OpenTag[] = [];\n let textBuffer = '';\n let textStart = -1;\n const matchedClosingTagOffsets = new Set<number>();\n const locate = createLocator(source);\n const errorAt = (message: string, offset: number) => {\n return new DmlParseError(message, file, locate(offset));\n };\n // Without `locations`, nodes have no `loc` key at all.\n const withLocation = <Node extends DmlNode>(node: Node, offset: number): Node => {\n if (!locations) {\n return node;\n }\n return { ...node, loc: locate(offset) };\n };\n const currentChildren = (): DmlNode[] => {\n return openTags.at(-1)?.node.children ?? roots;\n };\n const flushText = (): void => {\n if (textStart < 0) {\n return;\n }\n const content = normalizeText(textBuffer, whitespace);\n if (content.length > 0) {\n // Point at the first character kept, past any whitespace trimmed off the front.\n let contentStart = textStart;\n if (whitespace !== 'preserve') {\n contentStart += leadingWhitespaceLength(textBuffer);\n }\n currentChildren().push(withLocation({ type: 'Text', content }, contentStart));\n }\n textBuffer = '';\n textStart = -1;\n };\n // A tag whose name has been read but not its closing `>`.\n let unfinishedTag: { name: string; start: number } | undefined;\n const parser = new Parser(\n {\n onopentagname(name) {\n unfinishedTag = { name, start: parser.startIndex };\n },\n onopentag(name, rawAttributes) {\n unfinishedTag = undefined;\n flushText();\n const { attributes, events } = splitEvents(rawAttributes);\n const node = withLocation<DmlElementNode>(\n { type: 'Element', tag: name, attributes, events, children: [] },\n parser.startIndex,\n );\n currentChildren().push(node);\n openTags.push({ node, start: parser.startIndex });\n },\n onclosetag(name, isImplied) {\n flushText();\n if (unfinishedTag) {\n throw errorAt(\n `<${unfinishedTag.name}> isn't finished: add \\`>\\` or \\`/>\\``,\n unfinishedTag.start,\n );\n }\n // htmlparser2 only reports closing tags it has seen open.\n const openTag = openTags.pop()!;\n const openTagName = openTag.node.tag;\n const selfClosing = parser.startIndex === openTag.start;\n if (isImplied && !selfClosing) {\n let found = 'end of input';\n if (parser.startIndex < source.length) {\n found = `\\`${source.slice(parser.startIndex, parser.endIndex + 1)}\\``;\n }\n throw errorAt(\n `<${openTagName}> isn't closed: expected </${openTagName}>, found ${found}`,\n openTag.start,\n );\n }\n if (name !== openTagName) {\n throw errorAt(\n `</${name}> doesn't match <${openTagName}>: expected </${openTagName}>`,\n parser.startIndex,\n );\n }\n if (!selfClosing) {\n matchedClosingTagOffsets.add(parser.startIndex);\n }\n },\n ontext(data) {\n // htmlparser2 splits text around entities; buffer until the next tag.\n if (textStart < 0) {\n textStart = parser.startIndex;\n }\n textBuffer += data;\n },\n oncomment() {\n flushText();\n },\n onprocessinginstruction() {\n flushText();\n },\n onerror(error) {\n throw errorAt(error.message, parser.startIndex);\n },\n },\n {\n xmlMode: true,\n decodeEntities: true,\n recognizeCDATA: true,\n },\n );\n\n parser.write(source);\n parser.end();\n flushText();\n\n // htmlparser2 ignores unmatched closing tags instead of throwing, so we catch them here.\n // Comments and CDATA are blanked with spaces, not removed, so offsets still match the source.\n const markupOnly = source.replace(OPAQUE_REGION, (region) => ' '.repeat(region.length));\n for (const closingTag of markupOnly.matchAll(CLOSING_TAG)) {\n if (!matchedClosingTagOffsets.has(closingTag.index)) {\n throw errorAt(`</${closingTag[1]!}> has no matching opening tag`, closingTag.index);\n }\n }\n return roots;\n}\n\nexport default parseDmlToIR;\n\nfunction splitEvents(rawAttributes: Record<string, string>): {\n attributes: Record<string, string>;\n events: Record<string, string>;\n} {\n const attributes: Record<string, string> = {};\n const events: Record<string, string> = {};\n for (const [name, value] of Object.entries(rawAttributes)) {\n if (isEventProp(name)) {\n events[name] = value;\n } else {\n attributes[name] = value;\n }\n }\n return { attributes, events };\n}\n\nfunction normalizeText(raw: string, mode: WhitespaceMode): string {\n switch (mode) {\n case 'preserve':\n if (raw.trim() === '') {\n return '';\n }\n return raw;\n case 'collapse':\n return raw.replace(/\\s+/g, ' ').trim();\n case 'inline':\n return inlineText(raw);\n case 'trim':\n return raw.trim();\n }\n}\n\n// As text flows around inline elements: whitespace with a line break in it only lays out the markup,\n// so it goes, but a space on the same line as an element stays, as in `paid <Text>SLE 50</Text> today`.\nfunction inlineText(raw: string): string {\n if (raw.trim() === '') {\n if (raw.includes('\\n')) {\n return '';\n }\n return ' ';\n }\n return raw\n .replace(/^\\s*\\n\\s*/, '')\n .replace(/\\s*\\n\\s*$/, '')\n .replace(/\\s+/g, ' ');\n}\n\nfunction leadingWhitespaceLength(text: string): number {\n return text.length - text.trimStart().length;\n}\n","import type { SourceLocation } from '@monimesl/dot-core';\n\nexport interface DmlElementNode {\n readonly type: 'Element';\n readonly tag: string;\n readonly events: Record<string, string>;\n readonly attributes: Record<string, string>;\n readonly children: DmlNode[];\n readonly loc?: SourceLocation;\n}\n\nexport interface DmlTextNode {\n readonly type: 'Text';\n readonly content: string;\n readonly loc?: SourceLocation;\n}\n\nexport type DmlNode = DmlElementNode | DmlTextNode;\n\nexport function isElementNode(node: DmlNode): node is DmlElementNode {\n return node.type === 'Element';\n}\n"],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@monimesl/dot-dml-parser",
|
|
3
|
-
"version": "0.1.0-alpha.
|
|
3
|
+
"version": "0.1.0-alpha.24",
|
|
4
4
|
"description": "Dot .dml template parser: markup -> intermediary representation",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"repository": {
|
|
@@ -32,7 +32,7 @@
|
|
|
32
32
|
},
|
|
33
33
|
"dependencies": {
|
|
34
34
|
"htmlparser2": "^12.0.0",
|
|
35
|
-
"@monimesl/dot-core": "0.1.0-alpha.
|
|
35
|
+
"@monimesl/dot-core": "0.1.0-alpha.24"
|
|
36
36
|
},
|
|
37
37
|
"publishConfig": {
|
|
38
38
|
"access": "public"
|