allyhub 0.3.0 → 0.4.0

package/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/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/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/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/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 "./chart.js";
+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

package/node_modules/@allyhub-next/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"./enums.js";export*from"./strict.js";export*from"./animation.js";export*from"./chart.js";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";

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

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

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

@@ -0,0 +1,278 @@
+import type { AnimationFile, LineDash, TransitionFile, LineEnd, ShapeGeometry, TextAlign, ThemeColor } from "@allyhub-next/formats";
+import type { ChartDef } from "./chart.js";
+import type { Anchor, AutoSize, PlaceholderType } from "./enums.js";
+import type { ThemeInput } from "./theme.js";
+import type { Length } from "./units.js";
+export interface Frame {
+    left: Length;
+    top: Length;
+    width: Length;
+    height: Length;
+}
+/** A colour: the theme's, or `#RRGGBB`. */
+export type Color = ThemeColor | {
+    rgb: string;
+};
+/** Character properties (`a:rPr`, `a:defRPr`): what python-pptx's `Font` holds. */
+export interface FontDef {
+    /** A typeface, or the theme's (`+mj-lt`, `+mn-lt`). */
+    name?: string;
+    size?: Length;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    color?: ThemeColor;
+    /** A colour that is not the theme's, `#RRGGBB`. */
+    rgb?: string;
+    /** Space added between letters (negative tightens), EMU (`a:rPr` spc). */
+    spacing?: Length;
+}
+export interface RunDef {
+    /** Its text; `\v` is a line break in the paragraph (`a:br`). */
+    text: string;
+    font?: FontDef;
+    /** The script's `` `code` ``: its font is the theme's code font. */
+    code?: boolean;
+}
+/** Line spacing (`a:lnSpc`): a multiple of the line (`a:spcPct`) or a fixed height (`a:spcPts`). */
+export type LineSpacing = {
+    lines: number;
+} | {
+    fixed: Length;
+};
+/** A paragraph's properties (`a:pPr`), and a list style's level (`a:lvlNpPr`). */
+export interface ParagraphFormatDef {
+    alignment?: TextAlign;
+    line_spacing?: LineSpacing;
+    space_before?: Length;
+    space_after?: Length;
+    /** Its bullet character (`a:buChar`); null: none (`a:buNone`). */
+    bullet?: string | null;
+    /** The bullet's typeface (`a:buFont`). */
+    bullet_font?: string;
+    /** Where its lines start (`@marL`), and its first line from there (`@indent`, negative for a hanging bullet). */
+    margin_left?: Length;
+    indent?: Length;
+    /** Its runs' default character properties (`a:defRPr`). */
+    font?: FontDef;
+}
+export interface ParagraphDef extends ParagraphFormatDef {
+    runs: RunDef[];
+    /** Its indent level, 0 to 8 (`@lvl`). */
+    level: number;
+}
+/** The nine levels of a list style (`a:lstStyle`, a master's `p:titleStyle`…), level 0 first. */
+export type LevelsDef = ParagraphFormatDef[];
+/** A text frame (`p:txBody`): its body properties, its list style and its paragraphs. */
+export interface TextFrameDef {
+    paragraphs: ParagraphDef[];
+    /** Its list style, nine levels: a placeholder's for the text a slide gives it. */
+    levels: LevelsDef;
+    vertical_anchor?: Anchor;
+    auto_size?: AutoSize;
+    word_wrap?: boolean;
+    margin_left?: Length;
+    margin_top?: Length;
+    margin_right?: Length;
+    margin_bottom?: Length;
+}
+export type ShapeKind = "placeholder" | "textbox" | "picture" | "movie" | "autoshape" | "table" | "chart" | "component";
+/** A table cell's edge (`a:lnL`, `a:lnR`, `a:lnT`, `a:lnB`). */
+export interface CellBorder {
+    color: Color;
+    width: Length;
+}
+/** A table's cell (`a:tc`). */
+export interface TableCellDef {
+    text: TextFrameDef;
+    fill?: Color | null;
+    borders?: Partial<Record<"left" | "right" | "top" | "bottom", CellBorder>>;
+    /** Columns and rows it takes, merged (`@gridSpan`, `@rowSpan`). */
+    span_width?: number;
+    span_height?: number;
+    /** Another cell's, merged over it (`@hMerge`, `@vMerge`). */
+    spanned?: boolean;
+}
+/** A table (`a:tbl`). What PowerPoint's style would paint is the deck's own: a table here has no style, so its look is its cells'. */
+export interface TableDef {
+    columns: Length[];
+    rows: {
+        height: Length;
+        cells: TableCellDef[];
+    }[];
+    /** What its first row and so on are, for those who read it by them (`a:tblPr`); they paint nothing. */
+    first_row?: boolean;
+    first_col?: boolean;
+    last_row?: boolean;
+    last_col?: boolean;
+    horz_banding?: boolean;
+    vert_banding?: boolean;
+}
+/** A step of a freeform's outline, in its path's units. */
+export type PathStep = {
+    op: "move";
+    x: number;
+    y: number;
+} | {
+    op: "line";
+    x: number;
+    y: number;
+} | {
+    op: "curve";
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    x: number;
+    y: number;
+} | {
+    op: "close";
+};
+/** A freeform's outline: steps in a box of `w` × `h` units, stretched to the shape's frame (`a:path`). */
+export interface FreeformPath {
+    w: number;
+    h: number;
+    steps: PathStep[];
+}
+/** A shape as a master, a layout or a generator's code makes it. */
+export interface ShapeDef {
+    name: string;
+    kind: ShapeKind;
+    /** Its frame; a layout's placeholder without one takes its master's (`a:xfrm` left out). */
+    frame?: Frame;
+    /** A connector's ends: it runs from its frame's top left to its bottom right, unless flipped. */
+    flip?: {
+        h?: boolean;
+        v?: boolean;
+    };
+    /** Degrees clockwise about its centre, 0 up to 360 (`a:xfrm` rot). */
+    rotation?: number;
+    placeholder?: {
+        type: PlaceholderType;
+        idx: number;
+    };
+    text?: TextFrameDef;
+    fill?: Color | null;
+    line?: Color | null;
+    line_width?: Length;
+    line_dash?: LineDash;
+    /** What the end of its line where it starts has (`a:headEnd`), and where it ends (`a:tailEnd`). */
+    line_begin?: LineEnd;
+    line_end?: LineEnd;
+    geometry?: ShapeGeometry;
+    /** A freeform's outline (`a:custGeom`), in place of a geometry. */
+    path?: FreeformPath;
+    /** A table (`p:graphicFrame`). */
+    table?: TableDef;
+    /** A chart (`p:graphicFrame`). */
+    chart?: ChartDef;
+    /** The group it is in (`p:grpSp`), by a name the group's shapes share; a group is a file's, and drawn as its shapes. */
+    group?: string;
+    /** Its geometry's adjustments (`a:avLst`), as python-pptx's: a rounded rectangle's corner, a share of its shorter side. */
+    adjustments?: number[];
+    /** A picture or a movie: a path, and the folder of the module that named it (a project path). */
+    media?: {
+        path: string;
+        base: string;
+        poster?: number;
+    };
+    component?: {
+        name: string;
+        props: Record<string, unknown>;
+    };
+}
+export interface LayoutDef {
+    name: string;
+    master: string;
+    background?: Color | undefined;
+    /** False: its master's shapes are not drawn on its slides (`@showMasterSp`, PowerPoint's Hide Background Graphics). */
+    display_master_shapes?: boolean;
+    /** Its placeholders and its own shapes, back to front. */
+    shapes: ShapeDef[];
+}
+/** A master's text styles (`p:txStyles`): its titles', its other placeholders', and other text's. */
+export interface TextStylesDef {
+    title: LevelsDef;
+    body: LevelsDef;
+    other: LevelsDef;
+}
+export interface MasterDef {
+    name: string;
+    background: Color;
+    text_styles: TextStylesDef;
+    /** Its placeholders (the default frame and style of each type) and the shapes every slide shows, back to front. */
+    shapes: ShapeDef[];
+    layouts: LayoutDef[];
+}
+/** A prop a component exposes to a person, as data (the SDK's text(), number()…). */
+export interface PropSpec {
+    type: string;
+    optional?: boolean;
+    of?: PropSpec;
+    fields?: Readonly<Record<string, PropSpec>>;
+    kind?: string;
+}
+/** A component: a shape drawn by code (layers of the layer contract) in its frame. */
+export interface ComponentDef {
+    name: string;
+    props: Readonly<Record<string, PropSpec>>;
+    /** The layers it draws, laid out in its frame's pixels (the video's layer contract). */
+    layers: (props: Record<string, unknown>, ctx: ComponentContext) => unknown[];
+}
+/** What a component's layers function is given. */
+export interface ComponentContext {
+    /** Its frame's pixels as the stage draws it. */
+    width: number;
+    height: number;
+    /** The slide it is on. */
+    slide: string;
+}
+/** A slide a generator makes. */
+export interface GeneratedSlideDef {
+    /** Its id in the block: the slide is `<block>/<id>`. */
+    id: string;
+    layout: string;
+    /** Its layout's placeholders it moved or styled, by idx, and the shapes it adds. */
+    shapes: ShapeDef[];
+    /** Text set on a layout's placeholder, by its idx. */
+    text: Record<number, ParagraphDef[]>;
+    /** Its Animation Pane, in order. */
+    animations?: AnimationFile[];
+    /** How it comes on from the slide before. */
+    transition?: TransitionFile;
+    notes?: string;
+}
+export interface GeneratorContext {
+    /** A data file (CSV rows, YAML, JSON) from the deck's folder. */
+    data: (path: string) => unknown;
+}
+export interface GeneratorDef {
+    name: string;
+    make: (ctx: GeneratorContext) => GeneratedSlideDef[];
+}
+/** A deck's definition: what slides.ts makes. */
+export interface DeckDef {
+    slide_width: Length;
+    slide_height: Length;
+    theme?: ThemeInput;
+    masters: MasterDef[];
+    components: Record<string, ComponentDef>;
+    generators: Record<string, GeneratorDef>;
+}
+/**
+ * A deck as its stage drew it, in one language: what its PowerPoint file
+ * is written from. Its masters and layouts as code made them, its slides
+ * resolved (`ResolvedSlide`, resolve.ts), its theme as resolved.
+ */
+export interface DrawnDeck<Slide = unknown, DeckTheme = unknown> {
+    width: Length;
+    height: Length;
+    theme: DeckTheme;
+    masters: MasterDef[];
+    slides: Slide[];
+    /** The share autofit shrank a text to, by `<slide>/<shape>`. */
+    fitted: Record<string, number>;
+    /** The deck's language, its combo's. */
+    lang?: string;
+}
+//# sourceMappingURL=model.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export{};