allyhub 0.7.0 → 0.8.0

package/dist/node_modules/@allyhub/slides-core/dist/api.js

@@ -0,0 +1,4 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{themeColor as O,themeColorOf as T}from"@allyhub/chart";import{presetAdjustments as z}from"@allyhub/ooxml/geometry";import{framedComponent as G}from"@allyhub/video-core";import{MSO_CONNECTOR as I,MSO_SHAPE as M,MSO_SHAPE_TYPE as B,PP_PLACEHOLDER as j}from"./enums.js";import{Chart as D}from"./chart-api.js";import{AUTOSHAPE_STYLE as p,SHADOW_DEFAULTS as v,CONNECTOR_GEOMETRIES as H,CONNECTOR_STYLE as P,FOOTER_IDX as U,isConnectorGeometry as R,OFFICE_TEXT_STYLES as X,placeholderLevels as Y,TEXT_INSETS as w,TEXTBOX_FRAME as J}from"./office.js";import{masterPlaceholder as A}from"./placeholders.js";import{strict as o}from"./strict.js";import{EMU_PER_PT as F,SLIDE_SIZES as k,length as d,lengthOr as y}from"./units.js";class Z extends Error{constructor(t){super(`${t} (allyhub slides capabilities lists what the API holds).`),this.name="Unsupported"}}const m=i=>{throw new Z(i)},q=/^#?[0-9a-f]{6}$/iu,C=i=>{if(!q.test(i))throw new Error(`rgb ${i} is not RRGGBB.`);return`#${i.replace("#","").toUpperCase()}`};export const RGBColor=Object.assign(function(t,e,s){for(const h of[t,e,s])if(!Number.isInteger(h)||h<0||h>255)throw new Error(`RGBColor(${String(t)}, ${String(e)}, ${String(s)}): each is 0 to 255.`);const r=`#${[t,e,s].map(h=>h.toString(16).padStart(2,"0")).join("").toUpperCase()}`;return new.target===void 0?r:new String(r)},{from_string:i=>C(i)});export class ColorFormat{read;write;constructor(t,e){return this.read=t,this.write=e,o(this,"ColorFormat")}get theme_color(){const t=this.read();return t===void 0?void 0:T(t)}set theme_color(t){this.write(t===void 0?void 0:O(t,this.brightness))}get brightness(){const t=this.read();return typeof t=="object"&&"brightness"in t?t.brightness:0}set brightness(t){if(!(t>=-1&&t<=1))throw new RangeError(`brightness ${String(t)} is not a number from -1.0 to 1.0.`);const e=this.read();if(e===void 0)throw new TypeError("There is no colour to set the brightness of: set theme_color first.");const s=T(e);if(s!==void 0)this.write(O(s,t));else if(t!==0)throw new TypeError("Only a theme colour has a brightness here, so an RGB colour does not: set theme_color first, or rgb to the colour it makes.")}get rgb(){const t=this.read();return typeof t=="object"&&"rgb"in t?t.rgb:void 0}set rgb(t){this.write(t===void 0?void 0:{rgb:C(t)})}}export class Font{def;constructor(t){return this.def=t,o(this,"Font")}_set(t,e){e===void 0?Reflect.deleteProperty(this.def,t):this.def[t]=e}get strike(){return this.def.strike}set strike(t){this._set("strike",t)}get baseline(){return this.def.baseline}set baseline(t){this._set("baseline",t)}get highlight(){return this.def.highlight}set highlight(t){this._set("highlight",t)}get name(){return this.def.name}set name(t){this._set("name",t)}get size(){return y(this.def.size)}set size(t){this._set("size",t)}get bold(){return this.def.bold}set bold(t){this._set("bold",t)}get italic(){return this.def.italic}set italic(t){this._set("italic",t)}get underline(){return this.def.underline}set underline(t){this._set("underline",t)}get spacing(){return y(this.def.spacing)}set spacing(t){this._set("spacing",t)}get color(){return new ColorFormat(()=>this.def.color,t=>{this._set("color",t)})}}export class Hyperlink{def;constructor(t){return this.def=t,o(this,"_Hyperlink")}get address(){return this.def.font?.link}set address(t){this.def.font??={},t===void 0?Reflect.deleteProperty(this.def.font,"link"):this.def.font.link=t}}export class Run{def;constructor(t){return this.def=t,o(this,"_Run")}get text(){return this.def.text}set text(t){this.def.text=t}get font(){return this.def.font??={},new Font(this.def.font)}get hyperlink(){return new Hyperlink(this.def)}}const K=i=>{if(!Number.isFinite(i)||i<=0)throw new Error(`line_spacing ${String(i)} is not over 0.`);return Number.isInteger(i)&&i>=F?{fixed:i}:{lines:i}},W=i=>i===void 0?void 0:"lines"in i?i.lines:d(i.fixed),N=i=>i.split(/\n|\v/u).flatMap((t,e)=>[...e>0?[{text:"\v"}]:[],...t===""?[]:[{text:t}]]);class L{_set(t,e){e===void 0?Reflect.deleteProperty(this.fmt,t):this.fmt[t]=e}get alignment(){return this.fmt.alignment}set alignment(t){this._set("alignment",t)}get line_spacing(){return W(this.fmt.line_spacing)}set line_spacing(t){this._set("line_spacing",t===void 0?void 0:K(t))}get space_before(){return y(this.fmt.space_before)}set space_before(t){this._set("space_before",t)}get space_after(){return y(this.fmt.space_after)}set space_after(t){this._set("space_after",t)}get font(){return this.fmt.font??={},new Font(this.fmt.font)}}export class Paragraph extends L{fmt;constructor(t){return super(),this.fmt=t,o(this,"_Paragraph")}get text(){return this.fmt.runs.map(t=>t.text).join("")}set text(t){this.fmt.runs=N(t)}get runs(){return this.fmt.runs.filter(t=>t.text!=="\v").map(t=>new Run(t))}add_run(){const t={text:""};return this.fmt.runs.push(t),new Run(t)}add_line_break(){this.fmt.runs.push({text:"\v"})}clear(){return this.fmt.runs=[],this}get level(){return this.fmt.level}set level(t){if(!Number.isInteger(t)||t<0||t>8)throw new Error(`level ${String(t)} is not 0 to 8.`);this.fmt.level=t}}export class ListLevel extends L{fmt;constructor(t){return super(),this.fmt=t,o(this,"ListLevel")}get numbered(){return this.fmt.numbered}set numbered(t){this._set("numbered",t)}get bullet(){return this.fmt.bullet}set bullet(t){this._set("bullet",t)}get bullet_font(){return this.fmt.bullet_font}set bullet_font(t){this._set("bullet_font",t)}get margin_left(){return y(this.fmt.margin_left)}set margin_left(t){this._set("margin_left",t)}get indent(){return y(this.fmt.indent)}set indent(t){this._set("indent",t)}}const S=i=>Object.freeze(i.map(t=>new ListLevel(t))),Q=()=>Array.from({length:9},()=>({})),E=()=>({paragraphs:[],levels:Q()});export class TextFrame{def;constructor(t){return this.def=t,o(this,"TextFrame")}_set(t,e){e===void 0?Reflect.deleteProperty(this.def,t):this.def[t]=e}get text(){return this.def.paragraphs.map(t=>t.runs.map(e=>e.text).join("")).join(`
+`)}set text(t){this.def.paragraphs=t.split(`
+`).map(e=>({runs:N(e),level:0}))}get paragraphs(){return this.def.paragraphs.length===0&&this.def.paragraphs.push({runs:[],level:0}),this.def.paragraphs.map(t=>new Paragraph(t))}add_paragraph(){this.def.paragraphs.length===0&&this.def.paragraphs.push({runs:[],level:0});const t={runs:[],level:0};return this.def.paragraphs.push(t),new Paragraph(t)}clear(){const t=this.def.paragraphs[0];this.def.paragraphs=t?[{...t,runs:[]}]:[]}fit_text(t,e=18,s,r){this.def.auto_size="text",this.def.word_wrap=!0;for(const n of this.def.paragraphs)for(const h of n.runs)h.font={...h.font,size:Math.trunc(e*F),...t===void 0?{}:{name:t},...s===void 0?{}:{bold:s},...r===void 0?{}:{italic:r}}}get list_style(){return S(this.def.levels)}get vertical_anchor(){return this.def.vertical_anchor}set vertical_anchor(t){this._set("vertical_anchor",t)}get auto_size(){return this.def.auto_size}set auto_size(t){this._set("auto_size",t)}get word_wrap(){return this.def.word_wrap}set word_wrap(t){this._set("word_wrap",t)}get margin_left(){return d(this.def.margin_left??w.left)}set margin_left(t){this.def.margin_left=t}get margin_top(){return d(this.def.margin_top??w.top)}set margin_top(t){this.def.margin_top=t}get margin_right(){return d(this.def.margin_right??w.right)}set margin_right(t){this.def.margin_right=t}get margin_bottom(){return d(this.def.margin_bottom??w.bottom)}set margin_bottom(t){this.def.margin_bottom=t}}export class FillFormat{read;write;start;shape;constructor(t,e,s="lt1",r){return this.read=t,this.write=e,this.start=s,this.shape=r,o(this,"FillFormat")}solid(){const t=this.read();this.shape&&Reflect.deleteProperty(this.shape,"gradient"),t==null&&this.write(this.start)}background(){this.shape&&Reflect.deleteProperty(this.shape,"gradient"),this.write(null)}_shape(t){if(!this.shape)throw new TypeError(`Only a shape's fill has ${t}.`);return this.shape}gradient(){this._shape("a gradient").gradient??={angle:90,stops:[{at:0,color:"accent1"},{at:1,color:"accent2"}]}}get gradient_angle(){return this._gradient().angle}set gradient_angle(t){this._gradient().angle=t}get gradient_stops(){return this._gradient().stops}set gradient_stops(t){if(t.length<2)throw new Error("A gradient has two stops at least.");this._gradient().stops=t.map(e=>({...e}))}_gradient(){const{gradient:t}=this._shape("a gradient");if(!t)throw new TypeError("This fill is no gradient: call fill.gradient() first.");return t}get transparency(){return this._shape("a transparency").fill_transparency??0}set transparency(t){if(!(t>=0&&t<=1))throw new Error(`A transparency is a share, 0 to 1, not ${String(t)}.`);this._shape("a transparency").fill_transparency=t}get type(){if(this.shape?.gradient)return"gradient";const t=this.read();return t===void 0?void 0:t===null?"background":"solid"}get fore_color(){const t=this.read();if(t==null)throw new TypeError("This fill is not solid, so it has no fore_color: call fill.solid() first.");return new ColorFormat(()=>this.read()??void 0,e=>{this.write(e??this.start)})}}export class ShadowFormat{def;constructor(t){return this.def=t,o(this,"ShadowFormat")}_shadow(){return this.def.shadow??={...v},this.def.shadow}get inherit(){return this.def.shadow===void 0}set inherit(t){t?Reflect.deleteProperty(this.def,"shadow"):this._shadow()}get blur_radius(){return d(this._shadow().blur)}set blur_radius(t){this._shadow().blur=t}get distance(){return d(this._shadow().distance)}set distance(t){this._shadow().distance=t}get angle(){return this._shadow().angle}set angle(t){this._shadow().angle=t}get transparency(){return this._shadow().transparency}set transparency(t){this._shadow().transparency=t}get color(){const t=this._shadow();return new ColorFormat(()=>t.color,e=>{t.color=e??v.color})}}export class LineFormat{def;constructor(t){return this.def=t,o(this,"LineFormat")}get color(){return new ColorFormat(()=>this.def.line??void 0,t=>{this.def.line=t??null})}get fill(){return new FillFormat(()=>this.def.line,t=>{this.def.line=t},"dk1")}get width(){return d(this.def.line_width??0)}set width(t){this.def.line_width=t}get dash_style(){return this.def.line_dash??null}set dash_style(t){t===null?delete this.def.line_dash:this.def.line_dash=t}get begin_arrow(){return this.def.line_begin??"none"}set begin_arrow(t){this.def.line_begin=t}get end_arrow(){return this.def.line_end??"none"}set end_arrow(t){this.def.line_end=t}}export class Background{holder;constructor(t){return this.holder=t,o(this,"_Background")}get fill(){return new FillFormat(()=>this.holder.background,t=>{this.holder.background=t??"lt1"})}}export const adjustmentDefaults=i=>z(i).map(t=>t.value/1e5);export class Adjustments{def;constructor(t){return this.def=t,o(this,"Adjustments",{index:e=>this._values()[e],setIndex:(e,s)=>{this._set(e,Number(s))}})}_values(){return this.def.adjustments??adjustmentDefaults(this.def.geometry??"rect")}get length(){return this._values().length}_set(t,e){const s=this._values();if(t<0||t>=s.length)throw new RangeError(`adjustments[${String(t)}]: ${this.def.geometry??"this shape"} has ${String(s.length)}.`);if(!Number.isFinite(e))throw new Error(`adjustments[${String(t)}] = ${String(e)} is not a number.`);s[t]=e,this.def.adjustments=s}}const V={left:0,top:0,width:0,height:0};export class Shape{def;inherit;constructor(t,e=()=>{}){return this.def=t,this.inherit=e,o(this,"Shape")}get _def(){return this.def}_frame(){return this.def.frame??this.inherit()??V}_own(){return this.def.frame??={...this._frame()},this.def.frame}get name(){return this.def.name}set name(t){this.def.name=t}get shape_type(){return this.def.path?"freeform":R(this.def.geometry)?"line":this.def.kind}get is_placeholder(){return this.def.kind==="placeholder"}get has_table(){return this.def.table!==void 0}get has_chart(){return this.def.chart!==void 0}get chart(){if(!this.def.chart)throw new Error(`${this.def.name} is not a chart.`);return new D(this.def.chart)}get table(){if(!this.def.table)throw new Error(`${this.def.name} is not a table.`);return new Table(this.def.table)}get placeholder_format(){if(!this.def.placeholder)throw new Error(`${this.def.name} is not a placeholder.`);return o({...this.def.placeholder},"_PlaceholderFormat")}get left(){return d(this._frame().left)}set left(t){this._own().left=t}get top(){return d(this._frame().top)}set top(t){this._own().top=t}get width(){return d(this._frame().width)}set width(t){this._own().width=t}get height(){return d(this._frame().height)}set height(t){this._own().height=t}get rotation(){return this.def.rotation??0}set rotation(t){if(!Number.isFinite(t))throw new Error(`${this.def.name}: rotation is a number of degrees.`);const e=(Math.trunc(t*6e4)%216e5+216e5)%216e5/6e4;e===0?Reflect.deleteProperty(this.def,"rotation"):this.def.rotation=e}get has_text_frame(){return this.def.text!==void 0}get text_frame(){if(!this.def.text)throw new Error(`${this.def.name} (a ${this.shape_type}) has no text frame: has_text_frame is false.`);return new TextFrame(this.def.text)}get text(){return this.text_frame.text}set text(t){this.text_frame.text=t}get fill(){return new FillFormat(()=>this.def.fill,t=>{this.def.fill=t},"lt1",this.def)}get line(){return new LineFormat(this.def)}get shadow(){return new ShadowFormat(this.def)}get adjustments(){return new Adjustments(this.def)}}const tt=i=>typeof i=="number"&&Number.isFinite(i),g=(i,t,e,s,{line:r=!1}={})=>{for(const[n,h]of Object.entries({left:i,top:t,width:e,height:s}))if(!tt(h))throw new Error(`${n} ${String(h)} is not a length (Emu, Inches, Pt, Cm, Mm).`);if(r?e<0||s<0:e<=0||s<=0)throw new Error("A shape's width and height are over 0.");return{left:Math.trunc(i),top:Math.trunc(t),width:Math.trunc(e),height:Math.trunc(s)}},et=new Set(Object.values(M));export class FreeformBuilder{steps;sx;sy;make;constructor(t,e,s){return this.steps=[{op:"move",x:t[0],y:t[1]}],[this.sx,this.sy]=typeof e=="number"?[e,e]:e,this.make=s,o(this,"FreeformBuilder")}add_line_segments(t,e=!0){for(const[s,r]of t)this.steps.push({op:"line",x:s,y:r});return e&&this.steps.push({op:"close"}),this}add_curve_segment(t,e,s,r,n,h){return this.steps.push({op:"curve",x1:t,y1:e,x2:s,y2:r,x:n,y:h}),this}move_to(t,e){return this.steps.push({op:"move",x:t,y:e}),this}convert_to_shape(t=0,e=0){this.steps.length<2&&m("convert_to_shape(): a freeform needs a segment.");const s=this.steps.flatMap(a=>a.op==="close"?[]:a.op==="curve"?[[a.x1,a.y1],[a.x2,a.y2],[a.x,a.y]]:[[a.x,a.y]]),r=s.map(a=>a[0]),n=s.map(a=>a[1]),h=Math.min(...r),l=Math.min(...n),f=Math.max(...r)-h,u=Math.max(...n)-l,c=(a,_)=>({x:a-h,y:_-l});return this.make({w:f,h:u,steps:this.steps.map(a=>{if(a.op==="close")return a;if(a.op!=="curve")return{op:a.op,...c(a.x,a.y)};const _=c(a.x1,a.y1),x=c(a.x2,a.y2);return{op:"curve",x1:_.x,y1:_.y,x2:x.x,y2:x.y,...c(a.x,a.y)}})},g(Math.round(h*this.sx)+t,Math.round(l*this.sy)+e,Math.round(f*this.sx),Math.round(u*this.sy)))}}export class GroupShape{list;_name;make;constructor(t,e,s){return this.list=t,this._name=e,this.make=s,o(this,"GroupShape")}members(){return this.list.filter(t=>t.group===this._name)}box(){const t=this.members().flatMap(r=>r.frame?[r.frame]:[]),e=Math.min(...t.map(r=>r.left)),s=Math.min(...t.map(r=>r.top));return{left:t.length>0?e:0,top:t.length>0?s:0,right:Math.max(0,...t.map(r=>r.left+r.width)),bottom:Math.max(0,...t.map(r=>r.top+r.height))}}get shapes(){return this.make(this._name)}get shape_type(){return B.GROUP}get name(){return this._name}set name(t){for(const e of this.members())e.group=t;this._name=t}get left(){return d(this.box().left)}set left(t){const e=t-this.box().left;for(const s of this.members())s.frame&&(s.frame.left+=e)}get top(){return d(this.box().top)}set top(t){const e=t-this.box().top;for(const s of this.members())s.frame&&(s.frame.top+=e)}get width(){const t=this.box();return d(t.right-t.left)}get height(){const t=this.box();return d(t.bottom-t.top)}}export class Cell{def;table;row;col;constructor(t,e,s,r){return this.def=t,this.table=e,this.row=s,this.col=r,o(this,"_Cell")}get text_frame(){return new TextFrame(this.def.text)}get text(){return this.text_frame.text}set text(t){this.text_frame.text=t}get fill(){return new FillFormat(()=>this.def.fill,t=>{this.def.fill=t})}get borders(){return this.def.borders??{}}set borders(t){this.def.borders=t}get margin_left(){return d(this.def.text.margin_left??w.left)}set margin_left(t){this.def.text.margin_left=t}get margin_right(){return d(this.def.text.margin_right??w.right)}set margin_right(t){this.def.text.margin_right=t}get margin_top(){return d(this.def.text.margin_top??w.top)}set margin_top(t){this.def.text.margin_top=t}get margin_bottom(){return d(this.def.text.margin_bottom??w.bottom)}set margin_bottom(t){this.def.text.margin_bottom=t}get vertical_anchor(){return this.def.text.vertical_anchor}set vertical_anchor(t){t===void 0?delete this.def.text.vertical_anchor:this.def.text.vertical_anchor=t}get is_merge_origin(){return(this.def.span_width??1)>1||(this.def.span_height??1)>1}get is_spanned(){return this.def.spanned===!0}get span_width(){return this.def.span_width??1}get span_height(){return this.def.span_height??1}merge(t){const e=[this.row,t.row].sort((f,u)=>f-u),s=[this.col,t.col].sort((f,u)=>f-u),[r=0,n=0]=e,[h=0,l=0]=s;for(let f=r;f<=n;f++)for(let u=h;u<=l;u++){const c=this.table.rows[f]?.cells[u];c&&(f===r&&u===h?(l>h&&(c.span_width=l-h+1),n>r&&(c.span_height=n-r+1)):c.spanned=!0)}}split(){const t=this.span_width,e=this.span_height;delete this.def.span_width,delete this.def.span_height;for(let s=this.row;s<this.row+e;s++)for(let r=this.col;r<this.col+t;r++){const n=this.table.rows[s]?.cells[r];n&&delete n.spanned}}}export class Column{def;at;constructor(t,e){return this.def=t,this.at=e,o(this,"_Column")}get width(){return d(this.def.columns[this.at]??0)}set width(t){this.def.columns[this.at]=t}}export class Row{def;at;constructor(t,e){return this.def=t,this.at=e,o(this,"_Row")}get row(){const t=this.def.rows[this.at];if(!t)throw new Error(`The table has no row ${String(this.at)}.`);return t}get height(){return d(this.row.height)}set height(t){this.row.height=t}}export class Table{def;constructor(t){return this.def=t,o(this,"Table")}cell(t,e){const s=this.def.rows[t]?.cells[e];if(!s)throw new Error(`cell(): the table has ${String(this.def.rows.length)} rows and ${String(this.def.columns.length)} columns.`);return new Cell(s,this.def,t,e)}*iter_cells(){for(let t=0;t<this.def.rows.length;t++)for(let e=0;e<this.def.columns.length;e++)yield this.cell(t,e)}get columns(){return this.def.columns.map((t,e)=>new Column(this.def,e))}get rows(){return this.def.rows.map((t,e)=>new Row(this.def,e))}flag(t){return this.def[t]===!0}get first_row(){return this.flag("first_row")}set first_row(t){this.def.first_row=t}get first_col(){return this.flag("first_col")}set first_col(t){this.def.first_col=t}get last_row(){return this.flag("last_row")}set last_row(t){this.def.last_row=t}get last_col(){return this.flag("last_col")}set last_col(t){this.def.last_col=t}get horz_banding(){return this.flag("horz_banding")}set horz_banding(t){this.def.horz_banding=t}get vert_banding(){return this.flag("vert_banding")}set vert_banding(t){this.def.vert_banding=t}}function st(i,t,e=[]){const s=new Set([...i,...e].map(n=>n.name));let r=1;for(;s.has(`${t}-${String(r)}`);)r++;return`${t}-${String(r)}`}export class ShapeCollection{list;base;components;inherit;group;under;constructor(t,e,s,r=()=>{},n=()=>[],h){return this.list=t,this.base=e,this.components=s,this.inherit=r,this.under=n,this.group=h,o(this,"SlideShapes",{index:l=>this._at(l)})}_wrap(t){return new Shape(t,()=>this.inherit(t))}_at(t){const e=this.list[t];return e?this._wrap(e):void 0}*[Symbol.iterator](){for(const t of this.list)yield this._wrap(t)}get length(){return this.list.length}get(t){const e=this.list.find(s=>s.name===t);return e?this._wrap(e):void 0}get title(){const t=this.list.find(e=>e.placeholder?.type==="title"||e.placeholder?.type==="ctrTitle");return t?this._wrap(t):void 0}get placeholders(){return new Placeholders(this.list,this.inherit)}_add(t,e){const s={name:st(this.list,t,this.under()),...e,...this.group===void 0?{}:{group:this.group}};return this.list.push(s),this._wrap(s)}add_textbox(t,e,s,r){return this._add("textbox",{kind:"textbox",frame:g(t,e,s,r),text:{...E(),...J}})}add_picture(t,e,s,r,n){return(r===void 0||n===void 0)&&m("add_picture() takes a width and a height here: a picture's own size is not read while a deck's code runs"),this._add("picture",{kind:"picture",frame:g(e,s,r??0,n??0),media:{path:t,base:this.base}})}add_movie(t,e,s,r,n,h={}){return this._add("movie",{kind:"movie",frame:g(e,s,r,n),media:{path:t,base:this.base,...h.poster_frame_time===void 0?{}:{poster:h.poster_frame_time}}})}add_shape(t,e,s,r,n){et.has(t)||m(`add_shape(): ${t} is not one of MSO_SHAPE's ${Object.keys(M).join(", ")}`);const h=E();return h.vertical_anchor=p.vertical_anchor,h.paragraphs=[{runs:[],level:0,alignment:p.alignment}],this._add("shape",{kind:"autoshape",frame:g(e,s,r,n),geometry:t,fill:p.fill,line:p.line,line_width:p.line_width,text:h})}add_table(t,e,s,r,n,h){(t<1||e<1)&&m("add_table(): a table has at least a row and a column.");const l=Math.floor(n/e),f=Math.floor(h/t);return this._add("table",{kind:"table",frame:g(s,r,n,h),table:{columns:Array.from({length:e},()=>l),rows:Array.from({length:t},()=>({height:f,cells:Array.from({length:e},()=>({text:E()}))}))}})}add_chart(t,e,s,r,n,h){return this._add("chart",{kind:"chart",frame:g(e,s,r,n),chart:{type:t,categories:[...h.categories],series:h._series()}})}add_group_shape(){this.group!==void 0&&m("add_group_shape(): a group here holds shapes, not another group.");let t=1;for(;this.list.some(e=>e.group===`group-${String(t)}`);)t++;return new GroupShape(this.list,`group-${String(t)}`,e=>new ShapeCollection(this.list,this.base,this.components,this.inherit,this.under,e))}build_freeform(t=0,e=0,s=1){return new FreeformBuilder([t,e],s,(r,n)=>{const h=E();return h.vertical_anchor=p.vertical_anchor,h.paragraphs=[{runs:[],level:0,alignment:p.alignment}],this._add("freeform",{kind:"autoshape",frame:n,path:r,fill:p.fill,line:p.line,line_width:p.line_width,text:h})})}add_connector(t,e,s,r,n){R(t)||m(`add_connector(): ${t} is not one of MSO_CONNECTOR's ${Object.keys(I).join(", ")}, nor a connector's preset (${H.join(", ")})`);const h=g(Math.min(e,r),Math.min(s,n),Math.abs(r-e),Math.abs(n-s),{line:!0}),l=r<e,f=n<s;return this._add("connector",{kind:"autoshape",frame:h,geometry:t,...l||f?{flip:{...l?{h:l}:{},...f?{v:f}:{}}}:{},line:P.line,line_width:P.line_width})}add_component(t,e,s,r,n,h={}){if(!Object.hasOwn(this.components(),t))throw new Error(`add_component(): the presentation has no component ${t}; add it with prs.components.add("${t}", { … }) first.`);return this._add(t,{kind:"component",frame:g(e,s,r,n),component:{name:t,props:h}})}}export const NAME_OF_TYPE={title:"title",ctrTitle:"title",subTitle:"subtitle",body:"body",pic:"picture",media:"media",obj:"content",dt:"date",ftr:"footer",sldNum:"slide-number"};export class Placeholders{list;inherit;constructor(t,e=()=>{}){return this.list=t,this.inherit=e,o(this,"placeholders",{index:s=>this.get(s)})}_wrap(t){return new Shape(t,()=>this.inherit(t))}*[Symbol.iterator](){for(const t of this.list)t.kind==="placeholder"&&(yield this._wrap(t))}get length(){return this.list.filter(t=>t.kind==="placeholder").length}get(t){const e=this.list.find(s=>s.kind==="placeholder"&&(typeof t=="number"?s.placeholder?.idx===t:s.name===t||s.placeholder?.type===t));return e?this._wrap(e):void 0}add(t,e,s,r,n,h={}){const l=typeof e=="object"?e:h,f=typeof e=="object"?void 0:e;Object.values(j).includes(t)||m(`placeholders.add(): ${t} is not one of PP_PLACEHOLDER's ${Object.keys(j).join(", ")}`);const u=this.list.filter(b=>b.kind==="placeholder"),c=new Set(u.map(b=>b.placeholder?.idx));let a=t==="title"||t==="ctrTitle"?0:U[t]??1;for(;c.has(a)&&a!==0;)a++;if(c.has(a))throw new Error("A layout has one title placeholder (idx 0).");const _=l.name??NAME_OF_TYPE[t];if(this.list.some(b=>b.name===_))throw new Error(`Two shapes are ${_}: give the placeholder a name ({ name }).`);const x=[f,s,r,n].filter(b=>b!==void 0);if(x.length!==0&&x.length!==4)throw new Error("placeholders.add(type, left, top, width, height): give all four, or none to take the master's frame.");const $={name:_,kind:"placeholder",placeholder:{type:t,idx:a},...x.length===4?{frame:g(f??0,s??0,r??0,n??0)}:{},text:{paragraphs:[],levels:Y(t)}};return this.list.push($),this._wrap($)}}export class SlideLayout{def;master;ctx;constructor(t,e,s){return this.def=t,this.master=e,this.ctx=s,o(this,"SlideLayout")}get _def(){return this.def}inherit=t=>t.placeholder?A(this.master._def,t.placeholder.type)?.frame:void 0;get name(){return this.def.name}get slide_master(){return this.master}get display_master_shapes(){return this.def.display_master_shapes??!0}set display_master_shapes(t){t?delete this.def.display_master_shapes:this.def.display_master_shapes=!1}get background(){return new Background(this.def)}get placeholders(){return new Placeholders(this.def.shapes,this.inherit)}get shapes(){return new ShapeCollection(this.def.shapes,this.ctx.base,this.ctx.components,this.inherit,()=>this.master._def.shapes)}}export class SlideLayouts{list;make;constructor(t,e){return this.list=t,this.make=e,o(this,"SlideLayouts",{index:s=>this.list[s]})}*[Symbol.iterator](){yield*this.list}get length(){return this.list.length}get_by_name(t,e){return this.list.find(s=>s.name===t)??e}index(t){const e=this.list.indexOf(t);if(e<0)throw new Error(`${t.name} is not among these layouts.`);return e}add(t,e){if(!this.make)throw new Error("A layout is added to a master: master.slide_layouts.add(name).");const s=this.make(t);return e?.(s),s}}export class TextStyles{def;constructor(t){return this.def=t,o(this,"text_styles")}get title_style(){return S(this.def.title)}get body_style(){return S(this.def.body)}get other_style(){return S(this.def.other)}}export class SlideMaster{def;layouts=[];ctx;allLayouts;constructor(t,e,s){return this.def=t,this.ctx=e,this.allLayouts=s,o(this,"SlideMaster")}get _def(){return this.def}get name(){return this.def.name}get background(){return new Background(this.def)}get placeholders(){return new Placeholders(this.def.shapes)}get shapes(){return new ShapeCollection(this.def.shapes,this.ctx.base,this.ctx.components)}get text_styles(){return new TextStyles(this.def.text_styles)}get slide_layouts(){return new SlideLayouts(this.layouts,t=>{if(this.allLayouts.some(r=>r.name===t))throw new Error(`Two layouts are "${t}": a layout's name is unique in the deck, as slides.yaml names it.`);const e={name:t,master:this.def.name,shapes:[]};this.def.layouts.push(e);const s=new SlideLayout(e,this,this.ctx);return this.layouts.push(s),this.allLayouts.push(s),s})}}export class SlideMasters{list;make;constructor(t,e){return this.list=t,this.make=e,o(this,"SlideMasters",{index:s=>this.list[s]})}*[Symbol.iterator](){yield*this.list}get length(){return this.list.length}index(t){return this.list.indexOf(t)}add(t,e){const s=this.make(t);return e?.(s),s}}export class GeneratedSlide{own;def;layout;constructor(t,e,s){this.def=t,this.layout=e,this.own=e._def.shapes.filter(n=>n.kind==="placeholder").map(n=>({name:n.name,kind:"placeholder",...n.placeholder?{placeholder:{...n.placeholder}}:{},text:E()}));const r=n=>{const h=e._def.shapes.find(l=>l.kind==="placeholder"&&l.placeholder?.idx===n.placeholder?.idx);return h?h.frame??(h.placeholder?A(e.slide_master._def,h.placeholder.type)?.frame:void 0):void 0};return this._shapes=new ShapeCollection(this.own,s.base,s.components,r,()=>[...e.slide_master._def.shapes,...e._def.shapes]),this._placeholders=new Placeholders(this.own,r),o(this,"Slide")}_shapes;_placeholders;get shapes(){return this._shapes}get placeholders(){return this._placeholders}get slide_id(){return this.def.id}get slide_layout(){return this.layout}get has_notes_slide(){return this.def.notes!==void 0}get notes_slide(){const t=this.def;return o({notes_text_frame:o({get text(){return t.notes??""},set text(e){t.notes=e}},"TextFrame")},"NotesSlide")}get transition(){return this.def.transition}set transition(t){t===void 0?delete this.def.transition:this.def.transition=t}get animations(){return new Animations(this.def.animations??=[])}_done(){const t={},e=[];for(const s of this.own)s.kind==="placeholder"&&s.placeholder?(s.text?.paragraphs.some(r=>r.runs.length>0)&&(t[s.placeholder.idx]=s.text.paragraphs),s.frame&&e.push({...s,text:E()})):e.push(s);return{...this.def,shapes:e,text:t}}}export class Animations{list;constructor(t){return this.list=t,o(this,"Animations")}add(t,e,s={}){this.list.push({shape:typeof t=="string"?t:t.name,effect:e,...s})}get length(){return this.list.length}}class rt{gen;constructor(t){return this.gen=t,o(this,"slides")}add_slide(t,e){return this.gen._add(t,e)}}export class Generator{list=[];prs;ctx;constructor(t,e){return this.prs=t,this.ctx=e,o(this,"Generator")}data(t){return this.ctx.data(t)}get slides(){return new rt(this)}_add(t,e){const s=typeof t=="string"?this.prs._layout(t):t;if(!s)throw new Error(`add_slide(): the presentation has no layout ${typeof t=="string"?t:t.name}.`);if(!/^[A-Za-z0-9_-]+$/u.test(e))throw new Error(`add_slide(): ${e} is not an id of letters, digits, _ and -.`);if(this.list.some(n=>n.slide_id===e))throw new Error(`add_slide(): two slides are ${e}.`);const r=new GeneratedSlide({id:e,layout:s.name,shapes:[],text:{}},s,this.prs._ctx);return this.list.push(r),r}_made(){return this.list.map(t=>t._done())}}const it=()=>JSON.parse(JSON.stringify(X));export class Presentation{masters=[];layouts=[];def;_ctx;constructor(t,e){return this.def={slide_width:t[0],slide_height:t[1],masters:[],components:{},generators:{}},this._ctx={base:e,components:()=>this.def.components},o(this,"Presentation")}get _def(){return this.def}get slide_width(){return d(this.def.slide_width)}set slide_width(t){this.def.slide_width=t}get slide_height(){return d(this.def.slide_height)}set slide_height(t){this.def.slide_height=t}get slide_masters(){return new SlideMasters(this.masters,t=>{if(this.masters.some(r=>r.name===t))throw new Error(`Two masters are "${t}".`);const e={name:t,background:"lt1",text_styles:it(),shapes:[],layouts:[]};this.def.masters.push(e);const s=new SlideMaster(e,this._ctx,this.layouts);return this.masters.push(s),s})}get slide_master(){const t=this.masters[0];if(!t)throw new Error("The presentation has no master yet: prs.slide_masters.add(name) makes one.");return t}get slide_layouts(){const t=this.masters[0];return t?t.slide_layouts:new SlideLayouts([])}get slides(){return m("A deck's slides are slides.yaml's, in order, each on a layout, and their words the script's; slides made from data are a generator's (prs.generators.add)")}save(){return m("A deck is not saved by its code: allyhub render writes its PDF, pictures and PPTX")}get theme(){return this.def.theme??={},this.def.theme}set theme(t){this.def.theme=t}get components(){return o({add:(t,e)=>{if(Object.hasOwn(this.def.components,t))throw new Error(`Two components are "${t}".`);const s=G(t,e);if(!s)throw new Error(`Component ${t} is not a component: give what defineComponent makes, or { props, layers }.`);this.def.components[t]=s}},"components")}get generators(){return o({add:(t,e)=>{if(Object.hasOwn(this.def.generators,t))throw new Error(`Two generators are "${t}".`);this.def.generators[t]={name:t,make:s=>{const r=new Generator(this,s);return e(r),r._made()}}}},"generators")}_layout(t){return this.layouts.find(e=>e.name===t)}}export const DECK_BRAND="__allyhubDeck";export function isDeck(i){return typeof i=="object"&&i!==null&&DECK_BRAND in i}export const presentationFor=i=>(t,e)=>{const[s,r]=typeof t=="function"?[{},t]:[t,e];if(typeof r!="function")throw new Error("An item's slides.ts exports one deck: export default presentation({ size }, (prs) => { … masters, layouts, components … }); its slides are slides.yaml.");if(typeof s.size=="string"&&!Object.hasOwn(k,s.size))throw new Error(`presentation(): size ${s.size} is not one of ${Object.keys(k).join(", ")}, or { width, height } in EMU.`);return{[DECK_BRAND]:!0,kind:"slides",options:s,build:r,written:{file:i}}};export function evaluateDeck(i){const t=i.options.size??"16:9",e=typeof t=="string"?k[t]:[t.width,t.height],s=i.written.file.split("/").slice(0,-1).join("/"),r=new Presentation(e,s);return i.options.theme&&(r.theme=JSON.parse(JSON.stringify(i.options.theme))),i.build(r),r._def}

package/dist/node_modules/@allyhub/slides-core/dist/chart-api.d.ts

@@ -0,0 +1,202 @@
+import type { ChartLegendPosition, ChartType } from "@allyhub/formats";
+import { ColorFormat, FillFormat } from "./api.js";
+import type { ChartAxisDef, ChartDef, ChartLabelPosition, ChartLabelsDef, ChartSeriesDef } from "@allyhub/chart";
+import type { Color } from "./model.js";
+import { type Length, type LengthValue } from "./units.js";
+/** The numbers a chart shows (python-pptx's `CategoryChartData`). */
+export declare class CategoryChartData {
+    number_format: string;
+    private names;
+    private readonly list;
+    constructor(options?: {
+        number_format?: string;
+    });
+    get categories(): string[];
+    set categories(v: readonly (string | number)[]);
+    add_category(label: string | number): void;
+    add_series(name: string, values?: readonly (number | null | undefined)[], number_format?: string): void;
+    /** The series as a chart holds them. */
+    _series(): ChartSeriesDef[];
+}
+/** python-pptx's `XySeriesData`: a series of an XY chart, a point at a time. */
+export declare class XySeriesData {
+    readonly points: {
+        x: number;
+        y: number;
+    }[];
+    readonly name: string;
+    constructor(name: string);
+    add_data_point(x: number, y: number): void;
+}
+/** python-pptx's `XyChartData`: what an XY scatter chart shows. */
+export declare class XyChartData {
+    number_format: string;
+    private readonly list;
+    constructor(options?: {
+        number_format?: string;
+    });
+    add_series(name: string): XySeriesData;
+    /** The chart's data: an XY chart has no categories. */
+    get categories(): string[];
+    /** The series as a chart holds them. */
+    _series(): ChartSeriesDef[];
+}
+/** A chart's text, or its labels' (`font`). */
+export declare class ChartFont {
+    private readonly read;
+    private readonly write;
+    constructor(read: () => {
+        size?: number;
+        color?: Color;
+    }, write: (v: {
+        size?: number;
+        color?: Color;
+    }) => void);
+    get size(): LengthValue | undefined;
+    set size(v: Length | undefined);
+    get color(): ColorFormat;
+}
+/** A line's colour (`format.line`). */
+export declare class ChartLine {
+    private readonly read;
+    private readonly write;
+    constructor(read: () => Color | undefined, write: (c: Color | undefined) => void);
+    get color(): ColorFormat;
+}
+/** A series (python-pptx's `BarSeries`, `LineSeries`…). */
+export declare class ChartSeries {
+    private readonly def;
+    private readonly at;
+    constructor(def: ChartSeriesDef, at: number);
+    get name(): string;
+    get values(): readonly (number | null)[];
+    /** A marker's size in points (`marker.size`). */
+    get marker(): {
+        size: number | undefined;
+    };
+    get smooth(): boolean;
+    set smooth(v: boolean);
+    /** Its fill (`format.fill`), and its line's width (`format.line.width`); a line's or an area's colour is the fill's. */
+    get format(): {
+        fill: FillFormat;
+        line: {
+            width: Length | undefined;
+        };
+    };
+}
+/** Data labels (python-pptx's `DataLabels`). */
+export declare class DataLabels {
+    private readonly def;
+    constructor(def: ChartLabelsDef);
+    get show_value(): boolean;
+    set show_value(v: boolean);
+    get show_percentage(): boolean;
+    set show_percentage(v: boolean);
+    get show_category_name(): boolean;
+    set show_category_name(v: boolean);
+    get show_series_name(): boolean;
+    set show_series_name(v: boolean);
+    get number_format(): string;
+    set number_format(v: string);
+    get position(): ChartLabelPosition | undefined;
+    set position(v: ChartLabelPosition | undefined);
+    get font(): ChartFont;
+}
+/** A chart's plot (python-pptx's `BarPlot`, `LinePlot`…). */
+export declare class ChartPlot {
+    private readonly def;
+    constructor(def: ChartDef);
+    get categories(): readonly string[];
+    get series(): ChartSeries[];
+    get has_data_labels(): boolean;
+    set has_data_labels(v: boolean);
+    get data_labels(): DataLabels;
+    /** Between bars' groups, as a share of a bar's width, in %. */
+    get gap_width(): number;
+    set gap_width(v: number);
+    get overlap(): number;
+    set overlap(v: number);
+    get vary_by_categories(): boolean;
+    set vary_by_categories(v: boolean);
+}
+/** A chart's legend (python-pptx's `Legend`). */
+export declare class ChartLegend {
+    private readonly def;
+    constructor(def: ChartDef);
+    get position(): ChartLegendPosition;
+    set position(v: ChartLegendPosition);
+    /** Whether the plot is made smaller for it (true, as python-pptx's default), or it is drawn over the plot. */
+    get include_in_layout(): boolean;
+    set include_in_layout(v: boolean);
+}
+/** An axis's tick labels (python-pptx's `TickLabels`): their number format. */
+export declare class TickLabels {
+    private readonly def;
+    constructor(def: ChartAxisDef);
+    get number_format(): string;
+    set number_format(v: string);
+}
+/** A chart's gridlines (python-pptx's `MajorGridlines`): their line. */
+export declare class MajorGridlines {
+    private readonly line;
+    constructor(line: ChartLine);
+    get format(): ChartFormat;
+}
+/** What a chart's part is drawn with (python-pptx's `ChartFormat`): its line. */
+export declare class ChartFormat {
+    private readonly held;
+    constructor(line: ChartLine);
+    get line(): ChartLine;
+}
+/** A chart's axis (python-pptx's `ValueAxis`, `CategoryAxis`). */
+export declare class ChartAxis {
+    private readonly def;
+    constructor(def: ChartAxisDef);
+    get minimum_scale(): number | undefined;
+    set minimum_scale(v: number | undefined);
+    get maximum_scale(): number | undefined;
+    set maximum_scale(v: number | undefined);
+    get major_unit(): number | undefined;
+    set major_unit(v: number | undefined);
+    get has_major_gridlines(): boolean;
+    set has_major_gridlines(v: boolean);
+    get visible(): boolean;
+    set visible(v: boolean);
+    get reverse_order(): boolean;
+    set reverse_order(v: boolean);
+    /** Its tick labels' format (`tick_labels.number_format`). */
+    get tick_labels(): TickLabels;
+    /** Its gridlines' colour (`major_gridlines.format.line.color`). */
+    get major_gridlines(): MajorGridlines;
+    /** Its line's colour (`format.line.color`). */
+    get format(): ChartFormat;
+}
+/** A chart (python-pptx's `Chart`), in its shape's `.chart`. */
+export declare class Chart {
+    private readonly def;
+    constructor(def: ChartDef);
+    get chart_type(): ChartType;
+    get has_legend(): boolean;
+    set has_legend(v: boolean);
+    get legend(): ChartLegend;
+    get has_title(): boolean;
+    set has_title(v: boolean);
+    /** Its title (`chart_title.text_frame.text`, and `chart_title.font.size`). */
+    get chart_title(): {
+        text_frame: {
+            text: string;
+        };
+        font: {
+            size: Length | undefined;
+        };
+    };
+    /** Its text's size and colour. */
+    get font(): ChartFont;
+    get plots(): ChartPlot[];
+    get series(): ChartSeries[];
+    get value_axis(): ChartAxis;
+    get category_axis(): ChartAxis;
+    /** Other numbers, in its look. */
+    replace_data(chart_data: CategoryChartData): void;
+}
+//# sourceMappingURL=chart-api.d.ts.map

package/dist/node_modules/@allyhub/slides-core/dist/chart-api.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{ColorFormat as h,FillFormat as l}from"./api.js";import{accentOf as f,isRound as u}from"@allyhub/chart";import{strict as s}from"./strict.js";import{Pt as n,length as d}from"./units.js";export class CategoryChartData{number_format;names=[];list=[];constructor(e={}){return this.number_format=e.number_format??"General",s(this,"CategoryChartData")}get categories(){return this.names}set categories(e){this.names=e.map(String)}add_category(e){this.names.push(String(e))}add_series(e,t=[],i){this.list.push({name:e,values:t.map(a=>a??null),...i===void 0?{}:{number_format:i}})}_series(){return this.list.map(e=>({...e,values:[...e.values],number_format:e.number_format??this.number_format}))}}export class XySeriesData{points=[];name;constructor(e){return this.name=e,s(this,"XySeriesData")}add_data_point(e,t){this.points.push({x:e,y:t})}}export class XyChartData{number_format;list=[];constructor(e={}){return this.number_format=e.number_format??"General",s(this,"XyChartData")}add_series(e){const t=new XySeriesData(e);return this.list.push(t),t}get categories(){return[]}_series(){return this.list.map(e=>({name:e.name,values:e.points.map(t=>t.y),x:e.points.map(t=>t.x),number_format:this.number_format}))}}const _=r=>r===void 0?void 0:r/n(1);export class ChartFont{read;write;constructor(e,t){return this.read=e,this.write=t,s(this,"ChartFont")}get size(){const e=this.read().size;return e===void 0?void 0:d(n(e))}set size(e){const t=this.read(),i=_(e);this.write({...t.color===void 0?{}:{color:t.color},...i===void 0?{}:{size:i}})}get color(){return new h(()=>this.read().color,e=>{const{size:t}=this.read();this.write({...t===void 0?{}:{size:t},...e===void 0?{}:{color:e}})})}}export class ChartLine{read;write;constructor(e,t){return this.read=e,this.write=t,s(this,"ChartLine")}get color(){return new h(this.read,this.write)}}export class ChartSeries{def;at;constructor(e,t){return this.def=e,this.at=t,s(this,"ChartSeries")}get name(){return this.def.name}get values(){return this.def.values}get marker(){const e=this.def;return s({get size(){return e.marker_size},set size(t){t===void 0?delete e.marker_size:e.marker_size=t}},"Marker")}get smooth(){return this.def.smooth===!0}set smooth(e){this.def.smooth=e}get format(){const e=this.def;return s({line:s({get width(){return e.line_width===void 0?void 0:d(n(e.line_width))},set width(t){t===void 0?delete e.line_width:e.line_width=t/n(1)}},"LineFormat"),fill:new l(()=>this.def.color??f(this.at),t=>{t!==null&&(this.def.color=t)})},"ChartFormat")}}export class DataLabels{def;constructor(e){return this.def=e,s(this,"DataLabels")}get show_value(){return this.def.show_value??!1}set show_value(e){this.def.show_value=e}get show_percentage(){return this.def.show_percentage??!1}set show_percentage(e){this.def.show_percentage=e}get show_category_name(){return this.def.show_category_name??!1}set show_category_name(e){this.def.show_category_name=e}get show_series_name(){return this.def.show_series_name??!1}set show_series_name(e){this.def.show_series_name=e}get number_format(){return this.def.number_format??"General"}set number_format(e){this.def.number_format=e}get position(){return this.def.position}set position(e){e===void 0?delete this.def.position:this.def.position=e}get font(){return new ChartFont(()=>({...this.def.size===void 0?{}:{size:this.def.size},...this.def.color===void 0?{}:{color:this.def.color}}),e=>{delete this.def.size,delete this.def.color,Object.assign(this.def,e)})}}export class ChartPlot{def;constructor(e){return this.def=e,s(this,"ChartPlot")}get categories(){return this.def.categories}get series(){return this.def.series.map((e,t)=>new ChartSeries(e,t))}get has_data_labels(){return this.def.labels!==void 0}set has_data_labels(e){e?this.def.labels??={show_value:!0}:delete this.def.labels}get data_labels(){return this.def.labels??={show_value:!0},new DataLabels(this.def.labels)}get gap_width(){return this.def.gap_width??150}set gap_width(e){this.def.gap_width=e}get overlap(){return this.def.overlap??0}set overlap(e){this.def.overlap=e}get vary_by_categories(){return this.def.vary_by_categories??u(this.def.type)}set vary_by_categories(e){this.def.vary_by_categories=e}}export class ChartLegend{def;constructor(e){return this.def=e,s(this,"ChartLegend")}get position(){return this.def.legend??"right"}set position(e){this.def.legend=e}get include_in_layout(){return this.def.legend_overlay!==!0}set include_in_layout(e){e?delete this.def.legend_overlay:this.def.legend_overlay=!0}}export class TickLabels{def;constructor(e){return this.def=e,s(this,"TickLabels")}get number_format(){return this.def.number_format??"General"}set number_format(e){this.def.number_format=e}}export class MajorGridlines{line;constructor(e){return this.line=e,s(this,"MajorGridlines")}get format(){return new ChartFormat(this.line)}}export class ChartFormat{held;constructor(e){return this.held=e,s(this,"ChartFormat")}get line(){return this.held}}export class ChartAxis{def;constructor(e){return this.def=e,s(this,"ChartAxis")}get minimum_scale(){return this.def.minimum_scale}set minimum_scale(e){e===void 0?delete this.def.minimum_scale:this.def.minimum_scale=e}get maximum_scale(){return this.def.maximum_scale}set maximum_scale(e){e===void 0?delete this.def.maximum_scale:this.def.maximum_scale=e}get major_unit(){return this.def.major_unit}set major_unit(e){e===void 0?delete this.def.major_unit:this.def.major_unit=e}get has_major_gridlines(){return this.def.has_major_gridlines??!0}set has_major_gridlines(e){this.def.has_major_gridlines=e}get visible(){return this.def.visible??!0}set visible(e){this.def.visible=e}get reverse_order(){return this.def.reverse_order??!1}set reverse_order(e){this.def.reverse_order=e}get tick_labels(){return new TickLabels(this.def)}get major_gridlines(){return new MajorGridlines(new ChartLine(()=>this.def.gridline_color,e=>{e===void 0?delete this.def.gridline_color:this.def.gridline_color=e}))}get format(){return new ChartFormat(new ChartLine(()=>this.def.line_color,e=>{e===void 0?delete this.def.line_color:this.def.line_color=e}))}}export class Chart{def;constructor(e){return this.def=e,s(this,"Chart")}get chart_type(){return this.def.type}get has_legend(){return this.def.legend!==void 0}set has_legend(e){e?this.def.legend??="right":delete this.def.legend}get legend(){return new ChartLegend(this.def)}get has_title(){return this.def.title!==void 0}set has_title(e){e?this.def.title??="":delete this.def.title}get chart_title(){const e=this.def;return s({font:s({get size(){return e.title_size===void 0?void 0:d(n(e.title_size))},set size(t){t===void 0?delete e.title_size:e.title_size=t/n(1)}},"Font"),text_frame:s({get text(){return e.title??""},set text(t){e.title=t}},"TextFrame")},"ChartTitle")}get font(){return new ChartFont(()=>({...this.def.font_size===void 0?{}:{size:this.def.font_size},...this.def.font_color===void 0?{}:{color:this.def.font_color}}),e=>{delete this.def.font_size,delete this.def.font_color,e.size!==void 0&&(this.def.font_size=e.size),e.color!==void 0&&(this.def.font_color=e.color)})}get plots(){return[new ChartPlot(this.def)]}get series(){return this.def.series.map((e,t)=>new ChartSeries(e,t))}get value_axis(){return this.def.value_axis??={},new ChartAxis(this.def.value_axis)}get category_axis(){return this.def.category_axis??={},new ChartAxis(this.def.category_axis)}replace_data(e){const t=this.def.series;this.def.categories=[...e.categories],this.def.series=e._series().map((i,a)=>{const o=t[a]?.color;return o===void 0?i:{...i,color:o}})}}

package/dist/node_modules/@allyhub/slides-core/dist/code.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{DeckCodeSchema as a}from"@allyhub/formats";export function deckCode(e,r){const t={};for(const[o,n]of Object.entries(e.generators))try{t[o]=n.make({data:r??(()=>{throw new Error("No data here.")})})}catch(s){t[o]={error:s instanceof Error?s.message:String(s),...s instanceof Error&&s.stack!==void 0?{stack:s.stack}:{}}}const c={slide_width:e.slide_width,slide_height:e.slide_height,...e.theme===void 0?{}:{theme:e.theme},masters:e.masters,components:Object.fromEntries(Object.entries(e.components).map(([o,n])=>[o,{props:n.props}])),generators:t};return i(c)}function i(e){const r=JSON.stringify(e),t=JSON.parse(r);if(!isDeckCode(t))throw new Error("The deck's code made something that is not data.");return t}export function isDeckCode(e){return a.safeParse(e).success}export function deckCodeProblems(e){const r=a.safeParse(e);return r.success?[]:r.error.issues.map(t=>`${t.path.map(String).join(".")||"(top)"}: ${t.message}`)}

package/dist/node_modules/@allyhub/slides-core/dist/file.d.ts

@@ -0,0 +1,131 @@
+import { type AnimationFile, type BackgroundFile, type ShapeFile, type TransitionFile, type SlideFile, type SlidesFile } from "@allyhub/formats";
+import { type Document } from "yaml";
+export interface FileProblem {
+    /** Where in the file, as `slides.2.shapes.Title.frame`. */
+    path: string;
+    line?: number;
+    message: string;
+}
+/**
+ * slides.yaml's text read: its slides, or none when it is not the format;
+ * the slides of it that are (`readable`, every slide that is the format,
+ * the first of two of one id), so what else is wrong can be found in the
+ * same pass; every problem; and the line of any path.
+ */
+export declare function readSlidesFile(text: string): {
+    file?: SlidesFile;
+    /** The slides that are the format, and the line of a path in them. */
+    readable?: {
+        file: SlidesFile;
+        lineOf: (path: string) => number | undefined;
+    };
+    problems: FileProblem[];
+    lineOf: (path: string) => number | undefined;
+};
+export type SlidesEdit = 
+/** A slide put after another, or first (null). */
+{
+    op: "move";
+    slide: string;
+    after: string | null;
+}
+/** A slide put after another (null: first; undefined: last). */
+ | {
+    op: "add";
+    slide: SlideFile;
+    after?: string | null;
+} | {
+    op: "duplicate";
+    slide: string;
+    id: string;
+} | {
+    op: "remove";
+    slide: string;
+} | {
+    op: "layout";
+    slide: string;
+    layout: string;
+}
+/** Hidden (a block: those of its slides), or shown (false). */
+ | {
+    op: "hidden";
+    slide: string;
+    hidden: boolean | string[];
+}
+/**
+ * Fields of a shape set (undefined takes one away); the entry is made
+ * when there is none. A key may go into a field (`text.size`), so two
+ * hands' changes to one field's parts both stand.
+ */
+ | {
+    op: "shape";
+    slide: string;
+    shape: string;
+    set: {
+        [K in keyof ShapeFile]?: ShapeFile[K] | undefined;
+    } & Record<`${"text" | "props" | "crop"}.${string}`, unknown>;
+} | {
+    op: "unplace";
+    slide: string;
+    shape: string;
+}
+/**
+ * A shape named on the slide or not: a layout's date, footer and slide
+ * number show where slides.yaml names them (`slide-number: {}`). Shown,
+ * its entry is there, empty if it had none; not, it is taken away.
+ */
+ | {
+    op: "show";
+    slide: string;
+    shape: string;
+    shown: boolean;
+}
+/** A shape's changes taken away: it is its layout's again. */
+ | {
+    op: "reset";
+    slide: string;
+    shape?: string;
+}
+/** Its Animation Pane, whole; none takes it away. */
+ | {
+    op: "animations";
+    slide: string;
+    animations: AnimationFile[];
+}
+/** How it comes on; none takes it away. */
+ | {
+    op: "transition";
+    slide: string;
+    transition?: TransitionFile;
+}
+/** When a show goes on from it by itself, seconds; none takes it away. */
+ | {
+    op: "advance";
+    slide: string;
+    after?: number;
+}
+/** Its own background over its layout's; none takes it away. */
+ | {
+    op: "background";
+    slide: string;
+    background?: BackgroundFile;
+};
+/** slides.yaml's text after an edit. */
+export declare function editSlidesFile(text: string | undefined, edit: SlidesEdit): string;
+/**
+ * An edit made on slides.yaml's parsed document, in place: only the nodes
+ * it changes are touched, so an editor that keeps the document edits a
+ * long file in the time one slide takes. False when it changed nothing
+ * (its slide is not there).
+ */
+export declare function editSlidesDocument(doc: Document, edit: SlidesEdit): boolean;
+/** An id or a name no slide or shape has yet, from a stem: `cover`, `cover-2`… */
+export declare function freeName(taken: Iterable<string>, stem: string): string;
+/**
+ * What `b` changes of `a`, as edits: slides removed, added and moved (a
+ * slide is moved only when it leaves the order the two share), then each
+ * slide's own changes. Made over `a` they make `b`; made over a file
+ * another hand changed from `a`, they are `b`'s changes kept.
+ */
+export declare function slidesEdits(a: SlidesFile, b: SlidesFile): SlidesEdit[];
+//# sourceMappingURL=file.d.ts.map

package/dist/node_modules/@allyhub/slides-core/dist/file.js

@@ -0,0 +1,4 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{readDataFile as N}from"@allyhub/formats";import{isCollection as $,isMap as b,isSeq as j,LineCounter as I,parseDocument as x}from"yaml";import{commonPairs as M,sameValue as O}from"./values.js";export function readSlidesFile(t){const e=new I,s=x(t,{lineCounter:e}),o=f=>{const g=f===""?[]:f.split(".");for(let p=g.length;p>=0;p--){const S=s.getIn(g.slice(0,p).map(y=>/^\d+$/u.test(y)?Number(y):y),!0)?.range?.[0];if(S!==void 0)return e.linePos(S).line}};if(s.errors.length>0)return{problems:s.errors.map(f=>({path:"",line:e.linePos(f.pos[0]).line,message:`not YAML: ${f.message.split(`
+`)[0]??""}`})),lineOf:o};const l=s.toJS()??{},r=N("slides",l);if(r.ok)return{file:r.value,readable:{file:r.value,lineOf:o},problems:[],lineOf:o};const n=[],h=(f,g)=>{const p=o(f);n.push({path:f,...p===void 0?{}:{line:p},message:g})},a=(f,g)=>{h(f,C(g,P(l,f)))},i=typeof l=="object"&&l!==null&&"slides"in l?l.slides:void 0,d=Array.isArray(i)?i:[],u=N("slides",{...l,...Array.isArray(i)?{slides:[]}:{}});if(!u.ok)for(const f of u.problems)a(f.path,f.message);const c=[],k=[],m=new Set;return d.forEach((f,g)=>{const p=N("slides",{slides:[f]});if(!p.ok)for(const y of p.problems)a(y.path.replace(/^slides\.0(?=\.|$)/u,`slides.${String(g)}`),y.message);const v=typeof f=="object"&&f!==null&&"id"in f?f.id:void 0;if(typeof v=="string"){if(m.has(v)){h(`slides.${String(g)}.id`,`Two slides are "${v}".`);return}m.add(v)}const[S]=p.ok?p.value.slides:[];S&&(c.push(S),k.push(g))}),{readable:{file:{slides:c},lineOf:f=>o(f.replace(/^slides\.(\d+)/u,(g,p)=>`slides.${String(k[Number(p)]??p)}`))},problems:n,lineOf:o}}function P(t,e){let s=t;for(const o of e===""?[]:e.split(".")){if(typeof s!="object"||s===null)return;s=s[o]}return s}const C=(t,e)=>typeof e=="string"||typeof e=="number"||typeof e=="boolean"?`${t.replace(/\.$/u,"")} (it is ${JSON.stringify(e)}).`:t,w=`slides: []
+`;function D(t){let e=t.get("slides",!0);if(j(e)||(b(t.contents)?t.set("slides",t.createNode([])):t.contents=t.createNode({slides:[]}),e=t.get("slides",!0)),!j(e))throw new Error("slides.yaml has no slides list.");return e}const A=(t,e)=>t.findIndex(s=>b(s)&&s.get("id")===e),E=["frame","text","fill","line","z","crop"];export function editSlidesFile(t,e){const s=x(t===void 0||t.trim()===""?w:t);if(s.errors.length>0)throw new Error("slides.yaml is not YAML: it is mended by hand first.");return editSlidesDocument(s,e)?s.toString():t??w}export function editSlidesDocument(t,e){const s=D(t),o=a=>{if(a===null)return 0;const i=a===void 0?-1:A(s.items,a);return i<0?s.items.length:i+1};if(e.op==="add")return A(s.items,e.slide.id)>=0||(s.items.splice(o(e.after),0,t.createNode(e.slide)),s.flow===!0&&(s.flow=!1)),!0;const l=A(s.items,e.slide),r=s.items[l];if(l<0||!b(r))return!1;const n=a=>{let i=r.get("shapes",!0);return!b(i)&&a&&(r.set("shapes",t.createNode({})),i=r.get("shapes",!0)),b(i)?i:void 0},h=a=>{const i=n(!1);if(i){for(const d of a){const u=i.get(d,!0);b(u)&&u.items.length===0&&i.delete(d)}i.items.length===0&&r.delete("shapes")}};switch(e.op){case"move":{if(e.after===e.slide)break;s.items.splice(l,1),s.items.splice(o(e.after),0,r);break}case"duplicate":{const a=r.clone();a.set("id",e.id),s.items.splice(l+1,0,a);break}case"remove":s.items.splice(l,1);break;case"layout":r.set("layout",e.layout);break;case"hidden":e.hidden===!1||Array.isArray(e.hidden)&&e.hidden.length===0?r.delete("hidden"):r.set("hidden",t.createNode(e.hidden));break;case"shape":{const a=n(!0);if(!a)break;let i=a.get(e.shape,!0);if(b(i)||(a.set(e.shape,t.createNode({})),i=a.get(e.shape,!0)),!b(i))break;for(const[d,u]of Object.entries(e.set)){const c=d.split(".");if(u===void 0){i.deleteIn(c);const k=c.length>1?i.getIn(c.slice(0,-1),!0):void 0;b(k)&&k.items.length===0&&i.deleteIn(c.slice(0,-1))}else{const k=i.getIn(c,!0),m=t.createNode(u);$(k)&&$(m)&&k.flow===!0&&(m.flow=!0),i.setIn(c,m)}}h([e.shape]);break}case"unplace":{n(!1)?.delete(e.shape),h([]);break}case"show":{if(!e.shown){n(!1)?.delete(e.shape),h([]);break}const a=n(!0);a&&!a.has(e.shape)&&a.set(e.shape,t.createNode({}));break}case"background":e.background===void 0?r.delete("background"):r.set("background",t.createNode(e.background));break;case"animations":e.animations.length===0?r.delete("animations"):r.set("animations",t.createNode(e.animations));break;case"transition":e.transition===void 0?r.delete("transition"):r.set("transition",t.createNode(e.transition));break;case"advance":e.after===void 0?r.delete("advance_after"):r.set("advance_after",e.after);break;case"reset":{const a=n(!1);if(!a)break;const i=[];for(const d of a.items){const u=String(b(d.key)?"":d.key.value??d.key);if(e.shape!==void 0&&u!==e.shape)continue;const c=d.value;if(!(!b(c)||["textbox","picture","movie","geometry","component"].some(m=>c.has(m))||!E.some(m=>c.has(m)))){for(const m of E)c.delete(m);i.push(u)}}h(i);break}}return!0}export function freeName(t,e){const s=new Set(t),o=e.replace(/[^A-Za-z0-9_-]+/gu,"-").replace(/^-+|-+$/gu,"")||"slide";if(!s.has(o))return o;for(let l=2;;l++){const r=`${o}-${String(l)}`;if(!s.has(r))return r}}const F=new Set(["text","props","crop"]);function _(t){const e=new Map;for(const[s,o]of Object.entries(t??{}))if(F.has(s)&&typeof o=="object"&&!Array.isArray(o))for(const[l,r]of Object.entries(o))e.set(`${s}.${l}`,r);else e.set(s,o);return e}const L=(t,e)=>new Set(M(t,e).map(([s])=>t[s]??""));function T(t,e){const s=[],o=e.id;e.layout!==void 0&&e.layout!==t.layout&&s.push({op:"layout",slide:o,layout:e.layout}),O(t.hidden,e.hidden)||s.push({op:"hidden",slide:o,hidden:e.hidden??!1}),O(t.animations??[],e.animations??[])||s.push({op:"animations",slide:o,animations:e.animations??[]}),O(t.transition,e.transition)||s.push({op:"transition",slide:o,...e.transition?{transition:e.transition}:{}}),t.advance_after!==e.advance_after&&s.push({op:"advance",slide:o,...e.advance_after===void 0?{}:{after:e.advance_after}}),O(t.background,e.background)||s.push({op:"background",slide:o,...e.background?{background:e.background}:{}});const l=t.shapes??{},r=e.shapes??{};for(const n of Object.keys(l))n in r||s.push({op:"unplace",slide:o,shape:n});for(const[n,h]of Object.entries(r)){const a=_(l[n]),i=_(h),d={};for(const c of new Set([...a.keys(),...i.keys()]))O(a.get(c),i.get(c))||(d[c]=i.get(c));Object.keys(d).length>0&&s.push({op:"shape",slide:o,shape:n,set:d});const u=l[n];Object.keys(h).length===0&&(u===void 0||Object.keys(u).length>0)&&s.push({op:"show",slide:o,shape:n,shown:!0})}return s}export function slidesEdits(t,e){const s=[],o=new Map(t.slides.map(n=>[n.id,n])),l=new Set(e.slides.map(n=>n.id));for(const n of t.slides)l.has(n.id)||s.push({op:"remove",slide:n.id});const r=L(t.slides.map(n=>n.id).filter(n=>l.has(n)),e.slides.map(n=>n.id).filter(n=>o.has(n)));return e.slides.forEach((n,h)=>{const a=h===0?null:e.slides[h-1]?.id??null,i=o.get(n.id);if(!i||i.generate!==n.generate){i&&s.push({op:"remove",slide:n.id}),s.push({op:"add",slide:n,after:a});return}r.has(n.id)||s.push({op:"move",slide:n.id,after:a}),s.push(...T(i,n))}),s}

package/dist/node_modules/@allyhub/slides-core/dist/index.d.ts

@@ -0,0 +1,25 @@
+export * from "./units.js";
+export * from "./lang.js";
+export * from "./enums.js";
+export * from "./strict.js";
+export * from "./animation.js";
+export * from "@allyhub/chart";
+export * from "./chart-api.js";
+export * from "./office.js";
+export * from "./path.js";
+export * from "./placeholders.js";
+export * from "./theme.js";
+export * from "./model.js";
+export * from "./api.js";
+export * from "./code.js";
+export * from "./resolve.js";
+export * from "./identity.js";
+export * from "./file.js";
+export * from "./script.js";
+export * from "./merge.js";
+export * from "./stage.js";
+export * from "./components.js";
+export * from "./check.js";
+export * from "./capabilities.js";
+export * from "./measure.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/node_modules/@allyhub/slides-core/dist/index.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export*from"./units.js";export*from"./lang.js";export*from"./enums.js";export*from"./strict.js";export*from"./animation.js";export*from"@allyhub/chart";export*from"./chart-api.js";export*from"./office.js";export*from"./path.js";export*from"./placeholders.js";export*from"./theme.js";export*from"./model.js";export*from"./api.js";export*from"./code.js";export*from"./resolve.js";export*from"./identity.js";export*from"./file.js";export*from"./script.js";export*from"./merge.js";export*from"./stage.js";export*from"./components.js";export*from"./check.js";export*from"./capabilities.js";export*from"./measure.js";

package/dist/node_modules/@allyhub/slides-core/dist/measure.d.ts

@@ -0,0 +1,34 @@
+import { type DeckLayout, type DeckShapeLayout, type Fact, type FactPlace } from "@allyhub/video-core";
+export interface DeckFactOptions {
+    /** near-alignment: lines this many points apart or fewer, and more than `aligned`, are reported. */
+    within: number;
+    /** near-alignment: lines this close, in points, are in line. */
+    aligned: number;
+    /** placement-drift: frames further apart than this, in points, are different places. */
+    drift: number;
+    /** read-size: a room's screen width and its farthest seat, metres; without it, no room is measured. */
+    room?: {
+        screen: number;
+        distance: number;
+    };
+    /** read-size: the phone a slide is fitted on, in points, upright. */
+    phone: [number, number];
+    /** Pixels a box may reach past a line before it is past it (antialiasing). */
+    slack: number;
+    /** deck-fonts: the fonts every PowerPoint, Keynote and Google Slides has. */
+    standard?: readonly string[];
+    /** Only shapes of these levels are measured; every level unless given. */
+    levels?: readonly DeckShapeLayout["level"][];
+    /** Shapes by name left out of every fact, `*` for any letters; none unless given. */
+    except?: readonly string[];
+}
+export declare const DECK_FACT_DEFAULTS: DeckFactOptions;
+/**
+ * The facts of a deck as drawn, each placed at its slide (`part`, its
+ * still's `t`), a deck's own (type-in-use, placement-drift) at none.
+ */
+export declare function deckFacts(layout: DeckLayout, frame: {
+    width: number;
+    height: number;
+}, place: FactPlace, given?: Partial<DeckFactOptions>): Fact[];
+//# sourceMappingURL=measure.d.ts.map

package/dist/node_modules/@allyhub/slides-core/dist/measure.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{READ_DEFAULTS as W,fact as m,phoneScale as X}from"@allyhub/video-core";import{STANDARD_FONTS as Y}from"./theme.js";export const DECK_FACT_DEFAULTS={within:8,aligned:.5,drift:1,phone:W.phone,slack:1};const E=e=>e[0]+e[2],$=e=>e[1]+e[3],A=e=>Math.max(0,e[2])*Math.max(0,e[3]),w=(e,h=2)=>{const d=10**h;return Math.round(e*d)/d};function N(e,h,d){const M=[],a=(r,k)=>{k>d&&M.push({side:r,px:k})};return a("left",h[0]-e[0]),a("top",h[1]-e[1]),a("right",E(e)-E(h)),a("bottom",$(e)-$(h)),M}const R=(e,h)=>{const d=Math.max(e[0],h[0]),M=Math.max(e[1],h[1]);return[d,M,Math.min(E(e),E(h))-d,Math.min($(e),$(h))-M]},Z=(e,h,d)=>e[0]>=h[0]-d&&e[1]>=h[1]-d&&E(e)<=E(h)+d&&$(e)<=$(h)+d,O={left:e=>e[0],right:E,"centre-x":e=>e[0]+e[2]/2,top:e=>e[1],bottom:$,"centre-y":e=>e[1]+e[3]/2},D=e=>e.opaque||!e.text?.glyphs?e.box:e.text.glyphs,ee=new Set(Object.keys(O)),se=new Set(["left","right","top","bottom"]);function Q(e){if(e.opaque)return ee;if(!e.text?.glyphs)return se;const h=e.text.align??"l";return new Set([h==="ctr"?"centre-x":h==="r"?"right":"left"])}const te=(e,h)=>h.some(d=>new RegExp(`^${d.split("*").map(M=>M.replace(/[.*+?^${}()|[\]\\]/gu,"\\$&")).join(".*")}$`,"su").test(e)),ne=e=>e.box[2]>0||e.box[3]>0;export function deckFacts(e,h,d,M={}){const a={...DECK_FACT_DEFAULTS,...M},r=s=>w(s/e.pxPerPt),k=s=>[r(s[0]),r(s[1]),r(s[2]),r(s[3])],q=s=>s.map(n=>({side:n.side,pt:w(n.px/e.pxPerPt,1)})),H=s=>w(s,3),B=s=>s.opaque||!s.text?.glyphs?"frame":"glyphs",T=(s,n,x)=>n==="left"||n==="right"||n==="centre-x"?{shape:s.name,x:w(r(s.frame[0])+x)}:{shape:s.name,y:w(r(s.frame[1])+x)},g=[],F=[0,0,h.width,h.height],_=new Map,j=new Map,I=new Map;for(const s of e.slides){const n={...d,part:s.slide,t:s.t},x=j.get(s.slide)??{at:n,total:s.steps??1,measured:0,shapes:new Map};j.set(s.slide,x),x.measured++;for(const c of s.shapes){if(c.level!=="slide")continue;const t=x.shapes.get(c.name)??{hidden:0,by:[]};c.hidden===!0&&t.hidden++,x.shapes.set(c.name,t)}const b=s.shapes.filter(c=>ne(c)&&c.hidden!==!0&&(a.levels===void 0||a.levels.includes(c.level))&&!te(c.name,a.except??[]));let L=0,J=0,K=0;for(const[c,t]of b.entries()){t.chart&&g.push(m("chart-data",n,{shape:t.name,...t.chart}));const p=(t.rows??[]).flatMap((l,u)=>l.drawn>l.set+a.slack?[{row:u,set:r(l.set),drawn:r(l.drawn)}]:[]);p.length>0&&g.push(m("table-grown",n,{shape:t.name,set:r(t.frame[3]),drawn:r(t.box[3]),rows:p}));const o=t.text;if(o?.glyphs){K++,L+=o.words,J+=o.lines.length;const l=N(o.glyphs,t.box,a.slack);l.length>0&&g.push(m("text-overflow",n,{shape:t.name,text:o.text,box:k(t.box),glyphs:k(o.glyphs),edges:q(l),lines:o.lines.length,past:o.lines.filter(i=>N(i,t.box,a.slack).length>0).length,...o.scale===void 0?{}:{scale:o.scale}}));const u=N(o.glyphs,F,a.slack);if(u.length>0){const i=A(o.glyphs);g.push(m("text-off-slide",n,{shape:t.name,text:o.text,glyphs:k(o.glyphs),edges:q(u),share:i>0?H(1-A(R(o.glyphs,F))/i):1}))}for(const i of o.type){const v=`${String(i.size)}/${String(i.weight)}`,z=_.get(v)??{size:i.size,weight:i.weight,slides:new Set,shapes:new Set};z.slides.add(s.slide),z.shapes.add(`${s.slide}/${t.name}`),_.set(v,z)}const f=o.type.reduce((i,v)=>i===void 0||v.size<i.size?v:i,void 0);if(f){const i=a.room,v=f.xHeight===void 0?"em":"x",z=i&&(f.xHeight??f.size)*(i.screen*1e3/(h.width/e.pxPerPt));g.push(m("read-size",n,{shape:t.name,text:o.text,size:f.size,...f.xHeight===void 0?{}:{xHeight:f.xHeight},...i&&z!==void 0?{screen:{by:v,mm:w(z,1),arcmin:w(Math.atan(z/1e3/i.distance)*180*60/Math.PI,1)}}:{},phone:w(f.size*e.pxPerPt*X([h.width,h.height],a.phone),1),options:{...i?{room:{...i}}:{},phone:[...a.phone]}}))}}const S=N(t.box,F,a.slack);if(S.length>0){const l=A(t.box);g.push(m("shape-off-slide",n,{shape:t.name,box:k(t.box),edges:q(S),share:l>0?H(1-A(R(t.box,F))/l):1}))}if(t.picture){const[l,u]=t.picture.shown;if(l>0&&u>0){const f=Math.max(t.box[2]/l,t.box[3]/u),i=v=>v/e.pxPerPt/72;g.push(m("picture-resolution",n,{shape:t.name,source:t.picture.source,shown:t.picture.shown,box:k(t.box),scale:w(f),ppi:Math.round(Math.min(l/i(t.box[2]),u/i(t.box[3]))),stretch:w(t.box[2]/l/(t.box[3]/u)-1)}))}}const P=b.slice(c+1).find(l=>l.opaque&&Z(t.box,l.box,a.slack)),y=x.shapes.get(t.name);if(y?y.by.push(P?.name):P&&g.push(m("shape-hidden",n,{shape:t.name,by:P.name})),t.level==="slide"){const l=`${s.layout}\0${t.name}`,u=I.get(l)??new Map,f=[r(t.frame[0]),r(t.frame[1]),r(t.frame[2]),r(t.frame[3])],i=[...u.values()].find(v=>v.frame.every((z,V)=>Math.abs(z-(f[V]??0))<=a.drift));i?i.slides.includes(s.slide)||i.slides.push(s.slide):u.set(f.join(","),{frame:f,slides:[s.slide]}),I.set(l,u)}}for(let c=0;c<b.length;c++)for(let t=c+1;t<b.length;t++){const p=b[c],o=b[t];if(!p||!o)continue;const S=p.level==="slide"||o.level==="slide",P=R(D(p),D(o));if(S&&p.level==="slide"&&o.level==="slide"&&P[2]>a.slack&&P[3]>a.slack){const y=A(P);g.push(m("shape-overlap",n,{a:p.name,b:o.name,area:w(y/e.pxPerPt**2,1),share:H(y/Math.max(1,Math.min(A(D(p)),A(D(o)))))}))}if(S)for(const[y,l]of Object.entries(O)){if(!Q(p).has(y)||!Q(o).has(y))continue;const u=r(l(D(p))),f=r(l(D(o))),i=Math.abs(u-f);i>a.aligned&&i<=a.within&&g.push(m("near-alignment",n,{a:p.name,b:o.name,line:y,gap:w(i),at:{a:u,b:f},by:{a:B(p),b:B(o)},align:p.level==="slide"?T(p,y,f-u):T(o,y,u-f),options:{within:a.within,aligned:a.aligned}}))}}for(const c of b)if(!(c.level!=="slide"||!c.opaque))for(const t of["centre-x","centre-y"]){const p=r(O[t](c.box)),o=r(O[t](F)),S=Math.abs(p-o);S>a.aligned&&S<=a.within&&g.push(m("near-alignment",n,{a:c.name,b:"slide",line:t,gap:w(S),at:{a:p,b:o},by:{a:"frame",b:"frame"},align:T(c,t,o-p),options:{within:a.within,aligned:a.aligned}}))}g.push(m("words-on-slide",n,{words:L,lines:J,texts:K}))}for(const[s,n]of I){if(n.size<2)continue;const[x="",b=""]=s.split("\0");g.push(m("placement-drift",d,{layout:x,shape:b,places:[...n.values()],options:{drift:a.drift}}))}if(e.fonts&&e.fonts.length>0){const s=new Set(M.standard??Y);g.push(m("deck-fonts",d,{fonts:e.fonts.map(n=>({...n,standard:s.has(n.name)})),options:{standard:[...s]}}))}const C=[..._.values()].map(s=>({size:s.size,weight:s.weight,slides:s.slides.size,shapes:s.shapes.size})).sort((s,n)=>s.size-n.size||s.weight-n.weight),U=C[0];U&&g.push(m("type-in-use",d,{type:C,smallest:U.size}));for(const s of j.values())for(const[n,x]of s.shapes){const[b]=x.by;b!==void 0&&x.by.every(L=>L!==void 0)&&g.push(m("shape-hidden",s.at,{shape:n,by:b})),s.measured>=s.total&&x.hidden===s.measured&&g.push(m("shape-hidden",s.at,{shape:n,never:!0}))}const G=new Set;return g.filter(s=>{const n=JSON.stringify([s.kind,s.part,s.data]);return G.has(n)?!1:(G.add(n),!0)})}

package/dist/node_modules/@allyhub/slides-core/dist/merge.d.ts

@@ -0,0 +1,58 @@
+import { type ScriptFile, type SlidesFile } from "@allyhub/formats";
+/** Where a person's change met another hand's in slides.yaml. */
+export interface SlidesConflict {
+    slide: string;
+    shape?: string;
+    /**
+     * What both changed, by its path in the slide or shape (`layout`,
+     * `frame.x`, `text.size`, `animations.title:fade.duration`; `order`: both
+     * moved the slide, or the item); absent when one hand removed the slide or
+     * shape the other changed.
+     */
+    field?: string;
+    /** Each hand's value; absent where that hand removed it. */
+    mine?: unknown;
+    theirs?: unknown;
+    /** Whose stands: the person's, unless the person removed what the other hand changed. */
+    kept: "mine" | "theirs";
+}
+/** Where a person's words met another hand's in a deck's script. */
+export interface DeckScriptConflict {
+    slide: string;
+    /** The shape whose words both changed. */
+    shape?: string;
+    /** `notes`, or what of the shape's words both changed; absent when one hand removed the row the other changed. */
+    field?: string;
+    mine?: unknown;
+    theirs?: unknown;
+    kept: "mine" | "theirs";
+}
+/**
+ * A person's slides.yaml (`mine`, what the editor holds, made from
+ * `base`) merged with the file as another hand left it (`theirs`), written
+ * over theirs. Undefined when theirs is not a slides.yaml a merge can
+ * read: the person mends it, or the other hand does.
+ */
+export declare function mergeSlides(base: string, mine: SlidesFile, theirs: string): {
+    text: string;
+    conflicts: SlidesConflict[];
+} | undefined;
+/**
+ * A person's script (`mine`, made from `base`) merged with the script as
+ * another hand left it (`theirs`): its slides' rows, as mergeSlides
+ * merges slides.yaml. Undefined when theirs is not a script.
+ */
+export declare function mergeDeckScript(base: string, mine: ScriptFile, theirs: string): {
+    text: string;
+    conflicts: DeckScriptConflict[];
+} | undefined;
+/**
+ * An id for a slide a person adds or duplicates in the editor: its stem
+ * and four random letters (`slide-k3f9`), none a slide has yet. The
+ * agent writes slides.yaml while the person edits it, so an id counted up
+ * from what the editor sees (`slide-2`) could be one the agent is adding
+ * too; one of 32⁴ (about a million) is not, as PowerPoint gives a new
+ * slide an id no other slide has (`p:sldId/@id`).
+ */
+export declare function newSlideId(taken: Iterable<string>, stem?: string, random?: () => number): string;
+//# sourceMappingURL=merge.d.ts.map

package/dist/node_modules/@allyhub/slides-core/dist/merge.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{readDataFile as T}from"@allyhub/formats";import{editSlidesFile as I,readSlidesFile as v,slidesEdits as O}from"./file.js";import{deckScriptEdits as _,editDeckScript as C,readScript as A}from"./script.js";import{commonPairs as $,isRecord as M,sameValue as y,valueKey as F}from"./values.js";const N="order";function E(e,n,o,t,i,c){if(y(t,i))return t;if(y(o,t))return i;if(y(o,i))return t;if(t===void 0||i===void 0)return c.push({path:n,mine:t,theirs:i,kept:t===void 0?"theirs":"mine"}),t??i;if(M(t)&&M(i)&&(o===void 0||M(o))&&!e.whole(n)){const s={};for(const d of new Set([...Object.keys(i),...Object.keys(t)])){const f=E(e,[...n,d],o?.[d],t[d],i[d],c);f!==void 0&&(s[d]=f)}return s}if(Array.isArray(t)&&Array.isArray(i)&&(o===void 0||Array.isArray(o))){const s=e.list(n),d=o??[];if(s==="lines")return B(n,d,t,i,c);if(s)return z(e,n,d,t,i,s,c)}return c.push({path:n,mine:t,theirs:i,kept:"mine"}),t}function R(e,n){const o=[],t=new Map,i=new Map;for(const c of e){const s=n(c),d=(i.get(s)??0)+1;i.set(s,d);const f=d===1?s:`${s}#${String(d)}`;o.push(f),t.set(f,c)}return{order:o,byKey:t}}function K(e,n){const o=new Set(n),t=new Set(e),i=e.filter(s=>o.has(s)),c=n.filter(s=>t.has(s));return new Set($(i,c).map(([s])=>i[s]??""))}function z(e,n,o,t,i,c,s){const d=R(o,c),f=R(t,c),a=R(i,c),g=new Map;for(const r of new Set([...a.order,...f.order,...d.order])){const m=E(e,[...n,r],d.byKey.get(r),f.byKey.get(r),a.byKey.get(r),s);m!==void 0&&g.set(r,m)}const S=new Set(d.order),u=K(d.order,f.order),l=K(d.order,a.order),p=a.order.filter(r=>g.has(r));return f.order.forEach((r,m)=>{if(!g.has(r))return;const h=p.indexOf(r);if(h>=0&&S.has(r)&&u.has(r))return;h>=0&&p.splice(h,1);let x=0;for(let w=m-1;w>=0;w--){const k=p.indexOf(f.order[w]??"");if(k>=0){x=k+1;break}}if(p.splice(x,0,r),S.has(r)&&h>=0&&!l.has(r)){const w=(k,L)=>k[k.indexOf(L)-1]??null;w(a.order,r)!==w(f.order,r)&&s.push({path:[...n,r,N],mine:{after:w(f.order,r)},theirs:{after:w(a.order,r)},kept:"mine"})}}),p.map(r=>g.get(r))}function B(e,n,o,t,i){const c=u=>u.map(F),s=new Map($(c(n),c(o))),d=new Map($(c(n),c(t))),f=[];let a=0,g=0,S=0;for(;;){let u=a;for(;u<n.length&&!(s.has(u)&&d.has(u));)u++;const l=u<n.length?s.get(u)??o.length:o.length,p=u<n.length?d.get(u)??t.length:t.length;if(u===a&&l===g&&p===S){if(u>=n.length)break;f.push(o[g]),a++,g++,S++;continue}const r=n.slice(a,u),m=o.slice(g,l),h=t.slice(S,p);y(r,m)?f.push(...h):y(r,h)||y(m,h)?f.push(...m):r.length===0?f.push(...m,...h):(i.push({path:e,mine:m,theirs:h,kept:"mine"}),f.push(...m)),a=u,g=l,S=p}return f}function b(e,n,o){let t=[...e],i=[...n],c=[...o];const s=d=>({...d,id:""});for(const d of["theirs","mine"]){const f=d==="theirs"?c:i,a=d==="theirs"?i:c,g=new Set(f.map(l=>l.id)),S=new Set(t.map(l=>l.id)),u=f.filter(l=>!S.has(l.id));for(const l of t.filter(p=>!g.has(p.id))){const p=u.filter(h=>y(s(h),s(l))),[r]=p;if(p.length!==1||!r||!a.some(h=>h.id===l.id)||a.some(h=>h.id===r.id))continue;const m=h=>h.map(x=>x.id===l.id?{...x,id:r.id}:x);t=m(t),d==="theirs"?i=m(i):c=m(c)}}return[t,i,c]}const P=e=>{const n=e;return`${n.shape??""}${n.paragraph===void 0?"":`[${String(n.paragraph)}]`}:${n.effect??""}`},U={list(e){if(e.length===1)return n=>M(n)?String(n.id):"";if(e.length===3&&e[2]==="animations")return P;if(e.length===3&&e[2]==="hidden")return n=>String(n)},whole:e=>e.length===5&&e[4]==="path"||e.length===3&&e[2]==="background"},q={list(e){if(e.length===1)return n=>M(n)?String(n.id):"";if(e.length>=4&&e[2]==="text")return"lines"},whole:()=>!1},j=e=>({...e.mine===void 0?{}:{mine:e.mine},...e.theirs===void 0?{}:{theirs:e.theirs},kept:e.kept});function V(e){const[,n="",...o]=e.path,t=o[0]==="shapes"&&o.length>=2,i=(t?o.slice(2):o).join(".");return{slide:n,...t&&o[1]!==void 0?{shape:o[1]}:{},...i===""?{}:{field:i},...j(e)}}function Z(e){const[,n="",...o]=e.path,t=o[0]==="text"&&o.length>=2,i=(t?o.slice(2):o).join(".");return{slide:n,...t&&o[1]!==void 0?{shape:o[1]}:{},...i===""?{}:{field:i},...j(e)}}export function mergeSlides(e,n,o){const t=v(e).file??{slides:[]},i=v(o).file;if(!i)return;const[c,s,d]=b(t.slides,n.slides,i.slides),f=[],a=E(U,["slides"],c,s,d,f)??[],g=T("slides",{slides:a});if(!g.ok)for(const u of new Set(g.problems.flatMap(l=>{const[p,r]=l.path.split(".");return p==="slides"&&r!==void 0?[Number(r)]:[]}))){const l=a[u]?.id,p=s.find(r=>r.id===l)??d.find(r=>r.id===l);l===void 0||!p||(a[u]=p,f.push({path:["slides",l],mine:s.find(r=>r.id===l),theirs:d.find(r=>r.id===l),kept:s.some(r=>r.id===l)?"mine":"theirs"}))}return{text:O(i,{slides:a}).reduce((u,l)=>I(u,l),o),conflicts:f.map(V)}}export function mergeDeckScript(e,n,o){const t=A(e)??{parts:[],slides:[]},i=A(o);if(!i)return;const[c,s,d]=b(t.slides,n.slides,i.slides),f=[],a=E(q,["slides"],c,s,d,f)??[];return{text:_(i,{...i,slides:a}).reduce((S,u)=>C(S,u),o),conflicts:f.map(Z)}}const D="abcdefghijkmnpqrstuvwxyz23456789";export function newSlideId(e,n="slide",o=Math.random){const t=new Set(e),i=n.replace(/[^A-Za-z0-9_-]+/gu,"-").replace(/^-+|-+$/gu,"")||"slide";for(;;){let c="";for(let d=0;d<4;d++)c+=D[Math.floor(o()*D.length)]??"a";const s=`${i}-${c}`;if(!t.has(s))return s}}