@ai-setting/roy-plugin-task-show 2.5.11 → 2.5.13

package/dist/file-viewer-utils.js

@@ -0,0 +1,215 @@
+/**
+ * @fileoverview File viewer rendering utilities (Task #2952).
+ *
+ * The right-hand tool-call detail panel on the task page renders
+ * differently depending on the tool name:
+ *
+ *   - **write_file / write / create_file** → render the FULL content
+ *     of the file as the user just wrote it (line-numbered, no
+ *     truncation). Previously the panel mounted a Monaco placeholder
+ *     that fetched the file from disk via /api/file-content — which
+ *     could be truncated for large files and never reflected the
+ *     content the tool call actually wrote.
+ *
+ *   - **edit_file / edit / edit_file_v2 / multi_edit_file / multi_edit
+ *     / apply_patch** → render a git-style diff between
+ *     `old_string` and `new_string` (LCS-based +/- lines). For these
+ *     tools we want to highlight what changed, not show the entire
+ *     resulting file again.
+ *
+ * Both renderers produce XSS-safe HTML — every user-controlled string
+ * passes through {@link escapeHtml} before being injected.
+ */
+// ---------------------------------------------------------------------------
+// Public renderers
+// ---------------------------------------------------------------------------
+/**
+ * Render a write_file tool call's full content as line-numbered HTML.
+ *
+ * Returns a `<div class="file-viewer write-file">` containing:
+ *   - a header with the file path + line/byte counts
+ *   - a `<pre class="code-block">` with every line (no truncation)
+ *
+ * The renderer escapes HTML; long lines are preserved verbatim.
+ */
+export function renderWriteFileFull(opts) {
+    const lines = opts.content.split("\n");
+    // If the content ends with \n, split() produces a trailing "" entry.
+    // We keep it (matches editor display) but flag the count accurately.
+    const totalChars = opts.content.length;
+    const lineNumbered = lines
+        .map((line, i) => {
+        const num = String(i + 1).padStart(4, " ");
+        const escaped = escapeHtml(line);
+        return `<div class="code-line"><span class="ln">${num}</span><span class="content">${escaped}</span></div>`;
+    })
+        .join("");
+    return `<div class="file-viewer write-file" data-file-path="${escapeHtmlAttr(opts.path)}">
+  <div class="file-header">
+    <span class="file-icon">📝</span>
+    <span class="file-path">${escapeHtml(opts.path)}</span>
+    <span class="file-meta">${lines.length} lines · ${totalChars} bytes</span>
+  </div>
+  <pre class="code-block">${lineNumbered}</pre>
+</div>`;
+}
+/**
+ * Render an edit_file tool call as a git-style unified diff.
+ *
+ * Returns a `<div class="file-viewer edit-file">` containing:
+ *   - a header with the file path + line counts
+ *   - a `<ol class="diff-body">` with LCS-derived +/- / context lines
+ *     (legacy contract — pre-v2.5.12 callers look for `class="diff-body"`
+ *     and `diff-line-(added|removed|context)` markers).
+ *
+ * If `old_string` and `new_string` are identical the result is just
+ * the context lines (no +/- markers).
+ *
+ * The wrapper also carries `data-diff="<json>"` so the client
+ * hydrator can rebuild the diff on click without re-parsing the DOM.
+ */
+export function renderEditFileDiff(opts) {
+    const oldLines = splitLines(opts.old_string);
+    const newLines = splitLines(opts.new_string);
+    const ops = computeLineDiff(oldLines, newLines);
+    const rendered = ops
+        .map((op) => {
+        const escaped = escapeHtml(op.line);
+        // v2.5.12: dual-class — legacy `diff-line-added/removed/context`
+        // (consumed by .diff-body CSS + v2.0.0 client tests) AND the new
+        // `add/remove/context` short forms (consumed by .file-viewer CSS).
+        // The legacy class MUST be the second token so the regex
+        // `class="diff-line diff-line-(added|removed|context)"` continues
+        // to match (used by RED-INT3 in
+        // test/tool-call-detail-server-integration.test.ts).
+        const legacyCls = op.type === "add"
+            ? "diff-line-added"
+            : op.type === "remove"
+                ? "diff-line-removed"
+                : "diff-line-context";
+        const newCls = op.type; // "add" | "remove" | "context"
+        const marker = op.type === "add" ? "+" : op.type === "remove" ? "-" : " ";
+        return `<li class="diff-line ${legacyCls}" data-kind="${newCls}" data-line="${escapeHtmlAttr(String(op.lineNum))}"><span class="diff-gutter">${escapeHtml(marker)}</span><span class="diff-text">${escaped}</span></li>`;
+    })
+        .join("");
+    const removedCount = ops.filter((o) => o.type === "remove").length;
+    const addedCount = ops.filter((o) => o.type === "add").length;
+    const dataDiff = JSON.stringify(ops.map((o) => ({
+        kind: o.type === "add" ? "added" : o.type === "remove" ? "removed" : "context",
+        text: o.line,
+        lineNum: o.lineNum,
+    })));
+    return `<div class="file-viewer edit-file" data-file-path="${escapeHtmlAttr(opts.path)}">
+  <div class="file-header">
+    <span class="file-icon">✏️</span>
+    <span class="file-path">${escapeHtml(opts.path)}</span>
+    <span class="file-meta">-${removedCount} +${addedCount} lines (${oldLines.length} → ${newLines.length})</span>
+  </div>
+  <ol class="diff-body" data-diff="${escapeHtmlAttr(dataDiff)}">${rendered}</ol>
+</div>`;
+}
+// ---------------------------------------------------------------------------
+// LCS-based line diff
+// ---------------------------------------------------------------------------
+/**
+ * Compute a line-level diff using LCS (Longest Common Subsequence).
+ *
+ * Algorithm: classic O(N*M) DP table, then a single backtrack to
+ * emit the ops in order. For inputs up to a few thousand lines this
+ * is well within budget; for pathological inputs we accept the cost
+ * (Task #2952 callers are user-authored file edits, not bulk
+ * transforms).
+ *
+ * Output: ordered array of `{type, line, lineNum}` matching how an
+ * editor would display them.
+ */
+export function computeLineDiff(oldLines, newLines) {
+    const m = oldLines.length;
+    const n = newLines.length;
+    if (m === 0 && n === 0)
+        return [];
+    // dp[i+1][j+1] = LCS length of oldLines[0..i] vs newLines[0..j]
+    const dp = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
+    for (let i = 0; i < m; i++) {
+        const oldLine = oldLines[i];
+        const row = dp[i + 1];
+        const prev = dp[i];
+        for (let j = 0; j < n; j++) {
+            if (oldLine === newLines[j]) {
+                row[j + 1] = (prev[j] ?? 0) + 1;
+            }
+            else {
+                row[j + 1] = Math.max(prev[j + 1] ?? 0, row[j] ?? 0);
+            }
+        }
+    }
+    // Backtrack to produce the ops in reverse order.
+    const reversed = [];
+    let i = m;
+    let j = n;
+    while (i > 0 && j > 0) {
+        if (oldLines[i - 1] === newLines[j - 1]) {
+            reversed.push({ type: "context", line: oldLines[i - 1], lineNum: j });
+            i--;
+            j--;
+        }
+        else if ((dp[i - 1]?.[j] ?? 0) >= (dp[i]?.[j - 1] ?? 0)) {
+            reversed.push({ type: "remove", line: oldLines[i - 1], lineNum: i });
+            i--;
+        }
+        else {
+            reversed.push({ type: "add", line: newLines[j - 1], lineNum: j });
+            j--;
+        }
+    }
+    while (i > 0) {
+        reversed.push({ type: "remove", line: oldLines[i - 1], lineNum: i });
+        i--;
+    }
+    while (j > 0) {
+        reversed.push({ type: "add", line: newLines[j - 1], lineNum: j });
+        j--;
+    }
+    reversed.reverse();
+    return reversed;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Split a string into lines. We split on `\n` and drop a single
+ * trailing empty element from a final `\n` (matching how `git diff`
+ * and most editors present the result). Empty input → `[]`.
+ */
+function splitLines(s) {
+    if (s === "")
+        return [];
+    const parts = s.split("\n");
+    if (parts.length > 0 && parts[parts.length - 1] === "")
+        parts.pop();
+    return parts;
+}
+/**
+ * Escape user-controlled strings for HTML body context. Mirrors
+ * `escapeHtml()` in `src/tool-call-detail.ts` so the two renderers
+ * stay consistent.
+ */
+function escapeHtml(input) {
+    if (input === undefined || input === null)
+        return "";
+    const s = typeof input === "string" ? input : JSON.stringify(input);
+    return s
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&#39;");
+}
+/**
+ * Attribute-context escape. Same algorithm as {@link escapeHtml} but
+ * the separate name makes the intent clear at the call site.
+ */
+function escapeHtmlAttr(input) {
+    return escapeHtml(input);
+}
+//# sourceMappingURL=file-viewer-utils.js.map

package/dist/file-viewer-utils.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @fileoverview Plugin-internal unified logger (Task #2961).
+ *
+ * User feedback: "用 logger.info 走日志系统，不污染 stdout/stderr".
+ *
+ * The plugin is intentionally zero-runtime-dep (no `@ai-setting/roy-agent-core`,
+ * no `pino`/`winston`). To route diagnostic output through a unified logger
+ * WITHOUT polluting stdout/stderr, we ship a small, self-contained logger
+ * here that mirrors the host agent's `createLogger` semantics:
+ *
+ *   - `info` / `warn` / `error` / `debug` methods on every logger instance.
+ *   - Quiet-by-default mode: when `quietMode === true` (the default), all
+ *     log calls go to a per-category log file under
+ *     `${XDG_DATA_HOME:-~/.local/share}/roy-agent/logs/roy-plugin-task-show-<name>.log`,
+ *     and DO NOT touch `console.log` / `console.warn` / `console.error`.
+ *   - Console output is only enabled when an operator explicitly calls
+ *     `setQuietMode(false)`. The env var `TASK_SHOW_DEBUG=1` no longer
+ *     re-enables console output — it is intentionally ignored (was the
+ *     previous band-aid in Task #2953).
+ *   - The log file path is created on first write (mkdir -p).
+ *   - Writes are synchronous append (`appendFileSync`) so the log is
+ *     durable even when the process exits immediately (subprocess shutdown).
+ *
+ * Why a new file instead of inlining in `plugin.ts`? Tests pin the
+ * `createPluginLogger` symbol (RED-3 / RED-4 / RED-5) and the chat
+ * subprocess test imports it from `../src/logger.js`. Co-locating the
+ * logger means `server.ts`, `collector.ts`, and `plugin.ts` all import
+ * the same `createPluginLogger` — one sink, one set of gates.
+ *
+ * NOTE: this logger is intentionally minimal. If the host agent ever
+ * exposes a `createPluginLogger` factory in `@ai-setting/roy-agent-core`,
+ * this file can be replaced with a thin re-export.
+ */
+export declare function isQuietMode(): boolean;
+export declare function setQuietMode(enabled: boolean): void;
+export interface PluginLogger {
+    /** Log to file unconditionally. Console only when un-quiet. */
+    info(message: string, data?: unknown): void;
+    warn(message: string, data?: unknown): void;
+    error(message: string, data?: unknown): void;
+    debug(message: string, data?: unknown): void;
+    /**
+     * Whether this logger currently routes to the console. True when
+     * quiet mode is off AND the env says console output is allowed.
+     * Tests use this to assert the default behaviour without spying on
+     * `console.*` directly.
+     */
+    readonly consoleEnabled: boolean;
+}
+/**
+ * Create (or fetch from cache) a plugin logger under the given category
+ * prefix. The prefix appears in the log file name and in each formatted
+ * line so operators can grep for it.
+ *
+ * @param prefix A short identifier for the subsystem
+ *   (e.g. `"plugin"`, `"server"`, `"collector"`).
+ */
+export declare function createPluginLogger(prefix: string): PluginLogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAqBH,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEnD;AAgDD,MAAM,WAAW,YAAY;IAC3B,+DAA+D;IAC/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7C;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AA+CD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CA4C/D"}

package/dist/logger.js

@@ -0,0 +1,181 @@
+/**
+ * @fileoverview Plugin-internal unified logger (Task #2961).
+ *
+ * User feedback: "用 logger.info 走日志系统，不污染 stdout/stderr".
+ *
+ * The plugin is intentionally zero-runtime-dep (no `@ai-setting/roy-agent-core`,
+ * no `pino`/`winston`). To route diagnostic output through a unified logger
+ * WITHOUT polluting stdout/stderr, we ship a small, self-contained logger
+ * here that mirrors the host agent's `createLogger` semantics:
+ *
+ *   - `info` / `warn` / `error` / `debug` methods on every logger instance.
+ *   - Quiet-by-default mode: when `quietMode === true` (the default), all
+ *     log calls go to a per-category log file under
+ *     `${XDG_DATA_HOME:-~/.local/share}/roy-agent/logs/roy-plugin-task-show-<name>.log`,
+ *     and DO NOT touch `console.log` / `console.warn` / `console.error`.
+ *   - Console output is only enabled when an operator explicitly calls
+ *     `setQuietMode(false)`. The env var `TASK_SHOW_DEBUG=1` no longer
+ *     re-enables console output — it is intentionally ignored (was the
+ *     previous band-aid in Task #2953).
+ *   - The log file path is created on first write (mkdir -p).
+ *   - Writes are synchronous append (`appendFileSync`) so the log is
+ *     durable even when the process exits immediately (subprocess shutdown).
+ *
+ * Why a new file instead of inlining in `plugin.ts`? Tests pin the
+ * `createPluginLogger` symbol (RED-3 / RED-4 / RED-5) and the chat
+ * subprocess test imports it from `../src/logger.js`. Co-locating the
+ * logger means `server.ts`, `collector.ts`, and `plugin.ts` all import
+ * the same `createPluginLogger` — one sink, one set of gates.
+ *
+ * NOTE: this logger is intentionally minimal. If the host agent ever
+ * exposes a `createPluginLogger` factory in `@ai-setting/roy-agent-core`,
+ * this file can be replaced with a thin re-export.
+ */
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+// ============================================================================
+// Module-level quiet mode (mirrors @ai-setting/roy-agent-core quietMode)
+// ============================================================================
+/**
+ * Quiet mode = "log to file only, do not touch console". When false, log
+ * calls also forward to the matching `console.*` method.
+ *
+ * Defaults to `true` so the plugin never pollutes the parent process's
+ * stdout / stderr unless the operator explicitly asks for it. The env
+ * var `TASK_SHOW_DEBUG=1` (legacy band-aid from Task #2953) is ignored
+ * — see `envSaysConsoleEnabled()` for the rationale.
+ */
+let quietMode = true;
+export function isQuietMode() {
+    return quietMode;
+}
+export function setQuietMode(enabled) {
+    quietMode = enabled;
+}
+/**
+ * v2.5.12 (Task #2961): the env flags are intentionally NOT consulted.
+ * The user's explicit feedback was "用 logger.info 走日志系统，不污染
+ * stdout/stderr". Honouring that means the default behaviour must NEVER
+ * touch console, regardless of legacy debug env vars. Operators who
+ * want console output for live debugging should call `setQuietMode(false)`
+ * directly — this keeps the env variable surface narrow and predictable.
+ */
+function envSaysConsoleEnabled() {
+    return false;
+}
+// ============================================================================
+// Log file path
+// ============================================================================
+/**
+ * Resolve the log directory every call so tests that flip
+ * `XDG_DATA_HOME` between cases pick up the new path. The cost is a
+ * couple of `path.join` calls per log write — negligible.
+ */
+function getLogDir() {
+    const xdg = process.env?.XDG_DATA_HOME;
+    const base = xdg && xdg.length > 0
+        ? xdg
+        : path.join(os.homedir(), ".local", "share");
+    const dir = path.join(base, "roy-agent", "logs");
+    try {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    catch {
+        // ignore — fall through; writeToFile will no-op on error.
+    }
+    return dir;
+}
+function getLogFilePath(category) {
+    // Sanitize the category to avoid path traversal — keep alnum + dash/underscore.
+    const safe = category.replace(/[^a-zA-Z0-9_-]/g, "_").slice(0, 64);
+    return path.join(getLogDir(), `roy-plugin-task-show-${safe}.log`);
+}
+const TAG = "roy-plugin-task-show";
+function formatLine(level, prefix, message, data) {
+    const ts = new Date().toISOString();
+    const tail = data !== undefined ? ` ${safeStringify(data)}` : "";
+    return `${ts} [${level.toUpperCase()}] [${TAG}:${prefix}] ${message}${tail}`;
+}
+function safeStringify(data) {
+    try {
+        const s = JSON.stringify(data);
+        return s === undefined ? String(data) : s;
+    }
+    catch {
+        return String(data);
+    }
+}
+function writeToFile(line, category) {
+    try {
+        const file = getLogFilePath(category);
+        fs.appendFileSync(file, line + "\n", "utf-8");
+    }
+    catch {
+        // Swallow — the plugin must never crash on log I/O.
+    }
+}
+/**
+ * Compute the current console-enabled state. Called on every log
+ * call so that toggling `quietMode` at runtime takes effect immediately.
+ */
+function computeConsoleEnabled() {
+    return !quietMode || envSaysConsoleEnabled();
+}
+// ============================================================================
+// Logger factory
+// ============================================================================
+const cache = new Map();
+/**
+ * Create (or fetch from cache) a plugin logger under the given category
+ * prefix. The prefix appears in the log file name and in each formatted
+ * line so operators can grep for it.
+ *
+ * @param prefix A short identifier for the subsystem
+ *   (e.g. `"plugin"`, `"server"`, `"collector"`).
+ */
+export function createPluginLogger(prefix) {
+    const cached = cache.get(prefix);
+    if (cached)
+        return cached;
+    const logger = {
+        get consoleEnabled() {
+            return computeConsoleEnabled();
+        },
+        info(message, data) {
+            const line = formatLine("info", prefix, message, data);
+            writeToFile(line, prefix);
+            if (computeConsoleEnabled()) {
+                // eslint-disable-next-line no-console
+                console.log(line);
+            }
+        },
+        warn(message, data) {
+            const line = formatLine("warn", prefix, message, data);
+            writeToFile(line, prefix);
+            if (computeConsoleEnabled()) {
+                // eslint-disable-next-line no-console
+                console.warn(line);
+            }
+        },
+        error(message, data) {
+            const line = formatLine("error", prefix, message, data);
+            writeToFile(line, prefix);
+            if (computeConsoleEnabled()) {
+                // eslint-disable-next-line no-console
+                console.error(line);
+            }
+        },
+        debug(message, data) {
+            const line = formatLine("debug", prefix, message, data);
+            writeToFile(line, prefix);
+            if (computeConsoleEnabled()) {
+                // eslint-disable-next-line no-console
+                console.debug(line);
+            }
+        },
+    };
+    cache.set(prefix, logger);
+    return logger;
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/mermaid-zoom-guardian.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @fileoverview Mermaid zoom-stage guardian (v2.5.12 / Task #2951).
+ *
+ * Why this module exists
+ * ----------------------
+ * The Mermaid controller (`public/mermaid-renderer.js`) wraps every
+ * freshly-rendered SVG in a `.mermaid-zoom-stage` div that carries
+ * the pan/zoom CSS transform and the pointer-drag handlers. Without
+ * that wrapper the user can neither pan nor zoom the lifecycle
+ * diagram.
+ *
+ * Mermaid's library auto-runs `mermaid.run({nodes})` once
+ * `startOnLoad: true` is set in `mermaid.initialize`. We DO set
+ * `startOnLoad: true` in the SSR template (server.ts line ~2041) so
+ * the initial paint works for hosts that don't ship our controller.
+ * The auto-runner scans the DOM for `.mermaid` elements that are not
+ * already marked `data-processed` and replaces their innerHTML with a
+ * freshly-rendered SVG.
+ *
+ * Even after our controller's `update()` has set `data-processed="true"`
+ * and wrapped the SVG, Mermaid's auto-runner fires roughly 1.5–3s
+ * later (observed via Playwright trace on 2026-08-12) and replaces
+ * the contents of the `.mermaid` element with a fresh, bare SVG. The
+ * bare SVG is not wrapped in `.mermaid-zoom-stage`, so the pan/zoom
+ * UI silently breaks for the rest of the page lifetime.
+ *
+ * What this module does
+ * ---------------------
+ * `ensureMermaidZoomStage(container)` — one-shot helper that walks
+ * the container and wraps any existing `<svg>` in a
+ * `.mermaid-zoom-stage` div. Idempotent: calling it twice keeps ONE
+ * wrapper.
+ *
+ * `MermaidZoomGuardian` — a long-lived `MutationObserver` that
+ * detects when something (Mermaid's late `mermaid.run()`, an SSE
+ * patch, etc.) replaces the SVG and re-applies the wrapper. The
+ * guardian stops observing after `stop()` is called.
+ *
+ * Both helpers are deliberately framework-free so they can be unit-
+ * tested in happy-dom / jsdom without a full browser.
+ */
+/**
+ * Wrap any existing SVG inside `container` in a single
+ * `.mermaid-zoom-stage` div. Idempotent.
+ *
+ * @returns the (possibly newly-created) stage element, or `null`
+ *          when the container has no SVG to wrap.
+ */
+export declare function ensureMermaidZoomStage(container: Element): HTMLElement | null;
+/**
+ * v2.5.12 (Task #2951): the MermaidZoomGuardian watches a container
+ * and re-wraps any replacement SVG in `.mermaid-zoom-stage`. Use
+ * this for diagrams that survive past the initial render — e.g. the
+ * lifecycle mermaid on the per-task page, where Mermaid's late
+ * `mermaid.run()` otherwise destroys the wrapper.
+ *
+ * Lifecycle:
+ *   const g = new MermaidZoomGuardian(container);
+ *   g.start();
+ *   // ...later, when the page is torn down:
+ *   g.stop();
+ */
+export declare class MermaidZoomGuardian {
+    private readonly container;
+    private observer;
+    private scheduled;
+    constructor(container: Element);
+    start(): void;
+    stop(): void;
+}
+/**
+ * Export the constants so tests can reference them without hardcoding.
+ */
+export declare const MERMAID_STAGE_CLASS = "mermaid-zoom-stage";
+export declare const MERMAID_TOOLBAR_CLASS = "mermaid-zoom-toolbar";
+export declare const MERMAID_CONTAINER_CLASS = "mermaid";
+//# sourceMappingURL=mermaid-zoom-guardian.d.ts.map

package/dist/mermaid-zoom-guardian.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid-zoom-guardian.d.ts","sourceRoot":"","sources":["../src/mermaid-zoom-guardian.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAgBH;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAsC7E;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,SAAS,CAAS;gBAEd,SAAS,EAAE,OAAO;IAI9B,KAAK,IAAI,IAAI;IAwCb,IAAI,IAAI,IAAI;CAOb;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,uBAAc,CAAC;AAC/C,eAAO,MAAM,qBAAqB,yBAAgB,CAAC;AACnD,eAAO,MAAM,uBAAuB,YAAgB,CAAC"}