tempile-core 1.0.0

package/dist/ast/base/Node.d.ts

@@ -0,0 +1,9 @@
+import NodeType from "./node-types.js";
+import Pos from "./Pos.js";
+declare abstract class Node {
+    type: NodeType;
+    pos: Pos | null | undefined;
+    constructor(type: NodeType, pos: Pos | null | undefined);
+    abstract getChildren(): Node[];
+}
+export default Node;

package/dist/ast/base/Node.js

@@ -0,0 +1,9 @@
+class Node {
+    type;
+    pos;
+    constructor(type, pos) {
+        this.type = type;
+        this.pos = pos;
+    }
+}
+export default Node;

package/dist/ast/base/Pos.d.ts

@@ -0,0 +1,10 @@
+type Pos = {
+    fileName: string;
+    startLine?: number;
+    startCol?: number;
+    startOffset?: number;
+    endLine?: number;
+    endCol?: number;
+    endOffset?: number;
+};
+export default Pos;

package/dist/ast/base/Pos.js

@@ -0,0 +1 @@
+export {};

package/dist/ast/base/Root.d.ts

@@ -0,0 +1,13 @@
+import Node from "./Node.js";
+declare class Root {
+    children: Node[];
+    fileName: string;
+    constructor(children: Node[], fileName: string);
+    resolveIncludes(srcPath: string): void;
+    private resolveIncludesRecursive;
+    matchSlotsAndContents(): void;
+    private collectIncludes;
+    private collectSlotsAndContents;
+    private unwrapSlotsAndIncludes;
+}
+export default Root;

package/dist/ast/base/Root.js

@@ -0,0 +1,105 @@
+import path from "node:path";
+import NodeType from "./node-types.js";
+import fs from "fs";
+import { parse } from "../../parser/parser.js";
+class Root {
+    children;
+    fileName;
+    constructor(children, fileName) {
+        this.children = children;
+        this.fileName = fileName;
+    }
+    resolveIncludes(srcPath) {
+        this.resolveIncludesRecursive(this.children, srcPath);
+    }
+    resolveIncludesRecursive(nodes, srcPath) {
+        for (const child of nodes) {
+            if (child.type === NodeType.Include) {
+                const includeNode = child;
+                const pos = includeNode.path.pos;
+                if (path.basename(includeNode.path.value) === this.fileName) {
+                    throw new Error(`Circular include detected: file "${this.fileName}" tries to include itself at ${includeNode.path.value}
+                        File: ${pos?.fileName} Line: ${pos?.startLine} Col: ${pos?.startCol}  
+                        `);
+                }
+                const filePath = path.join(srcPath, includeNode.path.value);
+                let file = "";
+                try {
+                    file = fs.readFileSync(filePath, "utf-8");
+                }
+                catch (err) {
+                    throw new Error(`Failed to read file at path "${filePath}". Error: ${err.message} 
+                        File: ${pos?.fileName} Line: ${pos?.startLine} Col: ${pos?.startCol}
+                        `);
+                }
+                const parsedRoot = parse(file, filePath);
+                parsedRoot.resolveIncludes(srcPath);
+                this.resolveIncludesRecursive(includeNode.children, srcPath);
+                includeNode.children = [...parsedRoot.children, ...includeNode.children];
+            }
+            else {
+                this.resolveIncludesRecursive(child.getChildren(), srcPath);
+            }
+        }
+    }
+    matchSlotsAndContents() {
+        const includeNodes = this.collectIncludes(this.children);
+        const slots = new Map();
+        const contents = new Map();
+        for (const iNode of includeNodes) {
+            slots.set(iNode.ctxId, new Map());
+            contents.set(iNode.ctxId, new Map());
+            this.collectSlotsAndContents(iNode.children, iNode.ctxId, slots, contents);
+        }
+        for (const [k, v] of contents) {
+            for (const [innerK, innerV] of v) {
+                const slot = slots.get(k)?.get(innerK);
+                slot?.children.push(...innerV.children);
+            }
+        }
+        this.unwrapSlotsAndIncludes(this.children);
+    }
+    collectIncludes(nodes) {
+        const includeNodes = [];
+        for (const node of nodes) {
+            if (node.type === NodeType.Include) {
+                includeNodes.push(node);
+            }
+            includeNodes.push(...this.collectIncludes(node.getChildren()));
+        }
+        return includeNodes;
+    }
+    collectSlotsAndContents(nodes, ctxId, slots, contents) {
+        for (let i = 0; i < nodes.length; i++) {
+            const node = nodes[i];
+            if (node.type === NodeType.Slot) {
+                slots.get(ctxId)?.set(node.name, node);
+            }
+            else if (node.type === NodeType.Content) {
+                contents.get(ctxId)?.set(node.name, node);
+                this.collectSlotsAndContents(node.getChildren(), ctxId, slots, contents);
+                nodes.splice(i, 1);
+                i--;
+                continue;
+            }
+            this.collectSlotsAndContents(node.getChildren(), ctxId, slots, contents);
+        }
+    }
+    unwrapSlotsAndIncludes(nodes) {
+        for (let i = 0; i < nodes.length; i++) {
+            const node = nodes[i];
+            const isUnwrap = node.type === NodeType.Include ||
+                node.type === NodeType.Slot;
+            const children = node.getChildren();
+            if (isUnwrap) {
+                this.unwrapSlotsAndIncludes(children);
+                nodes.splice(i, 1, ...children);
+                i += children.length - 1;
+            }
+            else {
+                this.unwrapSlotsAndIncludes(children);
+            }
+        }
+    }
+}
+export default Root;

