@hyperframes/core 0.8.204 → 0.8.206

package/dist/compiler/compositionScoping.d.ts

@@ -13,6 +13,8 @@ export declare function hoistFontFaceRules(styleTexts: string[]): {
     styles: string[];
     faces: string[];
 };
+export declare const AUTHORED_SOURCE_BEGIN = "/*hf-authored-begin*/";
+export declare const AUTHORED_SOURCE_END = "/*hf-authored-end*/";
 export declare function scopedModulePrelude(timelineCompositionId: string, compositionSrc?: string | null): string;
 export declare function wrapScopedCompositionScript(source: string, compositionId: string, errorLabel?: string, scopeSelectorOverride?: string, timelineCompositionId?: string, authoredRootId?: string | null, compositionSrc?: string | null): string;
 export declare function wrapInlineScriptWithErrorBoundary(source: string, errorLabel: string): string;

package/dist/compiler/compositionScoping.js

@@ -295,6 +295,8 @@ const SCOPED_HYPERFRAMES_EXPRESSION = `!__hfBaseHyperframes
           return scoped ? Object.assign({}, scoped) : {};
         },
       })`;
+export const AUTHORED_SOURCE_BEGIN = "/*hf-authored-begin*/";
+export const AUTHORED_SOURCE_END = "/*hf-authored-end*/";
 export function scopedModulePrelude(timelineCompositionId, compositionSrc) {
     return `const __hyperframes = (function(__hfBaseHyperframes, __hfTimelineCompId, __hfCompositionSrc) {
   return ${SCOPED_HYPERFRAMES_EXPRESSION};
@@ -581,7 +583,9 @@ export function wrapScopedCompositionScript(source, compositionId, errorLabel =
     if (typeof report === "function") report("start", __hfCompositionSrc || "index.html");
     try {
       (function(document, gsap, window, __hyperframes) {
+${AUTHORED_SOURCE_BEGIN}
 ${source.replace(/<\/(script)/gi, "<\\/$1")}
+${AUTHORED_SOURCE_END}
       }).call(window, __hfScopedDocument, __hfScopedGsap, __hfScopedWindow, __hfScopedHyperframes);
     } catch (_err) {
       console.error(__hfErrorLabel, __hfCompId, _err);

package/dist/compiler/htmlBundler.js

@@ -1,7 +1,8 @@
 import { createHash } from "node:crypto";
-import { compositionStyle, cssStyleMergeKey, deferScriptsUntilFonts, UNCONDITIONAL_CSS_KEY, headStyleRuns, INLINED_FILE_ATTR, inlineScriptRuns, styleElementsFor, } from "./scriptRuns.js";
+import { compositionStyle, cssStyleMergeKey, deferScriptsUntilFonts, isAlwaysAppliedStyle, headStyleRuns, INLINED_FILE_ATTR, inlineScriptRuns, styleElementsFor, } from "./scriptRuns.js";
 import { countPageRoot, executableScripts, isJavaScriptType, planCompositionAssembly, } from "./compositionAssembly.js";
 import { SCENE_FONTS_ATTR, SCENE_PART_ATTR } from "../sceneParts.js";
+import { stripSdrPngColourTags } from "./pngColourTags.js";
 import { ensureExternalScriptTag, readExternalScriptAttributes, } from "./externalScripts.js";
 import { emitMountedModuleScripts, parseImportMap } from "./importMaps.js";
 import { markFlattenedInnerRoot } from "../runtime/flattenedRoot.js";
@@ -313,7 +314,8 @@ function createAssetInliner(resolveProjectPath, inlineAssets) {
         const byteLength = safeStatSize(filePath);
         if (byteLength !== null && byteLength > MAX_INLINE_ASSET_BYTES)
             return { tooLarge: byteLength };
-        const content = safeReadFileBuffer(filePath);
+        const read = safeReadFileBuffer(filePath);
+        const content = read && mimeType === "image/png" ? (stripSdrPngColourTags(read) ?? read) : read;
         return {
             dataUrl: content === null ? null : `data:${mimeType};base64,${content.toString("base64")}`,
         };
@@ -640,9 +642,6 @@ function placeSceneStylesLikeRender(document) {
     holder.textContent = hoisted;
     first.before(holder);
 }
-function isAlwaysAppliedStyle(el) {
-    return cssStyleMergeKey(el) === UNCONDITIONAL_CSS_KEY && !el.closest("template, noscript, svg");
-}
 function pushRun(runs, scene, chunk) {
     const last = runs.at(-1);
     if (last && last.scene === scene)

package/dist/compiler/index.d.ts

@@ -6,10 +6,10 @@ export { readDeclaredDefaults, parseHostVariableValues } from "../runtime/getVar
 export { extractCompiledHtmlParityContract, type CompiledHtmlParityContract, type HtmlParityComposition, type HtmlParityResource, type HtmlParityTimedElement, } from "./htmlParityContract.js";
 export { RUNTIME_BOOTSTRAP_ATTR, injectScriptsAtHeadStart, injectTagsAtHeadStart, injectScriptsIntoHtml, insertBeforeCloseTag, insertRuntimeTag, isRuntimeFileUrl, parseHTMLContent, stripEmbeddedRuntimeScripts, } from "./htmlDocument.js";
 export { addScenePartsManifest } from "./scenePartsManifest.js";
-export { AFTER_FONTS_SCRIPT_TYPE, compositionStyle, cssStyleMergeKey, deferScriptsUntilFonts, headStyleRuns, inlineScriptRuns, styleElementsFor, type CompositionStyle, type InlineScriptRun, } from "./scriptRuns.js";
+export { AFTER_FONTS_SCRIPT_TYPE, compositionStyle, cssStyleMergeKey, isAlwaysAppliedStyle, deferScriptsUntilFonts, headStyleRuns, inlineScriptRuns, styleElementsFor, type CompositionStyle, type InlineScriptRun, } from "./scriptRuns.js";
 export { isJavaScriptType } from "./compositionAssembly.js";
 export { validateHyperframeHtmlContract, type HyperframeStaticFailureReason, type HyperframeStaticGuardResult, } from "./staticGuard.js";
-export { buildVariablesByCompScript, scopeCssToComposition, wrapScopedCompositionScript, } from "./compositionScoping.js";
+export { buildVariablesByCompScript, dedupeFontFaceRules, scopeCssToComposition, wrapScopedCompositionScript, } from "./compositionScoping.js";
 export { ensureExternalLinkTag, inlineSubCompositions, type InlineSubCompositionsOptions, type InlineSubCompositionsResult, } from "./inlineSubCompositions.js";
 export { extractStandaloneEntryFromIndex, isTemplateEntry } from "./standaloneEntry.js";
 export { checkSubCompositionUsability, type ParsableDocumentLike, type SubCompositionValidity, type SubCompositionValidityReason, } from "./subCompositionValidity.js";

package/dist/compiler/index.js

@@ -12,12 +12,12 @@ export { extractCompiledHtmlParityContract, } from "./htmlParityContract.js";
 export { RUNTIME_BOOTSTRAP_ATTR, injectScriptsAtHeadStart, injectTagsAtHeadStart, injectScriptsIntoHtml, insertBeforeCloseTag, insertRuntimeTag, isRuntimeFileUrl, parseHTMLContent, stripEmbeddedRuntimeScripts, } from "./htmlDocument.js";
 export { addScenePartsManifest } from "./scenePartsManifest.js";
 // Script ordering shared by the bundler and the producer coalescers
-export { AFTER_FONTS_SCRIPT_TYPE, compositionStyle, cssStyleMergeKey, deferScriptsUntilFonts, headStyleRuns, inlineScriptRuns, styleElementsFor, } from "./scriptRuns.js";
+export { AFTER_FONTS_SCRIPT_TYPE, compositionStyle, cssStyleMergeKey, isAlwaysAppliedStyle, deferScriptsUntilFonts, headStyleRuns, inlineScriptRuns, styleElementsFor, } from "./scriptRuns.js";
 export { isJavaScriptType } from "./compositionAssembly.js";
 // Static guard
 export { validateHyperframeHtmlContract, } from "./staticGuard.js";
 // Composition isolation helpers
-export { buildVariablesByCompScript, scopeCssToComposition, wrapScopedCompositionScript, } from "./compositionScoping.js";
+export { buildVariablesByCompScript, dedupeFontFaceRules, scopeCssToComposition, wrapScopedCompositionScript, } from "./compositionScoping.js";
 // Sub-composition inlining (shared between bundler and producer)
 export { ensureExternalLinkTag, inlineSubCompositions, } from "./inlineSubCompositions.js";
 export { extractStandaloneEntryFromIndex, isTemplateEntry } from "./standaloneEntry.js";

package/dist/compiler/inlineSubCompositions.js

@@ -13,7 +13,7 @@ import { compositionStyle, cssStyleMergeKey, hasSameLink, } from "./scriptRuns.j
  */
 import { rewriteAssetPath, rewriteAssetPaths, rewriteCssAssetUrls, rewriteInlineStyleAssetUrls, } from "./rewriteSubCompPaths.js";
 import { warnUnknownEnumValues } from "../runtime/getVariables.js";
-import { createCompositionCssScoper, wrapInlineScriptWithErrorBoundary, scopedModulePrelude, wrapScopedCompositionScript, } from "./compositionScoping.js";
+import { createCompositionCssScoper, AUTHORED_SOURCE_BEGIN, AUTHORED_SOURCE_END, wrapInlineScriptWithErrorBoundary, scopedModulePrelude, wrapScopedCompositionScript, } from "./compositionScoping.js";
 import { namespaceCollidingSvgIds, rewriteSvgIdReferencesInCss, } from "./svgIdNamespacing.js";
 import { checkSubCompositionUsability, resolveSubCompositionContent, } from "@hyperframes/parsers/sub-composition-validity";
 import { enumerateNestedCompositionHosts, planCompositionAssembly, extractedCompositionAssets, } from "./compositionAssembly.js";
@@ -419,7 +419,7 @@ export function inlineSubCompositions(document, hosts, options) {
                 const prelude = scriptCompositionId
                     ? scopedModulePrelude(runtimeCompId || scopeCompId || scriptCompositionId, src)
                     : "";
-                moduleScripts.push(prelude + (scriptEl.textContent || ""));
+                moduleScripts.push(`${prelude}${AUTHORED_SOURCE_BEGIN}\n${scriptEl.textContent || ""}\n${AUTHORED_SOURCE_END}`);
             }
             else if (externalSrc) {
                 if (!externalScriptSrcs.includes(externalSrc)) {

package/dist/compiler/pngColourTags.d.ts

@@ -0,0 +1,2 @@
+/** An SDR PNG's copy without the tags that make Chrome re-map its pixels; null if none apply or it is HDR. */
+export declare function stripSdrPngColourTags(png: Uint8Array): Buffer | null;

package/dist/compiler/pngColourTags.js

@@ -0,0 +1,27 @@
+const PNG_SIGNATURE = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
+const PNG_SIGNATURE_BYTES = PNG_SIGNATURE.length;
+const CHUNK_OVERHEAD_BYTES = 12;
+const REMOVED_CHUNKS = new Set(["cICP", "gAMA", "cHRM"]);
+const HDR_CICP_TRANSFERS = new Set([16, 18]);
+/** An SDR PNG's copy without the tags that make Chrome re-map its pixels; null if none apply or it is HDR. */
+export function stripSdrPngColourTags(png) {
+    const bytes = Buffer.from(png.buffer, png.byteOffset, png.byteLength);
+    if (!bytes.subarray(0, PNG_SIGNATURE_BYTES).equals(PNG_SIGNATURE))
+        return null;
+    const kept = [bytes.subarray(0, PNG_SIGNATURE_BYTES)];
+    let removed = false;
+    for (let at = PNG_SIGNATURE_BYTES; at + CHUNK_OVERHEAD_BYTES <= bytes.length;) {
+        const end = at + CHUNK_OVERHEAD_BYTES + bytes.readUInt32BE(at);
+        if (end > bytes.length)
+            return null;
+        const type = bytes.toString("latin1", at + 4, at + 8);
+        if (type === "cICP" && HDR_CICP_TRANSFERS.has(bytes[at + 9] ?? 0))
+            return null;
+        if (REMOVED_CHUNKS.has(type))
+            removed = true;
+        else
+            kept.push(bytes.subarray(at, end));
+        at = end;
+    }
+    return removed ? Buffer.concat(kept) : null;
+}

package/dist/compiler/scriptRuns.d.ts

@@ -17,7 +17,7 @@ export declare function deferScriptsUntilFonts(document: Document, isFramework?:
 export declare function typeAfterFonts(el: Element): string | null;
 /** Undefined for a type the browser never applies as CSS; `media="all"` and an empty title count as none. */
 export declare function cssStyleMergeKey(el: Element): string | undefined;
-export declare const UNCONDITIONAL_CSS_KEY: string;
+export declare function isAlwaysAppliedStyle(el: Element): boolean;
 export declare function hasSameLink(scope: ParentNode, link: Element): boolean;
 /** Groups head styles into runs of adjacent styles with one merge key, so merging a run never reorders rules. */
 export declare function headStyleRuns(styles: readonly Element[], isPinned?: (el: Element) => boolean): Element[][];

package/dist/compiler/scriptRuns.js

@@ -102,7 +102,10 @@ export function cssStyleMergeKey(el) {
     const media = (el.getAttribute("media") ?? "").trim().toLowerCase();
     return JSON.stringify([media === "all" ? "" : media, el.getAttribute("title") ?? ""]);
 }
-export const UNCONDITIONAL_CSS_KEY = JSON.stringify(["", ""]);
+const UNCONDITIONAL_CSS_KEY = JSON.stringify(["", ""]);
+export function isAlwaysAppliedStyle(el) {
+    return cssStyleMergeKey(el) === UNCONDITIONAL_CSS_KEY && !el.closest("template, noscript, svg");
+}
 /** A link's identity and condition; fetch attributes (crossorigin, integrity, referrerpolicy) are not compared. */
 function linkDedupeKey(el) {
     return JSON.stringify([