@hyperframes/parsers 0.8.49 → 0.8.50

package/dist/topLevelElements.d.ts

@@ -0,0 +1,22 @@
+/** Structural view of a markup node; lint (source tags) and Studio (DOM) adapt to it. */
+type StructureNode<N = unknown> = {
+    tag: string;
+    attrs: Readonly<Record<string, string | undefined>>;
+    children: readonly N[];
+};
+type TrackKind = "video" | "audio" | "captions" | "graphics";
+type TrackKindSource = "attribute" | "tag" | "legacy-captions" | "sub-composition";
+declare function isSubCompositionHost(node: StructureNode): boolean;
+/** Mirrors the runtime's clip selector; a data-track-index layer container without a duration is not a clip. */
+declare function isTimedElement(node: StructureNode): boolean;
+/**
+ * The elements that own a timeline row: a sub-composition host or timed element is one row
+ * and is never descended into; untimed wrappers are descended. The root itself is not a row.
+ */
+declare function topLevelElements<N extends StructureNode<N>>(root: N): N[];
+declare function trackKindOf(node: StructureNode): {
+    kind: TrackKind;
+    source: TrackKindSource;
+};
+
+export { type StructureNode, type TrackKind, type TrackKindSource, isSubCompositionHost, isTimedElement, topLevelElements, trackKindOf };

package/dist/topLevelElements.js

@@ -0,0 +1,40 @@
+// src/topLevelElements.ts
+var NON_RENDERED_TAGS = /* @__PURE__ */ new Set(["script", "style", "template", "noscript", "link", "meta"]);
+var MEDIA_TAGS = /* @__PURE__ */ new Set(["video", "audio", "img"]);
+var TRACK_KINDS = ["video", "audio", "captions", "graphics"];
+function isSubCompositionHost(node) {
+  return node.attrs["data-composition-src"] !== void 0 || node.attrs["data-composition-id"] !== void 0;
+}
+function isTimedElement(node) {
+  const { attrs } = node;
+  return attrs["data-start"] !== void 0 || attrs["data-track-index"] !== void 0 && attrs["data-duration"] !== void 0 || MEDIA_TAGS.has(node.tag.toLowerCase());
+}
+function topLevelElements(root) {
+  const rows = [];
+  const visit = (node) => {
+    if (NON_RENDERED_TAGS.has(node.tag.toLowerCase())) return;
+    if (isSubCompositionHost(node) || isTimedElement(node)) rows.push(node);
+    else node.children.forEach(visit);
+  };
+  root.children.forEach(visit);
+  return rows;
+}
+function trackKindOf(node) {
+  const explicit = node.attrs["data-track-kind"]?.trim().toLowerCase();
+  if (explicit && TRACK_KINDS.includes(explicit))
+    return { kind: explicit, source: "attribute" };
+  const tag = node.tag.toLowerCase();
+  if (tag === "video" || tag === "audio") return { kind: tag, source: "tag" };
+  if (isSubCompositionHost(node)) {
+    const legacy = node.attrs["data-composition-id"] === "captions" || /(?:^|\s)caption[-_]/.test(node.attrs.class ?? "");
+    return legacy ? { kind: "captions", source: "legacy-captions" } : { kind: "graphics", source: "sub-composition" };
+  }
+  return { kind: "graphics", source: "tag" };
+}
+export {
+  isSubCompositionHost,
+  isTimedElement,
+  topLevelElements,
+  trackKindOf
+};
+//# sourceMappingURL=topLevelElements.js.map

