@hyperframes/parsers 0.7.37 → 0.7.38

package/dist/hfIds.d.ts

@@ -13,6 +13,15 @@ declare const EXCLUDED_TAGS: Set<string>;
  * never re-exposes the ordering after first persist.
  */
 declare function mintHfId(el: Element, assigned: Set<string>): string;
+/**
+ * True for a `<template data-composition-id>` — the sub-composition authoring
+ * pattern whose content the studio preview unwraps into the served body. Only
+ * these templates are treated as transparent containers for hf-id purposes.
+ * A plain `<template>` (runtime clone-source: list item, particle, etc.) must
+ * NOT get inner ids: its content is cloned N times into the live DOM, so a
+ * persisted inner id would be duplicated across every clone.
+ */
+declare function isCompositionTemplate(el: Element): boolean;
 declare function ensureHfIds(html: string): string;
 
-export { EXCLUDED_TAGS, ensureHfIds, mintHfId };
+export { EXCLUDED_TAGS, ensureHfIds, isCompositionTemplate, mintHfId };

package/dist/hfIds.js

@@ -48,6 +48,17 @@ function mintHfId(el, assigned) {
   assigned.add(id);
   return id;
 }
+function isCompositionTemplate(el) {
+  return el.tagName.toLowerCase() === "template" && el.getAttribute("data-composition-id") !== null;
+}
+function walkElements(root, visit) {
+  for (const child of Array.from(root.children)) {
+    const isTemplate = child.tagName.toLowerCase() === "template";
+    if (isTemplate && !isCompositionTemplate(child)) continue;
+    visit(child);
+    walkElements(child, visit);
+  }
+}
 function ensureHfIds(html) {
   const hasDocumentShell = /<!doctype|<html[\s>]/i.test(html);
   const wrapped = !hasDocumentShell;
@@ -55,20 +66,21 @@ function ensureHfIds(html) {
   const body = document.body;
   if (!body) return html;
   const assigned = /* @__PURE__ */ new Set();
-  for (const el of Array.from(body.querySelectorAll("[data-hf-id]"))) {
+  walkElements(body, (el) => {
     const existing = el.getAttribute("data-hf-id");
     if (existing) assigned.add(existing);
-  }
-  for (const el of Array.from(body.querySelectorAll("*"))) {
-    if (EXCLUDED_TAGS.has(el.tagName.toLowerCase())) continue;
-    if (el.getAttribute("data-hf-id")) continue;
+  });
+  walkElements(body, (el) => {
+    if (EXCLUDED_TAGS.has(el.tagName.toLowerCase())) return;
+    if (el.getAttribute("data-hf-id")) return;
     el.setAttribute("data-hf-id", mintHfId(el, assigned));
-  }
+  });
   return wrapped ? document.body.innerHTML || "" : document.toString();
 }
 export {
   EXCLUDED_TAGS,
   ensureHfIds,
+  isCompositionTemplate,
   mintHfId
 };
 //# sourceMappingURL=hfIds.js.map

package/dist/hfIds.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/hfIds.ts"],"sourcesContent":["/**\n * Stable hf- element id minting (R1). Node-safe (linkedom only, not browser DOM).\n *\n * Two surfaces share these helpers:\n *  - ensureHfIds(html): node-id surface — mints data-hf-id on every element.\n *  - mintHfId(el, assigned): shared by htmlParser for clip ids.\n *\n * Hash is CONTENT ONLY (tag + sorted attrs + own text) — no sibling position,\n * so inserting a non-identical sibling never shifts another element's id.\n */\nimport { parseHTML } from \"linkedom\";\n\n// Non-editable / non-visual elements that should never receive a stable id.\nexport const EXCLUDED_TAGS = new Set([\n  \"script\",\n  \"style\",\n  \"template\",\n  \"meta\",\n  \"link\",\n  \"noscript\",\n  \"base\",\n]);\n\n// 32-bit FNV-1a. Pure, deterministic, no crypto, no Math.random.\nfunction fnv1a(str: string): number {\n  let h = 0x811c9dc5;\n  for (let i = 0; i < str.length; i++) {\n    h ^= str.charCodeAt(i);\n    h = Math.imul(h, 0x01000193);\n  }\n  return h >>> 0;\n}\n\n// 4 base-36 chars · 36^4 ≈ 1.68M ids per document. Birthday-paradox collision\n// ≈ N²/(2·36^4): well under 1% per document after dup rehash at realistic\n// clip-model sizes (≤ a few hundred elements). The dup-rehash in mintHfId\n// resolves the rare collision; width is deliberately small for readable ids.\nfunction toHfId(hash: number): string {\n  const s = (hash >>> 0).toString(36);\n  // Use suffix (most-avalanched bits) for better distribution within the 4-char window.\n  const four = s.length >= 4 ? s.slice(-4) : s.padStart(4, \"0\");\n  return `hf-${four}`;\n}\n\n// Element's own direct text (TEXT_NODE children), not descendants'.\nfunction ownText(el: Element): string {\n  let text = \"\";\n  el.childNodes.forEach((n) => {\n    if (n.nodeType === 3) text += (n as Text).nodeValue ?? \"\";\n  });\n  return text.trim();\n}\n\nfunction contentKey(el: Element): string {\n  // Exclude all data-hf-* attrs (ids, studio state) — they must not influence the hash.\n  // Use \\x00 / \\x01 separators (invalid in HTML attrs) to prevent ambiguous serialization.\n  const attrs = Array.from(el.attributes)\n    .filter((a) => !a.name.startsWith(\"data-hf-\"))\n    .map((a) => `${a.name}\\x00${a.value}`)\n    .sort()\n    .join(\"\\x01\");\n  return `${el.tagName.toLowerCase()}|${attrs}|${ownText(el)}`;\n}\n\n/**\n * Collision tiebreak for byte-identical siblings: document-order dup counter\n * (`hash(key#N)`). This IS order-dependent — two identical `<span></span>`\n * get different ids based on which comes first in the DOM. This is unavoidable:\n * unique ids for byte-identical elements require a positional signal.\n *\n * Why this is safe in practice: once `ensureHfIds` write-back persists\n * `data-hf-id` to source the attribute is physically bound to its element.\n * Reordering identical siblings carries the attribute along → zero\n * order-dependence post-persist. `ensureHfIds` skips pinned elements\n * (`if (el.getAttribute(\"data-hf-id\")) continue`), so normal operation\n * never re-exposes the ordering after first persist.\n */\n// WIRE CONTRACT: id minting is content-keyed (FNV1a of innerHTML + tag). R7's\n// preview route relies on mintHfId producing identical ids across mint contexts\n// (disk-persist pass vs. in-memory bundle pass) — see preview.test.ts\n// \"bundle returning untagged HTML gets same ids as disk\". Any change that adds\n// positional, session, or random input to the hash breaks that invariant and\n// makes hf- ids diverge between disk and served HTML, silently corrupting\n// drag-to-edit targeting.\nexport function mintHfId(el: Element, assigned: Set<string>): string {\n  const key = contentKey(el);\n  let id = toHfId(fnv1a(key));\n  let dup = 0;\n  while (assigned.has(id)) {\n    dup += 1;\n    // Graceful fallback instead of a hard throw: rehashing only fails to find a\n    // free 4-char slot in a pathological document (~1.6M identical elements).\n    // Rather than crash the whole parse, widen the id with the dup counter —\n    // still deterministic and unique, just longer than the 4-char norm.\n    if (dup > 10000) {\n      id = `hf-${(fnv1a(key) >>> 0).toString(36)}-${dup}`;\n      break;\n    }\n    id = toHfId(fnv1a(`${key}#${dup}`));\n  }\n  assigned.add(id);\n  return id;\n}\n\nexport function ensureHfIds(html: string): string {\n  // Mirror parseSourceDocument's fragment-wrapping so bare fragments don't land\n  // outside <body> in linkedom, which would cause body.querySelectorAll to return [].\n  const hasDocumentShell = /<!doctype|<html[\\s>]/i.test(html);\n  const wrapped = !hasDocumentShell;\n  const { document } = wrapped\n    ? parseHTML(`<!DOCTYPE html><html><head></head><body>${html}</body></html>`)\n    : parseHTML(html);\n  const body = document.body;\n  if (!body) return html;\n\n  const assigned = new Set<string>();\n  // Seed with already-present ids (pin) so fresh mints never collide with them.\n  // Scope to <body> to match the mint walk below — a stray data-hf-id in <head>\n  // must not pin an id into the set that a body element would then be bumped off.\n  for (const el of Array.from(body.querySelectorAll(\"[data-hf-id]\"))) {\n    const existing = el.getAttribute(\"data-hf-id\");\n    if (existing) assigned.add(existing);\n  }\n\n  for (const el of Array.from(body.querySelectorAll(\"*\"))) {\n    if (EXCLUDED_TAGS.has(el.tagName.toLowerCase())) continue;\n    if (el.getAttribute(\"data-hf-id\")) continue; // pinned\n    el.setAttribute(\"data-hf-id\", mintHfId(el, assigned));\n  }\n\n  return wrapped ? document.body.innerHTML || \"\" : document.toString();\n}\n"],"mappings":";AAUA,SAAS,iBAAiB;AAGnB,IAAM,gBAAgB,oBAAI,IAAI;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAGD,SAAS,MAAM,KAAqB;AAClC,MAAI,IAAI;AACR,WAAS,IAAI,GAAG,IAAI,IAAI,QAAQ,KAAK;AACnC,SAAK,IAAI,WAAW,CAAC;AACrB,QAAI,KAAK,KAAK,GAAG,QAAU;AAAA,EAC7B;AACA,SAAO,MAAM;AACf;AAMA,SAAS,OAAO,MAAsB;AACpC,QAAM,KAAK,SAAS,GAAG,SAAS,EAAE;AAElC,QAAM,OAAO,EAAE,UAAU,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,GAAG;AAC5D,SAAO,MAAM,IAAI;AACnB;AAGA,SAAS,QAAQ,IAAqB;AACpC,MAAI,OAAO;AACX,KAAG,WAAW,QAAQ,CAAC,MAAM;AAC3B,QAAI,EAAE,aAAa,EAAG,SAAS,EAAW,aAAa;AAAA,EACzD,CAAC;AACD,SAAO,KAAK,KAAK;AACnB;AAEA,SAAS,WAAW,IAAqB;AAGvC,QAAM,QAAQ,MAAM,KAAK,GAAG,UAAU,EACnC,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,WAAW,UAAU,CAAC,EAC5C,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,KAAO,EAAE,KAAK,EAAE,EACpC,KAAK,EACL,KAAK,GAAM;AACd,SAAO,GAAG,GAAG,QAAQ,YAAY,CAAC,IAAI,KAAK,IAAI,QAAQ,EAAE,CAAC;AAC5D;AAsBO,SAAS,SAAS,IAAa,UAA+B;AACnE,QAAM,MAAM,WAAW,EAAE;AACzB,MAAI,KAAK,OAAO,MAAM,GAAG,CAAC;AAC1B,MAAI,MAAM;AACV,SAAO,SAAS,IAAI,EAAE,GAAG;AACvB,WAAO;AAKP,QAAI,MAAM,KAAO;AACf,WAAK,OAAO,MAAM,GAAG,MAAM,GAAG,SAAS,EAAE,CAAC,IAAI,GAAG;AACjD;AAAA,IACF;AACA,SAAK,OAAO,MAAM,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;AAAA,EACpC;AACA,WAAS,IAAI,EAAE;AACf,SAAO;AACT;AAEO,SAAS,YAAY,MAAsB;AAGhD,QAAM,mBAAmB,wBAAwB,KAAK,IAAI;AAC1D,QAAM,UAAU,CAAC;AACjB,QAAM,EAAE,SAAS,IAAI,UACjB,UAAU,2CAA2C,IAAI,gBAAgB,IACzE,UAAU,IAAI;AAClB,QAAM,OAAO,SAAS;AACtB,MAAI,CAAC,KAAM,QAAO;AAElB,QAAM,WAAW,oBAAI,IAAY;AAIjC,aAAW,MAAM,MAAM,KAAK,KAAK,iBAAiB,cAAc,CAAC,GAAG;AAClE,UAAM,WAAW,GAAG,aAAa,YAAY;AAC7C,QAAI,SAAU,UAAS,IAAI,QAAQ;AAAA,EACrC;AAEA,aAAW,MAAM,MAAM,KAAK,KAAK,iBAAiB,GAAG,CAAC,GAAG;AACvD,QAAI,cAAc,IAAI,GAAG,QAAQ,YAAY,CAAC,EAAG;AACjD,QAAI,GAAG,aAAa,YAAY,EAAG;AACnC,OAAG,aAAa,cAAc,SAAS,IAAI,QAAQ,CAAC;AAAA,EACtD;AAEA,SAAO,UAAU,SAAS,KAAK,aAAa,KAAK,SAAS,SAAS;AACrE;","names":[]}
+{"version":3,"sources":["../src/hfIds.ts"],"sourcesContent":["/**\n * Stable hf- element id minting (R1). Node-safe (linkedom only, not browser DOM).\n *\n * Two surfaces share these helpers:\n *  - ensureHfIds(html): node-id surface — mints data-hf-id on every element.\n *  - mintHfId(el, assigned): shared by htmlParser for clip ids.\n *\n * Hash is CONTENT ONLY (tag + sorted attrs + own text) — no sibling position,\n * so inserting a non-identical sibling never shifts another element's id.\n */\nimport { parseHTML } from \"linkedom\";\n\n// Non-editable / non-visual elements that should never receive a stable id.\nexport const EXCLUDED_TAGS = new Set([\n  \"script\",\n  \"style\",\n  \"template\",\n  \"meta\",\n  \"link\",\n  \"noscript\",\n  \"base\",\n]);\n\n// 32-bit FNV-1a. Pure, deterministic, no crypto, no Math.random.\nfunction fnv1a(str: string): number {\n  let h = 0x811c9dc5;\n  for (let i = 0; i < str.length; i++) {\n    h ^= str.charCodeAt(i);\n    h = Math.imul(h, 0x01000193);\n  }\n  return h >>> 0;\n}\n\n// 4 base-36 chars · 36^4 ≈ 1.68M ids per document. Birthday-paradox collision\n// ≈ N²/(2·36^4): well under 1% per document after dup rehash at realistic\n// clip-model sizes (≤ a few hundred elements). The dup-rehash in mintHfId\n// resolves the rare collision; width is deliberately small for readable ids.\nfunction toHfId(hash: number): string {\n  const s = (hash >>> 0).toString(36);\n  // Use suffix (most-avalanched bits) for better distribution within the 4-char window.\n  const four = s.length >= 4 ? s.slice(-4) : s.padStart(4, \"0\");\n  return `hf-${four}`;\n}\n\n// Element's own direct text (TEXT_NODE children), not descendants'.\nfunction ownText(el: Element): string {\n  let text = \"\";\n  el.childNodes.forEach((n) => {\n    if (n.nodeType === 3) text += (n as Text).nodeValue ?? \"\";\n  });\n  return text.trim();\n}\n\nfunction contentKey(el: Element): string {\n  // Exclude all data-hf-* attrs (ids, studio state) — they must not influence the hash.\n  // Use \\x00 / \\x01 separators (invalid in HTML attrs) to prevent ambiguous serialization.\n  const attrs = Array.from(el.attributes)\n    .filter((a) => !a.name.startsWith(\"data-hf-\"))\n    .map((a) => `${a.name}\\x00${a.value}`)\n    .sort()\n    .join(\"\\x01\");\n  return `${el.tagName.toLowerCase()}|${attrs}|${ownText(el)}`;\n}\n\n/**\n * Collision tiebreak for byte-identical siblings: document-order dup counter\n * (`hash(key#N)`). This IS order-dependent — two identical `<span></span>`\n * get different ids based on which comes first in the DOM. This is unavoidable:\n * unique ids for byte-identical elements require a positional signal.\n *\n * Why this is safe in practice: once `ensureHfIds` write-back persists\n * `data-hf-id` to source the attribute is physically bound to its element.\n * Reordering identical siblings carries the attribute along → zero\n * order-dependence post-persist. `ensureHfIds` skips pinned elements\n * (`if (el.getAttribute(\"data-hf-id\")) continue`), so normal operation\n * never re-exposes the ordering after first persist.\n */\n// WIRE CONTRACT: id minting is content-keyed (FNV1a of innerHTML + tag). R7's\n// preview route relies on mintHfId producing identical ids across mint contexts\n// (disk-persist pass vs. in-memory bundle pass) — see preview.test.ts\n// \"bundle returning untagged HTML gets same ids as disk\". Any change that adds\n// positional, session, or random input to the hash breaks that invariant and\n// makes hf- ids diverge between disk and served HTML, silently corrupting\n// drag-to-edit targeting.\nexport function mintHfId(el: Element, assigned: Set<string>): string {\n  const key = contentKey(el);\n  let id = toHfId(fnv1a(key));\n  let dup = 0;\n  while (assigned.has(id)) {\n    dup += 1;\n    // Graceful fallback instead of a hard throw: rehashing only fails to find a\n    // free 4-char slot in a pathological document (~1.6M identical elements).\n    // Rather than crash the whole parse, widen the id with the dup counter —\n    // still deterministic and unique, just longer than the 4-char norm.\n    if (dup > 10000) {\n      id = `hf-${(fnv1a(key) >>> 0).toString(36)}-${dup}`;\n      break;\n    }\n    id = toHfId(fnv1a(`${key}#${dup}`));\n  }\n  assigned.add(id);\n  return id;\n}\n\n/**\n * True for a `<template data-composition-id>` — the sub-composition authoring\n * pattern whose content the studio preview unwraps into the served body. Only\n * these templates are treated as transparent containers for hf-id purposes.\n * A plain `<template>` (runtime clone-source: list item, particle, etc.) must\n * NOT get inner ids: its content is cloned N times into the live DOM, so a\n * persisted inner id would be duplicated across every clone.\n */\nexport function isCompositionTemplate(el: Element): boolean {\n  return el.tagName.toLowerCase() === \"template\" && el.getAttribute(\"data-composition-id\") !== null;\n}\n\n/**\n * Document-order walk of every element under `root`, descending into\n * composition `<template>` subtrees — linkedom's querySelectorAll does not, so\n * template-based sub-comps would otherwise never get inner ids (the preview\n * unwraps the template and stamps the SAME content, so skipping here splits\n * the id space between the served DOM and the raw file). Plain templates are\n * skipped entirely (see isCompositionTemplate).\n */\nfunction walkElements(root: Element, visit: (el: Element) => void): void {\n  for (const child of Array.from(root.children)) {\n    const isTemplate = child.tagName.toLowerCase() === \"template\";\n    if (isTemplate && !isCompositionTemplate(child)) continue;\n    visit(child);\n    walkElements(child, visit);\n  }\n}\n\nexport function ensureHfIds(html: string): string {\n  // Mirror parseSourceDocument's fragment-wrapping so bare fragments don't land\n  // outside <body> in linkedom, which would cause body.querySelectorAll to return [].\n  const hasDocumentShell = /<!doctype|<html[\\s>]/i.test(html);\n  const wrapped = !hasDocumentShell;\n  const { document } = wrapped\n    ? parseHTML(`<!DOCTYPE html><html><head></head><body>${html}</body></html>`)\n    : parseHTML(html);\n  const body = document.body;\n  if (!body) return html;\n\n  const assigned = new Set<string>();\n  // Seed with already-present ids (pin) so fresh mints never collide with them.\n  // Scope to <body> to match the mint walk below — a stray data-hf-id in <head>\n  // must not pin an id into the set that a body element would then be bumped off.\n  walkElements(body, (el) => {\n    const existing = el.getAttribute(\"data-hf-id\");\n    if (existing) assigned.add(existing);\n  });\n\n  walkElements(body, (el) => {\n    if (EXCLUDED_TAGS.has(el.tagName.toLowerCase())) return;\n    if (el.getAttribute(\"data-hf-id\")) return; // pinned\n    el.setAttribute(\"data-hf-id\", mintHfId(el, assigned));\n  });\n\n  return wrapped ? document.body.innerHTML || \"\" : document.toString();\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export { isStudioHoldSet } from './gsapParser.js';
 export { PROPERTY_GROUPS, PropertyGroupName, SUPPORTED_EASES, SUPPORTED_PROPS, classifyPropertyGroup, classifyTweenPropertyGroup } from './gsapConstants.js';
 export { SPRING_PRESETS, SpringPreset, generateSpringEaseData } from './springEase.js';
 export { parseGsapScriptAcorn as parseGsapScript } from './gsapParserAcorn.js';
-export { EXCLUDED_TAGS, ensureHfIds, mintHfId } from './hfIds.js';
+export { EXCLUDED_TAGS, ensureHfIds, isCompositionTemplate, mintHfId } from './hfIds.js';
 export { ParsableDocumentLike, SubCompositionValidity, SubCompositionValidityReason, checkSubCompositionUsability } from './subCompositionValidity.js';
 export { CANONICAL_FONT_DISPLAY_NAMES, FONT_ALIAS_KEYS, FONT_ALIAS_MAP, decodeUrlPathVariants, resolveAliasDisplayName } from './composition.js';
 

package/dist/index.js

@@ -1986,6 +1986,17 @@ function mintHfId(el, assigned) {
   assigned.add(id);
   return id;
 }
+function isCompositionTemplate(el) {
+  return el.tagName.toLowerCase() === "template" && el.getAttribute("data-composition-id") !== null;
+}
+function walkElements(root, visit) {
+  for (const child of Array.from(root.children)) {
+    const isTemplate = child.tagName.toLowerCase() === "template";
+    if (isTemplate && !isCompositionTemplate(child)) continue;
+    visit(child);
+    walkElements(child, visit);
+  }
+}
 function ensureHfIds(html) {
   const hasDocumentShell = /<!doctype|<html[\s>]/i.test(html);
   const wrapped = !hasDocumentShell;
@@ -1993,15 +2004,15 @@ function ensureHfIds(html) {
   const body = document.body;
   if (!body) return html;
   const assigned = /* @__PURE__ */ new Set();
-  for (const el of Array.from(body.querySelectorAll("[data-hf-id]"))) {
+  walkElements(body, (el) => {
     const existing = el.getAttribute("data-hf-id");
     if (existing) assigned.add(existing);
-  }
-  for (const el of Array.from(body.querySelectorAll("*"))) {
-    if (EXCLUDED_TAGS.has(el.tagName.toLowerCase())) continue;
-    if (el.getAttribute("data-hf-id")) continue;
+  });
+  walkElements(body, (el) => {
+    if (EXCLUDED_TAGS.has(el.tagName.toLowerCase())) return;
+    if (el.getAttribute("data-hf-id")) return;
     el.setAttribute("data-hf-id", mintHfId(el, assigned));
-  }
+  });
   return wrapped ? document.body.innerHTML || "" : document.toString();
 }
 
@@ -3059,6 +3070,7 @@ export {
   getDefaultStageZoom,
   gsapAnimationsToKeyframes,
   isCompositionElement,
+  isCompositionTemplate,
   isMediaElement,
   isStudioHoldSet,
   isTextElement,