@abbox/inspector 0.0.0-stage → 0.3.0

package/dist/next/preview-env.d.ts

@@ -0,0 +1,15 @@
+export type AbboxInspectionMode = "preview" | "production";
+/**
+ * When true, Inspector instrumentation, CSP frame-ancestors, and client bootstrap are allowed.
+ * Preview Vercel deploys stay on by default; production deploys require explicit
+ * `ABBBOX_INSPECTION_MODE=production` (set by @abbox/cli production mode).
+ */
+export declare function isAbboxInspectorBuildEnabled(): boolean;
+/** Baked inspection mode in the client bundle (not query parameters). */
+export declare function getBakedInspectionMode(): AbboxInspectionMode | "off";
+/** Client-side: Inspector may connect to the Viewer iframe host. */
+export declare function isAbboxInspectorRuntimeEnabled(): boolean;
+export declare function isAbboxInspectorProductionRuntime(): boolean;
+/** Primary Viewer origin baked at install time (production mode host validation). */
+export declare function getBakedViewerOrigin(): string | undefined;
+//# sourceMappingURL=preview-env.d.ts.map

package/dist/next/preview-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-env.d.ts","sourceRoot":"","sources":["../../src/next/preview-env.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,YAAY,CAAC;AAE3D;;;;GAIG;AACH,wBAAgB,4BAA4B,IAAI,OAAO,CAKtD;AAED,yEAAyE;AACzE,wBAAgB,sBAAsB,IAAI,mBAAmB,GAAG,KAAK,CAOpE;AAED,oEAAoE;AACpE,wBAAgB,8BAA8B,IAAI,OAAO,CAExD;AAED,wBAAgB,iCAAiC,IAAI,OAAO,CAE3D;AAED,qFAAqF;AACrF,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,SAAS,CAGzD"}

package/dist/next/preview-env.js

@@ -0,0 +1,39 @@
+/**
+ * When true, Inspector instrumentation, CSP frame-ancestors, and client bootstrap are allowed.
+ * Preview Vercel deploys stay on by default; production deploys require explicit
+ * `ABBBOX_INSPECTION_MODE=production` (set by @abbox/cli production mode).
+ */
+export function isAbboxInspectorBuildEnabled() {
+    if (process.env.ABBBOX_INSPECTOR === "1")
+        return true;
+    if (process.env.ABBBOX_INSPECTION_MODE === "production")
+        return true;
+    if (process.env.VERCEL_ENV === "preview")
+        return true;
+    return false;
+}
+/** Baked inspection mode in the client bundle (not query parameters). */
+export function getBakedInspectionMode() {
+    const explicit = process.env.NEXT_PUBLIC_ABBOX_INSPECTION_MODE;
+    if (explicit === "production")
+        return "production";
+    if (explicit === "preview")
+        return "preview";
+    if (process.env.NEXT_PUBLIC_ABBOX_INSPECTOR === "1")
+        return "preview";
+    if (process.env.NEXT_PUBLIC_VERCEL_ENV === "preview")
+        return "preview";
+    return "off";
+}
+/** Client-side: Inspector may connect to the Viewer iframe host. */
+export function isAbboxInspectorRuntimeEnabled() {
+    return getBakedInspectionMode() !== "off";
+}
+export function isAbboxInspectorProductionRuntime() {
+    return getBakedInspectionMode() === "production";
+}
+/** Primary Viewer origin baked at install time (production mode host validation). */
+export function getBakedViewerOrigin() {
+    const raw = process.env.NEXT_PUBLIC_ABBOX_VIEWER_ORIGIN;
+    return raw?.trim() ? raw.replace(/\/$/, "") : undefined;
+}

package/dist/next/webpack-instrumentation.cjs

