hyperframes 0.8.75 → 0.8.77

package/dist/renderSetupWorker.js

@@ -13009,6 +13009,13 @@ function parseGsapScriptAcornForWrite(script) {
   }
 }
 function parseGsapScriptAcorn(script) {
+  const parsed = parseMemo.get(script) ?? parseGsapScriptAcornUncached(script);
+  parseMemo.delete(script);
+  parseMemo.set(script, parsed);
+  if (parseMemo.size > PARSE_MEMO_ENTRIES) parseMemo.delete(parseMemo.keys().next().value);
+  return structuredClone(parsed);
+}
+function parseGsapScriptAcornUncached(script) {
   try {
     const ast = parseProgram2(script);
     const scope = collectScopeBindings(ast);
@@ -13156,7 +13163,7 @@ function extractGsapLabels(script) {
     return [];
   }
 }
-var PROPERTY_GROUPS, PROP_TO_GROUP, SKIP_KEYS, FUNCTION_TYPES, GSAP_METHODS, MAX_DEPTH, MAX_ITERS, SAFE_DEFAULT_NODES, SUPPORTED_PARAMS_CACHE, roundPercentage, GSAP_METHODS2, QUERY_METHODS, ITERATION_METHODS, SCOPE_NODE_TYPES, CONST_NODES, MATH_FNS, MATH_CONSTS, BUILTIN_VAR_KEYS, DROPPED_VAR_KEYS, EXTRAS_KEYS, PERCENTAGE_KEY_RE, GSAP_DEFAULT_DURATION;
+var PROPERTY_GROUPS, PROP_TO_GROUP, SKIP_KEYS, FUNCTION_TYPES, GSAP_METHODS, MAX_DEPTH, MAX_ITERS, SAFE_DEFAULT_NODES, SUPPORTED_PARAMS_CACHE, roundPercentage, GSAP_METHODS2, QUERY_METHODS, ITERATION_METHODS, SCOPE_NODE_TYPES, CONST_NODES, MATH_FNS, MATH_CONSTS, BUILTIN_VAR_KEYS, DROPPED_VAR_KEYS, EXTRAS_KEYS, PERCENTAGE_KEY_RE, GSAP_DEFAULT_DURATION, PARSE_MEMO_ENTRIES, parseMemo;
 var init_gsapParserAcorn = __esm({
   "../parsers/dist/gsapParserAcorn.js"() {
     "use strict";
@@ -13236,9 +13243,14 @@ var init_gsapParserAcorn = __esm({
     ]);
     PERCENTAGE_KEY_RE = /^(\d+(?:\.\d+)?)%$/;
     GSAP_DEFAULT_DURATION = 0.5;
+    PARSE_MEMO_ENTRIES = 4;
+    parseMemo = /* @__PURE__ */ new Map();
   }
 });
 
+// src/renderSetupWorker.ts
+import { constants as constants2, setPriority } from "os";
+
 // src/browser/manager.ts
 import { execSync, spawnSync } from "child_process";
 import { randomUUID } from "crypto";
@@ -27624,6 +27636,81 @@ function collectDeclaredVariableIds(htmlTagRaw) {
   }
   return declared;
 }
