allyhub 0.6.0 → 0.7.0

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

@@ -1,87 +0,0 @@
-import { type Browser, type Drawing, type LocalServer, type Page } from "@allyhub-next/browser";
-import type { DrawOptions, LoadedSummary, PartSignature } from "@allyhub-next/runtime/bridge";
-import { type BuildSource, type CaptionLine, type CaptionOptions, type ConsoleLog, type LayerAnswer, type LayerQueries, type LayoutReport, type LoadOptions, type Problem, type TextInk, type Track, type Word } from "@allyhub-next/video-core";
-/** A piece that could not load at all: the runtime's LoadFailure, its code and words. */
-export declare class LoadError extends Error {
-    readonly code: string;
-    /** The page's whole report, its stack included: where the host finds the project's line. */
-    readonly detail: string;
-    constructor(code: string, message: string, detail?: string);
-}
-export interface OpenOptions {
-    browser: Browser;
-    server: LocalServer;
-    /** Draw frames on request (a browser started with BeginFrame control, Linux). */
-    beginFrame?: boolean;
-}
-/** What a frame is captured as. */
-export interface CaptureOptions {
-    format?: "png" | "jpeg";
-    quality?: number;
-    /** Keep the stage's transparency (PNG). */
-    alpha?: boolean;
-}
-export declare class StagePage {
-    readonly page: Page;
-    readonly drawing: Drawing;
-    /** What the load said, after `load`. */
-    summary: LoadedSummary | undefined;
-    private constructor();
-    /** A page at a piece's size, the stage loaded in it. */
-    static open(source: Pick<BuildSource, "format">, options: OpenOptions): Promise<StagePage>;
-    /** Loads the piece and readies it; a piece that cannot load at all is a LoadError. */
-    load(source: BuildSource, options: LoadOptions): Promise<LoadedSummary>;
-    private output;
-    /** Draws film time t; the picture is settled when it returns. */
-    seek(t: number, options?: DrawOptions): Promise<void>;
-    /** What shows after the last seek, as a string two equal moments share; undefined when the DOM does not say it all. */
-    signature(): Promise<string | undefined>;
-    /**
-     * What moment t shows, drawn for its layout alone (LoadedOutput.signatureAt):
-     * the page's pixels are then not t's until the next seek.
-     */
-    signatureAt(t: number): Promise<string | undefined>;
-    /** The page's picture now. */
-    capture(options?: CaptureOptions): Promise<Buffer>;
-    partSignature(key: string, times: readonly number[]): Promise<PartSignature>;
-    problems(): Promise<Problem[]>;
-    stuck(): Promise<string | undefined>;
-    words(): Promise<Word[]>;
-    lines(): Promise<CaptionLine[]>;
-    /** The options its first layer that read its captions asked; undefined when none did. */
-    captionOptions(): Promise<CaptionOptions | undefined>;
-    measure(times?: readonly number[]): Promise<LayoutReport>;
-    tracks(from: number, to: number): Promise<Track[]>;
-    inks(t: number): Promise<TextInk[]>;
-    /** A deck as it was drawn (slides-core's DrawnDeck). */
-    deck(): Promise<unknown>;
-    /**
-     * Hides every text's fill while on (HIDE_TEXT_CSS; with `outlines`,
-     * their strokes and shadows too), as a constructed style sheet adopted
-     * by the document, not a <style> element: the page's watcher of changes
-     * outside the stage (AK-R003) sees no change to the DOM.
-     */
-    hideText(on: boolean, outlines?: boolean): Promise<void>;
-    drawCover(n: number): Promise<void>;
-    ask<K extends keyof LayerQueries>(name: K, args: LayerQueries[K]["args"]): Promise<LayerAnswer<LayerQueries[K]["answer"]>[]>;
-    /**
-     * The output printed to a PDF, a sheet per page: at each page's still,
-     * the stage's DOM cloned onto a sheet of `paper` (CSS @page size: "W H",
-     * or A4 and Letter at their size, the frame scaled onto it) over its
-     * `background`, so the text stays text; canvases frozen to pictures; a
-     * sheet without headings of its own given an invisible one, its title,
-     * so the outline lists every page; printed tagged, with the outline and
-     * backgrounds. The stage is gone after it: print last.
-     */
-    print(pages: readonly {
-        still: number;
-        title: string;
-        background: string;
-    }[], paper: string): Promise<Buffer>;
-    /** What piece code printed since the load began. */
-    console(): Promise<ConsoleLog>;
-    /** Requests the page made that the server did not allow (AK-N003). */
-    refused(): string[];
-    close(): Promise<void>;
-}
-//# sourceMappingURL=page.d.ts.map

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

