allyhub 0.6.0 → 0.7.0

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

@@ -1,14 +0,0 @@
-export { load } from "./output.js";
-export { consoleLog, installConsole } from "./console.js";
-export { LoadFailure, codeOf } from "./errors.js";
-export type { Embed } from "./env.js";
-export type { DrawMode, DrawOptions, LoadedOutput, LoadedSummary, LoadFailureInfo, PartSignature, SayNeed, StageBridge, } from "./bridge.js";
-export { planStack, type StackPlan } from "./compose.js";
-export { MEASURE_EVERY, MOMENTS_PER_PART } from "./measure.js";
-export { STUCK_WAIT } from "./frame.js";
-export { RUN_PROBLEMS } from "./env.js";
-export { EPOCH_MS, installGuards, type Guards } from "./guards.js";
-export { mixPlan, musicPlayed, speechGains, voicePlan, wordsOnFilm, type MixPlanOptions, } from "./mix-plan.js";
-export { startPlayer, type PlayerCommand, type PlayerEvent, type PlayerOptions, } from "./player/player.js";
-export { locateLayers, type LocatedLayer } from "./locate.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/node_modules/@allyhub-next/runtime/dist/inspect.d.ts

@@ -1,112 +0,0 @@
-import { type Box, type Problem, type TextContainer } from "@allyhub-next/video-core";
-export interface ScreenText {
-    text: string;
-    el: HTMLElement;
-    bbox: Box;
-    /** Effective opacity, the product of the element's and its ancestors'. */
-    opacity: number;
-    /**
-     * The rows its glyphs cover, [top, bottom] in viewport pixels: the first
-     * line's box down to the highest glyph's top, the last line's up to the
-     * lowest glyph's bottom. A line's box is the font's whole ascent and
-     * descent, taller than what is drawn.
-     */
-    rows: [top: number, bottom: number];
-    /**
-     * What its glyphs cover, a box per line in viewport pixels, [x0, y0, x1,
-     * y1]: each line's box down to its glyphs' rows (as `rows`), out to the
-     * first glyph's overhang on the left of the first line and the last
-     * glyph's on the right of the last.
-     */
-    lines: [x0: number, y0: number, x1: number, y1: number][];
-    /** Its font size as drawn, in viewport pixels: the computed size scaled as a transform scales its line's box. */
-    size: number;
-    /**
-     * The height of its font's lowercase x as drawn, in viewport pixels,
-     * scaled as `size`: how large its lowercase letters are, which a
-     * handwriting or display face draws much smaller than its size says.
-     * Only for text with a lowercase Latin letter.
-     */
-    xHeight?: number;
-}
-/**
- * Visible text in `root`, in document order, with where it is drawn;
- * `screens: false` leaves out what is part of a picture: drawn on a 3D
- * scenery's screens, or inside an element marked `data-ak-picture`.
- */
-export declare function screenTexts(root: HTMLElement, opts?: {
-    screens?: boolean;
-}): ScreenText[];
-export interface TextBlock {
-    text: string;
-    /** In the frame's pixels (the stage's, unscaled), whole pixels. */
-    box: Box;
-    /** Inside a page viewport (a site demo): the page's own text. */
-    viewport?: boolean;
-    /** The lowest opacity of its text nodes (each with its ancestors'). */
-    opacity: number;
-    /**
-     * What shows of its glyphs, in the frame's pixels: the rows they cover
-     * (a line's box is taller), cut where an ancestor clips its content
-     * (overflow); null when all of it is clipped away.
-     */
-    ink: Box | null;
-    /** The share of its glyphs' box that shows, the lowest of its text nodes' (1: nothing clips it). */
-    shown: number;
-    /** Its font size as drawn, in the frame's pixels: the smallest of its text nodes'. */
-    size: number;
-    /** Its lowercase x's height as drawn, in the frame's pixels: the smallest of its text nodes' that have lowercase Latin letters. */
-    xHeight?: number;
-    /** The boxes it is drawn inside, nearest first (see `containersOf`). */
-    containers: TextContainer[];
-    /**
-     * What shows of its glyphs, a box per line in the frame's pixels (not
-     * rounded): cut where an ancestor clips its content, except where that
-     * ancestor's edge is at or past the frame's, so the frame's own edges are
-     * measured against them (the text-off-frame fact).
-     */
-    glyphs: Box[];
-    /** Its text nodes: the element each is drawn by, its opacity and its glyphs' boxes (as `glyphs`). */
-    runs: {
-        el: HTMLElement;
-        opacity: number;
-        glyphs: Box[];
-    }[];
-    /** The block-level element whose text it is. */
-    el: HTMLElement;
-}
-/**
- * Visible text in `root` as blocks: the text nodes of one block-level
- * element (a line of word spans, a paragraph) joined, with the box round
- * them in the stage's own pixels, whatever the stage is scaled to.
- */
-export declare function textBlocks(root: HTMLElement, stage: HTMLElement, width: number): TextBlock[];
-/**
- * What allyhub inspect motion follows in a layer: every element that
- * draws something of its own and shows (opacity over 0.05): one that holds
- * text directly, one that paints a background, a border or a shadow, and a
- * picture (img, svg, canvas, video; nothing inside an svg).
- */
-export declare function trackedIn(root: HTMLElement): {
-    el: Element;
-    what: string;
-    opacity: number;
-    name?: string;
-}[];
-/** A selector that finds el inside the stage. */
-export declare function selectorOf(el: Element, stage: HTMLElement): string;
-export interface InspectInput {
-    part: string;
-    t: number;
-    section: HTMLElement;
-    stage: HTMLElement;
-    format: string;
-    /** The messages file of this language, for problem locations. */
-    messagesFile: string;
-    width: number;
-    height: number;
-    /** Message keys showing a text, to say what to shorten. */
-    keysShowing(text: string): string[];
-}
-export declare function inspectFrame(input: InspectInput): Problem[];
-//# sourceMappingURL=inspect.d.ts.map