package/dist/ast/base/node-types.d.ts

@@ -0,0 +1,18 @@
+declare enum NodeType {
+    Import = "import",
+    Doctype = "doctype",
+    Tempile = "tempile",
+    Comment = "comment",
+    Text = "text",
+    Element = "element",
+    If = "if",
+    ElseIf = "elseif",
+    Else = "else",
+    For = "for",
+    Include = "include",
+    Slot = "slot",
+    Content = "content",
+    Out = "out",
+    Logic = "logic"
+}
+export default NodeType;

package/dist/ast/base/node-types.js

@@ -0,0 +1,19 @@
+var NodeType;
+(function (NodeType) {
+    NodeType["Import"] = "import";
+    NodeType["Doctype"] = "doctype";
+    NodeType["Tempile"] = "tempile";
+    NodeType["Comment"] = "comment";
+    NodeType["Text"] = "text";
+    NodeType["Element"] = "element";
+    NodeType["If"] = "if";
+    NodeType["ElseIf"] = "elseif";
+    NodeType["Else"] = "else";
+    NodeType["For"] = "for";
+    NodeType["Include"] = "include";
+    NodeType["Slot"] = "slot";
+    NodeType["Content"] = "content";
+    NodeType["Out"] = "out";
+    NodeType["Logic"] = "logic";
+})(NodeType || (NodeType = {}));
+export default NodeType;

package/dist/ast/base/parse5-type-guards.d.ts

@@ -0,0 +1,4 @@
+import { RawChildNode, RawCommentNode, RawElementNode, RawTextNode } from "./parse5-types.js";
+export declare function isRawTextNode(node: RawChildNode): node is RawTextNode;
+export declare function isRawCommentNode(node: RawChildNode): node is RawCommentNode;
+export declare function isRawElementNode(node: RawChildNode): node is RawElementNode;

package/dist/ast/base/parse5-type-guards.js

@@ -0,0 +1,9 @@
+export function isRawTextNode(node) {
+    return node.nodeName === "#text";
+}
+export function isRawCommentNode(node) {
+    return node.nodeName === "#comment";
+}
+export function isRawElementNode(node) {
+    return "tagName" in node;
+}

package/dist/ast/base/parse5-types.d.ts

@@ -0,0 +1,5 @@
+import type { DefaultTreeAdapterTypes } from "parse5";
+export type RawChildNode = DefaultTreeAdapterTypes.ChildNode;
+export type RawTextNode = DefaultTreeAdapterTypes.TextNode;
+export type RawCommentNode = DefaultTreeAdapterTypes.CommentNode;
+export type RawElementNode = DefaultTreeAdapterTypes.Element;

