allyhub 0.6.0 → 0.7.0

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

@@ -1,11 +0,0 @@
-export { CheckSession, runtimeDigest, type SessionOptions } from "./session.js";
-export { LoadedVersion, StuckError, type Target, type VersionPage, } from "./page.js";
-export { baseDigest, outputDigest } from "./digest.js";
-export { ConsolePool, consoleJson, consoleOf, mergeConsole, type ConsoleFields, } from "./console.js";
-export { ProblemPool, byLevel, dedupe, type ProblemFields } from "./ledger.js";
-export { OpenedVersion, ProjectError, extraCombos, filmTimes, lookOf, parseCombo, partOf, pickTarget, projectMedia, soundOf, versionLabel, type Moment, type OpenVersionOptions, } from "./version.js";
-export { generatedReads, momentsIn, stretchOf, type GeneratedRead, type Stretch, type StretchAsk, } from "./stretch.js";
-export { indexNeeds, makeIndex, needText, type IndexProgress, } from "./media-index.js";
-export { projectSays, type FoundSay } from "./says.js";
-export { findScenery, piecesDrawing, sceneryTimesFromVideo, type VideoSceneryTimes, } from "./scenery.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/node_modules/@allyhub-next/project/dist/ledger.d.ts

@@ -1,17 +0,0 @@
-import { type Problem } from "@allyhub-next/video-core";
-/** Each problem once: the same code and message at the same place. */
-export declare function dedupe(problems: readonly Problem[]): Problem[];
-/** The problems of the pages closed so far, each once. */
-export declare class ProblemPool {
-    private list;
-    add(problems: readonly Problem[]): void;
-    /** Every problem added since the last take, errors first. */
-    take(): Problem[];
-}
-/** Errors before warnings, each kind in the order found. */
-export declare const byLevel: (a: Problem, b: Problem) => number;
-/** What a command's JSON carries: the problems its pages had. */
-export interface ProblemFields {
-    problems: Problem[];
-}
-//# sourceMappingURL=ledger.d.ts.map

package/dist/node_modules/@allyhub-next/project/dist/media-index.d.ts

@@ -1,27 +0,0 @@
-import type { IndexNeed, Timeline } from "@allyhub-next/video-core";
-/** What the timelines say the media index lacks, one entry per video. */
-export declare function indexNeeds(results: readonly {
-    timeline?: Timeline | undefined;
-}[]): IndexNeed[];
-/** "the face track and the person matte of talk/host.mp4". */
-export declare function needText(n: IndexNeed): string;
-/** Where indexing is: a line for each step, and the share done. */
-export interface IndexProgress {
-    status: "running" | "done" | "failed";
-    file: string;
-    message: string;
-    /** 0 to 1, when known. */
-    share?: number;
-}
-/**
- * Makes what is missing, one video at a time. Never throws: each video
- * ends done or failed (with why), through `onProgress`.
- */
-export declare function makeIndex(root: string, needs: readonly IndexNeed[], onProgress?: (p: IndexProgress) => void, signal?: AbortSignal): Promise<{
-    done: IndexNeed[];
-    failed: {
-        need: IndexNeed;
-        error: string;
-    }[];
-}>;
-//# sourceMappingURL=media-index.d.ts.map

package/dist/node_modules/@allyhub-next/project/dist/page.d.ts