package/dist/node_modules/@allyhub-next/runtime/dist/locate.d.ts

@@ -1,11 +0,0 @@
-import { type NoteShape } from "@allyhub-next/formats";
-export interface LocatedLayer {
-    part: string;
-    /** Its component. */
-    layer: string;
-    /** Its `data-ak` name, when what is under the place has one. */
-    name?: string;
-    text?: string;
-}
-export declare function locateLayers(root: ParentNode, mark: NoteShape): LocatedLayer[];
-//# sourceMappingURL=locate.d.ts.map

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

@@ -1,41 +0,0 @@
-import { type LayoutReport, type PageObjects, type TextInk, type Track } from "@allyhub-next/video-core";
-import type { PartSignature } from "./bridge.js";
-import type { CaptionTrack } from "./captions.js";
-import type { Mounted, TextsAt } from "./compose.js";
-import type { Env } from "./env.js";
-import { type Drawer } from "./frame.js";
-import type { FootagePlanner } from "./footage.js";
-import type { ResolvedPiece } from "./piece.js";
-import type { StageHost } from "./stage.js";
-/** The most moments measure() looks at in one part by default. */
-export declare const MOMENTS_PER_PART = 24;
-/** Seconds between the moments measure() looks at through each part by default. */
-export declare const MEASURE_EVERY = 1;
-/** Two 32-bit hashes of a string (FNV-1a and djb2) and its length: a frame's signature. */
-export declare function domHash(s: string): string;
-/**
- * ctx.texts: the text of `layers` (mounted already: listed before the
- * asking layer) that show at part time t, each drawn at t's frame for its
- * layout and measured, once per layer and frame.
- */
-export declare function textReader(env: Env, piece: ResolvedPiece, stage: StageHost, forLayout: <T>(f: () => T) => T): TextsAt;
-export interface Measurer {
-    measure(times?: readonly number[]): Promise<LayoutReport>;
-    tracks(from: number, to: number): Promise<Track[]>;
-    inks(t: number): Promise<TextInk[]>;
-    objects(t: number, keys: (text: string) => string[]): Promise<PageObjects>;
-    signature(): string | undefined;
-    signatureAt(t: number): Promise<string | undefined>;
-    partSignature(key: string, times: readonly number[]): Promise<PartSignature>;
-}
-export interface MeasureInput {
-    piece: ResolvedPiece;
-    stage: StageHost;
-    drawer: Drawer;
-    mounted: readonly Mounted[];
-    duration: number;
-    captions: CaptionTrack;
-    footage: FootagePlanner | undefined;
-}
-export declare function measurer(input: MeasureInput): Measurer;
-//# sourceMappingURL=measure.d.ts.map

