allyhub 0.7.1 → 0.8.0

package/dist/node_modules/@allyhub/stage-page/dist/runtime/stage.js

@@ -0,0 +1,3 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+var allyhub=()=>window.allyhub,post=e=>{parent.postMessage({allyhub:!0,...e},"*")},firstLine=e=>String(e instanceof Error?e.message:e).split(`
+`)[0]??"",fail=e=>{post({type:"error",message:firstLine(e)})},asked=e=>e.source===parent&&typeof e.data=="object"&&e.data!==null&&e.data.allyhub===!0,q=new URLSearchParams(location.search),value=e=>{const t=q.get(e);return t===null||t===""?void 0:t},number=e=>{const t=value(e),n=t===void 0?void 0:Number(t);return n!==void 0&&Number.isFinite(n)?n:void 0};function comboOf(e){return e===void 0||e==="default"?{}:Object.fromEntries(e.split(",").map(t=>{const n=t.indexOf("=");return[t.slice(0,n),t.slice(n+1)]}))}async function sourceOf(e){const t=encodeURIComponent(encodeURIComponent(e)),n=await fetch(new URL(`../build/sources/${t}.json`,location.href));if(!n.ok)throw new Error(`The piece ${e} is not built here.`);return await n.json()}async function player(e,t,n){const d=await e,s=await allyhub().load(d,t),i=allyhub().output;if(!i)throw new Error("Nothing loaded.");const c=s.timeline;let o=number("t");const m=value("part"),u=m===void 0?void 0:c.parts.find(a=>a.key===m);if(u){const a=u.end-u.start,r=number("offset")??0,p=number("dur"),l=p===void 0||Math.abs(a-p)<1e-6;o=u.start+(l?r:r/Math.max(p,1e-6)*a),o=Math.min(o,u.end-1/c.fps)}const h={...n,size:d.format},v=Object.keys(h).sort().map(a=>`${a}=${h[a]??""}`).join(",");post({type:"loaded",kind:s.kind,timeline:c,text:s.text,reads:s.reads,problems:s.problems,mix:i.mixPlan()});const f={},b=[];addEventListener("message",a=>{if(!asked(a))return;const r=a.data;if(r.type==="objects"){i.objects(Number(r.t)).then(l=>{post({type:"objects",...l})},fail);return}if(r.type==="deck-update"){i.update?.(r.deck,r.media).then(l=>{post({type:"deck-updated",...l})},fail);return}if(r.type==="locate"){post({type:"located",id:r.id,layers:allyhub().locate(r.mark)});return}if(typeof r.type!="string")return;const p={...r,type:r.type};f.control?f.control.command(p):b.push(p)});const y=await allyhub().play({media:d.media,seed:`${d.piece}:${s.kind}:${v}`,...o===void 0?{}:{start:o},...value("chrome")==="0"?{chrome:!1}:{},post:a=>{post(a)}});f.control=y,value("play")==="1"&&y.command({type:"play"});for(const a of b.splice(0))y.command(a)}async function main(e){const t=comboOf(value("combo")),n=value("mode"),d=sourceOf(e),s={combo:t,purpose:n==="component"?"render":"play"};if(n==="code"){const i=d.then(o=>allyhub().deckCode(o,s)),c=()=>{i.then(o=>{post({type:"deck-code",code:o.code,theme:o.theme})},fail)};addEventListener("message",o=>{asked(o)&&o.data.type==="deck-code"&&c()}),c();return}if(n==="component"){let i=d.then(()=>{},fail);addEventListener("message",c=>{if(!asked(c)||c.data.type!=="component")return;const o=c.data;i=i.then(()=>d).then(m=>allyhub().component(m,s,{name:String(o.name),props:o.props??{},width:Number(o.width),height:Number(o.height),t:Number(o.t)})).then(m=>{post({type:"component-ready",component:m})},fail)});return}await player(d,s,t)}var piece=value("piece");piece!==void 0&&main(piece).catch(e=>{const t=firstLine(e);document.body.style.cssText="margin:0;padding:16px;background:#141210;color:#fc9cbd;font:14px/1.5 system-ui,sans-serif",document.body.textContent=t,post({type:"error",message:t})});