@@ -0,0 +1,82 @@
+/**
+ * Apply Abbox JSX instrumentation via webpack + babel-loader on selected app sources.
+ * Does not use babel.config.js, so Next.js keeps SWC (and next/font) for excluded files
+ * such as app/layout.tsx.
+ */
+const fs = require("node:fs");
+const path = require("node:path");
+const { createRequire } = require("node:module");
+
+const LAYOUT_BASENAMES = new Set(["layout.tsx", "layout.jsx"]);
+
+function resolveInspectorBabelPlugin(rootDir) {
+  const req = createRequire(path.join(rootDir, "package.json"));
+  try {
+    return req.resolve("@abbox/inspector/babel");
+  } catch {
+    return req.resolve("abbox-inspector/babel");
+  }
+}
+
+function resolveBabelLoader(rootDir) {
+  const req = createRequire(path.join(rootDir, "package.json"));
+  return req.resolve("babel-loader");
+}
+
+function resolveNextBabelPreset(rootDir) {
+  const req = createRequire(path.join(rootDir, "package.json"));
+  return req.resolve("next/babel");
+}
+
+function collectIncludeDirs(rootDir) {
+  return ["app", "components", "src", "pages"]
+    .map((segment) => path.join(rootDir, segment))
+    .filter((dir) => fs.existsSync(dir));
+}
+
+function isRootLayoutResource(resourcePath) {
+  const base = path.basename(resourcePath);
+  if (!LAYOUT_BASENAMES.has(base)) return false;
+  const parent = path.basename(path.dirname(resourcePath));
+  return parent === "app" || parent === "src/app";
+}
+
+/**
+ * @param {import('webpack').Configuration} webpackConfig
+ * @param {{ dir: string }} options
+ */
+function applyAbboxWebpackInstrumentation(webpackConfig, options) {
+  const rootDir = options.dir ?? process.cwd();
+  const pluginPath = resolveInspectorBabelPlugin(rootDir);
+  const babelLoader = resolveBabelLoader(rootDir);
+  const nextBabel = resolveNextBabelPreset(rootDir);
+  const includeDirs = collectIncludeDirs(rootDir);
+
+  if (includeDirs.length === 0) {
+    return webpackConfig;
+  }
+
+  const rule = {
+    test: /\.(tsx|jsx)$/,
+    include: (resourcePath) =>
+      includeDirs.some((dir) => resourcePath.startsWith(dir)) &&
+      !isRootLayoutResource(resourcePath),
+    exclude: [/node_modules/],
+    use: {
+      loader: babelLoader,
+      options: {
+        babelrc: false,
+        configFile: false,
+        presets: [nextBabel],
+        plugins: [[pluginPath, { rootDir }]],
+      },
+    },
+  };
+
+  webpackConfig.module = webpackConfig.module ?? { rules: [] };
+  webpackConfig.module.rules = webpackConfig.module.rules ?? [];
+  webpackConfig.module.rules.unshift(rule);
+  return webpackConfig;
+}
+
+module.exports = { applyAbboxWebpackInstrumentation, isRootLayoutResource };

package/dist/next/with-abbox-inspector.d.ts

@@ -0,0 +1,31 @@
+export type NextConfigLike = {
+    env?: Record<string, string | undefined>;
+    headers?: unknown;
+    webpack?: (config: Record<string, unknown>, options: Record<string, unknown>) => Record<string, unknown> | void;
+    transpilePackages?: unknown;
+    [key: string]: unknown;
+};
+export type WithAbboxInspectorOptions = {
+    /** When false, returns config unchanged (default: build gate in preview-env). */
+    enabled?: boolean;
+    /**
+     * Origins allowed to embed this app in an iframe (Abbox Viewer).
+     * Defaults to hosted viewer + common local Viewer ports.
+     */
+    frameAncestors?: string[];
+    /**
+     * Primary Viewer origin for production-mode postMessage validation.
+     * Defaults to the first `frameAncestors` entry.
+     */
+    viewerOrigin?: string;
+};
+export declare const DEFAULT_VIEWER_FRAME_ANCESTORS: string[];
+/**
+ * Merge Next.js config for Abbox inspection: iframe embedding headers
+ * and public env flags for client bootstrap.
+ *
+ * JSX instrumentation uses a webpack babel-loader rule (no root babel.config.js),
+ * so `next/font` in app/layout.tsx can keep using SWC.
+ */
+export declare function withAbboxInspector<T>(config: T, options?: WithAbboxInspectorOptions): T;
+//# sourceMappingURL=with-abbox-inspector.d.ts.map

