@hyperframes/lint 0.8.108 → 0.8.110

package/dist/index.js

@@ -1372,6 +1372,93 @@ function cssErrorOffset(source, error) {
 import { validateColorGradingContract } from "@hyperframes/parsers/color-grading-contract";
 import { extractMediaSrcMutations } from "@hyperframes/parsers/composition";
 import { parseHTML } from "linkedom";
+
+// src/rules/linkedClips.ts
+var SYNC_TOLERANCE_S = 1e-3;
+var LINKED_TIMING_FIELDS = [
+  { field: "start", attrs: ["data-start"], fallback: 0 },
+  { field: "duration", attrs: ["data-duration"], fallback: 0 },
+  { field: "media-start", attrs: ["data-playback-start", "data-media-start"], fallback: 0 },
+  { field: "playback-rate", attrs: ["data-playback-rate"], fallback: 1 }
+];
+function readTimingField(tag, attrs, fallback) {
+  for (const attr of attrs) {
+    const raw = readAttr(tag.raw, attr);
+    if (raw === null || raw.trim() === "") continue;
+    const value = Number(raw);
+    if (Number.isFinite(value)) return value;
+  }
+  return fallback;
+}
+function driftingFields(members) {
+  return LINKED_TIMING_FIELDS.filter(({ attrs, fallback }) => {
+    const values = members.map((tag) => readTimingField(tag, attrs, fallback));
+    const first = values[0] ?? fallback;
+    return values.some((value) => Math.abs(value - first) > SYNC_TOLERANCE_S);
+  }).map(({ field }) => field);
+}
+function compositionScopeOf(tag, compositions) {
+  let scope = -1;
+  for (const composition of compositions) {
+    const end = composition.endIndex ?? composition.closeIndex ?? Number.POSITIVE_INFINITY;
+    const encloses = composition.index < tag.index && tag.index < end;
+    if (composition !== tag && encloses && composition.index > scope) scope = composition.index;
+  }
+  return scope;
+}
+function groupByLink(tags) {
+  const compositions = tags.filter(
+    (tag) => ["data-composition-id", "data-composition-file"].some(
+      (name) => readAttr(tag.raw, name) !== null
+    )
+  );
+  const groups = /* @__PURE__ */ new Map();
+  for (const tag of tags) {
+    const link = readAttr(tag.raw, "data-link");
+    if (!link) continue;
+    const key = `${compositionScopeOf(tag, compositions)}\0${link}`;
+    const group = groups.get(key) ?? { link, members: [] };
+    group.members.push(tag);
+    groups.set(key, group);
+  }
+  return groups;
+}
+var memberLabel = (tag) => {
+  const id = readAttr(tag.raw, "id");
+  return id ? `#${id}` : `<${tag.name}>`;
+};
+function findLinkedClipFindings(ctx) {
+  const findings = [];
+  for (const { link, members } of groupByLink(ctx.tags).values()) {
+    const first = members[0];
+    if (!first) continue;
+    const elementId = readAttr(first.raw, "id") || void 0;
+    if (members.length === 1) {
+      findings.push({
+        code: "linked_clip_orphan",
+        severity: "warning",
+        message: `${memberLabel(first)} is the only clip with data-link="${link}"; its linked partner is gone.`,
+        elementId,
+        fixHint: `Remove data-link="${link}" from ${memberLabel(first)}, or restore the partner clip.`,
+        snippet: truncateSnippet(first.raw)
+      });
+      continue;
+    }
+    const drift = driftingFields(members);
+    if (drift.length === 0) continue;
+    findings.push({
+      code: "linked_clips_out_of_sync",
+      severity: "warning",
+      message: `Linked clips ${members.map(memberLabel).join(", ")} (data-link="${link}") differ in ${drift.join(", ")}.`,
+      elementId,
+      fixHint: "Linked clips are edited as one: give every member the same data-start, data-duration, data-media-start and data-playback-rate, or remove data-link from all of them to unlink.",
+      snippet: truncateSnippet(first.raw)
+    });
+  }
+  return findings;
+}
+
+// src/rules/media.ts
 function tweensVolumeInSameCall(script, id) {
   const selector = new RegExp(`#${escapeRegExp(id)}(?![\\w-])`, "g");
   for (let hit = selector.exec(script); hit; hit = selector.exec(script)) {
@@ -2070,7 +2157,8 @@ var mediaRules = [
   // audio_group_timing_attrs
   findAudioGroupTimingAttrFindings,
   // audio_group_carve_attr
-  findAudioGroupCarveAttrFindings
+  findAudioGroupCarveAttrFindings,
+  findLinkedClipFindings
 ];
 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));