package/dist/node_modules/@allyhub/stage-page/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@allyhub/stage-page",
+  "version": "0.8.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/host.d.ts",
+      "default": "./dist/host.js"
+    }
+  },
+  "private": true,
+  "license": "SEE LICENSE IN LICENSE.md"
+}

package/dist/node_modules/@allyhub/video-core/dist/component.d.ts

@@ -0,0 +1,70 @@
+/** A prop's type as data: the SDK's text(), number()…, as hosts read them. */
+export interface PropType {
+    type: string;
+    optional?: boolean;
+    of?: PropType;
+    fields?: Readonly<Record<string, PropType>>;
+    kind?: string;
+    label?: string | Readonly<Record<string, string>>;
+    min?: number;
+    max?: number;
+    step?: number;
+    multiline?: boolean;
+}
+/** The frame a component is drawn in: its pixels at 1×, and the slide it is on in a deck. */
+export interface ComponentFrame {
+    width: number;
+    height: number;
+    slide?: string;
+}
+/** A component normalized: its props' types and the layers it draws in a frame. */
+export interface FramedComponent {
+    name: string;
+    /** A name for people; default its name. */
+    label?: string | Readonly<Record<string, string>>;
+    props: Readonly<Record<string, PropType>>;
+    /** Its layers (the layer contract), laid out in the frame's pixels. */
+    layers: (props: Record<string, unknown>, frame: ComponentFrame) => unknown[];
+}
+/** Whether a value is a graphic layer of the layer contract. */
+export declare const isGraphicLayer: (v: unknown) => boolean;
+/**
+ * A component in either of its forms, normalized: what `defineComponent`
+ * makes (one layer filling the frame, or its layers in a frame), or a
+ * deck's `{ props, layers }`. Undefined for anything else.
+ */
+export declare function framedComponent(name: string, value: unknown): FramedComponent | undefined;
+/** A component named by its module: the path from the piece's folder, and the export. */
+export interface ComponentRef {
+    /** The module's path as written, relative to the piece's folder. */
+    path: string;
+    /** The export's name; `default` when the reference names none. */
+    name: string;
+}
+/** `../../components/screens.ts#ShareDialog` read; undefined when it names no module. */
+export declare function parseComponentRef(text: string): ComponentRef | undefined;
+/** A reference written back: the default export without its name. */
+export declare const componentRefText: (ref: ComponentRef) => string;
+export type PropRead = {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    why: string;
+};
+/**
+ * A prop's value read from text by its type, as a doc's attribute gives it:
+ * a number from its digits, a boolean from true or false, a list or an
+ * object from JSON, anything else as written.
+ */
+export declare function readPropText(type: PropType, text: string): PropRead;
+/** A prop's value written as text, as a doc's attribute holds it. */
+export declare function propText(value: unknown): string;
+export interface PropsRead {
+    props: Record<string, unknown>;
+    /** What is wrong, a line each: a prop the component does not have, a value its type does not read. */
+    problems: string[];
+}
+/** Props given as text (a doc's attributes) read by a component's types. */
+export declare function readPropsText(component: Pick<FramedComponent, "name" | "props">, given: Readonly<Record<string, string>>): PropsRead;
+//# sourceMappingURL=component.d.ts.map