package/dist/next/with-abbox-inspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-abbox-inspector.d.ts","sourceRoot":"","sources":["../../src/next/with-abbox-inspector.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,cAAc,GAAG;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,CACR,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACpC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAIF,eAAO,MAAM,8BAA8B,UAM1C,CAAC;AAcF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,MAAM,EAAE,CAAC,EACT,OAAO,GAAE,yBAA8B,GACtC,CAAC,CAiFH"}

package/dist/next/with-abbox-inspector.js

@@ -0,0 +1,92 @@
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
+const require = createRequire(fileURLToPath(import.meta.url));
+import { isAbboxInspectorBuildEnabled } from "./preview-env.js";
+export const DEFAULT_VIEWER_FRAME_ANCESTORS = [
+    "https://viewer.abbox.com",
+    "http://localhost:5173",
+    "http://127.0.0.1:5173",
+    "http://localhost:4173",
+    "http://127.0.0.1:4173",
+];
+function inspectorEnabled(explicit) {
+    if (explicit !== undefined)
+        return explicit;
+    return isAbboxInspectorBuildEnabled();
+}
+function bakedInspectionMode() {
+    if (process.env.ABBBOX_INSPECTION_MODE === "production") {
+        return "production";
+    }
+    return "preview";
+}
+/**
+ * Merge Next.js config for Abbox inspection: iframe embedding headers
+ * and public env flags for client bootstrap.
+ *
+ * JSX instrumentation uses a webpack babel-loader rule (no root babel.config.js),
+ * so `next/font` in app/layout.tsx can keep using SWC.
+ */
+export function withAbboxInspector(config, options = {}) {
+    if (!inspectorEnabled(options.enabled)) {
+        return config;
+    }
+    const base = config;
+    const { applyAbboxWebpackInstrumentation } = require("./webpack-instrumentation.cjs");
+    const ancestors = options.frameAncestors ?? DEFAULT_VIEWER_FRAME_ANCESTORS;
+    const viewerOrigin = options.viewerOrigin?.replace(/\/$/, "") ??
+        ancestors.find((a) => a.startsWith("https://")) ??
+        ancestors[0];
+    const csp = `frame-ancestors 'self' ${ancestors.join(" ")}`;
+    const mode = bakedInspectionMode();
+    const headers = async () => {
+        const existing = typeof base.headers === "function"
+            ? await base.headers()
+            : (base.headers ?? []);
+        return [
+            ...existing,
+            {
+                source: "/:path*",
+                headers: [
+                    {
+                        key: "Content-Security-Policy",
+                        value: csp,
+                    },
+                ],
+            },
+        ];
+    };
+    const transpile = new Set([
+        ...(Array.isArray(base.transpilePackages)
+            ? base.transpilePackages
+            : []),
+        "@abbox/inspector",
+        "abbox-inspector",
+    ]);
+    const userWebpack = base.webpack;
+    const webpack = (webpackConfig, webpackOptions) => {
+        let cfg = webpackConfig;
+        if (typeof userWebpack === "function") {
+            const nextCfg = userWebpack(cfg, webpackOptions);
+            if (nextCfg)
+                cfg = nextCfg;
+        }
+        const dir = typeof webpackOptions.dir === "string"
+            ? webpackOptions.dir
+            : process.cwd();
+        return applyAbboxWebpackInstrumentation(cfg, { dir });
+    };
+    return {
+        ...base,
+        transpilePackages: [...transpile],
+        env: {
+            ...(base.env ?? {}),
+            NEXT_PUBLIC_ABBOX_INSPECTOR: "1",
+            NEXT_PUBLIC_ABBOX_INSPECTION_MODE: mode,
+            NEXT_PUBLIC_ABBOX_VIEWER_ORIGIN: viewerOrigin,
+            NEXT_PUBLIC_VERCEL_ENV: process.env.VERCEL_ENV ?? "",
+        },
+        headers,
+        webpack,
+    };
+}