@@ -1,69 +0,0 @@
-import { type Browser, type Page } from "@allyhub-next/browser";
-import type { BakeReport } from "@allyhub-next/scenery";
-import { type Answer, type SceneryCommands, type SceneryFailure } from "@allyhub-next/scenery-host";
-import type { MediaInfo, RuleCode } from "@allyhub-next/video-core";
-/** How long a bake may take: as long as its samples, bounces and density ask, up to half a day. */
-export declare const BAKE_TIMEOUT_MS: number;
-/** Methods of a scenery's commands a host calls by name. */
-type Command = Exclude<keyof SceneryCommands, "page">;
-export interface SceneryStageOptions {
-    browser: Browser;
-    root: string;
-    /** The scenery module, a project path (room/scenery.ts). */
-    file: string;
-    /** The build folder this bundle goes into. */
-    buildDir: string;
-    /** The project's media the scenery may load, by path. */
-    media: Readonly<Record<string, MediaInfo>>;
-    /** The project's declared packages. */
-    dependencies: ReadonlySet<string>;
-    /** The page's size, which commands that draw take theirs from. */
-    width?: number;
-    height?: number;
-    /** Leave the scenery unbaked even when there is a bake for it (to bake it). */
-    unbaked?: boolean;
-}
-/**
- * What a scenery's page failed at: its kind, the rule it is said under,
- * and, when a move or the scenery's update asked the time of a reference
- * that has none, that reference (give it a time).
- */
-export declare class SceneryCallError extends Error {
-    readonly kind: SceneryFailure;
-    readonly rule: RuleCode;
-    readonly needsTime: string | undefined;
-    constructor(kind: SceneryFailure, message: string, needsTime?: string);
-}
-export declare class SceneryStage {
-    readonly page: Page;
-    private readonly server;
-    private constructor();
-    static open(options: SceneryStageOptions): Promise<SceneryStage>;
-    /** Calls one of the scenery's commands, with JSON arguments. */
-    call<M extends Command>(method: M, ...args: Parameters<SceneryCommands[M]>): Promise<Awaited<ReturnType<SceneryCommands[M]>>>;
-    private callWithin;
-    /** A command's value, or a SceneryCallError with what failed. */
-    value<T>(answer: Answer<T> | Promise<Answer<T>>): Promise<T>;
-    /**
-     * Bakes the scenery's light on this page's renderer: the report and the
-     * bake file's bytes (keepBake writes them). The stage must be opened
-     * unbaked.
-     */
-    bake(): Promise<{
-        report: BakeReport;
-        bytes: Uint8Array;
-    }>;
-    /**
-     * A project's scenery item on a page of its own: its files' media and
-     * its declared packages read from the project, its bundle in the
-     * project's build folder.
-     */
-    static ofProject(options: Omit<SceneryStageOptions, "buildDir" | "media" | "dependencies"> & {
-        buildDir?: string;
-    }): Promise<SceneryStage>;
-    close(): Promise<void>;
-}
-/** Where a scenery's bundle goes in a project's build folder. */
-export declare const sceneryBuildDir: (root: string) => string;
-export {};
-//# sourceMappingURL=scenery-page.d.ts.map

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

