@hyperframes/sdk 0.7.45 → 0.7.47

package/dist/engine/patches.js

@@ -8,7 +8,8 @@
  *   /elements/{hfId}/timing/{start|end|duration|trackIndex}   ← end = computed absolute data-end
  *   /elements/{hfId}/hold/{start|end|fill}
  *   /elements/{hfId}                        ← whole subtree (removeElement)
- *   /variables/{variableId}
+ *   /variables/{variableId}                 ← declaration's default value
+ *   /variableDeclarations/{variableId}      ← whole declaration object
  *   /metadata/{width|height|duration}
  *   /script/gsap                            ← GSAP inline script textContent
  *   /style/css                              ← <style> element textContent
@@ -21,6 +22,7 @@
  *   /elements/hf-x/hold/start               → "hf-x.hold.start"
  *   /elements/hf-x                          → "hf-x"  (null = removal marker)
  *   /variables/brand-color-primary          → "var.brand-color-primary"
+ *   /variableDeclarations/brand-color-primary → "varDecl.brand-color-primary"
  *   /metadata/width                         → "meta.width"
  *   /script/gsap                            → "script.gsap"
  *   /style/css                              → "style.css"
@@ -62,6 +64,10 @@ export function elementPath(id) {
 export function variablePath(id) {
     return `/variables/${id}`;
 }
+/** Whole-declaration path — distinct from /variables/{id}, which is the default *value*. */
+export function variableDeclPath(id) {
+    return `/variableDeclarations/${id}`;
+}
 export function metaPath(field) {
     return `/metadata/${field}`;
 }
@@ -103,6 +109,10 @@ export function pathToKey(path) {
     const elemMatch = /^\/elements\/([^/]+)$/.exec(path);
     if (elemMatch)
         return decodePathSegment(elemMatch[1]);
+    // /variableDeclarations/{id} → "varDecl.{id}" (checked before /variables/)
+    const varDeclMatch = /^\/variableDeclarations\/(.+)$/.exec(path);
+    if (varDeclMatch)
+        return `varDecl.${varDeclMatch[1]}`;
     // /variables/{id} → "var.{id}"
     const varMatch = /^\/variables\/(.+)$/.exec(path);
     if (varMatch)
@@ -123,6 +133,8 @@ export function pathToKey(path) {
  * Inverse of pathToKey — maps an override-set key back to its RFC 6902 path.
  * Used to replay a stored override-set onto a fresh base document (T3 init).
  */
+// Exhaustive key-family dispatcher — same shape as apply-patches.ts parsePath.
+// fallow-ignore-next-line complexity
 export function keyToPath(key) {
     const style = /^([^.]+)\.style\.(.+)$/.exec(key);
     if (style?.[1] && style[2])
@@ -142,6 +154,9 @@ export function keyToPath(key) {
     const hold = /^([^.]+)\.hold\.(start|end|fill)$/.exec(key);
     if (hold?.[1])
         return holdPath(hold[1], hold[2]);
+    const varDecl = /^varDecl\.(.+)$/.exec(key);
+    if (varDecl?.[1])
+        return variableDeclPath(varDecl[1]);
     const variable = /^var\.(.+)$/.exec(key);
     if (variable?.[1])
         return variablePath(variable[1]);

package/dist/engine/patches.js.map

@@ -1 +1 @@
-{"version":3,"file":"patches.js","sourceRoot":"","sources":["../../src/engine/patches.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"patches.js","sourceRoot":"","sources":["../../src/engine/patches.ts"],"names":[],"mappings":"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"}

package/dist/engine/variableModel.d.ts

@@ -1,23 +1,65 @@
 /**
  * Shared helpers for the composition variable JSON model
- * (`data-composition-variables` on `document.documentElement`).
+ * (`data-composition-variables`). The declaration-carrying element is resolved
+ * by the caller (`declarationElement` in model.ts): `<html>` for full-document
+ * comps, the composition root div for wrapped template/fragment comps.
  *
  * Single source for the parse → find-by-id → read/write/clear logic so the
  * forward-mutation path (engine/mutate.ts) and the patch-replay path
  * (engine/apply-patches.ts) can never disagree on the model's shape.
  */
+import type { CompositionVariable } from "@hyperframes/core/variables";
+export type VariableDecl = {
+    id: string;
+    default?: unknown;
+    [key: string]: unknown;
+};
+/**
+ * Read the typed variable declarations from `data-composition-variables`.
+ * Delegates to the canonical parser (same filter the render pipeline uses),
+ * so malformed entries are dropped rather than surfaced. Returns `[]` when
+ * the declaration element is absent or has no declarations.
+ */
+export declare function readVariableDeclarations(declEl: Element | null): CompositionVariable[];
+/**
+ * Find the raw declaration entry for a variable id, verbatim (unvalidated).
+ * Returns undefined when the attribute is absent, the JSON is invalid, or no
+ * entry matches the id.
+ */
+export declare function findVariableDeclaration(declEl: Element | null, id: string): VariableDecl | undefined;
+/**
+ * Upsert a whole variable declaration by its id. Creates the
+ * `data-composition-variables` attribute when absent; replaces an unparseable
+ * attribute with a fresh single-entry array (the prior content was invisible
+ * to every reader anyway). Returns false only when there is no declaration
+ * element to carry the attribute.
+ *
+ * Accepts raw (unvalidated) entries as well as typed declarations: the patch
+ * REPLAY path must faithfully restore whatever entry the inverse patch
+ * captured — including loose hand-authored declarations the strict parser
+ * would drop — or undo silently diverges from history.
+ */
+export declare function writeVariableDeclaration(declEl: Element | null, declaration: CompositionVariable | ({
+    id: string;
+} & Record<string, unknown>)): boolean;
+/**
+ * Remove a variable declaration by id. Drops the whole attribute when the
+ * last declaration is removed (an empty `[]` is noise in authored HTML).
+ * No-ops (returns false) when the attribute or the entry is absent.
+ */
+export declare function removeVariableDeclarationEntry(declEl: Element | null, id: string): boolean;
 /**
  * Read the current `default` value for a variable id. Returns undefined when
  * the attribute is absent, the JSON is invalid, or no entry matches the id.
  */
-export declare function readVariableDefault(document: Document, id: string): unknown;
+export declare function readVariableDefault(declEl: Element | null, id: string): unknown;
 /**
  * Upsert a variable's `default`. No-ops (returns false) when the attribute is
  * absent or contains no declaration for the id — we never auto-add declarations
  * for undeclared variables, keeping the schema authoritative. Returns true when
  * the attribute was updated.
  */
-export declare function writeVariableDefault(document: Document, id: string, newDefault: unknown): boolean;
+export declare function writeVariableDefault(declEl: Element | null, id: string, newDefault: unknown): boolean;
 /**
  * Remove the `default` key from a variable declaration, restoring its
  * "no authored default" state. This is the exact inverse of writeVariableDefault
@@ -25,5 +67,5 @@ export declare function writeVariableDefault(document: Document, id: string, new
  * default-less variable round-trips. No-ops when the decl or key is absent.
  * Returns true when the attribute was updated.
  */
-export declare function clearVariableDefault(document: Document, id: string): boolean;
+export declare function clearVariableDefault(declEl: Element | null, id: string): boolean;
 //# sourceMappingURL=variableModel.d.ts.map

package/dist/engine/variableModel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"variableModel.d.ts","sourceRoot":"","sources":["../../src/engine/variableModel.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA4BH;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAK3E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,OAAO,CAQjG;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAS5E"}
+{"version":3,"file":"variableModel.d.ts","sourceRoot":"","sources":["../../src/engine/variableModel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAGvE,MAAM,MAAM,YAAY,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAqBrF;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,GAAG,mBAAmB,EAAE,CAGtF;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,GAAG,IAAI,EACtB,EAAE,EAAE,MAAM,GACT,YAAY,GAAG,SAAS,CAK1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,OAAO,GAAG,IAAI,EACtB,WAAW,EAAE,mBAAmB,GAAG,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC5E,OAAO,CAaT;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAY1F;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAK/E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,OAAO,GAAG,IAAI,EACtB,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,OAAO,GAClB,OAAO,CAQT;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAShF"}

package/dist/engine/variableModel.js

@@ -1,20 +1,21 @@
 /**
  * Shared helpers for the composition variable JSON model
- * (`data-composition-variables` on `document.documentElement`).
+ * (`data-composition-variables`). The declaration-carrying element is resolved
+ * by the caller (`declarationElement` in model.ts): `<html>` for full-document
+ * comps, the composition root div for wrapped template/fragment comps.
  *
  * Single source for the parse → find-by-id → read/write/clear logic so the
  * forward-mutation path (engine/mutate.ts) and the patch-replay path
  * (engine/apply-patches.ts) can never disagree on the model's shape.
  */
-function getHtmlEl(document) {
-    return document.documentElement ?? null;
-}
+// Browser-safe subpath — the core/parsers root entries pull Node-only modules
+// and would break browser bundles that include the SDK (e.g. Studio).
+import { parseCompositionVariables } from "@hyperframes/core/variables";
 /** Parse the variable declaration array, or null when absent/invalid. */
-function readDecls(document) {
-    const htmlEl = getHtmlEl(document);
-    if (!htmlEl)
+function readDecls(declEl) {
+    if (!declEl)
         return null;
-    const raw = htmlEl.getAttribute("data-composition-variables");
+    const raw = declEl.getAttribute("data-composition-variables");
     if (!raw)
         return null;
     let parsed;
@@ -26,17 +27,89 @@ function readDecls(document) {
     }
     if (!Array.isArray(parsed))
         return null;
-    return { htmlEl, arr: parsed };
+    return { declEl, arr: parsed };
 }
 function indexOfId(arr, id) {
     return arr.findIndex((v) => typeof v === "object" && v !== null && v.id === id);
 }
+/**
+ * Read the typed variable declarations from `data-composition-variables`.
+ * Delegates to the canonical parser (same filter the render pipeline uses),
+ * so malformed entries are dropped rather than surfaced. Returns `[]` when
+ * the declaration element is absent or has no declarations.
+ */
+export function readVariableDeclarations(declEl) {
+    if (!declEl)
+        return [];
+    return parseCompositionVariables(declEl);
+}
+/**
+ * Find the raw declaration entry for a variable id, verbatim (unvalidated).
+ * Returns undefined when the attribute is absent, the JSON is invalid, or no
+ * entry matches the id.
+ */
+export function findVariableDeclaration(declEl, id) {
+    const decls = readDecls(declEl);
+    if (!decls)
+        return undefined;
+    const idx = indexOfId(decls.arr, id);
+    return idx < 0 ? undefined : decls.arr[idx];
+}
+/**
+ * Upsert a whole variable declaration by its id. Creates the
+ * `data-composition-variables` attribute when absent; replaces an unparseable
+ * attribute with a fresh single-entry array (the prior content was invisible
+ * to every reader anyway). Returns false only when there is no declaration
+ * element to carry the attribute.
+ *
+ * Accepts raw (unvalidated) entries as well as typed declarations: the patch
+ * REPLAY path must faithfully restore whatever entry the inverse patch
+ * captured — including loose hand-authored declarations the strict parser
+ * would drop — or undo silently diverges from history.
+ */
+export function writeVariableDeclaration(declEl, declaration) {
+    if (!declEl)
+        return false;
+    const decls = readDecls(declEl);
+    const arr = decls?.arr ?? [];
+    const idx = indexOfId(arr, declaration.id);
+    const entry = { ...declaration };
+    if (idx < 0) {
+        arr.push(entry);
+    }
+    else {
+        arr[idx] = entry;
+    }
+    declEl.setAttribute("data-composition-variables", JSON.stringify(arr));
+    return true;
+}
+/**
+ * Remove a variable declaration by id. Drops the whole attribute when the
+ * last declaration is removed (an empty `[]` is noise in authored HTML).
+ * No-ops (returns false) when the attribute or the entry is absent.
+ */
+export function removeVariableDeclarationEntry(declEl, id) {
+    const decls = readDecls(declEl);
+    if (!decls)
+        return false;
+    const idx = indexOfId(decls.arr, id);
+    if (idx < 0)
+        return false;
+    decls.arr.splice(idx, 1);
+    if (decls.arr.length === 0) {
+        decls.declEl.removeAttribute("data-composition-variables");
+    }
+    else {
+        decls.declEl.setAttribute("data-composition-variables", JSON.stringify(decls.arr));
+    }
+    return true;
+}
 /**
  * Read the current `default` value for a variable id. Returns undefined when
  * the attribute is absent, the JSON is invalid, or no entry matches the id.
  */
-export function readVariableDefault(document, id) {
-    const decls = readDecls(document);
+export function readVariableDefault(declEl, id) {
+    const decls = readDecls(declEl);
     if (!decls)
         return undefined;
     const idx = indexOfId(decls.arr, id);
@@ -48,15 +121,15 @@ export function readVariableDefault(document, id) {
  * for undeclared variables, keeping the schema authoritative. Returns true when
  * the attribute was updated.
  */
-export function writeVariableDefault(document, id, newDefault) {
-    const decls = readDecls(document);
+export function writeVariableDefault(declEl, id, newDefault) {
+    const decls = readDecls(declEl);
     if (!decls)
         return false;
     const idx = indexOfId(decls.arr, id);
     if (idx < 0)
         return false; // variable not declared — don't auto-add
     decls.arr[idx] = { ...decls.arr[idx], default: newDefault };
-    decls.htmlEl.setAttribute("data-composition-variables", JSON.stringify(decls.arr));
+    decls.declEl.setAttribute("data-composition-variables", JSON.stringify(decls.arr));
     return true;
 }
 /**
@@ -66,8 +139,8 @@ export function writeVariableDefault(document, id, newDefault) {
  * default-less variable round-trips. No-ops when the decl or key is absent.
  * Returns true when the attribute was updated.
  */
-export function clearVariableDefault(document, id) {
-    const decls = readDecls(document);
+export function clearVariableDefault(declEl, id) {
+    const decls = readDecls(declEl);
     if (!decls)
         return false;
     const idx = indexOfId(decls.arr, id);
@@ -75,7 +148,13 @@ export function clearVariableDefault(document, id) {
         return false;
     const { default: _drop, ...rest } = decls.arr[idx];
     decls.arr[idx] = rest;
-    decls.htmlEl.setAttribute("data-composition-variables", JSON.stringify(decls.arr));
+    decls.declEl.setAttribute("data-composition-variables", JSON.stringify(decls.arr));
     return true;
 }
+// NOTE: #2098's Document-based helpers (listVariableDecls / declareVariableDecl /
+// removeVariableDecl) were removed in the #2098-reconciliation — they duplicated
+// the canonical declEl-based readVariableDeclarations / writeVariableDeclaration /
+// removeVariableDeclarationEntry below and predate template/fragment declaration
+// scope. The session conveniences (listVariables / removeVariable) delegate to
+// the canonical methods instead.
 //# sourceMappingURL=variableModel.js.map

package/dist/engine/variableModel.js.map

@@ -1 +1 @@
-{"version":3,"file":"variableModel.js","sourceRoot":"","sources":["../../src/engine/variableModel.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"variableModel.js","sourceRoot":"","sources":["../../src/engine/variableModel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,8EAA8E;AAC9E,sEAAsE;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAMxE,yEAAyE;AACzE,SAAS,SAAS,CAAC,MAAsB;IACvC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,4BAA4B,CAAC,CAAC;IAC9D,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAwB,EAAE,CAAC;AACnD,CAAC;AAED,SAAS,SAAS,CAAC,GAAmB,EAAE,EAAU;IAChD,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAClF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAsB;IAC7D,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,OAAO,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAsB,EACtB,EAAU;IAEV,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACrC,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAsB,EACtB,WAA6E;IAE7E,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,GAAG,GAAG,KAAK,EAAE,GAAG,IAAI,EAAE,CAAC;IAC7B,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAiB,EAAE,GAAG,WAAW,EAAE,CAAC;IAC/C,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QACZ,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACnB,CAAC;IACD,MAAM,CAAC,YAAY,CAAC,4BAA4B,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IACvE,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,8BAA8B,CAAC,MAAsB,EAAE,EAAU;IAC/E,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACrC,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1B,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACzB,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC,4BAA4B,CAAC,CAAC;IAC7D,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,4BAA4B,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAsB,EAAE,EAAU;IACpE,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACrC,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAsB,EACtB,EAAU,EACV,UAAmB;IAEnB,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACrC,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,yCAAyC;IACpE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAE,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IAC7D,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,4BAA4B,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACnF,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAsB,EAAE,EAAU;IACrE,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACrC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAE,IAAI,SAAS,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IAChF,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;IACpD,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAoB,CAAC;IACtC,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,4BAA4B,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACnF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kFAAkF;AAClF,iFAAiF;AACjF,mFAAmF;AACnF,iFAAiF;AACjF,+EAA+E;AAC/E,iCAAiC"}

package/dist/index.d.ts

@@ -1,8 +1,11 @@
 export type { HyperFramesElement, SdkDocument, OverrideSet, EditOp, ElasticHold, FontValue, ImageValue, GsapTweenSpec, HfId, JsonPatchOp, PatchEvent, PersistErrorEvent, ElementSnapshot, ElementTimingSnapshot, FindQuery, SelectionProxy, ElementHandle, Composition, CanResult, } from "./types.js";
 export { ORIGIN_APPLY_PATCHES, ORIGIN_LOCAL } from "./types.js";
+export type { CompositionVariable, CompositionVariableType, CompositionVariableBase, StringVariable, NumberVariable, ColorVariable, BooleanVariable, EnumVariable, FontVariable, ImageVariable, VariableValidationIssue, VariableUsageScan, } from "@hyperframes/core/variables";
+export type { VariableUsageReport } from "./types.js";
 export { UnsupportedOpError } from "./engine/mutate.js";
 export { buildDocument, buildRoots, flatElements } from "./document.js";
-export { isNewHostBoundary, bareId } from "./engine/model.js";
+export { isNewHostBoundary, bareId, resolveScoped, findById, escapeHfId } from "./engine/model.js";
+export { readVariableDefault } from "./engine/variableModel.js";
 export { openComposition } from "./session.js";
 export type { OpenCompositionOptions } from "./session.js";
 export { createHistory } from "./history.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,MAAM,EACN,WAAW,EACX,SAAS,EACT,UAAU,EACV,aAAa,EACb,IAAI,EACJ,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,SAAS,EACT,cAAc,EACd,aAAa,EACb,WAAW,EACX,SAAS,GACV,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAExE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEhF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAElF,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG/F,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,MAAM,EACN,WAAW,EACX,SAAS,EACT,UAAU,EACV,aAAa,EACb,IAAI,EACJ,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,SAAS,EACT,cAAc,EACd,aAAa,EACb,WAAW,EACX,SAAS,GACV,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAIhE,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,aAAa,EACb,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAExE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEnG,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEhF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAElF,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG/F,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -1,7 +1,8 @@
 export { ORIGIN_APPLY_PATCHES, ORIGIN_LOCAL } from "./types.js";
 export { UnsupportedOpError } from "./engine/mutate.js";
 export { buildDocument, buildRoots, flatElements } from "./document.js";
-export { isNewHostBoundary, bareId } from "./engine/model.js";
+export { isNewHostBoundary, bareId, resolveScoped, findById, escapeHfId } from "./engine/model.js";
+export { readVariableDefault } from "./engine/variableModel.js";
 export { openComposition } from "./session.js";
 export { createHistory } from "./history.js";
 export { createPersistQueue } from "./persist-queue.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAExE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAKxD,kGAAkG;AAClG,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAoBhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAExE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEnG,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAKxD,kGAAkG;AAClG,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAEV,WAAW,EAYX,WAAW,EAKZ,MAAM,YAAY,CAAC;AAGpB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAgB1E,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,iHAAiH;IACjH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,mFAAmF;IACnF,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC;IAC3B,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC;CACjB;AAynBD;;;;;;GAMG;AAEH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,sBAAsB,GAC5B,OAAO,CAAC,WAAW,CAAC,CAmCtB"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAEV,WAAW,EAYX,WAAW,EAMZ,MAAM,YAAY,CAAC;AAGpB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAuB1E,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,iHAAiH;IACjH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,mFAAmF;IACnF,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC;IAC3B,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC;CACjB;AA+wBD;;;;;;GAMG;AAEH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,sBAAsB,GAC5B,OAAO,CAAC,WAAW,CAAC,CAmCtB"}

package/dist/session.js

@@ -11,16 +11,22 @@ import { ORIGIN_APPLY_PATCHES, ORIGIN_LOCAL } from "./types.js";
 import { buildRoots, flatElements, parsedAnimationIds } from "./document.js";
 import { parseMutable } from "./engine/model.js";
 import { applyOp, validateOp } from "./engine/mutate.js";
-import { getGsapScript, resolveScoped } from "./engine/model.js";
+import { getGsapScript, resolveScoped, declarationElement } from "./engine/model.js";
 import { extractGsapLabels } from "@hyperframes/core/gsap-parser-acorn";
 import { stripEmbeddedRuntimeScripts } from "@hyperframes/core/compiler/html-document";
 import { parseStartExpression } from "@hyperframes/core/runtime/start-expression";
+import { readDeclaredDefaults, validateVariables, scanVariableUsage, } from "@hyperframes/core/variables";
+import { readVariableDeclarations } from "./engine/variableModel.js";
 import { serializeDocument } from "./engine/serialize.js";
 import { applyPatchesToDocument, applyOverrideSet } from "./engine/apply-patches.js";
 import { buildPatchEvent, pathToKey } from "./engine/patches.js";
 import { createHistory } from "./history.js";
 import { createPersistQueue } from "./persist-queue.js";
 // ─── Implementation ───────────────────────────────────────────────────────────
+/** Escape a string for literal use inside a RegExp. */
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
 class CompositionImpl {
     parsed;
     persist;
@@ -88,6 +94,131 @@ class CompositionImpl {
     setVariableValue(id, value) {
         this.dispatch({ type: "setVariableValue", id, value });
     }
+    // ── #2098 CRUD conveniences — thin aliases over the canonical surface below.
+    // They delegate so the per-file declaration-element scope (template/fragment
+    // sub-comps included) is resolved in exactly one place.
+    getVariableValue(id) {
+        return this.getVariableValues()[id];
+    }
+    listVariables() {
+        return this.getVariableDeclarations();
+    }
+    removeVariable(id) {
+        this.dispatch({ type: "removeVariable", id });
+    }
+    // ── Canonical declaration edit ops (this stack) ──
+    // declareVariable unified onto the {declaration} op payload (#2098 used
+    // {decl}); the method signature is identical, so #2098 callers are unaffected.
+    declareVariable(declaration) {
+        this.dispatch({ type: "declareVariable", declaration });
+    }
+    updateVariableDeclaration(id, declaration) {
+        this.dispatch({ type: "updateVariableDeclaration", id, declaration });
+    }
+    removeVariableDeclaration(id) {
+        this.dispatch({ type: "removeVariableDeclaration", id });
+    }
+    getVariableDeclarations() {
+        return readVariableDeclarations(declarationElement(this.parsed.document, this.parsed.wrapped));
+    }
+    getVariableValues(overrides) {
+        // THIS composition's own declared defaults (loose extraction: any entry with
+        // a string id + a `default` key, even ones the strict declaration parser
+        // drops) spread under the overrides. Scope note: this reads the composition's
+        // single declaration element only — NOT a union of every `[data-composition-
+        // variables]` in the document. The runtime's getVariables()
+        // (core/runtime/getVariables.ts) additionally walks inlined sub-composition
+        // declarers because it operates on the bundled multi-composition document;
+        // the SDK models one composition file, so per-file scope is intended.
+        const defaults = readDeclaredDefaults(declarationElement(this.parsed.document, this.parsed.wrapped));
+        return { ...defaults, ...(overrides ?? {}) };
+    }
+    validateVariableValues(values) {
+        return validateVariables(values, this.getVariableDeclarations());
+    }
+    /**
+     * Script scans are content-keyed (same rationale as _gsapLabelCache): the
+     * panel recomputes usage on every preview reload, and unchanged script text
+     * is the common case — never pay a second acorn parse for identical input.
+     */
+    _variableUsageScanCache = new Map();
+    // Scan/merge dispatcher — same complexity class as the suppressed
+    // variableUsage.ts classifiers it drives.
+    // fallow-ignore-next-line complexity
+    getVariableUsage() {
+        const usedIds = [];
+        const seen = new Set();
+        let scanIncomplete = false;
+        const freshCache = new Map();
+        // Inline scripts only — external src scripts aren't part of the document model.
+        for (const script of Array.from(this.parsed.document.querySelectorAll("script"))) {
+            if (script.getAttribute("src"))
+                continue;
+            const text = script.textContent ?? "";
+            // Direct global reads (window.__hfVariables / __hfVariablesByComp) are
+            // invisible to the getVariables() scanner — the report must degrade to
+            // a lower bound instead of confidently claiming declarations unused.
+            if (text.includes("__hfVariables"))
+                scanIncomplete = true;
+            if (!text.includes("getVariables"))
+                continue; // cheap pre-filter before an acorn parse
+            const scan = this._variableUsageScanCache.get(text) ?? scanVariableUsage(text);
+            freshCache.set(text, scan);
+            scanIncomplete = scanIncomplete || scan.scanIncomplete;
+            for (const id of scan.usedIds) {
+                if (!seen.has(id)) {
+                    seen.add(id);
+                    usedIds.push(id);
+                }
+            }
+        }
+        // Declarative bindings (data-var-src / data-var-text) are direct reads.
+        for (const el of Array.from(this.parsed.document.querySelectorAll("[data-var-src], [data-var-text]"))) {
+            for (const attr of ["data-var-src", "data-var-text"]) {
+                const id = el.getAttribute(attr)?.trim();
+                if (id && !seen.has(id)) {
+                    seen.add(id);
+                    usedIds.push(id);
+                }
+            }
+        }
+        this._variableUsageScanCache = freshCache;
+        const declaredIds = this.getVariableDeclarations().map((d) => d.id);
+        // The CSS compat channel counts as usage: a variable consumed only via
+        // var(--id) in stylesheets or inline styles must not be badged unused
+        // (removing it also removes the --{id} root prop and breaks the binding).
+        const cssText = this._collectCssText();
+        // Match var(--id) only at a custom-property-name boundary: the id must be
+        // followed by whitespace, a comma (fallback), or the closing paren — so id
+        // "foo" is NOT counted as used by an unrelated var(--foo-header). Ids are
+        // regex-escaped because a value read from disk may predate can()'s
+        // /^[A-Za-z_][A-Za-z0-9_-]*$/ enforcement and carry metacharacters.
+        const cssUsed = (id) => new RegExp(`var\\(\\s*--${escapeRegExp(id)}[\\s,)]`).test(cssText);
+        const declaredSet = new Set(declaredIds);
+        return {
+            usedIds,
+            unusedDeclarations: declaredIds.filter((id) => !seen.has(id) && !cssUsed(id)),
+            undeclaredReads: usedIds.filter((id) => !declaredSet.has(id)),
+            scanIncomplete,
+        };
+    }
+    /** All stylesheet + inline-style text, for var(--id) consumption checks. */
+    _collectCssText() {
+        const cssParts = [];
+        for (const styleEl of Array.from(this.parsed.document.querySelectorAll("style"))) {
+            cssParts.push(styleEl.textContent ?? "");
+        }
+        for (const el of Array.from(this.parsed.document.querySelectorAll("[style]"))) {
+            cssParts.push(el.getAttribute("style") ?? "");
+        }
+        return cssParts.join("\n");
+    }
+    setPreviewVariables(values) {
+        if (!this.preview?.setPreviewVariables)
+            return false;
+        this.preview.setPreviewVariables(values);
+        return true;
+    }
     // ── WS-C: timing accessors + typed setHold ───────────────────────────────────
     /**
      * Cache of parsed GSAP labels keyed by EXACT script text. extractGsapLabels does