package/dist/node_modules/@allyhub/video-core/dist/component.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{LAYER_BRAND as f}from"./piece.js";const l=e=>typeof e=="function"&&typeof e.info=="object"&&e.info!==null;export const isGraphicLayer=e=>typeof e=="object"&&e!==null&&e[f]==="graphic";export function framedComponent(e,n){if(l(n)){const{info:r}=n,t=n.layersIn;return{name:e,...r.label===void 0?{}:{label:r.label},props:r.props,layers:t??(o=>[n(o)])}}if(typeof n=="object"&&n!==null&&typeof n.layers=="function"){const r=n;return{name:e,...r.label===void 0?{}:{label:r.label},props:r.props??{},layers:r.layers}}}export function parseComponentRef(e){const n=e.lastIndexOf("#"),r=(n<0?e:e.slice(0,n)).trim(),t=(n<0?"":e.slice(n+1)).trim()||"default";if(!(r===""||!/\.(?:[cm]?[jt]sx?)$/u.test(r))&&/^[A-Za-z_$][\w$]*$/u.test(t))return{path:r,name:t}}export const componentRefText=e=>e.name==="default"?e.path:`${e.path}#${e.name}`;export function readPropText(e,n){switch(e.type){case"number":{const r=n.trim()===""?NaN:Number(n);return Number.isFinite(r)?e.min!==void 0&&r<e.min?{ok:!1,why:`is under its least, ${String(e.min)}`}:e.max!==void 0&&r>e.max?{ok:!1,why:`is over its most, ${String(e.max)}`}:{ok:!0,value:r}:{ok:!1,why:"is not a number"}}case"boolean":return n==="true"?{ok:!0,value:!0}:n==="false"?{ok:!0,value:!1}:{ok:!1,why:"is not true or false"};case"time":{const r=Number(n);return Number.isFinite(r)&&n.trim()!==""?{ok:!0,value:r}:{ok:!0,value:n}}case"list":case"object":{let r;try{r=JSON.parse(n)}catch{return{ok:!1,why:`is not JSON (a ${e.type} is written as JSON)`}}return(e.type==="list"?Array.isArray(r):typeof r=="object"&&r!==null&&!Array.isArray(r))?{ok:!0,value:r}:{ok:!1,why:`is not a JSON ${e.type==="list"?"array":"object"}`}}default:return{ok:!0,value:n}}}export function propText(e){return typeof e=="string"?e:typeof e=="number"||typeof e=="boolean"?String(e):JSON.stringify(e)}export function readPropsText(e,n){const r={},t=[];for(const[o,i]of Object.entries(n)){const a=e.props[o];if(a===void 0){const u=Object.keys(e.props);t.push(`${e.name} has no prop ${o} (${u.length>0?`it has ${u.join(", ")}`:"it has none"})`);continue}const s=readPropText(a,i);s.ok?r[o]=s.value:t.push(`${e.name}'s ${o} "${i}" ${s.why}`)}return{props:r,problems:t}}