package/dist/node_modules/@allyhub-next/runtime/dist/mix-plan.d.ts

@@ -1,42 +0,0 @@
-import { type GainPoint, type MixPlan, type MusicSegment, type Segment } from "@allyhub-next/audio";
-import { type AudioPlan, type MediaInfo, type MusicPlan, type Timeline, type VoiceSetting, type Word } from "@allyhub-next/video-core";
-type Mic = NonNullable<AudioPlan["mic"]>;
-/**
- * How the speech was recorded, for the timeline: the video's setting (a
- * studio's finishing where it gives none) and each part's own, resolved
- * over their presets. The settings were checked when the piece was made
- * (the SDK's and the build's voiceProblem).
- */
-export declare function voicePlan(video: VoiceSetting | undefined, specs: readonly {
-    key: string;
-    mic?: VoiceSetting | undefined;
-}[]): {
-    mic: Mic;
-};
-/** Where each spoken word falls on the film's clock, over every segment. */
-export declare function wordsOnFilm(segments: readonly (Segment & {
-    file: string;
-})[], wordsOf: (file: string) => readonly Word[] | undefined): {
-    start: number;
-    end: number;
-}[];
-/**
- * The film seconds and file seconds the music plays: its stretches with
- * their seams' fades, from the file's length `len`.
- */
-export declare function musicPlayed(m: MusicPlan, len: number, duration: number): MusicSegment[];
-export interface MixPlanOptions {
-    /** Seeds the synthesized sounds and the voice's rooms: piece id, output, combo key with the format. */
-    seed: string;
-}
-/** The plan for a timeline, given the project's media by path (with loudness). */
-export declare function mixPlan(timeline: Timeline, media: Readonly<Record<string, MediaInfo>>, opts: MixPlanOptions): MixPlan;
-/**
- * Each part's speechGainDb on the film's clock, as a gain envelope: where
- * its speech plays (its clips, room tone included) or else where its
- * picture is, ramped over 10 ms at each change. Empty when no part sets
- * one.
- */
-export declare function speechGains(timeline: Timeline): GainPoint[];
-export {};
-//# sourceMappingURL=mix-plan.d.ts.map

package/dist/node_modules/@allyhub-next/runtime/dist/music.d.ts

@@ -1,29 +0,0 @@
-import { type MediaInfo, type MusicGrid, type MusicOptions, type MusicPlan, type PartInput } from "@allyhub-next/video-core";
-import type { FilmClock } from "./clock.js";
-import type { Env } from "./env.js";
-import type { ResolvedPiece } from "./piece.js";
-export interface MusicClock {
-    /** The music asked for, as options; undefined: none. */
-    readonly music: MusicOptions | undefined;
-    /** The file this combo plays (its language's), when there is one. */
-    readonly media: MediaInfo | undefined;
-    /** Parts without speech end on the beat (snap asked, and a tempo known). */
-    readonly snapped: boolean;
-    /** Seconds per beat when snapped, else 0; and the beat's phase on the film. */
-    readonly beat: number;
-    readonly beatPhase: number;
-    readonly grid: MusicGrid | undefined;
-    /**
-     * Where a part without speech ends: the beat nearest `t` after `after`,
-     * as the music's stretches lay its beats on the film; undefined when
-     * nothing snaps.
-     */
-    snapTo(inputs: readonly PartInput[]): ((t: number, after: number) => number | undefined) | undefined;
-    /** The music as the film plays it (Timeline.audio.music); undefined: none asked for. */
-    plan(film: FilmClock): MusicPlan | undefined;
-}
-/** The music's clock: its tempo, its grid, and how its stretches lay out. */
-export declare function musicClock(env: Env, piece: ResolvedPiece): MusicClock;
-/** The music as the film plays it (Timeline.audio.music); undefined: none asked for. */
-export declare const musicPlan: (clock: MusicClock, film: FilmClock) => MusicPlan | undefined;
-//# sourceMappingURL=music.d.ts.map

