frameyard 0.4.0 → 0.5.0

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":"AAAA,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,UAAU,GAMX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAqB,MAAM,WAAW,CAAC;AAyB1E,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,oBAAoB,CAAU,CAAC;AAEtF,SAAS,QAAQ,CACf,OAA8B,EAC9B,IAAY;IAEZ,MAAM,WAAW,GAA4B,EAAE,CAAC;IAChD,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,gBAAgB,CAAC,CAAC;IAE1F,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,WAAW,CAAC,IAAI,CACd,gBAAgB,CAAC,OAAO,EAAE,qBAAqB,EAAE,8DAA8D,EAAE;YAC/G,IAAI;SACL,CAAC,CACH,CAAC;QACF,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IACrC,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,WAAW,CAAC,IAAI,CACd,gBAAgB,CACd,OAAO,EACP,qBAAqB,EACrB,sEAAsE,EACtE,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAC1C,CACF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAuB,CAAC;IAC7C,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC,EAAE,CAAC;QAC9E,WAAW,CAAC,IAAI,CACd,gBAAgB,CACd,OAAO,EACP,qBAAqB,EACrB,kDAAkD,EAClD,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAC1C,CACF,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,WAAW,CAAC,IAAI,CACd,gBAAgB,CACd,OAAO,EACP,qBAAqB,EACrB,4DAA4D,EAC5D,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAC1C,CACF,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,mBAAmB,CAC1B,OAA8B,EAC9B,IAAY,EACZ,IAAU,EACV,SAAiB,EACjB,WAAoC;IAEpC,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IACnD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,WAAW,CAAC,IAAI,CACd,gBAAgB,CACd,OAAO,EACP,qBAAqB,EACrB,qBAAqB,SAAS,kCAAkC,EAChE,gBAAgB,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CACjD,CACF,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACxE,WAAW,CAAC,IAAI,CACd,gBAAgB,CACd,OAAO,EACP,qBAAqB,EACrB,IAAI,SAAS,2CAA2C,GAAG,IAAI,EAC/D,gBAAgB,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CACjE,CACF,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,kBAAkB,CACzB,OAA8B,EAC9B,IAAY,EACZ,IAAU,EACV,SAAiB,EACjB,WAAoC;IAEpC,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IACnD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,WAAW,CAAC,IAAI,CACd,gBAAgB,CACd,OAAO,EACP,qBAAqB,EACrB,qBAAqB,SAAS,kCAAkC,EAChE,gBAAgB,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CACjD,CACF,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1C,WAAW,CAAC,IAAI,CACd,gBAAgB,CACd,OAAO,EACP,qBAAqB,EACrB,IAAI,SAAS,0CAA0C,GAAG,IAAI,EAC9D,gBAAgB,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CACjE,CACF,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CACnB,OAA8B,EAC9B,IAAY,EACZ,IAAU;IAEV,MAAM,WAAW,GAA4B,EAAE,CAAC;IAChD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuD,CAAC;IAE9E,KAAK,MAAM,SAAS,IAAI,mBAAmB,EAAE,CAAC;QAC5C,MAAM,CAAC,GAAG,CACR,SAAS,EACT,SAAS,KAAK,KAAK;YACjB,CAAC,CAAC,kBAAkB,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC;YACjE,CAAC,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,CACrE,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;IAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;IAC5C,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;IACtC,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,IAAI,CAAC;IAElE,OAAO;QACL,QAAQ,EACN,KAAK,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI,IAAI,GAAG,KAAK,IAAI,IAAI,gBAAgB,KAAK,IAAI;YAC5E,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,EAAE;YAC1C,CAAC,CAAC,IAAI;QACV,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CACvB,OAA8B,EAC9B,IAAY;IAEZ,MAAM,WAAW,GAA4B,EAAE,CAAC;IAChD,MAAM,MAAM,GAAG,YAAY,CACzB,OAAO,EACP,CAAC,IAAI,EAAE,EAAE,CACP,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,QAAQ;QAClC,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,KAAK,kBAAkB;QACzE,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,KAAK,OAAO,CACrD,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACpC,WAAW,CAAC,IAAI,CACd,gBAAgB,CACd,OAAO,EACP,eAAe,EACf,8DAA8D,EAC9D,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAC1C,CACF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAoB,EAAE,WAAW,EAAE,CAAC;IAC7E,CAAC;IAED,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,WAAW,CAAC,IAAI,CACd,gBAAgB,CACd,OAAO,EACP,eAAe,EACf,4DAA4D,EAC5D,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAC1C,CACF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7D,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3E,CAAC;QACD,sBAAsB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QAC/C,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,MAAe,EAAE,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC/E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,WAAW,CAAC,IAAI,CACd,gBAAgB,CACd,OAAO,EACP,eAAe,EACf,0BAA0B,YAAY,CAAC,KAAK,CAAC,EAAE,EAC/C,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAC1C,CACF,CAAC;QACF,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAoB,EAAE,WAAW,EAAE,CAAC;IAC7E,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CACrB,OAA8B,EAC9B,IAAY,EACZ,WAAoC;IAEpC,MAAM,WAAW,GAA4B,EAAE,CAAC;IAChD,MAAM,MAAM,GAAG,YAAY,CACzB,OAAO,EACP,CAAC,IAAI,EAAE,EAAE,CACP,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,QAAQ,IAAI,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,KAAK,oBAAoB,CACpH,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACpC,WAAW,CAAC,IAAI,CACd,gBAAgB,CACd,OAAO,EACP,oBAAoB,EACpB,mDAAmD,EACnD,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAC1C,CACF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC3C,CAAC;IAED,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,WAAW,CAAC,IAAI,CACd,gBAAgB,CACd,OAAO,EACP,oBAAoB,EACpB,uDAAuD,EACvD,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAC1C,CACF,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IAE3C,IAAI,GAAG,KAAK,SAAS,IAAI,SAAS,EAAE,CAAC;QACnC,WAAW,CAAC,IAAI,CACd,gBAAgB,CACd,OAAO,EACP,oBAAoB,EACpB,2DAA2D,EAC3D,gBAAgB,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CACnD,CACF,CAAC;QACF,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC3C,CAAC;IAED,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,SAAS,EAAE,CAAC;QACpC,WAAW,CAAC,IAAI,CACd,gBAAgB,CACd,OAAO,EACP,oBAAoB,EACpB,mFAAmF,EACnF,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAC1C,CACF,CAAC;QACF,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC3C,CAAC;IAED,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrF,MAAM,WAAW,GAAiC;YAChD,IAAI;YACJ,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;YACpC,SAAS,EAAE,KAAK;YAChB,GAAG,eAAe,CAAC,QAAQ,CAAC;YAC5B,KAAK,EAAE,GAAG;SACX,CAAC;QAEF,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,WAAW,CAAC,IAAI,CACd,gBAAgB,CACd,OAAO,EACP,oBAAoB,EACpB,sDAAsD,GAAG,IAAI,EAC7D,WAAW,CACZ,CACF,CAAC;YACF,OAAO,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,UAAU,CAAC,QAAQ,CAAC,EAAE,EAAE,WAAW,EAAE,CAAC;QACjG,CAAC;QAED,IAAI,QAAgB,CAAC;QACrB,IAAI,CAAC;YACH,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,IAAI,CACd,gBAAgB,CACd,OAAO,EACP,oBAAoB,EACpB,sCAAsC,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,EAAE,EACpE,WAAW,CACZ,CACF,CAAC;YACF,OAAO,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,UAAU,CAAC,QAAQ,CAAC,EAAE,EAAE,WAAW,EAAE,CAAC;QACjG,CAAC;QAED,OAAO;YACL,UAAU,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,UAAU,CAAC,QAAQ,CAAC,EAAE;YACrF,WAAW;SACZ,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACzF,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtF,OAAO;QACL,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,QAAQ,CAAC,EAAE;QAC/D,WAAW;KACZ,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAA8B,EAC9B,OAAyC;IAEzC,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;IAE9C,IAAI,QAAQ,GAA+B,IAAI,CAAC;IAChD,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,YAAY,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxE,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC;QACjC,WAAW,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,WAAW,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IAE3C,MAAM,cAAc,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAClF,WAAW,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAEhD,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,UAAU,EAAE;YACV,QAAQ;YACR,YAAY,EAAE,SAAS,CAAC,YAAY;YACpC,UAAU,EAAE,cAAc,CAAC,UAAU;SACtC;QACD,KAAK,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,KAAK,OAAO,CAAC;QACzE,WAAW;KACZ,CAAC;AACJ,CAAC"}

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"}

