@hyperframes/parsers 0.8.48 → 0.8.50

package/dist/index.d.ts

@@ -8,6 +8,7 @@ export { parseGsapScriptAcorn as parseGsapScript } from './gsapParserAcorn.js';
 export { EXCLUDED_TAGS, ensureHfIds, isCompositionTemplate, mintHfId, walkCompositionDescendants } from './hfIds.js';
 export { ParsableDocumentLike, SubCompositionValidity, SubCompositionValidityReason, checkSubCompositionUsability } from './subCompositionValidity.js';
 export { CANONICAL_AUTHORED_TIMING_ATTRIBUTES, COMPOSITION_ATTRIBUTES, COMPOSITION_CONTRACT_VERSION, ClipAttributeReader, ClipAttributeWriter, ClipTiming, ClipTimingDiagnostic, ClipTimingDiagnosticCode, ClipTimingUpdate, ClipTimingWriteError, DERIVED_TIMING_ATTRIBUTES, LEGACY_TIMING_ATTRIBUTES, ReadClipTimingOptions, ReferenceExpression, parseNumeric, parseStartExpression, readClipTiming, writeClipTiming } from './compositionContract.js';
+export { StructureNode, TrackKind, TrackKindSource, isSubCompositionHost, isTimedElement, topLevelElements, trackKindOf } from './topLevelElements.js';
 export { CANONICAL_FONT_DISPLAY_NAMES, FONT_ALIAS_KEYS, FONT_ALIAS_MAP, VariableUsageScan, decodeUrlPathVariants, parseCompositionVariables, resolveAliasDisplayName, scanVariableUsage } from './composition.js';
 
 /**

package/dist/index.js

@@ -3526,6 +3526,40 @@ var HTML_BODY_CSS_WIDTH_FIRST_RE = /(html\s*,\s*body\s*\{[^}]*?width:\s*)(\d+)px
 var HTML_BODY_CSS_HEIGHT_FIRST_RE = /(html\s*,\s*body\s*\{[^}]*?height:\s*)(\d+)px([^}]*?width:\s*)(\d+)px/i;
 var VIEWPORT_META_SIZE_RE = /(<meta[^>]*name=["']viewport["'][^>]*content=["']width=)(\d+)(,\s*height=)(\d+)/i;
 
+// 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" };
+}
+
 // src/utils/urlPath.ts
 function decodeUrlPathVariants(path) {
   const variants = [path];
@@ -3863,7 +3897,9 @@ export {
   isCompositionTemplate,
   isMediaElement,
   isStudioHoldSet,
+  isSubCompositionHost,
   isTextElement,
+  isTimedElement,
   keyframesToGsapAnimations,
   mintHfId,
   normalizeResolutionFlag,
@@ -3881,6 +3917,8 @@ export {
   scanVariableUsage,
   serializeGsapAnimations,
   suggestMatchingPreset,
+  topLevelElements,
+  trackKindOf,
   unrollComputedTimeline,
   updateElementInHtml,
   validateCompositionGsap,