@hyperframes/inspector 0.8.181 → 0.8.184

package/dist/types/core/src/compiler/compositionScoping.d.ts

@@ -1,7 +1,11 @@
-export declare function scopeCssToComposition(css: string, compositionId: string, scopeSelectorOverride?: string, authoredRootId?: string | null, options?: {
+type ScopeOptions = {
     compoundAuthoredRoot?: boolean;
     scopeRootSelectors?: boolean;
-}): string;
+};
+export declare function scopeCssToComposition(css: string, compositionId: string, scopeSelectorOverride?: string, authoredRootId?: string | null, options?: ScopeOptions): string;
+/** `scopeCssToComposition` for sheets mounted many times: each sheet is scoped once around a
+ * placeholder scope, which each mount's own scope then replaces. */
+export declare function createCompositionCssScoper(): typeof scopeCssToComposition;
 /** Drops repeats of an identical `@font-face` across the given style texts, keeping the last copy:
  * the last matching rule is the one the browser uses, so a rule in between never gains precedence. */
 export declare const dedupeFontFaceRules: (styleTexts: string[]) => string[];
@@ -30,3 +34,4 @@ export declare function wrapInlineScriptWithErrorBoundary(source: string, errorL
  * table goes through `jsonScriptLiteral` — see there for why.
  */
 export declare function buildVariablesByCompScript(variablesByComp: Record<string, Record<string, unknown>>): string | null;
+export {};

package/dist/types/core/src/compiler/htmlBundler.d.ts

@@ -55,6 +55,7 @@ export interface BundleOptions {
     sceneParts?: boolean;
     /** Warn when the compiled HTML breaks the HyperFrames contract (default true). */
     staticGuard?: boolean;
+    /** Called once per build for each project file the build reads or looks for. */
     onRead?: (filePath: string) => void;
 }
 export declare function bundleToSingleHtml(projectDir: string, options?: BundleOptions): Promise<string>;

package/dist/types/core/src/mediaTiming.d.ts

@@ -1,41 +1 @@
-export declare const MEDIA_START_BASIS_ATTR = "data-hf-media-start-basis";
-export type MediaStartBasis = "local" | "global";
-export declare function readMediaStartBasis(value: string | null | undefined): MediaStartBasis;
-/** Resolve authored media time onto the root timeline. Nested media is local
- * by default; only an explicit compatibility marker preserves a legacy
- * root-global value. */
-export declare function resolveAbsoluteMediaStartSeconds(input: {
-    authoredStart: number;
-    hostStart: number;
-    basis?: string | null;
-}): number;
-/** The one rule for a media element's root-timeline start; the runtime and the CLI both call it.
- * `hostStart` is the composition's origin. With no literal start, an auto-injected start, or an
- * origin at 0 there is nothing for the basis to disambiguate, so ordinary resolution applies. */
-export declare function resolveMediaStartSeconds(input: MediaStartInput & {
-    ordinaryStart: () => number;
-}): number;
-/** True when the authored start is already root time, so no host offset applies. */
-export declare function isRootGlobalMediaStart(input: MediaStartInput): boolean;
-export interface MediaStartInput {
-    authoredStart: number | null;
-    hostStart: number;
-    hasAutoStart: boolean;
-    basis?: string | null;
-}
-/** A composition host's in-point; only a host with one shifts or cuts what it holds. */
-export declare function hostInPointSeconds(host: Pick<Element, "getAttribute">): number;
-/** Main-timeline time of a sub-composition's local t=0: its host's start minus its in-point. */
-export declare function compositionOriginSeconds(hostStart: number, host: Pick<Element, "getAttribute">): number;
-export interface HostSlot {
-    start: number;
-    end: number;
-}
-/** Each in-point host cuts the span to its own window. */
-export declare function cutToHostSlots(span: {
-    start: number;
-    end: number;
-}, hosts: readonly HostSlot[]): {
-    start: number;
-    end: number;
-};
+export * from "@hyperframes/parsers/media-timing";

package/dist/types/core/src/runtime/types.d.ts

@@ -261,6 +261,7 @@ export type RuntimeTimelineLike = {
     seek: (timeSeconds?: number, suppressEvents?: boolean) => unknown;
     totalTime?: (timeSeconds?: number, suppressEvents?: boolean) => unknown;
     totalDuration?: () => number;
+    shiftChildren?: (amount: number) => unknown;
     progress?: (value?: number, suppressEvents?: boolean) => unknown;
     time: () => number;
     duration: () => number;

package/dist/types/inspector/src/live.d.ts

@@ -11,7 +11,7 @@ export interface LiveInspection {
     timeline(runner: PageRunner, request: TimelineRequest): Promise<TimelineReport>;
     elementMap(runner: PageRunner): Promise<ElementMapReport>;
 }
-export declare function prepareLiveInspection(projectDir: string, html: string, provenance: readonly BundleScriptProvenance[], sourceVersion: string): LiveInspection;
+export declare function prepareLiveInspection(projectDir: string, html: string, provenance: readonly BundleScriptProvenance[], sourceVersion: string, reads?: readonly string[]): LiveInspection;
 export declare function previewGeneration(runner: PageRunner): Promise<string | null>;
 export declare function fingerprint(project: string): string;
 export type { ComponentReport, ElementMapReport, InspectRequest, PageRunner, TimelineReport, TimelineRequest, };

package/dist/types/inspector/src/mapInspection.d.ts

@@ -1,5 +1,18 @@
 import { Sources } from "./sources.js";
 import type { InspectRequest, RuntimeResponse, Snippet } from "./types.js";
+declare function shown(snippet: Snippet, targetCount: number): {
+    id: string;
+    kind: string[];
+    code: string;
+    uniqueInFile: boolean;
+    targets?: undefined;
+} | {
+    id: string;
+    kind: string[];
+    targets: number[];
+    code: string;
+    uniqueInFile: boolean;
+};
 export declare function mapInspection(raw: RuntimeResponse, request: InspectRequest, context: {
     sources: Sources;
     map: ReturnType<Sources["mapper"]>;
@@ -13,6 +26,11 @@ export declare function mapInspection(raw: RuntimeResponse, request: InspectRequ
         duration: number | undefined;
     };
 }): {
+    recordLimitReached: boolean;
+    hooked: boolean;
+    debugAvailable: boolean;
+    elapsedMs: number;
+    coverage?: string[];
     generation: string;
     visualState: {
         time: number | undefined;
@@ -21,29 +39,30 @@ export declare function mapInspection(raw: RuntimeResponse, request: InspectRequ
     sourceVersion: string;
     reused: boolean;
     results: {
+        unmappedAnimations: number;
+        scopeTruncated: boolean;
+        coTargetsOmitted?: number | undefined;
         target: number;
         status: "missing" | "found" | "ambiguous" | "stale-ref" | "invalid-selector";
         candidates: import("./types.js").ElementRef[];
         candidatesOmitted: number;
         animations: number;
         coTargets: import("./types.js").ElementRef[];
-        unmappedAnimations: number;
-        scopeTruncated: boolean;
     }[];
-    snippets: Snippet[];
+    snippets: ReturnType<typeof shown>[];
     omitted: {
         id: string;
         bytes: number;
     }[];
     omittedCount: number;
     nextOffset: number | null;
-    coverage: string[];
+} | {
+    debug: RuntimeResponse;
     recordLimitReached: boolean;
     hooked: boolean;
     debugAvailable: boolean;
     elapsedMs: number;
-} | {
-    debug: RuntimeResponse;
+    coverage?: string[];
     generation: string;
     visualState: {
         time: number | undefined;
@@ -52,25 +71,22 @@ export declare function mapInspection(raw: RuntimeResponse, request: InspectRequ
     sourceVersion: string;
     reused: boolean;
     results: {
+        unmappedAnimations: number;
+        scopeTruncated: boolean;
+        coTargetsOmitted?: number | undefined;
         target: number;
         status: "missing" | "found" | "ambiguous" | "stale-ref" | "invalid-selector";
         candidates: import("./types.js").ElementRef[];
         candidatesOmitted: number;
         animations: number;
         coTargets: import("./types.js").ElementRef[];
-        unmappedAnimations: number;
-        scopeTruncated: boolean;
     }[];
-    snippets: Snippet[];
+    snippets: ReturnType<typeof shown>[];
     omitted: {
         id: string;
         bytes: number;
     }[];
     omittedCount: number;
     nextOffset: number | null;
-    coverage: string[];
-    recordLimitReached: boolean;
-    hooked: boolean;
-    debugAvailable: boolean;
-    elapsedMs: number;
 };
+export {};

package/dist/types/inspector/src/service.d.ts

@@ -29,6 +29,11 @@ export declare class Inspector {
     private view;
     private idle;
     inspect(request: InspectRequest): Promise<{
+        recordLimitReached: boolean;
+        hooked: boolean;
+        debugAvailable: boolean;
+        elapsedMs: number;
+        coverage?: string[];
         generation: string;
         visualState: {
             time: number | undefined;
@@ -37,29 +42,42 @@ export declare class Inspector {
         sourceVersion: string;
         reused: boolean;
         results: {
+            unmappedAnimations: number;
+            scopeTruncated: boolean;
+            coTargetsOmitted?: number | undefined;
             target: number;
             status: "missing" | "found" | "ambiguous" | "stale-ref" | "invalid-selector";
             candidates: import("./types.js").ElementRef[];
             candidatesOmitted: number;
             animations: number;
             coTargets: import("./types.js").ElementRef[];
-            unmappedAnimations: number;
-            scopeTruncated: boolean;
         }[];
-        snippets: Snippet[];
+        snippets: ReturnType<(snippet: Snippet, targetCount: number) => {
+            id: string;
+            kind: string[];
+            code: string;
+            uniqueInFile: boolean;
+            targets?: undefined;
+        } | {
+            id: string;
+            kind: string[];
+            targets: number[];
+            code: string;
+            uniqueInFile: boolean;
+        }>[];
         omitted: {
             id: string;
             bytes: number;
         }[];
         omittedCount: number;
         nextOffset: number | null;
-        coverage: string[];
+    } | {
+        debug: import("./types.js").RuntimeResponse;
         recordLimitReached: boolean;
         hooked: boolean;
         debugAvailable: boolean;
         elapsedMs: number;
-    } | {
-        debug: import("./types.js").RuntimeResponse;
+        coverage?: string[];
         generation: string;
         visualState: {
             time: number | undefined;
@@ -68,27 +86,35 @@ export declare class Inspector {
         sourceVersion: string;
         reused: boolean;
         results: {
+            unmappedAnimations: number;
+            scopeTruncated: boolean;
+            coTargetsOmitted?: number | undefined;
             target: number;
             status: "missing" | "found" | "ambiguous" | "stale-ref" | "invalid-selector";
             candidates: import("./types.js").ElementRef[];
             candidatesOmitted: number;
             animations: number;
             coTargets: import("./types.js").ElementRef[];
-            unmappedAnimations: number;
-            scopeTruncated: boolean;
         }[];
-        snippets: Snippet[];
+        snippets: ReturnType<(snippet: Snippet, targetCount: number) => {
+            id: string;
+            kind: string[];
+            code: string;
+            uniqueInFile: boolean;
+            targets?: undefined;
+        } | {
+            id: string;
+            kind: string[];
+            targets: number[];
+            code: string;
+            uniqueInFile: boolean;
+        }>[];
         omitted: {
             id: string;
             bytes: number;
         }[];
         omittedCount: number;
         nextOffset: number | null;
-        coverage: string[];
-        recordLimitReached: boolean;
-        hooked: boolean;
-        debugAvailable: boolean;
-        elapsedMs: number;
     }>;
     private query;
     timeline(request: TimelineRequest): Promise<import("./timelineReport.js").TimelineReport>;

package/dist/types/inspector/src/sources.d.ts

@@ -27,6 +27,10 @@ export interface HtmlTag {
     hfId?: string;
     classes: string[];
     tag: string;
+    compositionId?: string;
+    compositionSrc?: string;
+    inMarkup: boolean;
+    parent?: number;
 }
 export interface AuthoredHtml {
     files: Map<string, {
@@ -47,13 +51,18 @@ export declare class Sources {
         end: number;
     }[];
     readonly htmlTags: HtmlTag[];
-    constructor(project: string);
+    constructor(project: string, served?: Iterable<string>);
     private addChunk;
     private addCss;
     slice(file: string, start: number, end: number, kind: string, target: number): Snippet | null;
     markup(element: ElementRef, target: number): Snippet | null;
+    markupTag(element: ElementRef): HtmlTag | null;
+    private nestingIndex?;
+    private get nested();
+    private fileByPath?;
+    private mountedFile;
+    compositions(tag: HtmlTag, target: number): Snippet[];
     mapper(html: string, provenance: BundleScriptProvenance[]): (stack: string, target: number) => Snippet[];
 }
-export declare function markupSnippet(sources: Sources, element: ElementRef, target: number): Snippet | null;
 export declare function mergeSnippets(snippets: Snippet[], sources: Sources): Snippet[];
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/inspector",
-  "version": "0.8.181",
+  "version": "0.8.184",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
@@ -40,10 +40,11 @@
     "acorn": "^8.17.0",
     "esbuild": "^0.25.12",
     "eslint-scope": "^9.1.2",
+    "htmlparser2": "^10.1.0",
     "postcss": "^8.5.8",
     "puppeteer-core": "^25.8.0",
-    "@hyperframes/core": "0.8.181",
-    "@hyperframes/parsers": "0.8.181"
+    "@hyperframes/parsers": "0.8.184",
+    "@hyperframes/core": "0.8.184"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",