package/dist/node_modules/@allyhub-next/runtime/dist/output.d.ts

@@ -1,5 +0,0 @@
-import { type BuildSource, type LoadOptions } from "@allyhub-next/video-core";
-import type { LoadedOutput } from "./bridge.js";
-import { type Embed } from "./env.js";
-export declare function load(source: BuildSource, options: LoadOptions, el: HTMLElement, embed?: Embed): Promise<LoadedOutput>;
-//# sourceMappingURL=output.d.ts.map

package/dist/node_modules/@allyhub-next/runtime/dist/pictures.d.ts

@@ -1,39 +0,0 @@
-/** A picture that did not load. */
-export interface BrokenPicture {
-    /** The element that draws it: the `<img>`, or the element with the background. */
-    el: Element;
-    /** The source as written: the `src` attribute, or the background's URL. */
-    src: string;
-    via: "img" | "background";
-}
-export interface PictureWatch {
-    /** Decodes what the stage draws now; what fails is recorded. */
-    sweep(): Promise<void>;
-    /** What did not load so far, once per element and source. */
-    broken(): BrokenPicture[];
-}
-/**
- * Whether a source is the stage's to serve: on its own origin, or inline
- * (data:, blob:). Another origin is the sandbox's (AK-N003).
- */
-export declare function servedHere(src: string, base: string): boolean;
-/** The URLs of a computed `background-image` (`url("…")`, quoted by the browser). */
-export declare function backgroundUrls(value: string): string[];
-/** What to do about a source that did not load, in one sentence. */
-export declare function pictureHint(src: string): string;
-export declare function watchPictures(stage: HTMLElement): PictureWatch;
-/**
- * Waits until every picture the stage shows now is decoded, so a frame is
- * never taken while a picture is still blank. A layer may change what an
- * `<img>` shows, or an inline background image, as it plays (a captured
- * screen swapped for the next state), and the browser may let a decoded
- * picture go while it is out of sight and decode it again only when it is
- * painted: either way a capture taken before it is ready shows nothing
- * where it goes. So every frame asks each `<img>` that is shown, and each
- * inline background URL, to be decoded (at once when it already is).
- * The returned function waits at most `limitMs` and resolves with the
- * sources still not decoded then; a picture that does not load, at any
- * moment, is given to `broken` (AK-A005).
- */
-export declare function pictureWaiter(stage: HTMLElement, broken?: (b: BrokenPicture) => void): (limitMs: number) => Promise<string[]>;
-//# sourceMappingURL=pictures.d.ts.map

package/dist/node_modules/@allyhub-next/runtime/dist/piece.d.ts

@@ -1,34 +0,0 @@
-import { type Format, type Look, type PartDefaults, type PartSpec, type PieceContext, type PieceDefinition, type SizeInfo, type VideoOptions } from "@allyhub-next/video-core";
-import type { Env } from "./env.js";
-export interface ResolvedPiece {
-    readonly def: PieceDefinition;
-    readonly options: VideoOptions;
-    readonly fps: number;
-    readonly format: Format;
-    /** Its pixels, orientation and safe zone: its format as the piece gives it. */
-    readonly dims: SizeInfo;
-    /** The prefix of its message keys: its id with `/` as `.`. */
-    readonly prefix: string;
-    readonly look: Look;
-    /** Part defaults: the output's over the project's over PART_DEFAULTS. */
-    readonly defaults: Required<PartDefaults>;
-    /** The file its parts were written in (the piece's own, else the one it says). */
-    readonly writtenIn: string;
-    /** The folder the music's file is named in: where it was written, kept through a spread. */
-    readonly musicBase: string;
-    /** The longest one moment may take to draw, ms (AK-P003). */
-    readonly seekLimitMs: number;
-    /** The longest loading may take, ms (AK-P002). */
-    readonly loadLimitMs: number;
-    /** A deck's video items by folder, which its bundle imports for slides.yaml (`DECK_VIDEOS`). */
-    readonly videos: Readonly<Record<string, PieceDefinition>>;
-}
-/** The export of a deck's module that holds the video items its slides.yaml shows, by folder. */
-export declare const DECK_VIDEOS = "__allyhubVideos";
-/** Imports the piece and resolves its output; its parts are built by buildParts. */
-export declare function resolvePiece(env: Env): Promise<ResolvedPiece>;
-/** What every output's build function receives. */
-export declare function pieceContext(env: Env, piece: ResolvedPiece): PieceContext;
-/** The parts the output's function builds, a repeated key reported (AK-K001) and left out. */
-export declare function buildParts(env: Env, piece: ResolvedPiece, ctx: PieceContext): Promise<PartSpec[]>;
-//# sourceMappingURL=piece.d.ts.map

