@hyperframes/core 0.8.211 → 0.8.213

package/dist/audioAnalysis.d.ts

@@ -99,6 +99,7 @@ export interface KindFeatures {
     syllables: number;
     /** Share of 50 ms frames within 20 dB of the loud end (95th percentile), 0–1: high for beds and speech, low for hits. */
     sustain: number;
+    voiced?: number;
 }
 export declare const signalDuration: (signal: AudioSignal) => number;
 /** Per-sample energy. Channels are squared first, so a reversed channel stays audible. */
@@ -112,10 +113,11 @@ export declare function silence(signal: AudioSignal, options?: SilenceOptions):
 export declare function kindFeatures(signal: AudioSignal): KindFeatures;
 /**
  * A first guess at what the audio is. Length decides most of it: beds run long, effects short. Long audio is voice
- * when its envelope moves at syllable rate without a beat; short audio is voice when it also holds its level.
+ * when its envelope moves at syllable rate without a beat; short audio also holds its level. Both need a voice pitch.
  */
 export declare function classify(signal: AudioSignal): KindGuess;
 export * from "./audioAnalysisLadder.js";
+export * from "./audioPitch.js";
 export * from "./audioRhythm.js";
 export * from "./audioSections.js";
 export * from "./audioSnap.js";

package/dist/audioAnalysis.js

@@ -4,6 +4,7 @@
  */
 import { finish } from "./audioSteps.js";
 import { fft } from "./fft.js";
+import { voicedShare } from "./audioPitch.js";
 import { rhythm } from "./audioRhythm.js";
 import { sections } from "./audioSections.js";
 const DB_FLOOR = -120;
@@ -416,26 +417,33 @@ export function kindFeatures(signal) {
         sustain: round(sustainShare(signal)),
     };
 }
+const VOICED_SPEECH = 0.15;
+const VOICED_STEADY_SPEECH = 0.25;
 /**
  * A first guess at what the audio is. Length decides most of it: beds run long, effects short. Long audio is voice
- * when its envelope moves at syllable rate without a beat; short audio is voice when it also holds its level.
+ * when its envelope moves at syllable rate without a beat; short audio also holds its level. Both need a voice pitch.
  */
 export function classify(signal) {
     const features = kindFeatures(signal);
     const { duration, regularity, syllables, sustain } = features;
     const speechLike = syllables >= 0.35 && regularity < 0.35;
+    const voiced = () => (features.voiced ??= round(voicedShare(signal.channels, signal.sampleRate)));
+    const pitched = () => voiced() >= VOICED_SPEECH;
     if (duration >= 8) {
         if (sustain < 0.4)
             return { value: "sfx", confidence: 0.6, features };
-        if (speechLike)
+        if (speechLike && pitched())
             return { value: "voice", confidence: round(Math.min(0.9, 0.4 + syllables)), features };
+        if (regularity < 0.2 && syllables >= 0.17 && voiced() >= VOICED_STEADY_SPEECH)
+            return { value: "voice", confidence: 0.6, features };
         return { value: "music", confidence: round(Math.min(0.9, 0.5 + regularity)), features };
     }
-    if (duration >= 1.5 && syllables >= 0.17 && regularity < 0.3 && sustain >= 0.7)
+    if (duration >= 1.5 && syllables >= 0.17 && regularity < 0.3 && sustain >= 0.7 && pitched())
         return { value: "voice", confidence: speechLike ? 0.8 : 0.6, features };
     return { value: "sfx", confidence: duration <= 2 ? 0.85 : 0.65, features };
 }
 export * from "./audioAnalysisLadder.js";
+export * from "./audioPitch.js";
 export * from "./audioRhythm.js";
 export * from "./audioSections.js";
 export * from "./audioSnap.js";

package/dist/audioPitch.d.ts

