frameyard 0.4.0 → 0.6.0

package/dist/composition/adapter.d.ts

@@ -0,0 +1,30 @@
+export interface SourceLocation {
+    startLine: number;
+    startCol: number;
+    endLine: number;
+    endCol: number;
+}
+export interface DocumentAttribute {
+    name: string;
+    value: string;
+}
+/**
+ * A lazy view over an HTML document tree. The composition reader owns the
+ * traversal and rules; an adapter supplies the tree primitives for parse5 or
+ * the browser DOM.
+ */
+export interface DocumentAdapter<Node> {
+    readonly root: Node;
+    isElement(node: Node): boolean;
+    /** Lowercase tag name for elements; empty for non-elements. */
+    tagName(node: Node): string;
+    attributes(node: Node): readonly DocumentAttribute[];
+    children(node: Node): readonly Node[];
+    /** Template content, or undefined when the node is not a template. */
+    templateContent(node: Node): readonly Node[] | undefined;
+    /** Text content, including descendants for elements. */
+    text(node: Node): string;
+    /** Source location when the adapter can supply one. */
+    location(node: Node, attribute?: string): SourceLocation | undefined;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/composition/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/composition/adapter.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe,CAAC,IAAI;IACnC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;IAC/B,+DAA+D;IAC/D,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC;IAC5B,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,iBAAiB,EAAE,CAAC;IACrD,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,IAAI,EAAE,CAAC;IACtC,sEAAsE;IACtE,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,IAAI,EAAE,GAAG,SAAS,CAAC;IACzD,wDAAwD;IACxD,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC;IACzB,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;CACtE"}

package/dist/composition/adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adapter.js.map

package/dist/composition/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/composition/adapter.ts"],"names":[],"mappings":""}

package/dist/composition/animation.d.ts

@@ -0,0 +1,19 @@
+import type { CompositionDiagnostic } from "../contracts.js";
+import type { DocumentAdapter } from "./adapter.js";
+export interface AnimationDeclaration<Node> {
+    element: Node;
+    startFrame?: number;
+    durationInFrames?: number;
+    easing?: string;
+    attributes: readonly string[];
+}
+export interface ReadAnimationDeclarationsOptions {
+    path: string;
+    includeTemplateContent: boolean;
+}
+export interface AnimationDeclarations<Node> {
+    entries: AnimationDeclaration<Node>[];
+    diagnostics: CompositionDiagnostic[];
+}
+export declare function readAnimationDeclarations<Node>(adapter: DocumentAdapter<Node>, options: ReadAnimationDeclarationsOptions): AnimationDeclarations<Node>;
+//# sourceMappingURL=animation.d.ts.map

package/dist/composition/animation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation.d.ts","sourceRoot":"","sources":["../../src/composition/animation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAKpD,MAAM,WAAW,oBAAoB,CAAC,IAAI;IACxC,OAAO,EAAE,IAAI,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,gCAAgC;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,qBAAqB,CAAC,IAAI;IACzC,OAAO,EAAE,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;IACtC,WAAW,EAAE,qBAAqB,EAAE,CAAC;CACtC;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAC5C,OAAO,EAAE,eAAe,CAAC,IAAI,CAAC,EAC9B,OAAO,EAAE,gCAAgC,GACxC,qBAAqB,CAAC,IAAI,CAAC,CA8E7B"}

package/dist/composition/animation.js

@@ -0,0 +1,55 @@
+import { isAnimationAttribute } from "./attributes.js";
+import { attributeDetails, createDiagnostic } from "./diagnostics.js";
+import { findElements, getAttribute } from "./walk.js";
+export function readAnimationDeclarations(adapter, options) {
+    const diagnostics = [];
+    const entries = [];
+    const targets = findElements(adapter, (node) => adapter.attributes(node).some((attribute) => isAnimationAttribute(attribute.name)), options.includeTemplateContent);
+    for (const target of targets) {
+        const attributes = adapter
+            .attributes(target.node)
+            .filter((attribute) => isAnimationAttribute(attribute.name))
+            .map((attribute) => attribute.name);
+        let startFrame;
+        let durationInFrames;
+        let easing;
+        const start = getAttribute(adapter, target.node, "data-fy-anim-start");
+        if (start !== undefined) {
+            const value = Number(start);
+            if (!/^\d+$/.test(start.trim()) || !Number.isInteger(value) || value < 0) {
+                diagnostics.push(createDiagnostic("error", "ANIMATION_INVALID", "data-fy-anim-start must be a non-negative integer frame count.", attributeDetails(adapter, options.path, target.node, "data-fy-anim-start", { value: start })));
+            }
+            else {
+                startFrame = value;
+            }
+        }
+        const duration = getAttribute(adapter, target.node, "data-fy-anim-duration");
+        if (duration !== undefined) {
+            const value = Number(duration);
+            if (!/^\d+$/.test(duration.trim()) || !Number.isInteger(value) || value <= 0) {
+                diagnostics.push(createDiagnostic("error", "ANIMATION_INVALID", "data-fy-anim-duration must be a positive integer frame count.", attributeDetails(adapter, options.path, target.node, "data-fy-anim-duration", { value: duration })));
+            }
+            else {
+                durationInFrames = value;
+            }
+        }
+        const easingValue = getAttribute(adapter, target.node, "data-fy-anim-easing");
+        if (easingValue !== undefined) {
+            if (easingValue.trim().length === 0) {
+                diagnostics.push(createDiagnostic("error", "ANIMATION_INVALID", "data-fy-anim-easing must not be empty.", attributeDetails(adapter, options.path, target.node, "data-fy-anim-easing")));
+            }
+            else {
+                easing = easingValue;
+            }
+        }
+        entries.push({
+            element: target.node,
+            ...(startFrame !== undefined ? { startFrame } : {}),
+            ...(durationInFrames !== undefined ? { durationInFrames } : {}),
+            ...(easing !== undefined ? { easing } : {}),
+            attributes,
+        });
+    }
+    return { entries, diagnostics };
+}
+//# sourceMappingURL=animation.js.map

package/dist/composition/animation.js.map

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

package/dist/composition/attributes.d.ts

@@ -0,0 +1,7 @@
+export declare const BINDING_ATTRIBUTES: readonly ["data-fy-text", "data-fy-if", "data-fy-repeat"];
+export declare const ANIMATION_ATTRIBUTES: readonly ["data-fy-anim-start", "data-fy-anim-duration", "data-fy-anim-easing"];
+export declare const MEDIA_ATTRIBUTES: readonly ["data-fy-start", "data-fy-trim", "data-fy-duration", "data-fy-volume", "data-fy-audio"];
+export declare const KNOWN_DATA_FY_ATTRIBUTES: readonly ["data-fy", "data-fy-text", "data-fy-if", "data-fy-repeat", "data-fy-anim-start", "data-fy-anim-duration", "data-fy-anim-easing", "data-fy-start", "data-fy-trim", "data-fy-duration", "data-fy-volume", "data-fy-audio"];
+export declare function isAnimationAttribute(name: string): boolean;
+export declare function isMediaAttribute(name: string): boolean;
+//# sourceMappingURL=attributes.d.ts.map

package/dist/composition/attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../../src/composition/attributes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,2DAA4D,CAAC;AAE5F,eAAO,MAAM,oBAAoB,iFAAkF,CAAC;AAEpH,eAAO,MAAM,gBAAgB,mGAMnB,CAAC;AAEX,eAAO,MAAM,wBAAwB,oOAK3B,CAAC;AAKX,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD"}

package/dist/composition/attributes.js

@@ -0,0 +1,24 @@
+export const BINDING_ATTRIBUTES = ["data-fy-text", "data-fy-if", "data-fy-repeat"];
+export const ANIMATION_ATTRIBUTES = ["data-fy-anim-start", "data-fy-anim-duration", "data-fy-anim-easing"];
+export const MEDIA_ATTRIBUTES = [
+    "data-fy-start",
+    "data-fy-trim",
+    "data-fy-duration",
+    "data-fy-volume",
+    "data-fy-audio",
+];
+export const KNOWN_DATA_FY_ATTRIBUTES = [
+    "data-fy",
+    ...BINDING_ATTRIBUTES,
+    ...ANIMATION_ATTRIBUTES,
+    ...MEDIA_ATTRIBUTES,
+];
+const ANIMATION_SET = new Set(ANIMATION_ATTRIBUTES);
+const MEDIA_SET = new Set(MEDIA_ATTRIBUTES);
+export function isAnimationAttribute(name) {
+    return ANIMATION_SET.has(name);
+}
+export function isMediaAttribute(name) {
+    return MEDIA_SET.has(name);
+}
+//# sourceMappingURL=attributes.js.map

package/dist/composition/attributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.js","sourceRoot":"","sources":["../../src/composition/attributes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,cAAc,EAAE,YAAY,EAAE,gBAAgB,CAAU,CAAC;AAE5F,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,oBAAoB,EAAE,uBAAuB,EAAE,qBAAqB,CAAU,CAAC;AAEpH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,eAAe;IACf,cAAc;IACd,kBAAkB;IAClB,gBAAgB;IAChB,eAAe;CACP,CAAC;AAEX,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,SAAS;IACT,GAAG,kBAAkB;IACrB,GAAG,oBAAoB;IACvB,GAAG,gBAAgB;CACX,CAAC;AAEX,MAAM,aAAa,GAAG,IAAI,GAAG,CAAS,oBAAoB,CAAC,CAAC;AAC5D,MAAM,SAAS,GAAG,IAAI,GAAG,CAAS,gBAAgB,CAAC,CAAC;AAEpD,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/composition/descriptor.d.ts

@@ -0,0 +1,30 @@
+import { type CompositionDiagnostic, type CompositionMetadata, type ControllerDeclaration, type Props } from "../contracts.js";
+import type { DocumentAdapter } from "./adapter.js";
+export interface CompositionDescriptor {
+    metadata: CompositionMetadata | null;
+    defaultProps: Readonly<Props>;
+    controller: ControllerDeclaration | null;
+}
+export interface CompositionDescriptorResult<Node> {
+    root: Node | null;
+    descriptor: CompositionDescriptor;
+    valid: boolean;
+    diagnostics: CompositionDiagnostic[];
+}
+export interface ReadCompositionDescriptorOptions {
+    /** Project-relative path to the composition document, used in diagnostics. */
+    path: string;
+    /**
+     * Resolves an external controller's authoring `src` to a project-relative
+     * path. The reader stays pure; the caller supplies the path world.
+     */
+    resolvePath(raw: string): string;
+}
+/**
+ * Reads the fixed facts of an HTML composition: metadata, default props, and
+ * the controller declaration. The reader is pure; the adapter supplies tree
+ * access and source locations, and the caller supplies controller path
+ * resolution.
+ */
+export declare function readCompositionDescriptor<Node>(adapter: DocumentAdapter<Node>, options: ReadCompositionDescriptorOptions): CompositionDescriptorResult<Node>;
+//# sourceMappingURL=descriptor.d.ts.map

package/dist/composition/descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.d.ts","sourceRoot":"","sources":["../../src/composition/descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,qBAAqB,EAE1B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,KAAK,EACX,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAKpD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACrC,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9B,UAAU,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,2BAA2B,CAAC,IAAI;IAC/C,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,UAAU,EAAE,qBAAqB,CAAC;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,qBAAqB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,gCAAgC;IAC/C,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC;AA+UD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAC5C,OAAO,EAAE,eAAe,CAAC,IAAI,CAAC,EAC9B,OAAO,EAAE,gCAAgC,GACxC,2BAA2B,CAAC,IAAI,CAAC,CA2BnC"}

package/dist/composition/descriptor.js

@@ -0,0 +1,188 @@
+import { assertJsonSerializable, isPlainObject, mergeProps, } from "../contracts.js";
+import { errorMessage } from "../errors.js";
+import { attributeDetails, createDiagnostic, elementDetails, lineColumn, locationDetails } from "./diagnostics.js";
+import { isLocalRelative } from "./paths.js";
+import { findElements, getAttribute } from "./walk.js";
+const METADATA_ATTRIBUTES = ["width", "height", "fps", "duration-in-frames"];
+function readRoot(adapter, path) {
+    const diagnostics = [];
+    const roots = findElements(adapter, (node) => adapter.tagName(node) === "fy-composition");
+    if (roots.length === 0) {
+        diagnostics.push(createDiagnostic("error", "COMPOSITION_INVALID", "Composition document must contain one <fy-composition> root.", {
+            path,
+        }));
+        return { root: null, diagnostics };
+    }
+    for (const extra of roots.slice(1)) {
+        diagnostics.push(createDiagnostic("error", "COMPOSITION_INVALID", "Composition document must contain exactly one <fy-composition> root.", elementDetails(adapter, path, extra.node)));
+    }
+    const first = roots[0];
+    if (!first.ancestors.some((ancestor) => adapter.tagName(ancestor) === "body")) {
+        diagnostics.push(createDiagnostic("error", "COMPOSITION_INVALID", "The <fy-composition> root must be inside <body>.", elementDetails(adapter, path, first.node)));
+    }
+    if (first.inTemplate) {
+        diagnostics.push(createDiagnostic("error", "COMPOSITION_INVALID", "The <fy-composition> root must not be inside a <template>.", elementDetails(adapter, path, first.node)));
+    }
+    return { root: first.node, diagnostics };
+}
+function readPositiveInteger(adapter, path, root, attribute, diagnostics) {
+    const raw = getAttribute(adapter, root, attribute);
+    if (raw === undefined) {
+        diagnostics.push(createDiagnostic("error", "COMPOSITION_INVALID", `Missing required "${attribute}" attribute on <fy-composition>.`, attributeDetails(adapter, path, root, attribute)));
+        return null;
+    }
+    const value = Number(raw);
+    if (!/^\d+$/.test(raw.trim()) || !Number.isInteger(value) || value <= 0) {
+        diagnostics.push(createDiagnostic("error", "COMPOSITION_INVALID", `"${attribute}" must be a positive integer; received "${raw}".`, attributeDetails(adapter, path, root, attribute, { value: raw })));
+        return null;
+    }
+    return value;
+}
+function readPositiveNumber(adapter, path, root, attribute, diagnostics) {
+    const raw = getAttribute(adapter, root, attribute);
+    if (raw === undefined) {
+        diagnostics.push(createDiagnostic("error", "COMPOSITION_INVALID", `Missing required "${attribute}" attribute on <fy-composition>.`, attributeDetails(adapter, path, root, attribute)));
+        return null;
+    }
+    const value = Number(raw);
+    if (!Number.isFinite(value) || value <= 0) {
+        diagnostics.push(createDiagnostic("error", "COMPOSITION_INVALID", `"${attribute}" must be a positive number; received "${raw}".`, attributeDetails(adapter, path, root, attribute, { value: raw })));
+        return null;
+    }
+    return value;
+}
+function readMetadata(adapter, path, root) {
+    const diagnostics = [];
+    const values = new Map();
+    for (const attribute of METADATA_ATTRIBUTES) {
+        values.set(attribute, attribute === "fps"
+            ? readPositiveNumber(adapter, path, root, attribute, diagnostics)
+            : readPositiveInteger(adapter, path, root, attribute, diagnostics));
+    }
+    const width = values.get("width") ?? null;
+    const height = values.get("height") ?? null;
+    const fps = values.get("fps") ?? null;
+    const durationInFrames = values.get("duration-in-frames") ?? null;
+    return {
+        metadata: width !== null && height !== null && fps !== null && durationInFrames !== null
+            ? { width, height, fps, durationInFrames }
+            : null,
+        diagnostics,
+    };
+}
+function readDefaultProps(adapter, path) {
+    const diagnostics = [];
+    const blocks = findElements(adapter, (node) => adapter.tagName(node) === "script" &&
+        getAttribute(adapter, node, "type")?.toLowerCase() === "application/json" &&
+        getAttribute(adapter, node, "data-fy") === "props");
+    for (const extra of blocks.slice(1)) {
+        diagnostics.push(createDiagnostic("error", "PROPS_INVALID", 'A composition may contain at most one data-fy="props" block.', elementDetails(adapter, path, extra.node)));
+    }
+    const block = blocks[0];
+    if (!block) {
+        return { defaultProps: Object.freeze({}), diagnostics };
+    }
+    if (block.inTemplate) {
+        diagnostics.push(createDiagnostic("error", "PROPS_INVALID", 'The data-fy="props" block must not be inside a <template>.', elementDetails(adapter, path, block.node)));
+    }
+    try {
+        const parsed = JSON.parse(adapter.text(block.node));
+        if (!isPlainObject(parsed)) {
+            throw new Error('The data-fy="props" block must contain a JSON object.');
+        }
+        assertJsonSerializable(parsed, "defaultProps");
+        return { defaultProps: mergeProps(parsed, undefined), diagnostics };
+    }
+    catch (error) {
+        diagnostics.push(createDiagnostic("error", "PROPS_INVALID", `Invalid default props: ${errorMessage(error)}`, elementDetails(adapter, path, block.node)));
+        return { defaultProps: Object.freeze({}), diagnostics };
+    }
+}
+function readController(adapter, path, resolvePath) {
+    const diagnostics = [];
+    const blocks = findElements(adapter, (node) => adapter.tagName(node) === "script" && getAttribute(adapter, node, "type")?.toLowerCase() === "text/fy-controller");
+    for (const extra of blocks.slice(1)) {
+        diagnostics.push(createDiagnostic("error", "CONTROLLER_INVALID", "A composition may declare at most one controller.", elementDetails(adapter, path, extra.node)));
+    }
+    const block = blocks[0];
+    if (!block) {
+        return { controller: null, diagnostics };
+    }
+    if (block.inTemplate) {
+        diagnostics.push(createDiagnostic("error", "CONTROLLER_INVALID", "The controller block must not be inside a <template>.", elementDetails(adapter, path, block.node)));
+    }
+    const src = getAttribute(adapter, block.node, "src");
+    const source = adapter.text(block.node);
+    const hasSource = source.trim().length > 0;
+    if (src !== undefined && hasSource) {
+        diagnostics.push(createDiagnostic("error", "CONTROLLER_INVALID", "A controller must be either inline or external, not both.", attributeDetails(adapter, path, block.node, "src")));
+        return { controller: null, diagnostics };
+    }
+    if (src === undefined && !hasSource) {
+        diagnostics.push(createDiagnostic("error", "CONTROLLER_INVALID", "A controller must contain inline source or reference an external module with src.", elementDetails(adapter, path, block.node)));
+        return { controller: null, diagnostics };
+    }
+    if (src !== undefined) {
+        const location = adapter.location(block.node, "src") ?? adapter.location(block.node);
+        const pathDetails = {
+            path,
+            element: adapter.tagName(block.node),
+            attribute: "src",
+            ...locationDetails(location),
+            value: src,
+        };
+        if (!isLocalRelative(src)) {
+            diagnostics.push(createDiagnostic("error", "CONTROLLER_INVALID", `Controller path must be a local project file, not "${src}".`, pathDetails));
+            return { controller: { kind: "external", rawSrc: src, ...lineColumn(location) }, diagnostics };
+        }
+        let resolved;
+        try {
+            resolved = resolvePath(src);
+        }
+        catch (error) {
+            diagnostics.push(createDiagnostic("error", "CONTROLLER_INVALID", `Could not resolve controller path "${src}": ${errorMessage(error)}`, pathDetails));
+            return { controller: { kind: "external", rawSrc: src, ...lineColumn(location) }, diagnostics };
+        }
+        return {
+            controller: { kind: "external", rawSrc: src, src: resolved, ...lineColumn(location) },
+            diagnostics,
+        };
+    }
+    const textNode = adapter.children(block.node).find((child) => !adapter.isElement(child));
+    const location = textNode ? adapter.location(textNode) : adapter.location(block.node);
+    return {
+        controller: { kind: "inline", source, ...lineColumn(location) },
+        diagnostics,
+    };
+}
+/**
+ * Reads the fixed facts of an HTML composition: metadata, default props, and
+ * the controller declaration. The reader is pure; the adapter supplies tree
+ * access and source locations, and the caller supplies controller path
+ * resolution.
+ */
+export function readCompositionDescriptor(adapter, options) {
+    const rootRead = readRoot(adapter, options.path);
+    const diagnostics = [...rootRead.diagnostics];
+    let metadata = null;
+    if (rootRead.root) {
+        const metadataRead = readMetadata(adapter, options.path, rootRead.root);
+        metadata = metadataRead.metadata;
+        diagnostics.push(...metadataRead.diagnostics);
+    }
+    const propsRead = readDefaultProps(adapter, options.path);
+    diagnostics.push(...propsRead.diagnostics);
+    const controllerRead = readController(adapter, options.path, options.resolvePath);
+    diagnostics.push(...controllerRead.diagnostics);
+    return {
+        root: rootRead.root,
+        descriptor: {
+            metadata,
+            defaultProps: propsRead.defaultProps,
+            controller: controllerRead.controller,
+        },
+        valid: !diagnostics.some((diagnostic) => diagnostic.severity === "error"),
+        diagnostics,
+    };
+}
+//# sourceMappingURL=descriptor.js.map

package/dist/composition/descriptor.js.map

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

package/dist/composition/diagnostics.d.ts

@@ -0,0 +1,12 @@
+import type { CompositionDiagnostic, CompositionDiagnosticDetails, DiagnosticSeverity } from "../contracts.js";
+import type { FrameyardErrorCode } from "../errors.js";
+import type { DocumentAdapter, SourceLocation } from "./adapter.js";
+export declare function createDiagnostic(severity: DiagnosticSeverity, code: FrameyardErrorCode, message: string, details: CompositionDiagnosticDetails): CompositionDiagnostic;
+export declare function locationDetails(location: SourceLocation | undefined): CompositionDiagnosticDetails;
+export declare function lineColumn(location: SourceLocation | undefined): {
+    line?: number;
+    column?: number;
+};
+export declare function elementDetails<Node>(adapter: DocumentAdapter<Node>, path: string, node: Node, extra?: CompositionDiagnosticDetails): CompositionDiagnosticDetails;
+export declare function attributeDetails<Node>(adapter: DocumentAdapter<Node>, path: string, node: Node, attribute: string, extra?: CompositionDiagnosticDetails): CompositionDiagnosticDetails;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/composition/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/composition/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC/G,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEpE,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,kBAAkB,EAC5B,IAAI,EAAE,kBAAkB,EACxB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,4BAA4B,GACpC,qBAAqB,CAEvB;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,GAAG,4BAA4B,CAUlG;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAKnG;AAED,wBAAgB,cAAc,CAAC,IAAI,EACjC,OAAO,EAAE,eAAe,CAAC,IAAI,CAAC,EAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,IAAI,EACV,KAAK,GAAE,4BAAiC,GACvC,4BAA4B,CAO9B;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EACnC,OAAO,EAAE,eAAe,CAAC,IAAI,CAAC,EAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,4BAAiC,GACvC,4BAA4B,CAQ9B"}

package/dist/composition/diagnostics.js

@@ -0,0 +1,38 @@
+export function createDiagnostic(severity, code, message, details) {
+    return { severity, code, message, details };
+}
+export function locationDetails(location) {
+    if (!location) {
+        return {};
+    }
+    return {
+        line: location.startLine,
+        column: location.startCol,
+        endLine: location.endLine,
+        endColumn: location.endCol,
+    };
+}
+export function lineColumn(location) {
+    if (!location) {
+        return {};
+    }
+    return { line: location.startLine, column: location.startCol };
+}
+export function elementDetails(adapter, path, node, extra = {}) {
+    return {
+        path,
+        element: adapter.tagName(node),
+        ...locationDetails(adapter.location(node)),
+        ...extra,
+    };
+}
+export function attributeDetails(adapter, path, node, attribute, extra = {}) {
+    return {
+        path,
+        element: adapter.tagName(node),
+        attribute,
+        ...locationDetails(adapter.location(node, attribute) ?? adapter.location(node)),
+        ...extra,
+    };
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/composition/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/composition/diagnostics.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,gBAAgB,CAC9B,QAA4B,EAC5B,IAAwB,EACxB,OAAe,EACf,OAAqC;IAErC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAoC;IAClE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,SAAS;QACxB,MAAM,EAAE,QAAQ,CAAC,QAAQ;QACzB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,SAAS,EAAE,QAAQ,CAAC,MAAM;KAC3B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAoC;IAC7D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,OAA8B,EAC9B,IAAY,EACZ,IAAU,EACV,QAAsC,EAAE;IAExC,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QAC9B,GAAG,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC1C,GAAG,KAAK;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,OAA8B,EAC9B,IAAY,EACZ,IAAU,EACV,SAAiB,EACjB,QAAsC,EAAE;IAExC,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QAC9B,SAAS;QACT,GAAG,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC/E,GAAG,KAAK;KACT,CAAC;AACJ,CAAC"}

package/dist/composition/index.d.ts

@@ -0,0 +1,12 @@
+export { readCompositionDescriptor } from "./descriptor.js";
+export type { CompositionDescriptor, CompositionDescriptorResult, ReadCompositionDescriptorOptions, } from "./descriptor.js";
+export { readAnimationDeclarations } from "./animation.js";
+export type { AnimationDeclaration, AnimationDeclarations, ReadAnimationDeclarationsOptions } from "./animation.js";
+export { readMediaDeclarations, readMediaSpec } from "./media.js";
+export type { MediaDeclaration, MediaDeclarations, MediaSpec, ReadMediaDeclarationsOptions } from "./media.js";
+export { readTranscriptDeclarations } from "./transcripts.js";
+export type { ReadTranscriptDeclarationsOptions, TranscriptDeclaration, TranscriptDeclarations, } from "./transcripts.js";
+export { KNOWN_DATA_FY_ATTRIBUTES, isAnimationAttribute, isMediaAttribute } from "./attributes.js";
+export type { DocumentAdapter, DocumentAttribute, SourceLocation } from "./adapter.js";
+export { isLocalRelative, isRemote } from "./paths.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/composition/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EACV,qBAAqB,EACrB,2BAA2B,EAC3B,gCAAgC,GACjC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,YAAY,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,gCAAgC,EAAE,MAAM,gBAAgB,CAAC;AACpH,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAClE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,SAAS,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAC/G,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC9D,YAAY,EACV,iCAAiC,EACjC,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnG,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/composition/index.js

@@ -0,0 +1,7 @@
+export { readCompositionDescriptor } from "./descriptor.js";
+export { readAnimationDeclarations } from "./animation.js";
+export { readMediaDeclarations, readMediaSpec } from "./media.js";
+export { readTranscriptDeclarations } from "./transcripts.js";
+export { KNOWN_DATA_FY_ATTRIBUTES, isAnimationAttribute, isMediaAttribute } from "./attributes.js";
+export { isLocalRelative, isRemote } from "./paths.js";
+//# sourceMappingURL=index.js.map

package/dist/composition/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/composition/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAM5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAElE,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAM9D,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnG,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/composition/media.d.ts

@@ -0,0 +1,27 @@
+import { type CompositionDiagnostic, type Props, type ResolvedAudioClip } from "../contracts.js";
+import type { DocumentAdapter } from "./adapter.js";
+export interface MediaDeclaration<Node> {
+    clip: ResolvedAudioClip;
+    element: Node;
+}
+export interface MediaDeclarations<Node> {
+    audio: MediaDeclaration<Node>[];
+    embedded: MediaDeclaration<Node>[];
+    diagnostics: CompositionDiagnostic[];
+}
+export interface ReadMediaDeclarationsOptions {
+    path: string;
+    includeTemplateContent: boolean;
+    props: Readonly<Props>;
+    /** True after the host has applied bindings; the resolved src wins over the binding attribute. */
+    bindingsApplied?: boolean;
+}
+export interface MediaSpec {
+    startFrame: number;
+    trimStart: number;
+    trimDuration?: number;
+    volume: number;
+}
+export declare function readMediaSpec<Node>(adapter: DocumentAdapter<Node>, path: string, element: Node, diagnostics: CompositionDiagnostic[], defaultVolume?: number): MediaSpec | null;
+export declare function readMediaDeclarations<Node>(adapter: DocumentAdapter<Node>, options: ReadMediaDeclarationsOptions): MediaDeclarations<Node>;
+//# sourceMappingURL=media.d.ts.map

package/dist/composition/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../src/composition/media.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,KAAK,qBAAqB,EAAE,KAAK,KAAK,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAErH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAMpD,MAAM,WAAW,gBAAgB,CAAC,IAAI;IACpC,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB,CAAC,IAAI;IACrC,KAAK,EAAE,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;IAChC,QAAQ,EAAE,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;IACnC,WAAW,EAAE,qBAAqB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB,EAAE,OAAO,CAAC;IAChC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvB,kGAAkG;IAClG,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAChC,OAAO,EAAE,eAAe,CAAC,IAAI,CAAC,EAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,IAAI,EACb,WAAW,EAAE,qBAAqB,EAAE,EACpC,aAAa,SAAI,GAChB,SAAS,GAAG,IAAI,CAqGlB;AAoED,wBAAgB,qBAAqB,CAAC,IAAI,EACxC,OAAO,EAAE,eAAe,CAAC,IAAI,CAAC,EAC9B,OAAO,EAAE,4BAA4B,GACpC,iBAAiB,CAAC,IAAI,CAAC,CAsGzB"}