hyperframes 0.8.160 → 0.8.162

package/dist/{chunk-PINFPWRV.js → chunk-GIPNECWL.js}

@@ -138,7 +138,7 @@ function replacementTimelineAssetId(document, element, newSrc) {
   return buildTimelineAssetId(decodedUrlPath(newSrc), ids);
 }
 
-// ../studio-server/dist/chunk-JBFOY5SI.js
+// ../studio-server/dist/chunk-WUNFUTHB.js
 var import_postcss_selector_parser = __toESM(require_dist(), 1);
 import postcss from "postcss";
 function parseStyleDecls(style) {
@@ -189,16 +189,16 @@ function patchStyleAttrString(style, property, value) {
   }
   return serializeStyleDecls(props, order);
 }
+var pinnedInSource = /* @__PURE__ */ new WeakMap();
 function parseSourceDocument(raw) {
   const source = ensureHfIds(raw);
   const hasDocumentShell = /<!doctype|<html[\s>]/i.test(source);
-  if (hasDocumentShell) {
-    return { document: parseHTML(source).document, wrappedFragment: false };
-  }
-  return {
-    document: parseHTML(`<!DOCTYPE html><html><head></head><body>${source}</body></html>`).document,
-    wrappedFragment: true
-  };
+  const document = hasDocumentShell ? parseHTML(source).document : parseHTML(`<!DOCTYPE html><html><head></head><body>${source}</body></html>`).document;
+  pinnedInSource.set(
+    document,
+    new Set(Array.from(raw.matchAll(/\bdata-hf-id\s*=\s*["']?([^"'\s>]+)/gi), (m) => m[1]))
+  );
+  return { document, wrappedFragment: !hasDocumentShell };
 }
 function duplicateCssRulesForId(document, originalId, newId) {
   const idToken = `#${originalId}`;
@@ -263,14 +263,16 @@ function findTargetElement(document, target) {
     const el = findByHfId(document, target.hfId);
     if (el) return el;
   }
+  const pinned = pinnedInSource.get(document);
+  const unlessPinnedElsewhere = (el) => el && !(target.hfId && pinned?.has(el.getAttribute("data-hf-id") ?? "")) ? el : null;
   if (target.id) {
-    const byId = document.getElementById(target.id);
+    const byId = unlessPinnedElsewhere(document.getElementById(target.id));
     if (byId) return byId;
   }
   if (!target.selector) return null;
   try {
     const matches = querySelectorAllWithTemplates(document, target.selector);
-    return matches[target.selectorIndex ?? 0] ?? null;
+    return unlessPinnedElsewhere(matches[target.selectorIndex ?? 0]);
   } catch {
     return null;
   }

package/dist/{chunk-KWRBEDJI.js → chunk-GNFWKGSQ.js}

@@ -7,10 +7,10 @@ var __dirname = __hf_dirname(__filename);
 import {
   trackLintReport,
   trackLintRuleStreak
-} from "./chunk-KRE55WLI.js";
+} from "./chunk-YLBV2PXM.js";
 import {
   shouldTrack
-} from "./chunk-ICZVCVD3.js";
+} from "./chunk-ZEWX3GHP.js";
 import {
   LINT_RULE_COUNT,
   LINT_RULE_GROUP_COUNTS

package/dist/{chunk-4VYNMVMC.js → chunk-GS5EXZBV.js}

@@ -10,7 +10,7 @@ import {
   seekCompositionTimeline,
   waitForCompositionFonts,
   waitForRuntimeReady
-} from "./chunk-6MCASYIS.js";
+} from "./chunk-ON2HYNGB.js";
 import {
   launchManagedBrowser,
   resolveManagedGpuMode
@@ -20,10 +20,10 @@ import {
 } from "./chunk-ERTJPFCH.js";
 import {
   resolveProject
-} from "./chunk-37LNY2EC.js";
+} from "./chunk-YJKUE3LV.js";
 import {
   serveStaticProjectHtml
-} from "./chunk-GOTCGKX6.js";
+} from "./chunk-RGYEL7QD.js";
 import {
   defineCommand
 } from "./chunk-S3S4TGEH.js";
@@ -37,7 +37,7 @@ import {
 import {
   printDeprecationNotice,
   withMeta
-} from "./chunk-FRGYHRP6.js";
+} from "./chunk-T5BG7PYZ.js";
 import {
   normalizeErrorMessage
 } from "./chunk-KNU5COPB.js";

package/dist/chunk-J4L5TPLS.js

@@ -0,0 +1,101 @@
+import { createRequire as __hf_createRequire } from "node:module";
+import { fileURLToPath as __hf_fileURLToPath } from "node:url";
+import { dirname as __hf_dirname } from "node:path";
+var require = __hf_createRequire(import.meta.url);
+var __filename = __hf_fileURLToPath(import.meta.url);
+var __dirname = __hf_dirname(__filename);
+import {
+  HyperframesApiError
+} from "./chunk-5UBZPG74.js";
+
+// src/cloud/upload.ts
+import { createHash } from "crypto";
+var COMPLETE_MAX_RETRIES = 5;
+var COMPLETE_RETRY_BASE_MS = 500;
+var CONTENT_TYPE_ZIP = "application/zip";
+function sha256Hex(bytes) {
+  return createHash("sha256").update(bytes).digest("hex");
+}
+function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+function normalizeUploadHeaders(raw) {
+  const out = {};
+  for (const [k, v] of Object.entries(raw ?? {})) {
+    if (typeof v === "string") out[k] = v;
+    else if (typeof v === "number" || typeof v === "boolean") out[k] = String(v);
+  }
+  return out;
+}
+async function putBytesToPresignedUrl(fetchImpl, uploadUrl, uploadHeaders, bytes, contentType) {
+  const headers = {
+    "content-type": contentType,
+    ...normalizeUploadHeaders(uploadHeaders)
+  };
+  const res = await fetchImpl(uploadUrl, {
+    method: "PUT",
+    headers,
+    body: bytes
+  });
+  if (!res.ok) {
+    const detail = await res.text().catch(() => "");
+    throw new Error(
+      `Direct upload PUT failed: ${res.status} ${res.statusText}${detail ? ` \u2014 ${detail.slice(0, 300)}` : ""}`
+    );
+  }
+}
+async function completeWithRetry(client, asset_id, checksum_sha256) {
+  let lastErr;
+  for (let attempt = 0; attempt < COMPLETE_MAX_RETRIES; attempt++) {
+    try {
+      return await client.completeAssetUpload({
+        asset_id,
+        body: { checksum_sha256 }
+      });
+    } catch (err) {
+      const retryable = err instanceof HyperframesApiError && err.status === 409;
+      if (!retryable || attempt === COMPLETE_MAX_RETRIES - 1) {
+        throw err;
+      }
+      lastErr = err;
+      await sleep(COMPLETE_RETRY_BASE_MS * (attempt + 1));
+    }
+  }
+  throw lastErr ?? new Error("completeAssetUpload retries exhausted");
+}
+async function uploadAssetViaDirectUpload(opts) {
+  const start = Date.now();
+  const { bytes, filename, idempotencyKey } = opts;
+  const size_bytes = bytes.byteLength;
+  const checksum_sha256 = sha256Hex(bytes);
+  const fetchImpl = opts.fetchImpl ?? fetch;
+  opts.onProgress?.({ phase: "initialize" });
+  const initialize = await opts.client.createAssetUpload({
+    body: { filename, content_type: opts.contentType, size_bytes, checksum_sha256 },
+    idempotencyKey
+  });
+  opts.onProgress?.({ phase: "upload", percent: 0 });
+  await putBytesToPresignedUrl(
+    fetchImpl,
+    initialize.upload_url,
+    initialize.upload_headers,
+    bytes,
+    opts.contentType
+  );
+  opts.onProgress?.({ phase: "upload", percent: 100 });
+  opts.onProgress?.({ phase: "complete" });
+  const completed = await completeWithRetry(opts.client, initialize.asset_id, checksum_sha256);
+  return {
+    asset_id: completed.asset_id,
+    size_bytes,
+    duration_ms: Date.now() - start
+  };
+}
+function uploadZipViaDirectUpload(opts) {
+  return uploadAssetViaDirectUpload({ ...opts, contentType: CONTENT_TYPE_ZIP });
+}
+
+export {
+  uploadAssetViaDirectUpload,
+  uploadZipViaDirectUpload
+};

package/dist/{chunk-V2FQQILJ.js → chunk-JJYFRAI4.js}

@@ -6,7 +6,7 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   resolveProject
-} from "./chunk-37LNY2EC.js";
+} from "./chunk-YJKUE3LV.js";
 import {
   findPreviewServerForProject,
   studioApiUrl

package/dist/{chunk-IGTGLGML.js → chunk-KAKBRDU4.js}

@@ -20,7 +20,7 @@ import {
   typeDirPath,
   updateRecord,
   withFigmaErrors
-} from "./chunk-VZ6LCTOZ.js";
+} from "./chunk-3LQEZ4EI.js";
 import {
   defineCommand
 } from "./chunk-S3S4TGEH.js";
