@smoove/studio 0.1.1

package/dist/types.d.ts

@@ -0,0 +1,112 @@
+import type { Composition, ReadonlySignal } from "@smoove/core";
+import type { IconName } from "./components/icon/paths.js";
+import type { LayerKind } from "./lib/constants.js";
+import type { SmooveSchema } from "./schema/types.js";
+/** A signal you can both read and write. The store owns the writable side and
+    pushes form edits onto the composition via `comp.setProps`. */
+export interface WritableSignal<T> extends ReadonlySignal<T> {
+    set(value: T): void;
+}
+export type PropsSignal<P = Record<string, unknown>> = WritableSignal<P>;
+/** A timeline track derived from (or declared for) a composition. */
+export type StudioLayer = {
+    name: string;
+    kind: LayerKind;
+    /** Normalized [0,1] bounds across the composition duration. */
+    start: number;
+    end: number;
+};
+/** The composition for an entry: a ready instance, or a (lazy / code-split)
+    loader resolving to one. A loader may resolve to a module namespace whose
+    `default` export is the Composition — the registry unwraps it.
+
+    Typed against `Composition<any>` on purpose: the registry is props-shape
+    agnostic, and `Composition<P>` is invariant in `P` (via `setProps`), so a
+    concretely-typed `Composition<MyProps>` would not otherwise be assignable. */
+type AnyComposition = Composition<any>;
+export type CompositionInput = AnyComposition | (() => AnyComposition | Promise<AnyComposition> | Promise<{
+    default: AnyComposition;
+}>);
+export interface RegistryEntry<P extends Record<string, unknown> = Record<string, unknown>> {
+    /** REQUIRED — the stable key shared by catalog + route segment (`/:id`). */
+    id: string;
+    title?: string;
+    group?: string;
+    tags?: string[];
+    description?: string;
+    /** Drives the auto-generated props form. */
+    propsSchema?: SmooveSchema;
+    /** Overrides deep-merged over the schema defaults. */
+    defaultProps?: P;
+    /** Explicit layer override; otherwise layers are derived from the comp. */
+    layers?: StudioLayer[];
+    /** The Composition (default-exported), or a lazy loader resolving to one.
+        Props live on the comp's `props` signal — set via `comp.setProps`. */
+    composition: CompositionInput;
+}
+export type Registry = {
+    /** Lightweight catalog rows — id + metadata, no compositions built. */
+    entries(): RegistryEntry[];
+    /** Resolve (memoized) the composition for an id. */
+    load(id: string): Promise<Composition>;
+    /** The already-loaded instance for an id, if any (sync). */
+    peek(id: string): Composition | undefined;
+    /** Swap an entry's composition + drop its cached instance, then notify
+        listeners. Used for dev hot-reload of composition source. */
+    update(id: string, composition: CompositionInput): void;
+    /** Subscribe to entry changes (id passed to listener). Returns unsubscribe. */
+    onChange(listener: (id: string) => void): () => void;
+};
+export type RenderKind = "video" | "still";
+export type RenderStatus = "queued" | "rendering" | "done" | "canceled" | "error";
+export type RenderRequest = {
+    /** Composition id in the registry (= route segment). */
+    id: string;
+    kind: RenderKind;
+    /** Display title for the queue row. */
+    comp: string;
+    props?: Record<string, unknown>;
+    format: string;
+    quality: string;
+    w: number;
+    h: number;
+    fps: number;
+    frames: number;
+    rangeLabel: string;
+    sizeEst: number;
+    frameNo?: number;
+    /** Absolute composition frame range for a partial (region) render. When
+        omitted the whole composition is rendered. `to` is inclusive. */
+    from?: number;
+    to?: number;
+};
+export type RenderJob = RenderRequest & {
+    /** Unique per queued job (distinct from the composition `id`). */
+    jobId: string;
+    status: RenderStatus;
+    progress: number;
+    createdAt: number;
+    result?: string;
+    error?: string;
+};
+/**
+ * The transport contract the studio is given via `<Studio render={...}>`. The
+ * package ships none — a host wires this to an in-process call, SSE, polling, a
+ * websocket, or (here) a client-side mock. The store hands the queued job and an
+ * `onUpdate(patch)` callback that pushes progress into the store; the resolved
+ * patch (if any) is applied as the final state.
+ */
+export interface RenderBackend {
+    start(job: RenderJob, onUpdate: (patch: Partial<RenderJob>) => void): Promise<Partial<RenderJob> | undefined>;
+    /** Optional — cancel an in-flight job. */
+    cancel?(jobId: string): void;
+    /** Optional — fetch/download a finished result. */
+    download?(job: RenderJob): void;
+}
+export type Toast = {
+    id: string;
+    title: string;
+    icon?: IconName;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@smoove/studio",
+  "version": "0.1.1",
+  "description": "Composable React studio UI for smoove compositions — catalog, stage, timeline, props form, render dialogs.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/smoove-dev/smoove.git",
+    "directory": "packages/studio"
+  },
+  "homepage": "https://smoove.dev",
+  "bugs": "https://github.com/smoove-dev/smoove/issues",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js"
+    },
+    "./styles.css": "./dist/styles/studio.css"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@base-ui/react": "^1.5.0",
+    "signal-polyfill": "^0.2.2"
+  },
+  "peerDependencies": {
+    "konva": ">=10",
+    "react": ">=18",
+    "react-dom": ">=18",
+    "@smoove/core": "^0.1.1",
+    "@smoove/renderer": "^0.1.1",
+    "@smoove/player": "^0.1.1"
+  },
+  "peerDependenciesMeta": {
+    "@smoove/renderer": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@tailwindcss/cli": "^4.3.0",
+    "@types/node": "^22.10.0",
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
+    "concurrently": "^9.1.0",
+    "tailwindcss": "^4.3.0",
+    "@smoove/renderer": "0.1.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -b && pnpm run build:css",
+    "build:css": "tailwindcss -i ./src/studio.css -o ./dist/styles/studio.css --minify",
+    "dev": "concurrently -k \"tsc -b --watch --preserveWatchOutput\" \"tailwindcss -i ./src/studio.css -o ./dist/styles/studio.css --watch\"",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}