package/dist/ast/base/parse5-types.js

@@ -0,0 +1 @@
+export {};

package/dist/ast/base/parser-types.d.ts

@@ -0,0 +1,3 @@
+import Node from "./Node.js";
+import { RawChildNode } from "./parse5-types.js";
+export type RawASTParserFunction = (raw: RawChildNode[], fileName: string) => Node[];

package/dist/ast/base/parser-types.js

@@ -0,0 +1 @@
+export {};

package/dist/ast/control/ElseIfNode.d.ts

@@ -0,0 +1,13 @@
+import { Attribute } from "../html/Attribute.js";
+import Node from "../base/Node.js";
+import Pos from "../base/Pos.js";
+import { RawChildNode } from "../base/parse5-types.js";
+import { RawASTParserFunction } from "../base/parser-types.js";
+declare class ElseIfNode extends Node {
+    conditions: Attribute[];
+    children: Node[];
+    constructor(conditions: Attribute[], children: Node[], pos: Pos);
+    getChildren(): Node[];
+    static newFromRawNode(node: RawChildNode, fileName: string, rawAstParserFn: RawASTParserFunction): Node | null;
+}
+export default ElseIfNode;

package/dist/ast/control/ElseIfNode.js

@@ -0,0 +1,41 @@
+import Node from "../base/Node.js";
+import NodeType from "../base/node-types.js";
+import { isRawElementNode } from "../base/parse5-type-guards.js";
+import { getAtAttributes, getPos } from "../../utils/utils.js";
+class ElseIfNode extends Node {
+    conditions;
+    children;
+    constructor(conditions, children, pos) {
+        super(NodeType.ElseIf, pos);
+        this.conditions = conditions;
+        this.children = children;
+    }
+    getChildren() {
+        return this.children;
+    }
+    static newFromRawNode(node, fileName, rawAstParserFn) {
+        if (!isRawElementNode(node)) {
+            throw new Error(`Expected an element node but found '${node.nodeName}'. ` +
+                `File: ${fileName}, Line: ${node.sourceCodeLocation?.startLine ?? "?"}, Col: ${node.sourceCodeLocation?.startCol ?? "?"}`);
+        }
+        if (node.tagName !== "elseif") {
+            throw new Error(`Expected element tag name 'elseif' but found '${node.tagName}'. ` +
+                `File: ${fileName}, Line: ${node.sourceCodeLocation?.startLine ?? "?"}, Col: ${node.sourceCodeLocation?.startCol ?? "?"}`);
+        }
+        if (!node.parentNode || node.parentNode.nodeName !== "if") {
+            throw new Error(`<elseif> must be a child of <if>. ` +
+                `File: ${fileName}, Line: ${node.sourceCodeLocation?.startLine ?? "?"}, Col: ${node.sourceCodeLocation?.startCol ?? "?"}`);
+        }
+        const attributes = getAtAttributes(node, fileName);
+        if (attributes.length < 1) {
+            throw new Error(`Missing @[lang] attribute on <elseif> tag. ` +
+                `File: ${fileName}, Line: ${node.sourceCodeLocation?.startLine ?? "?"}, Col: ${node.sourceCodeLocation?.startCol ?? "?"}`);
+        }
+        if (node.childNodes.length === 0)
+            return null;
+        const children = rawAstParserFn(node.childNodes, fileName);
+        const pos = getPos(node, fileName);
+        return new ElseIfNode(attributes, children, pos);
+    }
+}
+export default ElseIfNode;

package/dist/ast/control/ElseNode.d.ts

@@ -0,0 +1,11 @@
+import Node from "../base/Node.js";
+import Pos from "../base/Pos.js";
+import { RawChildNode } from "../base/parse5-types.js";
+import { RawASTParserFunction } from "../base/parser-types.js";
+declare class ElseNode extends Node {
+    children: Node[];
+    constructor(children: Node[], pos: Pos);
+    getChildren(): Node[];
+    static newFromRawNode(node: RawChildNode, fileName: string, rawAstParserFn: RawASTParserFunction): Node | null;
+}
+export default ElseNode;

package/dist/ast/control/ElseNode.js

@@ -0,0 +1,34 @@
+import Node from "../base/Node.js";
+import NodeType from "../base/node-types.js";
+import { isRawElementNode } from "../base/parse5-type-guards.js";
+import { getPos } from "../../utils/utils.js";
+class ElseNode extends Node {
+    children;
+    constructor(children, pos) {
+        super(NodeType.Else, pos);
+        this.children = children;
+    }
+    getChildren() {
+        return this.children;
+    }
+    static newFromRawNode(node, fileName, rawAstParserFn) {
+        if (!isRawElementNode(node)) {
+            throw new Error(`Expected an element node but found '${node.nodeName}'. ` +
+                `File: ${fileName}, Line: ${node.sourceCodeLocation?.startLine ?? "?"}, Col: ${node.sourceCodeLocation?.startCol ?? "?"}`);
+        }
+        if (node.tagName !== "else") {
+            throw new Error(`Expected element tag name 'else' but found '${node.tagName}'. ` +
+                `File: ${fileName}, Line: ${node.sourceCodeLocation?.startLine ?? "?"}, Col: ${node.sourceCodeLocation?.startCol ?? "?"}`);
+        }
+        if (!node.parentNode || node.parentNode.nodeName !== "if") {
+            throw new Error(`<else> must be a child of <if>. ` +
+                `File: ${fileName}, Line: ${node.sourceCodeLocation?.startLine ?? "?"}, Col: ${node.sourceCodeLocation?.startCol ?? "?"}`);
+        }
+        if (node.childNodes.length === 0)
+            return null;
+        const children = rawAstParserFn(node.childNodes, fileName);
+        const pos = getPos(node, fileName);
+        return new ElseNode(children, pos);
+    }
+}
+export default ElseNode;

package/dist/ast/control/ForNode.d.ts

@@ -0,0 +1,13 @@
+import { Attribute } from "../html/Attribute.js";
+import Node from "../base/Node.js";
+import Pos from "../base/Pos.js";
+import { RawChildNode } from "../base/parse5-types.js";
+import { RawASTParserFunction } from "../base/parser-types.js";
+declare class ForNode extends Node {
+    loops: Attribute[];
+    children: Node[];
+    constructor(loops: Attribute[], children: Node[], pos: Pos);
+    getChildren(): Node[];
+    static newFromRawNode(node: RawChildNode, fileName: string, rawAstParserFn: RawASTParserFunction): Node | null;
+}
+export default ForNode;

package/dist/ast/control/ForNode.js

@@ -0,0 +1,37 @@
+import Node from "../base/Node.js";
+import NodeType from "../base/node-types.js";
+import { isRawElementNode } from "../base/parse5-type-guards.js";
+import { getAtAttributes, getPos } from "../../utils/utils.js";
+class ForNode extends Node {
+    loops;
+    children;
+    constructor(loops, children, pos) {
+        super(NodeType.For, pos);
+        this.loops = loops;
+        this.children = children;
+    }
+    getChildren() {
+        return this.children;
+    }
+    static newFromRawNode(node, fileName, rawAstParserFn) {
+        if (!isRawElementNode(node)) {
+            throw new Error(`Expected an element node but found '${node.nodeName}'. ` +
+                `File: ${fileName}, Line: ${node.sourceCodeLocation?.startLine ?? "?"}, Col: ${node.sourceCodeLocation?.startCol ?? "?"}`);
+        }
+        if (node.tagName !== "for") {
+            throw new Error(`Expected element tag name 'for' but found '${node.tagName}'. ` +
+                `File: ${fileName}, Line: ${node.sourceCodeLocation?.startLine ?? "?"}, Col: ${node.sourceCodeLocation?.startCol ?? "?"}`);
+        }
+        const atAttrs = getAtAttributes(node, fileName);
+        if (atAttrs.length < 1) {
+            throw new Error(`Missing @[lang] attribute on <for> tag. ` +
+                `File: ${fileName}, Line: ${node.sourceCodeLocation?.startLine ?? "?"}, Col: ${node.sourceCodeLocation?.startCol ?? "?"}`);
+        }
+        if (node.childNodes.length === 0)
+            return null;
+        const children = rawAstParserFn(node.childNodes, fileName);
+        const pos = getPos(node, fileName);
+        return new ForNode(atAttrs, children, pos);
+    }
+}
+export default ForNode;