package/dist/protocol.d.ts

@@ -0,0 +1,92 @@
+/** Wire protocol between Abbox Viewer (host) and instrumented preview (client). */
+export declare const PROTOCOL_VERSION: 1;
+export declare const ABBBOX_INSPECTOR_CHANNEL: "abbox-inspector";
+export type InspectorMessageBase = {
+    channel: typeof ABBBOX_INSPECTOR_CHANNEL;
+    version: typeof PROTOCOL_VERSION;
+    sessionId: string;
+};
+export type InspectorReadyMessage = InspectorMessageBase & {
+    type: "INSPECTOR_READY";
+    previewUrl: string;
+};
+export type InspectorEnableMessage = InspectorMessageBase & {
+    type: "INSPECTOR_ENABLE";
+};
+export type InspectorDisableMessage = InspectorMessageBase & {
+    type: "INSPECTOR_DISABLE";
+};
+/** Host asks the preview client to resend INSPECTOR_READY (e.g. after iframe load). */
+export type InspectorHostHelloMessage = InspectorMessageBase & {
+    type: "INSPECTOR_HOST_HELLO";
+};
+export type ElementRect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export type SourceLocation = {
+    /** Project-relative path (no absolute filesystem paths). */
+    file: string;
+    line: number;
+    column: number;
+    /** Raw attribute value when present on DOM. */
+    raw?: string;
+};
+export type SourceMappingStatus = "resolved" | "unresolved" | "partial";
+export type ElementMetadata = {
+    tagName: string;
+    id: string | null;
+    classList: string[];
+    role: string | null;
+    ariaLabel: string | null;
+    textPreview: string | null;
+    attributes: Record<string, string>;
+};
+export type RuntimeElementRef = {
+    /** Stable within a preview session for a given DOM node identity. */
+    id: string;
+    sourceKey: string | null;
+};
+export type ElementHoverPayload = {
+    elementRef: RuntimeElementRef;
+    rect: ElementRect;
+    metadata: ElementMetadata;
+    source: SourceLocation | null;
+    mappingStatus: SourceMappingStatus;
+};
+export type ElementSelectedPayload = ElementHoverPayload;
+export type ElementHoveredMessage = InspectorMessageBase & {
+    type: "ELEMENT_HOVERED";
+    payload: ElementHoverPayload;
+};
+export type ElementSelectedMessage = InspectorMessageBase & {
+    type: "ELEMENT_SELECTED";
+    payload: ElementSelectedPayload;
+};
+export type ElementClearedMessage = InspectorMessageBase & {
+    type: "ELEMENT_CLEARED";
+};
+export type InspectorErrorMessage = InspectorMessageBase & {
+    type: "INSPECTOR_ERROR";
+    code: string;
+    message: string;
+};
+export type ChangeMarkerKind = "mock" | "pr-preview";
+/** Optional overlay markers supplied by the host (diff engine lives outside inspector). */
+export type ChangeMarker = {
+    elementRefId: string;
+    label: string;
+    kind: ChangeMarkerKind;
+    pulse?: boolean;
+};
+export type ApplyChangeMarkersMessage = InspectorMessageBase & {
+    type: "APPLY_CHANGE_MARKERS";
+    markers: ChangeMarker[];
+};
+export type HostToClientMessage = InspectorEnableMessage | InspectorDisableMessage | InspectorHostHelloMessage | ApplyChangeMarkersMessage;
+export type ClientToHostMessage = InspectorReadyMessage | ElementHoveredMessage | ElementSelectedMessage | ElementClearedMessage | InspectorErrorMessage;
+export type InspectorMessage = HostToClientMessage | ClientToHostMessage;
+export declare function isInspectorMessage(value: unknown): value is InspectorMessage;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

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

