@miragon/modeler-shell 0.0.0-stage → 0.2.0

package/dist/vscode-extension.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vscode-extension.ts","../src/core/appearance.ts","../src/vscode/extension/html.ts","../src/vscode/protocol.ts","../src/vscode/extension/theme-bridge.ts","../src/vscode/extension/reveal.ts"],"sourcesContent":["// \"@miragon/modeler-shell/vscode/extension\": the extension-host side (the vscode namespace is injected).\nexport * from \"./vscode/extension/index.js\";\n","/** The modes a Miragon modeler can show (guide §13.3). */\nexport type Theme = \"light\" | \"dark\";\n\n/** High contrast; written as `data-cd-kontrast=\"hoch\"` on the same element as `data-cd-theme`. */\nexport type Kontrast = \"hoch\";\n\nexport interface Appearance {\n  theme: Theme;\n  kontrast?: Kontrast | undefined;\n}\n\n/**\n * The one appearance decision of guide §13.5: a theme the modeler cannot show is never shown\n * (`themes[0]` wins, so `[\"light\"]` stays light whatever the host requests); `kontrast` always\n * passes through. Throws when `themes` is empty.\n */\nexport function resolveAppearance(requested: Appearance, themes: readonly Theme[]): Appearance {\n  const [fallback] = themes;\n  if (fallback === undefined) {\n    throw new Error(\n      \"@miragon/modeler-shell: resolveAppearance needs at least one theme the modeler can show\",\n    );\n  }\n  const theme = themes.includes(requested.theme) ? requested.theme : fallback;\n  return withKontrast(theme, requested.kontrast);\n}\n\n// Appearances arrive through postMessage and settings, so only the one known value passes.\nfunction withKontrast(theme: Theme, kontrast: unknown): Appearance {\n  return kontrast === \"hoch\" ? { theme, kontrast } : { theme };\n}\n\n/**\n * The appearance VS Code requests for `vscode.window.activeColorTheme.kind`:\n * 1 Light → light, 2 Dark → dark, 3 HighContrast → dark + hoch, 4 HighContrastLight → light + hoch;\n * any other value → light.\n */\nexport function appearanceFromColorThemeKind(kind: number): Appearance {\n  switch (kind) {\n    case 2:\n      return { theme: \"dark\" };\n    case 3:\n      return { theme: \"dark\", kontrast: \"hoch\" };\n    case 4:\n      return { theme: \"light\", kontrast: \"hoch\" };\n    default:\n      return { theme: \"light\" };\n  }\n}\n\n/** The values of the setting `miragon.<modeler>.colorTheme` (it ships once a modeler can show dark). */\nexport type ColorThemeSetting = \"automatic\" | \"light\" | \"dark\";\n\n/**\n * The requested appearance in an IDE host: the setting's theme unless it is `automatic` (or\n * missing), the contrast always from the color theme kind.\n */\nexport function requestedAppearance(kind: number, setting?: ColorThemeSetting | undefined): Appearance {\n  const fromKind = appearanceFromColorThemeKind(kind);\n  const theme = setting === \"light\" || setting === \"dark\" ? setting : fromKind.theme;\n  return withKontrast(theme, fromKind.kontrast);\n}\n\n/**\n * The fallback signal inside a VS Code webview: the body classes `vscode-high-contrast-light`\n * (checked first, VS Code adds `vscode-high-contrast` to it as well), `vscode-high-contrast`,\n * `vscode-dark`, `vscode-light`. `undefined` when none is set. Never use them for styling.\n */\nexport function appearanceFromBodyClasses(classes: Iterable<string>): Appearance | undefined {\n  const present = new Set(classes);\n  if (present.has(\"vscode-high-contrast-light\")) return { theme: \"light\", kontrast: \"hoch\" };\n  if (present.has(\"vscode-high-contrast\")) return { theme: \"dark\", kontrast: \"hoch\" };\n  if (present.has(\"vscode-dark\")) return { theme: \"dark\" };\n  if (present.has(\"vscode-light\")) return { theme: \"light\" };\n  return undefined;\n}\n\n/**\n * VS Code's `workbench.reduceMotion` as the webview sees it: the body class `vscode-reduce-motion`\n * (the webview host page sets it). Never use it for styling; the shell mirrors it as\n * `REDUCED_MOTION_CLASS` on `<html>`.\n */\nexport function reducedMotionFromBodyClasses(classes: Iterable<string>): boolean {\n  return new Set(classes).has(\"vscode-reduce-motion\");\n}\n\n/**\n * On `<html>` while the host asks for reduced motion although the OS does not (VS Code's\n * `workbench.reduceMotion`): the shell's animations stop as under `prefers-reduced-motion`, and an\n * explicit fit jumps.\n */\nexport const REDUCED_MOTION_CLASS = \"cd-shell-reduce-motion\";\n\nexport interface AppearanceAttributes {\n  \"data-cd-theme\": Theme;\n  \"data-cd-kontrast\"?: Kontrast;\n}\n\n/** The attributes for `<html>` (own document) or the modeler container (foreign page). */\nexport function appearanceAttributes(appearance: Appearance): AppearanceAttributes {\n  return appearance.kontrast === \"hoch\"\n    ? { \"data-cd-theme\": appearance.theme, \"data-cd-kontrast\": \"hoch\" }\n    : { \"data-cd-theme\": appearance.theme };\n}\n","import { appearanceAttributes, type Appearance } from \"../../core/index.js\";\n\nexport interface WebviewHtmlOptions {\n  /** `webview.cspSource` */\n  cspSource: string;\n  /** The bundle, `webview.asWebviewUri(…).toString()`. */\n  scriptUri: string;\n  /** Stylesheets in load order (token CSS first, see API.md). */\n  styleUris?: readonly string[] | undefined;\n  /** `<title>` */\n  title: string;\n  /** The tool's UI language for `<html lang>`; English modelers pass `\"en\"`. */\n  lang: string;\n  /** Resolved appearance (`currentAppearance`), written before the first paint. */\n  appearance: Appearance;\n  /** Markup inside `<body>` before the script; default `<div id=\"app\"></div>`. */\n  body?: string | undefined;\n  /** Script nonce; default `createNonce()`. */\n  nonce?: string | undefined;\n  /**\n   * Allow inline styles (`style-src … 'unsafe-inline'`), default `true`: renderers write `style`\n   * attributes into markup (palette entries, SVG strings). The shell and diagram-js themselves\n   * only style through the CSSOM and run without it; pass `false` once the renderer does too.\n   */\n  inlineStyles?: boolean | undefined;\n}\n\nconst NONCE_ALPHABET = \"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789\";\nconst NONCE_LENGTH = 32;\n/** Bytes at or above this limit are rejected, so every character is equally likely. */\nconst UNBIASED_BYTE_LIMIT = 256 - (256 % NONCE_ALPHABET.length);\n/** The `base64-value` of a CSP `nonce-source`. */\nconst CSP_NONCE = /^[A-Za-z0-9+/_-]+={0,2}$/;\n\nconst DEFAULT_BODY = '<div id=\"app\"></div>';\n\n/** 32 characters `[A-Za-z0-9]` from `crypto.getRandomValues`. */\nexport function createNonce(): string {\n  let nonce = \"\";\n  while (nonce.length < NONCE_LENGTH) {\n    for (const byte of crypto.getRandomValues(new Uint8Array(NONCE_LENGTH))) {\n      if (byte < UNBIASED_BYTE_LIMIT && nonce.length < NONCE_LENGTH) {\n        nonce += NONCE_ALPHABET.charAt(byte % NONCE_ALPHABET.length);\n      }\n    }\n  }\n  return nonce;\n}\n\nfunction escapeHtml(value: string): string {\n  return value.replace(/&/g, \"&amp;\").replace(/</g, \"&lt;\").replace(/>/g, \"&gt;\").replace(/\"/g, \"&quot;\");\n}\n\nfunction attribute(name: string, value: string): string {\n  return `${name}=\"${escapeHtml(value)}\"`;\n}\n\nfunction contentSecurityPolicy(cspSource: string, nonce: string, inlineStyles: boolean): string {\n  return [\n    \"default-src 'none'\",\n    `img-src ${cspSource} data: blob:`,\n    inlineStyles ? `style-src ${cspSource} 'unsafe-inline'` : `style-src ${cspSource}`,\n    `font-src ${cspSource} data:`,\n    `script-src 'nonce-${nonce}'`,\n  ].join(\"; \");\n}\n\n/**\n * The webview document: `<html lang class=\"cd-shell-document\" data-cd-theme [data-cd-kontrast]>`,\n * the CSP (`default-src 'none'`, `img-src <cspSource> data: blob:`, `style-src <cspSource>` plus\n * `'unsafe-inline'` unless `inlineStyles: false`, `font-src <cspSource> data:`,\n * `script-src 'nonce-…'`), the stylesheets, `body` and the nonce'd script. Attribute values and the\n * title are escaped; `body` is markup and is not. Throws for a `nonce` that is not a CSP base64\n * value.\n */\nexport function renderWebviewHtml(options: WebviewHtmlOptions): string {\n  const nonce = options.nonce ?? createNonce();\n  if (!CSP_NONCE.test(nonce)) {\n    throw new Error(`@miragon/modeler-shell: renderWebviewHtml got an invalid nonce \"${nonce}\"`);\n  }\n  const appearance = appearanceAttributes(options.appearance);\n  const kontrast = appearance[\"data-cd-kontrast\"];\n  const htmlAttributes = [\n    attribute(\"lang\", options.lang),\n    attribute(\"class\", \"cd-shell-document\"),\n    attribute(\"data-cd-theme\", appearance[\"data-cd-theme\"]),\n    ...(kontrast ? [attribute(\"data-cd-kontrast\", kontrast)] : []),\n  ].join(\" \");\n  const stylesheets = (options.styleUris ?? []).map(\n    (uri) => `\\n    <link ${attribute(\"rel\", \"stylesheet\")} ${attribute(\"href\", uri)} />`,\n  );\n\n  return `<!doctype html>\n<html ${htmlAttributes}>\n  <head>\n    <meta charset=\"UTF-8\" />\n    <meta http-equiv=\"Content-Security-Policy\" ${attribute(\"content\", contentSecurityPolicy(options.cspSource, nonce, options.inlineStyles !== false))} />\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />${stylesheets.join(\"\")}\n    <title>${escapeHtml(options.title)}</title>\n  </head>\n  <body>\n    ${options.body ?? DEFAULT_BODY}\n    <script ${attribute(\"nonce\", nonce)} ${attribute(\"src\", options.scriptUri)}></script>\n  </body>\n</html>\n`;\n}\n","import type { Appearance } from \"../core/index.js\";\n\n/** The one message the theme bridge posts to the webview. */\nexport const APPEARANCE_MESSAGE_TYPE = \"modelerShell.appearance\";\n\nexport interface AppearanceMessage {\n  type: typeof APPEARANCE_MESSAGE_TYPE;\n  /** Already resolved against the modeler's themes. */\n  appearance: Appearance;\n}\n\n/** A plain, JSON-safe message (no `kontrast: undefined` key). */\nexport function appearanceMessage(appearance: Appearance): AppearanceMessage {\n  return {\n    type: APPEARANCE_MESSAGE_TYPE,\n    appearance: appearance.kontrast\n      ? { theme: appearance.theme, kontrast: appearance.kontrast }\n      : { theme: appearance.theme },\n  };\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** Type guard for `MessageEvent.data` in the webview. */\nexport function isAppearanceMessage(value: unknown): value is AppearanceMessage {\n  if (!isRecord(value) || value.type !== APPEARANCE_MESSAGE_TYPE || !isRecord(value.appearance)) return false;\n  const { theme, kontrast } = value.appearance;\n  return (theme === \"light\" || theme === \"dark\") && (kontrast === undefined || kontrast === \"hoch\");\n}\n","import {\n  requestedAppearance,\n  resolveAppearance,\n  type Appearance,\n  type ColorThemeSetting,\n  type Theme,\n} from \"../../core/index.js\";\nimport { appearanceMessage } from \"../protocol.js\";\nimport type { DisposableLike, VsCodeLike, WebviewPanelLike } from \"./types.js\";\n\nexport interface ThemeBridgeOptions {\n  /** The modes the modeler can show, a static value of the modeler package (`[\"light\"]` today). */\n  themes: readonly Theme[];\n  /** Full key of `miragon.<modeler>.colorTheme`; omit until the modeler can show dark. */\n  settingKey?: string | undefined;\n}\n\nfunction isColorThemeSetting(value: unknown): value is ColorThemeSetting {\n  return value === \"automatic\" || value === \"light\" || value === \"dark\";\n}\n\nfunction readColorThemeSetting(vscode: VsCodeLike, settingKey: string): ColorThemeSetting | undefined {\n  const separator = settingKey.lastIndexOf(\".\");\n  const value =\n    separator < 0\n      ? vscode.workspace.getConfiguration().get<unknown>(settingKey)\n      : vscode.workspace\n          .getConfiguration(settingKey.slice(0, separator))\n          .get<unknown>(settingKey.slice(separator + 1));\n  return isColorThemeSetting(value) ? value : undefined;\n}\n\n/**\n * The resolved appearance right now: color theme kind (and setting) through `resolveAppearance`.\n * A setting value outside `automatic | light | dark` counts as `automatic`.\n */\nexport function currentAppearance(vscode: VsCodeLike, options: ThemeBridgeOptions): Appearance {\n  const setting = options.settingKey ? readColorThemeSetting(vscode, options.settingKey) : undefined;\n  return resolveAppearance(requestedAppearance(vscode.window.activeColorTheme.kind, setting), options.themes);\n}\n\n/**\n * Posts an `AppearanceMessage` to the panel's webview on `onDidChangeActiveColorTheme`, on a change\n * of `settingKey` and whenever the panel becomes visible again (hidden retained webviews may miss\n * messages). Disposes itself with the panel. Throws when `themes` is empty.\n */\nexport function connectThemeBridge(\n  vscode: VsCodeLike,\n  panel: WebviewPanelLike,\n  options: ThemeBridgeOptions,\n): DisposableLike {\n  if (options.themes.length === 0) {\n    throw new Error(\"@miragon/modeler-shell: connectThemeBridge needs at least one theme\");\n  }\n  const { settingKey } = options;\n  const post = (): void => {\n    void panel.webview.postMessage(appearanceMessage(currentAppearance(vscode, options)));\n  };\n\n  let wasVisible = panel.visible;\n  const subscriptions: DisposableLike[] = [\n    vscode.window.onDidChangeActiveColorTheme(post),\n    panel.onDidChangeViewState(({ webviewPanel }) => {\n      const becameVisible = webviewPanel.visible && !wasVisible;\n      wasVisible = webviewPanel.visible;\n      if (becameVisible) post();\n    }),\n  ];\n  if (settingKey) {\n    subscriptions.push(\n      vscode.workspace.onDidChangeConfiguration((event) => {\n        if (event.affectsConfiguration(settingKey)) post();\n      }),\n    );\n  }\n\n  let disposed = false;\n  const dispose = (): void => {\n    if (disposed) return;\n    disposed = true;\n    for (const subscription of subscriptions.splice(0)) subscription.dispose();\n  };\n  subscriptions.push(panel.onDidDispose(dispose));\n  return { dispose };\n}\n","/**\n * The label VS Code itself uses for revealing a file, for the action on the export notification:\n * `darwin` \"Reveal in Finder\", `win32` \"Reveal in File Explorer\", otherwise \"Open Containing Folder\".\n */\nexport function revealFileLabel(platform: string): string {\n  if (platform === \"darwin\") return \"Reveal in Finder\";\n  if (platform === \"win32\") return \"Reveal in File Explorer\";\n  return \"Open Containing Folder\";\n}\n"],"mappings":"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","names":[]}

