allyhub 0.3.0 → 0.5.0

package/dist/node_modules/@allyhub-next/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{MSO_CONNECTOR as k,MSO_SHAPE as $,MSO_SHAPE_TYPE as F,PP_PLACEHOLDER as M}from"./enums.js";import{Chart as R}from"./chart-api.js";import{AUTOSHAPE_STYLE as c,CONNECTOR_STYLE as O,FOOTER_IDX as L,OFFICE_TEXT_STYLES as N,TEXT_INSETS as _,TEXTBOX_FRAME as z}from"./office.js";import{masterPlaceholder as T}from"./placeholders.js";import{strict as a}from"./strict.js";import{EMU_PER_PT as v,SLIDE_SIZES as S}from"./units.js";class C extends Error{constructor(t){super(`${t} (allyhub slides capabilities lists what the API holds).`),this.name="Unsupported"}}const m=i=>{throw new C(i)},G=/^#?[0-9a-f]{6}$/iu,j=i=>{if(!G.test(i))throw new Error(`rgb ${i} is not RRGGBB.`);return`#${i.replace("#","").toUpperCase()}`};export const RGBColor=Object.assign((i,t,e)=>{for(const s of[i,t,e])if(!Number.isInteger(s)||s<0||s>255)throw new Error(`RGBColor(${String(i)}, ${String(t)}, ${String(e)}): each is 0 to 255.`);return`#${[i,t,e].map(s=>s.toString(16).padStart(2,"0")).join("").toUpperCase()}`},{from_string:i=>j(i)});export class ColorFormat{read;write;constructor(t,e){return this.read=t,this.write=e,a(this,"ColorFormat")}get theme_color(){const t=this.read();return typeof t=="string"?t:void 0}set theme_color(t){this.write(t)}get rgb(){const t=this.read();return typeof t=="object"?t.rgb:void 0}set rgb(t){this.write(t===void 0?void 0:{rgb:j(t)})}}export class Font{def;constructor(t){return this.def=t,a(this,"Font")}_set(t,e){e===void 0?Reflect.deleteProperty(this.def,t):this.def[t]=e}get name(){return this.def.name}set name(t){this._set("name",t)}get size(){return 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 this.def.spacing}set spacing(t){this._set("spacing",t)}get color(){return new ColorFormat(()=>this.def.rgb!==void 0?{rgb:this.def.rgb}:this.def.color,t=>{delete this.def.color,delete this.def.rgb,typeof t=="string"?this.def.color=t:t&&(this.def.rgb=t.rgb)})}}export class Run{def;constructor(t){return this.def=t,a(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)}}const I=i=>{if(!Number.isFinite(i)||i<=0)throw new Error(`line_spacing ${String(i)} is not over 0.`);return Number.isInteger(i)&&i>=v?{fixed:i}:{lines:i}},D=i=>i===void 0?void 0:"lines"in i?i.lines:i.fixed,A=i=>i.split(/\n|\v/u).flatMap((t,e)=>[...e>0?[{text:"\v"}]:[],...t===""?[]:[{text:t}]]);class P{_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 D(this.fmt.line_spacing)}set line_spacing(t){this._set("line_spacing",t===void 0?void 0:I(t))}get space_before(){return this.fmt.space_before}set space_before(t){this._set("space_before",t)}get space_after(){return 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 P{fmt;constructor(t){return super(),this.fmt=t,a(this,"_Paragraph")}get text(){return this.fmt.runs.map(t=>t.text).join("")}set text(t){this.fmt.runs=A(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 P{fmt;constructor(t){return super(),this.fmt=t,a(this,"ListLevel")}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 this.fmt.margin_left}set margin_left(t){this._set("margin_left",t)}get indent(){return this.fmt.indent}set indent(t){this._set("indent",t)}}const y=i=>Object.freeze(i.map(t=>new ListLevel(t))),B=()=>Array.from({length:9},()=>({})),x=()=>({paragraphs:[],levels:B()});export class TextFrame{def;constructor(t){return this.def=t,a(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:A(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*v),...t===void 0?{}:{name:t},...s===void 0?{}:{bold:s},...r===void 0?{}:{italic:r}}}get list_style(){return y(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 this.def.margin_left??_.left}set margin_left(t){this.def.margin_left=t}get margin_top(){return this.def.margin_top??_.top}set margin_top(t){this.def.margin_top=t}get margin_right(){return this.def.margin_right??_.right}set margin_right(t){this.def.margin_right=t}get margin_bottom(){return this.def.margin_bottom??_.bottom}set margin_bottom(t){this.def.margin_bottom=t}}export class FillFormat{read;write;start;constructor(t,e,s="lt1"){return this.read=t,this.write=e,this.start=s,a(this,"FillFormat")}solid(){const t=this.read();t==null&&this.write(this.start)}background(){this.write(null)}get type(){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 LineFormat{def;constructor(t){return this.def=t,a(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 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,a(this,"_Background")}get fill(){return new FillFormat(()=>this.holder.background,t=>{this.holder.background=t??"lt1"})}}export const ADJUSTMENT_DEFAULTS={roundRect:[.16667]};export class Adjustments{def;constructor(t){return this.def=t,a(this,"Adjustments",{index:e=>this._values()[e],setIndex:(e,s)=>{this._set(e,Number(s))}})}_values(){return this.def.adjustments??[...ADJUSTMENT_DEFAULTS[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 U={left:0,top:0,width:0,height:0};export class Shape{def;inherit;constructor(t,e=()=>{}){return this.def=t,this.inherit=e,a(this,"Shape")}get _def(){return this.def}_frame(){return this.def.frame??this.inherit()??U}_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":this.def.geometry==="line"?"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 R(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{...this.def.placeholder}}get left(){return this._frame().left}set left(t){this._own().left=t}get top(){return this._frame().top}set top(t){this._own().top=t}get width(){return this._frame().width}set width(t){this._own().width=t}get height(){return 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})}get line(){return new LineFormat(this.def)}get adjustments(){return new Adjustments(this.def)}}const H=i=>typeof i=="number"&&Number.isFinite(i),p=(i,t,e,s,{line:r=!1}={})=>{for(const[n,h]of Object.entries({left:i,top:t,width:e,height:s}))if(!H(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)}},X=new Set(Object.values($));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,a(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(o=>o.op==="close"?[]:o.op==="curve"?[[o.x1,o.y1],[o.x2,o.y2],[o.x,o.y]]:[[o.x,o.y]]),r=s.map(o=>o[0]),n=s.map(o=>o[1]),h=Math.min(...r),d=Math.min(...n),l=Math.max(...r)-h,f=Math.max(...n)-d,u=(o,g)=>({x:o-h,y:g-d});return this.make({w:l,h:f,steps:this.steps.map(o=>{if(o.op==="close")return o;if(o.op!=="curve")return{op:o.op,...u(o.x,o.y)};const g=u(o.x1,o.y1),b=u(o.x2,o.y2);return{op:"curve",x1:g.x,y1:g.y,x2:b.x,y2:b.y,...u(o.x,o.y)}})},p(Math.round(h*this.sx)+t,Math.round(d*this.sy)+e,Math.round(l*this.sx),Math.round(f*this.sy)))}}export class GroupShape{list;_name;make;constructor(t,e,s){return this.list=t,this._name=e,this.make=s,a(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 F.GROUP}get name(){return this._name}set name(t){for(const e of this.members())e.group=t;this._name=t}get left(){return 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 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 t.right-t.left}get height(){const t=this.box();return 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,a(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 this.def.text.margin_left??_.left}set margin_left(t){this.def.text.margin_left=t}get margin_right(){return this.def.text.margin_right??_.right}set margin_right(t){this.def.text.margin_right=t}get margin_top(){return this.def.text.margin_top??_.top}set margin_top(t){this.def.text.margin_top=t}get margin_bottom(){return this.def.text.margin_bottom??_.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((l,f)=>l-f),s=[this.col,t.col].sort((l,f)=>l-f),[r=0,n=0]=e,[h=0,d=0]=s;for(let l=r;l<=n;l++)for(let f=h;f<=d;f++){const u=this.table.rows[l]?.cells[f];u&&(l===r&&f===h?(d>h&&(u.span_width=d-h+1),n>r&&(u.span_height=n-r+1)):u.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,a(this,"_Column")}get width(){return 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,a(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 this.row.height}set height(t){this.row.height=t}}export class Table{def;constructor(t){return this.def=t,a(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 J(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,a(this,"SlideShapes",{index:d=>this._at(d)})}_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:J(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:p(t,e,s,r),text:{...x(),...z}})}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:p(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:p(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){X.has(t)||m(`add_shape(): ${t} is not one of MSO_SHAPE's ${Object.keys($).join(", ")}`);const h=x();return h.vertical_anchor=c.vertical_anchor,h.paragraphs=[{runs:[],level:0,alignment:c.alignment}],this._add("shape",{kind:"autoshape",frame:p(e,s,r,n),geometry:t,fill:c.fill,line:c.line,line_width:c.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 d=Math.floor(n/e),l=Math.floor(h/t);return this._add("table",{kind:"table",frame:p(s,r,n,h),table:{columns:Array.from({length:e},()=>d),rows:Array.from({length:t},()=>({height:l,cells:Array.from({length:e},()=>({text:x()}))}))}})}add_chart(t,e,s,r,n,h){return this._add("chart",{kind:"chart",frame:p(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=x();return h.vertical_anchor=c.vertical_anchor,h.paragraphs=[{runs:[],level:0,alignment:c.alignment}],this._add("freeform",{kind:"autoshape",frame:n,path:r,fill:c.fill,line:c.line,line_width:c.line_width,text:h})})}add_connector(t,e,s,r,n){t!==k.STRAIGHT&&m(`add_connector(): ${t} is not one of MSO_CONNECTOR's ${Object.keys(k).join(", ")}`);const h=p(Math.min(e,r),Math.min(s,n),Math.abs(r-e),Math.abs(n-s),{line:!0}),d=r<e,l=n<s;return this._add("connector",{kind:"autoshape",frame:h,geometry:"line",...d||l?{flip:{...d?{h:d}:{},...l?{v:l}:{}}}:{},line:O.line,line_width:O.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:p(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,a(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 d=typeof e=="object"?e:h,l=typeof e=="object"?void 0:e;Object.values(M).includes(t)||m(`placeholders.add(): ${t} is not one of PP_PLACEHOLDER's ${Object.keys(M).join(", ")}`);const f=this.list.filter(w=>w.kind==="placeholder"),u=new Set(f.map(w=>w.placeholder?.idx));let o=t==="title"||t==="ctrTitle"?0:L[t]??1;for(;u.has(o)&&o!==0;)o++;if(u.has(o))throw new Error("A layout has one title placeholder (idx 0).");const g=d.name??NAME_OF_TYPE[t];if(this.list.some(w=>w.name===g))throw new Error(`Two shapes are ${g}: give the placeholder a name ({ name }).`);const b=[l,s,r,n].filter(w=>w!==void 0);if(b.length!==0&&b.length!==4)throw new Error("placeholders.add(type, left, top, width, height): give all four, or none to take the master's frame.");const E={name:g,kind:"placeholder",placeholder:{type:t,idx:o},...b.length===4?{frame:p(l??0,s??0,r??0,n??0)}:{},text:x()};return this.list.push(E),this._wrap(E)}}export class SlideLayout{def;master;ctx;constructor(t,e,s){return this.def=t,this.master=e,this.ctx=s,a(this,"SlideLayout")}get _def(){return this.def}inherit=t=>t.placeholder?T(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,a(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,a(this,"text_styles")}get title_style(){return y(this.def.title)}get body_style(){return y(this.def.body)}get other_style(){return y(this.def.other)}}export class SlideMaster{def;layouts=[];ctx;allLayouts;constructor(t,e,s){return this.def=t,this.ctx=e,this.allLayouts=s,a(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,a(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:x()}));const r=n=>{const h=e._def.shapes.find(d=>d.kind==="placeholder"&&d.placeholder?.idx===n.placeholder?.idx);return h?h.frame??(h.placeholder?T(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),a(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{notes_text_frame:{get text(){return t.notes??""},set text(e){t.notes=e}}}}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:x()})):e.push(s);return{...this.def,shapes:e,text:t}}}export class Animations{list;constructor(t){return this.list=t,a(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 Y{gen;constructor(t){return this.gen=t,a(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,a(this,"Generator")}data(t){return this.ctx.data(t)}get slides(){return new Y(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 Z=()=>JSON.parse(JSON.stringify(N));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},a(this,"Presentation")}get _def(){return this.def}get slide_width(){return this.def.slide_width}set slide_width(t){this.def.slide_width=t}get slide_height(){return 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:Z(),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 a({add:(t,e)=>{if(Object.hasOwn(this.def.components,t))throw new Error(`Two components are "${t}".`);if(typeof e.layers!="function")throw new Error(`Component ${t} draws with its layers function.`);this.def.components[t]={name:t,props:e.props??{},layers:e.layers}}},"components")}get generators(){return a({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(S,s.size))throw new Error(`presentation(): size ${s.size} is not one of ${Object.keys(S).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"?S[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-next/slides-core/dist/capabilities.d.ts

