egaki 0.6.0 → 0.7.1

package/dist/vite/store.test.js

@@ -0,0 +1,172 @@
+/**
+ * Tests for the centralized egaki client store.
+ * Pure state transitions — no React, no mocks, just data in and data out.
+ */
+import { describe, test, expect, beforeEach } from 'vitest';
+import { egakiStore, selectMediaDurations, selectGenerationStatus, } from "./store.js";
+import { reportSectionDuration, clearSectionDuration, resetSectionDurations, } from "./media-duration-store.js";
+beforeEach(() => {
+    egakiStore.setState({
+        modules: {},
+        sectionReports: new Map(),
+        serverGenerationStatus: null,
+        serverGenerationEntries: [],
+        serverGenerationErrors: [],
+    });
+});
+// ---------------------------------------------------------------------------
+// Modules
+// ---------------------------------------------------------------------------
+describe('modules', () => {
+    test('setState updates modules', () => {
+        const mods = { './foo.tsx': { default: () => null } };
+        egakiStore.setState({ modules: mods });
+        expect(egakiStore.getState().modules).toBe(mods);
+    });
+    test('setState replaces previous modules', () => {
+        egakiStore.setState({ modules: { './a.tsx': { default: 1 } } });
+        const next = { './b.tsx': { default: 2 } };
+        egakiStore.setState({ modules: next });
+        expect(egakiStore.getState().modules).toBe(next);
+        expect(egakiStore.getState().modules['./a.tsx']).toBeUndefined();
+    });
+});
+// ---------------------------------------------------------------------------
+// Section duration reports
+// ---------------------------------------------------------------------------
+describe('sectionReports', () => {
+    test('reportSectionDuration adds a report', () => {
+        reportSectionDuration(0, 'inst-1', 5.5);
+        const durations = selectMediaDurations(egakiStore.getState());
+        expect(durations).toMatchInlineSnapshot(`
+      {
+        "0": 5.5,
+      }
+    `);
+    });
+    test('per-section max is derived from multiple instances', () => {
+        reportSectionDuration(0, 'inst-1', 3);
+        reportSectionDuration(0, 'inst-2', 7);
+        reportSectionDuration(0, 'inst-3', 5);
+        const durations = selectMediaDurations(egakiStore.getState());
+        expect(durations['0']).toBe(7);
+    });
+    test('multiple sections tracked independently', () => {
+        reportSectionDuration(0, 'a', 2);
+        reportSectionDuration(1, 'b', 4);
+        reportSectionDuration(2, 'c', 6);
+        const durations = selectMediaDurations(egakiStore.getState());
+        expect(durations).toMatchInlineSnapshot(`
+      {
+        "0": 2,
+        "1": 4,
+        "2": 6,
+      }
+    `);
+    });
+    test('duplicate report with same value is a no-op', () => {
+        reportSectionDuration(0, 'inst-1', 5);
+        const before = egakiStore.getState().sectionReports;
+        reportSectionDuration(0, 'inst-1', 5);
+        expect(egakiStore.getState().sectionReports).toBe(before);
+    });
+    test('clearSectionDuration removes an instance report', () => {
+        reportSectionDuration(0, 'a', 3);
+        reportSectionDuration(0, 'b', 7);
+        clearSectionDuration(0, 'b');
+        const durations = selectMediaDurations(egakiStore.getState());
+        expect(durations['0']).toBe(3);
+    });
+    test('clearSectionDuration removes section entry when last instance clears', () => {
+        reportSectionDuration(0, 'a', 3);
+        clearSectionDuration(0, 'a');
+        const durations = selectMediaDurations(egakiStore.getState());
+        expect(durations).toMatchInlineSnapshot(`{}`);
+    });
+    test('clearSectionDuration is a no-op for missing instance', () => {
+        reportSectionDuration(0, 'a', 3);
+        const before = egakiStore.getState().sectionReports;
+        clearSectionDuration(0, 'nonexistent');
+        expect(egakiStore.getState().sectionReports).toBe(before);
+    });
+    test('resetSectionDurations clears all reports', () => {
+        reportSectionDuration(0, 'a', 3);
+        reportSectionDuration(1, 'b', 5);
+        resetSectionDurations();
+        expect(egakiStore.getState().sectionReports.size).toBe(0);
+        expect(selectMediaDurations(egakiStore.getState())).toMatchInlineSnapshot(`{}`);
+    });
+    test('resetSectionDurations is a no-op when already empty', () => {
+        const before = egakiStore.getState().sectionReports;
+        resetSectionDurations();
+        expect(egakiStore.getState().sectionReports).toBe(before);
+    });
+    test('ignores invalid inputs', () => {
+        reportSectionDuration(-1, 'a', 5);
+        reportSectionDuration(0, 'a', NaN);
+        reportSectionDuration(0, 'a', 0);
+        reportSectionDuration(0, 'a', -1);
+        expect(egakiStore.getState().sectionReports.size).toBe(0);
+    });
+});
+// ---------------------------------------------------------------------------
+// Generation status (server-driven)
+// ---------------------------------------------------------------------------
+describe('serverGenerationStatus', () => {
+    test('setState tracks server generation status', () => {
+        egakiStore.setState({
+            serverGenerationStatus: { counts: { image: 1 }, total: 1 },
+        });
+        const status = selectGenerationStatus(egakiStore.getState());
+        expect(status).toMatchInlineSnapshot(`
+      {
+        "counts": {
+          "image": 1,
+        },
+        "total": 1,
+      }
+    `);
+    });
+    test('multiple generation types counted separately', () => {
+        egakiStore.setState({
+            serverGenerationStatus: { counts: { image: 2, video: 1, audio: 1 }, total: 4 },
+        });
+        const status = selectGenerationStatus(egakiStore.getState());
+        expect(status).toMatchInlineSnapshot(`
+      {
+        "counts": {
+          "audio": 1,
+          "image": 2,
+          "video": 1,
+        },
+        "total": 4,
+      }
+    `);
+    });
+    test('setting status to null clears generation tracking', () => {
+        egakiStore.setState({
+            serverGenerationStatus: { counts: { image: 1 }, total: 1 },
+        });
+        egakiStore.setState({ serverGenerationStatus: null });
+        const status = selectGenerationStatus(egakiStore.getState());
+        expect(status).toBeNull();
+    });
+    test('returns null when no generations active', () => {
+        expect(selectGenerationStatus(egakiStore.getState())).toBeNull();
+    });
+    test('tracks any namespace', () => {
+        egakiStore.setState({
+            serverGenerationStatus: { counts: { audio: 1, transcription: 2 }, total: 3 },
+        });
+        const status = selectGenerationStatus(egakiStore.getState());
+        expect(status).toMatchInlineSnapshot(`
+      {
+        "counts": {
+          "audio": 1,
+          "transcription": 2,
+        },
+        "total": 3,
+      }
+    `);
+    });
+});

