@allyhub/sdk 0.1.0-alpha.7 → 0.2.0-next.0

package/dist/dom.js

@@ -1,457 +1,2 @@
-import { contentEdges, markRuns, normText, readMarks, WordStream, } from "@allyhub/engine/stage";
-import { largestFit, lineOf, lineSpans } from "./fit.js";
-export function h(tag, style = {}, children = [], cls) {
-    const el = document.createElement(tag);
-    if (cls)
-        el.className = cls;
-    css(el, style);
-    for (const c of children) {
-        el.append(typeof c === "string" ? document.createTextNode(c) : c);
-    }
-    return el;
-}
-export function css(el, style) {
-    for (const [k, v] of Object.entries(style)) {
-        if (v === undefined)
-            continue;
-        const value = typeof v === "number" && !UNITLESS.has(k) ? `${v}px` : String(v);
-        if (k.startsWith("--"))
-            el.style.setProperty(k, value);
-        else
-            el.style.setProperty(k.replace(/[A-Z]/g, (m) => `-${m.toLowerCase()}`), value);
-    }
-}
-const UNITLESS = new Set([
-    "opacity",
-    "zIndex",
-    "fontWeight",
-    "lineHeight",
-    "flex",
-    "flexGrow",
-    "flexShrink",
-]);
-const CJK_RE = /[\u3400-\u9fff\uf900-\ufaff]/;
-/**
- * Chinese has no spaces, so a line can break inside a word. Mark word
- * boundaries (Intl.Segmenter, the browser's own dictionary) with zero-width
- * spaces; with `word-break: keep-all` lines then break only between words.
- */
-export function wordBreaks(value) {
-    if (!CJK_RE.test(value) || typeof Intl.Segmenter !== "function")
-        return value;
-    const seg = new Intl.Segmenter("zh", { granularity: "word" });
-    let out = "";
-    for (const s of seg.segment(value)) {
-        // Break before words only: punctuation stays with the word before it.
-        if (out && s.isWordLike)
-            out += "\u200b";
-        out += s.segment;
-    }
-    return out;
-}
-export const text = (v) => typeof v === "string" || typeof v === "number" || typeof v === "boolean"
-    ? String(v)
-    : "";
-export const list = (v) => Array.isArray(v) ? v.map(text) : v === undefined ? [] : [text(v)];
-/**
- * Layout of the stage for the current format: the type scale and the
- * content box (the same box as ctx.content). With the defaults, in
- * pixels: pad = max(margin, safe.left, safe.right), with margin 120 × k
- * in a landscape frame and 84 × k otherwise; top = max(pad, safe.top +
- * 30 × k); bottom = H − max(pad, safe.bottom + 20 × k); left = pad;
- * right = W − pad. `opts` changes the margin and the gaps.
- */
-export function layout(ctx, opts = {}) {
-    const { width: W, height: H, orient } = ctx.dims;
-    return { W, H, orient, ...contentEdges(ctx.dims, opts) };
-}
-/** A full-stage absolutely positioned box over the content area. */
-export function contentBox(L, style = {}) {
-    return h("div", {
-        position: "absolute",
-        left: L.left,
-        top: L.top,
-        width: L.right - L.left,
-        height: L.bottom - L.top,
-        display: "flex",
-        flexDirection: "column",
-        justifyContent: "center",
-        ...style,
-    });
-}
-/** Text block that keeps its words together and wraps by width. */
-export function textBlock(value, { size, weight = 700, color = "var(--ak-color-fg)", font = "var(--ak-font-display)", lineHeight = 1.15, align = "left", }) {
-    return h("div", {
-        fontFamily: font,
-        fontSize: size,
-        fontWeight: weight,
-        color,
-        lineHeight,
-        textAlign: align,
-        overflowWrap: "break-word",
-        // Even lines read better than one long line and a stub, especially
-        // in Chinese, where a break can fall anywhere.
-        textWrap: "balance",
-        lineBreak: "strict",
-        wordBreak: "keep-all",
-        letterSpacing: weight >= 700 ? "-0.01em" : "0",
-    }, [wordBreaks(value)]);
-}
-/** How marked() draws each kind of mark, unless it is given another style. */
-export const MARK_STYLES = {
-    strong: { fontWeight: 700 },
-    // The look's fonts may have no italic face: stress is a colour.
-    em: { color: "var(--ak-color-accent)" },
-    strike: { textDecoration: "line-through" },
-    code: { fontFamily: "var(--ak-font-mono)", fontSize: "0.9em" },
-};
-/**
- * A line with its marks drawn: a span holding the line's runs in order,
- * a plain run as text and a marked one as a span with `data-mark` (its
- * kinds, "strong", "strong em"…) and the style of each kind, `styles`
- * over MARK_STYLES. A string is read with readMarks() (`**strong**`,
- * `*em*`, `~~struck~~`, `` `code` ``); a text already read is taken with
- * the marks it has. Put it in any block: textBlock("", { size }).append(…),
- * h("div", style, [marked(line)]).
- */
-export function marked(value, styles = {}) {
-    const line = typeof value === "string" ? readMarks(value) : value;
-    const el = h("span");
-    for (const run of markRuns(line.text, line.marks)) {
-        const words = wordBreaks(run.text);
-        if (run.kinds.length === 0) {
-            el.append(words);
-            continue;
-        }
-        const style = {};
-        for (const k of run.kinds) {
-            Object.assign(style, styles[k] ?? MARK_STYLES[k]);
-        }
-        const piece = h("span", style, [words]);
-        piece.dataset["mark"] = run.kinds.join(" ");
-        el.append(piece);
-    }
-    return el;
-}
-/** Children of el by data-ak attribute, in document order. */
-export function all(el, name) {
-    return Array.from(el.querySelectorAll(`[data-ak="${name}"]`));
-}
-export function one(el, name) {
-    return el.querySelector(`[data-ak="${name}"]`);
-}
-export function tag(el, name) {
-    el.dataset["ak"] = name;
-    return el;
-}
-/**
- * The largest font size in [min, max] at which el fits its width and is at
- * most maxHeight tall. Layout depends only on the format and the text, so
- * mount calls this once.
- */
-export function fitTo(el, { min, max, maxHeight }) {
-    const fits = () => el.scrollWidth <= el.clientWidth + 1 && el.offsetHeight <= maxHeight + 1;
-    el.style.fontSize = `${max}px`;
-    if (fits())
-        return max;
-    let lo = min;
-    let hi = max;
-    while (hi - lo > 0.5) {
-        const mid = (lo + hi) / 2;
-        el.style.fontSize = `${mid}px`;
-        if (fits())
-            lo = mid;
-        else
-            hi = mid;
-    }
-    el.style.fontSize = `${lo}px`;
-    return lo;
-}
-export const FIT_LINES_PRECISION = 0.5;
-function textNodes(el) {
-    const walker = document.createTreeWalker(el, NodeFilter.SHOW_TEXT);
-    const out = [];
-    for (let n = walker.nextNode(); n; n = walker.nextNode()) {
-        if (n instanceof Text)
-            out.push(n);
-    }
-    return out;
-}
-function lineBoxes(el) {
-    const range = document.createRange();
-    const rects = [];
-    for (const node of textNodes(el)) {
-        range.selectNodeContents(node);
-        for (const r of range.getClientRects())
-            rects.push(r);
-    }
-    return lineSpans(rects);
-}
-/**
- * The text of each line of el as the browser broke it, top to bottom:
- * spaces collapsed, zero-width spaces (`wordBreaks`) left out. el must be
- * in the page.
- */
-export function textLines(el) {
-    const lines = lineBoxes(el);
-    if (lines.length === 0)
-        return [];
-    const out = lines.map(() => "");
-    const range = document.createRange();
-    let at = 0;
-    for (const node of textNodes(el)) {
-        const value = node.data;
-        for (let i = 0; i < value.length;) {
-            const size = (value.codePointAt(i) ?? 0) > 0xffff ? 2 : 1;
-            range.setStart(node, i);
-            range.setEnd(node, i + size);
-            const r = range.getBoundingClientRect();
-            if (r.height > 0) {
-                const found = lineOf(r, lines);
-                if (found >= 0)
-                    at = found;
-            }
-            out[at] = (out[at] ?? "") + value.slice(i, i + size);
-            i += size;
-        }
-    }
-    return out.map((line) => line
-        .replace(/\u200b/g, "")
-        .replace(/\s+/g, " ")
-        .trim());
-}
-export function fitLines(target, opts) {
-    if (typeof target === "string") {
-        if (opts.width === undefined)
-            throw new Error("fitLines: a text needs a width");
-        const probe = h("div", opts.style ?? {}, [target]);
-        const holder = h("div", {
-            position: "absolute",
-            left: 0,
-            top: 0,
-            visibility: "hidden",
-            pointerEvents: "none",
-        }, [probe]);
-        document.body.append(holder);
-        try {
-            return fitLines(probe, opts);
-        }
-        finally {
-            holder.remove();
-        }
-    }
-    const el = target;
-    const { lines, min, max, width, height } = opts;
-    if (width !== undefined)
-        el.style.width = `${width}px`;
-    const fits = (size) => {
-        el.style.fontSize = `${size}px`;
-        if (el.scrollWidth > el.clientWidth + 1)
-            return false;
-        if (height !== undefined &&
-            (el.offsetHeight > height + 1 || el.scrollHeight > el.clientHeight + 1))
-            return false;
-        return lineBoxes(el).length <= lines;
-    };
-    const found = largestFit(min, max, opts.precision ?? FIT_LINES_PRECISION, fits);
-    el.style.fontSize = `${found.size}px`;
-    return { ...found, lines: textLines(el) };
-}
-/** Pixels two boxes share. */
-const overlapArea = (a, b) => Math.max(0, Math.min(a[0] + a[2], b[0] + b[2]) - Math.max(a[0], b[0])) *
-    Math.max(0, Math.min(a[1] + a[3], b[1] + b[3]) - Math.max(a[1], b[1]));
-/**
- * The empty areas of the frame at part time t: bands across `within`
- * (the content box by default) where no face, other layer's text or
- * covered area is, each `[x, y, w, h]` in the frame's pixels, tallest
- * first. A measurement: use it, or not, as you place things. Draws the
- * layers listed before this one, so call it in mount.
- */
-export function freeAreas(ctx, t, opts = {}) {
-    const L = layout(ctx);
-    const [x, top, w, h] = opts.within ?? [
-        L.left,
-        L.top,
-        L.right - L.left,
-        L.bottom - L.top,
-    ];
-    const bottom = top + h;
-    const margin = opts.margin ?? 24 * L.k;
-    const avoid = [
-        ...(opts.faces === false ? [] : ctx.faces(t).map((f) => f.box)),
-        ...(opts.texts === false ? [] : ctx.texts(t).map((b) => b.box)),
-        ...(opts.covered === false ? [] : ctx.covered),
-    ];
-    // What each obstacle blocks: its rows, widened by the margin, where it
-    // reaches into the band's columns.
-    const blocked = avoid
-        .filter((b) => b[0] < x + w && b[0] + b[2] > x)
-        .map((b) => [b[1] - margin, b[1] + b[3] + margin])
-        .sort((a, b) => a[0] - b[0]);
-    const out = [];
-    let y = top;
-    for (const [a, b] of blocked) {
-        if (a > y)
-            out.push([x, y, w, Math.min(a, bottom) - y]);
-        y = Math.max(y, b);
-        if (y >= bottom)
-            break;
-    }
-    if (y < bottom)
-        out.push([x, y, w, bottom - y]);
-    return out
-        .filter((r) => r[3] > 0 && r[3] >= (opts.minHeight ?? 0))
-        .sort((a, b) => b[3] - a[3]);
-}
-/**
- * Where a caption block w × h pixels (centred across the frame) can go
- * for one cue: the first spot in `prefer`, else just above or below
- * another layer's text, clear of that text and of the faces over the
- * whole cue; when none is clear of both, the least text covered, then
- * the least face. Returns the block's top in pixels, inside the content
- * box. A tool: call it in mount, once per cue, if you want a measured
- * place; nothing places captions on its own.
- */
-export function captionTop(ctx, L, cue, w, h, opts = {}) {
-    const fit = (y) => Math.min(Math.max(y, L.top), Math.max(L.top, L.bottom - h));
-    const spotY = (s) => s === "top"
-        ? fit(L.top)
-        : s === "middle"
-            ? fit((L.top + L.bottom - h) / 2)
-            : s === "bottom"
-                ? fit(L.bottom - h)
-                : fit(s);
-    const prefer = (opts.prefer ?? ["bottom", "top", "middle"]).map(spotY);
-    const step = Math.max(0.02, opts.step ?? 0.1);
-    const len = Math.max(0, cue.end - cue.start);
-    const n = Math.min(200, Math.max(1, Math.ceil(len / step)));
-    const texts = [];
-    const faces = [];
-    for (let i = 0; i < n; i++) {
-        const t = cue.start + (len * i) / n;
-        if (opts.texts !== false)
-            texts.push(...ctx.texts(t).map((b) => b.box));
-        if (opts.faces !== false)
-            faces.push(...ctx.faces(t).map((f) => f.box));
-    }
-    const x = (L.W - w) / 2;
-    const textGap = opts.textGap ?? 48 * L.k;
-    const faceGap = opts.faceGap ?? 24 * L.k;
-    const over = (y, boxes, gap) => boxes.reduce((sum, b) => sum + overlapArea([x, y - gap, w, h + 2 * gap], b), 0);
-    const near = texts
-        .flatMap(([, by, , bh]) => [fit(by - textGap - h), fit(by + bh + textGap)])
-        .sort((a, b) => Math.abs(a - (prefer[0] ?? 0)) - Math.abs(b - (prefer[0] ?? 0)));
-    let best = prefer[0] ?? fit(L.bottom - h);
-    let least = [Infinity, Infinity];
-    for (const y of [...prefer, ...near]) {
-        const c = [
-            over(y, texts, textGap),
-            over(y, faces, faceGap),
-        ];
-        if (c[0] === 0 && c[1] === 0)
-            return y;
-        if (c[0] < least[0] || (c[0] === least[0] && c[1] < least[1])) {
-            least = c;
-            best = y;
-        }
-    }
-    return best;
-}
-/**
- * The look's background and text colours sorted into the lighter and the
- * darker, as variables: text over footage can be light on a dark outline
- * in any look. Measures the look, so call it in mount.
- */
-export function lightDark(el) {
-    const bg = "var(--ak-color-bg)";
-    const fg = "var(--ak-color-fg)";
-    const luminance = (value) => {
-        const probe = h("span", { color: value, display: "none" });
-        el.append(probe);
-        const rgb = /^rgba?\(\s*([\d.]+)[,\s]+([\d.]+)[,\s]+([\d.]+)/.exec(getComputedStyle(probe).color);
-        probe.remove();
-        if (!rgb)
-            return undefined;
-        const [r = 0, g = 0, b = 0] = rgb.slice(1, 4).map((c) => {
-            const s = Number(c) / 255;
-            return s <= 0.04045 ? s / 12.92 : ((s + 0.055) / 1.055) ** 2.4;
-        });
-        return 0.2126 * r + 0.7152 * g + 0.0722 * b;
-    };
-    const lb = luminance(bg);
-    const lf = luminance(fg);
-    return lb !== undefined && lf !== undefined && lf > lb
-        ? { light: fg, dark: bg }
-        : { light: bg, dark: fg };
-}
-const CJK_WORD = /[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Hangul}]/u;
-/** Every match of ref in the words, as [first, last] word indices. */
-function matches(stream, ref) {
-    const needle = normText(ref);
-    const out = [];
-    const end = stream.words.length - 1;
-    for (let nth = 1;; nth++) {
-        const m = stream.span(needle, 0, end, nth);
-        if (!m)
-            return out;
-        // Latin matches whole words: the match ends where a word ends.
-        if (CJK_WORD.test(needle) ||
-            stream.charOf(m.first) + needle.length === stream.charOf(m.last + 1)) {
-            out.push([m.first, m.last]);
-        }
-    }
-}
-/** For each of a cue's words, whether `emphasis` names it. */
-export function emphasized(words, emphasis) {
-    const out = words.map(() => false);
-    if (!emphasis?.length)
-        return out;
-    const stream = new WordStream(words);
-    for (const ref of emphasis) {
-        for (const [first, last] of matches(stream, ref)) {
-            out.fill(true, first, last + 1);
-        }
-    }
-    return out;
-}
-/**
- * For each of a cue's words, the emoji it brings ("" for none): a phrase's
- * goes to its last word, and the first key that names a word wins.
- */
-export function wordEmoji(words, emoji) {
-    const out = words.map(() => "");
-    if (!emoji)
-        return out;
-    const stream = new WordStream(words);
-    for (const [ref, value] of Object.entries(emoji)) {
-        for (const [, last] of matches(stream, ref)) {
-            if (!out[last])
-                out[last] = value;
-        }
-    }
-    return out;
-}
-/**
- * An emoji to draw beside or above a word: in the look's emoji font
- * (`var(--ak-font-emoji)`, colour emoji the stage has, the same on every
- * computer), upright at regular weight, without the capitals or the
- * outline of the line it sits in.
- */
-export function emojiEl(value, style = {}) {
-    const el = h("span", {
-        display: "inline-block",
-        fontFamily: "var(--ak-font-emoji)",
-        fontWeight: 400,
-        fontStyle: "normal",
-        fontSynthesis: "none",
-        textTransform: "none",
-        letterSpacing: "0",
-        lineHeight: 1,
-        WebkitTextStroke: "0",
-        textShadow: "none",
-        ...style,
-    }, [value]);
-    el.setAttribute("aria-hidden", "true");
-    return el;
-}
-//# sourceMappingURL=dom.js.map
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{contentEdges as N,markRuns as I,normText as $,readMarks as C,WordStream as M}from"@allyhub-next/video-core";import{largestFit as O,lineOf as R,lineSpans as j}from"./fit.js";export function h(t,n={},e=[],o){const r=document.createElement(t);o&&(r.className=o),css(r,n);for(const i of e)r.append(typeof i=="string"?document.createTextNode(i):i);return r}export function css(t,n){for(const[e,o]of Object.entries(n)){if(o===void 0)continue;const r=typeof o=="number"&&!B.has(e)?`${String(o)}px`:String(o);e.startsWith("--")?t.style.setProperty(e,r):t.style.setProperty(e.replace(/[A-Z]/g,i=>`-${i.toLowerCase()}`),r)}}const B=new Set(["opacity","zIndex","fontWeight","lineHeight","flex","flexGrow","flexShrink"]),F=/[\u3400-\u9fff\uf900-\ufaff]/;export function wordBreaks(t){if(!F.test(t)||typeof Intl.Segmenter!="function")return t;const n=new Intl.Segmenter("zh",{granularity:"word"});let e="";for(const o of n.segment(t))e&&o.isWordLike&&(e+="​"),e+=o.segment;return e}export const text=t=>typeof t=="string"||typeof t=="number"||typeof t=="boolean"?String(t):"",list=t=>Array.isArray(t)?t.map(text):t===void 0?[]:[text(t)];export function layout(t,n={}){const{width:e,height:o,orient:r}=t.dims;return{W:e,H:o,orient:r,...N(t.dims,n)}}export function contentBox(t,n={}){return h("div",{position:"absolute",left:t.left,top:t.top,width:t.right-t.left,height:t.bottom-t.top,display:"flex",flexDirection:"column",justifyContent:"center",...n})}export function textBlock(t,{size:n,weight:e=700,color:o="var(--ak-color-fg)",font:r="var(--ak-font-display)",lineHeight:i=1.15,align:s="left"}){return h("div",{fontFamily:r,fontSize:n,fontWeight:e,color:o,lineHeight:i,textAlign:s,overflowWrap:"break-word",textWrap:"balance",lineBreak:"strict",wordBreak:"keep-all",letterSpacing:e>=700?"-0.01em":"0"},[wordBreaks(t)])}export const MARK_STYLES={strong:{fontWeight:700},em:{color:"var(--ak-color-accent)"},strike:{textDecoration:"line-through"},code:{fontFamily:"var(--ak-font-mono)",fontSize:"0.9em"}};export function marked(t,n={}){const e=typeof t=="string"?C(t):t,o=h("span");for(const r of I(e.text,e.marks)){const i=wordBreaks(r.text);if(r.kinds.length===0){o.append(i);continue}const s={};for(const l of r.kinds)Object.assign(s,n[l]??MARK_STYLES[l]);const f=h("span",s,[i]);f.dataset.mark=r.kinds.join(" "),o.append(f)}return o}export function all(t,n){return Array.from(t.querySelectorAll(`[data-ak="${n}"]`))}export function one(t,n){return t.querySelector(`[data-ak="${n}"]`)}export function tag(t,n){return t.dataset.ak=n,t}export function fitTo(t,{min:n,max:e,maxHeight:o}){const r=()=>t.scrollWidth<=t.clientWidth+1&&t.offsetHeight<=o+1;if(t.style.fontSize=`${String(e)}px`,r())return e;let i=n,s=e;for(;s-i>.5;){const f=(i+s)/2;t.style.fontSize=`${String(f)}px`,r()?i=f:s=f}return t.style.fontSize=`${String(i)}px`,i}export const FIT_LINES_PRECISION=.5;function W(t){const n=document.createTreeWalker(t,NodeFilter.SHOW_TEXT),e=[];for(let o=n.nextNode();o;o=n.nextNode())o instanceof Text&&e.push(o);return e}function v(t){const n=document.createRange(),e=[];for(const o of W(t)){n.selectNodeContents(o);for(const r of n.getClientRects())e.push(r)}return j(e)}export function textLines(t){const n=v(t);if(n.length===0)return[];const e=n.map(()=>""),o=document.createRange();let r=0;for(const i of W(t)){const s=i.data;for(let f=0;f<s.length;){const l=(s.codePointAt(f)??0)>65535?2:1;o.setStart(i,f),o.setEnd(i,f+l);const m=o.getBoundingClientRect();if(m.height>0){const d=R(m,n);d>=0&&(r=d)}e[r]=(e[r]??"")+s.slice(f,f+l),f+=l}}return e.map(i=>i.replace(/\u200b/g,"").replace(/\s+/g," ").trim())}export function fitLines(t,n){if(typeof t=="string"){if(n.width===void 0)throw new Error("fitLines: a text needs a width");const d=h("div",n.style??{},[t]),x=h("div",{position:"absolute",left:0,top:0,visibility:"hidden",pointerEvents:"none"},[d]);document.body.append(x);try{return fitLines(d,n)}finally{x.remove()}}const e=t,{lines:o,min:r,max:i,width:s,height:f}=n;s!==void 0&&(e.style.width=`${String(s)}px`);const l=d=>(e.style.fontSize=`${String(d)}px`,e.scrollWidth>e.clientWidth+1||f!==void 0&&(e.offsetHeight>f+1||e.scrollHeight>e.clientHeight+1)?!1:v(e).length<=o),m=O(r,i,n.precision??FIT_LINES_PRECISION,l);return e.style.fontSize=`${String(m.size)}px`,{...m,lines:textLines(e)}}const _=(t,n)=>Math.max(0,Math.min(t[0]+t[2],n[0]+n[2])-Math.max(t[0],n[0]))*Math.max(0,Math.min(t[1]+t[3],n[1]+n[3])-Math.max(t[1],n[1]));export function freeAreas(t,n,e={}){const o=layout(t),[r,i,s,f]=e.within??[o.left,o.top,o.right-o.left,o.bottom-o.top],l=i+f,m=e.margin??24*o.k,x=[...e.faces===!1?[]:t.faces(n).map(a=>a.box),...e.texts===!1?[]:t.texts(n).map(a=>a.box),...e.covered===!1?[]:t.covered].filter(a=>a[0]<r+s&&a[0]+a[2]>r).map(a=>[a[1]-m,a[1]+a[3]+m]).sort((a,y)=>a[0]-y[0]),g=[];let p=i;for(const[a,y]of x)if(a>p&&g.push([r,p,s,Math.min(a,l)-p]),p=Math.max(p,y),p>=l)break;return p<l&&g.push([r,p,s,l-p]),g.filter(a=>a[3]>0&&a[3]>=(e.minHeight??0)).sort((a,y)=>y[3]-a[3])}export function captionTop(t,n,e,o,r,i={}){const s=c=>Math.min(Math.max(c,n.top),Math.max(n.top,n.bottom-r)),f=c=>s(c==="top"?n.top:c==="middle"?(n.top+n.bottom-r)/2:c==="bottom"?n.bottom-r:c),l=(i.prefer??["bottom","top","middle"]).map(f),m=Math.max(.02,i.step??.1),d=Math.max(0,e.end-e.start),x=Math.min(200,Math.max(1,Math.ceil(d/m))),g=[],p=[];for(let c=0;c<x;c++){const u=e.start+d*c/x;i.texts!==!1&&g.push(...t.texts(u).map(k=>k.box)),i.faces!==!1&&p.push(...t.faces(u).map(k=>k.box))}const a=(n.W-o)/2,y=i.textGap??48*n.k,T=i.faceGap??24*n.k,b=(c,u,k)=>u.reduce((H,A)=>H+_([a,c-k,o,r+2*k],A),0),z=g.flatMap(([,c,,u])=>[s(c-y-r),s(c+u+y)]).sort((c,u)=>Math.abs(c-(l[0]??0))-Math.abs(u-(l[0]??0)));let w=l[0]??s(n.bottom-r),S=[1/0,1/0];for(const c of[...l,...z]){const u=[b(c,g,y),b(c,p,T)];if(u[0]===0&&u[1]===0)return c;(u[0]<S[0]||u[0]===S[0]&&u[1]<S[1])&&(S=u,w=c)}return w}export function lightDark(t){const n="var(--ak-color-bg)",e="var(--ak-color-fg)",o=s=>{const f=h("span",{color:s,display:"none"});t.append(f);const l=/^rgba?\(\s*([\d.]+)[,\s]+([\d.]+)[,\s]+([\d.]+)/.exec(getComputedStyle(f).color);if(f.remove(),!l)return;const[m=0,d=0,x=0]=l.slice(1,4).map(g=>{const p=Number(g)/255;return p<=.04045?p/12.92:((p+.055)/1.055)**2.4});return .2126*m+.7152*d+.0722*x},r=o(n),i=o(e);return r!==void 0&&i!==void 0&&i>r?{light:e,dark:n}:{light:n,dark:e}}const G=/[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Hangul}]/u;function E(t,n){const e=$(n),o=[],r=t.words.length-1;for(let i=1;;i++){const s=t.span(e,0,r,i);if(!s)return o;(G.test(e)||t.charOf(s.first)+e.length===t.charOf(s.last+1))&&o.push([s.first,s.last])}}export function emphasized(t,n){const e=t.map(()=>!1);if(!n?.length)return e;const o=new M(t);for(const r of n)for(const[i,s]of E(o,r))e.fill(!0,i,s+1);return e}export function wordEmoji(t,n){const e=t.map(()=>"");if(!n)return e;const o=new M(t);for(const[r,i]of Object.entries(n))for(const[,s]of E(o,r))(e[s]??"")===""&&(e[s]=i);return e}export function emojiEl(t,n={}){const e=h("span",{display:"inline-block",fontFamily:"var(--ak-font-emoji)",fontWeight:400,fontStyle:"normal",fontSynthesis:"none",textTransform:"none",letterSpacing:"0",lineHeight:1,WebkitTextStroke:"0",textShadow:"none",...n},[t]);return e.setAttribute("aria-hidden","true"),e}

