allyhub 0.3.0 → 0.5.0

package/dist/node_modules/@allyhub-next/slides-core/LICENSE

@@ -0,0 +1,241 @@
+AllyHub Software License
+
+Copyright (c) 2026 AllyHub, Inc. ("AllyHub"). All rights reserved.
+
+This software (the AllyHub command-line tool, its SDK, runtime and the
+packages they depend on) is proprietary. It is not open source.
+
+1. Permitted use. You may install and run the software, unmodified, to make,
+   check, preview and render videos and decks, including for commercial
+   purposes. What you make with it is yours.
+
+2. Restrictions. Except as this license permits or applicable law requires,
+   you may not copy, modify, adapt, translate, sublicense, sell, rent, lease,
+   publish or otherwise distribute the software, create derivative works of
+   it, or reverse engineer, decompile or disassemble it.
+
+3. Cloud services. AllyHub's cloud tools (sign-in, research, images, voice,
+   video) are separate services governed by AllyHub's terms of service.
+
+4. Trademarks. This license grants no right to use the name "AllyHub" or its
+   logos.
+
+5. No warranty. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
+   KIND, EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY,
+   FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
+   ALLYHUB BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY ARISING FROM,
+   OUT OF OR IN CONNECTION WITH THE SOFTWARE OR ITS USE.
+
+6. Third-party code. Parts of the software are adapted from HyperFrames,
+   licensed under the Apache License, Version 2.0 (see NOTICE). Those parts
+   remain under that license, reproduced below, and nothing in this license
+   limits your rights under it.
+
+7. Starter components. The starter components in the "components" folder,
+   which "allyhub add" copies into your workspace, are licensed under the MIT
+   License (see components/LICENSE): once copied, you may change, use and
+   share them freely.
+
+--------------------------------------------------------------------------------
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

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

