@joycostudio/studio 0.1.3 → 0.1.4

package/dist/chunk-2RGQF5X5.js

@@ -0,0 +1,470 @@
+import {
+  error,
+  hasConfig,
+  validateConfig
+} from "./chunk-DEJYGBPJ.js";
+
+// src/client/studio.ts
+import {
+  button,
+  schemaValues
+} from "@joycostudio/xyz/debug";
+
+// src/core/diff.ts
+function diff(before, after, path = []) {
+  const nested = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+  if (nested(before) && nested(after)) {
+    const keys = /* @__PURE__ */ new Set([...Object.keys(before), ...Object.keys(after)]);
+    return [...keys].flatMap((key) => diff(before[key], after[key], [...path, key]));
+  }
+  return JSON.stringify(before) === JSON.stringify(after) ? [] : [{ path, before, after }];
+}
+function changedPaths(before, after) {
+  return diff(before, after).map(({ path }) => path.join("."));
+}
+
+// src/client/bridge.ts
+function connectBridge(url, handlers) {
+  let socket = null;
+  let nextId = 0;
+  let retry = 0;
+  let timer;
+  let closed = false;
+  const pending = /* @__PURE__ */ new Map();
+  const open = () => {
+    handlers.connection({ phase: "connecting" });
+    const ws = new WebSocket(url);
+    socket = ws;
+    ws.onopen = () => {
+      retry = 0;
+      handlers.connection({ phase: "connected" });
+    };
+    ws.onmessage = (event) => {
+      const message = JSON.parse(String(event.data));
+      if (message.type === "state") return handlers.state(message.state);
+      pending.get(message.id)?.(message.result);
+      pending.delete(message.id);
+    };
+    ws.onclose = () => {
+      socket = null;
+      for (const resolve of pending.values()) resolve(error("runtime_unavailable"));
+      pending.clear();
+      if (closed) return;
+      handlers.connection({ phase: "offline" });
+      timer = setTimeout(open, Math.min(500 * 2 ** retry++, 5e3));
+    };
+  };
+  open();
+  return {
+    request(op, params) {
+      if (socket?.readyState !== WebSocket.OPEN) return Promise.resolve(error("runtime_unavailable"));
+      const id = nextId++;
+      socket.send(JSON.stringify({ id, op, params }));
+      return new Promise((resolve) => pending.set(id, resolve));
+    },
+    close() {
+      closed = true;
+      clearTimeout(timer);
+      socket?.close();
+    }
+  };
+}
+
+// src/client/browser-sync.ts
+function connectBrowserSync(definition, runtime, handlers) {
+  if (typeof window === "undefined" || !window.location?.origin || !window.BroadcastChannel) return null;
+  let channel;
+  try {
+    channel = new window.BroadcastChannel(
+      JSON.stringify(["joyco-studio:config", runtime || null, definition.id, definition.file])
+    );
+  } catch {
+    return null;
+  }
+  const sender = crypto.getRandomValues(new Uint32Array(4)).join("-");
+  let clock = 0;
+  let latest;
+  let closed = false;
+  channel.onmessage = ({ data }) => {
+    if (closed || !data || typeof data !== "object") return;
+    if (data.type === "request") {
+      if (latest) channel.postMessage(latest);
+      return;
+    }
+    if (data.type !== "config" || !Number.isSafeInteger(data.clock) || data.clock < 1 || typeof data.sender !== "string")
+      return;
+    clock = Math.max(clock, data.clock);
+    if (!handlers.enabled()) return;
+    if (latest && (data.clock < latest.clock || data.clock === latest.clock && data.sender <= latest.sender)) return;
+    const result = validateConfig(definition, data.value);
+    if (!result.ok) return;
+    latest = { type: "config", clock: data.clock, sender: data.sender, value: result.data };
+    handlers.receive(result.data);
+  };
+  channel.postMessage({ type: "request" });
+  return {
+    publish(value) {
+      if (closed) return;
+      latest = { type: "config", clock: ++clock, sender, value: structuredClone(value) };
+      channel.postMessage(latest);
+    },
+    close() {
+      closed = true;
+      channel.onmessage = null;
+      channel.close();
+    }
+  };
+}
+
+// src/client/history.ts
+var LIMIT = 100;
+var MERGE_MS = 500;
+function createHistory() {
+  const past = [];
+  let future = [];
+  let open = null;
+  const step = (from, to, side) => {
+    const entry = from.pop();
+    if (!entry) return null;
+    to.push(entry);
+    open = null;
+    return entry.changes.map((change) => ({ path: change.path, value: change[side] }));
+  };
+  return {
+    get canUndo() {
+      return past.length > 0;
+    },
+    get canRedo() {
+      return future.length > 0;
+    },
+    /** Record the edit between two snapshots. `merge: false` keeps it a step of its own (e.g. Discard). */
+    record(before, after, { merge = true } = {}) {
+      const changes = structuredClone(diff(before, after));
+      if (!changes.length) return;
+      future = [];
+      const key = JSON.stringify(changes.map(({ path }) => path));
+      const now = Date.now();
+      if (merge && open && open.key === key && now - open.at < MERGE_MS) {
+        open.changes = open.changes.map((change, i) => ({ ...change, after: changes[i].after }));
+        open.at = now;
+        if (open.changes.every((change) => JSON.stringify(change.before) === JSON.stringify(change.after))) {
+          past.pop();
+          open = null;
+        }
+        return;
+      }
+      const entry = { changes, key, at: now };
+      past.push(entry);
+      if (past.length > LIMIT) past.shift();
+      open = merge ? entry : null;
+    },
+    /** The leaves to write back, or null when there is nothing to undo. */
+    undo: () => step(past, future, "before"),
+    redo: () => step(future, past, "after")
+  };
+}
+function writePath(target, path, value) {
+  const key = path.at(-1);
+  let parent = target;
+  for (const segment of path.slice(0, -1)) {
+    const next = parent[segment];
+    parent = typeof next === "object" && next !== null ? next : parent[segment] = {};
+  }
+  if (value === void 0) delete parent[key];
+  else parent[key] = structuredClone(value);
+}
+
+// src/client/live.ts
+function live(target, onWrite) {
+  const proxies = /* @__PURE__ */ new WeakMap();
+  const wrap = (object) => {
+    let proxy = proxies.get(object);
+    if (!proxy) {
+      proxy = new Proxy(object, {
+        get(target2, key, receiver) {
+          const value = Reflect.get(target2, key, receiver);
+          return typeof value === "object" && value !== null ? wrap(value) : value;
+        },
+        set(target2, key, value, receiver) {
+          const changed = Reflect.get(target2, key, receiver) !== value;
+          const ok = Reflect.set(target2, key, value, receiver);
+          if (changed) onWrite();
+          return ok;
+        }
+      });
+      proxies.set(object, proxy);
+    }
+    return proxy;
+  };
+  return wrap(target);
+}
+function assignDeep(target, source) {
+  for (const [key, value] of Object.entries(source)) {
+    const current = target[key];
+    const nested = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+    if (nested(current) && nested(value))
+      assignDeep(current, value);
+    else target[key] = structuredClone(value);
+  }
+}
+
+// src/client/studio.ts
+var COMPARE_MESSAGE = "joyco-studio:compare";
+function postCompare(target, tool, showSaved) {
+  const message = { type: COMPARE_MESSAGE, tool, showSaved };
+  target?.postMessage(message, location.origin);
+}
+function liveSchema(schema) {
+  return Object.fromEntries(
+    Object.entries(schema).map(([key, field]) => {
+      if (field.kind === "button") return [key, field];
+      if (field.kind === "folder")
+        return [
+          key,
+          { ...field, definition: { ...field.definition, schema: () => liveSchema(field.definition.schema()) } }
+        ];
+      return [key, { ...field, live: true }];
+    })
+  );
+}
+function resetSlidersOnDoubleClick(handle) {
+  return (folder, { fields }) => {
+    const sliders = fields().filter(({ field }) => field.kind === "slider");
+    const onDoubleClick = (event) => {
+      if (handle.comparing || event.target.closest("input")) return;
+      const slider = sliders.find(({ blade }) => blade.element.contains(event.target));
+      if (slider?.field.kind !== "slider") return;
+      const saved = slider.path.reduce(
+        (values, key) => values?.[key],
+        schemaValues(handle.definition.controls(structuredClone(handle.saved)))
+      );
+      if (typeof saved === "number") slider.field.write(saved);
+    };
+    folder.element.addEventListener("dblclick", onDoubleClick);
+    return () => folder.element.removeEventListener("dblclick", onDoubleClick);
+  };
+}
+function everyFrame(refresh) {
+  let frame = requestAnimationFrame(function tick() {
+    refresh();
+    frame = requestAnimationFrame(tick);
+  });
+  return () => cancelAnimationFrame(frame);
+}
+var instances = globalThis.__joycoStudio ??= /* @__PURE__ */ new Map();
+function createStudio(config, options = {}) {
+  const { tools } = config;
+  const runtime = options.runtime ?? config.runtime;
+  const instanceKey = runtime || JSON.stringify(tools.map(({ id, file }) => [id, file]).sort());
+  let bridge = null;
+  let connection = { phase: runtime ? "connecting" : "local" };
+  let version = 0;
+  const studioListeners = /* @__PURE__ */ new Set();
+  const touch = () => {
+    version++;
+    for (const listener of studioListeners) listener();
+  };
+  const createHandle = (definition) => {
+    const raw = structuredClone(definition.initial);
+    const listeners = /* @__PURE__ */ new Set();
+    let pushing = Promise.resolve();
+    let scheduled = false;
+    let stashed = null;
+    const history = createHistory();
+    let snapshot = structuredClone(raw);
+    const changed = () => {
+      snapshot = structuredClone(raw);
+      handle.version++;
+      for (const listener of listeners) listener(handle.config);
+      touch();
+    };
+    const adopt = (state) => {
+      handle.state = state;
+      touch();
+    };
+    const receive = (state) => {
+      if (stashed) stashed = structuredClone(state.draft.value);
+      else assignDeep(raw, state.draft.value);
+      adopt(state);
+      if (!stashed) changed();
+      browserSync?.publish(state.draft.value);
+    };
+    const resync = async () => {
+      const result = await bridge?.request("tool.get", { tool: definition.id });
+      if (result?.ok) receive(result.data);
+    };
+    const push = () => {
+      if (scheduled || !bridge) return;
+      scheduled = true;
+      pushing = Promise.resolve().then(async () => {
+        scheduled = false;
+        const result = await bridge?.request("tool.update", { tool: definition.id, value: raw });
+        if (!result) return;
+        if (result.ok) adopt(result.data);
+        else if (result.error !== "runtime_unavailable") {
+          console.warn(`[studio] ${definition.id}: ${result.message ?? result.error}`);
+          await resync();
+        }
+      });
+    };
+    const edited = () => {
+      changed();
+      if (!stashed) {
+        browserSync?.publish(raw);
+        push();
+      }
+    };
+    const restore = (patch) => {
+      if (!patch) return false;
+      for (const { path, value } of patch) writePath(raw, path, value);
+      edited();
+      return true;
+    };
+    const handle = {
+      definition,
+      config: live(raw, () => {
+        if (!stashed) history.record(snapshot, raw);
+        edited();
+      }),
+      state: null,
+      version: 0,
+      get saved() {
+        return handle.state?.saved.value ?? definition.initial;
+      },
+      get changes() {
+        return changedPaths(handle.saved, stashed ?? raw);
+      },
+      get dirty() {
+        return handle.changes.length > 0;
+      },
+      comparing: false,
+      compare(showSaved) {
+        if (showSaved === handle.comparing) return;
+        if (showSaved) stashed = structuredClone(raw);
+        const next = showSaved ? handle.saved : stashed;
+        assignDeep(raw, next);
+        if (!showSaved) stashed = null;
+        handle.comparing = showSaved;
+        changed();
+      },
+      get canUndo() {
+        return history.canUndo;
+      },
+      get canRedo() {
+        return history.canRedo;
+      },
+      undo: () => !stashed && restore(history.undo()),
+      redo: () => !stashed && restore(history.redo()),
+      subscribe(listener) {
+        listeners.add(listener);
+        return () => void listeners.delete(listener);
+      },
+      controls: () => definition.controls(handle.config),
+      debug() {
+        const actions = runtime ? {
+          save: button("Save", () => handle.save().then(fail), "Saved \u2713"),
+          discard: button("Discard", () => handle.discard().then(fail), "Discarded")
+        } : {};
+        return {
+          title: definition.title ?? definition.id,
+          schema: () => ({ ...liveSchema(handle.controls()), ...actions }),
+          extend: resetSlidersOnDoubleClick(handle)
+        };
+      },
+      async save({ force = false } = {}) {
+        if (!bridge) return error("runtime_unavailable");
+        await pushing;
+        const revision = handle.state?.draft.revision;
+        if (revision === void 0) return error("runtime_unavailable");
+        const result = await bridge.request("tool.save", { tool: definition.id, revision, force });
+        if (result.ok) adopt(result.data);
+        return result;
+      },
+      async discard() {
+        if (!bridge) return error("runtime_unavailable");
+        await pushing;
+        const before = snapshot;
+        const result = await bridge.request("tool.discard", { tool: definition.id });
+        if (result.ok) {
+          receive(result.data);
+          if (!stashed) history.record(before, raw, { merge: false });
+        }
+        return result;
+      },
+      receive,
+      resync,
+      close: () => browserSync?.close()
+    };
+    const browserSync = connectBrowserSync(definition, runtime, {
+      enabled: () => connection.phase !== "connected",
+      receive(value) {
+        if (stashed) {
+          stashed = value;
+          touch();
+        } else {
+          assignDeep(raw, value);
+          changed();
+        }
+      }
+    });
+    return handle;
+  };
+  const handles = new Map(tools.filter(hasConfig).map((definition) => [definition.id, createHandle(definition)]));
+  const onMessage = (event) => {
+    const message = event.data;
+    if (event.origin !== location.origin || message?.type !== COMPARE_MESSAGE) return;
+    handles.get(message.tool)?.compare(message.showSaved);
+  };
+  if (typeof window !== "undefined") window.addEventListener?.("message", onMessage);
+  if (runtime && typeof window !== "undefined") {
+    bridge = connectBridge(runtime, {
+      state: (state) => handles.get(state.tool)?.receive(state),
+      connection(next) {
+        connection = next;
+        touch();
+        if (next.phase === "connected") for (const handle of handles.values()) void handle.resync();
+      }
+    });
+  }
+  const studio = {
+    definitions: tools,
+    tools: [...handles.values()],
+    tool(definition) {
+      const handle = handles.get(definition.id);
+      if (!handle) throw new Error(`[studio] tool "${definition.id}" was not passed to createStudio`);
+      return handle;
+    },
+    get connection() {
+      return connection;
+    },
+    get version() {
+      return version;
+    },
+    subscribe(listener) {
+      studioListeners.add(listener);
+      return () => void studioListeners.delete(listener);
+    },
+    close() {
+      bridge?.close();
+      for (const handle of handles.values()) handle.close();
+      studioListeners.clear();
+      if (typeof window !== "undefined") window.removeEventListener?.("message", onMessage);
+      if (instances.get(instanceKey) === studio) instances.delete(instanceKey);
+    }
+  };
+  if (typeof window !== "undefined") {
+    instances.get(instanceKey)?.close();
+    instances.set(instanceKey, studio);
+  }
+  return studio;
+}
+function fail(result) {
+  if (!result.ok) throw new Error(result.message ?? result.error);
+}
+
+export {
+  postCompare,
+  everyFrame,
+  createStudio
+};
+//# sourceMappingURL=chunk-2RGQF5X5.js.map