package/dist/fit.js

@@ -1,60 +1,2 @@
-// The arithmetic behind fitLines and textLines (dom.ts), apart from the DOM
-// so it can be tested without a browser: text's boxes grouped into lines,
-// and the largest size a test passes at.
-//
-// fitLines is after Remotion's fitTextOnNLines and fillTextBox in
-// @remotion/layout-utils
-// (https://github.com/remotion-dev/remotion/tree/main/packages/layout-utils,
-// MIT): a binary search on the font size for the largest at which the text
-// takes at most n lines of a width. Written again here, measuring in the
-// stage's own DOM rather than word by word on a canvas. See NOTICE.
-/** Whether a box is on a line: it shares at least half its height with it. */
-function onLine(rect, line) {
-    const overlap = Math.min(rect.bottom, line.bottom) - Math.max(rect.top, line.top);
-    const height = Math.min(rect.bottom - rect.top, line.bottom - line.top);
-    return overlap > height / 2;
-}
-/**
- * The lines a text's boxes are on, top to bottom: each the extent of the
- * first box found on it. Boxes with no height (collapsed spaces) are left
- * out. A box shares a line with another when they overlap by more than half
- * the shorter one's height, which holds for line heights above about 0.6.
- */
-export function lineSpans(rects) {
-    const sorted = [...rects]
-        .filter((r) => r.bottom - r.top > 0)
-        .sort((a, b) => a.top - b.top);
-    const lines = [];
-    for (const r of sorted) {
-        if (!lines.some((line) => onLine(r, line)))
-            lines.push({ top: r.top, bottom: r.bottom });
-    }
-    return lines.sort((a, b) => a.top - b.top);
-}
-/** The index of the line a box is on, or -1. */
-export function lineOf(rect, lines) {
-    return lines.findIndex((line) => onLine(rect, line));
-}
-/**
- * The largest size in [min, max] at which `fits` holds, to within
- * `precision`, assuming a smaller size fits whenever a larger one does.
- * `fits` is false, and the size `min`, when even `min` does not.
- */
-export function largestFit(min, max, precision, fits) {
-    if (fits(max))
-        return { size: max, fits: true };
-    if (!fits(min))
-        return { size: min, fits: false };
-    let lo = min;
-    let hi = max;
-    const step = Math.max(precision, 1e-3);
-    while (hi - lo > step) {
-        const mid = (lo + hi) / 2;
-        if (fits(mid))
-            lo = mid;
-        else
-            hi = mid;
-    }
-    return { size: lo, fits: true };
-}
-//# sourceMappingURL=fit.js.map
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+function p(o,e){const s=Math.min(o.bottom,e.bottom)-Math.max(o.top,e.top),t=Math.min(o.bottom-o.top,e.bottom-e.top);return s>t/2}export function lineSpans(o){const e=[...o].filter(t=>t.bottom-t.top>0).sort((t,n)=>t.top-n.top),s=[];for(const t of e)s.some(n=>p(t,n))||s.push({top:t.top,bottom:t.bottom});return s.sort((t,n)=>t.top-n.top)}export function lineOf(o,e){return e.findIndex(s=>p(o,s))}export function largestFit(o,e,s,t){if(t(e))return{size:e,fits:!0};if(!t(o))return{size:o,fits:!1};let n=o,r=e;const f=Math.max(s,.001);for(;r-n>f;){const i=(n+r)/2;t(i)?n=i:r=i}return{size:n,fits:!0}}