package/dist/node_modules/@allyhub-next/runtime/dist/player/clips.d.ts

@@ -1,41 +0,0 @@
-import { type TimelineFootage } from "@allyhub-next/video-core";
-export interface PlacedClip extends TimelineFootage {
-    /** Where the stage loads the video. */
-    url: string;
-    /** The video's length, seconds (from ffprobe), if known. */
-    duration?: number;
-    /** The video's pixels, if known. */
-    source?: {
-        width: number;
-        height: number;
-    };
-    /** The part's element: the clip's box goes in it. */
-    host: HTMLElement;
-    /**
-     * The person cut out with the file's person matte (at the URL `matte`),
-     * drawn into `host`: over the graphics behind the person, or over the
-     * layer's own treated background.
-     */
-    cutoutIn?: {
-        host: HTMLElement;
-        matte: string;
-    };
-    /** Where the stage loads the background's image. */
-    imageUrl?: string;
-}
-export declare class Clips {
-    private readonly drawn;
-    private readonly fps;
-    private playing;
-    constructor(clips: readonly PlacedClip[], fps: number);
-    /** Video seconds a clip shows at film time t: its first frame holds before the file, its last after it. */
-    private sourceAt;
-    /** The player plays or pauses: clips follow. */
-    setPlaying(on: boolean): void;
-    /** Shows every clip at film time t, following the clock. */
-    draw(t: number, jumped: boolean): void;
-    /** Keeps a playing video with the clock. */
-    private follow;
-    dispose(): void;
-}
-//# sourceMappingURL=clips.d.ts.map

package/dist/node_modules/@allyhub-next/runtime/dist/player/cutout.d.ts

@@ -1,57 +0,0 @@
-export declare class Cutout {
-    /** The clipping box, placed like the take's. */
-    readonly box: HTMLDivElement;
-    /** The cut-out, placed like the take's <video>. */
-    readonly canvas: HTMLCanvasElement;
-    private readonly take;
-    private readonly matte;
-    private readonly alpha;
-    private readonly out;
-    private readonly alphaCtx;
-    private shown;
-    private failed;
-    private disposed;
-    private readonly edge;
-    /** Where the firm matte is blurred (with an edge). */
-    private readonly soft;
-    private readonly softCtx;
-    private readonly firm;
-    /** The edge's blur and levels at the scale they were made for. */
-    private made;
-    constructor(opts: {
-        take: HTMLVideoElement;
-        matte: string;
-        host: HTMLElement;
-        /** The take's displayed pixels, if known. */
-        source?: {
-            width: number;
-            height: number;
-        };
-        /** The person's edge: softness and how far it is pulled in, in the frame's pixels. */
-        edge?: {
-            feather: number;
-            shrink: number;
-        };
-        /** The matte did not load. */
-        onFail?: () => void;
-    });
-    /** The canvas's pixels: the take's shape, at most MAX_SIDE long. */
-    private size;
-    private readonly redraw;
-    /** Draws again at every new frame a video presents, where the browser says when. */
-    private everyFrame;
-    /** Shows or hides the cut-out with its take. */
-    show(on: boolean): void;
-    /** Keeps the matte at the take's moment: paused with it, playing with it. */
-    sync(): void;
-    /** Draws the take's frame, keeping only the person. */
-    draw(): void;
-    /**
-     * The edge's blur (in the matte's pixels) and levels, for the size the
-     * canvas is drawn at now: a punch-in or a moving box changes how many
-     * of the frame's pixels a matte pixel covers.
-     */
-    private edgeNow;
-    dispose(): void;
-}
-//# sourceMappingURL=cutout.d.ts.map

