@liqvid/studio 1.0.0-alpha.0

package/dist/types/providers/social/instagram.d.mts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+import type { SocialProvider } from "../types.mts";
+export declare const ProviderConfigInstagram: z.ZodObject<{
+    username: z.ZodString;
+}, z.core.$strip>;
+export type ProviderConfigInstagram = z.infer<typeof ProviderConfigInstagram>;
+export declare class InstagramProvider implements SocialProvider {
+    constructor(_options: ProviderConfigInstagram);
+    publish(): Promise<void>;
+}

package/dist/types/providers/social/twitter.d.mts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+import type { SocialProvider } from "../types.mts";
+export declare const ProviderConfigTwitter: z.ZodObject<{
+    username: z.ZodString;
+}, z.core.$strip>;
+export type ProviderConfigTwitter = z.infer<typeof ProviderConfigTwitter>;
+export declare class TwitterProvider implements SocialProvider {
+    publish(): Promise<void>;
+}

package/dist/types/providers/social/youtube.d.mts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+import type { SocialProvider } from "../types.mts";
+export declare const ProviderConfigYouTube: z.ZodObject<{
+    username: z.ZodString;
+}, z.core.$strip>;
+export type ProviderConfigYouTube = z.infer<typeof ProviderConfigYouTube>;
+export declare class YouTubeProvider implements SocialProvider {
+    publish(): Promise<void>;
+}

package/dist/types/providers/types.d.mts

@@ -0,0 +1,9 @@
+export interface HostingProvider {
+    publishContent(localDir: string): Promise<void>;
+}
+export interface MediaHostingProvider extends HostingProvider {
+    publishMedia(localDir: string): Promise<void>;
+}
+export interface SocialProvider {
+    publish(): Promise<void>;
+}

package/dist/types/publish.d.mts

@@ -0,0 +1 @@
+export {};

package/dist/types/recording/RecordingControl.d.ts