package/dist/composition/media.js

@@ -0,0 +1,162 @@
+import { resolveBindingPath } from "../bindings.js";
+import { normalizeAudioClip } from "../contracts.js";
+import { errorMessage, isFrameyardError } from "../errors.js";
+import { isMediaAttribute } from "./attributes.js";
+import { attributeDetails, createDiagnostic, elementDetails } from "./diagnostics.js";
+import { isLocalRelative, normalizeLocalPath } from "./paths.js";
+import { findElements, getAttribute, hasAttribute } from "./walk.js";
+export function readMediaSpec(adapter, path, element, diagnostics, defaultVolume = 1) {
+    let valid = true;
+    const startRaw = getAttribute(adapter, element, "data-fy-start");
+    let startFrame = 0;
+    if (startRaw !== undefined) {
+        const value = Number(startRaw);
+        if (!/^\d+$/.test(startRaw.trim()) || !Number.isInteger(value) || value < 0) {
+            diagnostics.push(createDiagnostic("error", "MEDIA_INVALID", "data-fy-start must be a non-negative integer frame.", attributeDetails(adapter, path, element, "data-fy-start", { value: startRaw })));
+            valid = false;
+        }
+        else {
+            startFrame = value;
+        }
+    }
+    const trimRaw = getAttribute(adapter, element, "data-fy-trim");
+    let trimStart = 0;
+    if (trimRaw !== undefined) {
+        const value = Number(trimRaw);
+        if (!Number.isFinite(value) || value < 0) {
+            diagnostics.push(createDiagnostic("error", "MEDIA_INVALID", "data-fy-trim must be a non-negative number of seconds.", attributeDetails(adapter, path, element, "data-fy-trim", { value: trimRaw })));
+            valid = false;
+        }
+        else {
+            trimStart = value;
+        }
+    }
+    const durationRaw = getAttribute(adapter, element, "data-fy-duration");
+    let trimDuration;
+    if (durationRaw !== undefined) {
+        const value = Number(durationRaw);
+        if (!Number.isFinite(value) || value <= 0) {
+            diagnostics.push(createDiagnostic("error", "MEDIA_INVALID", "data-fy-duration must be a positive number of seconds.", attributeDetails(adapter, path, element, "data-fy-duration", { value: durationRaw })));
+            valid = false;
+        }
+        else {
+            trimDuration = value;
+        }
+    }
+    const audio = getAttribute(adapter, element, "data-fy-audio");
+    if (audio !== undefined && (adapter.tagName(element) !== "video" || audio !== "off")) {
+        diagnostics.push(createDiagnostic("error", "MEDIA_INVALID", 'data-fy-audio is only valid on <video> with the value "off".', attributeDetails(adapter, path, element, "data-fy-audio", { value: audio })));
+        valid = false;
+    }
+    const volumeRaw = getAttribute(adapter, element, "data-fy-volume");
+    let volume = hasAttribute(adapter, element, "muted") ? 0 : defaultVolume;
+    if (volumeRaw !== undefined) {
+        const value = Number(volumeRaw);
+        if (!Number.isFinite(value) || value < 0 || value > 1) {
+            diagnostics.push(createDiagnostic("error", "MEDIA_INVALID", "data-fy-volume must be between 0 and 1.", attributeDetails(adapter, path, element, "data-fy-volume", { value: volumeRaw })));
+            valid = false;
+        }
+        else if (!hasAttribute(adapter, element, "muted")) {
+            volume = value;
+        }
+    }
+    if (!valid) {
+        return null;
+    }
+    return {
+        startFrame,
+        trimStart,
+        ...(trimDuration !== undefined ? { trimDuration } : {}),
+        volume,
+    };
+}
+function resolveMediaSource(adapter, path, element, props, bindingsApplied, diagnostics) {
+    const literal = getAttribute(adapter, element, "src");
+    const bound = getAttribute(adapter, element, "data-fy-attr-src");
+    if (bindingsApplied && literal !== undefined) {
+        return literal;
+    }
+    if (literal !== undefined && bound !== undefined) {
+        diagnostics.push(createDiagnostic("error", "MEDIA_INVALID", `Use either src or data-fy-attr-src on <${adapter.tagName(element)}>, not both.`, elementDetails(adapter, path, element)));
+        return null;
+    }
+    if (literal === undefined && bound === undefined) {
+        diagnostics.push(createDiagnostic("error", "MEDIA_INVALID", `<${adapter.tagName(element)}> requires a src attribute or data-fy-attr-src binding.`, elementDetails(adapter, path, element)));
+        return null;
+    }
+    if (literal !== undefined) {
+        return literal;
+    }
+    const root = bound.split(".")[0];
+    if (root === "item" || root === "index") {
+        return null;
+    }
+    const resolved = resolveBindingPath({ props }, bound);
+    if (!resolved.found) {
+        return null;
+    }
+    if (typeof resolved.value !== "string" || resolved.value.length === 0) {
+        diagnostics.push(createDiagnostic("error", "MEDIA_INVALID", `Media binding "${bound}" must resolve to a non-empty local path.`, elementDetails(adapter, path, element, { value: bound })));
+        return null;
+    }
+    return resolved.value;
+}
+export function readMediaDeclarations(adapter, options) {
+    const diagnostics = [];
+    const audio = [];
+    const embedded = [];
+    const candidates = findElements(adapter, (node) => {
+        const tag = adapter.tagName(node);
+        return (tag === "audio" ||
+            tag === "video" ||
+            adapter.attributes(node).some((attribute) => isMediaAttribute(attribute.name)));
+    }, options.includeTemplateContent);
+    let index = 0;
+    for (const candidate of candidates) {
+        const tag = adapter.tagName(candidate.node);
+        const attributes = adapter.attributes(candidate.node).filter((attribute) => isMediaAttribute(attribute.name));
+        if (tag !== "audio" && tag !== "video") {
+            for (const attribute of attributes) {
+                diagnostics.push(createDiagnostic("error", "MEDIA_INVALID", `${attribute.name} is only valid on <audio> or <video>.`, attributeDetails(adapter, options.path, candidate.node, attribute.name)));
+            }
+            continue;
+        }
+        const spec = readMediaSpec(adapter, options.path, candidate.node, diagnostics);
+        if (!spec) {
+            continue;
+        }
+        const source = resolveMediaSource(adapter, options.path, candidate.node, options.props, options.bindingsApplied === true, diagnostics);
+        if (source === null) {
+            continue;
+        }
+        if (!isLocalRelative(source)) {
+            diagnostics.push(createDiagnostic("error", "MEDIA_INVALID", `Media path must be a local project file, not "${source}".`, elementDetails(adapter, options.path, candidate.node, { value: source })));
+            continue;
+        }
+        let clip;
+        try {
+            clip = normalizeAudioClip({
+                src: normalizeLocalPath(source),
+                startFrame: spec.startFrame,
+                trimStart: spec.trimStart,
+                ...(spec.trimDuration !== undefined ? { trimDuration: spec.trimDuration } : {}),
+                volume: spec.volume,
+            }, index);
+        }
+        catch (error) {
+            diagnostics.push(createDiagnostic("error", isFrameyardError(error) ? error.code : "MEDIA_INVALID", errorMessage(error), elementDetails(adapter, options.path, candidate.node)));
+            continue;
+        }
+        index += 1;
+        const declaration = { clip, element: candidate.node };
+        if (tag === "audio") {
+            audio.push(declaration);
+        }
+        else if (!hasAttribute(adapter, candidate.node, "muted") &&
+            getAttribute(adapter, candidate.node, "data-fy-audio") !== "off") {
+            embedded.push(declaration);
+        }
+    }
+    return { audio, embedded, diagnostics };
+}
+//# sourceMappingURL=media.js.map