package/dist/vscode-extension.d.cts

@@ -0,0 +1,103 @@
+import { A as Appearance, T as Theme } from './appearance-D3FUcbu6.cjs';
+export { A as APPEARANCE_MESSAGE_TYPE, a as AppearanceMessage, b as appearanceMessage, i as isAppearanceMessage } from './protocol-DhYBakWL.cjs';
+
+/**
+ * The parts of the `vscode` namespace the extension helpers use, typed structurally: the shell
+ * never imports `vscode`; the extension passes its own `import * as vscode from "vscode"`.
+ */
+interface DisposableLike {
+    dispose(): unknown;
+}
+interface ColorThemeLike {
+    /** `vscode.ColorThemeKind`: 1 Light, 2 Dark, 3 HighContrast, 4 HighContrastLight. */
+    readonly kind: number;
+}
+interface VsCodeLike {
+    readonly window: {
+        readonly activeColorTheme: ColorThemeLike;
+        onDidChangeActiveColorTheme(listener: (theme: ColorThemeLike) => unknown): DisposableLike;
+    };
+    readonly workspace: {
+        getConfiguration(section?: string): {
+            get<T>(key: string): T | undefined;
+        };
+        onDidChangeConfiguration(listener: (event: {
+            affectsConfiguration(section: string): boolean;
+        }) => unknown): DisposableLike;
+    };
+}
+/** `vscode.WebviewPanel` as far as the theme bridge needs it. */
+interface WebviewPanelLike {
+    readonly webview: {
+        postMessage(message: unknown): unknown;
+    };
+    readonly visible: boolean;
+    onDidChangeViewState(listener: (event: {
+        readonly webviewPanel: {
+            readonly visible: boolean;
+        };
+    }) => unknown): DisposableLike;
+    onDidDispose(listener: () => unknown): DisposableLike;
+}
+
+interface WebviewHtmlOptions {
+    /** `webview.cspSource` */
+    cspSource: string;
+    /** The bundle, `webview.asWebviewUri(…).toString()`. */
+    scriptUri: string;
+    /** Stylesheets in load order (token CSS first, see API.md). */
+    styleUris?: readonly string[] | undefined;
+    /** `<title>` */
+    title: string;
+    /** The tool's UI language for `<html lang>`; English modelers pass `"en"`. */
+    lang: string;
+    /** Resolved appearance (`currentAppearance`), written before the first paint. */
+    appearance: Appearance;
+    /** Markup inside `<body>` before the script; default `<div id="app"></div>`. */
+    body?: string | undefined;
+    /** Script nonce; default `createNonce()`. */
+    nonce?: string | undefined;
+    /**
+     * Allow inline styles (`style-src … 'unsafe-inline'`), default `true`: renderers write `style`
+     * attributes into markup (palette entries, SVG strings). The shell and diagram-js themselves
+     * only style through the CSSOM and run without it; pass `false` once the renderer does too.
+     */
+    inlineStyles?: boolean | undefined;
+}
+/** 32 characters `[A-Za-z0-9]` from `crypto.getRandomValues`. */
+declare function createNonce(): string;
+/**
+ * The webview document: `<html lang class="cd-shell-document" data-cd-theme [data-cd-kontrast]>`,
+ * the CSP (`default-src 'none'`, `img-src <cspSource> data: blob:`, `style-src <cspSource>` plus
+ * `'unsafe-inline'` unless `inlineStyles: false`, `font-src <cspSource> data:`,
+ * `script-src 'nonce-…'`), the stylesheets, `body` and the nonce'd script. Attribute values and the
+ * title are escaped; `body` is markup and is not. Throws for a `nonce` that is not a CSP base64
+ * value.
+ */
+declare function renderWebviewHtml(options: WebviewHtmlOptions): string;
+
+interface ThemeBridgeOptions {
+    /** The modes the modeler can show, a static value of the modeler package (`["light"]` today). */
+    themes: readonly Theme[];
+    /** Full key of `miragon.<modeler>.colorTheme`; omit until the modeler can show dark. */
+    settingKey?: string | undefined;
+}
+/**
+ * The resolved appearance right now: color theme kind (and setting) through `resolveAppearance`.
+ * A setting value outside `automatic | light | dark` counts as `automatic`.
+ */
+declare function currentAppearance(vscode: VsCodeLike, options: ThemeBridgeOptions): Appearance;
+/**
+ * Posts an `AppearanceMessage` to the panel's webview on `onDidChangeActiveColorTheme`, on a change
+ * of `settingKey` and whenever the panel becomes visible again (hidden retained webviews may miss
+ * messages). Disposes itself with the panel. Throws when `themes` is empty.
+ */
+declare function connectThemeBridge(vscode: VsCodeLike, panel: WebviewPanelLike, options: ThemeBridgeOptions): DisposableLike;
+
+/**
+ * The label VS Code itself uses for revealing a file, for the action on the export notification:
+ * `darwin` "Reveal in Finder", `win32` "Reveal in File Explorer", otherwise "Open Containing Folder".
+ */
+declare function revealFileLabel(platform: string): string;
+
+export { type ColorThemeLike, type DisposableLike, type ThemeBridgeOptions, type VsCodeLike, type WebviewHtmlOptions, type WebviewPanelLike, connectThemeBridge, createNonce, currentAppearance, renderWebviewHtml, revealFileLabel };

