frameyard 0.7.0 → 0.9.0

package/dist/fonts/verify.js

@@ -0,0 +1,200 @@
+import { open, readdir, stat } from "node:fs/promises";
+import path from "node:path";
+import { hashFile } from "../assets/provenance.js";
+import { FrameyardError } from "../errors.js";
+import { hasFontMagic } from "./binary.js";
+import { fontManifestPath, resolveFontAssetPath } from "./manifest.js";
+import { FONT_ASSET_PREFIX } from "./types.js";
+async function firstBytes(filePath, length) {
+    const handle = await open(filePath, "r");
+    try {
+        const buffer = Buffer.alloc(length);
+        const { bytesRead } = await handle.read(buffer, 0, length, 0);
+        return buffer.subarray(0, bytesRead);
+    }
+    finally {
+        await handle.close();
+    }
+}
+function expectedExtension(format) {
+    return `.${format}`;
+}
+function error(diagnostics, code, message, font, file, details) {
+    diagnostics.push({
+        severity: "error",
+        code,
+        message,
+        font,
+        ...(file !== undefined ? { file: file.path } : {}),
+        ...(details !== undefined ? { details } : {}),
+    });
+}
+function warning(diagnostics, code, message, font, file, details) {
+    diagnostics.push({
+        severity: "warning",
+        code,
+        message,
+        font,
+        ...(file !== undefined ? { file: file.path } : {}),
+        ...(details !== undefined ? { details } : {}),
+    });
+}
+/** Verifies manifest files, hashes, licenses, and orphaned font directories. */
+export async function verifyFontManifest(options) {
+    const diagnostics = [];
+    let files = 0;
+    let bytes = 0;
+    const referencedDirectories = new Set();
+    for (const font of options.manifest.fonts) {
+        referencedDirectories.add(`${FONT_ASSET_PREFIX}${font.id}/`);
+        if (font.license.type === "unknown") {
+            warning(diagnostics, "FONT_LICENSE_MISSING", `Font "${font.family}" has no known license. Add a license before redistributing the project.`, font.id);
+        }
+        if (options.licenses && font.license.file !== undefined) {
+            const licensePath = resolveFontAssetPath(options.projectRoot, font.license.file);
+            try {
+                const info = await stat(licensePath);
+                if (!info.isFile()) {
+                    warning(diagnostics, "FONT_LICENSE_MISSING", `License path for "${font.family}" is not a regular file: ${font.license.file}`, font.id, undefined, { path: font.license.file });
+                }
+            }
+            catch {
+                warning(diagnostics, "FONT_LICENSE_MISSING", `License file for "${font.family}" is missing: ${font.license.file}`, font.id, undefined, { path: font.license.file });
+            }
+        }
+        else if (options.licenses && font.license.file === undefined && font.license.type !== "unknown") {
+            warning(diagnostics, "FONT_LICENSE_MISSING", `Font "${font.family}" records license "${font.license.type}" but no license file.`, font.id, undefined, { license: font.license.type });
+        }
+        for (const file of font.files) {
+            files += 1;
+            const absolute = resolveFontAssetPath(options.projectRoot, file.path);
+            let info;
+            try {
+                info = await stat(absolute);
+            }
+            catch {
+                error(diagnostics, "FONT_FILE_MISSING", `Font file is missing: ${file.path}`, font.id, file);
+                continue;
+            }
+            if (!info.isFile()) {
+                error(diagnostics, "FONT_FILE_INVALID", `Font path is not a regular file: ${file.path}`, font.id, file);
+                continue;
+            }
+            if (info.size !== file.bytes) {
+                error(diagnostics, "FONT_HASH_MISMATCH", `Font file size changed for ${file.path}: manifest says ${file.bytes} bytes, file has ${info.size}.`, font.id, file, { expected: file.bytes, actual: info.size });
+            }
+            if (path.extname(file.path).toLowerCase() !== expectedExtension(file.format)) {
+                error(diagnostics, "FONT_FILE_INVALID", `Font file extension does not match format "${file.format}": ${file.path}`, font.id, file);
+            }
+            try {
+                const magic = await firstBytes(absolute, 4);
+                if (!hasFontMagic(file.format, magic)) {
+                    error(diagnostics, "FONT_FILE_INVALID", `Font file does not have a valid ${file.format} signature: ${file.path}`, font.id, file);
+                }
+            }
+            catch (cause) {
+                error(diagnostics, "FONT_FILE_INVALID", `Could not inspect font file ${file.path}: ${cause instanceof Error ? cause.message : String(cause)}`, font.id, file);
+            }
+            if (options.hashes) {
+                try {
+                    const identity = await hashFile(absolute, { label: `font ${file.path}` });
+                    bytes += identity.bytes;
+                    if (identity.sha256 !== file.sha256.toLowerCase()) {
+                        error(diagnostics, "FONT_HASH_MISMATCH", `Font hash changed for ${file.path}. Run "npx frameyard font add --force" or restore the file.`, font.id, file, { expected: file.sha256, actual: identity.sha256 });
+                    }
+                }
+                catch (cause) {
+                    if (cause instanceof FrameyardError) {
+                        throw cause;
+                    }
+                    error(diagnostics, "FONT_FILE_INVALID", `Could not hash font file ${file.path}: ${cause instanceof Error ? cause.message : String(cause)}`, font.id, file);
+                }
+            }
+            else {
+                bytes += info.size;
+            }
+        }
+    }
+    if (options.orphans === true) {
+        const fontRoot = path.join(path.resolve(options.projectRoot), FONT_ASSET_PREFIX);
+        try {
+            const entries = await readdir(fontRoot, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory()) {
+                    continue;
+                }
+                const directory = `${FONT_ASSET_PREFIX}${entry.name}/`;
+                if (!referencedDirectories.has(directory)) {
+                    warning(diagnostics, "FONT_ORPHANED", `Font directory is not referenced by the manifest: ${directory}`, entry.name, undefined, { path: directory, orphaned: true });
+                }
+            }
+        }
+        catch (cause) {
+            if (cause.code !== "ENOENT") {
+                throw cause;
+            }
+        }
+    }
+    return {
+        manifest: fontManifestPath(options.projectRoot),
+        fonts: options.manifest.fonts.length,
+        files,
+        bytes,
+        diagnostics,
+        valid: !diagnostics.some((diagnostic) => diagnostic.severity === "error"),
+    };
+}
+export function fontStatuses(verification) {
+    const statuses = new Map();
+    for (const diagnostic of verification.diagnostics) {
+        if (diagnostic.font === undefined || diagnostic.severity !== "error") {
+            continue;
+        }
+        const current = statuses.get(diagnostic.font);
+        if (diagnostic.code === "FONT_FILE_INVALID" || diagnostic.code === "FONT_HASH_MISMATCH" || current === "invalid") {
+            statuses.set(diagnostic.font, "invalid");
+        }
+        else {
+            statuses.set(diagnostic.font, "missing");
+        }
+    }
+    return statuses;
+}
+/** Fails before capture when a declared font file is missing or modified. */
+export async function assertFontIntegrity(projectRoot, manifest, options) {
+    if (manifest === undefined || manifest.fonts.length === 0) {
+        return;
+    }
+    const verification = await verifyFontManifest({
+        projectRoot,
+        manifest,
+        hashes: options.hashes,
+        licenses: false,
+        orphans: false,
+    });
+    const firstError = verification.diagnostics.find((diagnostic) => diagnostic.severity === "error");
+    if (firstError) {
+        throw new FrameyardError(firstError.code, firstError.message, {
+            details: {
+                font: firstError.font,
+                file: firstError.file,
+                ...firstError.details,
+            },
+            diagnostics: verification.diagnostics.map((diagnostic) => ({
+                severity: diagnostic.severity,
+                code: diagnostic.code,
+                message: diagnostic.message,
+                ...(diagnostic.font !== undefined || diagnostic.file !== undefined || diagnostic.details !== undefined
+                    ? {
+                        details: {
+                            ...(diagnostic.font !== undefined ? { font: diagnostic.font } : {}),
+                            ...(diagnostic.file !== undefined ? { file: diagnostic.file } : {}),
+                            ...diagnostic.details,
+                        },
+                    }
+                    : {}),
+            })),
+        });
+    }
+}
+//# sourceMappingURL=verify.js.map