package/dist/chunk-2RGQF5X5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client/studio.ts","../src/core/diff.ts","../src/client/bridge.ts","../src/client/browser-sync.ts","../src/client/history.ts","../src/client/live.ts"],"sourcesContent":["import {\n  button,\n  type DebugDefinition,\n  type DebugField,\n  type DebugFolder,\n  type DebugSchema,\n  schemaValues,\n} from '@joycostudio/xyz/debug'\nimport { changedPaths } from '../core/diff'\nimport type { ToolState } from '../core/protocol'\nimport { error, type Result } from '../core/result'\nimport { hasConfig, type StudioTool, type ToolDefinition, type ToolReference } from '../core/tool'\nimport { connectBridge, type BridgeClient, type Connection } from './bridge'\nimport { connectBrowserSync } from './browser-sync'\nimport { createHistory, writePath } from './history'\nimport { assignDeep, live } from './live'\n\nexport type ToolHandle<TConfig extends object = any> = {\n  readonly definition: ToolDefinition<TConfig>\n  /** The live config. Writes sync to same-origin pages and, when connected, the runtime. */\n  readonly config: TConfig\n  /** Runtime-owned state; null until the runtime answers (always null without one). */\n  readonly state: ToolState<TConfig> | null\n  /** Bumps on every config change. Handy as a React snapshot. */\n  readonly version: number\n  /** Called after every config change, local or remote. */\n  subscribe(listener: (config: TConfig) => void): () => void\n  /** The tool's Xyz schema bound to the live config. */\n  controls(): DebugSchema\n  /** Xyz `Debuggable`: `debugManager.register(handle)` mounts this tool in the app's floating pane. */\n  debug(): DebugFolder\n  /** The config on disk: the runtime's saved value or, until one answers, the bundled `initial`. */\n  readonly saved: TConfig\n  /** Dotted paths where the draft differs from `saved`. Tracked locally, so it works without a runtime too. */\n  readonly changes: string[]\n  /** The draft differs from `saved`. */\n  readonly dirty: boolean\n  /** True while `compare(true)` shows the saved config in place of the draft. */\n  readonly comparing: boolean\n  /**\n   * Temporarily show `saved` (true) or go back to the draft (false). Local only: nothing\n   * reaches the runtime, and edits made while comparing are dropped when it ends.\n   */\n  compare(showSaved: boolean): void\n  /** True when `undo()` has an edit made on this page to step back through. */\n  readonly canUndo: boolean\n  readonly canRedo: boolean\n  /**\n   * Step back through edits made on this page (a slider drag counts as one), then sync the result like any\n   * other edit. Only the leaves each edit changed are restored. Returns false with nothing to undo or while comparing.\n   */\n  undo(): boolean\n  redo(): boolean\n  save(options?: { force?: boolean }): Promise<Result<ToolState<TConfig>>>\n  discard(): Promise<Result<ToolState<TConfig>>>\n}\n\nexport type Studio = {\n  /** Every registered tool in order, including preview-only ones. */\n  readonly definitions: readonly StudioTool[]\n  /** A handle per tool with a config. Preview-only tools have none. */\n  readonly tools: readonly ToolHandle[]\n  tool<TConfig extends object>(definition: ToolReference<TConfig>): ToolHandle<TConfig>\n  readonly connection: Connection\n  /** Bumps on connection or any tool state change. */\n  readonly version: number\n  subscribe(listener: () => void): () => void\n  close(): void\n}\n\nexport type StudioOptions = {\n  tools: readonly StudioTool[]\n  /**\n   * Runtime bridge URL (e.g. `ws://127.0.0.1:5179`). Omit or pass false for browser-only syncing, as in production.\n   * Only browsers connect, so a module-scope `createStudio` is safe to evaluate during SSR.\n   */\n  runtime?: string | false\n}\n\nconst COMPARE_MESSAGE = 'joyco-studio:compare'\ntype CompareMessage = { type: typeof COMPARE_MESSAGE; tool: string; showSaved: boolean }\n\n/** Make the studio running in `target` (e.g. a preview iframe) compare `tool` as well. */\nexport function postCompare(target: Window | null | undefined, tool: string, showSaved: boolean) {\n  const message: CompareMessage = { type: COMPARE_MESSAGE, tool, showSaved }\n  target?.postMessage(message, location.origin)\n}\n\n/** Mark every value control live so a pane registered with `registerFrame` reflects remote edits. */\nfunction liveSchema(schema: DebugSchema): DebugSchema {\n  return Object.fromEntries(\n    Object.entries(schema).map(([key, field]): [string, DebugField] => {\n      if (field.kind === 'button') return [key, field]\n      if (field.kind === 'folder')\n        return [\n          key,\n          { ...field, definition: { ...field.definition, schema: () => liveSchema(field.definition.schema()) } },\n        ]\n      return [key, { ...field, live: true }]\n    }),\n  )\n}\n\n/**\n * Xyz `extend` for a folder bound to `handle.controls()` (optionally followed by more fields, as in `debug()`):\n * double-clicking a slider resets it to its saved value.\n */\nexport function resetSlidersOnDoubleClick(handle: ToolHandle): NonNullable<DebugDefinition['extend']> {\n  return (folder, { fields }) => {\n    const sliders = fields().filter(({ field }) => field.kind === 'slider')\n    const onDoubleClick = (event: MouseEvent) => {\n      // Double-clicking the number input selects its text instead.\n      if (handle.comparing || (event.target as Element).closest('input')) return\n      const slider = sliders.find(({ blade }) => blade.element.contains(event.target as Node))\n      if (slider?.field.kind !== 'slider') return\n      const saved = slider.path.reduce<unknown>(\n        (values, key) => (values as Record<string, unknown> | undefined)?.[key],\n        schemaValues(handle.definition.controls(structuredClone(handle.saved))),\n      )\n      if (typeof saved === 'number') slider.field.write(saved)\n    }\n    folder.element.addEventListener('dblclick', onDoubleClick)\n    return () => folder.element.removeEventListener('dblclick', onDoubleClick)\n  }\n}\n\n/** A `registerFrame` for Xyz's `DebugManager` / `bindDebugSchema`: refreshes live controls every animation frame. */\nexport function everyFrame(refresh: () => void) {\n  let frame = requestAnimationFrame(function tick() {\n    refresh()\n    frame = requestAnimationFrame(tick)\n  })\n  return () => cancelAnimationFrame(frame)\n}\n\n/** One studio per runtime URL (or local tool set) per page; replace HMR instances without leaking transports. */\nconst instances: Map<string, Studio> = ((globalThis as { __joycoStudio?: Map<string, Studio> }).__joycoStudio ??=\n  new Map())\n\nexport function createStudio(config: StudioOptions, options: Pick<StudioOptions, 'runtime'> = {}): Studio {\n  const { tools } = config\n  const runtime = options.runtime ?? config.runtime\n  const instanceKey = runtime || JSON.stringify(tools.map(({ id, file }) => [id, file]).sort())\n  let bridge: BridgeClient | null = null\n  let connection: Connection = { phase: runtime ? 'connecting' : 'local' }\n  let version = 0\n  const studioListeners = new Set<() => void>()\n  const touch = () => {\n    version++\n    for (const listener of studioListeners) listener()\n  }\n\n  const createHandle = <TConfig extends object>(definition: ToolDefinition<TConfig>) => {\n    const raw = structuredClone(definition.initial)\n    const listeners = new Set<(config: TConfig) => void>()\n    let pushing: Promise<unknown> = Promise.resolve()\n    let scheduled = false\n    /** The draft to restore while comparing; null when showing the draft. */\n    let stashed: TConfig | null = null\n    const history = createHistory()\n    /** A copy of `raw` as of the last change, so the next local edit can be diffed against it. */\n    let snapshot = structuredClone(raw)\n\n    const changed = () => {\n      snapshot = structuredClone(raw)\n      handle.version++\n      for (const listener of listeners) listener(handle.config)\n      touch()\n    }\n    const adopt = (state: ToolState) => {\n      handle.state = state as ToolState<TConfig>\n      touch()\n    }\n    const receive = (state: ToolState) => {\n      if (stashed) stashed = structuredClone(state.draft.value) as TConfig\n      else assignDeep(raw as Record<string, unknown>, state.draft.value as Record<string, unknown>)\n      adopt(state)\n      if (!stashed) changed()\n      browserSync?.publish(state.draft.value as TConfig)\n    }\n    const resync = async () => {\n      const result = await bridge?.request('tool.get', { tool: definition.id })\n      if (result?.ok) receive(result.data)\n    }\n    const push = () => {\n      if (scheduled || !bridge) return\n      scheduled = true\n      pushing = Promise.resolve().then(async () => {\n        scheduled = false\n        const result = await bridge?.request('tool.update', { tool: definition.id, value: raw })\n        if (!result) return\n        if (result.ok) adopt(result.data)\n        else if (result.error !== 'runtime_unavailable') {\n          console.warn(`[studio] ${definition.id}: ${result.message ?? result.error}`)\n          await resync()\n        }\n      })\n    }\n\n    const edited = () => {\n      changed()\n      if (!stashed) {\n        browserSync?.publish(raw)\n        push()\n      }\n    }\n    const restore = (patch: ReturnType<typeof history.undo>) => {\n      if (!patch) return false\n      for (const { path, value } of patch) writePath(raw as Record<string, unknown>, path, value)\n      edited()\n      return true\n    }\n\n    const handle = {\n      definition,\n      config: live(raw, () => {\n        if (!stashed) history.record(snapshot, raw)\n        edited()\n      }),\n      state: null as ToolState<TConfig> | null,\n      version: 0,\n      get saved(): TConfig {\n        return handle.state?.saved.value ?? definition.initial\n      },\n      get changes() {\n        return changedPaths(handle.saved, stashed ?? raw)\n      },\n      get dirty() {\n        return handle.changes.length > 0\n      },\n      comparing: false,\n      compare(showSaved: boolean) {\n        if (showSaved === handle.comparing) return\n        if (showSaved) stashed = structuredClone(raw)\n        const next = showSaved ? handle.saved : stashed!\n        assignDeep(raw as Record<string, unknown>, next as Record<string, unknown>)\n        if (!showSaved) stashed = null\n        handle.comparing = showSaved\n        changed()\n      },\n      get canUndo() {\n        return history.canUndo\n      },\n      get canRedo() {\n        return history.canRedo\n      },\n      undo: () => !stashed && restore(history.undo()),\n      redo: () => !stashed && restore(history.redo()),\n      subscribe(listener: (config: TConfig) => void) {\n        listeners.add(listener)\n        return () => void listeners.delete(listener)\n      },\n      controls: () => definition.controls(handle.config),\n      debug(): DebugFolder {\n        const actions: DebugSchema = runtime\n          ? {\n              save: button('Save', () => handle.save().then(fail), 'Saved ✓'),\n              discard: button('Discard', () => handle.discard().then(fail), 'Discarded'),\n            }\n          : {}\n        return {\n          title: definition.title ?? definition.id,\n          schema: () => ({ ...liveSchema(handle.controls()), ...actions }),\n          extend: resetSlidersOnDoubleClick(handle),\n        }\n      },\n      async save({ force = false } = {}) {\n        if (!bridge) return error('runtime_unavailable')\n        await pushing\n        const revision = handle.state?.draft.revision\n        if (revision === undefined) return error('runtime_unavailable')\n        const result = await bridge.request('tool.save', { tool: definition.id, revision, force })\n        if (result.ok) adopt(result.data)\n        return result as Result<ToolState<TConfig>>\n      },\n      async discard() {\n        if (!bridge) return error('runtime_unavailable')\n        await pushing\n        const before = snapshot\n        const result = await bridge.request('tool.discard', { tool: definition.id })\n        if (result.ok) {\n          receive(result.data)\n          // Discarding is undoable, as its own step.\n          if (!stashed) history.record(before, raw, { merge: false })\n        }\n        return result as Result<ToolState<TConfig>>\n      },\n      receive,\n      resync,\n      close: () => browserSync?.close(),\n    }\n    const browserSync = connectBrowserSync(definition, runtime, {\n      enabled: () => connection.phase !== 'connected',\n      receive(value) {\n        if (stashed) {\n          // The shown saved config stays put, but `changes` and `dirty` read the new draft.\n          stashed = value\n          touch()\n        } else {\n          assignDeep(raw as Record<string, unknown>, value as Record<string, unknown>)\n          changed()\n        }\n      },\n    })\n    return handle\n  }\n\n  const handles = new Map(tools.filter(hasConfig).map((definition) => [definition.id, createHandle(definition)]))\n\n  // /studio asks its same-origin preview iframe to compare too (see `postCompare`).\n  const onMessage = (event: MessageEvent) => {\n    const message = event.data as CompareMessage | undefined\n    if (event.origin !== location.origin || message?.type !== COMPARE_MESSAGE) return\n    handles.get(message.tool)?.compare(message.showSaved)\n  }\n  if (typeof window !== 'undefined') window.addEventListener?.('message', onMessage)\n\n  if (runtime && typeof window !== 'undefined') {\n    bridge = connectBridge(runtime, {\n      state: (state) => handles.get(state.tool)?.receive(state),\n      connection(next) {\n        connection = next\n        touch()\n        if (next.phase === 'connected') for (const handle of handles.values()) void handle.resync()\n      },\n    })\n  }\n\n  const studio: Studio = {\n    definitions: tools,\n    tools: [...handles.values()],\n    tool<TConfig extends object>(definition: ToolDefinition<TConfig>) {\n      const handle = handles.get(definition.id)\n      if (!handle) throw new Error(`[studio] tool \"${definition.id}\" was not passed to createStudio`)\n      return handle as unknown as ToolHandle<TConfig>\n    },\n    get connection() {\n      return connection\n    },\n    get version() {\n      return version\n    },\n    subscribe(listener) {\n      studioListeners.add(listener)\n      return () => void studioListeners.delete(listener)\n    },\n    close() {\n      bridge?.close()\n      for (const handle of handles.values()) handle.close()\n      studioListeners.clear()\n      if (typeof window !== 'undefined') window.removeEventListener?.('message', onMessage)\n      if (instances.get(instanceKey) === studio) instances.delete(instanceKey)\n    },\n  }\n  if (typeof window !== 'undefined') {\n    instances.get(instanceKey)?.close()\n    instances.set(instanceKey, studio)\n  }\n  return studio\n}\n\nfunction fail(result: Result<unknown>) {\n  if (!result.ok) throw new Error(result.message ?? result.error)\n}\n","export type Change = { path: string[]; before: unknown; after: unknown }\n\n/** Every leaf that differs between two configs of the same shape. Arrays count as leaves. */\nexport function diff(before: unknown, after: unknown, path: string[] = []): Change[] {\n  const nested = (value: unknown): value is Record<string, unknown> =>\n    typeof value === 'object' && value !== null && !Array.isArray(value)\n  if (nested(before) && nested(after)) {\n    const keys = new Set([...Object.keys(before), ...Object.keys(after)])\n    return [...keys].flatMap((key) => diff(before[key], after[key], [...path, key]))\n  }\n  return JSON.stringify(before) === JSON.stringify(after) ? [] : [{ path, before, after }]\n}\n\n/** Dotted paths of every leaf that differs between two configs of the same shape. */\nexport function changedPaths(before: unknown, after: unknown): string[] {\n  return diff(before, after).map(({ path }) => path.join('.'))\n}\n","import type { Op, Operations, ServerMessage, ToolState } from '../core/protocol'\nimport { error, type Result } from '../core/result'\n\nexport type Connection = { phase: 'local' } | { phase: 'connecting' } | { phase: 'connected' } | { phase: 'offline' }\n\ntype Pending = (result: Result<unknown>) => void\n\n/** A reconnecting WebSocket to the Studio runtime with request/response correlation. */\nexport function connectBridge(\n  url: string,\n  handlers: { state: (state: ToolState) => void; connection: (connection: Connection) => void },\n) {\n  let socket: WebSocket | null = null\n  let nextId = 0\n  let retry = 0\n  let timer: ReturnType<typeof setTimeout> | undefined\n  let closed = false\n  const pending = new Map<number, Pending>()\n\n  const open = () => {\n    handlers.connection({ phase: 'connecting' })\n    const ws = new WebSocket(url)\n    socket = ws\n    ws.onopen = () => {\n      retry = 0\n      handlers.connection({ phase: 'connected' })\n    }\n    ws.onmessage = (event) => {\n      const message = JSON.parse(String(event.data)) as ServerMessage\n      if (message.type === 'state') return handlers.state(message.state)\n      pending.get(message.id)?.(message.result)\n      pending.delete(message.id)\n    }\n    ws.onclose = () => {\n      socket = null\n      for (const resolve of pending.values()) resolve(error('runtime_unavailable'))\n      pending.clear()\n      if (closed) return\n      handlers.connection({ phase: 'offline' })\n      timer = setTimeout(open, Math.min(500 * 2 ** retry++, 5000))\n    }\n  }\n  open()\n\n  return {\n    request<TOp extends Op>(op: TOp, params: Operations[TOp]['params']): Promise<Result<Operations[TOp]['result']>> {\n      if (socket?.readyState !== WebSocket.OPEN) return Promise.resolve(error('runtime_unavailable'))\n      const id = nextId++\n      socket.send(JSON.stringify({ id, op, params }))\n      return new Promise((resolve) => pending.set(id, resolve as Pending))\n    },\n    close() {\n      closed = true\n      clearTimeout(timer)\n      socket?.close()\n    },\n  }\n}\n\nexport type BridgeClient = ReturnType<typeof connectBridge>\n","import type { ToolDefinition } from '../core/tool'\nimport { validateConfig } from '../core/validate'\n\ntype Snapshot = { type: 'config'; clock: number; sender: string; value: unknown }\n\n/** Ephemeral config sharing between same-origin pages, including Studio's preview iframe. */\nexport function connectBrowserSync<T extends object>(\n  definition: ToolDefinition<T>,\n  runtime: string | false | undefined,\n  handlers: { enabled(): boolean; receive(value: T): void },\n) {\n  // Also exclude SSR and Node environments that expose their own BroadcastChannel implementation.\n  if (typeof window === 'undefined' || !window.location?.origin || !window.BroadcastChannel) return null\n\n  let channel: BroadcastChannel\n  try {\n    channel = new window.BroadcastChannel(\n      JSON.stringify(['joyco-studio:config', runtime || null, definition.id, definition.file]),\n    )\n  } catch {\n    return null\n  }\n  const sender = crypto.getRandomValues(new Uint32Array(4)).join('-')\n  let clock = 0\n  let latest: Snapshot | undefined\n  let closed = false\n\n  channel.onmessage = ({ data }) => {\n    if (closed || !data || typeof data !== 'object') return\n    if (data.type === 'request') {\n      if (latest) channel.postMessage(latest)\n      return\n    }\n    if (\n      data.type !== 'config' ||\n      !Number.isSafeInteger(data.clock) ||\n      data.clock < 1 ||\n      typeof data.sender !== 'string'\n    )\n      return\n    clock = Math.max(clock, data.clock)\n    if (!handlers.enabled()) return\n    // A stable tie-break keeps simultaneous edits and multiple snapshot replies from diverging.\n    if (latest && (data.clock < latest.clock || (data.clock === latest.clock && data.sender <= latest.sender))) return\n    const result = validateConfig(definition, data.value)\n    if (!result.ok) return\n    latest = { type: 'config', clock: data.clock, sender: data.sender, value: result.data }\n    handlers.receive(result.data)\n  }\n  // A newly mounted/reloaded preview asks existing peers for their current draft.\n  channel.postMessage({ type: 'request' })\n\n  return {\n    publish(value: T) {\n      if (closed) return\n      latest = { type: 'config', clock: ++clock, sender, value: structuredClone(value) }\n      channel.postMessage(latest)\n    },\n    close() {\n      closed = true\n      channel.onmessage = null\n      channel.close()\n    },\n  }\n}\n","import { diff, type Change } from '../core/diff'\n\ntype Entry = { changes: Change[]; key: string; at: number }\n\nconst LIMIT = 100\n/** Edits to the same leaves this close together (a slider drag) undo as one step. */\nconst MERGE_MS = 500\n\n/**\n * Undo/redo for one page's edits. Entries hold only the leaves an edit changed, so stepping back\n * never reverts what another page, the runtime, or an agent changed in between.\n */\nexport function createHistory() {\n  const past: Entry[] = []\n  let future: Entry[] = []\n  /** The newest entry while later edits to the same leaves may still extend it. */\n  let open: Entry | null = null\n\n  const step = (from: Entry[], to: Entry[], side: 'before' | 'after') => {\n    const entry = from.pop()\n    if (!entry) return null\n    to.push(entry)\n    open = null\n    return entry.changes.map((change) => ({ path: change.path, value: change[side] }))\n  }\n\n  return {\n    get canUndo() {\n      return past.length > 0\n    },\n    get canRedo() {\n      return future.length > 0\n    },\n    /** Record the edit between two snapshots. `merge: false` keeps it a step of its own (e.g. Discard). */\n    record(before: unknown, after: unknown, { merge = true } = {}) {\n      // Cloned so later in-place edits (e.g. to an array leaf) cannot rewrite history.\n      const changes = structuredClone(diff(before, after))\n      if (!changes.length) return\n      future = []\n      const key = JSON.stringify(changes.map(({ path }) => path))\n      const now = Date.now()\n      if (merge && open && open.key === key && now - open.at < MERGE_MS) {\n        open.changes = open.changes.map((change, i) => ({ ...change, after: changes[i]!.after }))\n        open.at = now\n        // Dragged back to where it started: nothing left to undo.\n        if (open.changes.every((change) => JSON.stringify(change.before) === JSON.stringify(change.after))) {\n          past.pop()\n          open = null\n        }\n        return\n      }\n      const entry = { changes, key, at: now }\n      past.push(entry)\n      if (past.length > LIMIT) past.shift()\n      open = merge ? entry : null\n    },\n    /** The leaves to write back, or null when there is nothing to undo. */\n    undo: () => step(past, future, 'before'),\n    redo: () => step(future, past, 'after'),\n  }\n}\n\n/** Write `value` at `path` in place; undefined removes the key (it did not exist before the edit). */\nexport function writePath(target: Record<string, unknown>, path: string[], value: unknown) {\n  const key = path.at(-1)!\n  let parent = target\n  for (const segment of path.slice(0, -1)) {\n    const next = parent[segment]\n    parent = (typeof next === 'object' && next !== null ? next : (parent[segment] = {})) as Record<string, unknown>\n  }\n  if (value === undefined) delete parent[key]\n  else parent[key] = structuredClone(value)\n}\n","/**\n * A deep proxy that reports every write, so plain `property(config, 'key')`\n * bindings from Xyz feed Studio without the tool author wiring callbacks.\n */\nexport function live<T extends object>(target: T, onWrite: () => void): T {\n  const proxies = new WeakMap<object, object>()\n  const wrap = <O extends object>(object: O): O => {\n    let proxy = proxies.get(object)\n    if (!proxy) {\n      proxy = new Proxy(object, {\n        get(target, key, receiver) {\n          const value = Reflect.get(target, key, receiver)\n          return typeof value === 'object' && value !== null ? wrap(value) : value\n        },\n        set(target, key, value, receiver) {\n          const changed = Reflect.get(target, key, receiver) !== value\n          const ok = Reflect.set(target, key, value, receiver)\n          if (changed) onWrite()\n          return ok\n        },\n      })\n      proxies.set(object, proxy)\n    }\n    return proxy as O\n  }\n  return wrap(target)\n}\n\n/** Copy `source` into `target` in place, keeping nested object identities (and every binding to them) intact. */\nexport function assignDeep(target: Record<string, unknown>, source: Record<string, unknown>) {\n  for (const [key, value] of Object.entries(source)) {\n    const current = target[key]\n    const nested = (v: unknown) => typeof v === 'object' && v !== null && !Array.isArray(v)\n    if (nested(current) && nested(value))\n      assignDeep(current as Record<string, unknown>, value as Record<string, unknown>)\n    else target[key] = structuredClone(value)\n  }\n}\n"],"mappings":"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","names":["target"]}

package/dist/{chunk-OIMLF2CL.js → chunk-DEJYGBPJ.js}

@@ -3,10 +3,11 @@ var hasConfig = (tool) => tool.controls !== void 0;
 var ID = /^[a-z0-9][a-z0-9-]*$/;
 function defineTool(tool) {
   if (!ID.test(tool.id)) throw new Error(`[studio] tool id "${tool.id}" must be kebab-case`);
-  const config = [tool.file, tool.initial, tool.controls].filter((part) => part !== void 0).length;
-  if (config === 1 || config === 2)
-    throw new Error(`[studio] tool "${tool.id}" needs all of file, initial, and controls, or none of them`);
-  if (!config && !tool.preview) throw new Error(`[studio] tool "${tool.id}" needs a preview or a config`);
+  const value = tool;
+  if (value.file !== void 0 || value.initial !== void 0) {
+    if (value.file === void 0 || value.initial === void 0 || value.controls === void 0)
+      throw new Error(`[studio] tool "${tool.id}" needs all of file, initial, and controls, or none of them`);
+  }
   return tool;
 }
 var DEFAULT_PORT = 5179;
@@ -97,4 +98,4 @@ export {
   error,
   validateConfig
 };
-//# sourceMappingURL=chunk-OIMLF2CL.js.map
+//# sourceMappingURL=chunk-DEJYGBPJ.js.map

package/dist/chunk-DEJYGBPJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/tool.ts","../src/core/result.ts","../src/core/validate.ts"],"sourcesContent":["import type { DebugSchema } from '@joycostudio/xyz/debug'\n\n/**\n * An SVG icon as data: `[tag, attributes]` children of a 24×24 stroke icon.\n * Lucide's core package (`import { Palette } from 'lucide'`) exports exactly this shape.\n */\nexport type ToolIcon = readonly (readonly [tag: string, attrs: Record<string, string | number | undefined>])[]\n\ntype ToolBase = {\n  /** Unique, URL-safe identifier. */\n  id: string\n  title?: string\n  /** Shown next to the tool in /studio. Data, not a component, so contracts stay loadable in Node. */\n  icon?: ToolIcon\n  /** App route that renders this tool's result, shown next to the controls in /studio. */\n  preview?: string\n  /** Use a bare iframe for tools that already own their canvas layout and headers. */\n  previewLayout?: 'canvas' | 'custom'\n}\n\n/**\n * A tool's contract. Isomorphic on purpose: the runtime loads it in Node to\n * validate and persist, the app loads it in the browser to apply and debug.\n *\n * `TConfig` is the one type that is read, edited, applied, and persisted.\n */\nexport type ToolDefinition<TConfig extends object = object> = ToolBase & {\n  /** Repo-relative JSON file the config persists to. Import that same file as `initial`. */\n  file: string\n  /** Config used before the runtime answers (and in production). */\n  initial: TConfig\n  /**\n   * What can be tweaked, as an Xyz/Tweakpane schema bound to `config`.\n   * Doubles as the runtime validator: every control's bounds are enforced on write.\n   */\n  controls: (config: TConfig) => DebugSchema\n}\n\n/** A tool with nothing to tune: a sidebar entry for its preview, without an inspector or config file. */\nexport type PreviewToolDefinition = ToolBase & {\n  preview: string\n  file?: never\n  initial?: never\n  controls?: never\n}\n\n/** A tool with a config. */\nexport type AnyTool = ToolDefinition<any>\n\n/** Anything `defineTool` returns: the kind follows from whether it declares a config. */\nexport type StudioTool = AnyTool | PreviewToolDefinition\n\nexport const hasConfig = (tool: StudioTool): tool is AnyTool => tool.controls !== undefined\n\n/** Filled by .studio/types.generated.ts in each consuming project. */\nexport interface DiscoveredToolConfigs {}\n\n/** A discovered declaration is resolved into a full definition by the generated registry. */\nexport type DiscoveredToolDefinition<TConfig extends object = object> = ToolBase & {\n  /** JSON source relative to this tool file, or a tsconfig path alias. Defaults to ./config.json. */\n  config?: string\n  controls: (config: TConfig) => DebugSchema\n  file?: never\n  initial?: never\n}\nexport type ToolReference<TConfig extends object> = Pick<ToolDefinition<TConfig>, 'id' | 'controls'>\nexport type ConfigOf<TTool> = TTool extends ToolReference<infer TConfig> ? TConfig : never\n\nconst ID = /^[a-z0-9][a-z0-9-]*$/\n\n/** Discovered tools infer their config from the generated ID-to-JSON type map. */\nexport function defineTool<K extends keyof DiscoveredToolConfigs & string>(\n  tool: Omit<DiscoveredToolDefinition<Extract<DiscoveredToolConfigs[K], object>>, 'id'> & { id: K },\n): DiscoveredToolDefinition<Extract<DiscoveredToolConfigs[K], object>>\n/** Existing explicitly registered tools remain supported. */\nexport function defineTool<TConfig extends object>(tool: ToolDefinition<TConfig>): ToolDefinition<TConfig>\nexport function defineTool(tool: PreviewToolDefinition): PreviewToolDefinition\n/** A discovered preview-only tool may infer its preview from the adjacent page. */\nexport function defineTool(\n  tool: ToolBase & { controls?: never; config?: never; file?: never; initial?: never },\n): ToolBase\nexport function defineTool(tool: StudioTool | DiscoveredToolDefinition<any> | ToolBase) {\n  if (!ID.test(tool.id)) throw new Error(`[studio] tool id \"${tool.id}\" must be kebab-case`)\n  const value = tool as Partial<AnyTool>\n  if (value.file !== undefined || value.initial !== undefined) {\n    if (value.file === undefined || value.initial === undefined || value.controls === undefined)\n      throw new Error(`[studio] tool \"${tool.id}\" needs all of file, initial, and controls, or none of them`)\n  }\n  return tool\n}\n\nexport type StudioConfig = {\n  /** Explicit registry; omit to enable convention-based discovery. */\n  tools?: readonly StudioTool[]\n  /**\n   * Directory to scan and watch for `studio.tool.ts` files, relative to\n   * the project root.\n   *\n   * Defaults to the active Next.js app directory: `app/` or `src/app/`.\n   * Set a narrower directory to reduce scanning and discovery triggers.\n   * This does not change preview URLs.\n   *\n   * @example 'src/app/experiments'\n   */\n  toolsDir?: string\n  /** Runtime WebSocket and HTTP MCP port. Defaults to 5179. */\n  port?: number\n  /** Browser origins allowed on the bridge and MCP endpoint. Defaults to localhost origins. */\n  origins?: readonly string[]\n  /** Running app URL (e.g. http://localhost:3000), used for MCP preview captures. */\n  appUrl?: string\n}\n\nexport const DEFAULT_PORT = 5179\n\nexport function defineConfig<T extends StudioConfig>(config: T): T {\n  return config\n}\n","export type Success<T> = { ok: true; data: T }\n\nexport type Failure = {\n  ok: false\n  /** snake_case wire code, e.g. `invalid_config`. */\n  error: string\n  message?: string\n}\n\nexport type Result<T> = Success<T> | Failure\n\nexport const success = <T>(data: T): Success<T> => ({ ok: true, data })\n\nexport const error = (code: string, message?: string): Failure => ({\n  ok: false,\n  error: code,\n  ...(message === undefined ? {} : { message }),\n})\n","import type { DebugSchema } from '@joycostudio/xyz/debug'\nimport { error, success, type Result } from './result'\nimport type { ToolDefinition } from './tool'\n\n/**\n * Accept `candidate` as a config for `tool` only if it has the exact shape of\n * `tool.initial` and every control in `tool.controls` accepts its value.\n * Returns a detached copy, never the input.\n */\nexport function validateConfig<TConfig extends object>(\n  tool: ToolDefinition<TConfig>,\n  candidate: unknown,\n): Result<TConfig> {\n  const mismatch = shapeMismatch(tool.initial, candidate, 'config')\n  if (mismatch) return error('invalid_config', mismatch)\n  const config = structuredClone(candidate) as TConfig\n  const invalid = invalidControl(tool.controls(config))\n  return invalid ? error('invalid_config', invalid) : success(config)\n}\n\nfunction kind(value: unknown) {\n  if (value === null) return 'null'\n  if (Array.isArray(value)) return 'array'\n  return typeof value\n}\n\nfunction shapeMismatch(reference: unknown, value: unknown, path: string): string | null {\n  const expected = kind(reference)\n  if (kind(value) !== expected) return `${path}: expected ${expected}, got ${kind(value)}`\n  if (expected === 'number' && !Number.isFinite(value)) return `${path}: expected a finite number`\n  if (expected === 'array') {\n    const [first] = reference as unknown[]\n    if (first === undefined) return null\n    for (const [index, item] of (value as unknown[]).entries()) {\n      const nested = shapeMismatch(first, item, `${path}[${index}]`)\n      if (nested) return nested\n    }\n  }\n  if (expected === 'object') {\n    const ref = reference as Record<string, unknown>\n    const obj = value as Record<string, unknown>\n    for (const key of Object.keys(obj)) if (!(key in ref)) return `${path}.${key}: unknown key`\n    for (const key of Object.keys(ref)) {\n      if (!(key in obj)) return `${path}.${key}: missing`\n      const nested = shapeMismatch(ref[key], obj[key], `${path}.${key}`)\n      if (nested) return nested\n    }\n  }\n  return null\n}\n\nconst isRgb = (value: unknown) =>\n  typeof value === 'object' &&\n  value !== null &&\n  ['r', 'g', 'b'].every((channel) => Number.isFinite((value as Record<string, unknown>)[channel]))\n\nfunction invalidControl(schema: DebugSchema, path = ''): string | null {\n  for (const [key, field] of Object.entries(schema)) {\n    if (field.kind === 'button') continue\n    const name = `${path}${field.label ?? key}`\n    if (field.kind === 'folder') {\n      const nested = invalidControl(field.definition.schema(), `${name}/`)\n      if (nested) return nested\n      continue\n    }\n    const value: unknown = field.read()\n    if (field.kind === 'slider') {\n      if (typeof value !== 'number' || value < field.min || value > field.max)\n        return `${name}: expected a number in [${field.min}, ${field.max}], got ${JSON.stringify(value)}`\n    } else if (field.kind === 'bool') {\n      if (typeof value !== 'boolean') return `${name}: expected a boolean`\n    } else if (field.kind === 'select') {\n      const options = Object.values(field.options)\n      if (!options.includes(value as string | number))\n        return `${name}: expected one of ${JSON.stringify(options)}, got ${JSON.stringify(value)}`\n    } else if (field.kind === 'color-string') {\n      if (typeof value !== 'string') return `${name}: expected a color string`\n    } else if (field.kind === 'color') {\n      if (!isRgb(value)) return `${name}: expected an { r, g, b } color`\n    }\n  }\n  return null\n}\n"],"mappings":"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","names":[]}