@@ -0,0 +1,12 @@
+/** The rate pitch is tracked at: 8 kHz keeps the 70–500 Hz search cheap. */
+export declare const PITCH_RATE = 8000;
+export interface PitchPoint {
+    t: number;
+    hz: number;
+}
+/** The fundamental of each voiced 40 ms frame of 8 kHz mono, by YIN's cumulative mean normalized difference. */
+export declare function pitchTrack(pcm: Float32Array): PitchPoint[];
+/** Mono at {@link PITCH_RATE}: channels averaged, a box filter as wide as the step against aliasing, then sampled. */
+export declare function atPitchRate(channels: readonly Float32Array[], sampleRate: number): Float32Array;
+/** The share of 40 ms frames with a fundamental in the voice range; hits, whooshes and noise have none. */
+export declare function voicedShare(channels: readonly Float32Array[], sampleRate: number): number;

package/dist/audioPitch.js

@@ -0,0 +1,91 @@
+/** The rate pitch is tracked at: 8 kHz keeps the 70–500 Hz search cheap. */
+export const PITCH_RATE = 8000;
+const FRAME = 320;
+const HOP = 320;
+const LOW_HZ = 70;
+const HIGH_HZ = 500;
+const VOICED_DB = -35;
+const PERIODIC = 0.15;
+const MIN_LAG = Math.floor(PITCH_RATE / HIGH_HZ);
+const MAX_LAG = Math.ceil(PITCH_RATE / LOW_HZ);
+function voiced(channels, start) {
+    let energy = 0;
+    for (const pcm of channels)
+        for (let i = 0; i < FRAME; i++)
+            energy += pcm[start + i] ** 2;
+    return 10 * Math.log10(energy / (FRAME * channels.length) + 1e-12) >= VOICED_DB;
+}
+function difference(channels, start, tau) {
+    let sum = 0;
+    for (const pcm of channels) {
+        for (let i = 0; i < FRAME; i++) {
+            const delta = pcm[start + i] - pcm[start + i + tau];
+            sum += delta * delta;
+        }
+    }
+    return sum;
+}
+/** The first lag whose normalized difference dips under the threshold, followed down to its minimum; -1 if none. */
+function periodOf(channels, start, d) {
+    let running = 0;
+    let lag = -1;
+    for (let tau = 1; tau <= MAX_LAG; tau++) {
+        const sum = difference(channels, start, tau);
+        running += sum;
+        d[tau] = running > 0 ? (sum * tau) / running : 1;
+        if (lag === -1) {
+            if (tau >= MIN_LAG && d[tau] < PERIODIC)
+                lag = tau;
+        }
+        else if (d[tau] > d[tau - 1])
+            break;
+        else if (d[tau] < d[lag])
+            lag = tau;
+    }
+    return lag;
+}
+/** The fundamental of each voiced 40 ms frame of 8 kHz mono, by YIN's cumulative mean normalized difference. */
+export function pitchTrack(pcm) {
+    return channelPitchTrack([pcm]);
+}
+function channelPitchTrack(channels) {
+    const length = channels[0]?.length ?? 0;
+    const out = [];
+    const d = new Float64Array(MAX_LAG + 1);
+    for (let start = 0; start + FRAME + MAX_LAG <= length; start += HOP) {
+        if (!voiced(channels, start))
+            continue;
+        const lag = periodOf(channels, start, d);
+        if (lag > 0)
+            out.push({ t: (start + FRAME / 2) / PITCH_RATE, hz: PITCH_RATE / lag });
+    }
+    return out;
+}
+/** Mono at {@link PITCH_RATE}: channels averaged, a box filter as wide as the step against aliasing, then sampled. */
+export function atPitchRate(channels, sampleRate) {
+    const length = channels[0]?.length ?? 0;
+    if (!length || !channels.length)
+        return new Float32Array(0);
+    const step = sampleRate / PITCH_RATE;
+    const width = Math.max(1, Math.round(step));
+    const sums = new Float64Array(length + 1);
+    for (let i = 0; i < length; i++) {
+        let mixed = 0;
+        for (const channel of channels)
+            mixed += channel[i];
+        sums[i + 1] = sums[i] + mixed / channels.length;
+    }
+    const out = new Float32Array(Math.floor(length / step));
+    for (let n = 0; n < out.length; n++) {
+        const from = Math.floor(n * step);
+        const to = Math.min(length, from + width);
+        out[n] = (sums[to] - sums[from]) / (to - from);
+    }
+    return out;
+}
+/** The share of 40 ms frames with a fundamental in the voice range; hits, whooshes and noise have none. */
+export function voicedShare(channels, sampleRate) {
+    const pitched = channels.map((channel) => atPitchRate([channel], sampleRate));
+    const frames = Math.floor((pitched[0]?.length ?? 0) / HOP);
+    return frames ? channelPitchTrack(pitched).length / frames : 0;
+}