@@ -1,119 +0,0 @@
-import type { LoadedSummary } from "@allyhub-next/runtime/bridge";
-import type { SourcePlace } from "@allyhub-next/build";
-import { type StagePage } from "@allyhub-next/stage";
-import { type Box, type Combo, type ConsoleLog, type LayerAnswer, type LayerQueries, type LayoutReport, type Problem, type TextInk, type Timeline, type Track } from "@allyhub-next/video-core";
-/** One version: what to load. */
-export interface Target {
-    piece: string;
-    /** Its output, named by its kind: `video` or `slides`. */
-    output: string;
-    combo: Combo;
-    /** The piece's one format. */
-    format: string;
-    /** The combo's id (c01), when the piece has slots and chose it. */
-    id?: string;
-}
-/**
- * A moment that never finished drawing: AK-P003, which ends the passes on
- * its page. `kept`: the page said so and keeps it among its problems; else
- * the page never answered.
- */
-export declare class StuckError extends Error {
-    readonly code = "AK-P003";
-    readonly kept: boolean;
-    constructor(message: string, kept: boolean);
-}
-/** What the passes ask of a loaded version; a test may give its own. */
-export interface VersionPage {
-    readonly target: Target;
-    readonly timeline: Timeline;
-    /** Draws film time t, `part` alone when given; a moment that did not finish drawing throws StuckError. */
-    seek(t: number, part?: string): Promise<void>;
-    /** What moment t shows, as a string two equal moments share (drawn for its layout alone). */
-    sign(t: number): Promise<string | undefined>;
-    /** A PNG of the whole frame at t. */
-    shot(t: number): Promise<Buffer>;
-    /** A small PNG of the frame at t, about `width` px wide. */
-    thumb(t: number, width: number): Promise<Buffer>;
-    /**
-     * A PNG of `region` of the frame at t (frame px) at `scale`, `part`
-     * drawn alone, and where its pixel (0, 0) is in the frame and how many
-     * frame px one of its px is.
-     */
-    region(t: number, part: string | undefined, region: Box, scale: number): Promise<{
-        png: Buffer;
-        x: number;
-        y: number;
-        scale: number;
-    }>;
-    /** A PNG of `box` of the page as it is now (viewport px), nothing drawn first, and where its pixel (0, 0) is. */
-    grab(box: Box): Promise<{
-        png: Buffer;
-        x: number;
-        y: number;
-    }>;
-    /** Hides every text's fill (and with `outlines` its stroke and shadow), or shows them again. */
-    hideText(on: boolean, outlines?: boolean): Promise<void>;
-    measure(times?: readonly number[]): Promise<LayoutReport>;
-    tracks(from: number, to: number): Promise<Track[]>;
-    inks(t: number): Promise<TextInk[]>;
-    ask<K extends keyof LayerQueries>(name: K, args: LayerQueries[K]["args"]): Promise<LayerAnswer<LayerQueries[K]["answer"]>[]>;
-}
-/** A version loaded in a stage page; `summary` is undefined when it did not load. */
-export declare class LoadedVersion implements VersionPage {
-    readonly target: Target;
-    readonly stage: StagePage;
-    readonly summary: LoadedSummary | undefined;
-    /** Why it did not load, as problems. */
-    private readonly failed;
-    /** The page stopped answering: nothing more is asked of it. */
-    private hung;
-    private constructor();
-    /**
-     * Loads a version in a stage page opened for it; a piece that cannot load
-     * at all is kept as its problem (its file's `where`), the page left open
-     * for its console.
-     */
-    static load(stage: StagePage, target: Target, load: () => Promise<LoadedSummary>, file: string, 
-    /** The project file and line a stack names, through the bundles' source maps. */
-    placeOf?: (stack: string) => Promise<SourcePlace | undefined>): Promise<LoadedVersion>;
-    get timeline(): Timeline;
-    /** The longest a moment may wait, ms, before the page is taken to run forever. */
-    private get backstop();
-    /**
-     * A moment the page never answers for (a layer's render in a loop that
-     * never ends: the page's own deadline cannot run) is AK-P003, well after
-     * the page's own deadline would have been.
-     */
-    private answered;
-    seek(t: number, part?: string): Promise<void>;
-    sign(t: number): Promise<string | undefined>;
-    shot(t: number): Promise<Buffer>;
-    thumb(t: number, width: number): Promise<Buffer>;
-    region(t: number, part: string | undefined, box: Box, scale: number): Promise<{
-        png: Buffer;
-        x: number;
-        y: number;
-        scale: number;
-    }>;
-    grab(box: Box): Promise<{
-        png: Buffer;
-        x: number;
-        y: number;
-    }>;
-    hideText(on: boolean, outlines?: boolean): Promise<void>;
-    measure(times?: readonly number[]): Promise<LayoutReport>;
-    tracks(from: number, to: number): Promise<Track[]>;
-    inks(t: number): Promise<TextInk[]>;
-    ask<K extends keyof LayerQueries>(name: K, args: LayerQueries[K]["args"]): Promise<LayerAnswer<LayerQueries[K]["answer"]>[]>;
-    /**
-     * Every problem of the page, each once: why it did not load, what
-     * loading and every moment drawn since found, the requests the server
-     * did not allow (AK-N003) and what the page threw and did not catch.
-     */
-    problems(): Promise<Problem[]>;
-    /** What piece code printed on this page. */
-    console(): Promise<ConsoleLog>;
-    close(): Promise<void>;
-}
-//# sourceMappingURL=page.d.ts.map