@@ -0,0 +1,16 @@
+export interface RecordingControlProps {
+    shortcuts?: {
+        /** Shortcut to toggle the Recording panel */
+        toggle?: string;
+        /** Shortcut to discard recording */
+        discard?: string;
+        /** Shortcut to pause recording */
+        pause?: string;
+        /** Shortcut to start/stop recording */
+        startStop?: string;
+    };
+}
+/**
+ * Liqvid recording control.
+ */
+export declare function RecordingControl({ shortcuts }: RecordingControlProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/recording/RecordingDialog.d.ts

@@ -0,0 +1,10 @@
+import type { RecordingMeta } from "../schemas/recording-meta.mts";
+import type { RecordingControlProps } from "./RecordingControl";
+export interface RecordingDialogProps {
+    shortcuts?: RecordingControlProps["shortcuts"];
+    onShortcutChange?: (key: keyof NonNullable<RecordingControlProps["shortcuts"]>, value: string) => void;
+}
+export declare function RecordingDialog({ shortcuts, onShortcutChange, }: RecordingDialogProps): import("react/jsx-runtime").JSX.Element;
+export declare function RecordingRow({ recording: r }: {
+    recording: RecordingMeta;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/schemas/liqvid-config.d.mts

@@ -0,0 +1,51 @@
+import { z } from "zod";
+export declare const LiqvidConfig: z.ZodObject<{
+    $schema: z.ZodString;
+    backend: z.ZodObject<{
+        content: z.ZodEnum<{
+            githubPages: "githubPages";
+            liqvidStudio: "liqvidStudio";
+            s3: "s3";
+            sftp: "sftp";
+        }>;
+        media: z.ZodEnum<{
+            liqvidStudio: "liqvidStudio";
+            s3: "s3";
+            sftp: "sftp";
+        }>;
+    }, z.core.$strip>;
+    providers: z.ZodObject<{
+        bluesky: z.ZodOptional<z.ZodObject<{
+            username: z.ZodString;
+        }, z.core.$strip>>;
+        facebook: z.ZodOptional<z.ZodObject<{
+            username: z.ZodString;
+        }, z.core.$strip>>;
+        instagram: z.ZodOptional<z.ZodObject<{
+            username: z.ZodString;
+        }, z.core.$strip>>;
+        twitter: z.ZodOptional<z.ZodObject<{
+            username: z.ZodString;
+        }, z.core.$strip>>;
+        youtube: z.ZodOptional<z.ZodObject<{
+            username: z.ZodString;
+        }, z.core.$strip>>;
+        githubPages: z.ZodOptional<z.ZodObject<{
+            repository: z.ZodString;
+            root: z.ZodOptional<z.ZodBoolean>;
+            username: z.ZodString;
+        }, z.core.$strip>>;
+        liqvidStudio: z.ZodOptional<z.ZodObject<{
+            username: z.ZodString;
+        }, z.core.$strip>>;
+        s3: z.ZodOptional<z.ZodObject<{
+            bucket: z.ZodString;
+            prefix: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        sftp: z.ZodOptional<z.ZodObject<{
+            host: z.ZodString;
+            path: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type LiqvidConfig = z.infer<typeof LiqvidConfig>;

package/dist/types/schemas/project.d.mts

@@ -0,0 +1,51 @@
+import type { Duration } from "@liqvid/duration";
+import { z } from "zod";
+export declare const AspectRatio: z.ZodObject<{
+    height: z.ZodNumber;
+    width: z.ZodNumber;
+}, z.core.$strip>;
+export type AspectRatio = z.infer<typeof AspectRatio>;
+export declare const AspectRatioSpecifier: z.ZodUnion<readonly [z.ZodTemplateLiteral<`${number}:${number}`>, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodObject<{
+    height: z.ZodNumber;
+    width: z.ZodNumber;
+}, z.core.$strip>]>;
+export type AspectRatioSpecifier = z.infer<typeof AspectRatioSpecifier>;
+/**
+ * project.json files
+ */
+export declare const ProjectJson: z.ZodObject<{
+    aspectRatio: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodTemplateLiteral<`${number}:${number}`>, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodObject<{
+        height: z.ZodNumber;
+        width: z.ZodNumber;
+    }, z.core.$strip>]>>>;
+    name: z.ZodString;
+}, z.core.$strip>;
+export type ProjectJson = z.infer<typeof ProjectJson>;
+/**
+ * auto-generated project-meta.json files
+ */
+export declare const AutoGenProjectMeta: z.ZodObject<{
+    duration: z.ZodObject<{
+        d: z.ZodOptional<z.ZodNumber>;
+        days: z.ZodOptional<z.ZodNumber>;
+        h: z.ZodOptional<z.ZodNumber>;
+        hours: z.ZodOptional<z.ZodNumber>;
+        ms: z.ZodOptional<z.ZodNumber>;
+        milliseconds: z.ZodOptional<z.ZodNumber>;
+        m: z.ZodOptional<z.ZodNumber>;
+        minutes: z.ZodOptional<z.ZodNumber>;
+        s: z.ZodOptional<z.ZodNumber>;
+        seconds: z.ZodOptional<z.ZodNumber>;
+        w: z.ZodOptional<z.ZodNumber>;
+        weeks: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type AutoGenProjectMeta = z.infer<typeof AutoGenProjectMeta>;
+export interface ProjectMeta {
+    aspectRatio: AspectRatio;
+    duration: Duration;
+    name: string;
+    openGraph: boolean;
+    path: string;
+    twitter: boolean;
+}

package/dist/types/schemas/recording-meta.d.mts

@@ -0,0 +1,17 @@
+import { z } from "zod";
+export declare const RecordingMetaFile: z.ZodObject<{
+    created: z.ZodISODateTime;
+    duration: z.ZodObject<{
+        milliseconds: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type RecordingMetaFile = z.infer<typeof RecordingMetaFile>;
+export declare const RecordingMeta: z.ZodObject<{
+    created: z.ZodISODateTime;
+    duration: z.ZodObject<{
+        milliseconds: z.ZodNumber;
+    }, z.core.$strip>;
+    name: z.ZodString;
+    plugins: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type RecordingMeta = z.infer<typeof RecordingMeta>;

package/dist/types/types/assets.d.mts

@@ -0,0 +1,3 @@
+export interface Directory {
+    [key: string]: Directory | null;
+}

package/dist/types/types.d.mts

@@ -0,0 +1,20 @@
+import type { Directory } from "./types/assets.mts";
+export interface ProjectFile {
+    filename: string;
+    mime: string;
+    version?: string;
+}
+export type FileNames<D extends Directory> = {
+    [key in string & keyof D]: D[key] extends Directory ? `${key}/` | `${key}/${FileNames<D[key]>}` : key;
+}[string & keyof D];
+type Files<T extends string> = T extends `${string}/` ? never : T;
+type Dirs<T extends string> = T extends `${infer Head}/${infer Tail}` ? Head | `${Head}/${Dirs<Tail>}` : never;
+type StripPrefix<T extends string, S extends string> = T extends `${S}${infer Tail}` ? Tail : never;
+export declare class DirectoryHelper<DS extends string> {
+    private dirname;
+    constructor(dirname?: string);
+    dir<D extends Dirs<DS>>(dirname: D): DirectoryHelper<Exclude<StripPrefix<DS, `${D}/`>, "">>;
+    file(filename: Files<DS>, version?: string): string;
+}
+export type Awaitable<T> = T | Promise<T>;
+export {};

package/dist/types/ui/Dialog.d.ts

@@ -0,0 +1,31 @@
+import { Dialog } from "@base-ui/react/dialog";
+import type { ReactNode } from "react";
+interface DialogApi {
+    /** Close the dialog. */
+    close: () => unknown;
+    /** Whether we are actually contained in a dialog. */
+    isDialog: boolean;
+    /** Whether the dialog is currently open */
+    isOpen: boolean;
+}
+export declare function useDialogApi(): DialogApi;
+interface DialogRootProps {
+    children?: ReactNode;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    open?: boolean;
+}
+export declare function DialogRoot({ children, defaultOpen, onOpenChange, open: controlledOpen, }: DialogRootProps): import("react/jsx-runtime").JSX.Element;
+interface DialogCloseProps extends Omit<React.ComponentProps<typeof Dialog.Close>, "render"> {
+    asChild?: boolean;
+}
+export declare function DialogClose({ asChild, children, className, ...props }: DialogCloseProps): import("react/jsx-runtime").JSX.Element;
+export declare function DialogContent({ className, ...props }: React.ComponentProps<typeof Dialog.Popup>): import("react/jsx-runtime").JSX.Element;
+export declare function DialogPortal(props: React.ComponentProps<typeof Dialog.Portal>): import("react/jsx-runtime").JSX.Element;
+export declare function DialogOverlay({ className, ...props }: React.ComponentProps<typeof Dialog.Backdrop>): import("react/jsx-runtime").JSX.Element;
+export declare function DialogTitle({ className, ...props }: React.ComponentProps<typeof Dialog.Title>): import("react/jsx-runtime").JSX.Element;
+interface DialogTriggerProps extends Omit<React.ComponentProps<typeof Dialog.Trigger>, "render"> {
+    asChild?: boolean;
+}
+export declare function DialogTrigger({ asChild, children, className, ...props }: DialogTriggerProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/ui/DockableDialog.d.ts

@@ -0,0 +1,25 @@
+declare function Root({ children, name, shortcut, }: {
+    children?: React.ReactNode;
+    name?: string;
+    shortcut?: string;
+}): import("react/jsx-runtime").JSX.Element;
+declare function Trigger({ asChild, children, }: {
+    asChild?: boolean;
+    children?: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+declare function Content({ asChild, className, ...props }: {
+    asChild?: boolean;
+} & React.HTMLAttributes<HTMLElement>): import("react/jsx-runtime").JSX.Element;
+declare function Header({ asChild, className, ...props }: {
+    asChild?: boolean;
+} & React.HTMLAttributes<HTMLElement>): import("react/jsx-runtime").JSX.Element;
+declare function Dialog({ className, ...props }: React.HTMLAttributes<HTMLElement>): import("react/jsx-runtime").JSX.Element;
+export declare const DockableDialog: {
+    Content: typeof Content;
+    Dialog: typeof Dialog;
+    Header: typeof Header;
+    Portal: import("react").ForwardRefExoticComponent<import("@radix-ui/react-portal").PortalProps & import("react").RefAttributes<HTMLDivElement>>;
+    Root: typeof Root;
+    Trigger: typeof Trigger;
+};
+export {};

package/dist/types/ui/RadioTabs.d.ts

@@ -0,0 +1,18 @@
+import { Radio } from "@base-ui/react/radio";
+import type { Icon } from "@phosphor-icons/react";
+import type { ReactNode } from "react";
+interface RadioTabsProps<T extends string> {
+    children?: ReactNode;
+    className?: string;
+    onValueChange: (value: T) => void;
+    value: T;
+}
+declare function RadioTabs<T extends string>({ className, value, onValueChange, ...props }: RadioTabsProps<T>): import("react/jsx-runtime").JSX.Element;
+interface RadioTabsItemProps extends React.ComponentProps<typeof Radio.Root> {
+    /** Phosphor icon component to display in the tab */
+    icon: Icon;
+    /** Icon size (default: 18) */
+    iconSize?: number;
+}
+declare function RadioTabsItem({ className, icon: IconComponent, iconSize, title, value, ...props }: RadioTabsItemProps): import("react/jsx-runtime").JSX.Element;
+export { RadioTabs, RadioTabsItem };

package/dist/types/ui/Tabs.d.ts

@@ -0,0 +1,9 @@
+import { Tabs as TabsPrimitive } from "@base-ui/react/tabs";
+declare function Tabs({ className, ...props }: React.ComponentProps<typeof TabsPrimitive.Root>): import("react/jsx-runtime").JSX.Element;
+declare function TabsList({ className, ...props }: React.ComponentProps<typeof TabsPrimitive.List>): import("react/jsx-runtime").JSX.Element;
+declare function TabsTrigger({ className, ...props }: React.ComponentProps<typeof TabsPrimitive.Tab>): import("react/jsx-runtime").JSX.Element;
+interface TabsContentProps extends Omit<React.ComponentProps<typeof TabsPrimitive.Panel>, "render"> {
+    asChild?: boolean;
+}
+declare function TabsContent({ asChild, children, className, ...props }: TabsContentProps): import("react/jsx-runtime").JSX.Element;
+export { Tabs, TabsList, TabsTrigger, TabsContent };

package/dist/types/ui/Toast.d.ts

@@ -0,0 +1,23 @@
+import type { PluginContext } from "@liqvid/studio-plugin-api";
+export type ToastProps = Parameters<PluginContext["makeToast"]>[0] & {
+    className?: string;
+    ref?: React.Ref<HTMLElement>;
+};
+export type ToastPropsWithTime = ToastProps & {
+    time: number;
+};
+export declare function Toast({ className, message, ref, title, type: toastType, }: ToastProps): import("react/jsx-runtime").JSX.Element;
+interface AnimationConfig {
+    keyframes: Keyframe[] | PropertyIndexedKeyframes;
+    options: KeyframeAnimationOptions;
+}
+/**
+ * Animation for hiding a toast notification.
+ * @see {@link https://www.figma.com/file/zdML9fFY9V0Oah28S0Msd3?node-id=3384:30299#314140994 Figma discussion}
+ */
+export declare const hideToast: AnimationConfig;
+/**
+ * Animation for showing a toast notification.
+ */
+export declare const appearToast: AnimationConfig;
+export {};

package/dist/types/ui/Toaster.d.ts

@@ -0,0 +1,6 @@
+import { type ToastProps } from "./Toast.tsx";
+export declare function Toaster({ toasts, }: {
+    toasts: (ToastProps & {
+        time: number;
+    })[];
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/ui/test.d.ts

@@ -0,0 +1,9 @@
+interface DialogContext {
+    min: number;
+}
+declare const DialogContext: import("react").Context<DialogContext>;
+export declare function useDialog(): DialogContext;
+export declare function DialogProvider({ children }: {
+    children?: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/utils/dom.d.mts

@@ -0,0 +1,3 @@
+import type { Result } from "have-fun";
+import type { z } from "zod";
+export declare function fetchJson<T extends z.ZodType>(Model: T, input: RequestInfo | URL, init?: RequestInit): Promise<Result<z.core.output<T>, z.ZodError<z.core.output<T>> | SyntaxError>>;

package/dist/types/utils/fs.d.mts

@@ -0,0 +1,32 @@
+import { Maybe, type Result } from "have-fun";
+import type { z } from "zod";
+import type { Awaitable } from "../types.mts";
+export declare function loadJson<T extends z.ZodType>(Model: T, filename: string): Promise<Result<z.core.output<T>, z.ZodError<z.core.output<T>> | SyntaxError | NodeJS.ErrnoException>>;
+export declare function findUpwards(dirname: string, callback: (dir: string) => boolean | Promise<boolean>): Promise<string | null>;
+/** Callback to process a file */
+export type WalkingCallback = (file: {
+    basename: string;
+    dirname: string;
+    filename: string;
+}) => Awaitable<void>;
+/** Walk a directory recursively */
+export declare function walkDir(
+/** Directory to walk */
+dir: string, 
+/** Callback to run for each file */
+callback: WalkingCallback, 
+/** Callback to decide whether to descend into a directory */
+shouldProcessDir?: (dir: {
+    basename: string;
+    dirname: string;
+}) => Awaitable<boolean>): Promise<void>;
+/** Synchronously walk a directory recursively */
+export declare function walkDirSync(
+/** Directory to walk */
+dir: string, 
+/** Callback to call for each file */
+callback: (path: string) => void): void;
+/**
+ * Get the path to the Biome executable, if available
+ */
+export declare function getBiomePath(dirname: string): Promise<Maybe<string>>;

package/dist/types/utils/misc.d.mts

@@ -0,0 +1,4 @@
+/**
+ * Debounce function calls, grouped by a key.
+ */
+export declare function debounce(callback: () => void, key: string, debounceMs?: number): void;

package/dist/types/utils/react.d.mts

@@ -0,0 +1,5 @@
+export declare function useToggle(defaultValue?: boolean): {
+    set: React.Dispatch<React.SetStateAction<boolean>>;
+    toggle: () => void;
+    value: boolean;
+};

package/dist/types/utils/rsync.d.mts

@@ -0,0 +1,10 @@
+export interface RsyncOptions {
+    localDir: string;
+    remoteDir: string;
+    host: string;
+    username?: string;
+    password?: string;
+    port?: number;
+    recursive?: boolean;
+}
+export declare function rsyncRemoteDirectory(options: RsyncOptions): Promise<void>;

package/package.json

@@ -0,0 +1,94 @@
+{
+  "name": "@liqvid/studio",
+  "version": "1.0.0-alpha.0",
+  "description": "Production suite for Liqvid videos",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.mjs",
+      "types": "./dist/types/index.d.mts"
+    },
+    "./next/api": {
+      "import": "./dist/esm/next/api.mjs",
+      "types": "./dist/types/next/api.d.mts"
+    },
+    "./next/page": {
+      "import": "./dist/esm/next/page.js",
+      "types": "./dist/types/next/page.d.ts"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "*": [
+        "./dist/types/*.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "dist/*"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/liqvidjs/liqvid.git"
+  },
+  "author": "Yuri Sulyma <yuri@liqvidjs.org>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/liqvidjs/liqvid/issues"
+  },
+  "homepage": "https://github.com/liqvidjs/liqvid/tree/main/packages/studio#readme",
+  "dependencies": {
+    "@base-ui/react": "^1.2.0",
+    "@phosphor-icons/react": "^2.1.10",
+    "@radix-ui/react-portal": "1.1.10",
+    "chalk": "5.6.2",
+    "classnames": "^2.5.1",
+    "execa": "^9.6.1",
+    "handlebars": "^4.7.8",
+    "have-fun": "^0.0.2",
+    "http-status-codes": "^2.3.0",
+    "lodash.debounce": "^4.0.8",
+    "serve": "^14.2.6",
+    "zod": "4.1.13",
+    "@liqvid/duration": "^1.3.0",
+    "@liqvid/assets": "^1.0.0",
+    "@liqvid/color-scheme": "^1.0.0-alpha.0",
+    "@liqvid/cli": "^2.0.0-alpha.0",
+    "@liqvid/event-emitter": "^1.0.0-alpha.0",
+    "@liqvid/hydration": "^1.0.0-alpha.0",
+    "@liqvid/keymap": "^2.0.0-alpha.0",
+    "@liqvid/utils": "^2.0.0-alpha.0",
+    "@liqvid/studio-plugin-api": "^1.0.0-alpha.0",
+    "@liqvid/recording": "^1.0.0-alpha.0",
+    "@liqvid/ssr": "^0.0.2"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.4.4",
+    "@types/node": "^24",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "concurrently": "^9.2.1",
+    "next": "16.1.6",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "typescript": "^5.9"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "scripts": {
+    "build": "pnpm build:clean ; pnpm build:js ; pnpm build:hbs ; pnpm build:css ; pnpm build:postclean",
+    "build:clean": "rm -rf dist",
+    "build:css": "rsync --include='*.css' --include='*/' --exclude='*' --recursive ./src/ ./dist/esm",
+    "build:hbs": "cp -R templates dist",
+    "build:js": "tsc",
+    "build:postclean": "rm -f dist/tsconfig.tsbuildinfo",
+    "generate:schemas": "node --disable-warning=ExperimentalWarning --experimental-strip-types scripts/generate-schemas.mts",
+    "lint": "biome check --fix",
+    "watch": "concurrently \"pnpm watch:css\" \"pnpm watch:hbs\" \"pnpm watch:tsc\"",
+    "watch:css": "watch -n1 pnpm build:css",
+    "watch:hbs": "watch -n1 pnpm build:hbs",
+    "watch:tsc": "tsc --watch"
+  }
+}