@@ -0,0 +1,18 @@
+export interface Capabilities {
+    reference: {
+        library: string;
+        version: string;
+        docs: string;
+    };
+    /** python-pptx's classes, each with the names of it the API holds. */
+    holds: Record<string, string[]>;
+    /** python-pptx's enumerations, each with the members held. */
+    enums: Record<string, string[]>;
+    units: string[];
+    /** Where a held name behaves differently from python-pptx's. */
+    differs: string[];
+    /** What the API adds, by class and name, and what each is. */
+    adds: Record<string, Record<string, string>>;
+}
+export declare const CAPABILITIES: Capabilities;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/node_modules/@allyhub-next/slides-core/dist/capabilities.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{Animations as d,Background as l,Cell as p,ColorFormat as h,Column as m,FillFormat as y,Font as c,FreeformBuilder as _,GeneratedSlide as f,Generator as u,GroupShape as g,LineFormat as S,ListLevel as b,Paragraph as w,Placeholders as O,Presentation as L,Row as A,Run as P,Shape as E,ShapeCollection as x,SlideLayout as C,SlideLayouts as T,SlideMaster as M,SlideMasters as R,Table as v,TextFrame as k,TextStyles as I}from"./api.js";import{CategoryChartData as F,Chart as B,ChartAxis as G,ChartLegend as D,ChartPlot as H,ChartSeries as N,DataLabels as j}from"./chart-api.js";import{MSO_ANCHOR as W,MSO_ARROWHEAD as X,MSO_AUTO_SIZE as z,MSO_CONNECTOR as U,MSO_FILL as Y,MSO_LINE as Z,MSO_SHAPE as K,MSO_SHAPE_TYPE as q,MSO_THEME_COLOR as J,PP_ALIGN as Q,PP_PLACEHOLDER as V,THEME_FONT as $,XL_CHART_TYPE as ee,XL_LABEL_POSITION as te,XL_LEGEND_POSITION as ae}from"./enums.js";import{publicNames as o}from"./strict.js";const a={Presentation:{theme:"The theme's colours (dk1…folHlink) and fonts (major, minor), over the project's look.",components:"components.add(name, { props, layers }): a shape drawn by code, by the layer contract.",generators:"generators.add(name, (g) => { g.data(path); g.slides.add_slide(layout, id) … }): slides made from data, placed in slides.yaml as one block."},SlideMasters:{add:"add(name): a master, with Office's text styles and no placeholders yet."},_Cell:{borders:"Its edges: { left, right, top, bottom }, each { color, width } (a:lnL…)."},LineFormat:{begin_arrow:"What the end of the line where it starts has (MSO_ARROWHEAD): PowerPoint's Begin Arrow type (a:headEnd).",end_arrow:"What the end of the line where it ends has (MSO_ARROWHEAD): PowerPoint's End Arrow type (a:tailEnd)."},FreeformBuilder:{add_curve_segment:"add_curve_segment(x1, y1, x2, y2, x, y): a cubic Bézier segment by its two control points (a:cubicBezTo)."},Font:{spacing:"Space added between letters, a Length, negative to tighten (PowerPoint's Character Spacing, a:rPr spc)."},SlideMaster:{text_styles:"Its text styles (p:txStyles): title_style, body_style, other_style, nine ListLevels each, Office's to start with."},SlideLayouts:{add:"add(name): a layout on this master."},SlideLayout:{display_master_shapes:"Whether its master's shapes are drawn on its slides, true unless set: PowerPoint's Hide Background Graphics (@showMasterSp)."},placeholders:{add:"add(PP_PLACEHOLDER.X, left?, top?, width?, height?, { name }): a placeholder on a master or a layout; a layout's without a frame takes its master's of its base type."},SlideShapes:{add_component:"add_component(name, left, top, width, height, props): a component of the presentation in a frame.",get:"get(name): a shape by its name."},TextFrame:{list_style:"Its list style (a:lstStyle): nine ListLevels, level 0 first, what its paragraphs take where they set nothing."},ListLevel:{"*":"A level of a list style: alignment, line_spacing, space_before, space_after, font, bullet (a character, or null for none), bullet_font, margin_left, indent."},text_styles:{"*":"title_style, body_style, other_style: a master's text styles, nine ListLevels each."},Animations:{"*":"A generated slide's Animation Pane: add(shape, effect, { start, direction, duration, delay, paragraph, path }), in order."},Slide:{animations:"Its Animation Pane, which python-pptx has no API for.",transition:"How it comes on from the slide before: { type, direction, duration }, which python-pptx has no API for."},Generator:{"*":"What a generator's function is given: data(path), and slides.add_slide(layout, id)."}},se={Presentation:{slides:"A deck's slides are slides.yaml's, their words the script's; slides from data are a generator's.",save:"A deck is not saved by its code: allyhub render writes its files."}},oe={Presentation:L.prototype,SlideMasters:R.prototype,SlideMaster:M.prototype,SlideLayouts:T.prototype,SlideLayout:C.prototype,Slide:f.prototype,placeholders:O.prototype,SlideShapes:x.prototype,Shape:E.prototype,TextFrame:k.prototype,_Paragraph:w.prototype,_Run:P.prototype,Font:c.prototype,ColorFormat:h.prototype,FillFormat:y.prototype,LineFormat:S.prototype,FreeformBuilder:_.prototype,GroupShape:g.prototype,Table:v.prototype,CategoryChartData:F.prototype,Chart:B.prototype,Plot:H.prototype,Series:N.prototype,DataLabels:j.prototype,Legend:D.prototype,Axis:G.prototype,_Cell:p.prototype,_Column:m.prototype,_Row:A.prototype,_Background:l.prototype},re={Animations:d.prototype,ListLevel:b.prototype,text_styles:I.prototype,Generator:u.prototype},ne=()=>{const e={};for(const[t,r]of Object.entries(oe)){const n=a[t]??{},i=se[t]??{};e[t]=o(r).filter(s=>!Object.hasOwn(n,s)&&!Object.hasOwn(i,s))}return e};export const CAPABILITIES={reference:{library:"python-pptx",version:"1.0.2",docs:"https://python-pptx.readthedocs.io/"},holds:ne(),enums:Object.fromEntries(Object.entries({MSO_THEME_COLOR:J,PP_ALIGN:Q,MSO_ANCHOR:W,MSO_AUTO_SIZE:z,PP_PLACEHOLDER:V,MSO_SHAPE:K,MSO_CONNECTOR:U,MSO_SHAPE_TYPE:q,MSO_FILL:Y,MSO_LINE:Z,XL_CHART_TYPE:ee,XL_LABEL_POSITION:te,XL_LEGEND_POSITION:ae,MSO_ARROWHEAD:X,THEME_FONT:$}).map(([e,t])=>[e,Object.keys(t)])),units:["Emu","Inches","Pt","Cm","Mm","Centipoints","RGBColor"],differs:["The entry is export default presentation({ size, theme }, (prs) => { … }), not Presentation(path): a deck is made by its code, never opened from a template. Its masters and layouts are made with the additions below; its slides are slides.yaml's.","A name python-pptx has that is not held throws where it is used, naming what the class holds; python-pptx's x[i] is held where it indexes (slide_masters[0], slide_layouts[0], placeholders[idx], shapes[0]), and len(x) is x.length.","Lengths are numbers of EMU, made by python-pptx's functions (Inches(1), Pt(12)): no .inches or .pt on them; divide by 914400 or 12700.",`An enumeration's members are PresentationML's values (MSO_THEME_COLOR.ACCENT_1 is "accent1", PP_ALIGN.CENTER "ctr"), not integers; TEXT_1 and BACKGROUND_1 are dk1 and lt1, a master's standard colour map. MSO_SHAPE_TYPE.COMPONENT is a component's.`,`A colour's rgb is "#RRGGBB": RGBColor(r, g, b) and RGBColor.from_string("RRGGBB") make one.`,"line_spacing is a number of lines, or a Length of Pt(1) and over for a fixed height (python-pptx tells them apart by type).","add_picture() takes both width and height: a picture's own size is not read while a deck's code runs.","add_movie(movie_file, left, top, width, height, { poster_frame_time }) takes a video file, its poster a moment of it in seconds, not poster_frame_image.","A shape's name is its kind and a number (textbox-1, shape-2), and a placeholder's its type's (title, body, subtitle): slides.yaml and the script name shapes by name.","fit_text() sets the frame to shrink its text when it is drawn (MSO_AUTO_SIZE.TEXT_TO_FIT_SHAPE) from max_size: it reads no font file.","Font.underline is a single underline or none.","A chart holds column, bar, line, area, pie and doughnut types; it has no 3D, no scatter and no second axis. slides.yaml's chart can read its numbers from a project file: data, categories and series name it and its columns.","A table has no style, where python-pptx's starts with Medium Style 2: its look is its cells' (fill, borders, text), and first_row and the like say what its rows are and paint nothing. add_table returns its shape, whose .table is the table.","A group is its shapes: they are listed with the shapes the group is among, drawn as they are, and a group holds no group; its box is theirs, so left and top move them and width and height only read.","A presentation is 16:9 (12192000 × 6858000) and its theme Office 2013–2022's over the project's look; python-pptx's template is 4:3 with Office 2007's.","prs.slide_layouts and prs.slide_master are the first master's, as python-pptx's; a generator's add_slide also takes a layout of any master by name."],adds:{...a,...Object.fromEntries(Object.entries(re).map(([e,t])=>[e,{...a[e]??{},names:o(t).join(", ")}]))}};

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