package/dist/composition/media.js.map

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

package/dist/composition/paths.d.ts

@@ -0,0 +1,5 @@
+export declare function isRemote(value: string): boolean;
+export declare function isLocalRelative(value: string): boolean;
+/** Normalizes an authoring path to the project-relative form used in clips. */
+export declare function normalizeLocalPath(value: string): string;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/composition/paths.ts"],"names":[],"mappings":"AAEA,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMxD"}

package/dist/composition/paths.js

@@ -0,0 +1,16 @@
+const SCHEME = /^[a-zA-Z][a-zA-Z0-9+.-]*:/;
+export function isRemote(value) {
+    return SCHEME.test(value) || value.startsWith("//");
+}
+export function isLocalRelative(value) {
+    return !SCHEME.test(value) && !value.startsWith("/") && !value.includes("\\") && !value.split("/").includes("..");
+}
+/** Normalizes an authoring path to the project-relative form used in clips. */
+export function normalizeLocalPath(value) {
+    let normalized = value;
+    while (normalized.startsWith("./")) {
+        normalized = normalized.slice(2);
+    }
+    return normalized;
+}
+//# sourceMappingURL=paths.js.map

package/dist/composition/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/composition/paths.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,2BAA2B,CAAC;AAE3C,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACpH,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,OAAO,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/composition/transcripts.d.ts

