hyperframes 0.7.22 → 0.7.23

package/dist/studio/assets/{index-gk_X4nXD.js → index-BRZTrsSs.js}

@@ -1,4 +1,4 @@
-import{n as Qi}from"./index-B4h4u7eW.js";/*!
+import{n as Qi}from"./index-B8XMgbWF.js";/*!
  * Copyright (c) 2026-present, Vanilagy and contributors
  *
  * This Source Code Form is subject to the terms of the Mozilla Public

package/dist/studio/assets/{index-B_gDTiNI.js → index-DPO5Gw_v.js}

@@ -1 +1 @@
-import{g as P}from"./index-B4h4u7eW.js";function j(c,d){for(var s=0;s<d.length;s++){const a=d[s];if(typeof a!="string"&&!Array.isArray(a)){for(const i in a)if(i!=="default"&&!(i in c)){const l=Object.getOwnPropertyDescriptor(a,i);l&&Object.defineProperty(c,i,l.get?l:{enumerable:!0,get:()=>a[i]})}}}return Object.freeze(Object.defineProperty(c,Symbol.toStringTag,{value:"Module"}))}var v={},w;function k(){if(w)return v;w=1,Object.defineProperty(v,"__esModule",{value:!0}),v.default=d;var c=window.OfflineAudioContext||window.webkitOfflineAudioContext;function d(e){var r=a(e);return r.start(0),[i,y,O(e.sampleRate),s].reduce(function(t,o){return o(t)},r.buffer.getChannelData(0))}function s(e){return e.sort(function(r,t){return t.count-r.count}).splice(0,5)[0].tempo}function a(e){var r=e.length,t=e.numberOfChannels,o=e.sampleRate,n=new c(t,r,o),u=n.createBufferSource();u.buffer=e;var f=n.createBiquadFilter();return f.type="lowpass",u.connect(f),f.connect(n.destination),u}function i(e){for(var r=[],t=.9,o=.3,n=15;r.length<n&&t>=o;)r=l(e,t),t-=.05;if(r.length<n)throw new Error("Could not find enough samples for a reliable detection.");return r}function l(e,r){for(var t=[],o=0,n=e.length;o<n;o+=1)e[o]>r&&(t.push(o),o+=1e4);return t}function y(e){var r=[];return e.forEach(function(t,o){for(var n=function(x){var g=e[o+x]-t,_=r.some(function(h){if(h.interval===g)return h.count+=1});_||r.push({interval:g,count:1})},u=0;u<10;u+=1)n(u)}),r}function O(e){return function(r){var t=[];return r.forEach(function(o){if(o.interval!==0){for(var n=60/(o.interval/e);n<90;)n*=2;for(;n>180;)n/=2;n=Math.round(n);var u=t.some(function(f){if(f.tempo===n)return f.count+=o.count});u||t.push({tempo:n,count:o.count})}}),t}}return v}var p,b;function q(){return b||(b=1,p=k().default),p}var m=q();const A=P(m),D=j({__proto__:null,default:A},[m]);export{D as i};
+import{g as P}from"./index-B8XMgbWF.js";function j(c,d){for(var s=0;s<d.length;s++){const a=d[s];if(typeof a!="string"&&!Array.isArray(a)){for(const i in a)if(i!=="default"&&!(i in c)){const l=Object.getOwnPropertyDescriptor(a,i);l&&Object.defineProperty(c,i,l.get?l:{enumerable:!0,get:()=>a[i]})}}}return Object.freeze(Object.defineProperty(c,Symbol.toStringTag,{value:"Module"}))}var v={},w;function k(){if(w)return v;w=1,Object.defineProperty(v,"__esModule",{value:!0}),v.default=d;var c=window.OfflineAudioContext||window.webkitOfflineAudioContext;function d(e){var r=a(e);return r.start(0),[i,y,O(e.sampleRate),s].reduce(function(t,o){return o(t)},r.buffer.getChannelData(0))}function s(e){return e.sort(function(r,t){return t.count-r.count}).splice(0,5)[0].tempo}function a(e){var r=e.length,t=e.numberOfChannels,o=e.sampleRate,n=new c(t,r,o),u=n.createBufferSource();u.buffer=e;var f=n.createBiquadFilter();return f.type="lowpass",u.connect(f),f.connect(n.destination),u}function i(e){for(var r=[],t=.9,o=.3,n=15;r.length<n&&t>=o;)r=l(e,t),t-=.05;if(r.length<n)throw new Error("Could not find enough samples for a reliable detection.");return r}function l(e,r){for(var t=[],o=0,n=e.length;o<n;o+=1)e[o]>r&&(t.push(o),o+=1e4);return t}function y(e){var r=[];return e.forEach(function(t,o){for(var n=function(x){var g=e[o+x]-t,_=r.some(function(h){if(h.interval===g)return h.count+=1});_||r.push({interval:g,count:1})},u=0;u<10;u+=1)n(u)}),r}function O(e){return function(r){var t=[];return r.forEach(function(o){if(o.interval!==0){for(var n=60/(o.interval/e);n<90;)n*=2;for(;n>180;)n/=2;n=Math.round(n);var u=t.some(function(f){if(f.tempo===n)return f.count+=o.count});u||t.push({tempo:n,count:o.count})}}),t}}return v}var p,b;function q(){return b||(b=1,p=k().default),p}var m=q();const A=P(m),D=j({__proto__:null,default:A},[m]);export{D as i};

package/dist/studio/index.html

@@ -5,7 +5,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
     <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
     <title>HyperFrames Studio</title>
-    <script type="module" crossorigin src="/assets/index-B4h4u7eW.js"></script>
+    <script type="module" crossorigin src="/assets/index-B8XMgbWF.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-DmkOvZns.css">
   </head>
   <body>

package/dist/studio/index.js

@@ -1470,6 +1470,72 @@ function generateId() {
   return `${Date.now()}-${Math.random().toString(36).slice(2)}`;
 }
 
+// src/utils/safeStorage.ts
+function safeLocalStorage() {
+  try {
+    return typeof localStorage === "undefined" ? null : localStorage;
+  } catch {
+    return null;
+  }
+}
+function safeSessionStorage() {
+  try {
+    return typeof sessionStorage === "undefined" ? null : sessionStorage;
+  } catch {
+    return null;
+  }
+}
+
+// src/telemetry/distinctId.ts
+var DISTINCT_ID_KEY = "hyperframes-studio:anonymousId";
+var LEGACY_STUDIO_ANON_ID_KEY = "hf-studio-anon-id";
+var cachedId = null;
+function getCliDistinctId() {
+  try {
+    const id = typeof window === "undefined" ? void 0 : window.__HF_CLI_DISTINCT_ID;
+    return typeof id === "string" && id.length > 0 ? id : null;
+  } catch {
+    return null;
+  }
+}
+function persist(ls, id) {
+  for (const key of [DISTINCT_ID_KEY, LEGACY_STUDIO_ANON_ID_KEY]) {
+    try {
+      ls.setItem(key, id);
+    } catch {
+    }
+  }
+}
+function resolveStudioDistinctId() {
+  if (cachedId) return cachedId;
+  const ls = safeLocalStorage();
+  const cliId = getCliDistinctId();
+  if (cliId) {
+    cachedId = cliId;
+    if (ls) persist(ls, cliId);
+    return cliId;
+  }
+  if (ls) {
+    let existing = null;
+    try {
+      existing = ls.getItem(DISTINCT_ID_KEY) ?? ls.getItem(LEGACY_STUDIO_ANON_ID_KEY);
+    } catch {
+    }
+    if (existing) {
+      cachedId = existing;
+      persist(ls, existing);
+      return existing;
+    }
+  } else {
+    cachedId = "anonymous";
+    return cachedId;
+  }
+  const id = generateId();
+  cachedId = id;
+  persist(ls, id);
+  return id;
+}
+
 // src/utils/studioTelemetry.ts
 var POSTHOG_API_KEY = "phc_zjjbX0PnWxERXrMHhkEJWj9A9BhGVLRReICgsfTMmpx";
 var POSTHOG_HOST = "https://us.i.posthog.com";
@@ -1477,23 +1543,8 @@ var FLUSH_INTERVAL_MS = 3e4;
 var FLUSH_TIMEOUT_MS = 5e3;
 var queue = [];
 var flushTimer = null;
-var distinctId = null;
 function getDistinctId() {
-  if (distinctId) return distinctId;
-  try {
-    const stored = localStorage.getItem("hf-studio-anon-id");
-    if (stored) {
-      distinctId = stored;
-      return stored;
-    }
-  } catch {
-  }
-  distinctId = generateId();
-  try {
-    localStorage.setItem("hf-studio-anon-id", distinctId);
-  } catch {
-  }
-  return distinctId;
+  return resolveStudioDistinctId();
 }
 function isEnabled() {
   try {
@@ -2825,7 +2876,7 @@ function useMusicBeatAnalysis() {
       void io.writeProjectFile(beatPath, content).catch(() => {
       });
     };
-    const persist = () => {
+    const persist2 = () => {
       const s = usePlayerStore.getState();
       const a = s.beatAnalysis;
       if (!a) return;
@@ -2837,7 +2888,7 @@ function useMusicBeatAnalysis() {
         flush2();
       }, PERSIST_DEBOUNCE_MS);
     };
-    setBeatPersist(persist);
+    setBeatPersist(persist2);
     return () => {
       if (timer) clearTimeout(timer);
       flush2();
@@ -9469,30 +9520,10 @@ function useCompositionStack({
 }
 
 // src/telemetry/config.ts
-var ANON_ID_KEY = "hyperframes-studio:anonymousId";
 var OPT_OUT_KEY = "hyperframes-studio:telemetryDisabled";
 var NOTICE_KEY = "hyperframes-studio:telemetryNoticeShown";
-function safeLocalStorage() {
-  try {
-    return typeof localStorage === "undefined" ? null : localStorage;
-  } catch {
-    return null;
-  }
-}
-function newAnonymousId() {
-  return generateId();
-}
 function getAnonymousId() {
-  const ls = safeLocalStorage();
-  if (!ls) return "anonymous";
-  const existing = ls.getItem(ANON_ID_KEY);
-  if (existing) return existing;
-  const id = newAnonymousId();
-  try {
-    ls.setItem(ANON_ID_KEY, id);
-  } catch {
-  }
-  return id;
+  return resolveStudioDistinctId();
 }
 function isOptedOut() {
   return safeLocalStorage()?.getItem(OPT_OUT_KEY) === "1";
@@ -9507,13 +9538,6 @@ function markNoticeShown() {
   }
 }
 var SESSION_FIRED_KEY = "hyperframes-studio:sessionStartFired";
-function safeSessionStorage() {
-  try {
-    return typeof sessionStorage === "undefined" ? null : sessionStorage;
-  } catch {
-    return null;
-  }
-}
 function hasFiredSessionStart() {
   return safeSessionStorage()?.getItem(SESSION_FIRED_KEY) === "1";
 }
@@ -9608,12 +9632,12 @@ function trackEvent(event, properties = {}) {
 }
 function flush() {
   if (eventQueue.length === 0) return;
-  const distinctId2 = getAnonymousId();
+  const distinctId = getAnonymousId();
   const batch = eventQueue.map((e) => ({
     event: e.event,
     // $ip: null tells PostHog to not record the request IP.
     properties: { ...e.properties, $ip: null },
-    distinct_id: distinctId2,
+    distinct_id: distinctId,
     timestamp: e.timestamp
   }));
   eventQueue = [];
@@ -22424,10 +22448,14 @@ function runResolverShadow(session, hfId, ops, sourceContent) {
       // sessionElementCount === 0 = session is empty/broken (actionable).
       sessionElementCount: session.getElements().length,
       // Count of data-hf-id="<id>" occurrences in source for an emitted
-      // element_not_found (the runtime-node filter already dropped absent-from-
-      // source ids, so an emitted one is in source ≥1×). >1 = duplicate ids →
-      // resolver picked the wrong instance; =1 = single static node the SDK
-      // parse dropped (foreign-content exclusion / sub-comp inlining gap).
+      // element_not_found. >1 = duplicate ids → resolver picked the wrong
+      // instance; =1 = single static node the SDK parse dropped (foreign-content
+      // exclusion / sub-comp inlining gap); =0 = the runtime-node filter above
+      // uses a loose substring match (biased toward keeping signal) while this
+      // count uses a strict attribute match — an emitted event with count 0
+      // means hfId appeared in source as plain text (e.g. a class name, comment,
+      // or script string) but never as a data-hf-id attribute. Treat 0 as "not
+      // a genuine attribute occurrence," not as a contradiction.
       ...isElementNotFound && sourceContent !== void 0 ? { sourceHfIdCount: countHfIdInSource(sourceContent, hfId) } : {},
       mismatchCount: mismatches.length,
       mismatches: JSON.stringify(redactMismatches(mismatches))
@@ -22435,15 +22463,30 @@ function runResolverShadow(session, hfId, ops, sourceContent) {
   } catch {
   }
 }
-function recordResolverParity(session, hfId, opLabel) {
+async function recordResolverParity(session, hfId, opLabel, readSource) {
   if (!STUDIO_SDK_RESOLVER_SHADOW_ENABLED) return;
   if (!session || !hfId) return;
   try {
     if (resolveSnapshot(session, hfId)) return;
+    const sessionElementCount = session.getElements().length;
+    let source;
+    if (readSource) {
+      try {
+        source = await readSource();
+      } catch {
+        source = void 0;
+      }
+    }
+    if (source !== void 0 && !source.includes(hfId)) return;
     trackStudioEvent("sdk_resolver_shadow", {
       hfId,
       opLabel,
-      sessionElementCount: session.getElements().length,
+      sessionElementCount,
+      // sourceHfIdCount: strict data-hf-id="..." attribute count. Can be 0 even
+      // on an emitted (non-suppressed) event — the suppression check above is a
+      // loose substring match (biased toward keeping signal); see the longer
+      // comment on this field in runResolverShadow for the full explanation.
+      ...source !== void 0 ? { sourceHfIdCount: countHfIdInSource(source, hfId) } : {},
       mismatchCount: 1,
       mismatches: JSON.stringify([
         { kind: "element_not_found", hfId }
@@ -22559,7 +22602,7 @@ function isSafeAttributeValue(name, value) {
   return true;
 }
 
-// src/utils/sdkCutover.ts
+// src/utils/sdkCutoverEligibility.ts
 var CUTOVER_OP_TYPES = /* @__PURE__ */ new Set([
   "inline-style",
   "text-content",
@@ -22619,6 +22662,8 @@ function shouldDeclineTextCutoverForTarget(target, ops) {
 function shouldUseSdkCutover(flagEnabled, hasSession, hfId, ops) {
   return flagEnabled && hasSession && !!hfId && ops.length > 0 && ops.every((o) => CUTOVER_OP_TYPES.has(o.type)) && !ops.some(mapsToReservedAttr) && !hasUnsafeHtmlAttributeOp(ops);
 }
+
+// src/utils/sdkCutover.ts
 async function captureOnDiskBefore(deps, targetPath, serializedFallback) {
   if (!deps.readProjectFile) return serializedFallback;
   try {
@@ -22674,7 +22719,13 @@ async function sdkCutoverPersist(selection, ops, originalContent, targetPath, sd
   }
 }
 async function sdkTimingPersist(hfId, targetPath, timingUpdate, sdkSession, deps, options) {
-  recordResolverParity(sdkSession, hfId, "setTiming");
+  const timingSrc = deps.readProjectFile;
+  void recordResolverParity(
+    sdkSession,
+    hfId,
+    "setTiming",
+    timingSrc ? () => timingSrc(targetPath) : void 0
+  );
   if (!STUDIO_SDK_CUTOVER_ENABLED) return false;
   if (!sdkSession || !sdkSession.getElement(hfId)) return false;
   if (wrongCompositionFile(deps, targetPath)) return false;
@@ -22693,8 +22744,15 @@ async function sdkTimingPersist(hfId, targetPath, timingUpdate, sdkSession, deps
   }
 }
 function sdkGsapTweenPersist(targetPath, op, sdkSession, deps, options) {
-  if (op.kind === "add") recordResolverParity(sdkSession, op.target, "addGsapTween");
-  else
+  if (op.kind === "add") {
+    const gsapSrc = deps.readProjectFile;
+    void recordResolverParity(
+      sdkSession,
+      op.target,
+      "addGsapTween",
+      gsapSrc ? () => gsapSrc(targetPath) : void 0
+    );
+  } else
     recordAnimationResolverParity(
       sdkSession,
       op.animationId,
@@ -22840,7 +22898,12 @@ function sdkReplaceWithKeyframesPersist(targetPath, animationId, targetSelector,
   );
 }
 async function sdkDeletePersist(hfId, originalContent, targetPath, sdkSession, deps) {
-  recordResolverParity(sdkSession, hfId, "removeElement");
+  void recordResolverParity(
+    sdkSession,
+    hfId,
+    "removeElement",
+    () => Promise.resolve(originalContent)
+  );
   if (!STUDIO_SDK_CUTOVER_ENABLED) return false;
   if (!sdkSession || !sdkSession.getElement(hfId)) return false;
   if (wrongCompositionFile(deps, targetPath)) return false;
@@ -29769,7 +29832,7 @@ function useDomEditSession({
   showToast,
   refreshPreviewDocumentVersion,
   queueDomEditSave,
-  readProjectFile: _readProjectFile,
+  readProjectFile,
   writeProjectFile,
   updateEditingFileContent,
   domEditSaveTimestampRef,
@@ -29793,7 +29856,6 @@ function useDomEditSession({
   forceReloadSdkSession
 }) {
   void _setRefreshKey;
-  void _readProjectFile;
   const {
     domEditSelection,
     domEditGroupSelections,
@@ -29952,7 +30014,9 @@ function useDomEditSession({
     // SDK persist), but the tripwire is decoupled from cutover — record whether
     // the SDK resolves each reordered element (the reorderElements op's targets).
     onReorderShadow: sdkSession ? (targets) => {
-      for (const target of targets) recordResolverParity(sdkSession, target, "reorderElements");
+      const reorderSrc = activeCompPath ? () => readProjectFile(activeCompPath) : void 0;
+      for (const target of targets)
+        void recordResolverParity(sdkSession, target, "reorderElements", reorderSrc);
     } : void 0
   });
   const { groupSelection, ungroupSelection } = useGroupCommits({
@@ -42664,9 +42728,9 @@ function makeSlideshowNotesController() {
     });
   };
   return {
-    schedule(manifest, persist, delayMs) {
+    schedule(manifest, persist2, delayMs) {
       if (timer !== null) clearTimeout(timer);
-      pending = { manifest, persist };
+      pending = { manifest, persist: persist2 };
       timer = setTimeout(() => {
         timer = null;
         drainPending();