@@ -0,0 +1,165 @@
+import type { ChartLegendPosition, ChartType } from "@allyhub-next/formats";
+import { ColorFormat, FillFormat } from "./api.js";
+import type { ChartAxisDef, ChartDef, ChartLabelPosition, ChartLabelsDef, ChartSeriesDef } from "@allyhub-next/chart";
+import type { Color } from "./model.js";
+import { type Length } 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[];
+}
+/** 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(): Length | 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);
+}
+/** 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(): {
+        number_format: string;
+    };
+    /** Its gridlines' colour (`major_gridlines.format.line.color`). */
+    get major_gridlines(): {
+        format: {
+            line: ChartLine;
+        };
+    };
+    /** Its line's colour (`format.line.color`). */
+    get format(): {
+        line: ChartLine;
+    };
+}
+/** 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-next/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 a,FillFormat as f}from"./api.js";import{accentOf as h,isRound as l}from"@allyhub-next/chart";import{strict as i}from"./strict.js";import{Pt as n}from"./units.js";export class CategoryChartData{number_format;names=[];list=[];constructor(e={}){return this.number_format=e.number_format??"General",i(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=[],r){this.list.push({name:e,values:t.map(d=>d??null),...r===void 0?{}:{number_format:r}})}_series(){return this.list.map(e=>({...e,values:[...e.values],number_format:e.number_format??this.number_format}))}}const u=s=>s===void 0?void 0:s/n(1);export class ChartFont{read;write;constructor(e,t){return this.read=e,this.write=t,i(this,"ChartFont")}get size(){const e=this.read().size;return e===void 0?void 0:n(e)}set size(e){const t=this.read(),r=u(e);this.write({...t.color===void 0?{}:{color:t.color},...r===void 0?{}:{size:r}})}get color(){return new a(()=>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,i(this,"ChartLine")}get color(){return new a(this.read,this.write)}}export class ChartSeries{def;at;constructor(e,t){return this.def=e,this.at=t,i(this,"ChartSeries")}get name(){return this.def.name}get values(){return this.def.values}get marker(){const e=this.def;return{get size(){return e.marker_size},set size(t){t===void 0?delete e.marker_size:e.marker_size=t}}}get smooth(){return this.def.smooth===!0}set smooth(e){this.def.smooth=e}get format(){const e=this.def;return{line:{get width(){return e.line_width===void 0?void 0:n(e.line_width)},set width(t){t===void 0?delete e.line_width:e.line_width=t/n(1)}},fill:new f(()=>this.def.color??h(this.at),t=>{t!==null&&(this.def.color=t)})}}}export class DataLabels{def;constructor(e){return this.def=e,i(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,i(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??l(this.def.type)}set vary_by_categories(e){this.def.vary_by_categories=e}}export class ChartLegend{def;constructor(e){return this.def=e,i(this,"ChartLegend")}get position(){return this.def.legend??"right"}set position(e){this.def.legend=e}}export class ChartAxis{def;constructor(e){return this.def=e,i(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(){const e=this.def;return{get number_format(){return e.number_format??"General"},set number_format(t){e.number_format=t}}}get major_gridlines(){return{format:{line:new ChartLine(()=>this.def.gridline_color,e=>{e===void 0?delete this.def.gridline_color:this.def.gridline_color=e})}}}get format(){return{line: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,i(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{font:{get size(){return e.title_size===void 0?void 0:n(e.title_size)},set size(t){t===void 0?delete e.title_size:e.title_size=t/n(1)}},text_frame:{get text(){return e.title??""},set text(t){e.title=t}}}}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((r,d)=>{const o=t[d]?.color;return o===void 0?r:{...r,color:o}})}}

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

@@ -0,0 +1,11 @@
+import { type ChartDef } from "@allyhub-next/chart";
+import type { ChartFile } from "@allyhub-next/formats";
+export declare function chartOfFile(f: ChartFile, o: {
+    title: string | undefined;
+    /** The deck's folder. */
+    base: string;
+    /** A data file's content, from the deck's folder. */
+    rows: (path: string) => unknown;
+    problem: (message: string) => void;
+}): ChartDef | undefined;
+//# sourceMappingURL=chart-file.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{labelPositionsOf as y}from"@allyhub-next/chart";import{colorOfFile as u,joinPath as z}from"./resolve.js";const v=e=>e&&{...e.min===void 0?{}:{minimum_scale:e.min},...e.max===void 0?{}:{maximum_scale:e.max},...e.major===void 0?{}:{major_unit:e.major},...e.gridlines===void 0?{}:{has_major_gridlines:e.gridlines},...e.visible===void 0?{}:{visible:e.visible},...e.format===void 0?{}:{number_format:e.format},...e.reverse===void 0?{}:{reverse_order:e.reverse},...e.gridline_color===void 0?{}:{gridline_color:u(e.gridline_color)},...e.line_color===void 0?{}:{line_color:u(e.line_color)}},x=e=>{if(!(e===void 0||e===!1))return e===!0?{show_value:!0}:{...e.value===void 0?{}:{show_value:e.value},...e.percentage===void 0?{}:{show_percentage:e.percentage},...e.category===void 0?{}:{show_category_name:e.category},...e.series===void 0?{}:{show_series_name:e.series},...e.format===void 0?{}:{number_format:e.format},...e.position===void 0?{}:{position:e.position},...e.size===void 0?{}:{size:e.size},...e.color===void 0?{}:{color:u(e.color)}}};function j(e){if(typeof e=="number")return Number.isFinite(e)?e:void 0;if(e==null)return null;if(typeof e!="string")return;const r=e.trim();if(r==="")return null;const s=Number(r);return Number.isFinite(s)?s:void 0}export function chartOfFile(e,r){const s=x(e.labels);let d,l;const c=n=>({...n.color===void 0?{}:{color:u(n.color)},...n.format===void 0?{}:{number_format:n.format},...n.smooth===void 0?{}:{smooth:n.smooth},...n.line_width===void 0?{}:{line_width:n.line_width},...n.marker_size===void 0?{}:{marker_size:n.marker_size}});if(e.data!==void 0){let n;try{n=r.rows(e.data)}catch(i){r.problem(`${e.data} cannot be read: ${i instanceof Error?i.message:String(i)}`);return}if(!Array.isArray(n)||n.length===0){r.problem(`${e.data} holds no rows.`);return}const t=n,a=e.categories;if(typeof a!="string"){r.problem("with data, categories names its column.");return}const p=Object.keys(t[0]??{}),_=[a,...e.series.map(i=>typeof i=="string"?i:i.name)].filter(i=>!p.includes(i));if(_.length>0){r.problem(`${e.data} has no column ${_.join(", ")} (it has ${p.join(", ")}).`);return}d=t.map(i=>{const o=i[a];return typeof o=="string"||typeof o=="number"?String(o):""}),l=e.series.map(i=>{const o=typeof i=="string"?i:i.name,w=t.map((h,$)=>{const b=j(h[o]);return b===void 0?(r.problem(`${String(e.data)} row ${String($+1)}: ${JSON.stringify(h[o])} in ${o} is not a number.`),null):b});return{name:o,values:w,...typeof i=="string"?{}:c(i)}})}else{if(typeof e.categories=="string"){r.problem("categories names a column, and there is no data to read.");return}d=e.categories;const n=[];for(const t of e.series){if(typeof t=="string"||!t.values){const a=typeof t=="string"?t:t.name;r.problem(`series ${a} has no values, and there is no data to read.`);return}t.values.length!==d.length&&r.problem(`series ${t.name} has ${String(t.values.length)} values for ${String(d.length)} categories.`),n.push({name:t.name,values:t.values,...c(t)})}l=n}const m=s?.position;m!==void 0&&!y(e.type).includes(m)&&r.problem(`a ${e.type} chart has no label position ${m}, which PowerPoint would repair (it has ${y(e.type).join(", ")||"none"}).`);const f=v(e.value_axis),g=v(e.category_axis);return{type:e.type,categories:d,series:l,...r.title===void 0?{}:{title:r.title},...e.legend===void 0?{}:{legend:e.legend},...s?{labels:s}:{},...e.gap_width===void 0?{}:{gap_width:e.gap_width},...e.overlap===void 0?{}:{overlap:e.overlap},...e.vary_by_categories===void 0?{}:{vary_by_categories:e.vary_by_categories},...e.hole_size===void 0?{}:{hole_size:e.hole_size},...f?{value_axis:f}:{},...g?{category_axis:g}:{},...e.size===void 0?{}:{font_size:e.size},...e.title_size===void 0?{}:{title_size:e.title_size},...e.color===void 0?{}:{font_color:u(e.color)},...e.data===void 0?{}:{source:z(r.base,e.data)}}}

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