@@ -0,0 +1,19 @@
+import { type CompositionDiagnostic, type Props, type ResolvedTranscriptClip } from "../contracts.js";
+import type { DocumentAdapter } from "./adapter.js";
+export interface TranscriptDeclaration<Node> {
+    clip: ResolvedTranscriptClip;
+    element: Node;
+}
+export interface TranscriptDeclarations<Node> {
+    declarations: TranscriptDeclaration<Node>[];
+    diagnostics: CompositionDiagnostic[];
+}
+export interface ReadTranscriptDeclarationsOptions {
+    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 declare function readTranscriptDeclarations<Node>(adapter: DocumentAdapter<Node>, options: ReadTranscriptDeclarationsOptions): TranscriptDeclarations<Node>;
+//# sourceMappingURL=transcripts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transcripts.d.ts","sourceRoot":"","sources":["../../src/composition/transcripts.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,KAAK,EACV,KAAK,sBAAsB,EAC5B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAKpD,MAAM,WAAW,qBAAqB,CAAC,IAAI;IACzC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB,CAAC,IAAI;IAC1C,YAAY,EAAE,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC;IAC5C,WAAW,EAAE,qBAAqB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,iCAAiC;IAChD,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,wBAAgB,0BAA0B,CAAC,IAAI,EAC7C,OAAO,EAAE,eAAe,CAAC,IAAI,CAAC,EAC9B,OAAO,EAAE,iCAAiC,GACzC,sBAAsB,CAAC,IAAI,CAAC,CAkG9B"}

package/dist/composition/transcripts.js

@@ -0,0 +1,57 @@
+import { resolveBindingPath } from "../bindings.js";
+import { normalizeTranscriptClip, } from "../contracts.js";
+import { errorMessage, isFrameyardError } from "../errors.js";
+import { createDiagnostic, elementDetails } from "./diagnostics.js";
+import { isLocalRelative, normalizeLocalPath } from "./paths.js";
+import { findElements, getAttribute, hasAttribute } from "./walk.js";
+export function readTranscriptDeclarations(adapter, options) {
+    const diagnostics = [];
+    const declarations = [];
+    const candidates = findElements(adapter, (node) => adapter.tagName(node) === "fy-transcript", options.includeTemplateContent);
+    let index = 0;
+    for (const candidate of candidates) {
+        const literal = getAttribute(adapter, candidate.node, "src");
+        const bound = getAttribute(adapter, candidate.node, "data-fy-attr-src");
+        if (!(options.bindingsApplied === true && literal !== undefined) && literal !== undefined && bound !== undefined) {
+            diagnostics.push(createDiagnostic("error", "TRANSCRIPT_INVALID", "Use either src or data-fy-attr-src on <fy-transcript>, not both.", elementDetails(adapter, options.path, candidate.node)));
+            continue;
+        }
+        if (literal === undefined && bound === undefined) {
+            diagnostics.push(createDiagnostic("error", "TRANSCRIPT_INVALID", "<fy-transcript> requires a src attribute or data-fy-attr-src binding.", elementDetails(adapter, options.path, candidate.node)));
+            continue;
+        }
+        let source = literal ?? null;
+        if (source === null && bound !== undefined) {
+            const root = bound.split(".")[0];
+            if (root === "item" || root === "index") {
+                continue;
+            }
+            const resolved = resolveBindingPath({ props: options.props }, bound);
+            if (!resolved.found) {
+                continue;
+            }
+            if (typeof resolved.value !== "string" || resolved.value.length === 0) {
+                diagnostics.push(createDiagnostic("error", "TRANSCRIPT_INVALID", `Transcript binding "${bound}" must resolve to a non-empty local path.`, elementDetails(adapter, options.path, candidate.node, { value: bound })));
+                continue;
+            }
+            source = resolved.value;
+        }
+        if (source === null) {
+            continue;
+        }
+        if (!isLocalRelative(source)) {
+            diagnostics.push(createDiagnostic("error", "TRANSCRIPT_INVALID", `Transcript path must be a local project file, not "${source}".`, elementDetails(adapter, options.path, candidate.node, { value: source })));
+            continue;
+        }
+        try {
+            const clip = normalizeTranscriptClip({ src: normalizeLocalPath(source), words: hasAttribute(adapter, candidate.node, "words") }, index);
+            index += 1;
+            declarations.push({ clip, element: candidate.node });
+        }
+        catch (error) {
+            diagnostics.push(createDiagnostic("error", isFrameyardError(error) ? error.code : "TRANSCRIPT_INVALID", errorMessage(error), elementDetails(adapter, options.path, candidate.node)));
+        }
+    }
+    return { declarations, diagnostics };
+}
+//# sourceMappingURL=transcripts.js.map