@hyperframes/core 0.7.14 → 0.7.15

package/dist/studio-api/types.d.ts

@@ -1,120 +0,0 @@
-import type { CanvasResolution } from "../core.types.js";
-import type { RegistryItem } from "../registry/types.js";
-/** Resolved info about a single project. */
-export interface ResolvedProject {
-    id: string;
-    dir: string;
-    title?: string;
-    sessionId?: string;
-}
-/** Observable render job state, polled by the SSE progress handler. */
-export interface RenderJobState {
-    id: string;
-    status: "rendering" | "complete" | "failed";
-    progress: number;
-    stage?: string;
-    outputPath: string;
-    error?: string;
-}
-/** Lint result from the core linter. */
-export interface LintResult {
-    findings: Array<{
-        severity: string;
-        message: string;
-        file?: string;
-        fixHint?: string;
-    }>;
-}
-/**
- * Adapter interface — injected by each consumer to handle host-specific behavior.
- * The shared API module calls these methods; each host (vite dev, CLI embedded)
- * provides its own implementation.
- */
-export interface StudioApiAdapter {
-    /** List all available projects. */
-    listProjects(): Promise<ResolvedProject[]> | ResolvedProject[];
-    /** Resolve a project ID (or session ID) to its directory. Returns null if not found. */
-    resolveProject(id: string): Promise<ResolvedProject | null> | ResolvedProject | null;
-    /** Bundle a project directory into a single HTML string. Returns null if unavailable. */
-    bundle(projectDir: string): Promise<string | null>;
-    /** Optional: cached signature for project files that should invalidate preview frame caches. */
-    getProjectSignature?: (projectDir: string) => string;
-    /** Lint a single HTML string. */
-    lint(html: string, opts?: {
-        filePath?: string;
-    }): Promise<LintResult> | LintResult;
-    /** URL to the hyperframe runtime JS (injected into preview HTML). */
-    runtimeUrl: string;
-    /**
-     * Optional: post-process preview HTML before Studio augments it.
-     * Useful when preview must mirror render-time compilation steps.
-     */
-    transformPreviewHtml?: (opts: {
-        html: string;
-        project: ResolvedProject;
-        activeCompositionPath: string;
-    }) => Promise<string> | string;
-    /** Directory where render output files are stored. */
-    rendersDir(project: ResolvedProject): string;
-    /**
-     * Start a render job. The adapter owns the async execution and must
-     * update the returned RenderJobState object reactively.
-     */
-    startRender(opts: {
-        project: ResolvedProject;
-        outputPath: string;
-        format: "mp4" | "webm" | "mov";
-        /**
-         * Frame rate as an exact rational. The HTTP layer (POST
-         * `/projects/:id/render`) accepts either a JSON number (integer fps,
-         * `30`) or a JSON string (ffmpeg-style rational, `"30000/1001"`); the
-         * route normalizes both into `Fps` before invoking the adapter, so
-         * adapter implementations only ever see the rational form.
-         */
-        fps: import("../core.types.js").Fps;
-        quality: string;
-        jobId: string;
-        /**
-         * Optional output resolution preset. See `resolveDeviceScaleFactor` in
-         * the producer for the integer-scale + aspect + HDR constraints.
-         */
-        outputResolution?: CanvasResolution;
-        /** Entry file relative to projectDir (e.g. "compositions/intro.html"). Defaults to index.html. */
-        composition?: string;
-        /**
-         * Telemetry id of the browser user who triggered the render. Lets the
-         * adapter attribute the server-emitted render_complete/render_error to
-         * that user so the studio render funnel is joinable. Undefined for older
-         * clients → falls back to the install's anonymous id.
-         */
-        distinctId?: string;
-    }): RenderJobState;
-    /** Optional: generate a JPEG thumbnail via Puppeteer or similar. */
-    generateThumbnail?: (opts: {
-        project: ResolvedProject;
-        compPath: string;
-        seekTime: number;
-        width: number;
-        height: number;
-        previewUrl: string;
-        selector?: string;
-        format?: "jpeg" | "png";
-        selectorIndex?: number;
-    }) => Promise<Buffer | null>;
-    /** Optional: resolve session ID to project (multi-project mode). */
-    resolveSession?: (sessionId: string) => Promise<{
-        projectId: string;
-        title: string;
-    } | null>;
-    /** Optional: list all registry items (blocks + components) for the catalog. */
-    listRegistryCatalog?(): Promise<RegistryItem[]>;
-    /** Optional: install a registry item into a project directory. */
-    installRegistryBlock?(opts: {
-        project: ResolvedProject;
-        blockName: string;
-    }): Promise<{
-        written: string[];
-        block: RegistryItem;
-    }>;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/studio-api/types.d.ts.map

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

package/dist/studio-api/types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=types.js.map

package/dist/studio-api/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/studio-api/types.ts"],"names":[],"mappings":""}