@@ -0,0 +1,7 @@
+import type { DeckProblem, ResolvedDeck } from "./resolve.js";
+export interface DeckProject {
+    /** A media file's kind (`image`, `video`, `audio`) by its project path; undefined when it is not in the project. */
+    mediaKind: (path: string) => string | undefined;
+}
+export declare function checkDeck(deck: ResolvedDeck, project: DeckProject): DeckProblem[];
+//# sourceMappingURL=check.d.ts.map

package/dist/node_modules/@allyhub-next/slides-core/dist/check.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export function checkDeck(m,h){const i=[];for(const s of m.slides){const d=new Set;for(const e of s.shapes){e.level==="slide"&&(d.has(e.name)&&i.push({slide:s.id,shape:e.name,message:`Slide ${s.id} has two shapes named ${e.name}.`}),d.add(e.name));const a=e.media;if(!a)continue;const o=e.kind==="movie"?"video":"image",n=h.mediaKind(a.path),t={slide:s.id,shape:e.name};n===void 0?i.push({...t,message:`${a.path} (shape ${e.name} of slide ${s.id}) is not in the project.`}):n!==o&&i.push({...t,message:`${a.path} (shape ${e.name} of slide ${s.id}) is ${n==="image"?"an image":`a ${n}`}, not ${o==="image"?"an image":"a video"}.`})}}return i}

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