package/dist/node_modules/@allyhub-next/runtime/dist/player/player.d.ts

@@ -1,78 +0,0 @@
-import { type MediaInfo, type Timeline } from "@allyhub-next/video-core";
-import type { LoadedOutput } from "../bridge.js";
-export interface PlayerOptions {
-    output: LoadedOutput;
-    stage: HTMLElement;
-    /** The project's media by path, as the stage sees them (with loudness). */
-    media?: Readonly<Record<string, MediaInfo>>;
-    /** Seeds the synthesized sounds like the export: piece:output:seed key (seedKey). */
-    seed?: string;
-    /** Where to start, seconds. */
-    start?: number;
-    /** Tells the embedding page what happens. */
-    post?: (msg: PlayerEvent) => void;
-    /**
-     * false: no control bar. The page that embeds the stage draws its own
-     * controls and drives the player with commands (allyhub dev's workbench).
-     * Default true.
-     */
-    chrome?: boolean;
-}
-export type PlayerMode = "play" | "page";
-export type PlayerEvent = {
-    type: "ready";
-    duration: number;
-    parts: Timeline["parts"];
-} | {
-    type: "time";
-    t: number;
-    part: string | undefined;
-    playing: boolean;
-    mode: PlayerMode;
-}
-/** A take's denoised sound is being made: it plays as recorded meanwhile. */
- | {
-    type: "sound";
-    denoising: boolean;
-};
-export type PlayerCommand = {
-    type: "play";
-} | {
-    type: "pause";
-} | {
-    type: "seek";
-    t: number;
-} | {
-    type: "mode";
-    mode: PlayerMode;
-} | {
-    type: "next";
-} | {
-    type: "prev";
-} | {
-    type: "captions";
-    on: boolean;
-};
-export declare function startPlayer(opts: PlayerOptions): Promise<{
-    command(cmd: PlayerCommand): void;
-    now: () => number;
-    /** For tests and debugging. */
-    state: () => {
-        playing: boolean;
-        audioClock: boolean;
-        audio: AudioContextState;
-        t: number;
-        frame: number;
-        ticks: number;
-        generation: number;
-        /** Sound sources scheduled for this play: the mix, one sound. */
-        sounds: number;
-        sfx: number;
-        mode: PlayerMode;
-        page: number;
-        captions: boolean;
-        caption: string;
-        cues: number;
-    };
-}>;
-//# sourceMappingURL=player.d.ts.map

package/dist/node_modules/@allyhub-next/runtime/dist/reads.d.ts