@@ -229,7 +229,7 @@ var asset_default = defineCommand({
           rendered > 0 ? `(${results.length} nodes, ${rendered} rendered in 1 figma request)` : `(${results.length} nodes, all reused from cache \u2014 no figma request)`
         );
       }
-      const { trackFigmaImport } = await import("./telemetry-7AWYECPL.js");
+      const { trackFigmaImport } = await import("./telemetry-WVHWY3DU.js");
       trackFigmaImport({
         phase: "asset",
         reused: results.every((r) => r.reused),

package/dist/{chunk-TTFDAWCS.js → chunk-KIJO75L4.js}

@@ -6,7 +6,7 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   updateNoticesSuppressed
-} from "./chunk-FRGYHRP6.js";
+} from "./chunk-T5BG7PYZ.js";
 import {
   hostAnswers
 } from "./chunk-K4WIOZFP.js";

package/dist/{chunk-3XPVZLAR.js → chunk-NQR5SBXX.js}

@@ -6,7 +6,7 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   VERSION
-} from "./chunk-TU2CQJO3.js";
+} from "./chunk-3NSVHCOH.js";
 
 // src/registry/compatibility.ts
 import { compareVersions } from "compare-versions";

package/dist/{chunk-6MCASYIS.js → chunk-ON2HYNGB.js}

