frameyard 0.2.0 → 0.4.0

package/dist/contracts.d.ts

@@ -1,3 +1,4 @@
+import { type FrameyardErrorCode } from "./errors.js";
 export type JsonPrimitive = string | number | boolean | null;
 export type JsonValue = JsonPrimitive | JsonValue[] | {
     [key: string]: JsonValue;
@@ -44,63 +45,88 @@ export interface ResolvedTranscriptClip {
     src: string;
     words: boolean;
 }
-export interface MountContext<P extends Props = Props> {
-    container: HTMLElement;
-    props: Readonly<P>;
+export type DiagnosticSeverity = "error" | "warning";
+export interface CompositionDiagnosticDetails {
+    /** Project-relative source path. */
+    path?: string;
+    /** One-based source line. */
+    line?: number;
+    /** One-based source column. */
+    column?: number;
+    endLine?: number;
+    endColumn?: number;
+    element?: string;
+    attribute?: string;
+    value?: string;
+    suggestion?: string;
+    frame?: number;
+    controller?: {
+        kind: "inline" | "external";
+        line?: number;
+        column?: number;
+    };
 }
-export interface UpdateContext<P extends Props = Props> {
-    frame: number;
-    props: Readonly<P>;
+export interface CompositionDiagnostic {
+    severity: DiagnosticSeverity;
+    code: FrameyardErrorCode;
+    message: string;
+    details?: CompositionDiagnosticDetails;
 }
-export interface AudioContext<P extends Props = Props> {
-    props: Readonly<P>;
+export interface ControllerDeclaration {
+    kind: "inline" | "external";
+    /** Project-relative path for external controllers. */
+    src?: string;
+    /** Inline source for inline controllers. */
+    source?: string;
+    /** One-based line of the controller block in the composition document. */
+    line?: number;
+    /** One-based column of the controller block in the composition document. */
+    column?: number;
 }
-export interface CompositionDefinition<P extends Props = Props> extends CompositionMetadata {
-    /** Props merged over by a render's JSON props. */
-    defaultProps?: P;
-    /** Creates the composition's visual structure once. May complete asynchronous work. */
-    mount(context: MountContext<P>): void | Promise<void>;
-    /** Makes the mounted structure represent the requested frame. Must be synchronous and seek-safe. */
-    update(context: UpdateContext<P>): void;
-    /** Releases resources after the last frame. */
-    dispose?(): void | Promise<void>;
-    /** Optional domain validation. Return an array of human-readable errors. */
-    validateProps?(props: Readonly<P>): void | string[];
-    /** Declarative audio timeline, or a function deriving one from props. */
-    audio?: AudioClip[] | ((context: AudioContext<P>) => AudioClip[]);
-    /** Transcript assets required by the composition, or a function deriving them from props. */
-    transcripts?: TranscriptClip[] | ((context: AudioContext<P>) => TranscriptClip[]);
+export interface CompositionSourceInfo {
+    metadata: CompositionMetadata;
+    defaultProps: Readonly<Props>;
+    controller: ControllerDeclaration | null;
+    audioClips: readonly ResolvedAudioClip[];
+    embeddedAudioClips: readonly ResolvedAudioClip[];
+    transcriptClips: readonly ResolvedTranscriptClip[];
 }
-export interface Composition<P extends Props = Props> extends CompositionMetadata {
-    defaultProps?: Readonly<P>;
-    mount(context: MountContext<P>): void | Promise<void>;
-    update(context: UpdateContext<P>): void;
-    dispose?(): void | Promise<void>;
-    validateProps?(props: Readonly<P>): void | string[];
-    audio?: AudioClip[] | ((context: AudioContext<P>) => AudioClip[]);
-    transcripts?: TranscriptClip[] | ((context: AudioContext<P>) => TranscriptClip[]);
+/** The browser host API exposed as window.__fy. */
+export interface FrameyardHost {
+    readonly ready: Promise<void>;
+    readonly metadata: CompositionMetadata;
+    readonly defaultProps: Readonly<Props>;
+    readonly props: Readonly<Props>;
+    readonly controller: {
+        kind: "inline";
+    } | {
+        kind: "external";
+        src: string;
+    } | null;
+    readonly audioClips: readonly ResolvedAudioClip[];
+    readonly embeddedAudioClips: readonly ResolvedAudioClip[];
+    readonly transcriptClips: readonly ResolvedTranscriptClip[];
+    readonly diagnostics: readonly CompositionDiagnostic[];
+    readonly frame: number;
+    load(options?: {
+        props?: unknown;
+    }): Promise<void>;
+    seek(frame: number): void;
+    settle(): Promise<void>;
+    dispose(): Promise<void>;
 }
-declare function isPlainObject(value: unknown): value is Record<string, unknown>;
-/**
- * Validates and returns a composition definition. Composition modules can use
- * this helper for early feedback, but plain exported objects are normalized by
- * the runtime as well.
- */
-export declare function defineComposition<P extends Props = Props>(definition: CompositionDefinition<P>): Composition<P>;
-export declare function normalizeComposition(value: unknown): Composition;
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
 /**
  * Checks that a value survives a JSON round trip without losing information.
  * Returns the same value for convenient inline use.
  */
 export declare function assertJsonSerializable<T>(value: T, label?: string): T;
 /**
- * Merges a render's prop overrides over composition defaults, validates the
- * result as JSON, runs the composition's optional validator, and deep-freezes it.
+ * Merges a render's prop overrides over defaults, validates the result as JSON,
+ * and deep-freezes it. The HTML static validator and host use this before a
+ * controller's validateProps hook runs.
  */
-export declare function resolveProps<P extends Props>(composition: Composition<P>, overrides?: unknown): Readonly<P>;
-/** Resolves and validates a composition's declarative audio timeline. */
-export declare function resolveAudioClips<P extends Props>(composition: Composition<P>, props: Readonly<P>): readonly ResolvedAudioClip[];
-/** Resolves and validates a composition's declarative transcript requirements. */
-export declare function resolveTranscriptClips<P extends Props>(composition: Composition<P>, props: Readonly<P>): readonly ResolvedTranscriptClip[];
-export { isPlainObject };
+export declare function mergeProps<P extends Props>(defaults: P | undefined, overrides?: unknown): Readonly<P>;
+export declare function normalizeAudioClip(value: unknown, index: number): ResolvedAudioClip;
+export declare function normalizeTranscriptClip(value: unknown, index: number): ResolvedTranscriptClip;
 //# sourceMappingURL=contracts.d.ts.map

package/dist/contracts.d.ts.map

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

package/dist/contracts.js

@@ -1,102 +1,11 @@
 import { FrameyardError } from "./errors.js";
-function invalid(message) {
-    throw new FrameyardError("COMPOSITION_INVALID", message);
-}
-function isPlainObject(value) {
+export function isPlainObject(value) {
     if (typeof value !== "object" || value === null) {
         return false;
     }
     const prototype = Object.getPrototypeOf(value);
     return prototype === Object.prototype || prototype === null;
 }
-function isAsyncFunction(value) {
-    return typeof value === "function" && Object.prototype.toString.call(value) === "[object AsyncFunction]";
-}
-/**
- * Validates and returns a composition definition. Composition modules can use
- * this helper for early feedback, but plain exported objects are normalized by
- * the runtime as well.
- */
-export function defineComposition(definition) {
-    return normalizeComposition(definition);
-}
-export function normalizeComposition(value) {
-    if (!isPlainObject(value)) {
-        invalid("A composition must be a plain object.");
-    }
-    const width = value.width;
-    const height = value.height;
-    const fps = value.fps;
-    const durationInFrames = value.durationInFrames;
-    if (typeof width !== "number" || !Number.isInteger(width) || width <= 0) {
-        invalid("Composition width must be a positive integer.");
-    }
-    if (typeof height !== "number" || !Number.isInteger(height) || height <= 0) {
-        invalid("Composition height must be a positive integer.");
-    }
-    if (typeof fps !== "number" || !Number.isFinite(fps) || fps <= 0) {
-        invalid("Composition fps must be a positive finite number.");
-    }
-    if (typeof durationInFrames !== "number" || !Number.isInteger(durationInFrames) || durationInFrames <= 0) {
-        invalid("Composition durationInFrames must be a positive integer.");
-    }
-    if (typeof value.mount !== "function") {
-        invalid("Composition mount must be a function.");
-    }
-    if (typeof value.update !== "function") {
-        invalid("Composition update must be a function.");
-    }
-    if (isAsyncFunction(value.update)) {
-        invalid("Composition update must be synchronous; finish asynchronous work in mount().");
-    }
-    if (value.dispose !== undefined && typeof value.dispose !== "function") {
-        invalid("Composition dispose must be a function when provided.");
-    }
-    if (value.validateProps !== undefined && typeof value.validateProps !== "function") {
-        invalid("Composition validateProps must be a function when provided.");
-    }
-    if (value.audio !== undefined && typeof value.audio !== "function" && !Array.isArray(value.audio)) {
-        invalid("Composition audio must be an array or a function returning an array.");
-    }
-    if (value.transcripts !== undefined && typeof value.transcripts !== "function" && !Array.isArray(value.transcripts)) {
-        invalid("Composition transcripts must be an array or a function returning an array.");
-    }
-    if (value.defaultProps !== undefined) {
-        if (!isPlainObject(value.defaultProps)) {
-            invalid("Composition defaultProps must be a plain object.");
-        }
-        try {
-            assertJsonSerializable(value.defaultProps, "defaultProps");
-        }
-        catch (error) {
-            invalid(`Composition defaultProps must be JSON-serializable: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    }
-    const composition = {
-        width,
-        height,
-        fps,
-        durationInFrames,
-        mount: value.mount,
-        update: value.update,
-    };
-    if (value.defaultProps !== undefined) {
-        composition.defaultProps = value.defaultProps;
-    }
-    if (value.dispose !== undefined) {
-        composition.dispose = value.dispose;
-    }
-    if (value.validateProps !== undefined) {
-        composition.validateProps = value.validateProps;
-    }
-    if (value.audio !== undefined) {
-        composition.audio = value.audio;
-    }
-    if (value.transcripts !== undefined) {
-        composition.transcripts = value.transcripts;
-    }
-    return Object.freeze(composition);
-}
 /**
  * Checks that a value survives a JSON round trip without losing information.
  * Returns the same value for convenient inline use.
@@ -169,42 +78,27 @@ function deepFreeze(value) {
     }
     return value;
 }
-/**
- * Merges a render's prop overrides over composition defaults, validates the
- * result as JSON, runs the composition's optional validator, and deep-freezes it.
- */
-export function resolveProps(composition, overrides) {
+function mergePropsUnfrozen(defaults, overrides) {
     if (overrides !== undefined && !isPlainObject(overrides)) {
         throw new FrameyardError("PROPS_INVALID", "Props must be a plain JSON object.");
     }
     const merged = {
-        ...composition.defaultProps,
+        ...defaults,
         ...overrides,
     };
     assertJsonSerializable(merged, "props");
-    if (composition.validateProps) {
-        let errors;
-        try {
-            errors = composition.validateProps(merged);
-        }
-        catch (error) {
-            throw new FrameyardError("PROPS_INVALID", `Props validation failed: ${error instanceof Error ? error.message : String(error)}`, {
-                cause: error,
-            });
-        }
-        if (errors !== undefined) {
-            if (!Array.isArray(errors) || errors.some((item) => typeof item !== "string")) {
-                throw new FrameyardError("PROPS_INVALID", "validateProps() must return void or an array of strings.");
-            }
-            if (errors.length > 0) {
-                throw new FrameyardError("PROPS_INVALID", `Invalid props: ${errors.join("; ")}`);
-            }
-        }
-    }
-    return deepFreeze(merged);
+    return merged;
+}
+/**
+ * Merges a render's prop overrides over defaults, validates the result as JSON,
+ * and deep-freezes it. The HTML static validator and host use this before a
+ * controller's validateProps hook runs.
+ */
+export function mergeProps(defaults, overrides) {
+    return deepFreeze(mergePropsUnfrozen(defaults, overrides));
 }
 const SCHEME = /^[a-zA-Z][a-zA-Z0-9+.-]*:/;
-function normalizeAudioClip(value, index) {
+export function normalizeAudioClip(value, index) {
     if (!isPlainObject(value)) {
         throw new FrameyardError("AUDIO_INVALID", `Audio clip ${index} must be a plain object.`);
     }
@@ -239,26 +133,7 @@ function normalizeAudioClip(value, index) {
     }
     return Object.freeze(clip);
 }
-/** Resolves and validates a composition's declarative audio timeline. */
-export function resolveAudioClips(composition, props) {
-    let clips = composition.audio;
-    if (typeof composition.audio === "function") {
-        try {
-            clips = composition.audio({ props });
-        }
-        catch (error) {
-            throw new FrameyardError("AUDIO_INVALID", `Could not resolve the audio timeline: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
-        }
-    }
-    if (clips === undefined) {
-        return Object.freeze([]);
-    }
-    if (!Array.isArray(clips)) {
-        throw new FrameyardError("AUDIO_INVALID", "Composition audio must resolve to an array of clips.");
-    }
-    return Object.freeze(clips.map((clip, index) => normalizeAudioClip(clip, index)));
-}
-function normalizeTranscriptClip(value, index) {
+export function normalizeTranscriptClip(value, index) {
     if (!isPlainObject(value)) {
         throw new FrameyardError("TRANSCRIPT_INVALID", `Transcript ${index} must be a plain object.`);
     }
@@ -274,24 +149,4 @@ function normalizeTranscriptClip(value, index) {
     }
     return Object.freeze({ src, words: words === true });
 }
-/** Resolves and validates a composition's declarative transcript requirements. */
-export function resolveTranscriptClips(composition, props) {
-    let clips = composition.transcripts;
-    if (typeof composition.transcripts === "function") {
-        try {
-            clips = composition.transcripts({ props });
-        }
-        catch (error) {
-            throw new FrameyardError("TRANSCRIPT_INVALID", `Could not resolve transcript requirements: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
-        }
-    }
-    if (clips === undefined) {
-        return Object.freeze([]);
-    }
-    if (!Array.isArray(clips)) {
-        throw new FrameyardError("TRANSCRIPT_INVALID", "Composition transcripts must resolve to an array of assets.");
-    }
-    return Object.freeze(clips.map((clip, index) => normalizeTranscriptClip(clip, index)));
-}
-export { isPlainObject };
 //# sourceMappingURL=contracts.js.map

package/dist/contracts.js.map

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

package/dist/errors.d.ts

@@ -1,9 +1,20 @@
-export type FrameyardErrorCode = "USAGE" | "CONFIG_NOT_FOUND" | "CONFIG_INVALID" | "COMPOSITION_NOT_FOUND" | "COMPOSITION_INVALID" | "COMPOSITION_UPDATE_ASYNC" | "COMPOSITION_ERROR" | "PROPS_INVALID" | "FRAME_OUT_OF_RANGE" | "AUDIO_INVALID" | "ASSET_NOT_FOUND" | "OUTPUT_EXISTS" | "OUTPUT_FAILED" | "FFMPEG_FAILED" | "FFPROBE_FAILED" | "BROWSER_FAILED" | "RENDER_FAILED" | "EXECUTABLE_NOT_FOUND" | "TTS_FAILED" | "TRANSCRIBE_FAILED" | "TRANSCRIPT_INVALID" | "TRANSCRIPT_WORDS_UNAVAILABLE" | "MANIFEST_INVALID" | "CANCELLED" | "INTERNAL";
+export type FrameyardErrorCode = "USAGE" | "CONFIG_NOT_FOUND" | "CONFIG_INVALID" | "COMPOSITION_NOT_FOUND" | "COMPOSITION_INVALID" | "COMPOSITION_UPDATE_ASYNC" | "COMPOSITION_ERROR" | "COMPOSITION_NOT_READY" | "COMPOSITION_DISPOSED" | "CONTROLLER_INVALID" | "BINDING_INVALID" | "BINDING_PATH_MISSING" | "BINDING_VALUE_INVALID" | "BINDING_REPEAT_INVALID" | "BINDING_REPEAT_NESTED" | "BINDING_TARGET_INVALID" | "ANIMATION_INVALID" | "ANIMATION_NOT_FOUND" | "ANIMATION_MULTIPLE" | "DETERMINISM_WARNING" | "SCRIPT_NOT_ALLOWED" | "EVENT_HANDLER_NOT_ALLOWED" | "URL_NOT_ALLOWED" | "ELEMENT_NOT_SUPPORTED" | "ELEMENT_UNKNOWN" | "CONTENT_OUTSIDE_ROOT" | "PROPS_INVALID" | "FRAME_OUT_OF_RANGE" | "AUDIO_INVALID" | "AUDIO_WARNING" | "MEDIA_INVALID" | "MEDIA_SEEK_FAILED" | "ASSET_NOT_FOUND" | "OUTPUT_EXISTS" | "OUTPUT_FAILED" | "FFMPEG_FAILED" | "FFPROBE_FAILED" | "BROWSER_FAILED" | "RENDER_FAILED" | "EXECUTABLE_NOT_FOUND" | "TTS_FAILED" | "TRANSCRIBE_FAILED" | "TRANSCRIPT_INVALID" | "TRANSCRIPT_WORDS_UNAVAILABLE" | "TRANSCRIPT_WARNING" | "MANIFEST_INVALID" | "CANCELLED" | "INTERNAL";
+export interface FrameyardDiagnostic {
+    severity: "error" | "warning";
+    code: string;
+    message: string;
+    details?: unknown;
+}
+export interface FrameyardErrorOptions {
+    cause?: unknown;
+    details?: unknown;
+    diagnostics?: FrameyardDiagnostic[];
+}
 export declare class FrameyardError extends Error {
     readonly code: FrameyardErrorCode;
-    constructor(code: FrameyardErrorCode, message: string, options?: {
-        cause?: unknown;
-    });
+    readonly details?: unknown;
+    readonly diagnostics?: FrameyardDiagnostic[];
+    constructor(code: FrameyardErrorCode, message: string, options?: FrameyardErrorOptions);
 }
 export declare function isFrameyardError(error: unknown): error is FrameyardError;
 export declare function errorMessage(error: unknown): string;

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC1B,OAAO,GACP,kBAAkB,GAClB,gBAAgB,GAChB,uBAAuB,GACvB,qBAAqB,GACrB,0BAA0B,GAC1B,mBAAmB,GACnB,eAAe,GACf,oBAAoB,GACpB,eAAe,GACf,iBAAiB,GACjB,eAAe,GACf,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,eAAe,GACf,sBAAsB,GACtB,YAAY,GACZ,mBAAmB,GACnB,oBAAoB,GACpB,8BAA8B,GAC9B,kBAAkB,GAClB,WAAW,GACX,UAAU,CAAC;AAEf,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;gBAEtB,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAKrF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKnD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC1B,OAAO,GACP,kBAAkB,GAClB,gBAAgB,GAChB,uBAAuB,GACvB,qBAAqB,GACrB,0BAA0B,GAC1B,mBAAmB,GACnB,uBAAuB,GACvB,sBAAsB,GACtB,oBAAoB,GACpB,iBAAiB,GACjB,sBAAsB,GACtB,uBAAuB,GACvB,wBAAwB,GACxB,uBAAuB,GACvB,wBAAwB,GACxB,mBAAmB,GACnB,qBAAqB,GACrB,oBAAoB,GACpB,qBAAqB,GACrB,oBAAoB,GACpB,2BAA2B,GAC3B,iBAAiB,GACjB,uBAAuB,GACvB,iBAAiB,GACjB,sBAAsB,GACtB,eAAe,GACf,oBAAoB,GACpB,eAAe,GACf,eAAe,GACf,eAAe,GACf,mBAAmB,GACnB,iBAAiB,GACjB,eAAe,GACf,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,eAAe,GACf,sBAAsB,GACtB,YAAY,GACZ,mBAAmB,GACnB,oBAAoB,GACpB,8BAA8B,GAC9B,oBAAoB,GACpB,kBAAkB,GAClB,WAAW,GACX,UAAU,CAAC;AAEf,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACrC;AAED,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,mBAAmB,EAAE,CAAC;gBAEjC,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB;CAWvF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKnD"}

package/dist/errors.js

@@ -1,9 +1,17 @@
 export class FrameyardError extends Error {
     code;
+    details;
+    diagnostics;
     constructor(code, message, options) {
         super(message, options);
         this.name = "FrameyardError";
         this.code = code;
+        if (options?.details !== undefined) {
+            this.details = options.details;
+        }
+        if (options?.diagnostics !== undefined) {
+            this.diagnostics = options.diagnostics;
+        }
     }
 }
 export function isFrameyardError(error) {

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AA2BA,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,IAAI,CAAqB;IAElC,YAAY,IAAwB,EAAE,OAAe,EAAE,OAA6B;QAClF,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,KAAK,YAAY,cAAc,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AA+DA,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,IAAI,CAAqB;IACzB,OAAO,CAAW;IAClB,WAAW,CAAyB;IAE7C,YAAY,IAAwB,EAAE,OAAe,EAAE,OAA+B;QACpF,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,OAAO,EAAE,OAAO,KAAK,SAAS,EAAE,CAAC;YACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QACjC,CAAC;QACD,IAAI,OAAO,EAAE,WAAW,KAAK,SAAS,EAAE,CAAC;YACvC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACzC,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,KAAK,YAAY,cAAc,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

package/dist/html/index.d.ts

@@ -0,0 +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";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/html/index.js

@@ -0,0 +1,3 @@
+export { validateHtmlComposition } from "./validate.js";
+export { parseHtml } from "./parse.js";
+//# sourceMappingURL=index.js.map

package/dist/html/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/html/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAExD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/html/parse.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/html/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AAE7D,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,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,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAEpD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,IAAI,WAAW,CAE7D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,IAAI,YAAY,CAE/D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,IAAI,YAAY,CAE/D;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnF;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAExE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEnG;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,GAAG,SAAS,CAEnF;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS,CAE1E;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAWrD;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI,CAa1E;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,GAAG,WAAW,EAAE,CAQhH;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,gBAAgB,GAAG,SAAS,CAEvF;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEpG;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAS7E"}

package/dist/html/parse.js

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

package/dist/html/parse.js.map

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