@@ -1,132 +0,0 @@
-import { type DataFile, type LineAnchor, type MediaInfo, type MessageHint, type MessagesFile, type MessageTree, type MessageValue, type Problem, type Reads, type TextAnchor } from "@allyhub-next/video-core";
-export interface ReadLogOptions {
-    lang: string | undefined;
-    defaultLang: string | undefined;
-    own: MessagesFile;
-    fallback: MessagesFile;
-    /** Key → the anchors of a line a script wrote them in, for each of the two. */
-    anchors?: {
-        own?: Readonly<Record<string, readonly TextAnchor[]>>;
-        fallback?: Readonly<Record<string, readonly TextAnchor[]>>;
-    };
-    /** Repo path → media, with URLs valid in this page. */
-    media: Record<string, MediaInfo>;
-    /** The piece's file: ctx.asset and ctx.data paths are relative to it. */
-    file: string;
-    /** Repo path → data files ctx.data can read. */
-    data?: Record<string, DataFile>;
-    /** The folder of the shared words, where a missing key is to be added. */
-    text?: string;
-}
-export declare class ReadLog {
-    private readonly messages;
-    private readonly media;
-    private readonly data;
-    /** Text that s() or s.with() returned → the key it came from (the latest). */
-    private readonly keyByText;
-    /** Media looked for that is not there yet (a say's stem): read as missing. */
-    private readonly missingReads;
-    private readonly missingMedia;
-    readonly problems: Problem[];
-    /** Every display text read, for matching against the screen. */
-    readonly texts: Set<string>;
-    /**
-     * Hears every read as it happens (a message's value, a medium's or data
-     * file's sha256): the runtime records what each part reads while it
-     * mounts and draws, for the part's identity.
-     */
-    tap: ((what: string, value: string) => void) | undefined;
-    private readonly opts;
-    private readonly fileOf;
-    constructor(opts: ReadLogOptions);
-    private value;
-    private record;
-    /** The locale a key's value comes from, for plural rules. */
-    private locale;
-    /** The text of a key for these inputs, recorded. */
-    private text;
-    /** s(key, hint): this language's text, else the default language's. */
-    s(key: string, hint?: MessageHint): string;
-    /**
-     * s.with(key, inputs, hint): the variant these inputs select (plurals,
-     * selectors), with its {name} variables filled.
-     */
-    with(key: string, inputs: Readonly<Record<string, string | number>>, hint?: MessageHint): string;
-    /**
-     * The message a text came from (the latest s() or s.with() that returned
-     * it), and how it reads aloud: its `speak` when it has one.
-     */
-    spokenOf(text: string): {
-        key: string;
-        speak: string;
-        anchors?: LineAnchor[];
-    } | undefined;
-    /** s.list(prefix): numbered keys under the prefix, in order. */
-    list(prefix: string, hint?: MessageHint): MessageTree[];
-    /** The keys under a prefix (`<prefix>.…`), in either language, without recording a read. */
-    keysUnder(prefix: string): string[];
-    /** The raw value of a key without recording a read. */
-    peek(key: string): MessageValue | undefined;
-    /** Marks a key as read (e.g. a page's "<prefix>.<page>.notes"). */
-    touch(key: string): MessageValue | undefined;
-    /** Media by repo path, recorded as read. undefined when it is not in the project. */
-    mediaAt(path: string): MediaInfo | undefined;
-    /**
-     * Media looked for by a path that is not there yet (a say's file, by its
-     * stem): recorded, so the digest changes once it is made.
-     */
-    missing(path: string): void;
-    /** A problem found while reading (once per message). */
-    report(p: Problem): void;
-    /**
-     * Paths are relative to the file that wrote the output read (another
-     * piece's, for a piece that reuses its outputs), else the piece's.
-     */
-    relativeTo(file: string): void;
-    private base;
-    /** The file paths are relative to. */
-    private get pathBase();
-    /** Where a path named in `base` (the folder of the module that wrote it; none: the piece's) is from, for a message. */
-    baseOf(base?: string): string;
-    /** A path named in `base` (a folder; none: the piece's file's), as a project path. */
-    private resolve;
-    /**
-     * ctx.asset(path): media relative to the piece's file, or to `base`, the
-     * file the code that named it was written in (pathBase).
-     */
-    asset(path: string, base?: string): MediaInfo;
-    /** A media file that may not be there: found and recorded, or recorded as missing; never a problem. */
-    optionalAsset(path: string): MediaInfo | undefined;
-    /**
-     * A data file the piece may not have yet (a take's edits file, which the
-     * preview's transcript editor creates): read and recorded when it is
-     * there; recorded as missing (so the digest changes once it is made)
-     * when not, without a problem.
-     */
-    optionalData(path: string, base?: string): {
-        full?: string;
-        found: boolean;
-        value?: unknown;
-        error?: string;
-    };
-    /** ctx.data(path): a data file relative to the piece's file, parsed. */
-    readData(path: string): unknown;
-    /** reads(), with each message attributed to the part its key names. */
-    reads(prefix: string, partKeys: readonly string[]): Reads;
-    /** Translation problems: keys that fell back to the default language (S002). */
-    translationProblems(): Problem[];
-    /**
-     * The keys a text on screen came from: the keys whose display text is
-     * exactly `text` when there are any, else the keys whose display text
-     * contains it (a word of a split line, a line being typed), and then only
-     * for a text with at least `KEY_PART_MIN` letters or digits. A comma or a
-     * single digit is in many messages and came from none of them: naming a
-     * key for it would send its reader to the wrong line. Spaces do not
-     * count: a block's text is its text nodes joined with a space, which a
-     * line drawn as several spans did not have between them.
-     */
-    keysShowing(text: string): string[];
-    /** The messages file of this language, for problem locations. */
-    get file(): string;
-}
-//# sourceMappingURL=reads.d.ts.map