package/dist/protocol.js

@@ -0,0 +1,12 @@
+/** Wire protocol between Abbox Viewer (host) and instrumented preview (client). */
+export const PROTOCOL_VERSION = 1;
+export const ABBBOX_INSPECTOR_CHANNEL = "abbox-inspector";
+export function isInspectorMessage(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const o = value;
+    return (o.channel === ABBBOX_INSPECTOR_CHANNEL &&
+        o.version === PROTOCOL_VERSION &&
+        typeof o.sessionId === "string" &&
+        typeof o.type === "string");
+}

package/dist/react/AbboxInspectorBoot.d.ts

@@ -0,0 +1,3 @@
+/** Mount once in the root layout so the Viewer iframe can connect via `abboxSession`. */
+export declare function AbboxInspectorBoot(): null;
+//# sourceMappingURL=AbboxInspectorBoot.d.ts.map

package/dist/react/AbboxInspectorBoot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbboxInspectorBoot.d.ts","sourceRoot":"","sources":["../../src/react/AbboxInspectorBoot.tsx"],"names":[],"mappings":"AAKA,yFAAyF;AACzF,wBAAgB,kBAAkB,SAKjC"}

package/dist/react/AbboxInspectorBoot.js

@@ -0,0 +1,10 @@
+"use client";
+import { useEffect } from "react";
+import { bootstrapInspectorPreview } from "../runtime/bootstrap.js";
+/** Mount once in the root layout so the Viewer iframe can connect via `abboxSession`. */
+export function AbboxInspectorBoot() {
+    useEffect(() => {
+        bootstrapInspectorPreview();
+    }, []);
+    return null;
+}

package/dist/runtime/bootstrap.d.ts

@@ -0,0 +1,10 @@
+export type BootstrapOptions = {
+    sessionId?: string;
+    allowedHostOrigins?: string[];
+};
+/**
+ * Entry for instrumented apps. Activates only when the build baked an authorized
+ * inspection mode and `abboxSession` is present (not sufficient on its own for security).
+ */
+export declare function bootstrapInspectorPreview(options?: BootstrapOptions): void;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/runtime/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/runtime/bootstrap.ts"],"names":[],"mappings":"AAsCA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,gBAAqB,GAC7B,IAAI,CAmCN"}

package/dist/runtime/bootstrap.js