@@ -0,0 +1,146 @@
+export declare const MSO_THEME_COLOR: {
+    readonly DARK_1: "dk1";
+    readonly LIGHT_1: "lt1";
+    readonly DARK_2: "dk2";
+    readonly LIGHT_2: "lt2";
+    readonly ACCENT_1: "accent1";
+    readonly ACCENT_2: "accent2";
+    readonly ACCENT_3: "accent3";
+    readonly ACCENT_4: "accent4";
+    readonly ACCENT_5: "accent5";
+    readonly ACCENT_6: "accent6";
+    readonly HYPERLINK: "hlink";
+    readonly FOLLOWED_HYPERLINK: "folHlink";
+    readonly TEXT_1: "dk1";
+    readonly BACKGROUND_1: "lt1";
+    readonly TEXT_2: "dk2";
+    readonly BACKGROUND_2: "lt2";
+};
+export declare const PP_ALIGN: {
+    readonly LEFT: "l";
+    readonly CENTER: "ctr";
+    readonly RIGHT: "r";
+    readonly JUSTIFY: "just";
+};
+/** A text frame's vertical anchor (`a:bodyPr/@anchor`). */
+export declare const MSO_ANCHOR: {
+    readonly TOP: "t";
+    readonly MIDDLE: "ctr";
+    readonly BOTTOM: "b";
+};
+export type Anchor = (typeof MSO_ANCHOR)[keyof typeof MSO_ANCHOR];
+/** How a text frame fits its text (`a:normAutofit`, `a:spAutoFit`, none). */
+export declare const MSO_AUTO_SIZE: {
+    readonly NONE: "none";
+    readonly SHAPE_TO_FIT_TEXT: "shape";
+    readonly TEXT_TO_FIT_SHAPE: "text";
+};
+export type AutoSize = (typeof MSO_AUTO_SIZE)[keyof typeof MSO_AUTO_SIZE];
+/** A placeholder's type (`p:ph/@type`). */
+export declare const PP_PLACEHOLDER: {
+    readonly TITLE: "title";
+    readonly CENTER_TITLE: "ctrTitle";
+    readonly SUBTITLE: "subTitle";
+    readonly BODY: "body";
+    readonly PICTURE: "pic";
+    readonly MEDIA_CLIP: "media";
+    readonly OBJECT: "obj";
+    readonly DATE: "dt";
+    readonly FOOTER: "ftr";
+    readonly SLIDE_NUMBER: "sldNum";
+};
+export type PlaceholderType = (typeof PP_PLACEHOLDER)[keyof typeof PP_PLACEHOLDER];
+/** An autoshape's preset geometry (`a:prstGeom/@prst`). */
+export declare const MSO_SHAPE: {
+    readonly RECTANGLE: "rect";
+    readonly ROUNDED_RECTANGLE: "roundRect";
+    readonly OVAL: "ellipse";
+    readonly ISOSCELES_TRIANGLE: "triangle";
+    readonly RIGHT_ARROW: "rightArrow";
+};
+/** A connector's kind (`add_connector`). */
+export declare const MSO_CONNECTOR: {
+    readonly STRAIGHT: "line";
+};
+/** A line's dashes (`line.dash_style`). */
+export declare const MSO_LINE: {
+    readonly SOLID: "solid";
+    readonly SQUARE_DOT: "sysDash";
+    readonly ROUND_DOT: "sysDot";
+    readonly DASH: "dash";
+    readonly DASH_DOT: "dashDot";
+    readonly DASH_DOT_DOT: "lgDashDotDot";
+    readonly LONG_DASH: "lgDash";
+    readonly LONG_DASH_DOT: "lgDashDot";
+};
+/** What a line's end has (`line.begin_arrow`, `line.end_arrow`): PowerPoint's arrow types; python-pptx has no such enumeration. */
+export declare const MSO_ARROWHEAD: {
+    readonly NONE: "none";
+    readonly TRIANGLE: "triangle";
+    readonly OPEN: "arrow";
+    readonly STEALTH: "stealth";
+    readonly DIAMOND: "diamond";
+    readonly OVAL: "oval";
+};
+/** What a shape is (`shape.shape_type`). `COMPONENT` is AllyHub's: a shape drawn by code. */
+export declare const MSO_SHAPE_TYPE: {
+    readonly AUTO_SHAPE: "autoshape";
+    readonly FREEFORM: "freeform";
+    readonly GROUP: "group";
+    readonly LINE: "line";
+    readonly TABLE: "table";
+    readonly CHART: "chart";
+    readonly MEDIA: "movie";
+    readonly PICTURE: "picture";
+    readonly PLACEHOLDER: "placeholder";
+    readonly TEXT_BOX: "textbox";
+    readonly COMPONENT: "component";
+};
+export type ShapeType = (typeof MSO_SHAPE_TYPE)[keyof typeof MSO_SHAPE_TYPE];
+/** A chart's kind (python-pptx's XL_CHART_TYPE). */
+export declare const XL_CHART_TYPE: {
+    readonly COLUMN_CLUSTERED: "column-clustered";
+    readonly COLUMN_STACKED: "column-stacked";
+    readonly COLUMN_STACKED_100: "column-stacked-100";
+    readonly BAR_CLUSTERED: "bar-clustered";
+    readonly BAR_STACKED: "bar-stacked";
+    readonly BAR_STACKED_100: "bar-stacked-100";
+    readonly LINE: "line";
+    readonly LINE_MARKERS: "line-markers";
+    readonly AREA: "area";
+    readonly AREA_STACKED: "area-stacked";
+    readonly AREA_STACKED_100: "area-stacked-100";
+    readonly PIE: "pie";
+    readonly DOUGHNUT: "doughnut";
+};
+/** Where a chart's legend is. */
+export declare const XL_LEGEND_POSITION: {
+    readonly BOTTOM: "bottom";
+    readonly TOP: "top";
+    readonly LEFT: "left";
+    readonly RIGHT: "right";
+};
+/** Where a data label sits. */
+export declare const XL_LABEL_POSITION: {
+    readonly ABOVE: "t";
+    readonly BELOW: "b";
+    readonly BEST_FIT: "bestFit";
+    readonly CENTER: "ctr";
+    readonly INSIDE_BASE: "inBase";
+    readonly INSIDE_END: "inEnd";
+    readonly LEFT: "l";
+    readonly OUTSIDE_END: "outEnd";
+    readonly RIGHT: "r";
+};
+/** A fill's kind (`fill.type`). */
+export declare const MSO_FILL: {
+    readonly SOLID: "solid";
+    readonly BACKGROUND: "background";
+};
+export type FillType = (typeof MSO_FILL)[keyof typeof MSO_FILL];
+/** The theme's fonts as a run names them (`+mj-lt`, `+mn-lt`). */
+export declare const THEME_FONT: {
+    readonly MAJOR: "+mj-lt";
+    readonly MINOR: "+mn-lt";
+};
+//# sourceMappingURL=enums.d.ts.map

