@hyperframes/core 0.8.150 → 0.8.151

package/dist/compiler/htmlBundler.d.ts

@@ -7,7 +7,15 @@ export type BundledHostCompositionIdentity = {
 export declare function assignBundledRuntimeCompositionIds(hosts: Element[], counts?: Map<string, number>): Map<Element, BundledHostCompositionIdentity>;
 export declare function prepareFlattenedInnerRoot(innerRoot: Element): Element;
 export declare function parsesAsScript(source: string): boolean;
+export interface BundleScriptProvenance {
+    input: string;
+    output: string;
+    sourceMap: string;
+    sourceURL?: string;
+}
 export interface BundleOptions {
+    /** Optional source mapping for inspection; does not alter bundled HTML. */
+    scriptProvenance?: (script: BundleScriptProvenance) => void;
     /** Project-relative HTML entry to bundle. Defaults to `index.html`. */
     entryFile?: string;
     stampHfIds?: boolean;

package/dist/compiler/htmlBundler.js

@@ -1,3 +1,4 @@
+import { createHash } from "node:crypto";
 import { compositionStyle, cssStyleMergeKey, deferScriptsUntilFonts, UNCONDITIONAL_CSS_KEY, headStyleRuns, INLINED_FILE_ATTR, inlineScriptRuns, styleElementsFor, } from "./scriptRuns.js";
 import { executableScripts, isJavaScriptType, planCompositionAssembly, } from "./compositionAssembly.js";
 import { SCENE_PART_ATTR } from "../sceneParts.js";
@@ -650,7 +651,7 @@ function pushRun(runs, scene, chunk) {
     else
         runs.push({ scene, chunks: [chunk] });
 }
-function coalesceHeadStylesAndBodyScripts(document) {
+function coalesceHeadStylesAndBodyScripts(document, provenance) {
     const allHeadStyles = [...document.querySelectorAll("head style")];
     const isScenePart = (el) => el.hasAttribute(SCENE_PART_ATTR);
     for (const run of allHeadStyles.length > 1 ? headStyleRuns(allHeadStyles, isScenePart) : []) {
@@ -668,7 +669,7 @@ function coalesceHeadStylesAndBodyScripts(document) {
         const mergedJs = joinJsChunks(members.map((el) => el.textContent || ""));
         if (mergedJs && !parsesAsScript(mergedJs)) {
             for (const el of members)
-                el.textContent = inlineScriptSource(el.textContent || "");
+                el.textContent = inlineScriptSource(el.textContent || "", provenance);
             continue;
         }
         for (const el of members)
@@ -676,7 +677,7 @@ function coalesceHeadStylesAndBodyScripts(document) {
         if (!mergedJs)
             continue;
         const inlineScript = document.createElement("script");
-        inlineScript.textContent = inlineScriptSource(mergedJs);
+        inlineScript.textContent = inlineScriptSource(mergedJs, provenance);
         if (anchor)
             anchor.before(inlineScript);
         else
@@ -739,19 +740,31 @@ export function parsesAsScript(source) {
         return false;
     }
 }
-function stripJsCommentsParserSafe(source) {
+function stripJsCommentsParserSafe(source, provenance) {
     if (!source)
         return source;
     try {
-        const result = transformSync(source, { loader: "js", minify: false, legalComments: "none" });
+        const result = transformSync(source, {
+            loader: "js",
+            minify: false,
+            legalComments: "none",
+            ...(provenance
+                ? { sourcemap: "external", sourcefile: "hf-authored-bundle.js" }
+                : {}),
+        });
+        if (provenance) {
+            const sourceURL = `hf-inspect-${createHash("sha256").update(source).digest("hex")}.js`;
+            provenance({ input: source, output: result.code.trim(), sourceMap: result.map, sourceURL });
+            return `${result.code.trim()}\n//# sourceURL=${sourceURL}`;
+        }
         return result.code.trim();
     }
     catch {
         return source;
     }
 }
-function inlineScriptSource(js) {
-    return escapeInlineScriptSource(stripJsCommentsParserSafe(js));
+function inlineScriptSource(js, provenance) {
+    return escapeInlineScriptSource(stripJsCommentsParserSafe(js, provenance));
 }
 function preserveLocalScriptIntegrity(doc, src, resolvePath) {
     const path = resolvePath(src);
@@ -1117,7 +1130,9 @@ async function bundleProject(projectDir, options) {
             const script = document.createElement("script");
             if (scene)
                 script.setAttribute(SCENE_PART_ATTR, scene);
-            script.textContent = skipsRunMerge ? inlineScriptSource(text) : text;
+            script.textContent = skipsRunMerge
+                ? inlineScriptSource(text, options?.scriptProvenance)
+                : text;
             document.body.appendChild(script);
         }
     }
@@ -1125,10 +1140,10 @@ async function bundleProject(projectDir, options) {
     emitRootCompositionVariableStyles(document, compVariablesByComp);
     enforceCompositionPixelSizing(document);
     autoHealMissingCompositionIds(document);
-    coalesceHeadStylesAndBodyScripts(document);
+    coalesceHeadStylesAndBodyScripts(document, options?.scriptProvenance);
     for (const el of document.querySelectorAll(`script[${INLINED_FILE_ATTR}]`)) {
         const js = el.textContent ?? "";
-        el.textContent = escapeInlineScriptSource(isJavaScriptType(el) ? stripJsCommentsParserSafe(js) : js);
+        el.textContent = escapeInlineScriptSource(isJavaScriptType(el) ? stripJsCommentsParserSafe(js, options?.scriptProvenance) : js);
     }
     deferScriptsUntilFonts(document, (el) => el.hasAttribute(RUNTIME_BOOTSTRAP_ATTR));
     injectTextRenderingRule(document);

package/dist/compiler/index.d.ts

@@ -1,7 +1,7 @@
 export { resolveTimings, type WordTiming, type ElementAnchor, type AuthoredTiming, type ResolvedTiming, type ResolveTimingsInput, type ResolveTimingsResult, } from "./timingResolver";
 export { compileTimingAttrs, injectDurations, extractResolvedMedia, clampDurations, shouldClampMediaDuration, shouldClampResolvedMediaDuration, type UnresolvedElement, type ResolvedDuration, type ResolvedMediaElement, type CompilationResult, } from "./timingCompiler";
 export { compileHtml, type MediaDurationProber } from "./htmlCompiler";
-export { assignBundledRuntimeCompositionIds, type BundledHostCompositionIdentity, bundleToSingleHtml, type BundleOptions, prepareFlattenedInnerRoot, FLATTENED_INNER_ROOT_STRIP_ATTRS, emitRootCompositionVariableStyles, parsesAsScript, } from "./htmlBundler";
+export { assignBundledRuntimeCompositionIds, type BundledHostCompositionIdentity, bundleToSingleHtml, type BundleOptions, type BundleScriptProvenance, prepareFlattenedInnerRoot, FLATTENED_INNER_ROOT_STRIP_ATTRS, emitRootCompositionVariableStyles, parsesAsScript, } from "./htmlBundler";
 export { readDeclaredDefaults, parseHostVariableValues } from "../runtime/getVariables";
 export { extractCompiledHtmlParityContract, type CompiledHtmlParityContract, type HtmlParityComposition, type HtmlParityResource, type HtmlParityTimedElement, } from "./htmlParityContract";
 export { RUNTIME_BOOTSTRAP_ATTR, injectScriptsAtHeadStart, injectTagsAtHeadStart, injectScriptsIntoHtml, insertBeforeCloseTag, insertRuntimeTag, isRuntimeFileUrl, parseHTMLContent, stripEmbeddedRuntimeScripts, } from "./htmlDocument";