package/dist/node_modules/@allyhub/video-core/dist/edits.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{PAD_MAX as X}from"@allyhub/formats";import{quietest as Y}from"./voice.js";import{joinWords as Z,normText as w,WordStream as z}from"./words.js";export const PAD_BEFORE=.12,PAD_AFTER=.08;const $=.04,R=.04,A=e=>Math.round(e*1e3)/1e3,T=e=>typeof e=="number"&&Number.isFinite(e)&&e>=0;export function parseEditList(e){if(typeof e!="object"||e===null||Array.isArray(e))return"an edits file is a JSON object: { version: 1, remove, sounds, inWord, maxPause, pad }";const t=e;if(t.version!==1)return"version is 1";for(const o of["take","$schema"])if(t[o]!==void 0&&typeof t[o]!="string")return`${o} is a string`;const s=Object.keys(t).filter(o=>!["version","remove","sounds","inWord","maxPause","pad","take","$schema"].includes(o));if(s.length>0)return`unknown field${s.length>1?"s":""} ${s.join(", ")} (an edits file has version, remove, sounds, inWord, maxPause, pad and take)`;const f={};if(t.remove!==void 0){if(!Array.isArray(t.remove))return"remove is a list of { from, to, text }";const o=[];for(const[i,k]of t.remove.entries()){const u=k,M=u?.from,m=u?.to,p=u?.text;if(typeof M!="number"||typeof m!="number"||!Number.isInteger(M)||!Number.isInteger(m)||M<0||m<M||p!==void 0&&typeof p!="string")return`remove[${String(i)}] is not { from, to, text } with word indices from ≤ to`;o.push({from:M,to:m,...p===void 0?{}:{text:p}})}f.remove=o}for(const o of["sounds","inWord"]){if(t[o]===void 0)continue;if(!Array.isArray(t[o]))return`${o} is a list of { from, to } in seconds of the take`;const i=[];for(const[k,u]of t[o].entries()){const M=u,m=M?.from,p=M?.to;if(!T(m)||!T(p)||p<=m)return`${o}[${String(k)}] is not { from, to } in seconds with from < to`;i.push({from:m,to:p})}f[o]=i}const a=t.maxPause;if(a!==void 0){if(typeof a!="number"||!Number.isFinite(a)||a<.05||a>10)return"maxPause is seconds, from 0.05 to 10";f.maxPause=a}const r=t.pad;if(r!==void 0){const o=r,i=typeof r=="object"&&o!==null&&!Array.isArray(r),k=i?Object.keys(o).filter(p=>p!=="before"&&p!=="after"):[],u=p=>p===void 0||T(p)&&p<=X;if(!i||k.length>0||!u(o.before)||!u(o.after))return`pad is { before, after }: seconds of silence kept before and after each cut, each from 0 to ${String(X)}`;const M=o.before,m=o.after;f.pad={...M===void 0?{}:{before:M},...m===void 0?{}:{after:m}}}return f}export function rangeText(e,t,s){return Z(e.slice(t,s+1))}export function locateRange(e,t,s=new z(e)){const f=t.from>=0&&t.to<e.length&&t.to>=t.from;if(t.text===void 0)return f?{from:t.from,to:t.to}:void 0;const a=w(t.text);if(a==="")return f?{from:t.from,to:t.to}:void 0;if(f&&w(rangeText(e,t.from,t.to))===a)return{from:t.from,to:t.to};let r;for(let o=1;;o++){const i=s.span(a,0,e.length-1,o);if(!i)break;w(rangeText(e,i.first,i.last))===a&&(!r||Math.abs(i.first-t.from)<Math.abs(r.from-t.from))&&(r={from:i.first,to:i.last})}return r}export function removedWords(e,t,s=new z(e)){const f=new Set,a=[];for(const r of t?.remove??[]){const o=locateRange(e,r,s);if(!o){a.push(r);continue}for(let i=o.from;i<=o.to;i++)f.add(i)}return{cut:f,lost:a}}export function snapCut(e,t,s,f){const a=Math.min(Math.max(t,s),f);return e?Y(e,a,Math.max(s,a-$),Math.min(f,a+$)):a}const tt=.5,ot=.6;export function speechPads(e,t,s,f,a){const r=e[t],o=e[s]??r;if(!r||!o)return{padIn:0,padOut:0};const i=r.start,k=e[t-1]?.end??0,u=e[s+1]?.start??f??o.end+.4,M=Math.max(0,Math.min((i-k)/2,i)),m=Math.max(0,(u-o.end)/2),p=snapCut(a,i-Math.min(tt,M),i-M,i),g=snapCut(a,o.end+Math.min(ot,m),o.end,o.end+m);return{padIn:A(Math.max(0,i-p)),padOut:A(Math.max(0,g-o.end))}}export function applyEdits(e,t,s=0,f=e.length-1,a={}){const{levels:r,fps:o}=a,{cut:i,lost:k}=removedWords(e,t),u=[];for(let n=s;n<=f;n++)i.has(n)||u.push(n);const M=[...i].filter(n=>n>=s&&n<=f).sort((n,c)=>n-c),m=t?.maxPause,p=[],g=[],y=n=>e[n]??{text:"",start:0,end:0};if(u.length===0)return{ranges:[],words:[],kept:u,removed:M,sounds:[],inWord:[],pauses:p,lost:k};const _=[],j=new Map;for(const n of t?.sounds??[])for(let c=0;c<u.length-1;c++){const h=y(u[c]??0),l=y(u[c+1]??0),b=Math.max(n.from,h.end),x=Math.min(n.to,l.start);if(x-b<.01)continue;const d=j.get(c)??[];d.push({start:b,end:x}),j.set(c,d),_.push({from:A(b),to:A(x)})}const F=y(u[0]??0);let O=F.start,W=F.start;const B=t?.pad?.before??PAD_BEFORE,C=t?.pad?.after??PAD_AFTER,H=m===void 0?B:Math.min(B,m/2),K=m===void 0?C:Math.min(C,m/2);for(let n=0;n<u.length-1;n++){const c=u[n]??0,h=u[n+1]??0,l=y(c),b=y(h),x=[];for(let v=c+1;v<h;v++)x.push({start:y(v).start,end:y(v).end});x.push(...j.get(n)??[]),x.sort((v,P)=>v.start-P.start);const d=x[0],N=x.at(-1);if(!d||!N){const v=b.start-l.end;if(m!==void 0&&v>m){const P=snapCut(r,l.end+m/2,l.end,b.start),S=snapCut(r,b.start-m/2,P,b.start);S-P>=R&&(p.push({after:c,was:A(v),now:m}),g.push({from:O,to:P,lo:W,hi:S}),O=S,W=P)}continue}const J=Math.max(0,d.start-l.end),q=Math.max(0,b.start-N.end),U=snapCut(r,l.end+Math.min(H,J/2),l.end,l.end+J/2),V=snapCut(r,b.start-Math.min(K,q/2),b.start-q/2,b.start);g.push({from:O,to:U,lo:W,hi:d.start}),O=Math.max(V,U),W=Math.min(O,N.end)}const D=y(u.at(-1)??0);g.push({from:O,to:D.end,lo:W,hi:D.end});const L=[];for(const n of t?.inWord??[]){const c=(n.from+n.to)/2,h=snapCut(r,n.from,n.from-$,c),l=snapCut(r,n.to,c,n.to+$);if(l-h<R)continue;let b=!1;for(let x=0;x<g.length;x++){const d=g[x];!d||h>=d.to||l<=d.from||(b=!0,h>d.from&&l<d.to?(g.splice(x,1,{from:d.from,to:h,lo:d.lo,hi:h},{from:l,to:d.to,lo:l,hi:d.hi}),x++):h<=d.from&&l>=d.to?(g.splice(x,1),x--):h<=d.from?(d.from=l,d.lo=l):(d.to=h,d.hi=h))}b&&L.push({from:A(h),to:A(l),words:u.filter(x=>y(x).start<l&&y(x).end>h)})}o!==void 0&&o>0&&g.forEach((n,c)=>{if(c>0){const h=Math.floor(n.from*o+1e-6)/o;h>=n.lo-1e-9&&(n.from=h)}if(c<g.length-1){const h=Math.ceil(n.to*o-1e-6)/o;h<=n.hi+1e-9&&(n.to=h)}});const E=[];for(const n of g){const c=E.at(-1);c&&n.from-c.to<R?c.to=Math.max(c.to,n.to):E.push({from:n.from,to:n.to})}const I=E.map(n=>({from:A(n.from),to:A(n.to)})),Q=editedLength(I),G=n=>A(Math.min(Q,Math.max(0,toEdited(I,n))));return{ranges:I,words:u.map(n=>{const c=y(n);return{text:c.text,start:G(c.start),end:G(c.end)}}),kept:u,removed:M,sounds:_,inWord:L,pauses:p,lost:k}}export function editedLength(e){return e.reduce((t,s)=>t+(s.to-s.from),0)}export function toEdited(e,t){let s=0;const f=e[0];if(!f)return t;if(t<=f.from)return t-f.from;for(const r of e){if(t<r.from)return s;if(t<=r.to)return s+(t-r.from);s+=r.to-r.from}const a=e.at(-1)??f;return s+(t-a.to)}export function fromEdited(e,t){const s=e[0];if(!s)return t;if(t<=0)return s.from+t;let f=0;for(const r of e){const o=r.to-r.from;if(t<f+o)return r.from+(t-f);f+=o}return(e.at(-1)??s).to+(t-f)}

