@cueframe/kernel 0.2.49 → 0.2.51

package/dist/primitives/captions.js

@@ -93,7 +93,20 @@ function assignTimeline(raw, lingerMs) {
 }
 
 // ../execution/primitives/src/captions/placement.ts
-function resolveCaptionPlacement(position, region) {
+var percent = (fraction) => `${Number((fraction * 100).toFixed(4))}%`;
+function resolveCaptionPlacement(position, region, authoredRegion) {
+  if (authoredRegion) {
+    return {
+      position: "absolute",
+      left: percent(authoredRegion.x),
+      top: percent(authoredRegion.y),
+      width: percent(authoredRegion.w),
+      height: percent(authoredRegion.h),
+      display: "flex",
+      justifyContent: "flex-start",
+      alignItems: "flex-start"
+    };
+  }
   const vertical = position === "top" ? { top: "8%" } : position === "center" ? { top: "50%", transform: "translateY(-50%)" } : position === "bottom" ? { bottom: "10%" } : region ? { bottom: `${Math.max(0, (1 - (region.y + region.h)) * 100)}%` } : { bottom: "10%" };
   return {
     position: "absolute",
@@ -153,16 +166,16 @@ function addTokenToBox(box, token, fontFamily, fontSize, fontWeight, emphasis) {
     fontWeight: String(tokenWeight)
   });
 }
-function makeBoxFactory(maxWidth, fontFamily, fontSize, fontWeight, emphasis) {
+function makeBoxFactory(maxWidth, maxLines, fontFamily, fontSize, fontWeight, emphasis) {
   return () => {
-    const box = fillTextBox({ maxBoxWidth: maxWidth, maxLines: 3 });
+    const box = fillTextBox({ maxBoxWidth: maxWidth, maxLines });
     return {
       add: (token) => !addTokenToBox(box, token, fontFamily, fontSize, fontWeight, emphasis).exceedsBox
     };
   };
 }
-function layoutTokensIntoLines(tokens, maxWidth, fontFamily, fontSize, fontWeight, emphasis) {
-  const box = fillTextBox({ maxBoxWidth: maxWidth, maxLines: 3 });
+function layoutTokensIntoLines(tokens, maxWidth, maxLines, fontFamily, fontSize, fontWeight, emphasis) {
+  const box = fillTextBox({ maxBoxWidth: maxWidth, maxLines });
   const lines = [[]];
   for (const token of tokens) {
     const result = addTokenToBox(box, token, fontFamily, fontSize, fontWeight, emphasis);
@@ -211,7 +224,15 @@ function Captions({
   const maxWidthPercent = style.maxWidthPercent ?? 80;
   const plateStyle = plateStyleFor(style.plate ?? "glass", style.backgroundColor);
   const fontSize = Math.round(height * (style.fontSize / 100));
-  const maxTextWidth = width * (maxWidthPercent / 100);
+  const authoredRegion = userStyle?.region;
+  const regionWidth = authoredRegion ? width * authoredRegion.w : width;
+  const maxTextWidth = authoredRegion ? Math.min(width * (maxWidthPercent / 100), regionWidth - fontSize * 1.6) : width * (maxWidthPercent / 100);
+  const availableHeight = authoredRegion ? height * authoredRegion.h - fontSize * 0.8 : Infinity;
+  const lineHeight = fontSize * Math.max(1, emphasisScale) * 1.2;
+  const maxLines = authoredRegion ? Math.min(3, Math.floor((availableHeight + fontSize * 0.25) / (lineHeight + fontSize * 0.25))) : 3;
+  if (authoredRegion && (maxTextWidth <= 0 || maxLines < 1)) {
+    throw new Error("Caption style.region is too small for one caption line at the authored font size");
+  }
   const { emphasisStartMs, annotateKind } = useMemo(() => {
     const emph = /* @__PURE__ */ new Set();
     const ann = /* @__PURE__ */ new Map();
@@ -228,10 +249,10 @@ function Captions({
   const pages = useMemo(
     () => paginateCaptionSegments(segments, {
       combineMs: COMBINE_TOKENS_MS,
-      makeBox: makeBoxFactory(maxTextWidth, style.fontFamily, fontSize, style.fontWeight, emphasisLayout),
+      makeBox: makeBoxFactory(maxTextWidth, maxLines, style.fontFamily, fontSize, style.fontWeight, emphasisLayout),
       lingerMs: CAPTION_LINGER_MS
     }),
-    [segments, maxTextWidth, fontSize, style.fontFamily, style.fontWeight, emphasisLayout]
+    [segments, maxTextWidth, maxLines, fontSize, style.fontFamily, style.fontWeight, emphasisLayout]
   );
   if (pages.length === 0) return null;
   const currentTimeMs = frame / fps * 1e3;
@@ -259,12 +280,13 @@ function Captions({
   const lines = layoutTokensIntoLines(
     currentPage.tokens,
     maxTextWidth,
+    maxLines,
     style.fontFamily,
     fontSize,
     style.fontWeight,
     emphasisLayout
   );
-  const wrapperStyle = resolveCaptionPlacement(userStyle?.position, region);
+  const wrapperStyle = resolveCaptionPlacement(userStyle?.position, region, authoredRegion);
   return /* @__PURE__ */ React.createElement(AbsoluteFill, { style: { pointerEvents: "none" } }, /* @__PURE__ */ React.createElement("div", { style: wrapperStyle }, /* @__PURE__ */ React.createElement(
     "div",
     {
@@ -272,12 +294,12 @@ function Captions({
         opacity: groupOpacity,
         display: "flex",
         flexDirection: "column",
-        alignItems: "center",
+        alignItems: authoredRegion ? "flex-start" : "center",
         gap: `${fontSize * 0.25}px`,
         padding: `${fontSize * 0.4}px ${fontSize * 0.8}px`,
         borderRadius: fontSize * 0.5,
         ...plateStyle,
-        maxWidth: `${maxWidthPercent}%`,
+        maxWidth: authoredRegion ? "100%" : `${maxWidthPercent}%`,
         boxSizing: "border-box"
       }
     },
@@ -317,7 +339,7 @@ function Captions({
           if (emphasisPlate && e && last && last.emph) last.tokens.push(t);
           else segs.push({ tokens: [t], emph: e });
         }
-        return /* @__PURE__ */ React.createElement("div", { key: lineIdx, style: { display: "flex", justifyContent: "center", alignItems: "baseline", gap: `${fontSize * 0.35}px` } }, segs.map((seg, si) => {
+        return /* @__PURE__ */ React.createElement("div", { key: lineIdx, style: { display: "flex", justifyContent: authoredRegion ? "flex-start" : "center", alignItems: "baseline", gap: `${fontSize * 0.35}px` } }, segs.map((seg, si) => {
           const first = seg.tokens[0];
           const { opacity, scale, y } = entranceOf(first, seg.emph);
           const entranceTransform = `translateY(${y}px) scale(${scale})`;

package/dist/render-harness.js

@@ -46,18 +46,22 @@ import {
   parseSceneComponentCaptureIntentV1,
   prepareSceneShotRenderInput,
   readSceneShotManifest
-} from "./chunk-4QMRY7KU.js";
+} from "./chunk-4CNJGY7P.js";
 import "./chunk-QH3YI3ND.js";
+import "./chunk-JPMVNMF3.js";
 import "./chunk-IMIUHG2E.js";
 import "./chunk-VZ7TYX6Z.js";
-import "./chunk-JPMVNMF3.js";
 import "./chunk-T56BK7NS.js";
 import "./chunk-KYRDKK2D.js";
+import "./chunk-6WQHVYJD.js";
+import "./chunk-Z6NY6MCL.js";
 import "./chunk-WREYUH2E.js";
+import "./chunk-ILO4NEZ3.js";
 import {
   CueframeError
 } from "./chunk-E63UEO5C.js";
 import "./chunk-7PA7FGLD.js";
+import "./chunk-VG2ND6PX.js";
 import {
   evaluateScene,
   parseSceneShotSpecV2,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cueframe/kernel",
-  "version": "0.2.49",
+  "version": "0.2.51",
   "type": "module",
   "description": "Publish-only aggregate of CueFrame's isomorphic kernel packages — composition, primitives, authoring, MCP, and friends shipped as one npm artifact. Members remain separate workspace packages; this only changes what ships.",
   "files": [
@@ -16,24 +16,24 @@
   "devDependencies": {
     "tsup": "^8.3.5",
     "typescript": "^5.9.3",
-    "@cueframe/account-model": "0.1.0",
     "@cueframe/animate": "0.1.0",
+    "@cueframe/cloud-import": "0.1.0",
     "@cueframe/authoring": "0.1.0",
+    "@cueframe/component-runtime": "0.1.0",
     "@cueframe/brand-derivation": "0.1.0",
-    "@cueframe/compose": "0.1.0",
-    "@cueframe/cloud-import": "0.1.0",
     "@cueframe/composition": "0.1.0",
     "@cueframe/composition-ops": "0.1.0",
-    "@cueframe/component-runtime": "0.1.0",
-    "@cueframe/core": "0.1.0",
-    "@cueframe/director": "0.1.0",
-    "@cueframe/errors": "0.1.0",
     "@cueframe/foundation": "0.1.0",
-    "@cueframe/mcp": "0.1.0",
+    "@cueframe/errors": "0.1.0",
     "@cueframe/media-model": "0.1.0",
+    "@cueframe/compose": "0.1.0",
+    "@cueframe/core": "0.1.0",
+    "@cueframe/account-model": "0.1.0",
+    "@cueframe/director": "0.1.0",
+    "@cueframe/plane": "0.1.0",
     "@cueframe/nle-export": "0.1.0",
+    "@cueframe/mcp": "0.1.0",
     "@cueframe/perception": "0.1.0",
-    "@cueframe/plane": "0.1.0",
     "@cueframe/primitives": "0.1.0",
     "@cueframe/render-harness": "0.1.0"
   },