@@ -4,14 +4,14 @@ import { dirname as __hf_dirname } from "node:path";
 var require = __hf_createRequire(import.meta.url);
 var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
-import {
-  resolveCompositionViewportFromHtml
-} from "./chunk-FH7WODJH.js";
 import {
   launchManagedBrowser,
   resolveManagedGpuMode,
   rethrowAfterBrowserCleanup
 } from "./chunk-B5FZ2CQM.js";
+import {
+  resolveCompositionViewportFromHtml
+} from "./chunk-FH7WODJH.js";
 import {
   resolveDiagnosticNavigationTimeoutMs,
   windowsChromeCrashRemediation
@@ -110,7 +110,7 @@ async function openSettledCompositionPage(html, url, options) {
   const puppeteer = await import("puppeteer-core");
   const { buildChromeArgs } = await import("./src-GPUDUKY6.js");
   const requestedGpuMode = options.browserGpuMode ?? resolveCliChromeGpuMode();
-  const answer = (await import("./staticProjectServer-S3NK3V4S.js")).inProcessAnswer(url);
+  const answer = (await import("./staticProjectServer-4CQ3KDQK.js")).inProcessAnswer(url);
   const requiresWebGpu = compositionRequiresWebGpu(html);
   let softwareWebGpu = false;
   const launch = async (executablePath) => {

package/dist/{chunk-GOTCGKX6.js → chunk-RGYEL7QD.js}

@@ -7,7 +7,7 @@ var __dirname = __hf_dirname(__filename);
 import {
   getMimeType,
   injectMediaCodecMapIntoHtml
-} from "./chunk-VD7WQYTO.js";
+} from "./chunk-5YSHR4XC.js";
 import {
   PROXY_VARIANT_CONFIG,
   ProxyCapacityError,

package/dist/{chunk-7OFNPEKR.js → chunk-S6OLD4SL.js}

@@ -7,7 +7,7 @@ var __dirname = __hf_dirname(__filename);
 import {
   RegistryCompatibilityError,
   gateRegistryItemsCompatibility
-} from "./chunk-3XPVZLAR.js";
+} from "./chunk-NQR5SBXX.js";
 import {
   DEFAULT_PROJECT_CONFIG,
   createProjectConfig,
@@ -29,7 +29,7 @@ import {
 } from "./chunk-EVRUR7DW.js";
 import {
   trackRegistryItemAdded
-} from "./chunk-KRE55WLI.js";
+} from "./chunk-YLBV2PXM.js";
 import {
   defineCommand
 } from "./chunk-S3S4TGEH.js";

package/dist/{chunk-FRGYHRP6.js → chunk-T5BG7PYZ.js}

@@ -17,7 +17,7 @@ import {
 } from "./chunk-ISN5GRYI.js";
 import {
   VERSION
-} from "./chunk-TU2CQJO3.js";
+} from "./chunk-3NSVHCOH.js";
 
 // src/utils/updateCheck.ts
 import { existsSync, readFileSync } from "fs";

package/dist/{chunk-MYGXKD7A.js → chunk-T65MIV36.js}

@@ -32,14 +32,14 @@ import {
 import {
   getUpdateMeta,
   withMeta
-} from "./chunk-FRGYHRP6.js";
+} from "./chunk-T5BG7PYZ.js";
 import {
   CONFIG_PATH,
   withFileLock
 } from "./chunk-XUXGIA7H.js";
 import {
   VERSION
-} from "./chunk-TU2CQJO3.js";
+} from "./chunk-3NSVHCOH.js";
 import {
   OPTIONAL_PACKAGES,
   installedOptionalPackageVersion

package/dist/chunk-TDPVEMBS.js

@@ -0,0 +1,156 @@
+import { createRequire as __hf_createRequire } from "node:module";
+import { fileURLToPath as __hf_fileURLToPath } from "node:url";
+import { dirname as __hf_dirname } from "node:path";
+var require = __hf_createRequire(import.meta.url);
+var __filename = __hf_fileURLToPath(import.meta.url);
+var __dirname = __hf_dirname(__filename);
+import {
+  HyperframesApiError,
+  HyperframesCloudClient
+} from "./chunk-5UBZPG74.js";
+import {
+  forceRefreshCredentials,
+  resolveCloudAuthHeaders,
+  resolveCloudBaseUrl
+} from "./chunk-KMAAOHLO.js";
+import {
+  errorBox
+} from "./chunk-K2FLNJVB.js";
+import {
+  failCommand
+} from "./chunk-PBN6GBJE.js";
+
+// src/cloud/poll.ts
+var DEFAULT_POLL_INTERVAL_MS = 1e4;
+var DEFAULT_MAX_WAIT_MS = 60 * 60 * 1e3;
+var TERMINAL_STATUSES = /* @__PURE__ */ new Set(["completed", "failed"]);
+var PollTimeoutError = class extends Error {
+  lastDetail;
+  constructor(lastDetail, elapsedMs) {
+    super(
+      `Render ${lastDetail.render_id} did not reach a terminal state within ${Math.round(elapsedMs / 1e3)}s`
+    );
+    this.name = "PollTimeoutError";
+    this.lastDetail = lastDetail;
+  }
+};
+function isTerminal(status) {
+  return TERMINAL_STATUSES.has(status);
+}
+async function pollUntilTerminal(client, renderId, options = {}) {
+  const intervalMs = options.intervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+  const maxWaitMs = options.maxWaitMs ?? DEFAULT_MAX_WAIT_MS;
+  const now = options.now ?? (() => Date.now());
+  const sleep = options.sleep ?? defaultAbortableSleep(options.signal);
+  const started = now();
+  while (true) {
+    if (options.signal?.aborted) {
+      throw signalAbortError(options.signal);
+    }
+    const detail = await client.getRender({ render_id: renderId, signal: options.signal });
+    const elapsed = now() - started;
+    options.onTick?.(detail, elapsed);
+    if (isTerminal(detail.status)) {
+      return detail;
+    }
+    if (elapsed >= maxWaitMs) {
+      throw new PollTimeoutError(detail, elapsed);
+    }
+    await sleep(intervalMs);
+  }
+}
+function signalAbortError(signal) {
+  const reason = signal.reason;
+  return reason instanceof Error ? reason : new Error("Poll aborted");
+}
+function defaultAbortableSleep(signal) {
+  return (ms) => new Promise((resolve, reject) => {
+    const onAbort = () => {
+      clearTimeout(timer);
+      reject(signalAbortError(signal));
+    };
+    const timer = setTimeout(() => {
+      signal?.removeEventListener("abort", onAbort);
+      resolve();
+    }, ms);
+    signal?.addEventListener("abort", onAbort, { once: true });
+  });
+}
+
+// src/cloud/index.ts
+async function createCloudClient() {
+  const client = new HyperframesCloudClient({
+    baseUrl: resolveCloudBaseUrl(),
+    getAuthHeaders: resolveCloudAuthHeaders
+  });
+  return wrapWith401Retry(client);
+}
+function wrapWith401Retry(client) {
+  return new Proxy(client, {
+    get(target, prop, receiver) {
+      const value = Reflect.get(target, prop, receiver);
+      if (typeof value !== "function") return value;
+      const original = value.bind(target);
+      return async (...args) => {
+        try {
+          return await original(...args);
+        } catch (err) {
+          if (err instanceof HyperframesApiError && err.status === 401) {
+            try {
+              await forceRefreshCredentials();
+            } catch {
+              throw err;
+            }
+            return await original(...args);
+          }
+          throw err;
+        }
+      };
+    }
+  });
+}
+
+// src/cloud/errors.ts
+var ERROR_CODE_HINTS = {
+  hyperframes_project_too_large: "The zip exceeded the 200 MB limit. Run `hyperframes cloud render --dry-run`, then add only verified-unneeded paths to `.hyperframesignore` or pre-host required large media.",
+  hyperframes_render_not_found: "The render_id no longer exists \u2014 either soft-deleted or never created.",
+  invalid_parameter: "Check the listed parameter against `hyperframes cloud render --help` for the accepted values.",
+  authentication_failed: "Run `hyperframes auth status` to confirm your credential; `hyperframes auth login` to re-auth.",
+  rate_limit_exceeded: "Retry after the duration in the Retry-After header."
+};
+function reportApiError(stage, err, options = {}) {
+  const hints = { ...ERROR_CODE_HINTS, ...options.extraHints };
+  if (err instanceof HyperframesApiError) {
+    if (err.status === 404 && options.notFound) {
+      errorBox("Not found", options.notFound);
+      failCommand();
+    }
+    const hint = err.code ? hints[err.code] : void 0;
+    const title = `${stage} (HTTP ${err.status})`;
+    if (hint) {
+      errorBox(title, err.message, hint);
+    } else if (options.suggestion) {
+      errorBox(title, err.message, options.suggestion);
+    } else if (err.code) {
+      errorBox(title, err.message, `code: ${err.code}`);
+    } else {
+      errorBox(title, err.message);
+    }
+    failCommand();
+  }
+  if (err instanceof Error) {
+    errorBox(stage, err.message, options.suggestion);
+    failCommand();
+  }
+  errorBox(stage, String(err), options.suggestion);
+  failCommand();
+}
+
+export {
+  DEFAULT_POLL_INTERVAL_MS,
+  DEFAULT_MAX_WAIT_MS,
+  PollTimeoutError,
+  pollUntilTerminal,
+  createCloudClient,
+  reportApiError
+};

package/dist/{chunk-SHVDJON6.js → chunk-XWWYGXJ5.js}

@@ -6,7 +6,7 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   getMimeType
-} from "./chunk-VD7WQYTO.js";
+} from "./chunk-5YSHR4XC.js";
 import {
   injectTagsAtHeadStart
 } from "./chunk-P47XYVEQ.js";

