nudge-ui 0.2.4 → 0.2.6

package/dist/project/files.js

@@ -1,16 +1,10 @@
-/**
- * Node's recursive `fs.watch` is not available on every supported platform, so
- * this watches each directory and adds watches for ones created later. The
- * public surface is lifecycle and settled batches; debounce and symlink
- * confinement stay internal.
- */
+/** Node's recursive `fs.watch` is not available on every supported platform, so directories are watched individually. */
 import { watch } from "node:fs";
 import { readdir } from "node:fs/promises";
 import { realpathSync, statSync } from "node:fs";
 import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { isExcludedDirectoryName, isSensitiveProjectPath } from "./pathPolicy.js";
 export { isExcludedDirectoryName, isSensitiveProjectPath } from "./pathPolicy.js";
-/** Creates a watcher that starts and stops explicitly with the server. */
 export function createProjectFileWatcher(options) {
     const rootDirectory = realpathSync(resolve(options.rootDirectory));
     const debounceMs = Math.max(0, options.debounceMs ?? 60);
@@ -85,8 +79,7 @@ export function createProjectFileWatcher(options) {
             return;
         }
         watches.set(directory, { directory, canonicalDirectory, watcher: directoryWatcher });
-        // Watch before scanning so events during the async walk are not missed. Scans
-        // run serially and re-check `closed` after every await, so none leak past close().
+        // Watch before scanning so events during the async walk are not missed.
         pendingScans += 1;
         scanQueue = scanQueue
             .then(() => scanSubdirectories(directory))

package/dist/project/identity.d.ts

@@ -1,6 +1,2 @@
-/**
- * Names a project deterministically across restarts. The root is canonicalized
- * first, so a symlinked working directory resolves to the same project — and
- * therefore the same durable session — as its real path.
- */
+/** The root is canonicalized first so a symlinked working directory names the same project as its real path. */
 export declare function createProjectId(host: string, root: string): string;

package/dist/project/identity.js

@@ -1,11 +1,7 @@
 import { createHash } from "node:crypto";
 import { realpathSync } from "node:fs";
 const PROJECT_DIGEST_LENGTH = 24;
-/**
- * Names a project deterministically across restarts. The root is canonicalized
- * first, so a symlinked working directory resolves to the same project — and
- * therefore the same durable session — as its real path.
- */
+/** The root is canonicalized first so a symlinked working directory names the same project as its real path. */
 export function createProjectId(host, root) {
     let canonical = root;
     try {

package/dist/project/mcpPackage.d.ts

@@ -0,0 +1,3 @@
+/** Only the application's own dependency tree counts; a global or unrelated copy never bridges this project. */
+export declare function findProjectMcpRoot(appRoot: string): string | null;
+export declare function projectMcpCliEntry(mcpRoot: string): string | null;

package/dist/project/mcpPackage.js

@@ -0,0 +1,55 @@
+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";
+/** Only the application's own dependency tree counts; a global or unrelated copy never bridges 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;
+    }
+}
+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 "pnp" in process.versions && typeof process.versions.pnp === "string";
+}

package/dist/project/pathPolicy.d.ts

@@ -1,8 +1,3 @@
-/**
- * Dot-prefixed segments commonly hold credentials, source-control metadata, or
- * local tool state. Treating the whole segment as sensitive keeps one policy
- * across direct requests, symlink targets, token discovery, and file watching.
- */
+/** Dot-prefixed segments may hold credentials or local tool state; one policy covers requests, symlinks, tokens, and watching. */
 export declare function isSensitiveProjectPath(projectPath: string): boolean;
-/** Returns whether a directory name is outside the standalone project view. */
 export declare function isExcludedDirectoryName(name: string): boolean;

package/dist/project/pathPolicy.js

@@ -1,12 +1,7 @@
-/**
- * Dot-prefixed segments commonly hold credentials, source-control metadata, or
- * local tool state. Treating the whole segment as sensitive keeps one policy
- * across direct requests, symlink targets, token discovery, and file watching.
- */
+/** Dot-prefixed segments may hold credentials or local tool state; one policy covers requests, symlinks, tokens, and watching. */
 export function isSensitiveProjectPath(projectPath) {
     return projectPath.split(/[\\/]/).some((segment) => segment.startsWith("."));
 }
-/** Returns whether a directory name is outside the standalone project view. */
 export function isExcludedDirectoryName(name) {
     return name.startsWith(".") || name === "build" || name === "dist" || name === "node_modules";
 }

package/dist/project/tokens.d.ts

@@ -1,36 +1,26 @@
 import type { TokenCatalogDiagnostic, TokenDefinition, TokenEntry } from "../css/model/index.js";
-/** The serializable token knowledge published by the standalone manifest. */
 export interface ProjectTokenSnapshot {
     readonly tokenCatalog: readonly TokenDefinition[];
     readonly tokens: readonly TokenEntry[];
     readonly tokenDiagnostics: readonly TokenCatalogDiagnostic[];
     readonly tokenGeneration: string;
 }
-/** The placeholder used before and in place of a successful project scan. */
 export declare const EMPTY_PROJECT_TOKEN_SNAPSHOT: ProjectTokenSnapshot;
-/** A CSS file discovered below the project root before inventory parsing. */
 export interface ProjectCssArtifact {
     readonly absolutePath: string;
     readonly projectPath: string;
     readonly content?: string;
     readonly readError?: string;
 }
-/** Injectable so unreadable-file handling stays testable. */
 export type ProjectCssFileReader = (absolutePath: string) => string | Promise<string>;
-/** Options for the deterministic project CSS scan. */
 export interface ProjectTokenSnapshotOptions {
     readonly rootDirectory: string;
-    /** Additional authored roots to include in the same deterministic inventory. */
     readonly additionalRootDirectories?: readonly string[];
     readonly readFile?: ProjectCssFileReader;
     /** Prefixed to the digest so two hosts scanning one project publish distinct generations. */
     readonly generationLabel: string;
 }
-/**
- * Files are sorted by project-relative POSIX path before receiving
- * discoveryOrder. Symlinks are followed only when their canonical target stays
- * below rootDirectory. Read and parse failures become diagnostics, never rejections.
- */
+/** Sorted by project-relative POSIX path; symlinks only within root; read failures become diagnostics, never rejections. */
 export declare function createProjectTokenSnapshot(options: ProjectTokenSnapshotOptions): Promise<ProjectTokenSnapshot>;
-/** Exported as a seam so provenance and symlink confinement are testable without PostCSS. */
+/** Exported for tests: provenance and symlink confinement without PostCSS. */
 export declare function discoverProjectCssArtifacts(rootDirectory: string, readFile?: ProjectCssFileReader): Promise<readonly ProjectCssArtifact[]>;

package/dist/project/tokens.js

@@ -1,26 +1,16 @@
-/**
- * Node-only CSS token discovery for the static HTML host. Reports directory
- * order as discovery evidence only: a directory walk cannot prove the order in
- * which a browser applies stylesheets. Every filesystem operation is async so a
- * large tree never blocks the server's event loop.
- */
+/** Directory order is discovery evidence only; a walk cannot prove the order a browser applies stylesheets. */
 import { createHash } from "node:crypto";
 import { readFile as readUtf8File, readdir, realpath, stat, } from "node:fs/promises";
 import { extname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { createTokenInventory, } from "../css/token-inventory/index.js";
 import { isExcludedDirectoryName, isSensitiveProjectPath } from "./pathPolicy.js";
-/** The placeholder used before and in place of a successful project scan. */
 export const EMPTY_PROJECT_TOKEN_SNAPSHOT = {
     tokenCatalog: [],
     tokens: [],
     tokenDiagnostics: [],
     tokenGeneration: "empty",
 };
-/**
- * Files are sorted by project-relative POSIX path before receiving
- * discoveryOrder. Symlinks are followed only when their canonical target stays
- * below rootDirectory. Read and parse failures become diagnostics, never rejections.
- */
+/** Sorted by project-relative POSIX path; symlinks only within root; read failures become diagnostics, never rejections. */
 export async function createProjectTokenSnapshot(options) {
     const rootDirectory = await canonicalRoot(options.rootDirectory);
     const additionalRoots = (await Promise.all((options.additionalRootDirectories ?? []).map((directory) => canonicalOptionalRoot(directory)))).filter((root) => root !== null);
@@ -34,8 +24,7 @@ export async function createProjectTokenSnapshot(options) {
             if (seenFiles.has(canonicalPath))
                 continue;
             seenFiles.add(canonicalPath);
-            // Additional roots are expressed relative to the primary one so a single
-            // inventory can merge their declarations without losing provenance.
+            // Additional roots are expressed relative to the primary so one inventory keeps provenance.
             artifacts.push({
                 ...artifact,
                 projectPath: index === 0
@@ -85,7 +74,7 @@ export async function createProjectTokenSnapshot(options) {
         tokenGeneration,
     };
 }
-/** Exported as a seam so provenance and symlink confinement are testable without PostCSS. */
+/** Exported for tests: provenance and symlink confinement without PostCSS. */
 export async function discoverProjectCssArtifacts(rootDirectory, readFile = (absolutePath) => readUtf8File(absolutePath, "utf8")) {
     const root = await canonicalRoot(rootDirectory);
     const artifacts = [];

package/dist/transport/editor.d.ts

@@ -1,23 +1,13 @@
-/** Returns the editor URL for one same-origin application location. */
 export declare function createNudgeUiEditorUrl(applicationHref: string): string;
-/** Resolves the application URL carried by an editor URL. */
 export declare function readNudgeUiEditorTarget(editorHref: string): string | null;
 type RequestHeaderValue = string | readonly string[] | undefined;
-/** Returns whether a host request should receive the pure editor document. */
 export declare function isNudgeUiEditorDocumentRequest(requestHref: string, method: string | undefined, headers: Record<string, RequestHeaderValue> | undefined): boolean;
-/** Adds the persistent marker that bypasses editor entry for a plain app view. */
 export declare function createNudgeUiDirectUrl(applicationHref: string): string;
-/** Reads the public `nudge-ui=off` / `nudge-ui=on` switch from an application URL. */
 export declare function readNudgeUiQuerySwitch(href: string): "off" | "on" | null;
-/** Returns whether this application location explicitly bypasses editor entry. */
 export declare function isNudgeUiDirectUrl(href: string): boolean;
-/** Remembers that this browser tab was explicitly opened outside the editor. */
 export declare function rememberNudgeUiDirectTabIntent(): void;
-/** Remembers an explicit URL switch so later navigations in this tab keep it. */
 export declare function rememberNudgeUiTabSwitch(value: "off" | "on"): void;
-/** Returns whether this browser tab should remain outside the editor. */
 export declare function hasNudgeUiDirectTabIntent(): boolean;
-/** Returns whether this browser tab explicitly asked for the editor with `nudge-ui=on`. */
 export declare function hasNudgeUiForcedTabIntent(): boolean;
 export type NudgeUiClientEntry = {
     readonly kind: "bootstrap";
@@ -40,8 +30,7 @@ export interface NudgeUiClientEntryContext {
     /** `navigator.webdriver`: Playwright, Puppeteer, Selenium, and headless Chrome. */
     readonly automated?: boolean;
 }
-/** Chooses the browser-client role before any runtime manifest is fetched. */
+/** Resolved before any runtime manifest is fetched. */
 export declare function resolveNudgeUiClientEntry(href: string, context: NudgeUiClientEntryContext): NudgeUiClientEntry;
-/** Renders the host-neutral editor document served by every development Adapter. */
 export declare function createNudgeUiEditorDocument(): string;
 export {};

package/dist/transport/editor.js

@@ -2,7 +2,6 @@ import { NUDGE_UI_CLIENT_PATH, NUDGE_UI_ARTIFACTS_PATH, NUDGE_UI_DIRECT_QUERY_PA
 const TARGET_QUERY_PARAM = "url";
 const DIRECT_TAB_SESSION_KEY = "nudge-ui:direct-tab";
 const FORCED_TAB_SESSION_KEY = "nudge-ui:forced-tab";
-/** Returns the editor URL for one same-origin application location. */
 export function createNudgeUiEditorUrl(applicationHref) {
     const applicationUrl = new URL(applicationHref);
     assertApplicationUrl(applicationUrl);
@@ -23,7 +22,6 @@ export function createNudgeUiEditorUrl(applicationHref) {
     applicationUrl.hash = hash;
     return applicationUrl.href;
 }
-/** Resolves the application URL carried by an editor URL. */
 export function readNudgeUiEditorTarget(editorHref) {
     const editorUrl = new URL(editorHref);
     if (editorUrl.pathname !== NUDGE_UI_EDITOR_PATH) {
@@ -50,7 +48,6 @@ export function readNudgeUiEditorTarget(editorHref) {
         return null;
     }
 }
-/** Returns whether a host request should receive the pure editor document. */
 export function isNudgeUiEditorDocumentRequest(requestHref, method, headers) {
     const normalizedMethod = (method ?? "GET").toUpperCase();
     if (normalizedMethod !== "GET" && normalizedMethod !== "HEAD")
@@ -69,14 +66,12 @@ export function isNudgeUiEditorDocumentRequest(requestHref, method, headers) {
     return header("sec-fetch-dest").toLowerCase() === "document"
         || header("accept").toLowerCase().includes("text/html");
 }
-/** Adds the persistent marker that bypasses editor entry for a plain app view. */
 export function createNudgeUiDirectUrl(applicationHref) {
     const url = new URL(applicationHref);
     assertApplicationUrl(url);
     url.searchParams.set(NUDGE_UI_DIRECT_QUERY_PARAM, "1");
     return url.href;
 }
-/** Reads the public `nudge-ui=off` / `nudge-ui=on` switch from an application URL. */
 export function readNudgeUiQuerySwitch(href) {
     const url = new URL(href);
     const values = url.searchParams.getAll(NUDGE_UI_EDITOR_QUERY_PARAM);
@@ -85,15 +80,12 @@ export function readNudgeUiQuerySwitch(href) {
     }
     return values.includes(NUDGE_UI_ON_QUERY_VALUE) ? "on" : null;
 }
-/** Returns whether this application location explicitly bypasses editor entry. */
 export function isNudgeUiDirectUrl(href) {
     return readNudgeUiQuerySwitch(href) === "off";
 }
-/** Remembers that this browser tab was explicitly opened outside the editor. */
 export function rememberNudgeUiDirectTabIntent() {
     rememberNudgeUiTabSwitch("off");
 }
-/** Remembers an explicit URL switch so later navigations in this tab keep it. */
 export function rememberNudgeUiTabSwitch(value) {
     try {
         sessionStorage.setItem(value === "off" ? DIRECT_TAB_SESSION_KEY : FORCED_TAB_SESSION_KEY, "1");
@@ -103,11 +95,9 @@ export function rememberNudgeUiTabSwitch(value) {
         // Storage denial must not prevent the current page from honoring the switch.
     }
 }
-/** Returns whether this browser tab should remain outside the editor. */
 export function hasNudgeUiDirectTabIntent() {
     return readTabFlag(DIRECT_TAB_SESSION_KEY);
 }
-/** Returns whether this browser tab explicitly asked for the editor with `nudge-ui=on`. */
 export function hasNudgeUiForcedTabIntent() {
     return readTabFlag(FORCED_TAB_SESSION_KEY);
 }
@@ -119,7 +109,7 @@ function readTabFlag(key) {
         return false;
     }
 }
-/** Chooses the browser-client role before any runtime manifest is fetched. */
+/** Resolved before any runtime manifest is fetched. */
 export function resolveNudgeUiClientEntry(href, context) {
     if (context.editorDocument || context.canvasRenderer)
         return { kind: "bootstrap" };
@@ -147,14 +137,13 @@ function assertApplicationUrl(url) {
         throw new TypeError("Nudge UI application URLs must be HTTP(S) URLs outside its reserved route namespace.");
     }
 }
-/** Renders the host-neutral editor document served by every development Adapter. */
 export function createNudgeUiEditorDocument() {
     return `<!doctype html>
 <html lang="en" data-nudge-ui-editor>
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>Nudge UI</title>
+  <title></title>
   <style>html,body,#${NUDGE_UI_MOUNT_ID}{width:100%;height:100%;margin:0}body{overflow:hidden}</style>
 </head>
 <body>

package/dist/transport/index.d.ts

@@ -1,8 +1,3 @@
-/**
- * The wire contract between any host and the browser client. Must stay
- * browser-safe: the inspector's mount components import these routes directly.
- * Anything needing Node belongs in `project/`.
- */
 export * from "./routes.js";
 export * from "./editor.js";
 /** Envelope version understood by the browser client. */

package/dist/transport/index.js

@@ -1,8 +1,3 @@
-/**
- * The wire contract between any host and the browser client. Must stay
- * browser-safe: the inspector's mount components import these routes directly.
- * Anything needing Node belongs in `project/`.
- */
 export * from "./routes.js";
 export * from "./editor.js";
 /** Envelope version understood by the browser client. */

package/dist/transport/routes.d.ts

@@ -1,8 +1,3 @@
-/**
- * The reserved URL namespace every host serves the inspector through. Hosts
- * own their own middleware and reload policy, but the paths are one contract:
- * the browser client is built once and requests the same URLs everywhere.
- */
 /** A host must not serve project files here. */
 export declare const NUDGE_UI_ROUTE_PREFIX = "/__nudge_ui__/";
 export declare const NUDGE_UI_MANIFEST_PATH = "/__nudge_ui__/manifest";

package/dist/transport/routes.js

@@ -1,8 +1,3 @@
-/**
- * The reserved URL namespace every host serves the inspector through. Hosts
- * own their own middleware and reload policy, but the paths are one contract:
- * the browser client is built once and requests the same URLs everywhere.
- */
 /** A host must not serve project files here. */
 export const NUDGE_UI_ROUTE_PREFIX = "/__nudge_ui__/";
 export const NUDGE_UI_MANIFEST_PATH = `${NUDGE_UI_ROUTE_PREFIX}manifest`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nudge-ui",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "A design panel for your codebase. Development only.",
   "license": "MIT",
   "repository": {
@@ -59,15 +59,25 @@
       "default": "./dist/inspector/index.js"
     },
     "./internal/component-runtime": {
-      "types": "./dist/inspector/componentSemantics/reactRuntime.d.ts",
-      "import": "./dist/inspector/componentSemantics/reactRuntime.js",
-      "default": "./dist/inspector/componentSemantics/reactRuntime.js"
+      "types": "./dist/inspector/componentSemantics/react/runtime.d.ts",
+      "import": "./dist/inspector/componentSemantics/react/runtime.js",
+      "default": "./dist/inspector/componentSemantics/react/runtime.js"
     },
     "./internal/host-runtime": {
       "types": "./dist/inspector/componentSemantics/runtimeBridge.d.ts",
       "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",
@@ -133,11 +143,12 @@
     "access": "public"
   },
   "scripts": {
+    "dev:client": "node scripts/watch-inspector-client.mjs",
     "build": "node ../../scripts/build-package.mjs && node ../../scripts/vendor-agent-protocol.mjs && node scripts/build-inspector-client.mjs && node scripts/build-next-loaders.mjs && node scripts/build-static-cli.mjs",
     "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;