package/dist/free.d.ts

@@ -0,0 +1,18 @@
+export { clamp, ease, fitText, lerp, progress, rand, stagger, tween, type Ease, type FitTextOptions, type TweenOptions, } from "./anim.js";
+export { noise2D, noise3D, noise4D } from "./noise.js";
+export { drag, fittsTime, INPUT_DEFAULTS, pointer, reach, scroll, tap, typing, type Drag, type DragOptions, type Movement, type Point, type Pointer, type PointerOptions, type PointerState, type PointerStep, type ReachOptions, type Scroll, type ScrollOptions, type Tap, type TapOptions, type Typed, type TypingOptions, } from "./input.js";
+export { aimed, type AimOptions } from "@allyhub-next/scenery";
+export { drawOn, interpolatePath, normalizePath, pathLength, pointAtLength, tangentAtLength, trimPath, type DrawOn, type PathCommand, type PathPoint, } from "./paths.js";
+export { FIT_LINES_PRECISION, fitLines, textLines, type FitLines, type FitLinesOptions, } from "./dom.js";
+export { custom, defineComponent, LAYER_OPTIONS, type Component, type ComponentDefinition, type ComponentInfo, type CustomOptions, type Label, type LayerOptions, type StageContext, } from "./define.js";
+export { say, type BoxKey, type FootageBackground, type FootageBox, type PerOrient, type PunchIn, type Pullback, type Reframe, type FootageLayer, type FootageOptions, type GraphicLayer, type Layer, type LayerSpec, type LayerTiming, type PartAnchors, type PartOptions, type PartSpec, type Rect, type RoomTone, type SayOptions, type SaySpeech, type SoundSpec, type SpeechSpec, type Take, type TakeSpeech, type VideoSpeech, type VideoTake, type Direction, type TransitionChannel, type TransitionInput, type TransitionPicture, type TransitionSpec, type TransitionType, type WordRef, } from "./parts.js";
+export type { InlineMark, MarkedText } from "@allyhub-next/video-core";
+/** What ctx.video(piece, el) gives: another video item, drawn inside an element. */
+export type { EmbeddedVideo } from "@allyhub-next/video-core";
+export { defineConfig, definePiece, paged, type Combo, type Dims, type Format, type FormatEntry, type FormatSpec, type ItemPiece, type Matrix, type MediaRef, type MessageHint, type MotionBlur, type MusicOptions, type PagedBuild, type PagedOptions, type PagedPiece, type PieceContext, type PieceDefinition, type PieceOptions, type PieceWritten, type PostProcess, type CaptureOptions, type ProjectConfig, type Slides, type SlidesOptions, type Video, type VideoBuild, type VideoItem, type VideoOptions, type VideoPiece, type VideoPieceOptions, } from "./piece.js";
+export type { ListItem, ListPrefix, MessageInputs, MessageKey, MessageLists, MessageReader, Messages, } from "./messages.js";
+export { asset, boolean, color, list, number, object, text, time, type PropSchema, type Time, type Timed, } from "./props.js";
+export { countText, splitText } from "./text.js";
+export { markRuns, readMarks, withoutMarks, type MarkRun, } from "@allyhub-next/video-core";
+export type { Box, CaptionOptions, CaptionTrackCue, CaptionWord, EditList, EditRange, FaceOnFrame, FaceTrack, MediaInfo, MediaKind, PixelRect, TrackedFace, Word, } from "@allyhub-next/video-core";
+//# sourceMappingURL=free.d.ts.map