package/dist/node_modules/@allyhub-next/project/dist/says.d.ts

@@ -1,15 +0,0 @@
-import type { SayNeed } from "@allyhub-next/runtime/bridge";
-/** A say a piece needs, with the version it was found in. */
-export interface FoundSay extends SayNeed {
-    piece: string;
-    combo: string;
-}
-export declare function projectSays(root: string, opts?: {
-    /** Only this piece (an id, a place, a path, or a folder of them). */
-    piece?: string;
-    gpu?: boolean;
-}): Promise<{
-    says: FoundSay[];
-    pieces: string[];
-}>;
-//# sourceMappingURL=says.d.ts.map

package/dist/node_modules/@allyhub-next/project/dist/scenery.d.ts

@@ -1,35 +0,0 @@
-import type { Browser } from "@allyhub-next/browser";
-import { type Prepared } from "@allyhub-next/build";
-import { type Item } from "@allyhub-next/formats";
-/**
- * The scenery item a name means: its folder from the project (`room`), its
- * folder, or a path into it from `cwd`. Not found, a ProjectError that
- * lists the project's sceneries.
- */
-export declare function findScenery(root: string, cwd: string, name: string): Promise<Item & {
-    place: string;
-}>;
-/** The video pieces whose stage bundle holds a module of the project (its path from the root): those that draw it. */
-export declare function piecesDrawing(prepared: Prepared, file: string): string[];
-/** The scenery times a video's scenery layers give the references of its parts. */
-export interface VideoSceneryTimes {
-    /** The video they come from. */
-    piece: string;
-    /** Scenery seconds of each anchor reference (`@name`, `@/name` for a stretch's end). */
-    times: Record<string, number>;
-}
-/**
- * The scenery time of every anchor of a video's parts, as the scenery
- * layers that draw this scenery module find them (the layer's own lookup,
- * the one its moves and its update use): `piece`'s, else the one video of
- * the project that draws it. None, several, or layers that draw a
- * reference at different times is a ProjectError that says what to do.
- */
-export declare function sceneryTimesFromVideo(o: {
-    root: string;
-    /** The scenery module, its path from the project's root. */
-    file: string;
-    piece?: string;
-    browser?: Browser;
-}): Promise<VideoSceneryTimes>;
-//# sourceMappingURL=scenery.d.ts.map

package/dist/node_modules/@allyhub-next/project/dist/session.d.ts

@@ -1,37 +0,0 @@
-import { type Browser } from "@allyhub-next/browser";
-import { type PieceInfo, type Prepared } from "@allyhub-next/build";
-import { type LoadOptions } from "@allyhub-next/video-core";
-import { LoadedVersion, type Target } from "./page.js";
-export interface SessionOptions {
-    /** The project's folder. */
-    root: string;
-    /** The build folder; default <root>/.allyhub/cache/build/check-<pid>, removed when the session closes. */
-    buildDir?: string;
-    /** Draw on the GPU (a browser the session starts); default the platform's. */
-    gpu?: boolean;
-    /** The most different console messages kept from piece code per version; default CONSOLE_LIMIT. */
-    consoleLimit?: number;
-    /** A browser already started, which the session does not close. */
-    browser?: Browser;
-}
-/** sha256 of the runtime bundle the stage loads. */
-export declare function runtimeDigest(): Promise<string>;
-export declare class CheckSession {
-    readonly prepared: Prepared;
-    readonly browser: Browser;
-    readonly consoleLimit: number;
-    private readonly server;
-    private readonly owned;
-    /** Where in the project a stack's frames are, through the bundles' source maps. */
-    private readonly places;
-    private constructor();
-    static open(o: SessionOptions): Promise<CheckSession>;
-    /** Whether the browser draws on the GPU. */
-    get gpu(): boolean;
-    /** The local file of a project path, when the build found it. */
-    mediaPath(path: string): string | undefined;
-    /** Loads one version of a piece in a page of its own. */
-    open(piece: PieceInfo, target: Target, purpose?: LoadOptions["purpose"]): Promise<LoadedVersion>;
-    close(): Promise<void>;
-}
-//# sourceMappingURL=session.d.ts.map

package/dist/node_modules/@allyhub-next/project/dist/stretch.d.ts