package/dist/vite/tweakpane-hook.d.ts

@@ -0,0 +1,94 @@
+import type { PlayerRef } from '@remotion/player';
+/** Slider config: value + optional min/max/step. */
+interface SliderParam {
+    value: number;
+    min?: number;
+    max?: number;
+    step?: number;
+}
+/** Select/dropdown config: value + options list. */
+interface SelectParam {
+    value: string;
+    options: string[];
+}
+/** Cubic bezier config: four control points [x1, y1, x2, y2]. */
+export interface CubicBezierParam {
+    type: 'cubicBezier';
+    value: [number, number, number, number];
+}
+/** Range config: min/max pair displayed as a single range slider (plugin-essentials). */
+interface RangeParam {
+    type: 'range';
+    value: {
+        min: number;
+        max: number;
+    };
+    min: number;
+    max: number;
+    step?: number;
+}
+/**
+ * A param value is either:
+ * - a bare primitive (number, boolean, string) — auto-inferred control
+ * - a SliderParam object with explicit range
+ * - a SelectParam object with a dropdown of string options
+ * - a CubicBezierParam for a visual bezier curve editor
+ * - a RangeParam for a min/max range slider (plugin-essentials)
+ */
+type ParamValue = number | boolean | string | SliderParam | SelectParam | CubicBezierParam | RangeParam;
+type ParamSchema = Record<string, ParamValue>;
+/** Resolved values: SliderParam becomes number, SelectParam becomes string, CubicBezierParam becomes tuple, RangeParam becomes {min, max}, everything else stays. */
+type ResolvedValues<T extends ParamSchema> = {
+    [K in keyof T]: T[K] extends SliderParam ? number : T[K] extends SelectParam ? string : T[K] extends CubicBezierParam ? [number, number, number, number] : T[K] extends RangeParam ? {
+        min: number;
+        max: number;
+    } : T[K] extends number ? number : T[K] extends boolean ? boolean : T[K] extends string ? string : T[K];
+};
+export interface TweakpaneContextValue {
+    playerRef: React.RefObject<PlayerRef | null>;
+    fps: number;
+    sections: {
+        heading: string | null;
+        durationInFrames: number;
+    }[];
+    entryPath: string;
+}
+export declare const TweakpaneContext: import("react").Context<TweakpaneContextValue | null>;
+/**
+ * Set to `true` to completely disable tweakpane across all components.
+ * useTweakpane() will return raw default values without mounting any UI.
+ */
+export declare let TWEAKPANE_DISABLED: boolean;
+/**
+ * Register a folder of tweakable parameters for the current component.
+ *
+ * @param label  Folder title shown in the pane UI. Also set as
+ *               `data-tweakpane="label"` on a wrapper div for agent inspection.
+ * @param schema Parameter definitions. Each key maps to either:
+ *   - a bare `number`, `boolean`, or `string` (auto-inferred control)
+ *   - a `{ value, min?, max?, step? }` object for explicit slider range
+ *
+ * Returns a reactive object with current values. Updating a control in the
+ * pane immediately triggers a React re-render with fresh values.
+ *
+ * On unmount the folder is disposed and removed from the pane.
+ */
+export declare function useTweakpane<T extends ParamSchema>(label: string, schema: T): ResolvedValues<T>;
+/** Sidebar width constant shared with player-page layout. */
+export declare const SIDEBAR_WIDTH = 280;
+/**
+ * Right sidebar that hosts the tweakpane Pane. Always visible in the page
+ * layout; the Pane mounts into the scrollable inner div. Also provides
+ * player metadata (frame, fps, sections) to the copy prompt button.
+ */
+export declare function TweakpaneRoot({ playerRef, fps, sections, entryPath, }: {
+    playerRef: React.RefObject<PlayerRef | null>;
+    fps: number;
+    sections: {
+        heading: string | null;
+        durationInFrames: number;
+    }[];
+    entryPath: string;
+}): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=tweakpane-hook.d.ts.map

package/dist/vite/tweakpane-hook.d.ts.map

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