@cueframe/kernel 0.0.1

package/dist/chunk-BRKJKB33.js

@@ -0,0 +1,683 @@
+import {
+  apcaLcFromLuminance,
+  clampToFloor,
+  deriveContrastSafe,
+  relativeLuminance
+} from "./chunk-V43Y7IE4.js";
+import {
+  FLOORS
+} from "./chunk-JF4JJAFP.js";
+
+// ../composition/src/projection/brandKit.ts
+var LOGO_DEFAULT_PLACEMENT = "br";
+var LOGO_DEFAULT_SIZE_PCT = 8;
+var INTRO_OUTRO_CARD_DEFAULT_MS = 1500;
+var WATERMARK_DEFAULT_OPACITY = 0.5;
+var WATERMARK_DEFAULT_PLACEMENT = "br";
+function resolveIntroOutro(io) {
+  if (!io) return void 0;
+  const durationMs = io.durationMs ?? (io.kind === "card" ? INTRO_OUTRO_CARD_DEFAULT_MS : void 0);
+  return {
+    kind: io.kind,
+    ...io.src != null ? { src: io.src } : {},
+    ...io.title != null ? { title: io.title } : {},
+    ...io.subtitle != null ? { subtitle: io.subtitle } : {},
+    ...durationMs != null ? { durationMs } : {}
+  };
+}
+function resolveBrandKit(kit, compositionWidth) {
+  const safe = deriveContrastSafe({
+    background: kit.colors.background,
+    text: kit.colors.text,
+    accent: kit.colors.accent
+  });
+  const colors = {
+    primary: kit.colors.primary ?? kit.colors.accent,
+    secondary: kit.colors.secondary ?? kit.colors.accent,
+    accent: kit.colors.accent,
+    background: safe.background,
+    text: safe.text,
+    // De-emphasis mix faded toward background, RE-CLAMPED to the non-body floor:
+    // for a hostile (near-floor) brand the 40% fade can drop below Lc60, so the
+    // clamp forward-corrects it back up to legibility. For a legible brand the
+    // mix already clears the floor and the clamp is a no-op.
+    textMuted: kit.colors.textMuted ?? clampToFloor(colorMix(safe.text, safe.background, 0.4), safe.background, FLOORS.nonBody),
+    border: kit.colors.border ?? colorMix(safe.text, safe.background, 0.15),
+    textOnMedia: safe.captionFg,
+    // Tier-2 core: author override wins, else the contrast-safe derived value.
+    surface: kit.colors.surface ?? safe.surface,
+    card: kit.colors.card ?? safe.card,
+    gridLine: kit.colors.gridLine ?? safe.gridLine,
+    accentMuted: kit.colors.accentMuted ?? safe.accentMuted,
+    textOnAccent: kit.colors.textOnAccent ?? safe.textOnAccent,
+    textOnSurface: kit.colors.textOnSurface ?? safe.textOnSurface
+  };
+  const fonts = {
+    heading: kit.fonts.heading,
+    body: kit.fonts.body ?? kit.fonts.heading,
+    caption: kit.fonts.caption ?? kit.fonts.body ?? kit.fonts.heading
+  };
+  const spacing = {
+    base: kit.spacing?.base ?? compositionWidth * 0.03,
+    lg: kit.spacing?.lg ?? compositionWidth * 0.06,
+    sm: kit.spacing?.sm ?? compositionWidth * 0.015
+  };
+  const sizing = {
+    fontSizeHeading: kit.sizing?.fontSizeHeading ?? compositionWidth * 0.06,
+    fontSizeBody: kit.sizing?.fontSizeBody ?? compositionWidth * 0.035,
+    fontSizeLabel: kit.sizing?.fontSizeLabel ?? compositionWidth * 0.025,
+    borderRadius: kit.sizing?.borderRadius ?? compositionWidth * 0.01
+  };
+  const motion = {
+    duration: kit.motion?.duration ?? 200,
+    easing: kit.motion?.easing ?? "ease-out",
+    entrance: kit.motion?.entrance ?? "none",
+    staggerMs: kit.motion?.staggerMs ?? 90,
+    exitMs: kit.motion?.exitMs ?? 0
+  };
+  const captionBaseFamily = kit.captionProfile?.fontFamily ?? fonts.caption.family;
+  const cp = kit.captionProfile;
+  const caption = {
+    fg: cp?.emphasisColor ? clampToFloor(cp.emphasisColor, safe.captionScrim, FLOORS.body) : safe.captionFg,
+    scrim: safe.captionScrim,
+    // Base + highlight color are forward-corrected to the body floor over the
+    // scrim, same guard as emphasisColor→fg (an authored accent that fails APCA
+    // is clamped UP to legibility, never rendered below the floor).
+    ...cp?.color ? { color: clampToFloor(cp.color, safe.captionScrim, FLOORS.body) } : {},
+    ...cp?.highlightColor ? { highlightColor: clampToFloor(cp.highlightColor, safe.captionScrim, FLOORS.body) } : {},
+    ...cp?.plate ? { plate: cp.plate } : {},
+    ...cp?.entrance ? { entrance: cp.entrance } : {},
+    ...cp?.entranceMs != null ? { entranceMs: cp.entranceMs } : {},
+    ...cp?.entranceStaggerMs != null ? { entranceStaggerMs: cp.entranceStaggerMs } : {},
+    ...cp?.exitMs != null ? { exitMs: cp.exitMs } : {},
+    ...captionBaseFamily ? { fontFamily: captionBaseFamily } : {},
+    ...cp?.emphasisFontFamily ? { emphasisFontFamily: cp.emphasisFontFamily } : {},
+    ...cp?.emphasisScale != null ? { emphasisScale: cp.emphasisScale } : {},
+    ...cp?.emphasisFontWeight != null ? { emphasisFontWeight: cp.emphasisFontWeight } : {},
+    ...cp?.emphasisFontStyle ? { emphasisFontStyle: cp.emphasisFontStyle } : {},
+    ...cp?.emphasisTextTransform ? { emphasisTextTransform: cp.emphasisTextTransform } : {},
+    ...cp?.emphasisLetterSpacing != null ? { emphasisLetterSpacing: cp.emphasisLetterSpacing } : {},
+    ...cp?.emphasisPlate != null ? { emphasisPlate: cp.emphasisPlate } : {},
+    ...cp?.emphasisPlateColor ? { emphasisPlateColor: cp.emphasisPlateColor } : {},
+    ...cp?.emphasisPlateTextColor ? { emphasisPlateTextColor: cp.emphasisPlateTextColor } : {}
+  };
+  const logo = kit.logo ? {
+    src: kit.logo.src,
+    ...kit.logo.alt != null ? { alt: kit.logo.alt } : {},
+    placement: kit.logo.placement ?? LOGO_DEFAULT_PLACEMENT,
+    sizePct: kit.logo.sizePct ?? LOGO_DEFAULT_SIZE_PCT
+  } : void 0;
+  const intro = resolveIntroOutro(kit.intro);
+  const outro = resolveIntroOutro(kit.outro);
+  const watermark = kit.watermark ? {
+    src: kit.watermark.src,
+    opacity: kit.watermark.opacity ?? WATERMARK_DEFAULT_OPACITY,
+    placement: kit.watermark.placement ?? WATERMARK_DEFAULT_PLACEMENT
+  } : void 0;
+  const language = kit.exemplarKeys && kit.exemplarKeys.length > 0 ? {
+    exemplarKeys: kit.exemplarKeys,
+    ...kit.contactSheetKey ? { contactSheetKey: kit.contactSheetKey } : {},
+    motifs: kit.motifs ?? [],
+    ...kit.styleRubric ? { styleRubric: kit.styleRubric } : {},
+    ...kit.density ? { density: kit.density } : {}
+  } : void 0;
+  return {
+    id: kit.id,
+    name: kit.name,
+    colors,
+    caption,
+    fonts,
+    spacing,
+    sizing,
+    motion,
+    ...logo ? { logo } : {},
+    ...intro ? { intro } : {},
+    ...outro ? { outro } : {},
+    ...watermark ? { watermark } : {},
+    ...language ? { language } : {},
+    ...kit.audio ? { audio: kit.audio } : {}
+  };
+}
+var BRAND_TOKEN_ROOT_KEYS = [
+  "colors",
+  "caption",
+  "fonts",
+  "spacing",
+  "sizing",
+  "motion"
+];
+var BRAND_TOKEN_REFERENCE_KIT = {
+  id: "reference",
+  name: "reference",
+  colors: {
+    primary: "#3b82f6",
+    accent: "#22c55e",
+    background: "#0b0b0f",
+    text: "#f5f5f7"
+  },
+  fonts: { heading: { kind: "system", family: "Inter" } }
+};
+var BRAND_TOKEN_REFERENCE_WIDTH = 1920;
+function collectBrandLeafPaths(value, prefix, out) {
+  if (value === null || value === void 0) return;
+  if (typeof value === "object") {
+    if (Array.isArray(value)) return;
+    for (const [k, v] of Object.entries(value)) {
+      collectBrandLeafPaths(v, prefix ? `${prefix}.${k}` : k, out);
+    }
+    return;
+  }
+  out.push(prefix);
+}
+function buildBrandTokenRefs() {
+  const ref = resolveBrandKit(
+    BRAND_TOKEN_REFERENCE_KIT,
+    BRAND_TOKEN_REFERENCE_WIDTH
+  );
+  const paths = [];
+  for (const root of BRAND_TOKEN_ROOT_KEYS) {
+    collectBrandLeafPaths(ref[root], root, paths);
+  }
+  return paths.map((p) => `$brand:${p}`).sort();
+}
+var BRAND_TOKEN_REFS = Object.freeze(
+  buildBrandTokenRefs()
+);
+function colorMix(a, b, ratio) {
+  const aRgb = parseHex(a);
+  const bRgb = parseHex(b);
+  if (!aRgb || !bRgb) return a;
+  const clamped = Math.max(0, Math.min(1, ratio));
+  const inv = 1 - clamped;
+  const r = Math.round(aRgb.r * inv + bRgb.r * clamped);
+  const g = Math.round(aRgb.g * inv + bRgb.g * clamped);
+  const blue = Math.round(aRgb.b * inv + bRgb.b * clamped);
+  return "#" + [r, g, blue].map((v) => v.toString(16).padStart(2, "0")).join("");
+}
+function parseHex(input) {
+  if (typeof input !== "string") return null;
+  const s = input.trim().toLowerCase();
+  if (!s.startsWith("#")) return null;
+  const hex = s.slice(1);
+  if (hex.length === 3) {
+    return {
+      r: parseInt(hex[0] + hex[0], 16),
+      g: parseInt(hex[1] + hex[1], 16),
+      b: parseInt(hex[2] + hex[2], 16)
+    };
+  }
+  if (hex.length === 6) {
+    return {
+      r: parseInt(hex.slice(0, 2), 16),
+      g: parseInt(hex.slice(2, 4), 16),
+      b: parseInt(hex.slice(4, 6), 16)
+    };
+  }
+  return null;
+}
+function resolveBrandRef(refOrValue, kit) {
+  if (typeof refOrValue !== "string") return null;
+  if (!refOrValue.startsWith("$brand:")) return null;
+  const path = refOrValue.slice("$brand:".length);
+  if (!path) return null;
+  const segments = path.split(".");
+  let cursor = kit;
+  for (const seg of segments) {
+    if (cursor == null || typeof cursor !== "object") return null;
+    cursor = cursor[seg];
+  }
+  if (cursor == null) return null;
+  if (typeof cursor === "object") return null;
+  return cursor;
+}
+function resolveBrandRefsDeep(value, kit) {
+  if (Array.isArray(value)) {
+    return value.map((v) => resolveBrandRefsDeep(v, kit));
+  }
+  if (value !== null && typeof value === "object") {
+    const out = {};
+    for (const [k, v] of Object.entries(value)) {
+      out[k] = resolveBrandRefsDeep(v, kit);
+    }
+    return out;
+  }
+  if (typeof value === "string") {
+    if (value.startsWith("\\$brand:")) {
+      return value.slice(1);
+    }
+    if (value.startsWith("$brand:")) {
+      const resolved = resolveBrandRef(value, kit);
+      return resolved ?? value;
+    }
+    return value;
+  }
+  return value;
+}
+function cssLayoutVars(tokens, kit) {
+  if (!tokens) return {};
+  const resolved = kit ? resolveBrandRefsDeep(tokens, kit) : tokens;
+  const vars = {};
+  for (const [k, v] of Object.entries(resolved)) {
+    if (typeof v === "string" && !v.startsWith("$brand:")) vars[`--cf-${k}`] = v;
+  }
+  return vars;
+}
+function componentBrandPalette(kit) {
+  return {
+    primary: kit.colors.primary,
+    secondary: kit.colors.secondary,
+    accent: kit.colors.accent,
+    accentMuted: kit.colors.accentMuted,
+    background: kit.colors.background,
+    surface: kit.colors.surface,
+    card: kit.colors.card,
+    border: kit.colors.border,
+    gridLine: kit.colors.gridLine,
+    text: kit.colors.text,
+    textMuted: kit.colors.textMuted,
+    textOnMedia: kit.colors.textOnMedia,
+    textOnAccent: kit.colors.textOnAccent,
+    textOnSurface: kit.colors.textOnSurface,
+    // A FontRef family can be undefined (unresolved) — hand the component an empty
+    // string so `fontFamily: props.brand.heading` falls to the browser default,
+    // never the literal "undefined". Mirrors cssLayoutVars dropping unresolved refs.
+    heading: kit.fonts.heading.family ?? "",
+    body: kit.fonts.body.family ?? "",
+    caption: kit.fonts.caption.family ?? ""
+  };
+}
+
+// ../composition/src/projection/safe-zones.ts
+var SAFE_ZONE_PROFILE_VERSION = "safezones-v2-2026.06.05";
+function inset(frac) {
+  const m = (1 - frac) / 2;
+  return { x: m, y: m, w: frac, h: frac };
+}
+var TITLE_SAFE_FRAC = 0.9;
+var ACTION_SAFE_FRAC = 0.93;
+function broadcast() {
+  return { exclusions: [], titleSafe: inset(TITLE_SAFE_FRAC), actionSafe: inset(ACTION_SAFE_FRAC) };
+}
+var PROFILES = {
+  tiktok: {
+    "9:16": [
+      { x: 0, y: 0.82, w: 1, h: 0.18 },
+      // bottom username/caption strip
+      { x: 0.86, y: 0.45, w: 0.14, h: 0.4 },
+      // right action rail (like/comment/share)
+      { x: 0, y: 0, w: 1, h: 0.06 }
+      // top (following/for-you tabs)
+    ]
+  },
+  reels: {
+    "9:16": [
+      { x: 0, y: 0.8, w: 1, h: 0.2 },
+      // bottom caption + audio strip
+      { x: 0.85, y: 0.42, w: 0.15, h: 0.42 }
+      // right action rail
+    ]
+  },
+  shorts: {
+    "9:16": [
+      { x: 0, y: 0.84, w: 1, h: 0.16 },
+      // bottom title/channel strip
+      { x: 0.88, y: 0.4, w: 0.12, h: 0.4 }
+      // right action rail
+    ]
+  }
+};
+var PLATFORM_ALIASES = {
+  ig: "reels",
+  instagram: "reels",
+  reels: "reels",
+  igreels: "reels",
+  yt: "shorts",
+  youtube: "shorts",
+  ytshorts: "shorts",
+  shorts: "shorts",
+  tiktok: "tiktok",
+  tt: "tiktok"
+};
+function normalizePlatform(platform) {
+  const k = (platform ?? "").trim().toLowerCase();
+  return PLATFORM_ALIASES[k] ?? k;
+}
+function lookupSafeZones(platform, aspect) {
+  const base = broadcast();
+  const key = normalizePlatform(platform);
+  const exclusions = PROFILES[key]?.[aspect] ?? unionExclusionsForAspect(aspect);
+  return { ...base, exclusions: exclusions.map((r) => ({ ...r })) };
+}
+function unionExclusionsForAspect(aspect) {
+  const all = [];
+  for (const platform of Object.keys(PROFILES)) {
+    const ex = PROFILES[platform]?.[aspect];
+    if (ex) all.push(...ex);
+  }
+  return all;
+}
+
+// ../composition/src/projection/composition-floor.ts
+var FLOOR_VERSION = "floor-v6-2026.06.09";
+var FACE_PADDING = { top: 0.6, bottom: 0.3, side: 0.25 };
+var CAPTION_LC_FLOOR = 60;
+var MIN_ZOOM = 0.4;
+var clamp01 = (v) => Math.max(0, Math.min(1, v));
+function faceKeepOut(face, depthMode = false) {
+  if (!face) return null;
+  const padX = FACE_PADDING.side * face.w;
+  const top = FACE_PADDING.top * face.h;
+  const bottom = depthMode ? 0 : FACE_PADDING.bottom * face.h;
+  const x = clamp01(face.x - padX);
+  const y = clamp01(face.y - top);
+  const right = clamp01(face.x + face.w + padX);
+  const bot = clamp01(face.y + face.h + bottom);
+  return { x, y, w: right - x, h: bot - y };
+}
+function boundingBox(rects) {
+  const x = Math.min(...rects.map((r) => r.x));
+  const y = Math.min(...rects.map((r) => r.y));
+  const right = Math.max(...rects.map((r) => r.x + r.w));
+  const bot = Math.max(...rects.map((r) => r.y + r.h));
+  return { x, y, w: right - x, h: bot - y };
+}
+function unionFaceKeepOutSeries(subjects, depthMode = false) {
+  const frameCount = subjects.reduce((m, s) => Math.max(m, s.faceBoxSeries.length), 0);
+  const series = [];
+  for (let f = 0; f < frameCount; f++) {
+    const present = [];
+    for (const s of subjects) {
+      const k = faceKeepOut(s.faceBoxSeries[f] ?? null, depthMode);
+      if (k) present.push(k);
+    }
+    series.push(present.length ? boundingBox(present) : null);
+  }
+  return series;
+}
+function activeFaceKeepOutSeries(subjects, depthMode = false) {
+  const frameCount = subjects.reduce((m, s) => Math.max(m, s.faceBoxSeries.length), 0);
+  const series = [];
+  for (let f = 0; f < frameCount; f++) {
+    let active = subjects.find(
+      (s) => (s.activeWindows ?? []).some((w) => f >= w.startFrame && f < w.endFrame)
+    );
+    if (!active || active.faceBoxSeries[f] == null) {
+      active = subjects.find((s) => s.faceBoxSeries[f] != null);
+    }
+    series.push(active ? faceKeepOut(active.faceBoxSeries[f] ?? null, depthMode) : null);
+  }
+  return series;
+}
+function resolveLayoutIntent(subjects) {
+  if (subjects.length <= 1) return "single-focus";
+  const anyActiveWindows = subjects.some((s) => (s.activeWindows?.length ?? 0) > 0);
+  return anyActiveWindows ? "speaker-switch" : "split";
+}
+function reframeYield(input) {
+  const { maxFaceKeepOut: f, neededBand } = input;
+  if (neededBand <= 0) return { kind: "transform", dy: 0, zoom: 1 };
+  const bandBelow = 1 - (f.y + f.h);
+  if (bandBelow >= neededBand) return { kind: "transform", dy: 0, zoom: 1 };
+  const dyNeeded = neededBand - bandBelow;
+  const headroomAbove = f.y;
+  if (dyNeeded <= headroomAbove) return { kind: "transform", dy: -dyNeeded, zoom: 1 };
+  const zoom = (f.h - (dyNeeded - headroomAbove)) / f.h;
+  if (zoom > MIN_ZOOM) return { kind: "transform", dy: -headroomAbove, zoom };
+  return { kind: "mat", rect: { x: 0, y: 1 - neededBand, w: 1, h: neededBand } };
+}
+function reframeYieldTop(input) {
+  const { maxFaceKeepOut: f, neededBand } = input;
+  if (neededBand <= 0) return { kind: "transform", dy: 0, zoom: 1 };
+  const bandAbove = f.y;
+  if (bandAbove >= neededBand) return { kind: "transform", dy: 0, zoom: 1 };
+  const dyNeeded = neededBand - bandAbove;
+  const roomBelow = 1 - (f.y + f.h);
+  if (dyNeeded <= roomBelow) return { kind: "transform", dy: dyNeeded, zoom: 1 };
+  const zoom = (f.h - (dyNeeded - roomBelow)) / f.h;
+  if (zoom > MIN_ZOOM) return { kind: "transform", dy: roomBelow, zoom };
+  return null;
+}
+var SILHOUETTE_TO_KEEPOUT_W = 1.5;
+var COVIEW_MAX_SILHOUETTE_W = 0.45;
+function coViewReframe(maxFaceKeepOut) {
+  const silhouetteW = SILHOUETTE_TO_KEEPOUT_W * maxFaceKeepOut.w;
+  if (silhouetteW <= COVIEW_MAX_SILHOUETTE_W) return { kind: "transform", dy: 0, zoom: 1 };
+  const zoom = Math.max(MIN_ZOOM, COVIEW_MAX_SILHOUETTE_W / silhouetteW);
+  return { kind: "transform", dy: 0, zoom };
+}
+var MIN_ACTIVE_SPEAKER_PRESENCE = 0.6;
+var COVIEW_MIN_BAND_COVERAGE = 0.15;
+var COVIEW_MAX_BAND_COVERAGE = 0.7;
+function captionsBehindEligible(input) {
+  if (input.activeSpeakerPresenceFraction < MIN_ACTIVE_SPEAKER_PRESENCE) {
+    return { eligible: false, reason: "no-active-speaker" };
+  }
+  if (input.activeBandCoverage != null) {
+    if (input.activeBandCoverage < COVIEW_MIN_BAND_COVERAGE) {
+      return { eligible: false, reason: "coverage-too-low" };
+    }
+    if (input.activeBandCoverage > COVIEW_MAX_BAND_COVERAGE) {
+      return { eligible: false, reason: "coverage-too-high" };
+    }
+  }
+  if (!input.legible) {
+    return { eligible: false, reason: "illegible" };
+  }
+  return { eligible: true, reason: "eligible" };
+}
+var CENTER = 0.5;
+var MIN_CAPTION_WIDTH = 0.5;
+var straddlesCentre = (r) => r.x < CENTER && r.x + r.w > CENTER;
+function placeInLegalArea(el, b) {
+  const all = [...b.faceKeepOut, ...b.safeZones];
+  const bands = all.filter(straddlesCentre);
+  const sideRegions = all.filter((r) => !straddlesCentre(r));
+  const spans = bands.map((r) => [r.y, r.y + r.h]).sort((a, c) => a[0] - c[0]);
+  const merged = [];
+  for (const s of spans) {
+    const last = merged[merged.length - 1];
+    if (last && s[0] <= last[1]) last[1] = Math.max(last[1], s[1]);
+    else merged.push([s[0], s[1]]);
+  }
+  const gaps = [];
+  let cursor = 0;
+  for (const [a, c] of merged) {
+    if (a - cursor >= el.minH) gaps.push([cursor, a]);
+    cursor = Math.max(cursor, c);
+  }
+  if (1 - cursor >= el.minH) gaps.push([cursor, 1]);
+  if (gaps.length === 0) return null;
+  const pick = el.anchor === "top" ? gaps[0] : el.anchor === "free" || el.anchor === "left" || el.anchor === "right" ? gaps.reduce((m, g) => g[1] - g[0] > m[1] - m[0] ? g : m) : gaps[gaps.length - 1];
+  const isBottom = el.anchor === "bottom" || el.anchor === "lower-third";
+  const y = isBottom ? pick[1] - el.minH : pick[0];
+  let leftBound = 0;
+  let rightBound = 1;
+  for (const r of sideRegions) {
+    const overlapsBand = r.y < y + el.minH && r.y + r.h > y;
+    if (!overlapsBand) continue;
+    if (r.x + r.w <= CENTER) leftBound = Math.max(leftBound, r.x + r.w);
+    else if (r.x >= CENTER) rightBound = Math.min(rightBound, r.x);
+  }
+  const avail = rightBound - leftBound;
+  const w = Math.min(avail, Math.min(0.92, Math.max(el.minW, 0.8)));
+  if (w < MIN_CAPTION_WIDTH) return null;
+  const x = leftBound + (avail - w) / 2;
+  return { x, y, w, h: el.minH };
+}
+function resolveCaptionRegion(input) {
+  const sz = lookupSafeZones(input.platform ?? "", input.aspect);
+  const ext = input.captionExtent ?? { w: 0.8, h: 0.15 };
+  const region = placeInLegalArea(
+    { id: "captions", anchor: input.anchor ?? "lower-third", minH: ext.h, minW: ext.w },
+    { faceKeepOut: [], safeZones: sz.exclusions }
+  );
+  return region ?? { x: 0.1, y: clamp01(1 - ext.h), w: ext.w, h: ext.h };
+}
+function resolveOverlayRegion(input) {
+  const sz = lookupSafeZones(input.platform ?? "", input.aspect);
+  const ext = input.extent ?? { w: 0.7, h: 0.35 };
+  const blockers = input.captionRegion ? [input.captionRegion] : [];
+  const region = placeInLegalArea(
+    { id: "overlay", anchor: "free", minH: ext.h, minW: ext.w },
+    { faceKeepOut: [], safeZones: [...sz.exclusions, ...blockers] }
+  );
+  return region ?? { x: 0.1, y: clamp01((sz.exclusions.find((r) => r.y === 0)?.h ?? 0) + 0.02), w: 0.8, h: 0.3 };
+}
+var WHITE_POLE = "#FFFFFF";
+function decideLegibility(backdrop, textColor = WHITE_POLE) {
+  const textY = relativeLuminance(textColor);
+  const worst = backdrop.tiles.reduce(
+    (m, tileY) => Math.min(m, apcaLcFromLuminance(textY, tileY)),
+    Number.POSITIVE_INFINITY
+  );
+  if (worst >= CAPTION_LC_FLOOR) return { lcTarget: CAPTION_LC_FLOOR, remedy: "none" };
+  return { lcTarget: CAPTION_LC_FLOOR, remedy: "scrim" };
+}
+function sampleFrames(win, k = 5) {
+  const { startFrame: start, endFrame: end } = win;
+  const span = Math.max(0, end - start);
+  const n = Math.max(1, Math.min(k, span || 1));
+  if (n === 1) return [start];
+  return Array.from({ length: n }, (_, i) => Math.round(start + span * i / (n - 1)));
+}
+function resolveOne(el, region, input) {
+  const legibility = el.hasText ? decideLegibility(input.backdrop(region, sampleFrames(el.timeWindow)), el.textColor) : { lcTarget: CAPTION_LC_FLOOR, remedy: "none" };
+  return { id: el.id, region, legibility };
+}
+function resolveCompositionFloor(input) {
+  const layout = resolveLayoutIntent(input.subjects);
+  const diagnostics = {
+    fallbacksTaken: [],
+    droppedElements: [],
+    matApplied: false,
+    layout
+  };
+  let effectiveDepthMode = input.depthMode ?? false;
+  if (effectiveDepthMode && input.captionsBehind) {
+    const elig = captionsBehindEligible({
+      activeSpeakerPresenceFraction: input.captionsBehind.activeSpeakerPresenceFraction,
+      activeBandCoverage: input.captionsBehind.activeBandCoverage,
+      legible: true
+    });
+    if (!elig.eligible) {
+      effectiveDepthMode = false;
+      diagnostics.fallbacksTaken.push(`captions-behind-ineligible:${elig.reason}`);
+    }
+  }
+  const keepOutSeries = layout === "speaker-switch" ? activeFaceKeepOutSeries(input.subjects, effectiveDepthMode) : unionFaceKeepOutSeries(input.subjects, effectiveDepthMode);
+  const present = keepOutSeries.filter((r) => r !== null);
+  const clipKeepOut = present.length ? boundingBox(present) : { x: 0.3, y: 0.3, w: 0.4, h: 0.4 };
+  if (!present.length) diagnostics.fallbacksTaken.push("no-face-center-band");
+  if (layout === "split" || layout === "stacked") {
+    diagnostics.fallbacksTaken.push(`multi-subject-union-placement:${layout}`);
+  }
+  const sz = lookupSafeZones(input.destination.platform, input.destination.aspect);
+  const requiredBand = Math.max(
+    0,
+    ...input.elements.filter((e) => e.required).map((e) => e.measuredExtent.h)
+  );
+  const captionEl = input.elements.find((e) => e.kind === "caption");
+  let effectiveElements = input.elements;
+  let reframe;
+  if (effectiveDepthMode && captionEl?.preferredRegion === "top") {
+    const topYield = reframeYieldTop({
+      maxFaceKeepOut: clipKeepOut,
+      neededBand: requiredBand,
+      aspect: input.destination.aspect
+    });
+    if (topYield) {
+      reframe = topYield;
+    } else {
+      effectiveDepthMode = false;
+      effectiveElements = input.elements.map(
+        (e) => e.kind === "caption" ? { ...e, preferredRegion: "lower-third" } : e
+      );
+      diagnostics.fallbacksTaken.push("captions-behind-top-no-headroom");
+      reframe = reframeYield({
+        maxFaceKeepOut: clipKeepOut,
+        neededBand: requiredBand,
+        aspect: input.destination.aspect
+      });
+    }
+  } else if (effectiveDepthMode) {
+    reframe = coViewReframe(clipKeepOut);
+  } else {
+    reframe = { kind: "transform", dy: 0, zoom: 1 };
+  }
+  if (reframe.kind === "mat") {
+    diagnostics.matApplied = true;
+    diagnostics.fallbacksTaken.push("designed-mat");
+  }
+  const placedKeepOut = reframe.kind === "transform" ? [{ ...clipKeepOut, y: clamp01(clipKeepOut.y + reframe.dy), h: clipKeepOut.h * reframe.zoom }] : [clipKeepOut];
+  const placementSafe = reframe.kind === "mat" ? [...sz.exclusions, reframe.rect] : sz.exclusions.slice();
+  const ordered = [...effectiveElements].sort((a, b) => b.priority - a.priority);
+  const perElement = [];
+  const taken = [];
+  for (const el of ordered) {
+    if (el.intent === "takeover") {
+      const region2 = { x: sz.titleSafe.x, y: sz.titleSafe.y, w: sz.titleSafe.w, h: sz.titleSafe.h };
+      perElement.push(resolveOne(el, region2, input));
+      continue;
+    }
+    const region = placeInLegalArea(
+      {
+        id: el.id,
+        anchor: el.preferredRegion ?? "free",
+        minH: el.measuredExtent.h,
+        minW: el.measuredExtent.w
+      },
+      { faceKeepOut: placedKeepOut, safeZones: [...placementSafe, ...taken] }
+    );
+    if (region) {
+      perElement.push(resolveOne(el, region, input));
+      taken.push(region);
+      continue;
+    }
+    if (el.required) {
+      const fallback = reframe.kind === "mat" ? reframe.rect : { x: 0.1, y: clamp01(1 - el.measuredExtent.h), w: 0.8, h: el.measuredExtent.h };
+      diagnostics.fallbacksTaken.push(`required-forced:${el.id}`);
+      perElement.push(resolveOne(el, fallback, input));
+      taken.push(fallback);
+    } else {
+      diagnostics.droppedElements.push(el.id);
+    }
+  }
+  return { perElement, reframe, faceKeepOut: keepOutSeries, layout, diagnostics };
+}
+
+export {
+  resolveBrandKit,
+  BRAND_TOKEN_ROOT_KEYS,
+  BRAND_TOKEN_REFS,
+  colorMix,
+  resolveBrandRef,
+  resolveBrandRefsDeep,
+  cssLayoutVars,
+  componentBrandPalette,
+  SAFE_ZONE_PROFILE_VERSION,
+  normalizePlatform,
+  lookupSafeZones,
+  FLOOR_VERSION,
+  FACE_PADDING,
+  CAPTION_LC_FLOOR,
+  MIN_ZOOM,
+  faceKeepOut,
+  boundingBox,
+  unionFaceKeepOutSeries,
+  activeFaceKeepOutSeries,
+  resolveLayoutIntent,
+  reframeYield,
+  reframeYieldTop,
+  SILHOUETTE_TO_KEEPOUT_W,
+  COVIEW_MAX_SILHOUETTE_W,
+  coViewReframe,
+  MIN_ACTIVE_SPEAKER_PRESENCE,
+  COVIEW_MIN_BAND_COVERAGE,
+  COVIEW_MAX_BAND_COVERAGE,
+  captionsBehindEligible,
+  placeInLegalArea,
+  resolveCaptionRegion,
+  resolveOverlayRegion,
+  decideLegibility,
+  resolveCompositionFloor
+};