@@ -1,38 +0,0 @@
-import type { MediaInfo, Part, Timeline } from "@allyhub-next/video-core";
-import type { Target } from "./page.js";
-import { type Moment, type OpenedVersion } from "./version.js";
-/** The stretch asked for: a part's, or from one second to another, else the whole version. */
-export interface StretchAsk {
-    part?: string | undefined;
-    from?: number | undefined;
-    to?: number | undefined;
-}
-export interface Stretch {
-    from: number;
-    to: number;
-    /** The last frame's moment: a part's end is the next part's first frame. */
-    last: number;
-    /** The part asked for. */
-    part?: Part;
-}
-/** The stretch an ask means in a timeline; a part it does not have is a ProjectError that lists them. */
-export declare function stretchOf(tl: Timeline, o: StretchAsk): Stretch;
-/**
- * Moments in film seconds: `every` this many seconds through the stretch,
- * or the moments `at` (seconds from the part's start when a part is asked,
- * or anchors); undefined when neither is asked. A moment outside the
- * version is a ProjectError.
- */
-export declare function momentsIn(tl: Timeline, o: StretchAsk & {
-    at?: readonly Moment[] | undefined;
-    every?: number;
-}, target?: Target): number[] | undefined;
-/** A file with a record saying a model made it, and the parts that read it. */
-export interface GeneratedRead {
-    file: string;
-    parts: string[];
-    gen: NonNullable<MediaInfo["gen"]>;
-}
-/** The media a loaded version read whose `.gen.json` says a model made it. */
-export declare function generatedReads(v: OpenedVersion): GeneratedRead[];
-//# sourceMappingURL=stretch.d.ts.map

package/dist/node_modules/@allyhub-next/project/dist/version.d.ts

@@ -1,114 +0,0 @@
-import type { Browser } from "@allyhub-next/browser";
-import type { PieceInfo, Prepared } from "@allyhub-next/build";
-import { type ExportPage, type ProjectMedia, type SoundInput, type StillFormat, type VideoLook } from "@allyhub-next/render";
-import { type Combo, type ConsoleLog, type LoadOptions, type Part, type Problem, type Timeline } from "@allyhub-next/video-core";
-import type { LoadedVersion, Target } from "./page.js";
-import { CheckSession } from "./session.js";
-/** Why something of a project (a version, a scenery) cannot be had, with what to do: `kind` says whether the asking was wrong, nothing matched, or it failed. */
-export declare class ProjectError extends Error {
-    readonly code: string;
-    readonly hint: string | undefined;
-    readonly kind: "usage" | "not-found" | "failed";
-    constructor(code: string, message: string, kind: ProjectError["kind"], hint?: string);
-}
-/**
- * A combo filter as written: `lang=zh-cn,hook=b` (every name equal), a
- * combo's id (`c03`, `c03-en`), or `default`, which every combo matches.
- */
-export declare function parseCombo(raw: string): Combo;
-/** "launch/film · lang=en · 9x16". */
-export declare const versionLabel: (t: Target) => string;
-/**
- * The one version a name and combo filters mean: the piece the name is
- * (its id, place or a path to it; or the one piece under a folder it
- * names; or the project's only piece), and its first combo matching a
- * filter (a combo of its matrix that the batch did not choose counts too).
- */
-export declare function pickTarget(prepared: Prepared, item?: string, combos?: readonly Combo[]): {
-    piece: PieceInfo;
-    target: Target;
-};
-/** What of a piece's options changes its picture once rendered, as read in Node. */
-export declare function lookOf(piece: PieceInfo): VideoLook;
-/** The project's media as a render reads them. */
-export declare function projectMedia(prepared: Prepared): ProjectMedia;
-/**
- * A version's sound as its render muxes it: the runtime's mix plan (the
- * player's) over the media with the loudness of each file it plays
- * measured, seeded as the page seeds it.
- */
-export declare function soundOf(prepared: Prepared, target: Target, timeline: Timeline, o?: {
-    ffmpeg?: string;
-}): Promise<SoundInput>;
-/** A moment asked for: seconds, or an anchor by name ("@press", "@/map", "@press+0.2"). */
-export type Moment = number | string;
-/**
- * Moments in film seconds. Seconds count from the start of `base` when it
- * is given. An anchor is looked for in `base`, or else in every part:
- * "@name" its start, "@/name" a stretch's end, "@name+0.2" shifted.
- */
-export declare function filmTimes(at: readonly Moment[], parts: readonly Part[], base?: Part): number[];
-/** A version's part by key, or a ProjectError that lists them. */
-export declare function partOf(timeline: Timeline, key: string): Part;
-export interface OpenVersionOptions {
-    /** The project's folder. */
-    root: string;
-    /** The piece: its id, place, or a path to it; default the project's only one. */
-    item?: string;
-    /** Combo filters; the first combo matching one. */
-    combos?: readonly Combo[];
-    /** What the page draws: a check page (graphics over the look's background), a render page (the graphics plane alone, transparent) or a player's. */
-    purpose: LoadOptions["purpose"];
-    gpu?: boolean;
-    consoleLimit?: number;
-    browser?: Browser;
-    /** A session already open on the project, which closing leaves open. */
-    session?: CheckSession;
-}
-/** One version loaded in a page, with what the commands draw from it. */
-export declare class OpenedVersion {
-    readonly session: CheckSession;
-    readonly piece: PieceInfo;
-    readonly target: Target;
-    readonly version: LoadedVersion;
-    private readonly ownSession;
-    private page;
-    private constructor();
-    get prepared(): Prepared;
-    get timeline(): Timeline;
-    get look(): VideoLook;
-    get media(): ProjectMedia;
-    /** The render's view of the page: its graphics plane, its exports. */
-    graphics(): ExportPage;
-    /**
-     * One moment as the render shows it (on a render page): footage and
-     * graphics composited, motion blur, the camera's marks, post, LUT and
-     * alpha; `raw` leaves out blur, the marks, post and LUT.
-     */
-    still(t: number, o?: {
-        raw?: boolean;
-        format?: StillFormat;
-        ffmpeg?: string;
-    }): Promise<Buffer>;
-    /** Its sound as its render muxes it. */
-    sound(o?: {
-        ffmpeg?: string;
-    }): Promise<SoundInput>;
-    /** The page's problems: loading's and every moment drawn since. */
-    problems(): Promise<Problem[]>;
-    /** What piece code printed on the page. */
-    console(): Promise<ConsoleLog>;
-    close(): Promise<void>;
-    /**
-     * Opens the version a name and filters mean. A piece that does not load
-     * is a ProjectError with its first problem; nothing is left open.
-     */
-    static open(o: OpenVersionOptions): Promise<OpenedVersion>;
-}
-/**
- * Combos a filter names in full that the batch did not choose, but the
- * piece's matrix allows (one assembled in the preview's matrix view):
- * checked and rendered too, named by their key.
- */
-export declare function extraCombos(piece: PieceInfo, filters: readonly Combo[] | undefined): Combo[];
-//# sourceMappingURL=version.d.ts.map