package/dist/{chunk-37LNY2EC.js → chunk-YJKUE3LV.js}

@@ -9,7 +9,7 @@ import {
 } from "./chunk-K2FLNJVB.js";
 import {
   trackCommandFailure
-} from "./chunk-KRE55WLI.js";
+} from "./chunk-YLBV2PXM.js";
 import {
   failCommand
 } from "./chunk-PBN6GBJE.js";

package/dist/{chunk-KRE55WLI.js → chunk-YLBV2PXM.js}

@@ -8,7 +8,7 @@ import {
   flush,
   shouldTrack,
   trackEvent
-} from "./chunk-ICZVCVD3.js";
+} from "./chunk-ZEWX3GHP.js";
 import {
   getPowerState
 } from "./chunk-QWQ6GQTI.js";

package/dist/{chunk-ICZVCVD3.js → chunk-ZEWX3GHP.js}

@@ -29,7 +29,7 @@ import {
 } from "./chunk-XUXGIA7H.js";
 import {
   VERSION
-} from "./chunk-TU2CQJO3.js";
+} from "./chunk-3NSVHCOH.js";
 import {
   CANARIES,
   canaryEnvVar,

package/dist/{clean-RRE6PMKZ.js → clean-WB62QULT.js}

@@ -6,7 +6,7 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   redactHome
-} from "./chunk-MYGXKD7A.js";
+} from "./chunk-T65MIV36.js";
 import "./chunk-Z27A7NUB.js";
 import "./chunk-5ETJX6WM.js";
 import {
@@ -16,10 +16,10 @@ import {
   formatBytes
 } from "./chunk-K2FLNJVB.js";
 import "./chunk-A2DMF2Q6.js";
-import "./chunk-VD7WQYTO.js";
-import "./chunk-PINFPWRV.js";
-import "./chunk-C6TPGUWD.js";
+import "./chunk-5YSHR4XC.js";
+import "./chunk-GIPNECWL.js";
 import "./chunk-6JR2XUEE.js";
+import "./chunk-C6TPGUWD.js";
 import {
   CACHE_DIR_NAME,
   cleanupProxyCache
@@ -47,12 +47,12 @@ import "./chunk-TJSTGSAW.js";
 import "./chunk-XRKMITSS.js";
 import {
   withMeta
-} from "./chunk-FRGYHRP6.js";
+} from "./chunk-T5BG7PYZ.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-TU2CQJO3.js";
+import "./chunk-3NSVHCOH.js";
 import "./chunk-3DKN5WKL.js";
 import "./chunk-EOVYQ3IG.js";
 import "./chunk-6BEFEWFB.js";