package/dist/compiler/htmlBundler.js

@@ -888,7 +888,11 @@ async function bundleProject(projectDir, options) {
     const rawHtml = readSource(mountedShell ?? entryHtml);
     const compiled = await compileHtml(rawHtml, sourceDir, options?.probeMediaDuration);
     if (options?.staticGuard !== false && !mountedShell) {
-        const staticGuard = await validateHyperframeHtmlContract(compiled);
+        const entryRel = relative(projectDir, indexPath).replace(/\\/g, "/");
+        const staticGuard = await validateHyperframeHtmlContract(compiled, {
+            dir: projectDir,
+            ...(entryRel !== "index.html" && { compSrcPath: entryRel }),
+        });
         if (!staticGuard.isValid) {
             console.warn(`[StaticGuard] Invalid HyperFrame contract: ${staticGuard.missingKeys.join("; ")}`);
         }

package/dist/compiler/staticGuard.d.ts

@@ -4,4 +4,7 @@ export type HyperframeStaticGuardResult = {
     missingKeys: string[];
     failureReason: HyperframeStaticFailureReason | null;
 };
-export declare function validateHyperframeHtmlContract(html: string): Promise<HyperframeStaticGuardResult>;
+export declare function validateHyperframeHtmlContract(html: string, project?: {
+    dir: string;
+    compSrcPath?: string;
+}): Promise<HyperframeStaticGuardResult>;

package/dist/compiler/staticGuard.js

@@ -1,6 +1,8 @@
-import { lintHyperframeHtml } from "@hyperframes/lint";
-export async function validateHyperframeHtmlContract(html) {
-    const result = await lintHyperframeHtml(html);
+import { collectExternalStyles, lintHyperframeHtml } from "@hyperframes/lint";
+export async function validateHyperframeHtmlContract(html, project) {
+    const result = await lintHyperframeHtml(html, project && {
+        externalStyles: collectExternalStyles(project.dir, html, project.compSrcPath),
+    });
     const missingKeys = result.findings
         .filter((finding) => finding.severity === "error")
         .map((finding) => finding.message);

package/dist/fonts/deterministicFonts.d.ts

@@ -36,7 +36,7 @@ export declare function parseFontFamilyValue(value: string): string[];
  */
 export declare function normalizeSystemFontPrimaryFamilies(html: string, deterministicPrimary?: string): string;
 /** Surfaces font-family is declared on in served HTML. */
-export type FontFamilySurface = "font-family" | "data-font-family";
+export type FontFamilySurface = "font-family" | "font" | "data-font-family";
 export type FontFamilyDeclaration = {
     surface: FontFamilySurface;
     declaration: string;

package/dist/fonts/deterministicFonts.js

@@ -213,16 +213,30 @@ function collectCssCustomProperties(css, customProperties) {
         customProperties.set(decl.prop, decl.value);
     });
 }
+const FONT_SIZE_KEYWORD = /^(?:xx-small|x-small|small|medium|large|x-large|xx-large|xxx-large|smaller|larger)$/i;
+const FONT_SIZE_TOKEN = /^(?:\d*\.?\d+[a-z%]+|(?:calc|min|max|clamp|var)\(.*\))(?:\/\S+)?$/i;
+function fontShorthandFamilies(value) {
+    for (const token of value.matchAll(/(?:[^\s(]|\([^)]*\))+/g)) {
+        const size = token[0].split("/")[0] ?? "";
+        if (FONT_SIZE_KEYWORD.test(size) || FONT_SIZE_TOKEN.test(token[0])) {
+            return value.slice(token.index + token[0].length).trim();
+        }
+    }
+    return "";
+}
 function* iterateCssRootFontFamilyDeclarations(root) {
     const declarations = [];
     root.walkDecls((decl) => {
-        if (decl.prop.toLowerCase() !== "font-family")
+        const prop = decl.prop.toLowerCase();
+        if (prop !== "font-family" && prop !== "font")
             return;
         if (isFontFaceDeclaration(decl))
             return;
-        const declaration = decl.value;
+        const declaration = prop === "font" ? fontShorthandFamilies(decl.value) : decl.value;
+        if (!declaration)
+            return;
         declarations.push({
-            surface: "font-family",
+            surface: prop,
             declaration,
             families: parseFontFamilyValue(declaration),
         });
@@ -230,7 +244,7 @@ function* iterateCssRootFontFamilyDeclarations(root) {
     yield* declarations;
 }
 function* iterateCssFontFamilyDeclarations(css) {
-    if (!/font-family/i.test(css))
+    if (!/font(?:-family)?\s*:/i.test(css))
         return;
     const root = parseCssRoot(css);
     if (!root)

package/dist/generated/position-edits-render-inline.js

@@ -1,5 +1,5 @@
 // Generated by scripts/build-position-edits-render.ts; do not edit.
-const POSITION_EDITS_RENDER_IIFE = '"use strict";(()=>{function x(){return globalThis}function P(e,t){if(typeof window>"u")return;let o=x(),r=o.__hf?.onSwallowed;if(r)try{r({label:e,error:t})}catch(s){}(o.__hfDebug||o.__HYPERFRAMES_DEBUG)&&console.debug(`[hyperframes] ${e} swallowed:`,t)}var T=null;function R(e,t){if(T)try{T({source:"hf-preview",type:"analytics",event:e,properties:t??{}})}catch(o){P("runtime.analytics.site1",o)}}var M="http://www.w3.org/1999/xhtml";function N(e){return e!=null&&e.nodeType===1}function _(e){return N(e)&&(e.namespaceURI===M||e.namespaceURI==="http://www.w3.org/2000/svg")}var y="data-hf-edit-base-x",w="data-hf-edit-base-y",m="data-hf-edit-original-translate",k=e=>{let t=parseFloat(e??"");return Number.isFinite(t)?t:0},C=e=>{let t=[],o=0,r="";for(let s of e.trim())s==="("&&(o+=1),s===")"&&(o=Math.max(0,o-1)),/\\s/.test(s)&&o===0?(r&&t.push(r),r=""):r+=s;return r&&t.push(r),t},$=/^-?(?:\\d+(?:\\.\\d+)?|\\.\\d+)px$/,E=(e,t)=>$.test(e)&&$.test(t)?`${parseFloat(e)+parseFloat(t)}px`:`calc(${e} + ${t})`,O=(e,t,o)=>{if(!e||e==="none")return`${t} ${o}`;let[r,s,a]=C(e);if(r===void 0)return`${t} ${o}`;if(s===void 0)return`${E(r,t)} ${o}`;let i=a===void 0?"":` ${a}`;return`${E(r,t)} ${E(s,o)}${i}`},j=e=>{try{e.ownerDocument.defaultView?.gsap?.getProperty?.(e,"x")}catch{}},V=e=>{let t=e.style.getPropertyValue("translate").trim();if(t)return t==="none"?"":t;try{let o=e.ownerDocument.defaultView,r=o?o.getComputedStyle(e).getPropertyValue("translate").trim():"";return r==="none"?"":r}catch{return""}},b=new WeakMap;function B(e,t){let o=b.get(e);if(!t?.force&&o!==void 0&&e.style.getPropertyValue("translate")!==o){R("position_edit_fold_skipped",{hfId:e.getAttribute("data-hf-id")});return}let r=k(e.getAttribute("data-x"))-k(e.getAttribute(y)),s=k(e.getAttribute("data-y"))-k(e.getAttribute(w));e.hasAttribute(m)||e.setAttribute(m,V(e)),o===void 0&&j(e);let a=e.getAttribute(m)??"",i=O(a,`${r}px`,`${s}px`);e.style.setProperty("translate",i),b.set(e,e.style.getPropertyValue("translate"))}function h(e,t){let o=e.querySelectorAll(`[${m}]:not([${y}]):not([${w}])`);for(let a=0;a<o.length;a++){let i=o[a];if(i===void 0||!_(i))continue;let g=i.getAttribute(m)??"";g===""?i.style.removeProperty("translate"):i.style.setProperty("translate",g),i.removeAttribute(m),b.delete(i)}let r=e.querySelectorAll(`[${y}], [${w}]`),s=0;for(let a=0;a<r.length;a++){let i=r[a];i===void 0||!_(i)||(B(i,t),s+=1)}return s}var L="__hfPositionEditsSeekReapplyWrapped",D=new WeakSet,F=new WeakMap,H=new WeakMap;function W(e){let t=e,o=()=>{try{h(t.document)}catch{}},r=n=>typeof n=="function"&&(D.has(n)||!!n[L]),s=n=>{D.add(n);try{Object.defineProperty(n,L,{value:!0})}catch{}},a=n=>{if(typeof n!="function"||r(n))return n;let l=function(...u){let d=n.apply(this,u);return o(),d};return s(l),l},i=(n,l)=>{let u=F.get(n);if(u?.has(l))return!0;let d=Object.getOwnPropertyDescriptor(n,l);if(d?.configurable===!1){let c=n[l];return typeof c=="function"&&(n[l]=a(c),o()),!1}let p=n[l],f=d?.set;return Object.defineProperty(n,l,{configurable:!0,enumerable:d?.enumerable??!0,get:()=>p,set:c=>{p=a(c),f?.call(n,c)}}),p=a(p),u??(u=new Set),u.add(l),F.set(n,u),o(),!0},g=(n,l)=>{let u=H.get(t),d=Object.getOwnPropertyDescriptor(t,n);if(!u?.has(n)){if(d?.configurable===!1){let c=t[n];return c?i(c,l):!1}let f=t[n];Object.defineProperty(t,n,{configurable:!0,enumerable:d?.enumerable??!0,get:()=>f,set:c=>{f=c,f&&i(f,l)}}),u??(u=new Set),u.add(n),H.set(t,u)}let p=t[n];return p?i(p,l):!1},S=()=>{let n=g("__hf","seek"),l=g("__player","renderSeek");return n&&l};if(S())return;let v=120,A=t.setInterval(()=>{if(S()){t.clearInterval(A);return}v-=1,v<=0&&t.clearInterval(A)},50)}function I(){document.querySelector(`[${y}], [${w}]`)&&(h(document),W(window))}document.readyState==="loading"?document.addEventListener("DOMContentLoaded",I,{once:!0}):I();})();\n';
+const POSITION_EDITS_RENDER_IIFE = '"use strict";(()=>{function x(){return globalThis}function T(e,t){if(typeof window>"u")return;let o=x(),r=o.__hf?.onSwallowed;if(r)try{r({label:e,error:t})}catch(s){}(o.__hfDebug||o.__HYPERFRAMES_DEBUG)&&console.debug(`[hyperframes] ${e} swallowed:`,t)}var P=null;function R(e,t){if(P)try{P({source:"hf-preview",type:"analytics",event:e,properties:t??{}})}catch(o){T("runtime.analytics.site1",o)}}var I="http://www.w3.org/1999/xhtml";function N(e){return e!=null&&e.nodeType===1}function _(e){return N(e)&&(e.namespaceURI===I||e.namespaceURI==="http://www.w3.org/2000/svg")}var y="data-hf-edit-base-x",w="data-hf-edit-base-y",m="data-hf-edit-original-translate",k=e=>{let t=parseFloat(e??"");return Number.isFinite(t)?t:0},C=e=>{let t=[],o=0,r="";for(let s of e.trim())s==="("&&(o+=1),s===")"&&(o=Math.max(0,o-1)),/\\s/.test(s)&&o===0?(r&&t.push(r),r=""):r+=s;return r&&t.push(r),t},$=/^-?(?:\\d+(?:\\.\\d+)?|\\.\\d+)px$/,E=(e,t)=>$.test(e)&&$.test(t)?`${parseFloat(e)+parseFloat(t)}px`:`calc(${e} + ${t})`,O=(e,t,o)=>{if(!e||e==="none")return`${t} ${o}`;let[r,s,a]=C(e);if(r===void 0)return`${t} ${o}`;if(s===void 0)return`${E(r,t)} ${o}`;let i=a===void 0?"":` ${a}`;return`${E(r,t)} ${E(s,o)}${i}`},j=e=>{try{e.ownerDocument.defaultView?.gsap?.getProperty?.(e,"x")}catch{}},V=e=>{let t=e.style.getPropertyValue("translate").trim();if(t)return t==="none"?"":t;try{let o=e.ownerDocument.defaultView,r=o?o.getComputedStyle(e).getPropertyValue("translate").trim():"";return r==="none"?"":r}catch{return""}},b=new WeakMap;function B(e,t){let o=b.get(e);if(!t?.force&&o!==void 0&&e.style.getPropertyValue("translate")!==o){R("position_edit_fold_skipped",{hfId:e.getAttribute("data-hf-id")});return}let r=k(e.getAttribute("data-x"))-k(e.getAttribute(y)),s=k(e.getAttribute("data-y"))-k(e.getAttribute(w));e.hasAttribute(m)||e.setAttribute(m,V(e)),o===void 0&&j(e);let a=e.getAttribute(m)??"",i=O(a,`${r}px`,`${s}px`);e.style.setProperty("translate",i),b.set(e,e.style.getPropertyValue("translate"))}function S(e,t){let o=e.querySelectorAll(`[${m}]:not([${y}]):not([${w}])`);for(let a=0;a<o.length;a++){let i=o[a];if(i===void 0||!_(i))continue;let g=i.getAttribute(m)??"";g===""?i.style.removeProperty("translate"):i.style.setProperty("translate",g),i.removeAttribute(m),b.delete(i)}let r=e.querySelectorAll(`[${y}], [${w}]`),s=0;for(let a=0;a<r.length;a++){let i=r[a];i===void 0||!_(i)||(B(i,t),s+=1)}return s}var L="__hfPositionEditsSeekReapplyWrapped",D=new WeakSet,F=new WeakMap,H=new WeakMap;function M(e){let t=e,o=()=>{try{S(t.document)}catch{}},r=n=>typeof n=="function"&&(D.has(n)||!!n[L]),s=n=>{D.add(n);try{Object.defineProperty(n,L,{value:!0})}catch{}},a=n=>{if(typeof n!="function"||r(n))return n;let l=function(...u){let d=n.apply(this,u);return o(),d};return s(l),l},i=(n,l)=>{let u=F.get(n);if(u?.has(l))return!0;let d=Object.getOwnPropertyDescriptor(n,l);if(d?.configurable===!1){let c=n[l];return typeof c=="function"&&(n[l]=a(c),o()),!1}let p=n[l],f=d?.set;return Object.defineProperty(n,l,{configurable:!0,enumerable:d?.enumerable??!0,get:()=>p,set:c=>{p=a(c),f?.call(n,c)}}),p=a(p),u??(u=new Set),u.add(l),F.set(n,u),o(),!0},g=(n,l)=>{let u=H.get(t),d=Object.getOwnPropertyDescriptor(t,n);if(!u?.has(n)){if(d?.configurable===!1){let c=t[n];return c?i(c,l):!1}let f=t[n];Object.defineProperty(t,n,{configurable:!0,enumerable:d?.enumerable??!0,get:()=>f,set:c=>{f=c,f&&i(f,l)}}),u??(u=new Set),u.add(n),H.set(t,u)}let p=t[n];return p?i(p,l):!1},h=()=>{let n=g("__hf","seek"),l=g("__player","renderSeek");return n&&l};if(h())return;let v=120,A=t.setInterval(()=>{if(h()){t.clearInterval(A);return}v-=1,v<=0&&t.clearInterval(A)},50)}function W(){document.querySelector(`[${y}], [${w}]`)&&(S(document),M(window))}document.readyState==="loading"?document.addEventListener("DOMContentLoaded",W,{once:!0}):W();})();\n';
 /** Returns the pre-built position-edits render IIFE as a string constant. */
 export function getPositionEditsRenderScript() {
     return POSITION_EDITS_RENDER_IIFE;