allyhub 0.7.0 → 0.8.0

package/dist/node_modules/@allyhub/video-core/dist/media.d.ts

@@ -0,0 +1,226 @@
+import type { MediaGen } from "./gen.js";
+import type { Box } from "./problem.js";
+import type { Envelope, UnheardSound } from "./voice.js";
+export type MediaKind = "image" | "audio" | "video" | "font"
+/** A 3D model and its parts: glTF, GLB, a glTF's buffers, KTX2 textures. */
+ | "model"
+/** A 3D scenery's environment: HDR and EXR pictures. */
+ | "environment";
+export interface Word {
+    text: string;
+    start: number;
+    end: number;
+    /**
+     * How sure the recognizer was of the word, 0 to 1: the lowest
+     * probability it gave any of the word's letter tokens (`allyhub
+     * transcribe` with Parakeet: greedy decoding's token log probability,
+     * exponentiated). Absent when the recognizer gave none, or the file was
+     * written another way.
+     */
+    confidence?: number;
+}
+export interface MediaInfo {
+    /** Path in the project, relative to the project root. */
+    path: string;
+    sha256: string;
+    kind: MediaKind;
+    /** Where the stage loads it; valid only at run time. */
+    url: string;
+    bytes?: number;
+    width?: number;
+    height?: number;
+    /** Seconds (audio, video). */
+    duration?: number;
+    /** Video: whether it has a sound stream (ffprobe). */
+    audio?: boolean;
+    /** Audio and video: word times from the sibling `<name>.words.json` (a take). */
+    words?: Word[];
+    /** Image: element boxes from the sibling `<name>.elements.json` (a page screenshot). */
+    elements?: Record<string, Box>;
+    /** Audio: integrated loudness (LUFS), measured when mixing. */
+    loudness?: number;
+    /**
+     * How `loudness` was measured: "integrated" (BS.1770, gated), or
+     * "level", the K-weighted level over the whole file, for a sound too
+     * short for one 0.4 s block or all under the gate (a click). Absent:
+     * integrated.
+     */
+    loudnessBy?: "integrated" | "level";
+    /**
+     * Audio without words (music): its tempo, measured by the build from
+     * its onsets (`@allyhub/analysis` beats): beats per minute, how steady
+     * the beat is (0–1), and the first beat in seconds. Absent when the
+     * file has no steady tempo or could not be measured.
+     */
+    tempo?: {
+        bpm: number;
+        confidence: number;
+        beat: number;
+    };
+    /**
+     * Video: the rotation its display matrix asks for (90, 180 or 270,
+     * clockwise); `width` and `height` are already the displayed ones.
+     */
+    rotation?: number;
+    /** Video: its faces over time, and the default speaker (the media index's face track). */
+    faces?: FaceTrack;
+    /** Video: a person matte is in the media index. */
+    matte?: boolean;
+    /**
+     * A take (audio or video with words): its level every 10 ms, which cut
+     * points snap to (voice.ts), measured by the build and kept in the media
+     * index.
+     */
+    envelope?: Envelope;
+    /** A take: the median level of its words, dBFS. */
+    speechDb?: number;
+    /** A take: what is heard between its words (voice.ts), reported, never removed on its own. */
+    sounds?: UnheardSound[];
+    /**
+     * The file's provenance, from the `<file>.gen.json` beside it (gen.ts):
+     * the tool that generated it, when, from what input. Absent without a
+     * readable record.
+     */
+    gen?: MediaGen;
+    /** A `<file>.gen.json` beside it that could not be read, and why. */
+    genUnread?: {
+        record: string;
+        error: string;
+    };
+    /** A glTF or GLB (kind "model"): what it holds, measured by the build. */
+    model?: ModelInfo;
+    /**
+     * Video: where the stage loads that matte, when its host serves it (the
+     * preview draws the speaker cut out with it); valid only at run time.
+     */
+    matteUrl?: string;
+    /**
+     * Audio and video: where the stage loads the sound denoised and sped
+     * like a take's denoise() and speed(), or filtered like a stem's filter, in the render, with
+     * `?db=<reduction>`, `&speed=<times>` and `&filter=<chain>` appended (any of them), when
+     * its host makes it (the preview); valid only at run time.
+     */
+    denoisedUrl?: string;
+}
+/**
+ * A media value turned into a string is its `url`, so `img.src = logo`
+ * and `` `url(${logo})` `` draw the file. The method is not enumerable:
+ * the value's JSON, its spread copies and the digests stay as they were.
+ * Returns the value itself.
+ */
+export declare function asUrlString<T extends {
+    url: string;
+}>(value: T): T;
+/** Where the media index keeps what it learnt about a file, from the project root. */
+export declare const INDEX_DIR = ".allyhub/cache/index";
+/** A file of a media file's index entry: `.allyhub/cache/index/<sha256>/<name>`. */
+export declare function indexPath(sha256: string, name: string): string;
+export type { FaceSample, FaceTrack, TrackedFace } from "@allyhub/formats";
+import type { FaceTrack } from "@allyhub/formats";
+type FaceBox = [number, number, number, number];
+/**
+ * The box of face `id` (default: the track's speaker) at t, linear
+ * between samples; undefined outside its samples, or when the track has
+ * no such face.
+ */
+export declare function faceAt(track: FaceTrack, t: number, id?: number | undefined): FaceBox | undefined;
+/** Every face of a track at t, with its id, in id order. */
+export declare function facesAt(track: FaceTrack, t: number): {
+    id: number;
+    box: FaceBox;
+}[];
+/** Whether a track has a face with this id. */
+export declare function hasFace(track: FaceTrack, id: number): boolean;
+/** The media kind of a path, by its extension; undefined when not media. */
+export declare function mediaKindOf(path: string): MediaKind | undefined;
+/** Every media extension, without the dot. */
+export declare const MEDIA_EXTENSIONS: readonly string[];
+/**
+ * Joins a path relative to a file in the project: ("a/b/film.ts", "./vo/en.mp3")
+ * → "a/b/vo/en.mp3". Undefined when it leaves the project.
+ */
+export declare function repoPath(fromFile: string, spec: string): string | undefined;
+/**
+ * Joins a path written in a folder of the project ("" its root), as the
+ * SDK records where a spec was written: ("a/b", "./vo/en.mp3") →
+ * "a/b/vo/en.mp3". Undefined when it leaves the project.
+ */
+export declare function pathIn(folder: string, spec: string): string | undefined;
+/**
+ * A glTF or GLB as the build measures it (docs/design/3d-worlds.md §4.6),
+ * in two steps: its own description (the JSON: extensions, named nodes,
+ * the files it names), which never fails; then its contents through
+ * glTF-Transform (bounds, counts, materials, textures, animations), which
+ * says why when it cannot read them. glTF and three.js are Y up, in metres.
+ */
+export interface ModelInfo {
+    container: "glb" | "gltf";
+    /** asset.generator: what wrote it. */
+    generator?: string;
+    /** asset.copyright. */
+    copyright?: string;
+    /** It carries rights metadata (KHR_xmp_json_ld). */
+    rights?: boolean;
+    extensionsUsed: string[];
+    extensionsRequired: string[];
+    /** Required extensions no lent decoder reads: three.js cannot load it (AK-W003). */
+    unsupported: string[];
+    /** Files it names that are not there, as project paths. */
+    missing: string[];
+    /** Its named nodes, with their paths from its root: what `getObjectByName` takes. */
+    nodes: {
+        name: string;
+        path: string;
+    }[];
+    /** Its default scene's box, metres, and its largest side. */
+    bounds?: {
+        min: [number, number, number];
+        max: [number, number, number];
+        size: [number, number, number];
+        largest: number;
+    };
+    counts?: {
+        nodes: number;
+        meshes: number;
+        primitives: number;
+        triangles: number;
+        instances: number;
+    };
+    materials?: {
+        name: string;
+        extensions: string[];
+    }[];
+    textures?: {
+        name: string;
+        mimeType: string;
+        width?: number;
+        height?: number;
+        bytes: number;
+        gpuBytes?: number;
+    }[];
+    animations?: {
+        name: string;
+        duration: number;
+        channels: number;
+    }[];
+    skins: number;
+    morphTargets: number;
+    cameras: number;
+    lights: number;
+    /** glTF-Validator's counts by severity, and its first messages. */
+    validator?: {
+        errors: number;
+        warnings: number;
+        infos: number;
+        hints: number;
+        messages: {
+            code: string;
+            severity: number;
+            message: string;
+            pointer?: string;
+        }[];
+    };
+    /** Why the contents (bounds, counts, materials, textures, animations) were not measured. */
+    contentsMissing?: string;
+}
+//# sourceMappingURL=media.d.ts.map