@@ -0,0 +1,129 @@
+import type { AnimationDirection, AnimationEffect, AnimationFile, AnimationStart, SlideTransitionType, TransitionFile } from "@allyhub-next/formats";
+import type { Frame, PathStep } from "./model.js";
+/** PowerPoint's default length of each effect, seconds. */
+export declare const ANIMATION_DURATIONS: Readonly<Record<AnimationEffect, number>>;
+export declare const isExit: (e: AnimationEffect) => boolean;
+export declare const isEntrance: (e: AnimationEffect) => boolean;
+/** PowerPoint's default length of each transition, seconds. */
+export declare const TRANSITION_DURATIONS: Readonly<Record<SlideTransitionType, number>>;
+/** A slide's transition with all it leaves to its defaults said. */
+export interface ResolvedTransition {
+    type: SlideTransitionType;
+    direction: AnimationDirection;
+    duration: number;
+}
+export declare const resolveTransition: (t: TransitionFile) => ResolvedTransition;
+/** How the two slides of a transition are drawn, `p` of the way through it. */
+export interface TransitionState {
+    /** The slide coming on: moved by, in shares of the slide, and what is cut from it. */
+    incoming: {
+        opacity: number;
+        x: number;
+        y: number;
+        clip?: {
+            top: number;
+            right: number;
+            bottom: number;
+            left: number;
+        };
+    };
+    /** The slide going: moved by, in shares of the slide. */
+    outgoing: {
+        x: number;
+        y: number;
+    };
+}
+/** A transition's drawing `p` of the way through it. A morph's own is `morphFrame`'s. */
+export declare function transitionAt(t: ResolvedTransition, p: number): TransitionState;
+/** A shape's frame on its way from where it was to where it stands: the morph's ease in and out. */
+export declare function morphFrame(from: Frame, to: Frame, p: number): Frame;
+/** An animation with all it leaves to its defaults said. */
+export interface ResolvedAnimation {
+    shape: string;
+    /** One paragraph of its text, not the whole shape. */
+    paragraph?: number;
+    effect: AnimationEffect;
+    direction: AnimationDirection;
+    start: AnimationStart;
+    duration: number;
+    delay: number;
+    /** A motion path's steps, in EMU from where the shape stands. */
+    path?: PathStep[];
+}
+/** An animation on its slide's clock. */
+export interface TimedAnimation extends ResolvedAnimation {
+    /** The step it plays in: 0 before the first click. */
+    step: number;
+    from: number;
+    to: number;
+}
+export interface SlideClock {
+    timed: TimedAnimation[];
+    /** Each step's still, seconds into the slide: step 0 first, the last the slide's. */
+    rests: number[];
+}
+/** An animation as slides.yaml has it, with its defaults; undefined for a path that does not read. */
+export declare function resolveAnimation(a: AnimationFile): ResolvedAnimation | undefined;
+/**
+ * A slide's clock. `settle` is how long what moves by its own code takes:
+ * a step that brings on one of `moving` (a component) rests no sooner than
+ * that after it comes on, and a slide with nothing animated rests at it.
+ * A click's animations start `frame` after the last rest, so a still never
+ * shows what the next click brings. `lead` is the transition's: what is
+ * on the slide starts when it is over.
+ */
+export declare function slideClock(animations: readonly ResolvedAnimation[], moving: readonly string[], settle: number, frame?: number, lead?: number): SlideClock;
+/** A slide's window on the stage's clock when nothing on it is animated, seconds: what moves in its components has settled by then. */
+export declare const SLIDE_SECONDS = 4;
+/** The stage's frame rate for a deck: the grid a slide's still is on. */
+export declare const DECK_FPS = 30;
+/** A slide's clock as the stage and the exports go by: on the frame grid, the first slide with no transition. */
+export declare function clockOf(slide: {
+    animations: readonly ResolvedAnimation[];
+    shapes: readonly {
+        name: string;
+        component?: unknown;
+    }[];
+    transition?: ResolvedTransition;
+}, first: boolean): SlideClock & {
+    lead: number;
+    comesOn: (shape: string) => number;
+    goesOff: (shape: string) => number | undefined;
+};
+/** How a shape, or a paragraph of one, is drawn at a moment. */
+export interface DrawnState {
+    hidden: boolean;
+    opacity: number;
+    /** Moved by, in EMU. */
+    x: number;
+    y: number;
+    scale: number;
+    /** What is cut from each side, a share of its size. */
+    clip?: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+}
+/** Where a path has got to, a share `p` of its length along it. */
+export declare function pathPoint(steps: readonly PathStep[], p: number): {
+    x: number;
+    y: number;
+};
+/**
+ * How what these animations are on is drawn at a moment, each `animations`
+ * being one target's, in order. What comes on by an entrance is not drawn
+ * before it.
+ */
+export declare function drawnAt(animations: readonly TimedAnimation[], t: number, f: Frame, slide: {
+    width: number;
+    height: number;
+}): DrawnState;
+/** Each thing a slide animates: a shape, or a paragraph of one, with its animations in order. */
+export declare function animationTargets(timed: readonly TimedAnimation[]): {
+    shape: string;
+    paragraph?: number;
+    animations: TimedAnimation[];
+}[];
+//# sourceMappingURL=animation.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{pathSteps as g}from"./path.js";import{EMU_PER_PT as h}from"./units.js";export const ANIMATION_DURATIONS={appear:0,fade:.5,wipe:.5,"fly-in":.5,zoom:.5,disappear:0,"fade-out":.5,"wipe-out":.5,"fly-out":.5,"zoom-out":.5,pulse:.5,path:2};const S=new Set(["disappear","fade-out","wipe-out","fly-out","zoom-out"]),M=new Set(["appear","fade","wipe","fly-in","zoom"]);export const isExit=t=>S.has(t),isEntrance=t=>M.has(t),TRANSITION_DURATIONS={fade:.7,push:1,wipe:1,morph:2},resolveTransition=t=>({type:t.type,direction:t.direction??"from-right",duration:t.duration??TRANSITION_DURATIONS[t.type]});const w={"from-left":{x:-1,y:0},"from-right":{x:1,y:0},"from-top":{x:0,y:-1},"from-bottom":{x:0,y:1}};export function transitionAt(t,o){const e={opacity:1,x:0,y:0};if(t.type==="fade")return{incoming:{...e,opacity:o},outgoing:{x:0,y:0}};if(t.type==="push"){const n=w[t.direction];return{incoming:{...e,x:n.x*(1-o),y:n.y*(1-o)},outgoing:{x:-n.x*o,y:-n.y*o}}}return t.type==="wipe"?{incoming:{...e,clip:d(t.direction,1-o)},outgoing:{x:0,y:0}}:{incoming:e,outgoing:{x:0,y:0}}}export function morphFrame(t,o,e){const n=e*e*(3-2*e),i=(p,f)=>p+(f-p)*n;return{left:i(t.left,o.left),top:i(t.top,o.top),width:i(t.width,o.width),height:i(t.height,o.height)}}export function resolveAnimation(t){const o=t.path===void 0?void 0:g(t.path);if(!(t.path!==void 0&&!o)&&!(t.effect==="path"&&!o))return{shape:t.shape,...t.paragraph===void 0?{}:{paragraph:t.paragraph},effect:t.effect,direction:t.direction??"from-bottom",start:t.start??"on-click",duration:t.duration??ANIMATION_DURATIONS[t.effect],delay:t.delay??0,...o?{path:o.map(e=>e.op==="close"?e:e.op!=="curve"?{...e,x:e.x*h,y:e.y*h}:{op:"curve",x1:e.x1*h,y1:e.y1*h,x2:e.x2*h,y2:e.y2*h,x:e.x*h,y:e.y*h})}:{}}}export function slideClock(t,o,e,n=0,i=0){const p=new Set(t.filter(s=>isEntrance(s.effect)).map(s=>s.shape));let f=i+(o.some(s=>!p.has(s))?e:0);if(t.length===0)return{timed:[],rests:[Math.max(e,i)]};const r=[],c=[];let a=0,u=i;for(const s of t){s.start==="on-click"?(r.push(f),a++,f+=n,u=f):s.start==="after-previous"&&(u=f);const y=u+s.delay,l=y+s.duration;c.push({...s,step:a,from:y,to:l}),f=Math.max(f,l),o.includes(s.shape)&&isEntrance(s.effect)&&(f=Math.max(f,y+e))}return r.push(f),{timed:c,rests:r}}export const SLIDE_SECONDS=4,DECK_FPS=30;const E=t=>Math.ceil(t*DECK_FPS-1e-6)/DECK_FPS;export function clockOf(t,o){const e=o?0:t.transition?.duration??0,n=slideClock(t.animations,t.shapes.flatMap(i=>i.component?[i.name]:[]),SLIDE_SECONDS-1/DECK_FPS,1/DECK_FPS,e);return{timed:n.timed,rests:n.rests.map(E),lead:e,comesOn:i=>n.timed.find(p=>p.shape===i&&isEntrance(p.effect))?.from??e,goesOff:i=>n.timed.find(p=>p.shape===i&&isExit(p.effect))?.to}}const T=1e-6,x={hidden:!1,opacity:1,x:0,y:0,scale:1},N=t=>1-(1-t)*(1-t);function A(t){const o=[];let e={x:0,y:0};for(const n of t){if(n.op==="close")continue;if(n.op!=="curve"){e={x:n.x,y:n.y},o.push(e);continue}const i=e;for(let p=1;p<=24;p++){const f=p/24,r=1-f,c=(a,u,s,y)=>r*r*r*a+3*r*r*f*u+3*r*f*f*s+f*f*f*y;o.push({x:c(i.x,n.x1,n.x2,n.x),y:c(i.y,n.y1,n.y2,n.y)})}e={x:n.x,y:n.y}}return o}export function pathPoint(t,o){const e=A(t),[n]=e;if(!n)return{x:0,y:0};let i=0;for(let f=1;f<e.length;f++){const[r,c]=[e[f-1]??n,e[f]??n];i+=Math.hypot(c.x-r.x,c.y-r.y)}let p=i*o;for(let f=1;f<e.length;f++){const[r,c]=[e[f-1]??n,e[f]??n],a=Math.hypot(c.x-r.x,c.y-r.y);if(p<=a&&a>0){const u=p/a;return{x:r.x+(c.x-r.x)*u,y:r.y+(c.y-r.y)*u}}p-=a}return e.at(-1)??n}function I(t,o,e){return t==="from-left"?{x:-(o.left+o.width),y:0}:t==="from-right"?{x:e.width-o.left,y:0}:t==="from-top"?{x:0,y:-(o.top+o.height)}:{x:0,y:e.height-o.top}}function d(t,o){const e={top:0,right:0,bottom:0,left:0};return t==="from-left"?e.right=o:t==="from-right"?e.left=o:t==="from-top"?e.bottom=o:e.top=o,e}function m(t,o,e,n){if(t.effect==="fade"||t.effect==="fade-out")return{opacity:o};if(t.effect==="zoom"||t.effect==="zoom-out")return{scale:o,opacity:o};if(t.effect==="wipe"||t.effect==="wipe-out")return{clip:d(t.direction,1-o)};if(t.effect==="fly-in"||t.effect==="fly-out"){const i=I(t.direction,e,n);return{x:i.x*(1-o),y:i.y*(1-o)}}return{}}export function drawnAt(t,o,e,n){let i={...x};const[p]=t,f=r=>o<r-T;if(p&&isEntrance(p.effect)&&f(p.from))return{...x,hidden:!0};for(const r of t){if(f(r.from))break;const c=r.to>r.from?Math.min(1,(o-r.from)/(r.to-r.from)):1;if(r.effect==="path"&&r.path){const a=pathPoint(r.path,c);i={...i,x:a.x,y:a.y}}else r.effect==="pulse"?i={...i,scale:1+.05*Math.sin(c*Math.PI)}:isExit(r.effect)?i=c>=1?{...x,hidden:!0}:{...i,...m(r,1-(r.effect==="fly-out"?c*c:c),e,n)}:i={...x,...c<1?m(r,r.effect==="fly-in"?N(c):c,e,n):{}}}return i}export function animationTargets(t){const o=new Map;for(const e of t){const n=JSON.stringify([e.shape,e.paragraph??null]),i=o.get(n);i?i.animations.push(e):o.set(n,{shape:e.shape,...e.paragraph===void 0?{}:{paragraph:e.paragraph},animations:[e]})}return[...o.values()]}