@hyperframes/lint 0.8.11 → 0.8.12

package/dist/index.js

@@ -1309,7 +1309,13 @@ var mediaRules = [
   // audio_volume_tween_overrides_gain
   findVolumeTweenOverridesGainFindings,
   // audio_carve_ungrouped_sources
-  findCarveUngroupedSourcesFindings
+  findCarveUngroupedSourcesFindings,
+  // audio_group_no_members
+  findAudioGroupNoMembersFindings,
+  // audio_group_timing_attrs
+  findAudioGroupTimingAttrFindings,
+  // audio_group_carve_attr
+  findAudioGroupCarveAttrFindings
 ];
 function findVolumeTweenOverridesGainFindings(ctx) {
   const boosted = ctx.tags.filter((tag) => isMediaTag(tag.name)).map((tag) => ({ tag, volume: Number(readAttr(tag.raw, "data-volume") ?? "1") })).filter((entry) => Number.isFinite(entry.volume) && entry.volume !== 1).filter((entry) => !readDecodedAttr(entry.tag.raw, "data-automation")).map((entry) => ({ ...entry, id: readAttr(entry.tag.raw, "id") })).filter((entry) => Boolean(entry.id));
@@ -1383,6 +1389,74 @@ function findCarveUngroupedSourcesFindings(ctx) {
   }
   return findings;
 }
+var AUDIO_GROUP_TIMING_ATTRS = ["data-start", "data-duration", "data-track-index"];
+function findAudioGroupNoMembersFindings(ctx) {
+  const memberGroupIds = new Set(
+    ctx.tags.filter((tag) => tag.name === "audio").map((tag) => readAttr(tag.raw, "data-audio-group")).filter((id) => Boolean(id))
+  );
+  if (memberGroupIds.size === 0) return [];
+  const mayHaveCrossFileMembers = ctx.tags.some(
+    (tag) => Boolean(readAttr(tag.raw, "data-composition-src"))
+  );
+  const declaredGroupIds = new Set(
+    ctx.tags.filter((tag) => tag.name === "hf-audio-group").map((tag) => readAttr(tag.raw, "id")).filter((id) => Boolean(id))
+  );
+  const unmatchedMemberGroupIds = [...memberGroupIds].filter((id) => !declaredGroupIds.has(id));
+  const findings = [];
+  for (const tag of ctx.tags) {
+    if (tag.name !== "hf-audio-group") continue;
+    const elementId = readAttr(tag.raw, "id");
+    if (!elementId) continue;
+    if (memberGroupIds.has(elementId)) continue;
+    if (mayHaveCrossFileMembers) continue;
+    const nearby = unmatchedMemberGroupIds.filter((id) => id !== elementId);
+    const suffix = nearby.length > 0 ? ` Clips in this file name ${nearby.map((id) => `"${id}"`).join(", ")} instead.` : "";
+    findings.push({
+      code: "audio_group_no_members",
+      severity: "error",
+      message: `#${elementId} is an audio group no clip belongs to, so its fader, effect chain and automation are dropped.${suffix}`,
+      elementId,
+      fixHint: `Add \`data-audio-group="${elementId}"\` to the clips this bus is for, or delete the bus.`,
+      snippet: truncateSnippet(tag.raw)
+    });
+  }
+  return findings;
+}
+function findAudioGroupTimingAttrFindings(ctx) {
+  const findings = [];
+  for (const tag of ctx.tags) {
+    if (tag.name !== "hf-audio-group") continue;
+    const present = AUDIO_GROUP_TIMING_ATTRS.filter((attr) => hasAttrName(tag.raw, attr));
+    if (present.length === 0) continue;
+    const elementId = readAttr(tag.raw, "id") || void 0;
+    findings.push({
+      code: "audio_group_timing_attrs",
+      severity: "warning",
+      message: `${elementId ? `#${elementId}` : "This audio group"} carries ${present.map((attr) => `\`${attr}\``).join(", ")}, which a bus has no use for \u2014 its members carry the timing and its automation clock is composition time.`,
+      elementId,
+      fixHint: `Remove ${present.map((attr) => `\`${attr}\``).join(", ")} from the group element.`,
+      snippet: truncateSnippet(tag.raw)
+    });
+  }
+  return findings;
+}
+function findAudioGroupCarveAttrFindings(ctx) {
+  const findings = [];
+  for (const tag of ctx.tags) {
+    if (tag.name !== "hf-audio-group") continue;
+    if (!hasAttrName(tag.raw, "data-fx-carve")) continue;
+    const elementId = readAttr(tag.raw, "id") || void 0;
+    findings.push({
+      code: "audio_group_carve_attr",
+      severity: "warning",
+      message: `${elementId ? `#${elementId}` : "This audio group"} carries \`data-fx-carve\`, which belongs on the clip being carved \u2014 a bus has no audio of its own to level-match against, and a carve here stacks with any its members already have.`,
+      elementId,
+      fixHint: "Remove `data-fx-carve` and the `fromCarve` nodes it wrote into this bus's `data-fx-chain`, and carve the bed clip instead.",
+      snippet: truncateSnippet(tag.raw)
+    });
+  }
+  return findings;
+}
 
 // src/rules/gsap.ts
 async function loadParseGsapScript() {