frameyard 0.3.0 → 0.5.0

package/dist/html/parse.d.ts

@@ -0,0 +1,26 @@
+import { type DefaultTreeAdapterTypes } from "parse5";
+import type { SourceLocation } from "../composition/adapter.js";
+export type { SourceLocation } from "../composition/adapter.js";
+export type HtmlDocument = DefaultTreeAdapterTypes.Document;
+export type HtmlElement = DefaultTreeAdapterTypes.Element;
+export type HtmlTemplate = DefaultTreeAdapterTypes.Template;
+export type HtmlNode = DefaultTreeAdapterTypes.Node;
+export type HtmlParentNode = DefaultTreeAdapterTypes.ParentNode;
+export type HtmlTextNode = DefaultTreeAdapterTypes.TextNode;
+export type HtmlDocumentType = DefaultTreeAdapterTypes.DocumentType;
+export declare function parseHtml(html: string): HtmlDocument;
+export declare function isElement(node: HtmlNode): node is HtmlElement;
+export declare function isTemplate(node: HtmlNode): node is HtmlTemplate;
+export declare function isTextNode(node: HtmlNode): node is HtmlTextNode;
+export declare function getAttribute(element: HtmlElement, name: string): string | undefined;
+export declare function hasAttribute(element: HtmlElement, name: string): boolean;
+export declare function getAttributeLocation(element: HtmlElement, name: string): SourceLocation | undefined;
+export declare function getElementLocation(element: HtmlElement): SourceLocation | undefined;
+export declare function getNodeLocation(node: HtmlNode): SourceLocation | undefined;
+export declare function getTextContent(node: HtmlNode): string;
+export declare function walk(node: HtmlNode, visit: (node: HtmlNode) => void): void;
+export declare function findElements(document: HtmlDocument, predicate: (element: HtmlElement) => boolean): HtmlElement[];
+export declare function getDocumentDoctype(document: HtmlDocument): HtmlDocumentType | undefined;
+export declare function getElementByTagName(document: HtmlDocument, tagName: string): HtmlElement | undefined;
+export declare function isDescendantOf(node: HtmlNode, ancestor: HtmlElement): boolean;
+//# sourceMappingURL=parse.d.ts.map

package/dist/html/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/html/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,MAAM,MAAM,YAAY,GAAG,uBAAuB,CAAC,QAAQ,CAAC;AAC5D,MAAM,MAAM,WAAW,GAAG,uBAAuB,CAAC,OAAO,CAAC;AAC1D,MAAM,MAAM,YAAY,GAAG,uBAAuB,CAAC,QAAQ,CAAC;AAC5D,MAAM,MAAM,QAAQ,GAAG,uBAAuB,CAAC,IAAI,CAAC;AACpD,MAAM,MAAM,cAAc,GAAG,uBAAuB,CAAC,UAAU,CAAC;AAChE,MAAM,MAAM,YAAY,GAAG,uBAAuB,CAAC,QAAQ,CAAC;AAC5D,MAAM,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,YAAY,CAAC;AAEpE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAEpD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,IAAI,WAAW,CAE7D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,IAAI,YAAY,CAE/D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,IAAI,YAAY,CAE/D;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnF;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAExE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEnG;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,GAAG,SAAS,CAEnF;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS,CAE1E;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAWrD;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI,CAa1E;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,GAAG,WAAW,EAAE,CAQhH;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,gBAAgB,GAAG,SAAS,CAEvF;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEpG;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAS7E"}

package/dist/html/parse.js

@@ -0,0 +1,80 @@
+import { parse } from "parse5";
+export function parseHtml(html) {
+    return parse(html, { sourceCodeLocationInfo: true });
+}
+export function isElement(node) {
+    return "tagName" in node;
+}
+export function isTemplate(node) {
+    return isElement(node) && node.tagName === "template" && "content" in node;
+}
+export function isTextNode(node) {
+    return node.nodeName === "#text";
+}
+export function getAttribute(element, name) {
+    return element.attrs.find((attribute) => attribute.name === name)?.value;
+}
+export function hasAttribute(element, name) {
+    return element.attrs.some((attribute) => attribute.name === name);
+}
+export function getAttributeLocation(element, name) {
+    return element.sourceCodeLocation?.attrs?.[name] ?? undefined;
+}
+export function getElementLocation(element) {
+    return element.sourceCodeLocation ?? undefined;
+}
+export function getNodeLocation(node) {
+    return node.sourceCodeLocation ?? undefined;
+}
+export function getTextContent(node) {
+    if (isTextNode(node)) {
+        return node.value;
+    }
+    if (isTemplate(node)) {
+        return node.content.childNodes.map((child) => getTextContent(child)).join("");
+    }
+    if (isElement(node)) {
+        return node.childNodes.map((child) => getTextContent(child)).join("");
+    }
+    return "";
+}
+export function walk(node, visit) {
+    visit(node);
+    if (isTemplate(node)) {
+        for (const child of node.content.childNodes) {
+            walk(child, visit);
+        }
+        return;
+    }
+    if ("childNodes" in node) {
+        for (const child of node.childNodes) {
+            walk(child, visit);
+        }
+    }
+}
+export function findElements(document, predicate) {
+    const elements = [];
+    walk(document, (node) => {
+        if (isElement(node) && predicate(node)) {
+            elements.push(node);
+        }
+    });
+    return elements;
+}
+export function getDocumentDoctype(document) {
+    return document.childNodes.find((node) => node.nodeName === "#documentType");
+}
+export function getElementByTagName(document, tagName) {
+    return findElements(document, (element) => element.tagName === tagName)[0];
+}
+export function isDescendantOf(node, ancestor) {
+    let current = "parentNode" in node ? node.parentNode : null;
+    while (current) {
+        if (current === ancestor) {
+            return true;
+        }
+        current = "parentNode" in current ? current.parentNode : null;
+    }
+    return false;
+}
+//# sourceMappingURL=parse.js.map

package/dist/html/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/html/parse.ts"],"names":[],"mappings":"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"}

package/dist/html/validate.d.ts

@@ -0,0 +1,14 @@
+import { type CompositionDiagnostic, type CompositionSourceInfo } from "../contracts.js";
+export interface ValidateHtmlCompositionOptions {
+    projectRoot: string;
+    /** Project-relative path to the composition HTML document. */
+    entry: string;
+    /** External props overrides merged over the document's default props. */
+    props?: unknown;
+}
+export interface StaticValidationResult {
+    info: CompositionSourceInfo | null;
+    diagnostics: CompositionDiagnostic[];
+}
+export declare function validateHtmlComposition(options: ValidateHtmlCompositionOptions): Promise<StaticValidationResult>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/html/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/html/validate.ts"],"names":[],"mappings":"AAgBA,OAAO,EAEL,KAAK,qBAAqB,EAG1B,KAAK,qBAAqB,EAM3B,MAAM,iBAAiB,CAAC;AA0BzB,MAAM,WAAW,8BAA8B;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACnC,WAAW,EAAE,qBAAqB,EAAE,CAAC;CACtC;AAuwBD,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,sBAAsB,CAAC,CAqDjC"}