@allyhub/sdk 0.0.0-stage → 0.1.0-alpha.6

package/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/NOTICE

@@ -0,0 +1,81 @@
+AllyHub
+Copyright (c) 2026 AllyHub, Inc. All rights reserved.
+
+This product is proprietary; see LICENSE.
+
+Parts of the rendering code (frame capture with BeginFrame, worker sizing,
+frame extraction and the ffmpeg arguments) and of the speech recognition
+(the pinned Parakeet model and sherpa-onnx runtime installed on first use,
+decoding in windows cut at silences and merging tokens into words) are
+adapted from HyperFrames (https://github.com/heygen-com/hyperframes),
+Copyright 2026 HeyGen, Inc., licensed under the Apache License, Version 2.0.
+Each adapted file says so in its header.
+
+The talking-head tools adapt logic from FilmCraft
+(https://github.com/storytold/filmcraft), dual-licensed under the MIT
+License or the Apache License, Version 2.0, and used here under the MIT
+License: reading a take by word index and tightening word bounds to the
+sound's level (crates/engine/src/transcript.rs, crates/speech/src/vad.rs),
+placing cuts in the silence beside the words, and measuring the offset
+between two recordings from their sound by generalised cross-correlation
+(GCC-PHAT, coarse then refined; crates/audio-dsp/src/sync.rs). Each adapted
+file says so in its header.
+
+  Copyright (c) 2026 ArtCraft Team and the FilmCraft contributors
+
+  Permission is hereby granted, free of charge, to any person obtaining a
+  copy of this software and associated documentation files (the
+  "Software"), to deal in the Software without restriction, including
+  without limitation the rights to use, copy, modify, merge, publish,
+  distribute, sublicense, and/or sell copies of the Software, and to permit
+  persons to whom the Software is furnished to do so, subject to the
+  following conditions:
+
+  The above copyright notice and this permission notice shall be included
+  in all copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+  OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
+  NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+  DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+  OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+  USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+The SDK's motion and layout helpers are after three of Remotion's packages
+(https://github.com/remotion-dev/remotion), each published under the MIT
+License, written again in AllyHub's own code: fitting a text to n lines by
+a binary search on its font size (@remotion/layout-utils,
+fit-text-on-n-lines.ts and fill-text-box.ts; packages/sdk/src/fit.ts and
+fitLines in dom.ts), seeded simplex noise with a seed and coordinates
+(@remotion/noise; packages/sdk/src/noise.ts) and measuring, drawing on and
+interpolating SVG paths (@remotion/paths: getLength, getPointAtLength,
+getTangentAtLength, evolvePath, interpolatePath; packages/sdk/src/paths.ts).
+Each file says so in its header. @remotion/noise wraps simplex-noise
+(https://github.com/jwagner/simplex-noise.js, Copyright (c) 2022 Jonas
+Wagner, MIT License); the noise here, like it, follows Stefan Gustavson's
+public-domain simplex noise reference ("Simplex noise demystified", 2005).
+
+  Copyright (c) 2023 JonnyBurger
+
+  Permission is hereby granted, free of charge, to any person obtaining a
+  copy of this software and associated documentation files (the
+  "Software"), to deal in the Software without restriction, including
+  without limitation the rights to use, copy, modify, merge, publish,
+  distribute, sublicense, and/or sell copies of the Software, and to permit
+  persons to whom the Software is furnished to do so, subject to the
+  following conditions:
+
+  The above copyright notice and this permission notice shall be included
+  in all copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+  OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
+  NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+  DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+  OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+  USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+The Apache License, Version 2.0 is reproduced at the end of LICENSE; those
+parts remain under it.

package/README.md

@@ -1,3 +1,17 @@
-# Temporary Holding Version
+# @allyhub/sdk
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The SDK that AllyHub videos and decks are written with: `definePiece`, the `video` and `paged` outputs, parts with their speech, footage and sounds, `defineComponent`, and the layout and motion helpers.
+
+This package is part of [AllyHub](https://allyhub.com): product demo videos from a few sentences, made by your coding agent. You do not install it yourself. The `allyhub` command brings it, and a project folder needs no `package.json`.
+
+To use AllyHub, add the skill to your agent:
+
+```bash
+npx skills add allyhub-ai/skills
+```
+
+The API reference is the AllyHub skill's `references/`, a file per topic; the skill's `SKILL.md` says which to read for a job.
+
+## License
+
+Proprietary: you may install and use it as set out in `LICENSE`. Code adapted from other projects is listed in `NOTICE`. "AllyHub" is a trademark of AllyHub, Inc.

package/client.d.ts

@@ -0,0 +1,86 @@
+// Types of the imports AllyHub's build understands. Add "@allyhub/sdk/client" to `types` in tsconfig.json.
+
+type AllyHubMedia = import("@allyhub/engine/stage").MediaInfo;
+type AllyHubRow = Record<string, string | number>;
+
+declare module "*.png" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.jpg" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.jpeg" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.webp" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.gif" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.svg" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.avif" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.mp3" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.wav" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.m4a" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.ogg" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.aac" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.flac" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.mp4" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.webm" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.mov" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.woff2" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.csv" {
+  /** One object per row, keyed by the header; numeric columns are numbers. */
+  const rows: AllyHubRow[];
+  export default rows;
+}
+declare module "*.yaml" {
+  const data: unknown;
+  export default data;
+}
+declare module "*.yml" {
+  const data: unknown;
+  export default data;
+}

package/dist/anim.d.ts

@@ -0,0 +1,41 @@
+export type Ease = (x: number) => number;
+export declare const clamp: (x: number, lo?: number, hi?: number) => number;
+export declare const lerp: (a: number, b: number, x: number) => number;
+/** Progress of t through [start, start + dur], clamped to 0–1. */
+export declare const progress: (t: number, start: number, dur: number) => number;
+export declare const ease: {
+    linear: Ease;
+    in: Ease;
+    out: Ease;
+    inOut: Ease;
+    outExpo: Ease;
+    outBack: Ease;
+    /** A damped spring that settles at 1. */
+    spring(damping?: number, frequency?: number): Ease;
+};
+export interface TweenOptions {
+    from?: number;
+    to?: number;
+    start?: number;
+    dur?: number;
+    ease?: Ease;
+}
+/** The value at time t of a tween from `from` to `to`. */
+export declare function tween(t: number, opts?: TweenOptions): number;
+/** The delay of the i-th element of a staggered group. */
+export declare const stagger: (i: number, gap: number) => number;
+/** A deterministic random number generator: the same seed, the same numbers. */
+export declare function rand(seed: string | number): () => number;
+export interface FitTextOptions {
+    /** Smallest font size in px. */
+    min: number;
+    /** Largest font size in px. */
+    max: number;
+}
+/**
+ * Sets the largest font size in [min, max] at which the element's text fits
+ * its own box (no overflow). The element needs a definite width (and height,
+ * to limit lines). Returns the size chosen.
+ */
+export declare function fitText(el: HTMLElement, opts: FitTextOptions): number;
+//# sourceMappingURL=anim.d.ts.map

package/dist/anim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anim.d.ts","sourceRoot":"","sources":["../src/anim.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;AAEzC,eAAO,MAAM,KAAK,GAAI,GAAG,MAAM,EAAE,WAAM,EAAE,WAAM,KAAG,MACnB,CAAC;AAEhC,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,KAAG,MACtC,CAAC;AAElB,kEAAkE;AAClE,eAAO,MAAM,QAAQ,GAAI,GAAG,MAAM,EAAE,OAAO,MAAM,EAAE,KAAK,MAAM,KAAG,MACL,CAAC;AAE7D,eAAO,MAAM,IAAI;YACO,IAAI;QACA,IAAI;SACU,IAAI;WAEoB,IAAI;aACP,IAAI;aAK3D,IAAI;IACV,yCAAyC;kDACH,IAAI;CAO3C,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAED,0DAA0D;AAC1D,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,MAAM,CAGhE;AAED,0DAA0D;AAC1D,eAAO,MAAM,OAAO,GAAI,GAAG,MAAM,EAAE,KAAK,MAAM,KAAG,MAAiB,CAAC;AAYnE,gFAAgF;AAChF,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,MAAM,CAQxD;AAED,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,CAgBrE"}

package/dist/anim.js

@@ -0,0 +1,75 @@
+// Animation helpers. All are pure functions of time (the skill's references/core.md, "Animation helpers").
+export const clamp = (x, lo = 0, hi = 1) => Math.min(hi, Math.max(lo, x));
+export const lerp = (a, b, x) => a + (b - a) * x;
+/** Progress of t through [start, start + dur], clamped to 0–1. */
+export const progress = (t, start, dur) => dur <= 0 ? (t >= start ? 1 : 0) : clamp((t - start) / dur);
+export const ease = {
+    linear: ((x) => x),
+    in: ((x) => x * x * x),
+    out: ((x) => 1 - Math.pow(1 - x, 3)),
+    inOut: ((x) => x < 0.5 ? 4 * x * x * x : 1 - Math.pow(-2 * x + 2, 3) / 2),
+    outExpo: ((x) => (x >= 1 ? 1 : 1 - Math.pow(2, -10 * x))),
+    outBack: ((x) => {
+        const c1 = 1.7;
+        const c3 = c1 + 1;
+        return 1 + c3 * Math.pow(x - 1, 3) + c1 * Math.pow(x - 1, 2);
+    }),
+    /** A damped spring that settles at 1. */
+    spring(damping = 7, frequency = 3.2) {
+        return (x) => x >= 1
+            ? 1
+            : 1 -
+                Math.exp(-damping * x) * Math.cos(frequency * Math.PI * 2 * x * 0.5);
+    },
+};
+/** The value at time t of a tween from `from` to `to`. */
+export function tween(t, opts = {}) {
+    const { from = 0, to = 1, start = 0, dur = 0.5, ease: e = ease.out } = opts;
+    return lerp(from, to, e(progress(t, start, dur)));
+}
+/** The delay of the i-th element of a staggered group. */
+export const stagger = (i, gap) => i * gap;
+function hashSeed(seed) {
+    const s = String(seed);
+    let h = 2166136261;
+    for (let i = 0; i < s.length; i++) {
+        h ^= s.charCodeAt(i);
+        h = Math.imul(h, 16777619);
+    }
+    return h >>> 0;
+}
+/** A deterministic random number generator: the same seed, the same numbers. */
+export function rand(seed) {
+    let a = hashSeed(seed);
+    return () => {
+        a = (a + 0x6d2b79f5) | 0;
+        let t = Math.imul(a ^ (a >>> 15), 1 | a);
+        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+/**
+ * Sets the largest font size in [min, max] at which the element's text fits
+ * its own box (no overflow). The element needs a definite width (and height,
+ * to limit lines). Returns the size chosen.
+ */
+export function fitText(el, opts) {
+    const fits = () => el.scrollWidth <= el.clientWidth + 1 &&
+        el.scrollHeight <= el.clientHeight + 1;
+    let lo = opts.min;
+    let hi = opts.max;
+    el.style.fontSize = `${hi}px`;
+    if (fits())
+        return hi;
+    while (hi - lo > 0.5) {
+        const mid = (lo + hi) / 2;
+        el.style.fontSize = `${mid}px`;
+        if (fits())
+            lo = mid;
+        else
+            hi = mid;
+    }
+    el.style.fontSize = `${lo}px`;
+    return lo;
+}
+//# sourceMappingURL=anim.js.map

package/dist/anim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anim.js","sourceRoot":"","sources":["../src/anim.ts"],"names":[],"mappings":"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"}

package/dist/define.d.ts

@@ -0,0 +1,75 @@
+import { type GraphicLayer, type LayerTiming, type StageContext, type TimeShape } from "@allyhub/engine/stage";
+import type { PropSchema, Timed } from "./props.js";
+export type { StageContext } from "@allyhub/engine/stage";
+/** What every graphic layer takes besides a component's own props. */
+export interface LayerOptions extends LayerTiming {
+    /**
+     * "front" (default): at its place in the part's layers, over those
+     * listed before it. "behind-person": right over the part's own footage
+     * and under its speaker, cut out with the take's person matte.
+     */
+    z?: "front" | "behind-person";
+}
+/** Text for people: one string, or by language. */
+export type Label = string | Record<string, string>;
+/** A component's description, as plain data (it goes into the project's metadata). */
+export interface ComponentInfo {
+    name: string;
+    label: Label;
+    summary?: Label;
+    /** Semantic types of the props: editors and checks use them. */
+    props: Record<string, PropSchema>;
+    /** Named example props; the platform renders previews from them. */
+    examples: Record<string, Record<string, unknown>>;
+    /** Deprecated components are hidden, not deleted. */
+    hidden: boolean;
+}
+export interface ComponentDefinition<P extends object> {
+    name: string;
+    /** A name for people; default: `name`. */
+    label?: Label;
+    /** One line on what it is for. */
+    summary?: Label;
+    /**
+     * The props' semantic types: text(), time(), asset()… (pure data). A
+     * prop declared time() may be given as a word reference; the component
+     * receives seconds from the part's start.
+     */
+    props?: {
+        [K in keyof P]?: PropSchema;
+    };
+    /** Named example props, e.g. { default: { … } }. */
+    examples?: Record<string, Partial<Timed<P>>>;
+    hidden?: boolean;
+    /** Default values of props. */
+    defaults?: Partial<Timed<P>>;
+    /**
+     * Lays the layer out once: builds its elements, measures text. `ctx.dur`
+     * is the part's length, `ctx.layer` the layer's window in it.
+     */
+    mount(el: HTMLElement, props: P, ctx: StageContext): void;
+    /** Sets everything that moves from `t` alone: seconds from the part's start. */
+    render(el: HTMLElement, t: number, props: P, ctx: StageContext): void;
+}
+/** A component: a function that makes a graphic layer from its props and the layer options. */
+export type Component<P extends object> = ((opts: LayerOptions & Timed<P>) => GraphicLayer<P>) & {
+    componentName: string;
+    info: ComponentInfo;
+};
+/**
+ * Layer options share one object with a component's props, so these names
+ * are reserved: a component cannot have props called this.
+ */
+export declare const LAYER_OPTIONS: readonly string[];
+/** Where props hold times, from their schema; undefined when none do. */
+export declare function timeShape(props: Readonly<Record<string, PropSchema | undefined>>): TimeShape | undefined;
+/** Makes a component: a function that returns a graphic layer. */
+export declare function defineComponent<P extends object>(def: ComponentDefinition<P>): Component<P>;
+export interface CustomOptions extends LayerOptions {
+    mount?(el: HTMLElement, ctx: StageContext): void;
+    /** Sets everything that moves from `t` alone: seconds from the part's start. */
+    render(el: HTMLElement, t: number, ctx: StageContext): void;
+}
+/** A graphic layer written directly in the output, for what no component does. */
+export declare function custom(opts: CustomOptions): GraphicLayer;
+//# sourceMappingURL=define.d.ts.map

package/dist/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"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"}