@@ -0,0 +1,66 @@
+import { withLocalhostAliases } from "../host/origin-aliases.js";
+import { createInspectorClient } from "../host/client-bridge.js";
+import { getBakedViewerOrigin, isAbboxInspectorProductionRuntime, isAbboxInspectorRuntimeEnabled, } from "../next/preview-env.js";
+/** Viewer origins used when `abboxHostOrigin` is missing (preview mode only). */
+const DEFAULT_VIEWER_ORIGINS = [
+    "https://viewer.abbox.com",
+    "http://localhost:5173",
+    "http://127.0.0.1:5173",
+    "http://localhost:4173",
+    "http://127.0.0.1:4173",
+];
+function viewerOriginsFromReferrer() {
+    if (typeof document === "undefined" || !document.referrer)
+        return [];
+    try {
+        return [new URL(document.referrer).origin];
+    }
+    catch {
+        return [];
+    }
+}
+function normalizeOrigin(origin) {
+    return origin.replace(/\/$/, "");
+}
+function isAllowedHostOrigin(hostOrigin, allowed) {
+    const normalized = normalizeOrigin(hostOrigin);
+    return allowed.some((o) => normalizeOrigin(o) === normalized);
+}
+/**
+ * Entry for instrumented apps. Activates only when the build baked an authorized
+ * inspection mode and `abboxSession` is present (not sufficient on its own for security).
+ */
+export function bootstrapInspectorPreview(options = {}) {
+    if (typeof window === "undefined")
+        return;
+    if (!isAbboxInspectorRuntimeEnabled())
+        return;
+    const params = new URLSearchParams(window.location.search);
+    const sessionFromUrl = params.get("abboxSession");
+    if (!sessionFromUrl)
+        return;
+    const sessionId = options.sessionId ?? sessionFromUrl;
+    const hostParam = params.get("abboxHostOrigin");
+    let allowedHostOrigins;
+    if (isAbboxInspectorProductionRuntime()) {
+        if (!hostParam)
+            return;
+        const bakedViewer = getBakedViewerOrigin();
+        const allowed = withLocalhostAliases(options.allowedHostOrigins ??
+            (bakedViewer ? [bakedViewer] : DEFAULT_VIEWER_ORIGINS));
+        if (!isAllowedHostOrigin(hostParam, allowed))
+            return;
+        allowedHostOrigins = withLocalhostAliases([hostParam]);
+    }
+    else {
+        allowedHostOrigins = withLocalhostAliases(options.allowedHostOrigins ??
+            (hostParam
+                ? [hostParam]
+                : [...viewerOriginsFromReferrer(), ...DEFAULT_VIEWER_ORIGINS]));
+    }
+    const client = createInspectorClient({
+        sessionId,
+        allowedHostOrigins,
+    });
+    client.start();
+}

package/dist/runtime/element-ref.d.ts

@@ -0,0 +1,4 @@
+import type { RuntimeElementRef } from "../protocol.js";
+export declare function runtimeElementRefFor(el: Element, sourceKey: string | null): RuntimeElementRef;
+export declare function resetElementRefCounter(): void;
+//# sourceMappingURL=element-ref.d.ts.map

package/dist/runtime/element-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-ref.d.ts","sourceRoot":"","sources":["../../src/runtime/element-ref.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAKxD,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,OAAO,EACX,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,iBAAiB,CAQnB;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/runtime/element-ref.js

@@ -0,0 +1,14 @@
+let counter = 0;
+const weakToId = new WeakMap();
+export function runtimeElementRefFor(el, sourceKey) {
+    let id = weakToId.get(el);
+    if (!id) {
+        counter += 1;
+        id = `el_${counter}`;
+        weakToId.set(el, id);
+    }
+    return { id, sourceKey };
+}
+export function resetElementRefCounter() {
+    counter = 0;
+}

package/dist/runtime/inspector.d.ts

@@ -0,0 +1,18 @@
+import type { ChangeMarker, ElementHoverPayload } from "../protocol.js";
+export type InspectorRuntimeOptions = {
+    document: Document;
+    window: Window;
+    onHover?: (payload: ElementHoverPayload) => void;
+    onSelect?: (payload: ElementHoverPayload) => void;
+    onClear?: () => void;
+};
+export type InspectorRuntime = {
+    enable: () => void;
+    disable: () => void;
+    isEnabled: () => boolean;
+    setChangeMarkers: (markers: ChangeMarker[]) => void;
+    getElementByRefId: (refId: string) => Element | null;
+    destroy: () => void;
+};
+export declare function createInspectorRuntime(options: InspectorRuntimeOptions): InspectorRuntime;
+//# sourceMappingURL=inspector.d.ts.map

package/dist/runtime/inspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector.d.ts","sourceRoot":"","sources":["../../src/runtime/inspector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAgBxE,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACjD,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAClD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,gBAAgB,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,IAAI,CAAC;IACpD,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAAC;IACrD,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAEF,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,gBAAgB,CAoIlB"}