package/dist/topLevelElements.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/topLevelElements.ts"],"sourcesContent":["/** Structural view of a markup node; lint (source tags) and Studio (DOM) adapt to it. */\nexport type StructureNode<N = unknown> = {\n  tag: string;\n  attrs: Readonly<Record<string, string | undefined>>;\n  children: readonly N[];\n};\n\nexport type TrackKind = \"video\" | \"audio\" | \"captions\" | \"graphics\";\nexport type TrackKindSource = \"attribute\" | \"tag\" | \"legacy-captions\" | \"sub-composition\";\n\nconst NON_RENDERED_TAGS = new Set([\"script\", \"style\", \"template\", \"noscript\", \"link\", \"meta\"]);\nconst MEDIA_TAGS = new Set([\"video\", \"audio\", \"img\"]);\nconst TRACK_KINDS: readonly string[] = [\"video\", \"audio\", \"captions\", \"graphics\"];\n\nexport function isSubCompositionHost(node: StructureNode): boolean {\n  return (\n    node.attrs[\"data-composition-src\"] !== undefined ||\n    node.attrs[\"data-composition-id\"] !== undefined\n  );\n}\n\n/** Mirrors the runtime's clip selector; a data-track-index layer container without a duration is not a clip. */\nexport function isTimedElement(node: StructureNode): boolean {\n  const { attrs } = node;\n  return (\n    attrs[\"data-start\"] !== undefined ||\n    (attrs[\"data-track-index\"] !== undefined && attrs[\"data-duration\"] !== undefined) ||\n    MEDIA_TAGS.has(node.tag.toLowerCase())\n  );\n}\n\n/**\n * The elements that own a timeline row: a sub-composition host or timed element is one row\n * and is never descended into; untimed wrappers are descended. The root itself is not a row.\n */\nexport function topLevelElements<N extends StructureNode<N>>(root: N): N[] {\n  const rows: N[] = [];\n  const visit = (node: N): void => {\n    if (NON_RENDERED_TAGS.has(node.tag.toLowerCase())) return;\n    if (isSubCompositionHost(node) || isTimedElement(node)) rows.push(node);\n    else node.children.forEach(visit);\n  };\n  root.children.forEach(visit);\n  return rows;\n}\n\nexport function trackKindOf(node: StructureNode): { kind: TrackKind; source: TrackKindSource } {\n  const explicit = node.attrs[\"data-track-kind\"]?.trim().toLowerCase();\n  if (explicit && TRACK_KINDS.includes(explicit))\n    return { kind: explicit as TrackKind, source: \"attribute\" };\n  const tag = node.tag.toLowerCase();\n  if (tag === \"video\" || tag === \"audio\") return { kind: tag, source: \"tag\" };\n  if (isSubCompositionHost(node)) {\n    const legacy =\n      node.attrs[\"data-composition-id\"] === \"captions\" ||\n      /(?:^|\\s)caption[-_]/.test(node.attrs.class ?? \"\");\n    return legacy\n      ? { kind: \"captions\", source: \"legacy-captions\" }\n      : { kind: \"graphics\", source: \"sub-composition\" };\n  }\n  return { kind: \"graphics\", source: \"tag\" };\n}\n"],"mappings":";AAUA,IAAM,oBAAoB,oBAAI,IAAI,CAAC,UAAU,SAAS,YAAY,YAAY,QAAQ,MAAM,CAAC;AAC7F,IAAM,aAAa,oBAAI,IAAI,CAAC,SAAS,SAAS,KAAK,CAAC;AACpD,IAAM,cAAiC,CAAC,SAAS,SAAS,YAAY,UAAU;AAEzE,SAAS,qBAAqB,MAA8B;AACjE,SACE,KAAK,MAAM,sBAAsB,MAAM,UACvC,KAAK,MAAM,qBAAqB,MAAM;AAE1C;AAGO,SAAS,eAAe,MAA8B;AAC3D,QAAM,EAAE,MAAM,IAAI;AAClB,SACE,MAAM,YAAY,MAAM,UACvB,MAAM,kBAAkB,MAAM,UAAa,MAAM,eAAe,MAAM,UACvE,WAAW,IAAI,KAAK,IAAI,YAAY,CAAC;AAEzC;AAMO,SAAS,iBAA6C,MAAc;AACzE,QAAM,OAAY,CAAC;AACnB,QAAM,QAAQ,CAAC,SAAkB;AAC/B,QAAI,kBAAkB,IAAI,KAAK,IAAI,YAAY,CAAC,EAAG;AACnD,QAAI,qBAAqB,IAAI,KAAK,eAAe,IAAI,EAAG,MAAK,KAAK,IAAI;AAAA,QACjE,MAAK,SAAS,QAAQ,KAAK;AAAA,EAClC;AACA,OAAK,SAAS,QAAQ,KAAK;AAC3B,SAAO;AACT;AAEO,SAAS,YAAY,MAAmE;AAC7F,QAAM,WAAW,KAAK,MAAM,iBAAiB,GAAG,KAAK,EAAE,YAAY;AACnE,MAAI,YAAY,YAAY,SAAS,QAAQ;AAC3C,WAAO,EAAE,MAAM,UAAuB,QAAQ,YAAY;AAC5D,QAAM,MAAM,KAAK,IAAI,YAAY;AACjC,MAAI,QAAQ,WAAW,QAAQ,QAAS,QAAO,EAAE,MAAM,KAAK,QAAQ,MAAM;AAC1E,MAAI,qBAAqB,IAAI,GAAG;AAC9B,UAAM,SACJ,KAAK,MAAM,qBAAqB,MAAM,cACtC,sBAAsB,KAAK,KAAK,MAAM,SAAS,EAAE;AACnD,WAAO,SACH,EAAE,MAAM,YAAY,QAAQ,kBAAkB,IAC9C,EAAE,MAAM,YAAY,QAAQ,kBAAkB;AAAA,EACpD;AACA,SAAO,EAAE,MAAM,YAAY,QAAQ,MAAM;AAC3C;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/parsers",
-  "version": "0.8.49",
+  "version": "0.8.50",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
@@ -64,6 +64,10 @@
       "import": "./dist/compositionContract.js",
       "types": "./dist/compositionContract.d.ts"
     },
+    "./top-level-elements": {
+      "import": "./dist/topLevelElements.js",
+      "types": "./dist/topLevelElements.d.ts"
+    },
     "./color-grading-contract": {
       "import": "./dist/colorGradingContract.js",
       "types": "./dist/colorGradingContract.d.ts"
@@ -98,7 +102,7 @@
     "tsx": "^4.21.0",
     "typescript": "^5.0.0",
     "vitest": "^4.1.11",
-    "@hyperframes/core": "0.8.49"
+    "@hyperframes/core": "0.8.50"
   },
   "scripts": {
     "build": "tsup",