package/dist/node_modules/@allyhub-next/render/dist/cap.d.ts

@@ -1,41 +0,0 @@
-import { type Tools } from "./tools.js";
-/** A cap: the most bitrate, and the buffer that holds two seconds of it. */
-export interface Cap {
-    /** kbit/s. */
-    maxKbps: number;
-    /** kbit. */
-    bufferKbps: number;
-}
-/** The cap of `maxBitrate` (or a platform profile's): the encoder's buffer holds two seconds of it. */
-export declare const capOf: (maxKbps: number) => Cap;
-/** How full the buffer is when a stream starts: x264's and x265's own start (vbv-init). */
-export declare const CAP_START = 0.9;
-/**
- * Whether frames of these sizes (bytes, in decode order) overrun the
- * cap's buffer: it starts nine tenths full, each frame takes its bits out
- * (never more than it holds), and each frame's time puts the cap's
- * bitrate back in, up to its size. The model x264 and x265 hold a cap by.
- */
-export declare function breaksCap(sizes: readonly number[], cap: Cap, fps: number): boolean;
-/**
- * The cap's buffer model over frames of these sizes from a buffer `start`
- * bits full (nine tenths of it by default): whether they overrun it, and
- * how full it is after them, in bits. Run segment after segment, each
- * from where the one before left the buffer, it is the model over the
- * whole stream.
- */
-export declare function capRun(sizes: readonly number[], cap: Cap, fps: number, start?: number): {
-    breaks: boolean;
-    end: number;
-};
-/**
- * The size in bytes of each video packet of a file, in decode order;
- * undefined when ffprobe could not read them.
- */
-export declare function packetSizes(file: string, o?: Tools): Promise<number[] | undefined>;
-/**
- * Whether an encoded segment overruns the cap. A file whose packets
- * cannot be read counts as over: the encoder then holds the cap itself.
- */
-export declare function overCap(file: string, cap: Cap, fps: number, o?: Tools): Promise<boolean>;
-//# sourceMappingURL=cap.d.ts.map