package/dist/node_modules/@allyhub/video-core/dist/export.d.ts

@@ -0,0 +1,97 @@
+export declare const FILE_TYPES: {
+    readonly mp4: {
+        readonly ext: "mp4";
+        readonly type: "video/mp4";
+    };
+    /** ProRes in QuickTime: 4444 with alpha when transparent, else 422 HQ. */
+    readonly mov: {
+        readonly ext: "mov";
+        readonly type: "video/quicktime";
+    };
+    /** VP9 and Opus; VP9 with alpha when transparent. */
+    readonly webm: {
+        readonly ext: "webm";
+        readonly type: "video/webm";
+    };
+    readonly gif: {
+        readonly ext: "gif";
+        readonly type: "image/gif";
+    };
+    readonly srt: {
+        readonly ext: "srt";
+        readonly type: "application/x-subrip";
+    };
+    readonly vtt: {
+        readonly ext: "vtt";
+        readonly type: "text/vtt";
+    };
+    readonly cover: {
+        readonly ext: "cover.jpg";
+        readonly type: "image/jpeg";
+    };
+    /** The mix, mastered as the render masters it: 48 kHz, 16 bits, the film's length. */
+    readonly wav: {
+        readonly ext: "wav";
+        readonly type: "audio/wav";
+    };
+    readonly png: {
+        readonly ext: "png";
+        readonly type: "image/png";
+    };
+    readonly pdf: {
+        readonly ext: "pdf";
+        readonly type: "application/pdf";
+    };
+    readonly pptx: {
+        readonly ext: "pptx";
+        readonly type: "application/vnd.openxmlformats-officedocument.presentationml.presentation";
+    };
+};
+export type FileType = keyof typeof FILE_TYPES;
+export declare function isFileType(v: string): v is FileType;
+/**
+ * The one file the platform stores for an export: the
+ * file type's own file, except PNG, which `allyhub render` writes a page
+ * per file; the platform stores those pages as one zip.
+ */
+export declare function exportFile(type: FileType): {
+    ext: string;
+    type: string;
+    zipped: boolean;
+};
+/**
+ * File types each output kind can be exported as. png is a page per file
+ * for a deck, and a frame per file for a video.
+ */
+/** What is exported: a video, or a deck (`@allyhub/slides-core`). */
+export type ExportKind = "video" | "slides";
+export declare const KIND_TYPES: Record<ExportKind, readonly FileType[]>;
+/** What `allyhub render` makes when no file type is asked for. */
+export declare const DEFAULT_TYPES: Record<ExportKind, readonly FileType[]>;
+/** The output item as the check loaded it (only what matters here). */
+export interface ExportTarget {
+    kind: ExportKind;
+    /** Whether any part says something (has speech). */
+    speech?: boolean;
+}
+/**
+ * Why a file type can't be made from this output item, if it can't: a
+ * type the kind does not have, or captions of an output that says nothing.
+ */
+export declare function exportProblem(target: ExportTarget, type: FileType): {
+    code: string;
+    message: string;
+    hint?: string;
+} | undefined;
+/** Video file types made from the frames (with or without sound). */
+export declare const MOTION_TYPES: readonly FileType[];
+/** File types that keep a transparent stage's alpha. */
+export declare const ALPHA_TYPES: readonly FileType[];
+/**
+ * A file's name from a title, as an export takes it: what no system takes
+ * in a name (a path's separators, control characters, the characters
+ * Windows keeps) becomes a space, a dot or a space at either end goes, and
+ * it is at most 120 characters. Empty when nothing is left.
+ */
+export declare function exportStem(title: string): string;
+//# sourceMappingURL=export.d.ts.map