@hyperframes/sdk 0.7.21 → 0.7.22

package/dist/editing/affordances.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Browser-only editing-affordance resolver. Reads live layout (getComputedStyle)
+ * from a rendered element and combines it with the SDK model element to call the
+ * pure core resolver. MUST NOT be imported on the static/Node SDK path — it
+ * touches getComputedStyle and only resolves meaningfully against a laid-out DOM.
+ */
+import { type EditingAffordances } from "@hyperframes/core/editing";
+import type { HyperFramesElement } from "../types.js";
+export interface AffordanceContext {
+    /** Studio-app concepts; default false for a generic consumer with no such notion. */
+    isCompositionHost?: boolean;
+    isCompositionRoot?: boolean;
+    isInsideLockedComposition?: boolean;
+    isMasterView?: boolean;
+}
+type ModelFacts = Pick<HyperFramesElement, "text" | "animationIds" | "start">;
+export declare function resolveElementAffordances(liveEl: HTMLElement, modelEl: ModelFacts | null, ctx?: AffordanceContext): EditingAffordances;
+export {};
+//# sourceMappingURL=affordances.d.ts.map

package/dist/editing/affordances.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"affordances.d.ts","sourceRoot":"","sources":["../../src/editing/affordances.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAA6B,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,qFAAqF;IACrF,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,KAAK,UAAU,GAAG,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,cAAc,GAAG,OAAO,CAAC,CAAC;AAE9E,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,UAAU,GAAG,IAAI,EAC1B,GAAG,GAAE,iBAAsB,GAC1B,kBAAkB,CAqCpB"}

package/dist/editing/affordances.js

@@ -0,0 +1,44 @@
+/**
+ * Browser-only editing-affordance resolver. Reads live layout (getComputedStyle)
+ * from a rendered element and combines it with the SDK model element to call the
+ * pure core resolver. MUST NOT be imported on the static/Node SDK path — it
+ * touches getComputedStyle and only resolves meaningfully against a laid-out DOM.
+ */
+import { resolveEditingAffordances } from "@hyperframes/core/editing";
+export function resolveElementAffordances(liveEl, modelEl, ctx = {}) {
+    const view = liveEl.ownerDocument.defaultView;
+    const cs = view ? view.getComputedStyle(liveEl) : null;
+    const computedStyles = cs
+        ? {
+            position: cs.getPropertyValue("position"),
+            left: cs.getPropertyValue("left"),
+            top: cs.getPropertyValue("top"),
+            width: cs.getPropertyValue("width"),
+            height: cs.getPropertyValue("height"),
+            transform: cs.getPropertyValue("transform"),
+        }
+        : undefined;
+    // Core reads position only from computedStyles; inlineStyles supplies the
+    // authored left/top/width/height that override the computed layout.
+    const inlineStyles = {
+        left: liveEl.style.getPropertyValue("left"),
+        top: liveEl.style.getPropertyValue("top"),
+        width: liveEl.style.getPropertyValue("width"),
+        height: liveEl.style.getPropertyValue("height"),
+    };
+    return resolveEditingAffordances({
+        hasStableTarget: true,
+        tag: liveEl.tagName.toLowerCase(),
+        inlineStyles,
+        computedStyles,
+        isCompositionHost: ctx.isCompositionHost ?? false,
+        isCompositionRoot: ctx.isCompositionRoot ?? false,
+        isInsideLockedComposition: ctx.isInsideLockedComposition ?? false,
+        isMasterView: ctx.isMasterView ?? false,
+        existsInSource: modelEl != null,
+        hasEditableText: modelEl?.text != null,
+        hasTimingStart: modelEl ? modelEl.start != null : liveEl.hasAttribute("data-start"),
+        animationCount: modelEl?.animationIds.length ?? 0,
+    });
+}
+//# sourceMappingURL=affordances.js.map

package/dist/editing/affordances.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"affordances.js","sourceRoot":"","sources":["../../src/editing/affordances.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,yBAAyB,EAA2B,MAAM,2BAA2B,CAAC;AAa/F,MAAM,UAAU,yBAAyB,CACvC,MAAmB,EACnB,OAA0B,EAC1B,MAAyB,EAAE;IAE3B,MAAM,IAAI,GAAG,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC;IAC9C,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACvD,MAAM,cAAc,GAAuC,EAAE;QAC3D,CAAC,CAAC;YACE,QAAQ,EAAE,EAAE,CAAC,gBAAgB,CAAC,UAAU,CAAC;YACzC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC;YACjC,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC;YAC/B,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC;YACnC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC;YACrC,SAAS,EAAE,EAAE,CAAC,gBAAgB,CAAC,WAAW,CAAC;SAC5C;QACH,CAAC,CAAC,SAAS,CAAC;IAEd,0EAA0E;IAC1E,oEAAoE;IACpE,MAAM,YAAY,GAA2B;QAC3C,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC;QAC3C,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,KAAK,CAAC;QACzC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC;QAC7C,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,QAAQ,CAAC;KAChD,CAAC;IAEF,OAAO,yBAAyB,CAAC;QAC/B,eAAe,EAAE,IAAI;QACrB,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE;QACjC,YAAY;QACZ,cAAc;QACd,iBAAiB,EAAE,GAAG,CAAC,iBAAiB,IAAI,KAAK;QACjD,iBAAiB,EAAE,GAAG,CAAC,iBAAiB,IAAI,KAAK;QACjD,yBAAyB,EAAE,GAAG,CAAC,yBAAyB,IAAI,KAAK;QACjE,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,KAAK;QACvC,cAAc,EAAE,OAAO,IAAI,IAAI;QAC/B,eAAe,EAAE,OAAO,EAAE,IAAI,IAAI,IAAI;QACtC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC;QACnF,cAAc,EAAE,OAAO,EAAE,YAAY,CAAC,MAAM,IAAI,CAAC;KAClD,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/sdk",
-  "version": "0.7.21",
+  "version": "0.7.22",
   "description": "Headless, framework-neutral HyperFrames composition editing engine",
   "repository": {
     "type": "git",
@@ -29,6 +29,10 @@
     "./adapters/headless": {
       "import": "./dist/adapters/headless.js",
       "types": "./dist/adapters/headless.d.ts"
+    },
+    "./editing": {
+      "import": "./dist/editing/affordances.js",
+      "types": "./dist/editing/affordances.d.ts"
     }
   },
   "publishConfig": {
@@ -36,11 +40,12 @@
   },
   "dependencies": {
     "linkedom": "^0.18.12",
-    "@hyperframes/parsers": "0.7.21",
-    "@hyperframes/core": "0.7.21"
+    "@hyperframes/core": "0.7.22",
+    "@hyperframes/parsers": "0.7.22"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",
+    "happy-dom": "^20.9.0",
     "typescript": "^5.0.0",
     "vitest": "^3.2.4"
   },