package/dist/node_modules/@allyhub/video-core/dist/media.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{CACHE_DIR as m}from"@allyhub/formats";export function asUrlString(e){return Object.prototype.hasOwnProperty.call(e,"toString")||Object.defineProperty(e,"toString",{value(){return this.url},enumerable:!1,configurable:!0,writable:!0}),e}export const INDEX_DIR=`${m}/index`;export function indexPath(e,n){return`${INDEX_DIR}/${e}/${n}`}function c(e,n,t){const o=e[0],i=e.at(-1);if(!o||!i)return;const s=1/Math.max(1,n);if(t<o.t-s||t>i.t+s)return;if(t<=o.t)return o.box;if(t>=i.t)return i.box;let a=0,u=e.length-1;for(;u-a>1;){const r=a+u>>1;(e[r]?.t??0)<=t?a=r:u=r}const f=e[a]??o,d=e[u]??i,l=d.t===f.t?0:(t-f.t)/(d.t-f.t);return[0,1,2,3].map(r=>(f.box[r]??0)+((d.box[r]??0)-(f.box[r]??0))*l)}export function faceAt(e,n,t=e.speaker){if(t===void 0)return;const o=e.faces.find(i=>i.id===t);return o?c(o.samples,e.fps,n):void 0}export function facesAt(e,n){return e.faces.flatMap(t=>{const o=c(t.samples,e.fps,n);return o?[{id:t.id,box:o}]:[]})}export function hasFace(e,n){return e.faces.some(t=>t.id===n)}const p={png:"image",jpg:"image",jpeg:"image",webp:"image",gif:"image",svg:"image",avif:"image",mp3:"audio",wav:"audio",m4a:"audio",ogg:"audio",aac:"audio",flac:"audio",mp4:"video",webm:"video",mov:"video",m4v:"video",qt:"video",woff2:"font",woff:"font",ttf:"font",otf:"font",glb:"model",gltf:"model",bin:"model",ktx2:"model",hdr:"environment",exr:"environment"};export function mediaKindOf(e){const n=/\.([A-Za-z0-9]+)$/.exec(e)?.[1]?.toLowerCase();return n===void 0?void 0:p[n]}export const MEDIA_EXTENSIONS=Object.keys(p);export function repoPath(e,n){return pathIn(e.split("/").slice(0,-1).join("/"),n)}export function pathIn(e,n){const t=n.startsWith("/")||e===""?[]:e.split("/");for(const o of n.split("/"))if(!(o==="."||o===""))if(o===".."){if(t.length===0)return;t.pop()}else t.push(o);return t.join("/")}