package/dist/node_modules/@allyhub-next/slides-core/dist/enums.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{strictEnum as E}from"./strict.js";export const MSO_THEME_COLOR=E("MSO_THEME_COLOR",{DARK_1:"dk1",LIGHT_1:"lt1",DARK_2:"dk2",LIGHT_2:"lt2",ACCENT_1:"accent1",ACCENT_2:"accent2",ACCENT_3:"accent3",ACCENT_4:"accent4",ACCENT_5:"accent5",ACCENT_6:"accent6",HYPERLINK:"hlink",FOLLOWED_HYPERLINK:"folHlink",TEXT_1:"dk1",BACKGROUND_1:"lt1",TEXT_2:"dk2",BACKGROUND_2:"lt2"}),PP_ALIGN=E("PP_ALIGN",{LEFT:"l",CENTER:"ctr",RIGHT:"r",JUSTIFY:"just"}),MSO_ANCHOR=E("MSO_ANCHOR",{TOP:"t",MIDDLE:"ctr",BOTTOM:"b"}),MSO_AUTO_SIZE=E("MSO_AUTO_SIZE",{NONE:"none",SHAPE_TO_FIT_TEXT:"shape",TEXT_TO_FIT_SHAPE:"text"}),PP_PLACEHOLDER=E("PP_PLACEHOLDER",{TITLE:"title",CENTER_TITLE:"ctrTitle",SUBTITLE:"subTitle",BODY:"body",PICTURE:"pic",MEDIA_CLIP:"media",OBJECT:"obj",DATE:"dt",FOOTER:"ftr",SLIDE_NUMBER:"sldNum"}),MSO_SHAPE=E("MSO_SHAPE",{RECTANGLE:"rect",ROUNDED_RECTANGLE:"roundRect",OVAL:"ellipse",ISOSCELES_TRIANGLE:"triangle",RIGHT_ARROW:"rightArrow"}),MSO_CONNECTOR=E("MSO_CONNECTOR",{STRAIGHT:"line"}),MSO_LINE=E("MSO_LINE",{SOLID:"solid",SQUARE_DOT:"sysDash",ROUND_DOT:"sysDot",DASH:"dash",DASH_DOT:"dashDot",DASH_DOT_DOT:"lgDashDotDot",LONG_DASH:"lgDash",LONG_DASH_DOT:"lgDashDot"}),MSO_ARROWHEAD=E("MSO_ARROWHEAD",{NONE:"none",TRIANGLE:"triangle",OPEN:"arrow",STEALTH:"stealth",DIAMOND:"diamond",OVAL:"oval"}),MSO_SHAPE_TYPE=E("MSO_SHAPE_TYPE",{AUTO_SHAPE:"autoshape",FREEFORM:"freeform",GROUP:"group",LINE:"line",TABLE:"table",CHART:"chart",MEDIA:"movie",PICTURE:"picture",PLACEHOLDER:"placeholder",TEXT_BOX:"textbox",COMPONENT:"component"}),XL_CHART_TYPE=E("XL_CHART_TYPE",{COLUMN_CLUSTERED:"column-clustered",COLUMN_STACKED:"column-stacked",COLUMN_STACKED_100:"column-stacked-100",BAR_CLUSTERED:"bar-clustered",BAR_STACKED:"bar-stacked",BAR_STACKED_100:"bar-stacked-100",LINE:"line",LINE_MARKERS:"line-markers",AREA:"area",AREA_STACKED:"area-stacked",AREA_STACKED_100:"area-stacked-100",PIE:"pie",DOUGHNUT:"doughnut"}),XL_LEGEND_POSITION=E("XL_LEGEND_POSITION",{BOTTOM:"bottom",TOP:"top",LEFT:"left",RIGHT:"right"}),XL_LABEL_POSITION=E("XL_LABEL_POSITION",{ABOVE:"t",BELOW:"b",BEST_FIT:"bestFit",CENTER:"ctr",INSIDE_BASE:"inBase",INSIDE_END:"inEnd",LEFT:"l",OUTSIDE_END:"outEnd",RIGHT:"r"}),MSO_FILL=E("MSO_FILL",{SOLID:"solid",BACKGROUND:"background"}),THEME_FONT=E("THEME_FONT",{MAJOR:"+mj-lt",MINOR:"+mn-lt"});

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