package/dist/free.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export{clamp,ease,fitText,lerp,progress,rand,stagger,tween}from"./anim.js";export{noise2D,noise3D,noise4D}from"./noise.js";export{drag,fittsTime,INPUT_DEFAULTS,pointer,reach,scroll,tap,typing}from"./input.js";export{aimed}from"@allyhub-next/scenery";export{drawOn,interpolatePath,normalizePath,pathLength,pointAtLength,tangentAtLength,trimPath}from"./paths.js";export{FIT_LINES_PRECISION,fitLines,textLines}from"./dom.js";export{custom,defineComponent,LAYER_OPTIONS}from"./define.js";export{say}from"./parts.js";export{defineConfig,definePiece,paged}from"./piece.js";export{asset,boolean,color,list,number,object,text,time}from"./props.js";export{countText,splitText}from"./text.js";export{markRuns,readMarks,withoutMarks}from"@allyhub-next/video-core";

package/dist/index.d.ts

@@ -1,14 +1,29 @@
-export { clamp, ease, fitText, lerp, progress, rand, stagger, tween, type Ease, type FitTextOptions, type TweenOptions, } from "./anim.js";
-export { noise2D, noise3D, noise4D } from "./noise.js";
-export { drawOn, interpolatePath, normalizePath, pathLength, pointAtLength, tangentAtLength, trimPath, type DrawOn, type PathCommand, type PathPoint, } from "./paths.js";
-export { FIT_LINES_PRECISION, fitLines, textLines, type FitLines, type FitLinesOptions, } from "./dom.js";
-export { custom, defineComponent, LAYER_OPTIONS, type Component, type ComponentDefinition, type ComponentInfo, type CustomOptions, type Label, type LayerOptions, type StageContext, } from "./define.js";
-export { footage, part, say, take, type BoxKey, type FootageBackground, type FootageBox, type PerOrient, type PunchIn, type Pullback, type Reframe, type FootageLayer, type FootageOptions, type GraphicLayer, type LayerSpec, type LayerTiming, type PartAnchors, type PartOptions, type PartSpec, type Rect, type SayOptions, type SaySpeech, type SoundSpec, type SpeechSpec, type Take, type TakeSpeech, type Direction, type TransitionChannel, type TransitionInput, type TransitionPicture, type TransitionSpec, type TransitionType, type WordRef, } from "./parts.js";
-export type { InlineMark, MarkedText } from "@allyhub/engine/stage";
-export { defineConfig, definePiece, paged, video, type Combo, type Dims, type Format, type FormatEntry, type FormatSpec, type Matrix, type MediaRef, type MessageHint, type MotionBlur, type MusicOptions, type PagedBuild, type PagedOptions, type PieceContext, type PieceDefinition, type PieceOptions, type PostProcess, type ProjectConfig, type VideoBuild, type VideoOptions, } from "./piece.js";
-export type { ListItem, ListPrefix, MessageInputs, MessageKey, MessageLists, MessageReader, Messages, } from "./messages.js";
-export { asset, boolean, color, list, number, object, text, time, type PropSchema, type Time, type Timed, } from "./props.js";
-export { countText, splitText } from "./text.js";
-export { markRuns, readMarks, withoutMarks, type MarkRun, } from "@allyhub/engine/stage";
-export type { Box, CaptionOptions, CaptionTrackCue, CaptionWord, EditList, EditRange, FaceOnFrame, FaceTrack, MediaInfo, MediaKind, PixelRect, TrackedFace, Word, } from "@allyhub/engine/stage";
+export * from "./free.js";
+export { BOUND, sdkFor, type BoundSdk, type Sdk, type SdkModule, } from "./module.js";
+export type { FootageFn, PartFn, TakeFn } from "./parts.js";
+export type { SlidesFn, VideoFn } from "./piece.js";
+/**
+ * A video: the default export of an item's video.ts. The function returns
+ * its parts, in order.
+ */
+export declare const video: import("./piece.js").VideoFn;
+/**
+ * Pages of one format, each one still frame: a single image, a carousel,
+ * slides, a PDF document; the default export of an item's slides.ts.
+ * `notes: true` reads each page's speaker notes from
+ * `<prefix>.<page>.notes`.
+ */
+export declare const slides: import("./piece.js").SlidesFn;
+/** A part of a video, or a page of a paged output. */
+export declare const part: import("./parts.js").PartFn;
+/**
+ * Speech from a recording (an import, or a path) with its word times
+ * beside it, or a stretch of another video item of the project.
+ */
+export declare const take: import("./parts.js").TakeFn;
+/**
+ * A video on the part: footage("./broll.mp4", { at: "inbox", dur: 1.5 }).
+ * Without a file it is the part's own take, in sync with its speech.
+ */
+export declare const footage: import("./parts.js").FootageFn;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,11 +1,2 @@
-export { clamp, ease, fitText, lerp, progress, rand, stagger, tween, } from "./anim.js";
-export { noise2D, noise3D, noise4D } from "./noise.js";
-export { drawOn, interpolatePath, normalizePath, pathLength, pointAtLength, tangentAtLength, trimPath, } from "./paths.js";
-export { FIT_LINES_PRECISION, fitLines, textLines, } from "./dom.js";
-export { custom, defineComponent, LAYER_OPTIONS, } from "./define.js";
-export { footage, part, say, take, } from "./parts.js";
-export { defineConfig, definePiece, paged, video, } from "./piece.js";
-export { asset, boolean, color, list, number, object, text, time, } from "./props.js";
-export { countText, splitText } from "./text.js";
-export { markRuns, readMarks, withoutMarks, } from "@allyhub/engine/stage";
-//# sourceMappingURL=index.js.map
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{footageFor as r,partFor as t,takeFor as e}from"./parts.js";import{slidesFor as p,videoFor as s}from"./piece.js";import{writtenIn as i}from"./written.js";export*from"./free.js";export{BOUND,sdkFor}from"./module.js";const o=i({file:""});export const video=s(o),slides=p(o),part=t(o),take=e(o),footage=r(o);