package/dist/fonts/verify.js.map

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

package/dist/html/document-adapter.d.ts

@@ -1,5 +1,5 @@
 import type { DocumentAdapter } from "../composition/adapter.js";
-import { type HtmlDocument, type HtmlNode } from "./parse.js";
-/** Adapts a parse5 document to the shared composition reader. */
-export declare function createParse5Adapter(root: HtmlDocument): DocumentAdapter<HtmlNode>;
+import { type HtmlNode, type HtmlRoot } from "./parse.js";
+/** Adapts a parse5 document or fragment to the shared composition reader. */
+export declare function createParse5Adapter(root: HtmlRoot): DocumentAdapter<HtmlNode>;
 //# sourceMappingURL=document-adapter.d.ts.map

package/dist/html/document-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document-adapter.d.ts","sourceRoot":"","sources":["../../src/html/document-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAOL,KAAK,YAAY,EACjB,KAAK,QAAQ,EACd,MAAM,YAAY,CAAC;AAEpB,iEAAiE;AACjE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,eAAe,CAAC,QAAQ,CAAC,CAcjF"}
+{"version":3,"file":"document-adapter.d.ts","sourceRoot":"","sources":["../../src/html/document-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAOL,KAAK,QAAQ,EACb,KAAK,QAAQ,EACd,MAAM,YAAY,CAAC;AAEpB,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC,CAc7E"}

package/dist/html/document-adapter.js

@@ -1,5 +1,5 @@
 import { getAttributeLocation, getElementLocation, getNodeLocation, getTextContent, isElement, isTemplate, } from "./parse.js";
-/** Adapts a parse5 document to the shared composition reader. */
+/** Adapts a parse5 document or fragment to the shared composition reader. */
 export function createParse5Adapter(root) {
     return {
         root,

package/dist/html/document-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"document-adapter.js","sourceRoot":"","sources":["../../src/html/document-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,SAAS,EACT,UAAU,GAGX,MAAM,YAAY,CAAC;AAEpB,iEAAiE;AACjE,MAAM,UAAU,mBAAmB,CAAC,IAAkB;IACpD,OAAO;QACL,IAAI;QACJ,SAAS;QACT,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrG,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;QACnF,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC;QACpC,QAAQ,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,CAC5B,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,IAAI,CAAC;YACxC,CAAC,CAAC,CAAC,oBAAoB,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACrE,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC;KAC5B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"document-adapter.js","sourceRoot":"","sources":["../../src/html/document-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,SAAS,EACT,UAAU,GAGX,MAAM,YAAY,CAAC;AAEpB,6EAA6E;AAC7E,MAAM,UAAU,mBAAmB,CAAC,IAAc;IAChD,OAAO;QACL,IAAI;QACJ,SAAS;QACT,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrG,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;QACnF,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC;QACpC,QAAQ,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,CAC5B,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,IAAI,CAAC;YACxC,CAAC,CAAC,CAAC,oBAAoB,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACrE,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC;KAC5B,CAAC;AACJ,CAAC"}

package/dist/html/index.d.ts

@@ -1,5 +1,5 @@
 export { validateHtmlComposition } from "./validate.js";
 export type { StaticValidationResult, ValidateHtmlCompositionOptions } from "./validate.js";
 export { parseHtml } from "./parse.js";
-export type { HtmlDocument, HtmlElement, HtmlNode, SourceLocation } from "./parse.js";
+export type { HtmlDocument, HtmlDocumentFragment, HtmlElement, HtmlNode, HtmlRoot, SourceLocation } from "./parse.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/html/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,YAAY,EAAE,sBAAsB,EAAE,8BAA8B,EAAE,MAAM,eAAe,CAAC;AAC5F,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/html/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,YAAY,EAAE,sBAAsB,EAAE,8BAA8B,EAAE,MAAM,eAAe,CAAC;AAC5F,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/html/parse.d.ts

@@ -2,6 +2,8 @@ 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 HtmlDocumentFragment = DefaultTreeAdapterTypes.DocumentFragment;
+export type HtmlRoot = HtmlDocument | HtmlDocumentFragment;
 export type HtmlElement = DefaultTreeAdapterTypes.Element;
 export type HtmlTemplate = DefaultTreeAdapterTypes.Template;
 export type HtmlNode = DefaultTreeAdapterTypes.Node;
@@ -9,6 +11,12 @@ export type HtmlParentNode = DefaultTreeAdapterTypes.ParentNode;
 export type HtmlTextNode = DefaultTreeAdapterTypes.TextNode;
 export type HtmlDocumentType = DefaultTreeAdapterTypes.DocumentType;
 export declare function parseHtml(html: string): HtmlDocument;
+/**
+ * Parses an authoring fragment in the browser's body context. Leading
+ * `<style>`, `<script>`, and `<link>` siblings stay in the fragment instead of
+ * being hoisted into an implicit `<head>`.
+ */
+export declare function parseHtmlFragment(source: string): HtmlDocumentFragment;
 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;
@@ -19,8 +27,8 @@ export declare function getElementLocation(element: HtmlElement): SourceLocation
 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 findElements(root: HtmlRoot, 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 getElementByTagName(root: HtmlRoot, 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

@@ -1 +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"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/html/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkD,KAAK,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AACtG,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,oBAAoB,GAAG,uBAAuB,CAAC,gBAAgB,CAAC;AAC5E,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,oBAAoB,CAAC;AAC3D,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;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,CAGtE;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,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,GAAG,WAAW,EAAE,CAQxG;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,gBAAgB,GAAG,SAAS,CAEvF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE5F;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAS7E"}

package/dist/html/parse.js

@@ -1,7 +1,16 @@
-import { parse } from "parse5";
+import { defaultTreeAdapter, html, parse, parseFragment } from "parse5";
 export function parseHtml(html) {
     return parse(html, { sourceCodeLocationInfo: true });
 }
+/**
+ * Parses an authoring fragment in the browser's body context. Leading
+ * `<style>`, `<script>`, and `<link>` siblings stay in the fragment instead of
+ * being hoisted into an implicit `<head>`.
+ */
+export function parseHtmlFragment(source) {
+    const context = defaultTreeAdapter.createElement("body", html.NS.HTML, []);
+    return parseFragment(context, source, { sourceCodeLocationInfo: true });
+}
 export function isElement(node) {
     return "tagName" in node;
 }
@@ -52,9 +61,9 @@ export function walk(node, visit) {
         }
     }
 }
-export function findElements(document, predicate) {
+export function findElements(root, predicate) {
     const elements = [];
-    walk(document, (node) => {
+    walk(root, (node) => {
         if (isElement(node) && predicate(node)) {
             elements.push(node);
         }
@@ -64,8 +73,8 @@ export function findElements(document, predicate) {
 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 getElementByTagName(root, tagName) {
+    return findElements(root, (element) => element.tagName === tagName)[0];
 }
 export function isDescendantOf(node, ancestor) {
     let current = "parentNode" in node ? node.parentNode : null;

package/dist/html/parse.js.map

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

package/dist/html/validate.d.ts

@@ -1,13 +1,24 @@
-import { type CompositionDiagnostic, type CompositionSourceInfo } from "../contracts.js";
+import { type CompositionDiagnostic, type CompositionFormat, 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;
+    /**
+     * Project format used to fill width, height, and fps the composition omits.
+     * Omit it for composition-only projects that declare their own format.
+     */
+    format?: CompositionFormat;
 }
 export interface StaticValidationResult {
     info: CompositionSourceInfo | null;
+    /**
+     * True when the document is otherwise valid but width, height, or fps is
+     * neither declared nor available from a project format. Callers report this
+     * with COMPOSITION_FORMAT_UNRESOLVED instead of a document diagnostic.
+     */
+    formatUnresolved: boolean;
     diagnostics: CompositionDiagnostic[];
 }
 export declare function validateHtmlComposition(options: ValidateHtmlCompositionOptions): Promise<StaticValidationResult>;

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

@@ -1 +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"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/html/validate.ts"],"names":[],"mappings":"AAiBA,OAAO,EAGL,KAAK,qBAAqB,EAE1B,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAQ3B,MAAM,iBAAiB,CAAC;AA2BzB,MAAM,WAAW,8BAA8B;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACnC;;;;OAIG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,qBAAqB,EAAE,CAAC;CACtC;AAwgCD,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,sBAAsB,CAAC,CA2DjC"}