package/dist/vscode-extension.d.ts

@@ -0,0 +1,103 @@
+import { A as Appearance, T as Theme } from './appearance-D3FUcbu6.js';
+export { A as APPEARANCE_MESSAGE_TYPE, a as AppearanceMessage, b as appearanceMessage, i as isAppearanceMessage } from './protocol-IeW8bf4f.js';
+
+/**
+ * The parts of the `vscode` namespace the extension helpers use, typed structurally: the shell
+ * never imports `vscode`; the extension passes its own `import * as vscode from "vscode"`.
+ */
+interface DisposableLike {
+    dispose(): unknown;
+}
+interface ColorThemeLike {
+    /** `vscode.ColorThemeKind`: 1 Light, 2 Dark, 3 HighContrast, 4 HighContrastLight. */
+    readonly kind: number;
+}
+interface VsCodeLike {
+    readonly window: {
+        readonly activeColorTheme: ColorThemeLike;
+        onDidChangeActiveColorTheme(listener: (theme: ColorThemeLike) => unknown): DisposableLike;
+    };
+    readonly workspace: {
+        getConfiguration(section?: string): {
+            get<T>(key: string): T | undefined;
+        };
+        onDidChangeConfiguration(listener: (event: {
+            affectsConfiguration(section: string): boolean;
+        }) => unknown): DisposableLike;
+    };
+}
+/** `vscode.WebviewPanel` as far as the theme bridge needs it. */
+interface WebviewPanelLike {
+    readonly webview: {
+        postMessage(message: unknown): unknown;
+    };
+    readonly visible: boolean;
+    onDidChangeViewState(listener: (event: {
+        readonly webviewPanel: {
+            readonly visible: boolean;
+        };
+    }) => unknown): DisposableLike;
+    onDidDispose(listener: () => unknown): DisposableLike;
+}
+
+interface WebviewHtmlOptions {
+    /** `webview.cspSource` */
+    cspSource: string;
+    /** The bundle, `webview.asWebviewUri(…).toString()`. */
+    scriptUri: string;
+    /** Stylesheets in load order (token CSS first, see API.md). */
+    styleUris?: readonly string[] | undefined;
+    /** `<title>` */
+    title: string;
+    /** The tool's UI language for `<html lang>`; English modelers pass `"en"`. */
+    lang: string;
+    /** Resolved appearance (`currentAppearance`), written before the first paint. */
+    appearance: Appearance;
+    /** Markup inside `<body>` before the script; default `<div id="app"></div>`. */
+    body?: string | undefined;
+    /** Script nonce; default `createNonce()`. */
+    nonce?: string | undefined;
+    /**
+     * Allow inline styles (`style-src … 'unsafe-inline'`), default `true`: renderers write `style`
+     * attributes into markup (palette entries, SVG strings). The shell and diagram-js themselves
+     * only style through the CSSOM and run without it; pass `false` once the renderer does too.
+     */
+    inlineStyles?: boolean | undefined;
+}
+/** 32 characters `[A-Za-z0-9]` from `crypto.getRandomValues`. */
+declare function createNonce(): string;
+/**
+ * The webview document: `<html lang class="cd-shell-document" data-cd-theme [data-cd-kontrast]>`,
+ * the CSP (`default-src 'none'`, `img-src <cspSource> data: blob:`, `style-src <cspSource>` plus
+ * `'unsafe-inline'` unless `inlineStyles: false`, `font-src <cspSource> data:`,
+ * `script-src 'nonce-…'`), the stylesheets, `body` and the nonce'd script. Attribute values and the
+ * title are escaped; `body` is markup and is not. Throws for a `nonce` that is not a CSP base64
+ * value.
+ */
+declare function renderWebviewHtml(options: WebviewHtmlOptions): string;
+
+interface ThemeBridgeOptions {
+    /** The modes the modeler can show, a static value of the modeler package (`["light"]` today). */
+    themes: readonly Theme[];
+    /** Full key of `miragon.<modeler>.colorTheme`; omit until the modeler can show dark. */
+    settingKey?: string | undefined;
+}
+/**
+ * The resolved appearance right now: color theme kind (and setting) through `resolveAppearance`.
+ * A setting value outside `automatic | light | dark` counts as `automatic`.
+ */
+declare function currentAppearance(vscode: VsCodeLike, options: ThemeBridgeOptions): Appearance;
+/**
+ * Posts an `AppearanceMessage` to the panel's webview on `onDidChangeActiveColorTheme`, on a change
+ * of `settingKey` and whenever the panel becomes visible again (hidden retained webviews may miss
+ * messages). Disposes itself with the panel. Throws when `themes` is empty.
+ */
+declare function connectThemeBridge(vscode: VsCodeLike, panel: WebviewPanelLike, options: ThemeBridgeOptions): DisposableLike;
+
+/**
+ * The label VS Code itself uses for revealing a file, for the action on the export notification:
+ * `darwin` "Reveal in Finder", `win32` "Reveal in File Explorer", otherwise "Open Containing Folder".
+ */
+declare function revealFileLabel(platform: string): string;
+
+export { type ColorThemeLike, type DisposableLike, type ThemeBridgeOptions, type VsCodeLike, type WebviewHtmlOptions, type WebviewPanelLike, connectThemeBridge, createNonce, currentAppearance, renderWebviewHtml, revealFileLabel };

package/dist/vscode-extension.js

@@ -0,0 +1,24 @@
+import {
+  connectThemeBridge,
+  createNonce,
+  currentAppearance,
+  renderWebviewHtml,
+  revealFileLabel
+} from "./chunk-KYDG5DMX.js";
+import {
+  APPEARANCE_MESSAGE_TYPE,
+  appearanceMessage,
+  isAppearanceMessage
+} from "./chunk-N4QXFF3A.js";
+import "./chunk-OADW3GPA.js";
+export {
+  APPEARANCE_MESSAGE_TYPE,
+  appearanceMessage,
+  connectThemeBridge,
+  createNonce,
+  currentAppearance,
+  isAppearanceMessage,
+  renderWebviewHtml,
+  revealFileLabel
+};
+//# sourceMappingURL=vscode-extension.js.map

package/dist/vscode-extension.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}