@joycostudio/studio 0.1.5 → 0.1.6

package/dist/client.d.ts

@@ -1,6 +1,12 @@
 import { DebugSchema, DebugFolder } from '@joycostudio/xyz/debug';
 import { f as StudioTool, T as ToolDefinition, j as ToolState, R as Result, i as ToolReference } from './protocol-DjrMADPm.js';
 
+type Change = {
+    path: string[];
+    before: unknown;
+    after: unknown;
+};
+
 type Connection = {
     phase: 'local';
 } | {
@@ -29,6 +35,8 @@ type ToolHandle<TConfig extends object = any> = {
     readonly saved: TConfig;
     /** Dotted paths where the draft differs from `saved`. Tracked locally, so it works without a runtime too. */
     readonly changes: string[];
+    /** Each leaf where the draft differs from `saved`: `before` is the saved value, `after` the draft's. */
+    readonly diff: Change[];
     /** The draft differs from `saved`. */
     readonly dirty: boolean;
     /** True while `compare(true)` shows the saved config in place of the draft. */
@@ -56,6 +64,16 @@ type ToolHandle<TConfig extends object = any> = {
      * Undoable as its own step. Returns false when there is nothing to discard.
      */
     discard(): boolean;
+    /**
+     * Reset one changed leaf (a dotted path from `changes`, or its keys, which also address keys containing dots) to its saved value, then sync it like any
+     * other edit. Undoable as its own step. Returns false when that leaf is unchanged or while comparing.
+     */
+    revert(path: string | readonly string[]): boolean;
+    /**
+     * A link to `base` (the current page by default) carrying the draft. Opening it on another machine applies
+     * that draft as an unsaved, undoable edit; a draft that no longer fits the tool's controls is ignored.
+     */
+    shareUrl(base?: string | URL): string;
 };
 type Studio = {
     /** Every registered tool in order, including preview-only ones. */
@@ -83,4 +101,4 @@ declare function postCompare(target: Window | null | undefined, tool: string, sh
 declare function everyFrame(refresh: () => void): () => void;
 declare function createStudio(config: StudioOptions, options?: Pick<StudioOptions, 'runtime'>): Studio;
 
-export { type Connection, type Studio, type StudioOptions, type ToolHandle, createStudio, everyFrame, postCompare };
+export { type Change, type Connection, type Studio, type StudioOptions, type ToolHandle, createStudio, everyFrame, postCompare };

package/dist/client.js

@@ -2,7 +2,7 @@ import {
   createStudio,
   everyFrame,
   postCompare
-} from "./chunk-ZH3NEN4V.js";
+} from "./chunk-6KZJEKOL.js";
 import "./chunk-DEJYGBPJ.js";
 export {
   createStudio,

package/dist/next.js

@@ -1,6 +1,6 @@
 import {
   createStudio
-} from "./chunk-ZH3NEN4V.js";
+} from "./chunk-6KZJEKOL.js";
 import "./chunk-DEJYGBPJ.js";
 
 // src/next.ts

package/dist/react.d.ts

@@ -3,6 +3,12 @@ import { ComponentType, ComponentPropsWithRef, ReactNode, ComponentPropsWithoutR
 import { DebugSchema, DebugFolder } from '@joycostudio/xyz/debug';
 import { Select } from '@base-ui/react/select';
 
+type Change = {
+    path: string[];
+    before: unknown;
+    after: unknown;
+};
+
 type Success<T> = {
     ok: true;
     data: T;
@@ -107,6 +113,8 @@ type ToolHandle<TConfig extends object = any> = {
     readonly saved: TConfig;
     /** Dotted paths where the draft differs from `saved`. Tracked locally, so it works without a runtime too. */
     readonly changes: string[];
+    /** Each leaf where the draft differs from `saved`: `before` is the saved value, `after` the draft's. */
+    readonly diff: Change[];
     /** The draft differs from `saved`. */
     readonly dirty: boolean;
     /** True while `compare(true)` shows the saved config in place of the draft. */
@@ -134,6 +142,16 @@ type ToolHandle<TConfig extends object = any> = {
      * Undoable as its own step. Returns false when there is nothing to discard.
      */
     discard(): boolean;
+    /**
+     * Reset one changed leaf (a dotted path from `changes`, or its keys, which also address keys containing dots) to its saved value, then sync it like any
+     * other edit. Undoable as its own step. Returns false when that leaf is unchanged or while comparing.
+     */
+    revert(path: string | readonly string[]): boolean;
+    /**
+     * A link to `base` (the current page by default) carrying the draft. Opening it on another machine applies
+     * that draft as an unsaved, undoable edit; a draft that no longer fits the tool's controls is ignored.
+     */
+    shareUrl(base?: string | URL): string;
 };
 type Studio$1 = {
     /** Every registered tool in order, including preview-only ones. */