package/dist/ast/control/IfNode.d.ts

@@ -0,0 +1,17 @@
+import { Attribute } from "../html/Attribute.js";
+import ElseIfNode from "./ElseIfNode.js";
+import ElseNode from "./ElseNode.js";
+import Node from "../base/Node.js";
+import Pos from "../base/Pos.js";
+import { RawChildNode } from "../base/parse5-types.js";
+import { RawASTParserFunction } from "../base/parser-types.js";
+declare class IfNode extends Node {
+    conditions: Attribute[];
+    ifContent: Node[];
+    elseIfNodes: ElseIfNode[];
+    elseNode?: ElseNode;
+    constructor(conditions: Attribute[], ifContent: Node[], pos: Pos, elseIfNodes?: ElseIfNode[], elseNode?: ElseNode);
+    getChildren(): Node[];
+    static newFromRawNode(node: RawChildNode, fileName: string, rawAstParserFn: RawASTParserFunction): Node | null;
+}
+export default IfNode;

package/dist/ast/control/IfNode.js

@@ -0,0 +1,64 @@
+import ElseIfNode from "./ElseIfNode.js";
+import ElseNode from "./ElseNode.js";
+import Node from "../base/Node.js";
+import NodeType from "../base/node-types.js";
+import { isRawElementNode } from "../base/parse5-type-guards.js";
+import { getAtAttributes, getPos } from "../../utils/utils.js";
+class IfNode extends Node {
+    conditions;
+    ifContent;
+    elseIfNodes;
+    elseNode;
+    constructor(conditions, ifContent, pos, elseIfNodes = [], elseNode) {
+        super(NodeType.If, pos);
+        this.conditions = conditions;
+        this.ifContent = ifContent;
+        this.elseIfNodes = elseIfNodes;
+        this.elseNode = elseNode;
+    }
+    getChildren() {
+        return this.ifContent;
+    }
+    static newFromRawNode(node, fileName, rawAstParserFn) {
+        if (!isRawElementNode(node)) {
+            throw new Error(`Expected an element node but found '${node.nodeName}'. ` +
+                `File: ${fileName}, Line: ${node.sourceCodeLocation?.startLine ?? "?"}, Col: ${node.sourceCodeLocation?.startCol ?? "?"}`);
+        }
+        if (node.tagName !== "if") {
+            throw new Error(`Expected element tag name 'if' but found '${node.tagName}'. ` +
+                `File: ${fileName}, Line: ${node.sourceCodeLocation?.startLine ?? "?"}, Col: ${node.sourceCodeLocation?.startCol ?? "?"}`);
+        }
+        const attributes = getAtAttributes(node, fileName);
+        if (attributes.length < 1) {
+            throw new Error(`Missing @[lang] attribute on <if> tag. ` +
+                `File: ${fileName}, Line: ${node.sourceCodeLocation?.startLine ?? "?"}, Col: ${node.sourceCodeLocation?.startCol ?? "?"}`);
+        }
+        const thenChildren = [];
+        const elseIfChildren = [];
+        let elseNode;
+        const children = rawAstParserFn(node.childNodes, fileName);
+        for (const child of children) {
+            if (child instanceof ElseIfNode) {
+                elseIfChildren.push(child);
+            }
+            else if (child instanceof ElseNode) {
+                if (!elseNode) {
+                    elseNode = child;
+                }
+                else {
+                    throw new Error(`Multiple <else> blocks are not allowed. ` +
+                        `File: ${fileName}, Line: ${child.pos?.startLine}, Col: ${child.pos?.startCol}`);
+                }
+            }
+            else {
+                thenChildren.push(child);
+            }
+        }
+        if (thenChildren.length === 0) {
+            return null;
+        }
+        const pos = getPos(node, fileName);
+        return new IfNode(attributes, thenChildren, pos, elseIfChildren, elseNode);
+    }
+}
+export default IfNode;