package/dist/node_modules/@allyhub-next/render/dist/capture.d.ts

@@ -1,78 +0,0 @@
-import type { CaptureOptions } from "@allyhub-next/video-core";
-export type { CaptureOptions };
-export declare const CAPTURE_DEFAULTS: {
-    bloom: {
-        threshold: number;
-        radius: number;
-        strength: number;
-    };
-    exposure: {
-        drift: number;
-        period: number;
-    };
-    grain: {
-        amount: number;
-        size: number;
-        shadows: number;
-        highlights: number;
-        chroma: number;
-        chromaSize: number;
-        static: boolean;
-    };
-};
-/** The exposure's drift at a film time, in stops. */
-export declare function exposureStops(e: {
-    drift: number;
-    period: number;
-}, t: number): number;
-/** The share of white noise's standard deviation gblur leaves at `sigma`. */
-export declare function blurredNoise(sigma: number): number;
-/**
- * The capture.grain.size whose grain has neighbouring pixels this
- * correlated, on a picture `lines` px on its shorter side: 0 for grain a
- * pixel each (or neighbours that differ more than chance, as sharpening
- * makes them).
- */
-export declare function grainSize(correlation: number, lines: number): number;
-/** The most grain the field holds without clipping: three deviations either side of the middle grey. */
-export declare const GRAIN_MOST: number;
-/** The grain's options with their defaults. */
-export type Grain = typeof CAPTURE_DEFAULTS.grain;
-/**
- * How strong the grain is at a level (0 to 1), over its strength at middle
- * grey: through `shadows` at 0, 1 at a half and `highlights` at 1.
- */
-export declare function grainWeight(g: Grain, level: number): number;
-/**
- * The grain's standard deviation in levels of 255 at a level of 255: its
- * strength by level, drawn smaller near black and white so that it keeps
- * GRAIN_ROOM_SD deviations of room there and never clips.
- */
-export declare function grainAt(g: Grain, level: number): number;
-/** Why capture options cannot be drawn, or undefined when they can. */
-export declare function captureProblem(o: CaptureOptions): string | undefined;
-/** Whether capture options draw anything. */
-export declare function capturesAnything(o: CaptureOptions | undefined): boolean;
-/**
- * The filters that put a camera's marks on a stream: from the label
- * `input` to the label returned, all their own labels starting with
- * `prefix`. The stream's frames are on its own clock from 0 (frame n at
- * n/fps); `first` is the film's frame number of its first frame, and
- * `frames` how many it has. With `alpha` its alpha is kept as it is.
- */
-export declare function captureGraph(o: CaptureOptions, at: {
-    input: string;
-    first: number;
-    /** How many frames the stream has. */
-    frames: number;
-    fps: number;
-    /** The frame rate as ffmpeg reads it ("30000/1001"); default fps. */
-    rate?: string;
-    size: readonly [number, number];
-    alpha?: boolean;
-    prefix?: string;
-}): {
-    filters: string[];
-    out: string;
-};
-//# sourceMappingURL=capture.d.ts.map

package/dist/node_modules/@allyhub-next/render/dist/clip.d.ts

@@ -1,27 +0,0 @@
-import { type Tools } from "./tools.js";
-/** The kinds of clip, by the file's extension. */
-export declare const CLIP_TYPES: readonly ["gif", "mp4", "webm"];
-export type ClipType = (typeof CLIP_TYPES)[number];
-/** The kind of clip a file's name says, or undefined. */
-export declare const clipTypeOf: (file: string) => ClipType | undefined;
-export interface ClipOptions extends Tools {
-    file: string;
-    type: ClipType;
-    /** Frames a second. */
-    fps: number;
-    /** Its width (never larger than the frames); default the frames' own, a gif's at most 960. */
-    width?: number;
-    /** A gif's palette from every frame alike (`full`) or weighted to what moves (`diff`, the default); dithered or not. */
-    palette?: {
-        stats?: "full" | "diff";
-        dither?: boolean;
-    };
-}
-/** Writes `frames` (PNGs of one size, in order) as a clip; its file, kind, rate and frame count. */
-export declare function writeClip(frames: readonly Buffer[], o: ClipOptions): Promise<{
-    out: string;
-    type: ClipType;
-    fps: number;
-    frames: number;
-}>;
-//# sourceMappingURL=clip.d.ts.map