nudge-ui 0.2.4 → 0.2.5

package/dist/nudge-ui.mjs

@@ -3750,8 +3750,8 @@ var require_source_map = __commonJS({
 var require_previous_map = __commonJS({
   "../../node_modules/.pnpm/postcss@8.5.26/node_modules/postcss/lib/previous-map.js"(exports, module) {
     "use strict";
-    var { existsSync: existsSync4, readFileSync: readFileSync2, realpathSync: realpathSync3 } = __require("fs");
-    var { dirname: dirname5, isAbsolute: isAbsolute5, join: join7, relative: relative5, sep: sep4 } = __require("path");
+    var { existsSync: existsSync3, readFileSync: readFileSync3, realpathSync: realpathSync3 } = __require("fs");
+    var { dirname: dirname4, isAbsolute: isAbsolute5, join: join7, relative: relative5, sep: sep4 } = __require("path");
     var { SourceMapConsumer, SourceMapGenerator } = require_source_map();
     function realPath(path) {
       try {
@@ -3778,7 +3778,7 @@ var require_previous_map = __commonJS({
         if (!this.mapFile && opts.from) {
           this.mapFile = opts.from;
         }
-        if (this.mapFile) this.root = dirname5(this.mapFile);
+        if (this.mapFile) this.root = dirname4(this.mapFile);
         if (text) this.text = text;
       }
       consumer() {
@@ -3824,15 +3824,15 @@ var require_previous_map = __commonJS({
         if (!trusted && !this.unsafeMap) {
           if (!/\.map$/i.test(path)) return void 0;
           if (!cssFile) return void 0;
-          let rel = relative5(realPath(dirname5(cssFile)), realPath(path));
+          let rel = relative5(realPath(dirname4(cssFile)), realPath(path));
           if (rel === ".." || rel.startsWith(".." + sep4) || isAbsolute5(rel)) {
             return void 0;
           }
         }
-        this.root = dirname5(path);
-        if (existsSync4(path)) {
+        this.root = dirname4(path);
+        if (existsSync3(path)) {
           this.mapFile = path;
-          return readFileSync2(path, "utf-8").toString().trim();
+          return readFileSync3(path, "utf-8").toString().trim();
         }
       }
       loadMap(file, prev) {
@@ -3866,7 +3866,7 @@ var require_previous_map = __commonJS({
           return this.decodeInline(this.annotation);
         } else if (this.annotation) {
           let map = this.annotation;
-          if (file) map = join7(dirname5(file), map);
+          if (file) map = join7(dirname4(file), map);
           let unknown = this.loadFile(map, file, false);
           if (unknown) {
             try {
@@ -4369,12 +4369,12 @@ var require_fromJSON = __commonJS({
 var require_map_generator = __commonJS({
   "../../node_modules/.pnpm/postcss@8.5.26/node_modules/postcss/lib/map-generator.js"(exports, module) {
     "use strict";
-    var { dirname: dirname5, relative: relative5, resolve: resolve5, sep: sep4 } = __require("path");
+    var { dirname: dirname4, relative: relative5, resolve: resolve5, sep: sep4 } = __require("path");
     var { SourceMapConsumer, SourceMapGenerator } = require_source_map();
     var { pathToFileURL: pathToFileURL2 } = __require("url");
     var Input2 = require_input();
     var sourceMapAvailable = Boolean(SourceMapConsumer && SourceMapGenerator);
-    var pathAvailable = Boolean(dirname5 && resolve5 && relative5 && sep4);
+    var pathAvailable = Boolean(dirname4 && resolve5 && relative5 && sep4);
     var MapGenerator = class {
       constructor(stringify2, root2, opts, cssString) {
         this.stringify = stringify2;
@@ -4406,7 +4406,7 @@ var require_map_generator = __commonJS({
       applyPrevMaps() {
         for (let prev of this.previous()) {
           let from = this.toUrl(this.path(prev.file));
-          let root2 = prev.root || dirname5(prev.file);
+          let root2 = prev.root || dirname4(prev.file);
           let map;
           if (this.mapOpts.sourcesContent === false) {
             map = new SourceMapConsumer(prev.text);
@@ -4601,9 +4601,9 @@ var require_map_generator = __commonJS({
         if (/^\w+:\/\//.test(file)) return file;
         let cached = this.memoizedPaths.get(file);
         if (cached) return cached;
-        let from = this.opts.to ? dirname5(this.opts.to) : ".";
+        let from = this.opts.to ? dirname4(this.opts.to) : ".";
         if (typeof this.mapOpts.annotation === "string") {
-          from = dirname5(resolve5(from, this.mapOpts.annotation));
+          from = dirname4(resolve5(from, this.mapOpts.annotation));
         }
         let path = relative5(from, file);
         this.memoizedPaths.set(file, path);
@@ -6152,11 +6152,58 @@ import { resolve as resolve4 } from "node:path";
 
 // src/cli/agentCommand.ts
 import { spawnSync } from "node:child_process";
-import { existsSync } from "node:fs";
+
+// src/project/mcpPackage.ts
+import { existsSync, readFileSync } from "node:fs";
 import { createRequire } from "node:module";
-import { dirname, join } from "node:path";
+import { dirname, join, parse } from "node:path";
+var MCP_PACKAGE = "@nudge-ui/mcp";
+var MCP_BIN = "nudge-mcp";
+function findProjectMcpRoot(appRoot) {
+  let directory2 = appRoot;
+  const { root: root2 } = parse(directory2);
+  for (; ; ) {
+    const candidate = join(directory2, "node_modules", "@nudge-ui", "mcp");
+    if (existsSync(join(candidate, "package.json"))) return candidate;
+    if (directory2 === root2) break;
+    directory2 = dirname(directory2);
+  }
+  if (!isPnpRuntime()) return null;
+  try {
+    return packageRootOf(createRequire(join(appRoot, "package.json")).resolve(MCP_PACKAGE));
+  } catch {
+    return null;
+  }
+}
+function projectMcpCliEntry(mcpRoot) {
+  const bin = readManifest(join(mcpRoot, "package.json"))?.bin;
+  const entry = typeof bin === "string" ? bin : isRecord(bin) ? bin[MCP_BIN] : void 0;
+  return typeof entry === "string" ? join(mcpRoot, entry) : null;
+}
+function packageRootOf(entry) {
+  for (let directory2 = dirname(entry); ; directory2 = dirname(directory2)) {
+    const manifest = join(directory2, "package.json");
+    if (existsSync(manifest) && readManifest(manifest)?.name === MCP_PACKAGE) return directory2;
+    if (dirname(directory2) === directory2) return null;
+  }
+}
+function readManifest(path) {
+  try {
+    const parsed = JSON.parse(readFileSync(path, "utf8"));
+    return isRecord(parsed) ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isPnpRuntime() {
+  return typeof process.versions.pnp === "string";
+}
+
+// src/cli/agentCommand.ts
 function planAgentCommand(args, projectRoot, packageVersion) {
-  const projectRequire = createRequire(join(projectRoot, "package.json"));
   if (args[0] === "setup") {
     if (!packageVersion || !/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.test(packageVersion)) {
       throw new Error("Run agent setup through the installed nudge-ui executable.");
@@ -6167,13 +6214,9 @@ function planAgentCommand(args, projectRoot, packageVersion) {
     };
   }
   if (args[0] === "doctor") {
-    let entry;
-    try {
-      const packageEntry = projectRequire.resolve(findLocalMcp(projectRoot, projectRequire));
-      entry = join(dirname(packageEntry), "cli.mjs");
-    } catch {
-      throw new Error("Nudge agent integration is not installed. Run nudge-ui agent setup.");
-    }
+    const mcpRoot = findProjectMcpRoot(projectRoot);
+    const entry = mcpRoot === null ? null : projectMcpCliEntry(mcpRoot);
+    if (entry === null) throw new Error("Nudge agent integration is not installed. Run nudge-ui agent setup.");
     return {
       executable: process.execPath,
       args: [entry, "doctor", "--workspace-root", projectRoot, ...args.slice(1)]
@@ -6181,20 +6224,6 @@ function planAgentCommand(args, projectRoot, packageVersion) {
   }
   throw new Error("Usage: nudge-ui agent <setup|doctor> [options]");
 }
-function findLocalMcp(projectRoot, projectRequire) {
-  let directory2 = projectRoot;
-  while (true) {
-    const candidate = join(directory2, "node_modules", "@nudge-ui", "mcp");
-    if (existsSync(join(candidate, "package.json"))) return candidate;
-    const parent = dirname(directory2);
-    if (parent === directory2) break;
-    directory2 = parent;
-  }
-  if (process.versions.pnp) {
-    return projectRequire.resolve("@nudge-ui/mcp");
-  }
-  throw new Error("MCP is not installed in this project.");
-}
 function runAgentCommand(args, packageVersion) {
   const command = planAgentCommand(args, process.cwd(), packageVersion);
   const result = spawnSync(command.executable, command.args, { cwd: process.cwd(), stdio: "inherit" });
@@ -6215,7 +6244,7 @@ function isHtmlArtifactRevision(value) {
 
 // src/project/artifacts.ts
 import { createHash } from "node:crypto";
-import { readFileSync, renameSync, writeFileSync } from "node:fs";
+import { readFileSync as readFileSync2, renameSync, writeFileSync } from "node:fs";
 import { mkdir, readFile, realpath, rename, rm, writeFile } from "node:fs/promises";
 import { isAbsolute, join as join2, relative, sep } from "node:path";
 
@@ -14171,7 +14200,7 @@ var VOID_ELEMENTS = /* @__PURE__ */ new Set([
 ]);
 
 // ../../node_modules/.pnpm/parse5@7.3.0/node_modules/parse5/dist/index.js
-function parse(html, options) {
+function parse2(html, options) {
   return Parser.parse(html, options);
 }
 
@@ -14181,7 +14210,7 @@ var MOUNT_MARKER = "data-nudge-ui-mount";
 function injectStandaloneBootstrap(html, options = {}) {
   const clientPath = options.clientPath ?? NUDGE_UI_CLIENT_PATH;
   const manifestPath = options.manifestPath ?? NUDGE_UI_MANIFEST_PATH;
-  const document2 = parse(html, { sourceCodeLocationInfo: true });
+  const document2 = parse2(html, { sourceCodeLocationInfo: true });
   const sourceFacts = inspectSource(document2, clientPath);
   const nodes = [];
   if (!sourceFacts.hasMount) {
@@ -14424,8 +14453,8 @@ async function handleHtmlArtifactRequest(request, response, root2, transformHtml
             await writeFile(temporary, html);
           }
           const latest = {
-            document: revision(readFileSync(join2(target, "document.html"))),
-            preview: revision(readFileSync(join2(target, "preview.html")))
+            document: revision(readFileSync2(join2(target, "document.html"))),
+            preview: revision(readFileSync2(join2(target, "preview.html")))
           };
           if (!sameRevision(latest, expected)) {
             respond(response, 409, HTML_ITERATION_CONFLICT);
@@ -14484,12 +14513,12 @@ import {
 } from "node:http";
 import {
   constants,
-  existsSync as existsSync3,
+  existsSync as existsSync2,
   realpathSync as realpathSync2,
   statSync as statSync2
 } from "node:fs";
 import { open, stat as stat2 } from "node:fs/promises";
-import { dirname as dirname4, extname as extname2, isAbsolute as isAbsolute4, join as join6, relative as relative4, resolve as resolve3 } from "node:path";
+import { dirname as dirname3, extname as extname2, isAbsolute as isAbsolute4, join as join6, relative as relative4, resolve as resolve3 } from "node:path";
 import { createRequire as createRequire3 } from "node:module";
 
 // src/html/dom.ts
@@ -14594,7 +14623,7 @@ function runIdentityPass(source, pass) {
     });
   };
   const parseErrors = [];
-  const document2 = parse(source, {
+  const document2 = parse2(source, {
     sourceCodeLocationInfo: true,
     onParseError: (error) => parseErrors.push(error)
   });
@@ -14679,9 +14708,8 @@ function instrumentSourceHtml(source, file) {
 }
 
 // src/hosts/projectBridge.ts
-import { existsSync as existsSync2 } from "node:fs";
 import { createRequire as createRequire2 } from "node:module";
-import { dirname as dirname2, join as join3, parse as parse2 } from "node:path";
+import { join as join3 } from "node:path";
 import { pathToFileURL } from "node:url";
 var runningBridges = /* @__PURE__ */ new Map();
 async function startOptionalProjectBridge(input) {
@@ -14698,7 +14726,7 @@ async function startOptionalProjectBridge(input) {
 async function launchOptionalProjectBridge(input, key) {
   let modulePath;
   try {
-    if (!isPnpRuntime() && !hasProjectInstalledMcp(input.appRoot)) {
+    if (findProjectMcpRoot(input.appRoot) === null) {
       runningBridges.delete(key);
       return null;
     }
@@ -14740,18 +14768,6 @@ async function launchOptionalProjectBridge(input, key) {
     return null;
   }
 }
-function isPnpRuntime() {
-  return typeof process.versions.pnp === "string";
-}
-function hasProjectInstalledMcp(appRoot) {
-  let directory2 = appRoot;
-  const root2 = parse2(directory2).root;
-  for (; ; ) {
-    if (existsSync2(join3(directory2, "node_modules", "@nudge-ui", "mcp", "package.json"))) return true;
-    if (directory2 === root2) return false;
-    directory2 = dirname2(directory2);
-  }
-}
 
 // src/project/tokens.ts
 import { createHash as createHash2 } from "node:crypto";
@@ -15457,7 +15473,7 @@ function comparePosixStrings(a, b) {
 import { watch } from "node:fs";
 import { readdir as readdir2 } from "node:fs/promises";
 import { realpathSync, statSync } from "node:fs";
-import { dirname as dirname3, isAbsolute as isAbsolute3, join as join5, relative as relative3, resolve as resolve2, sep as sep3 } from "node:path";
+import { dirname as dirname2, isAbsolute as isAbsolute3, join as join5, relative as relative3, resolve as resolve2, sep as sep3 } from "node:path";
 function createProjectFileWatcher(options) {
   const rootDirectory = realpathSync(resolve2(options.rootDirectory));
   const debounceMs = Math.max(0, options.debounceMs ?? 60);
@@ -15603,7 +15619,7 @@ function canonicalProjectPath(rootDirectory, path) {
     const canonical = realpathSync(path);
     return isWithin(rootDirectory, canonical) && !isSensitiveProjectPath(relative3(rootDirectory, canonical).split(sep3).join("/")) ? canonical : null;
   } catch {
-    const parent = dirname3(path);
+    const parent = dirname2(path);
     if (parent === path) return null;
     try {
       const canonicalParent = realpathSync(parent);
@@ -15817,13 +15833,13 @@ function resolveDecodedStaticFile(root2, decodedPath) {
   if (!isWithin2(root2, candidate)) return null;
   const canonicalCandidate = canonicalExistingAncestor(candidate);
   if (!canonicalCandidate || !isWithin2(root2, canonicalCandidate)) return null;
-  if (!existsSync3(candidate)) return null;
+  if (!existsSync2(candidate)) return null;
   let filePath = canonicalCandidate;
   const stats = statSync2(filePath);
   if (stats.isDirectory()) {
     const indexCandidate = join6(filePath, "index.html");
     const canonicalIndex = canonicalExistingAncestor(indexCandidate);
-    if (!canonicalIndex || !isWithin2(root2, canonicalIndex) || !existsSync3(indexCandidate)) {
+    if (!canonicalIndex || !isWithin2(root2, canonicalIndex) || !existsSync2(indexCandidate)) {
       return null;
     }
     if (!statSync2(canonicalIndex).isFile()) return null;
@@ -15903,7 +15919,7 @@ function canonicalExistingAncestor(candidate) {
       return realpathSync2(current);
     } catch (error) {
       if (!isMissingPathError(error)) return null;
-      const parent = dirname4(current);
+      const parent = dirname3(current);
       if (parent === current) return null;
       current = parent;
     }

package/dist/project/mcpPackage.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Locates the optional MCP package installed for an application. Only the
+ * application's own dependency tree counts; a global or unrelated copy never
+ * starts a bridge or answers diagnostics for this project.
+ */
+export declare function findProjectMcpRoot(appRoot: string): string | null;
+/** Absolute path of the installed package's `nudge-mcp` executable entry. */
+export declare function projectMcpCliEntry(mcpRoot: string): string | null;

package/dist/project/mcpPackage.js

@@ -0,0 +1,60 @@
+import { existsSync, readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join, parse } from "node:path";
+const MCP_PACKAGE = "@nudge-ui/mcp";
+const MCP_BIN = "nudge-mcp";
+/**
+ * Locates the optional MCP package installed for an application. Only the
+ * application's own dependency tree counts; a global or unrelated copy never
+ * starts a bridge or answers diagnostics for this project.
+ */
+export function findProjectMcpRoot(appRoot) {
+    let directory = appRoot;
+    const { root } = parse(directory);
+    for (;;) {
+        const candidate = join(directory, "node_modules", "@nudge-ui", "mcp");
+        if (existsSync(join(candidate, "package.json")))
+            return candidate;
+        if (directory === root)
+            break;
+        directory = dirname(directory);
+    }
+    if (!isPnpRuntime())
+        return null;
+    try {
+        return packageRootOf(createRequire(join(appRoot, "package.json")).resolve(MCP_PACKAGE));
+    }
+    catch {
+        return null;
+    }
+}
+/** Absolute path of the installed package's `nudge-mcp` executable entry. */
+export function projectMcpCliEntry(mcpRoot) {
+    const bin = readManifest(join(mcpRoot, "package.json"))?.bin;
+    const entry = typeof bin === "string" ? bin : isRecord(bin) ? bin[MCP_BIN] : undefined;
+    return typeof entry === "string" ? join(mcpRoot, entry) : null;
+}
+function packageRootOf(entry) {
+    for (let directory = dirname(entry);; directory = dirname(directory)) {
+        const manifest = join(directory, "package.json");
+        if (existsSync(manifest) && readManifest(manifest)?.name === MCP_PACKAGE)
+            return directory;
+        if (dirname(directory) === directory)
+            return null;
+    }
+}
+function readManifest(path) {
+    try {
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        return isRecord(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isPnpRuntime() {
+    return typeof process.versions.pnp === "string";
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nudge-ui",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "A design panel for your codebase. Development only.",
   "license": "MIT",
   "repository": {
@@ -68,6 +68,16 @@
       "import": "./dist/inspector/componentSemantics/runtimeBridge.js",
       "default": "./dist/inspector/componentSemantics/runtimeBridge.js"
     },
+    "./internal/page-inspector": {
+      "types": "./dist/inspector/pageInspector.d.ts",
+      "import": "./dist/inspector/pageInspector.js",
+      "default": "./dist/inspector/pageInspector.js"
+    },
+    "./internal/cursor-images": {
+      "types": "./dist/inspector/ui/customCursors.d.ts",
+      "import": "./dist/inspector/ui/customCursors.js",
+      "default": "./dist/inspector/ui/customCursors.js"
+    },
     "./internal/next/mount": {
       "types": "./dist/hosts/next/mount.d.ts",
       "import": "./dist/hosts/next/mount.js",
@@ -137,7 +147,7 @@
     "typecheck": "tsc --noEmit -p tsconfig.json",
     "test:unit": "vitest run --config vitest.unit.config.ts",
     "test:unit:watch": "vitest --config vitest.unit.config.ts",
-    "test:ui-integration": "vitest run src/inspector/styleEditors/LayoutSection.test.tsx src/inspector/styleEditors/LayoutComboField.test.tsx src/inspector/tokens/TokenDropdown.test.tsx src/inspector/ui/ui.test.tsx src/inspector/styleEditors/LayoutDropdown.test.tsx src/inspector/tokens/TokenField.test.tsx src/inspector/styleEditors/Typography.test.tsx src/inspector/styleEditors/BorderEditor.test.tsx src/inspector/styleEditors/AspectRatioField.test.tsx",
+    "test:ui-integration": "vitest run --config vitest.ui.config.ts",
     "test:unit:full": "vitest run"
   }
 }

package/dist/inspector/canvas/measurementProjection.d.ts

@@ -1,8 +0,0 @@
-import type { MeasurementSegment } from "../overlay/measurementGeometry.js";
-import type { Rect } from "../overlay/overlayGeometry.js";
-/**
- * Maps iframe-local measurement geometry into the Canvas board's screen
- * coordinate system. Distances deliberately remain in local CSS pixels so
- * their labels stay meaningful regardless of the board zoom.
- */
-export declare function projectMeasurementSegments(iframeRect: Rect, segments: MeasurementSegment[], zoom: number): MeasurementSegment[];

package/dist/inspector/canvas/measurementProjection.js

@@ -1,16 +0,0 @@
-/**
- * Maps iframe-local measurement geometry into the Canvas board's screen
- * coordinate system. Distances deliberately remain in local CSS pixels so
- * their labels stay meaningful regardless of the board zoom.
- */
-export function projectMeasurementSegments(iframeRect, segments, zoom) {
-    const projectPoint = (point) => ({
-        x: iframeRect.left + point.x * zoom,
-        y: iframeRect.top + point.y * zoom,
-    });
-    return segments.map((segment) => ({
-        ...segment,
-        from: projectPoint(segment.from),
-        to: projectPoint(segment.to),
-    }));
-}

package/dist/inspector/changes/changesLog.d.ts

@@ -1,49 +0,0 @@
-import type { StyleRule } from "../projection/managedStylesheet.js";
-import type { ChangeRecord } from "./types.js";
-import { type CommitResult } from "./draftChanges.js";
-import type { StructuralChange } from "./structuralTypes.js";
-export { isComponentChange, isElementChange, isTextContentChange, isTextContentChangeValue, isPreviewableChange, isTokenChange, } from "./types.js";
-export type { ChangeRecord, ComponentChangeRecord, ElementChangeRecord, PreviewableChangeRecord, TextContentChangeRecord, TokenChangeRecord, RuntimeElementEvidence, SourceElementEvidence, } from "./types.js";
-export interface AppendChangesOptions {
-    /** The rendered target captured for each change key at commit time. */
-    verificationTargets?: ReadonlyMap<string, HTMLElement | null>;
-}
-declare function subscribe(cb: () => void): () => void;
-declare function getChangesSnapshot(): ChangeRecord[];
-export declare function getPendingRules(): StyleRule[];
-/** Append records and report whether canonical workspace state changed. */
-export declare function appendChanges(incoming: ChangeRecord[], options?: AppendChangesOptions): CommitResult;
-export declare function appendChange(change: ChangeRecord): CommitResult;
-export declare function revertChange(change: ChangeRecord): void;
-/**
- * Removes source-verified records without allowing older undo snapshots to
- * resurrect their managed previews.
- *
- * Agent handoff revisions identify records by the same stable key used by the
- * canonical change model. Verification can therefore reconcile a subset while
- * preserving newer, unsent edits and their remaining undo history.
- */
-export declare function reconcileVerifiedChanges(verifiedKeys: ReadonlySet<string>): number;
-/** Atomically reconciles ordinary and structural intent from one agent handoff. */
-export declare function reconcileVerifiedDraftChanges(verifiedKeys: ReadonlySet<string>, verifiedStructuralIds: ReadonlySet<string>): number;
-/** Replaces ordinary and structural intent as one undoable edit. */
-export declare function commitDraftContents(changes: readonly ChangeRecord[], structuralChanges: readonly StructuralChange[]): boolean;
-export declare function discardChangesForSelector(selector: string): void;
-/** Relink removes every CSS declaration owned by one durable rendered target. */
-export declare function discardChangesForInstanceOverride(overrideId: string): void;
-export declare function undo(): boolean;
-export declare function redo(): boolean;
-/**
- * Replaces ordinary records while preserving structural intent. Restoring any
- * dimension is terminal for the unified workspace timeline, so undo and redo
- * history are reset for both dimensions.
- */
-export declare function restoreChangeRecords(incoming: ChangeRecord[]): void;
-/** Restores every canonical workspace intent as one subscriber-visible snapshot. */
-export declare function loadActiveDraftChanges(incoming: readonly ChangeRecord[], structuralChanges: readonly StructuralChange[], preserveHistory?: boolean): void;
-/** Clears the active draft and its edit steps, preserving other session history. */
-export declare function clearActiveDraft(): void;
-export declare function getChangesList(): ChangeRecord[];
-export { subscribe as subscribeChanges, getChangesSnapshot as getChanges };
-export declare function useChanges(): ChangeRecord[];
-export declare function refreshDraftPreview(): void;