@@ -1,49 +0,0 @@
-import { type Browser } from "@allyhub-next/browser";
-import { type CameraState, type LensFrame, type SolveParam, type SolveResult } from "@allyhub-next/scenery";
-import type { SceneryStage } from "./scenery-page.js";
-/** A point of the scenery as a correspondence names it: metres, an object's box centre, or a place on a screen's face (shares of its content from its top left). */
-export type SolveRef = readonly [number, number, number] | {
-    object: string;
-} | {
-    screen: string;
-    uv: readonly [number, number];
-};
-export interface Correspondences {
-    points?: readonly {
-        name?: string | undefined;
-        where: SolveRef;
-        px: readonly [number, number];
-        weight?: number | undefined;
-    }[];
-    lines?: readonly {
-        name?: string | undefined;
-        from: SolveRef;
-        to: SolveRef;
-        px: readonly [number, number];
-        weight?: number | undefined;
-    }[];
-}
-export interface SceneryCameraSolve {
-    /** The picture's size, px: the frame the pixels were measured on. */
-    frame: readonly [number, number];
-    /** Scenery time the scenery is posed at for named points, s. */
-    t: number;
-    times?: Readonly<Record<string, number>>;
-    lens?: number;
-    lensFrame?: LensFrame;
-    free?: readonly SolveParam[];
-    /** A camera to start from (one of the scenery's, as its info gives it). */
-    from?: CameraState;
-}
-/** Solves the camera of a picture from correspondences with a scenery on its page. */
-export declare function solveSceneryCamera(stage: SceneryStage, c: Correspondences, o: SceneryCameraSolve): Promise<SolveResult>;
-/**
- * The scenery drawn from a solved camera, the measured pixels as yellow
- * rings and where the camera puts them as red dots joined to them: a WebP.
- */
-export declare function solvedPicture(stage: SceneryStage, browser: Browser, camera: CameraState, r: SolveResult, o: {
-    frame: readonly [number, number];
-    t: number;
-    times?: Readonly<Record<string, number>>;
-}): Promise<Buffer>;
-//# sourceMappingURL=scenery-solve.d.ts.map

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

@@ -1,8 +0,0 @@
-import type { Plugin } from "@allyhub-next/build";
-export declare function sceneryHost(root: string): {
-    plugins: Plugin[];
-    lent: Record<string, string>;
-};
-/** Puts three.js's decoders beside a build's bundles. */
-export declare function serveDecoders(buildDir: string): Promise<void>;
-//# sourceMappingURL=scenery.d.ts.map

package/dist/node_modules/@allyhub-next/stage/dist/server.d.ts

@@ -1,21 +0,0 @@
-import { type LocalServer, type Mount } from "@allyhub-next/browser";
-/** The base the stage's own files are served under. */
-export declare const STAGE_BASE = "/__allyhub/";
-/** The stage page's path. */
-export declare const STAGE_PAGE = "/__allyhub/stage.html";
-/** Where the build's bundles are, as the stage imports them. */
-export declare const BUILD_BASE = "/build/";
-/** Where a project file is served: what the build's media values point at (`mediaUrl`). */
-export declare const mediaUrl: (path: string) => string;
-export interface StageServerOptions {
-    /** The folder the build bundled into (bundleForStage's outDir). */
-    buildDir: string;
-    /** The project's folder. */
-    root: string;
-    /** The project files the stage may load: its media. */
-    media: Iterable<string>;
-    /** More to serve (a scenery's decoders). */
-    mounts?: readonly Mount[];
-}
-export declare function serveStage(options: StageServerOptions): Promise<LocalServer>;
-//# sourceMappingURL=server.d.ts.map

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

@@ -1,22 +0,0 @@
-export interface StageFiles {
-    /** Absolute path of the runtime's browser bundle (one ES module). */
-    runtime: string;
-    /** Font folders to serve, by URL prefix (no trailing slash). */
-    fonts: Record<string, string>;
-    /** Stylesheets that declare the fonts, relative to the page's base. */
-    fontCss: string[];
-}
-/** The files a host serves beside the stage page. */
-export declare function stageFiles(): StageFiles;
-export interface StageHtmlOptions {
-    /** Where the page's files are served: the fonts and, by default, the runtime. Default "/__allyhub/". */
-    base?: string;
-    nonce?: string;
-    /** HTML before </body>. */
-    bodyEnd?: string;
-    /** URL of the runtime's bundle; default `<base>runtime.js`. */
-    runtime?: string;
-}
-/** The stage page: the fonts, the runtime, and #ak-stage, where it loads a built piece. */
-export declare function stageHtml(opts?: StageHtmlOptions): string;
-//# sourceMappingURL=host.d.ts.map