package/dist/ast/features/AttrExprNode.d.ts

@@ -0,0 +1 @@
+export default OutNode;

package/dist/ast/features/AttrExprNode.js

@@ -0,0 +1,13 @@
+import Node from "../base/Node.js";
+import NodeType from "../base/node-types.js";
+class AttrExprNode extends Node {
+    data;
+    constructor(data, pos) {
+        super(NodeType.Out, pos);
+        this.data = data;
+    }
+    getChildren() {
+        return [];
+    }
+}
+export default OutNode;

package/dist/ast/features/ContentNode.d.ts

@@ -0,0 +1,12 @@
+import Node from "../base/Node.js";
+import Pos from "../base/Pos.js";
+import { RawChildNode } from "../base/parse5-types.js";
+import { RawASTParserFunction } from "../base/parser-types.js";
+declare class ContentNode extends Node {
+    name: string;
+    children: Node[];
+    constructor(name: string, children: Node[], pos: Pos);
+    getChildren(): Node[];
+    static newFromRawNode(node: RawChildNode, fileName: string, rawAstParserFn: RawASTParserFunction): Node;
+}
+export default ContentNode;

package/dist/ast/features/ContentNode.js

@@ -0,0 +1,44 @@
+import Node from "../base/Node.js";
+import NodeType from "../base/node-types.js";
+import { getAtAttributes, getPos } from "../../utils/utils.js";
+import { isRawElementNode } from "../base/parse5-type-guards.js";
+class ContentNode extends Node {
+    name;
+    children;
+    constructor(name, children, pos) {
+        super(NodeType.Content, pos);
+        this.name = name;
+        this.children = children;
+    }
+    getChildren() {
+        return this.children;
+    }
+    static newFromRawNode(node, fileName, rawAstParserFn) {
+        if (!isRawElementNode(node)) {
+            throw new Error(`Expected an element node but found '${node.nodeName}'. ` +
+                `File: ${fileName}, Line: ${node.sourceCodeLocation?.startLine ?? "?"}, Col: ${node.sourceCodeLocation?.startCol ?? "?"}`);
+        }
+        if (node.tagName !== "content") {
+            throw new Error(`Expected element tag name 'content' but found '${node.tagName}'. ` +
+                `File: ${fileName}, Line: ${node.sourceCodeLocation?.startLine ?? "?"}, Col: ${node.sourceCodeLocation?.startCol ?? "?"}`);
+        }
+        const parentNode = node.parentNode;
+        if (!node.parentNode || !parentNode.tagName || parentNode.tagName !== "include") {
+            throw new Error(`<content> element can only appear inside an <include> element. ` +
+                `File: ${fileName}, Line: ${node.sourceCodeLocation?.startLine ?? "?"}, Col: ${node.sourceCodeLocation?.startCol ?? "?"}`);
+        }
+        const atAttrs = getAtAttributes(node, fileName);
+        if (atAttrs.length < 1) {
+            throw new Error(`Missing @[name] attribute on <content> tag. ` +
+                `File: ${fileName}, Line: ${node.sourceCodeLocation?.startLine ?? "?"}, Col: ${node.sourceCodeLocation?.startCol ?? "?"}`);
+        }
+        else if (atAttrs.length > 1) {
+            throw new Error(`Multiple @ attributes on <content> tag are not allowed: found [${atAttrs.map(a => a.name).join(", ")}]. ` +
+                `File: ${fileName}, Line: ${node.sourceCodeLocation?.startLine ?? "?"}, Col: ${node.sourceCodeLocation?.startCol ?? "?"}`);
+        }
+        const children = rawAstParserFn(node.childNodes, fileName);
+        const pos = getPos(node, fileName);
+        return new ContentNode(atAttrs[0].value, children, pos);
+    }
+}
+export default ContentNode;

package/dist/ast/features/ImportNode.d.ts

@@ -0,0 +1,12 @@
+import Node from "../base/Node.js";
+import Pos from "../base/Pos.js";
+import { RawChildNode } from "../base/parse5-types.js";
+import { RawASTParserFunction } from "../base/parser-types.js";
+declare class ImportNode extends Node {
+    lang: string;
+    data: Node[];
+    constructor(lang: string, data: Node[], pos: Pos);
+    getChildren(): Node[];
+    static newFromRawNode(node: RawChildNode, fileName: string, rawAstParserFn: RawASTParserFunction): Node;
+}
+export default ImportNode;

