@hyperframes/sdk 0.8.200 → 0.8.201

package/dist/engine/apply-patches.d.ts

@@ -17,6 +17,7 @@ import type { ParsedDocument } from "./model.js";
  */
 export declare function applyOverrideSet(parsed: ParsedDocument, overrides: OverrideSet): void;
 export declare function isElementSnapshotOverride(key: string, value: OverrideSet[string]): value is Record<string, unknown> & {
+    html: string;
     siblingIndex: number;
 };
 interface ApplyOptions {

package/dist/engine/apply-patches.js

@@ -102,6 +102,10 @@ export function applyOverrideSet(parsed, overrides) {
         const path = keyToPath(key);
         if (!path)
             continue;
+        if (value !== null &&
+            /^\/elements\/[^/]+$/.test(path) &&
+            !isElementSnapshotOverride(key, value))
+            continue;
         if (value === null) {
             patches.push({ op: "remove", path });
         }
@@ -127,7 +131,9 @@ export function applyOverrideSet(parsed, overrides) {
 export function isElementSnapshotOverride(key, value) {
     if (value === null || typeof value !== "object")
         return false;
-    return /^\/elements\/[^/]+$/.test(keyToPath(key) ?? "") && typeof value.siblingIndex === "number";
+    return (/^\/elements\/[^/]+$/.test(keyToPath(key) ?? "") &&
+        typeof value.html === "string" &&
+        typeof value.siblingIndex === "number");
 }
 function restoreOverridePositions(parsed, overrides) {
     const positions = [];

package/dist/engine/patches.d.ts

@@ -45,10 +45,7 @@ export declare function styleSheetPath(): string;
  * Returns null for paths that don't correspond to override-set entries.
  */
 export declare function pathToKey(path: string): string | null;
-/**
- * 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).
- */
+/** Map a stored override key to its RFC 6902 path when reopening a base document. */
 export declare function keyToPath(key: string): string | null;
 export declare function buildPatchEvent(forward: readonly JsonPatchOp[], inverse: readonly JsonPatchOp[], origin: unknown, opTypes: readonly string[]): PatchEvent;
 export declare function patchAdd(path: string, value: unknown): JsonPatchOp;

package/dist/engine/patches.js

@@ -129,31 +129,41 @@ export function pathToKey(path) {
         return "style.css";
     return null;
 }
-/**
- * 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.
+// Exhaustive element-key dispatch keeps both ID grammars on the same path rules.
 // fallow-ignore-next-line complexity
+function elementKeyToPath(key, allowDots = false) {
+    const separator = /\.(style|attr|timing|hold)\./.exec(key);
+    if (!separator) {
+        const id = key.endsWith(".text") ? key.slice(0, -5) : "";
+        return id && (allowDots || !id.includes(".")) ? textPath(id) : null;
+    }
+    const id = key.slice(0, separator.index);
+    const prop = key.slice(separator.index + separator[0].length);
+    if (!id || !prop || (!allowDots && id.includes(".")))
+        return null;
+    switch (separator[1]) {
+        case "style":
+            return stylePath(id, prop);
+        case "attr":
+            // Attribute names are already RFC 6902-encoded by pathToKey.
+            return `/elements/${escapeIdForPath(id)}/attributes/${prop}`;
+        case "timing":
+            if (prop === "start" || prop === "end" || prop === "duration" || prop === "trackIndex")
+                return timingPath(id, prop);
+            return null;
+        case "hold":
+            if (prop === "start" || prop === "end" || prop === "fill")
+                return holdPath(id, prop);
+            return null;
+        default:
+            return null;
+    }
+}
+/** Map a stored override key to its RFC 6902 path when reopening a base document. */
 export function keyToPath(key) {
-    const style = /^([^.]+)\.style\.(.+)$/.exec(key);
-    if (style?.[1] && style[2])
-        return stylePath(style[1], style[2]);
-    const text = /^([^.]+)\.text$/.exec(key);
-    if (text?.[1])
-        return textPath(text[1]);
-    const attr = /^([^.]+)\.attr\.(.+)$/.exec(key);
-    // The attr name segment in the key is already RFC 6902-encoded (pathToKey stored it verbatim).
-    // The id may be a scoped id (contains "/") so we must escape it, but must NOT re-escape
-    // the already-encoded attr segment. Reconstruct manually.
-    if (attr?.[1] && attr[2])
-        return `/elements/${escapeIdForPath(attr[1])}/attributes/${attr[2]}`;
-    const timing = /^([^.]+)\.timing\.(start|end|duration|trackIndex)$/.exec(key);
-    if (timing?.[1])
-        return timingPath(timing[1], timing[2]);
-    const hold = /^([^.]+)\.hold\.(start|end|fill)$/.exec(key);
-    if (hold?.[1])
-        return holdPath(hold[1], hold[2]);
+    const element = elementKeyToPath(key);
+    if (element)
+        return element;
     const varDecl = /^varDecl\.(.+)$/.exec(key);
     if (varDecl?.[1])
         return variableDeclPath(varDecl[1]);
@@ -167,10 +177,8 @@ export function keyToPath(key) {
         return gsapScriptPath();
     if (key === "style.css")
         return styleSheetPath();
-    // Bare element id — removal marker key.
-    if (!key.includes("."))
-        return elementPath(key);
-    return null;
+    // Existing namespaces keep precedence over the dotted-ID fallback.
+    return elementKeyToPath(key, true) ?? elementPath(key);
 }
 // ─── Patch event builder ──────────────────────────────────────────────────────
 export function buildPatchEvent(forward, inverse, origin, opTypes) {

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type { CompositionVariable, VariableValidationIssue } from "@hyperframes/core/variables";
+import type { CompositionVariable, FontValue, ImageValue, VariableValidationIssue } from "@hyperframes/core/variables";
 /**
  * Cross-referenced variable usage for a whole composition: the per-script
  * static scans merged and compared against the declared schema.
@@ -321,25 +321,7 @@ export interface ElasticHold {
     end: number;
     fill: "freeze" | "loop";
 }
-/**
- * Object value for a `font` variable (LOCKED §7 — object-valued, never a CSS string).
- * `name` is the CSS font-family value; `source` is the stylesheet URL to load.
- */
-export interface FontValue {
-    name: string;
-    source: string;
-}
-/**
- * Object value for an `image` variable (LOCKED §7 — object-valued, never a CSS string).
- * `url` is the image src. Add explicit optional fields here as consumers need them —
- * an open `[key: string]: unknown` index signature was dropped because it let any
- * `{url}`-shaped object through and swallowed key typos.
- */
-export interface ImageValue {
-    url: string;
-    alt?: string;
-    fit?: "cover" | "contain" | "fill" | "none" | "scale-down";
-}
+export type { FontValue, ImageValue } from "@hyperframes/core/variables";
 export interface GsapTweenSpec {
     method: "from" | "to" | "fromTo" | "set";
     position?: number | string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/sdk",
-  "version": "0.8.200",
+  "version": "0.8.201",
   "description": "Headless, framework-neutral HyperFrames composition editing engine",
   "repository": {
     "type": "git",
@@ -44,8 +44,8 @@
   },
   "dependencies": {
     "linkedom": "^0.18.12",
-    "@hyperframes/parsers": "0.8.200",
-    "@hyperframes/core": "0.8.200"
+    "@hyperframes/core": "0.8.201",
+    "@hyperframes/parsers": "0.8.201"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",