@@ -0,0 +1,109 @@
+import { type AnimationFile, type ShapeFile, type TransitionFile, type SlideFile, type SlidesFile } from "@allyhub-next/formats";
+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 nothing when it is not the format, what is wrong, and the line of any path. */
+export declare function readSlidesFile(text: string): {
+    file?: SlidesFile;
+    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'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;
+};
+/** slides.yaml's text after an edit. */
+export declare function editSlidesFile(text: string | undefined, edit: SlidesEdit): string;
+/** 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[];
+/** Where a person's change met another hand's: the person's stands. */
+export interface SlidesConflict {
+    slide: string;
+    shape?: string;
+    /** The field both changed (`frame`, `text.size`, `layout`); absent when the other hand removed what the person changed. */
+    field?: string;
+}
+/**
+ * A person's slides.yaml (`mine`, what the editor holds, made from
+ * `base`) merged into the file as another hand left it (`theirs`): the
+ * person's changes made over theirs, so what the other hand changed
+ * elsewhere stands, and where both changed one value the person's does,
+ * said in `conflicts`. 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;
+//# sourceMappingURL=file.d.ts.map

package/dist/node_modules/@allyhub-next/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 x}from"@allyhub-next/formats";import{isMap as u,isSeq as O,LineCounter as w,parseDocument as N}from"yaml";export function readSlidesFile(t){const e=new w,n=N(t,{lineCounter:e}),o=l=>{const s=l===""?[]:l.split(".");for(let a=s.length;a>=0;a--){const r=n.getIn(s.slice(0,a).map(i=>/^\d+$/u.test(i)?Number(i):i),!0)?.range?.[0];if(r!==void 0)return e.linePos(r).line}};if(n.errors.length>0)return{problems:n.errors.map(l=>({path:"",line:e.linePos(l.pos[0]).line,message:`slides.yaml is not YAML: ${l.message.split(`
+`)[0]??""}`})),lineOf:o};const c=x("slides",n.toJS()??{});return c.ok?{file:c.value,problems:[],lineOf:o}:{problems:c.problems.map(l=>{const s=o(l.path);return{path:l.path,...s===void 0?{}:{line:s},message:l.message}}),lineOf:o}}const A=`slides: []
+`;function M(t){let e=t.get("slides",!0);if(O(e)||(u(t.contents)?t.set("slides",t.createNode([])):t.contents=t.createNode({slides:[]}),e=t.get("slides",!0)),!O(e))throw new Error("slides.yaml has no slides list.");return e}const b=(t,e)=>t.findIndex(n=>u(n)&&n.get("id")===e),E=["frame","text","fill","line","z","crop"];export function editSlidesFile(t,e){const n=N(t===void 0||t.trim()===""?A:t);if(n.errors.length>0)throw new Error("slides.yaml is not YAML: it is mended by hand first.");const o=M(n),c=r=>{if(r===null)return 0;const i=r===void 0?-1:b(o.items,r);return i<0?o.items.length:i+1};if(e.op==="add")return b(o.items,e.slide.id)>=0||(o.items.splice(c(e.after),0,n.createNode(e.slide)),o.flow===!0&&(o.flow=!1)),n.toString();const l=b(o.items,e.slide),s=o.items[l];if(l<0||!u(s))return t??A;const a=r=>{let i=s.get("shapes",!0);return!u(i)&&r&&(s.set("shapes",n.createNode({})),i=s.get("shapes",!0)),u(i)?i:void 0},f=()=>{const r=a(!1);if(r){for(const i of[...r.items])u(i.value)&&i.value.items.length===0&&r.delete(i.key);r.items.length===0&&s.delete("shapes")}};switch(e.op){case"move":{if(e.after===e.slide)break;o.items.splice(l,1),o.items.splice(c(e.after),0,s);break}case"duplicate":{const r=s.clone();r.set("id",e.id),o.items.splice(l+1,0,r);break}case"remove":o.items.splice(l,1);break;case"layout":s.set("layout",e.layout);break;case"hidden":e.hidden===!1||Array.isArray(e.hidden)&&e.hidden.length===0?s.delete("hidden"):s.set("hidden",n.createNode(e.hidden));break;case"shape":{const r=a(!0);if(!r)break;let i=r.get(e.shape,!0);if(u(i)||(r.set(e.shape,n.createNode({})),i=r.get(e.shape,!0)),!u(i))break;for(const[d,p]of Object.entries(e.set)){const m=d.split(".");if(p===void 0){i.deleteIn(m);const h=m.length>1?i.getIn(m.slice(0,-1),!0):void 0;u(h)&&h.items.length===0&&i.deleteIn(m.slice(0,-1))}else i.setIn(m,n.createNode(p))}f();break}case"unplace":{a(!1)?.delete(e.shape),f();break}case"animations":e.animations.length===0?s.delete("animations"):s.set("animations",n.createNode(e.animations));break;case"transition":e.transition===void 0?s.delete("transition"):s.set("transition",n.createNode(e.transition));break;case"reset":{const r=a(!1);if(!r)break;for(const i of r.items){const d=String(u(i.key)?"":i.key.value??i.key);if(e.shape!==void 0&&d!==e.shape)continue;const p=i.value;if(!(!u(p)||["textbox","picture","movie","geometry","component"].some(h=>p.has(h))))for(const h of E)p.delete(h)}f();break}}return n.toString()}export function freeName(t,e){const n=new Set(t),o=e.replace(/[^A-Za-z0-9_-]+/gu,"-").replace(/^-+|-+$/gu,"")||"slide";if(!n.has(o))return o;for(let c=2;;c++){const l=`${o}-${String(c)}`;if(!n.has(l))return l}}const $=new Set(["text","props","crop"]),y=t=>Array.isArray(t)?t.map(y):t!==null&&typeof t=="object"?Object.fromEntries(Object.entries(t).sort(([e],[n])=>e<n?-1:e>n?1:0).map(([e,n])=>[e,y(n)])):t,k=(t,e)=>JSON.stringify(y(t))===JSON.stringify(y(e));function j(t){const e=new Map;for(const[n,o]of Object.entries(t??{}))if($.has(n)&&typeof o=="object"&&!Array.isArray(o))for(const[c,l]of Object.entries(o))e.set(`${n}.${c}`,l);else e.set(n,o);return e}function I(t,e){const n=t.length,o=e.length,c=Array.from({length:n+1},()=>new Array(o+1).fill(0));for(let s=n-1;s>=0;s--)for(let a=o-1;a>=0;a--){const f=c[s],r=c[s+1];!f||!r||(f[a]=t[s]===e[a]?(r[a+1]??0)+1:Math.max(r[a]??0,f[a+1]??0))}const l=new Set;for(let s=0,a=0;s<n&&a<o;)t[s]===e[a]?(l.add(t[s]??""),s++,a++):(c[s+1]?.[a]??0)>=(c[s]?.[a+1]??0)?s++:a++;return l}function J(t,e){const n=[],o=e.id;e.layout!==void 0&&e.layout!==t.layout&&n.push({op:"layout",slide:o,layout:e.layout}),k(t.hidden,e.hidden)||n.push({op:"hidden",slide:o,hidden:e.hidden??!1}),k(t.animations??[],e.animations??[])||n.push({op:"animations",slide:o,animations:e.animations??[]}),k(t.transition,e.transition)||n.push({op:"transition",slide:o,...e.transition?{transition:e.transition}:{}});const c=t.shapes??{},l=e.shapes??{};for(const s of Object.keys(c))s in l||n.push({op:"unplace",slide:o,shape:s});for(const[s,a]of Object.entries(l)){const f=j(c[s]),r=j(a),i={};for(const d of new Set([...f.keys(),...r.keys()]))k(f.get(d),r.get(d))||(i[d]=r.get(d));Object.keys(i).length>0&&n.push({op:"shape",slide:o,shape:s,set:i})}return n}export function slidesEdits(t,e){const n=[],o=new Map(t.slides.map(s=>[s.id,s])),c=new Set(e.slides.map(s=>s.id));for(const s of t.slides)c.has(s.id)||n.push({op:"remove",slide:s.id});const l=I(t.slides.map(s=>s.id).filter(s=>c.has(s)),e.slides.map(s=>s.id).filter(s=>o.has(s)));return e.slides.forEach((s,a)=>{const f=a===0?null:e.slides[a-1]?.id??null,r=o.get(s.id);if(!r||r.generate!==s.generate){r&&n.push({op:"remove",slide:s.id}),n.push({op:"add",slide:s,after:f});return}l.has(s.id)||n.push({op:"move",slide:s.id,after:f}),n.push(...J(r,s))}),n}const g=(t,e,n)=>JSON.stringify([t,e,n]);function v(t){const e=new Map;switch(t.op){case"layout":e.set(g(t.slide,"","layout"),t.layout);break;case"hidden":e.set(g(t.slide,"","hidden"),t.hidden);break;case"animations":e.set(g(t.slide,"","animations"),t.animations);break;case"transition":e.set(g(t.slide,"","transition"),t.transition);break;case"shape":for(const[n,o]of Object.entries(t.set))e.set(g(t.slide,t.shape,n),o);break;case"unplace":e.set(g(t.slide,t.shape,""),void 0);break;case"remove":e.set(g(t.slide,"",""),void 0);break;default:break}return e}export function mergeSlides(t,e,n){const o=readSlidesFile(t).file??{slides:[]},c=readSlidesFile(n).file;if(!c)return;const l=slidesEdits(o,e);let s=n;for(const i of l)s=editSlidesFile(s,i);const a=new Map;for(const i of slidesEdits(o,c))for(const[d,p]of v(i))a.set(d,p);const f=new Set(o.slides.map(i=>i.id).filter(i=>!c.slides.some(d=>d.id===i))),r=[];for(const i of l){if("slide"in i&&typeof i.slide=="string"&&f.has(i.slide)&&i.op!=="remove"){r.push({slide:i.slide});continue}for(const[d,p]of v(i)){if(!a.has(d)||k(a.get(d),p))continue;const[m="",h="",S=""]=JSON.parse(d);r.push({slide:m,...h===""?{}:{shape:h},...S===""?{}:{field:S}})}}return{text:s,conflicts:r}}

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

@@ -0,0 +1,21 @@
+export * from "./units.js";
+export * from "./enums.js";
+export * from "./strict.js";
+export * from "./animation.js";
+export * from "@allyhub-next/chart";
+export * from "./chart-api.js";
+export { chartOfFile } from "./chart-file.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 "./resolve.js";
+export * from "./file.js";
+export * from "./script.js";
+export * from "./stage.js";
+export * from "./check.js";
+export * from "./capabilities.js";
+export * from "./measure.js";
+//# sourceMappingURL=index.d.ts.map