+function variablesDeclarationFindings(tag, tags) {
+  const raw = readJsonAttr(tag.raw, "data-composition-variables");
+  if (!raw) return [];
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (err) {
+    const reason = err instanceof Error ? err.message : "unknown";
+    return [
+      {
+        code: "invalid_composition_variables_declaration",
+        severity: "error",
+        message: `data-composition-variables is not valid JSON (${reason}).`,
+        fixHint: `Provide a JSON array of variable declarations: data-composition-variables='[{"id":"title","type":"string","label":"Title","default":"Hello"}]'.`,
+        snippet: truncateSnippet(tag.raw)
+      }
+    ];
+  }
+  if (!Array.isArray(parsed)) {
+    return [
+      {
+        code: "invalid_composition_variables_declaration",
+        severity: "error",
+        message: "data-composition-variables must be a JSON array of variable declarations.",
+        fixHint: `Wrap declarations in [] and give each an id, type, label, and default: '[{"id":"title","type":"string","label":"Title","default":"Hello"}]'.`,
+        snippet: truncateSnippet(tag.raw)
+      }
+    ];
+  }
+  const findings = [];
+  const knownTypes = new Set(COMPOSITION_VARIABLE_TYPES);
+  const varSrcIds = /* @__PURE__ */ new Set();
+  for (const other of tags) {
+    const bound = readAttr(other.raw, "data-var-src");
+    if (bound) varSrcIds.add(bound);
+  }
+  for (let i = 0; i < parsed.length; i += 1) {
+    const entry = parsed[i];
+    if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
+      findings.push({
+        code: "invalid_composition_variables_declaration",
+        severity: "error",
+        message: `data-composition-variables entry [${i}] must be an object with id, type, label, and default.`,
+        snippet: truncateSnippet(tag.raw)
+      });
+      continue;
+    }
+    const e = entry;
+    const missing = [];
+    if (typeof e.id !== "string") missing.push("id");
+    if (typeof e.type !== "string" || !knownTypes.has(e.type)) missing.push("type");
+    if (typeof e.label !== "string") missing.push("label");
+    if (!("default" in e)) missing.push("default");
+    if (missing.length > 0) {
+      findings.push({
+        code: "invalid_composition_variables_declaration",
+        severity: "error",
+        message: `data-composition-variables entry [${i}] is missing or has invalid: ${missing.join(", ")}. Type must be one of string, number, color, boolean, enum, font, image.`,
+        snippet: truncateSnippet(tag.raw)
+      });
+      continue;
+    }
+    const id = String(e.id);
+    if ((e.type === "image" || varSrcIds.has(id)) && typeof e.default === "string" && e.default.length > 0 && !isSafeMediaUrl(e.default)) {
+      findings.push({
+        code: "unloadable_media_variable_default",
+        severity: "error",
+        message: `Variable "${id}" defaults to a URL the runtime will refuse to load, so any element bound to it renders its authored fallback src instead and the render still exits 0.`,
+        fixHint: `Media URLs must be relative, http(s), blob:, or a data:image/* URI. Copy the file into the project and reference it relatively (e.g. "assets/bg.png") rather than by absolute path.`,
+        snippet: truncateSnippet(tag.raw)
+      });
+    }
+  }
+  return findings;
+}
 function collectAllDeclaredVariableIds(tags) {
   const all = /* @__PURE__ */ new Set();
   for (const tag of tags) {
@@ -28099,84 +28186,8 @@ var compositionRules = [
   // on any structural problem. Surface JSON / shape failures so authors
   // catch them at lint time rather than wondering why their `getVariables()`
   // defaults aren't applied.
-  // fallow-ignore-next-line complexity
-  ({ tags }) => {
-    const htmlTag = findHtmlTag(tags);
-    if (!htmlTag) return [];
-    const raw = readJsonAttr(htmlTag.raw, "data-composition-variables");
-    if (!raw) return [];
-    let parsed;
-    try {
-      parsed = JSON.parse(raw);
-    } catch (err) {
-      const reason = err instanceof Error ? err.message : "unknown";
-      return [
-        {
-          code: "invalid_composition_variables_declaration",
-          severity: "error",
-          message: `data-composition-variables is not valid JSON (${reason}).`,
-          fixHint: `Provide a JSON array of variable declarations: data-composition-variables='[{"id":"title","type":"string","label":"Title","default":"Hello"}]'.`,
-          snippet: truncateSnippet(htmlTag.raw)
-        }
-      ];
-    }
-    if (!Array.isArray(parsed)) {
-      return [
-        {
-          code: "invalid_composition_variables_declaration",
-          severity: "error",
-          message: "data-composition-variables must be a JSON array of variable declarations.",
-          fixHint: `Wrap declarations in [] and give each an id, type, label, and default: '[{"id":"title","type":"string","label":"Title","default":"Hello"}]'.`,
-          snippet: truncateSnippet(htmlTag.raw)
-        }
-      ];
-    }
-    const findings = [];
-    const knownTypes = new Set(COMPOSITION_VARIABLE_TYPES);
-    const varSrcIds = /* @__PURE__ */ new Set();
-    for (const tag of tags) {
-      const bound = readAttr(tag.raw, "data-var-src");
-      if (bound) varSrcIds.add(bound);
-    }
-    for (let i = 0; i < parsed.length; i += 1) {
-      const entry = parsed[i];
-      if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
-        findings.push({
-          code: "invalid_composition_variables_declaration",
-          severity: "error",
-          message: `data-composition-variables entry [${i}] must be an object with id, type, label, and default.`,
-          snippet: truncateSnippet(htmlTag.raw)
-        });
-        continue;
-      }
-      const e = entry;
-      const missing = [];
-      if (typeof e.id !== "string") missing.push("id");
-      if (typeof e.type !== "string" || !knownTypes.has(e.type)) missing.push("type");
-      if (typeof e.label !== "string") missing.push("label");
-      if (!("default" in e)) missing.push("default");
-      if (missing.length > 0) {
-        findings.push({
-          code: "invalid_composition_variables_declaration",
-          severity: "error",
-          message: `data-composition-variables entry [${i}] is missing or has invalid: ${missing.join(", ")}. Type must be one of string, number, color, boolean, enum, font, image.`,
-          snippet: truncateSnippet(htmlTag.raw)
-        });
-        continue;
-      }
-      const id = String(e.id);
-      if ((e.type === "image" || varSrcIds.has(id)) && typeof e.default === "string" && e.default.length > 0 && !isSafeMediaUrl(e.default)) {
-        findings.push({
-          code: "unloadable_media_variable_default",
-          severity: "error",
-          message: `Variable "${id}" defaults to a URL the runtime will refuse to load, so any element bound to it renders its authored fallback src instead and the render still exits 0.`,
-          fixHint: `Media URLs must be relative, http(s), blob:, or a data:image/* URI. Copy the file into the project and reference it relatively (e.g. "assets/bg.png") rather than by absolute path.`,
-          snippet: truncateSnippet(htmlTag.raw)
-        });
-      }
-    }
-    return findings;
-  },
+  // Checked on every element that declares: <html>, or the composition root.
+  ({ tags }) => tags.filter((tag) => readJsonAttr(tag.raw, "data-composition-variables")).flatMap((tag) => variablesDeclarationFindings(tag, tags)),
   // html_dir_attribute_breaks_render — valid non-LTR dir values on
   // <html> renders correctly in preview/snapshot but produces a fully
   // blank/black video from render, with no other lint/validate/inspect
@@ -31837,63 +31848,41 @@ function isSnippetFragment(html) {
 }
 
 // src/utils/orphanCleanup.ts
-import { execFileSync as execFileSync3, execSync as execSync2 } from "child_process";
+import { execFileSync as execFileSync3 } from "child_process";
 import { readFileSync as readFileSync4 } from "fs";
 function killOrphanedProcesses() {
   if (process.platform === "win32") return 0;
-  let killed = 0;
-  for (const name of ["chrome-headless-shell", "chrome_headless_shell"]) {
-    killed += killOrphansByName(name);
-  }
-  killed += killOrphansByName("puppeteer_dev_chrome_profile");
-  return killed;
+  return killOrphansMatching([
+    "chrome-headless-shell",
+    "chrome_headless_shell",
+    "puppeteer_dev_chrome_profile"
+  ]);
 }
 function killProcessTree(pid, signal = "SIGTERM") {
   void terminateProcessTree(pid, { signal }).catch(() => void 0);
 }
-function killOrphansByName(processName) {
-  const uid = getUid();
-  const userFlag = uid !== null ? `-u ${uid} ` : "";
-  let pids;
+function killOrphansMatching(markers) {
+  const uid = process.getuid?.();
+  const owner = uid === void 0 ? ["-A"] : ["-U", String(uid)];
+  let table;
   try {
-    const raw = execSync2(`pgrep ${userFlag}-f ${processName}`, {
+    table = execFileSync3("ps", [...owner, "-ww", "-o", "pid=,ppid=,args="], {
       encoding: "utf-8",
       timeout: 3e3
-    }).trim();
-    if (!raw) return 0;
-    pids = raw.split("\n").map((s) => parseInt(s, 10)).filter((n) => !isNaN(n) && n > 0);
+    });
   } catch {
     return 0;
   }
   let killed = 0;
-  for (const pid of pids) {
-    if (!isOrphan(pid)) continue;
-    killProcessTree(pid);
+  for (const line of table.split("\n")) {
+    const match = line.match(/^\s*(\d+)\s+(\d+)\s+(.*)$/);
+    if (!match || match[2] !== "1") continue;
+    if (!markers.some((marker) => match[3].includes(marker))) continue;
+    killProcessTree(Number(match[1]));
     killed++;
   }
   return killed;
 }
-var _cachedUid;
-function getUid() {
-  if (_cachedUid !== void 0) return _cachedUid;
-  try {
-    _cachedUid = execSync2("id -u", { encoding: "utf-8", timeout: 1e3 }).trim();
-  } catch {
-    _cachedUid = null;
-  }
-  return _cachedUid;
-}
-function isOrphan(pid) {
-  try {
-    const ppid = execSync2(`ps -p ${pid} -o ppid=`, {
-      encoding: "utf-8",
-      timeout: 2e3
-    }).trim();
-    return ppid === "1";
-  } catch {
-    return false;
-  }
-}
 
 // src/renderSetupWorkerLifecycle.ts
 var RENDER_SETUP_SIGNALS = ["SIGINT", "SIGTERM", "SIGHUP"];
@@ -31928,7 +31917,12 @@ var result;
 if (mode === "browser") {
   result = await ensureBrowser(input);
 } else if (mode === "lint") {
-  result = await lintProject(input.projectDir, input.entryFile);
+  setPriority(constants2.priority.PRIORITY_LOW);
+  result = await lintProject(
+    input.projectDir,
+    input.entryFile,
+    input.host ? { host: input.host } : void 0
+  );
 } else if (mode === "orphan-cleanup") {
   const killed = killOrphanedProcesses();
   result = killed;

package/dist/skills/hyperframes-cli/SKILL.md

@@ -69,12 +69,12 @@ Treat tiny unstyled content, canvas-sized icons, missing hero elements, or timel
 
 ## Agent conventions
 
-- **Search the catalog before writing motion by hand.** `npx hyperframes catalog --query "<the beat, in plain English>"`. Search is entirely local: there is no hosted tier, no account, and the query text is never sent anywhere. By default it ranks on vocabulary shared with the item's name, title and description, which misses any phrasing that does not reuse the catalog's own wording. Add `--on-device` to rank by meaning instead (see the offline tier below).
+- **Search the catalog before writing motion by hand.** `npx hyperframes catalog --query "<the beat, in plain English>"`. Search is entirely local: there is no hosted tier, no account, and the query text is never sent anywhere. By default it ranks on vocabulary shared with the item's name, title, description and tags, which misses any phrasing that does not reuse the catalog's own wording. Add `--on-device` to rank by meaning instead (see the offline tier below).
 - **Query in English even when the video is not.** Both tiers index an English catalog, so a query in another script produces no searchable terms and returns nothing. Describe the move in English; the on-screen copy stays in whatever language the video needs. `No searchable words in query` means exactly this and is not a missing component, so do not report it as a catalog gap.
 - **Read which tier answered; never infer it from results appearing.** With `--json` the envelope carries `query`, `tier` (`on-device` or `words`), `tier_detail`, `dropped`, `unindexed`, `shown`, `total` and `results`, plus `top_score` when the answering tier produces one and `warnings` when a tier was asked for and could not run, or when a search returned nothing and a better tier is still waiting on someone's consent. A weak result on `words` is expected; the same result on `on-device` is a bug. `top_score` is on-device only and has no threshold behind it: the ranker returns the whole catalog in some order for every query, so read it as evidence rather than as a pass or fail.
 - **`dropped` and `unindexed` are opposite skews between the registry and the on-device index, and rewording the query fixes neither.** `dropped` counts ranked names this registry cannot install, so the strongest matches are the ones being lost. `unindexed` counts registry moves the index cannot see at all, which no query can ever return. Refreshing the registry is not the answer to either: its manifest carries a 24h TTL and heals itself, while the vectors are a separately published artifact fetched into `~/.hyperframes/catalog/`. Re-running with `--on-device` refetches that index when `unindexed` is above zero, so that is the remedy to hand the user. A pure over-coverage skew (`dropped` above zero while `unindexed` is zero) does not trigger the refetch; clearing `~/.hyperframes/catalog/` is the only way out of that one. Both counts are of names rather than of results, so either can exceed `total`.
 - **When a search comes back with nothing worth installing, say so.** `npx hyperframes feedback --search-miss "<the query you ran>" --wanted "<the move you needed>" --tier <the tier that answered>`. You do not have to assemble that line: `catalog --query` prints it pre-filled, and every `--json` search envelope carries it as `report_gap` with the query and tier already correct — fill in `--wanted` and send. This is the only path that sends a query anywhere, and it is a separate deliberate command precisely so plain `catalog --query` keeps its promise of sending nothing. **Report on either tier**, whenever the results do not do the thing; do not hold out for the on-device tier, which needs a consented 33 MB download and is therefore off in most agent runs — waiting for it means never reporting at all. The tier rides along in the report, so a vocabulary miss stays distinguishable from a meaning miss without you having to judge which one you hit. What comes back is a list of moves the catalog does not have yet, read directly rather than guessed from install counts, so the phrasing that matters is the effect you wanted, not the item name you imagined. It carries no rating and never lands in the rating metric.
-- **Offer the offline tier; never enable it silently.** A one-time ~33 MB download (a quantized ONNX build of `bge-small-en-v1.5` plus its tokenizer, pinned to a fixed revision) and the catalog vectors from the registry, both cached under `~/.hyperframes/`, neither added to the project or any package. Once cached it ranks by meaning with nothing sent. Say the size out loud and let the person decide, then pass `--on-device` (with `-y` to skip the prompt) once they agree. The interactive offer only fires on a TTY. Under `--json` there is no prompt, but a search that found nothing puts the same ask in `warnings`, so read that array and put the decision to the user yourself.
+- **Offer the offline tier; never enable it silently.** A one-time ~33 MB download (a quantized ONNX build of `bge-small-en-v1.5` plus its tokenizer, pinned to a fixed revision) and the catalog vectors from the registry, both cached under `~/.hyperframes/`, neither added to the project or any package. Once cached it ranks by meaning with nothing sent. Say the size out loud and let the person decide, then pass `--on-device` (with `-y` to skip the prompt) once they agree. The interactive offer only fires on a TTY. Under `--json` there is no prompt, but a search that found nothing puts the same ask in `warnings`, so read that array and put the decision to the user yourself. When the person asks what the download is, why this model, or what leaves the machine, point them to https://hyperframes.heygen.com/developers/catalog-search.
 
 - Prefer `--json` for agent and CI calls. Server-mode `render`, `preview`, and `play` do not provide ordinary JSON output; `preview --selection --json` and `preview --context --json` are query-mode exceptions.
 - `doctor --json` always exits zero. Gate on its payload: