npm - hyperframes - Versions diffs - 0.7.22 → 0.7.24 - Mend

hyperframes 0.7.22 → 0.7.24

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (17) hide show

package/dist/cli.js +585 -35
package/dist/commands/contrast-audit.browser.js +40 -0
package/dist/commands/layout-audit.browser.js +46 -1
package/dist/hyperframe-runtime.js +25 -25
package/dist/hyperframe.manifest.json +1 -1
package/dist/hyperframe.runtime.iife.js +25 -25
package/dist/hyperframes-player.global.js +2 -2
package/dist/skills/hyperframes/SKILL.md +17 -17
package/dist/studio/assets/hyperframes-player-BGuumSiM.js +459 -0
package/dist/studio/assets/{index-B_gDTiNI.js → index-CGW4LOlP.js} +1 -1
package/dist/studio/assets/{index-B4h4u7eW.js → index-CnZuUYe6.js} +109 -109
package/dist/studio/assets/{index-gk_X4nXD.js → index-DsVS-Zmd.js} +1 -1
package/dist/studio/index.html +1 -1
package/dist/studio/index.js +139 -65
package/dist/studio/index.js.map +1 -1
package/package.json +1 -1
package/dist/studio/assets/hyperframes-player-DNLS_l47.js +0 -459

package/dist/studio/assets/{index-gk_X4nXD.js → index-DsVS-Zmd.js} RENAMED Viewed

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

package/dist/studio/index.html CHANGED Viewed

@@ -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-CnZuUYe6.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-DmkOvZns.css">
   </head>
   <body>

package/dist/studio/index.js CHANGED Viewed

@@ -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 = [];
@@ -22418,32 +22442,59 @@ function runResolverShadow(session, hfId, ops, sourceContent) {
     const mismatches = sdkResolverShadowCheck(session, hfId, ops, sourceContent);
     if (mismatches.length === 0) return;
     const isElementNotFound = mismatches.some((m) => m.kind === "element_not_found");
+    const strictCount = isElementNotFound && sourceContent !== void 0 ? countHfIdInSource(sourceContent, hfId) : void 0;
     trackStudioEvent("sdk_resolver_shadow", {
       hfId,
       // sessionElementCount > 0 + element_not_found = runtime-only element;
       // 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).
-      ...isElementNotFound && sourceContent !== void 0 ? { sourceHfIdCount: countHfIdInSource(sourceContent, hfId) } : {},
+      // 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 — see sourceLooseMatchOnly below.
+      ...strictCount !== void 0 ? { sourceHfIdCount: strictCount } : {},
+      // Loose suppression check matched (kept this event) but the strict
+      // attribute count came back 0 — see the sourceHfIdCount comment above.
+      ...strictCount === 0 ? { sourceLooseMatchOnly: true } : {},
       mismatchCount: mismatches.length,
       mismatches: JSON.stringify(redactMismatches(mismatches))
     });
   } 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;
+    const strictCount = source !== void 0 ? countHfIdInSource(source, hfId) : void 0;
     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.
+      ...strictCount !== void 0 ? { sourceHfIdCount: strictCount } : {},
+      // Loose suppression check matched (kept this event) but the strict
+      // attribute count came back 0 — hfId appeared as plain text (class name,
+      // comment, script string) but never as a data-hf-id="..." attribute.
+      // Lets telemetry consumers filter this cohort without parsing the
+      // sourceHfIdCount comment above.
+      ...strictCount === 0 ? { sourceLooseMatchOnly: true } : {},
       mismatchCount: 1,
       mismatches: JSON.stringify([
         { kind: "element_not_found", hfId }
@@ -22559,7 +22610,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 +22670,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 +22727,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,13 +22752,21 @@ 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,
       op.kind === "set" ? "setGsapTween" : "removeGsapTween"
     );
+  }
   if (!STUDIO_SDK_CUTOVER_ENABLED) return Promise.resolve(false);
   if (op.kind === "add" && sdkSession && !sdkSession.getElement(op.target))
     return Promise.resolve(false);
@@ -22840,7 +22907,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 +29841,7 @@ function useDomEditSession({
   showToast,
   refreshPreviewDocumentVersion,
   queueDomEditSave,
-  readProjectFile: _readProjectFile,
+  readProjectFile,
   writeProjectFile,
   updateEditingFileContent,
   domEditSaveTimestampRef,
@@ -29793,7 +29865,6 @@ function useDomEditSession({
   forceReloadSdkSession
 }) {
   void _setRefreshKey;
-  void _readProjectFile;
   const {
     domEditSelection,
     domEditGroupSelections,
@@ -29952,7 +30023,10 @@ 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");
+      let reorderSrcPromise;
+      const reorderSrc = activeCompPath ? () => reorderSrcPromise ??= readProjectFile(activeCompPath) : void 0;
+      for (const target of targets)
+        void recordResolverParity(sdkSession, target, "reorderElements", reorderSrc);
     } : void 0
   });
   const { groupSelection, ungroupSelection } = useGroupCommits({
@@ -42664,9 +42738,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();