package/dist/ast/features/ImportNode.js

@@ -0,0 +1,51 @@
+import Node from "../base/Node.js";
+import NodeType from "../base/node-types.js";
+import { isRawCommentNode, isRawElementNode, isRawTextNode } from "../base/parse5-type-guards.js";
+import { getAtAttributes, getPos } from "../../utils/utils.js";
+class ImportNode extends Node {
+    lang;
+    data;
+    constructor(lang, data, pos) {
+        super(NodeType.Import, pos);
+        this.lang = lang;
+        this.data = data;
+    }
+    getChildren() {
+        return this.data;
+    }
+    static newFromRawNode(node, fileName, rawAstParserFn) {
+        if (!isRawElementNode(node)) {
+            throw new Error(`Expected an element node but found '${node.nodeName}'. ` +
+                `File: ${fileName}, Line: ${node.sourceCodeLocation?.startLine ?? "?"}, Col: ${node.sourceCodeLocation?.startCol ?? "?"}`);
+        }
+        if (node.tagName !== "import") {
+            throw new Error(`Expected element tag name 'import' but found '${node.tagName}'. ` +
+                `File: ${fileName}, Line: ${node.sourceCodeLocation?.startLine}, Col: ${node.sourceCodeLocation?.startCol}`);
+        }
+        if (node.parentNode && node.parentNode.nodeName !== "#document-fragment") {
+            throw new Error(`<import> node cannot be a child of another element. ` +
+                `File: ${fileName}, Line: ${node.sourceCodeLocation?.startLine ?? "?"}, Col: ${node.sourceCodeLocation?.startCol ?? "?"}`);
+        }
+        if (node.childNodes.length > 0) {
+            for (const n of node.childNodes) {
+                if (!isRawTextNode(n) && !isRawCommentNode(n)) {
+                    throw new Error(`Invalid child node inside <import>: found '${n.nodeName}' but only text or comment nodes are allowed. ` +
+                        `File: ${fileName}, Line: ${n.sourceCodeLocation?.startLine ?? "?"}, Col: ${n.sourceCodeLocation?.startCol ?? "?"}`);
+                }
+            }
+        }
+        const attributes = getAtAttributes(node, fileName);
+        if (attributes.length === 0) {
+            throw new Error(`Missing @[lang] attribute on <import> tag. ` +
+                `File: ${fileName}, Line: ${node.sourceCodeLocation?.startLine ?? "?"}, Col: ${node.sourceCodeLocation?.startCol ?? "?"}`);
+        }
+        if (attributes.length > 1) {
+            throw new Error(`Multiple @ attributes on <import> tag are not allowed: found [${attributes.map(a => a.name).join(", ")}]. ` +
+                `File: ${fileName}, line ${node.sourceCodeLocation?.startLine ?? "?"}, col ${node.sourceCodeLocation?.startCol ?? "?"}`);
+        }
+        const childNodes = rawAstParserFn(node.childNodes, fileName);
+        const pos = getPos(node, fileName);
+        return new ImportNode(attributes[0].name, childNodes, pos);
+    }
+}
+export default ImportNode;

package/dist/ast/features/IncludeNode.d.ts

@@ -0,0 +1,14 @@
+import Node from "../base/Node.js";
+import Pos from "../base/Pos.js";
+import { RawChildNode } from "../base/parse5-types.js";
+import { RawASTParserFunction } from "../base/parser-types.js";
+import { Attribute } from "../html/Attribute.js";
+declare class IncludeNode extends Node {
+    ctxId: string;
+    path: Attribute;
+    children: Node[];
+    constructor(ctxId: string, path: Attribute, children: Node[], pos: Pos);
+    getChildren(): Node[];
+    static newFromRawNode(node: RawChildNode, fileName: string, rawAstParserFn: RawASTParserFunction): Node;
+}
+export default IncludeNode;