@bpmn-nova/studio 0.3.0-preview → 0.3.2-preview

package/dist/modules/engine-activiti/index.js

@@ -0,0 +1,160 @@
+const escapeXml = (value = '') => String(value).replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;').replaceAll('"', '&quot;').replaceAll("'", '&apos;');
+
+function implementationAttrs(prefix, item = {}) {
+  const type = item.implementationType || 'class';
+  const value = item.implementation || '';
+  return value ? ` ${type}="${escapeXml(value)}"` : '';
+}
+
+function parseImplementation(element, prefix, namespace) {
+  const get = (name) => element.getAttributeNS(namespace, name) || element.getAttribute(`${prefix}:${name}`) || '';
+  const found = [['class', get('class')], ['delegateExpression', get('delegateExpression')], ['expression', get('expression')]].find(([, value]) => value);
+  return found ? { implementationType: found[0], implementation: found[1] } : {};
+}
+
+function parseExtensionProperties(element, prefix, namespace) {
+  const properties = { executionListeners: [], taskListeners: [], fields: [] };
+  const ext = Array.from(element.children || []).find((child) => child.localName === 'extensionElements');
+  if (ext) {
+    for (const child of Array.from(ext.children || [])) {
+      if (child.localName === 'executionListener') {
+        properties.executionListeners.push({ event: child.getAttribute('event') || 'start', ...parseImplementation(child, prefix, namespace) });
+      } else if (child.localName === 'taskListener') {
+        properties.taskListeners.push({ event: child.getAttribute('event') || 'create', ...parseImplementation(child, prefix, namespace) });
+      } else if (child.localName === 'field') {
+        const string = Array.from(child.children || []).find((item) => item.localName === 'string');
+        const expression = Array.from(child.children || []).find((item) => item.localName === 'expression');
+        properties.fields.push({ name: child.getAttribute('name') || '', type: expression ? 'expression' : 'string', value: (expression || string)?.textContent || '' });
+      } else if (child.localName === 'failedJobRetryTimeCycle') {
+        properties.failedJobRetryTimeCycle = child.textContent?.trim() || '';
+      }
+    }
+  }
+  const inParameters = [];
+  const outParameters = [];
+  for (const child of Array.from(element.children || [])) {
+    if (child.localName !== 'in' && child.localName !== 'out') continue;
+    const row = { source: child.getAttribute('source') || '', sourceExpression: child.getAttribute('sourceExpression') || '', target: child.getAttribute('target') || '' };
+    (child.localName === 'in' ? inParameters : outParameters).push(row);
+  }
+  if (inParameters.length) properties.inParameters = inParameters;
+  if (outParameters.length) properties.outParameters = outParameters;
+  return properties;
+}
+
+function listenerXml(prefix, kind, listener) {
+  return `<${prefix}:${kind} event="${escapeXml(listener.event || (kind === 'taskListener' ? 'create' : 'start'))}"${implementationAttrs(prefix, listener)} />`;
+}
+
+export const activitiProfile = {
+  id: 'activiti',
+  label: 'Activiti',
+  prefix: 'activiti',
+  namespace: 'http://activiti.org/bpmn',
+
+  parseProcess(element) {
+    const get = (name) => element.getAttributeNS(this.namespace, name) || element.getAttribute(`${this.prefix}:${name}`) || '';
+    return {
+      candidateStarterUsers: get('candidateStarterUsers'),
+      candidateStarterGroups: get('candidateStarterGroups'),
+      ...parseExtensionProperties(element, this.prefix, this.namespace),
+    };
+  },
+
+  processAttributes(model) {
+    const p = model.properties || {};
+    return {
+      ...(p.candidateStarterUsers ? { [`${this.prefix}:candidateStarterUsers`]: p.candidateStarterUsers } : {}),
+      ...(p.candidateStarterGroups ? { [`${this.prefix}:candidateStarterGroups`]: p.candidateStarterGroups } : {}),
+      ...(p.extensionAttributes || {}),
+    };
+  },
+
+  parseNode(element) {
+    const get = (name) => element.getAttributeNS(this.namespace, name) || element.getAttribute(`${this.prefix}:${name}`) || '';
+    const local = element.localName;
+    const common = {
+      async: get('async') === 'true',
+      exclusive: get('exclusive') !== 'false',
+      asyncLeave: get('asyncLeave') === 'true',
+      skipExpression: get('skipExpression'),
+      ...parseExtensionProperties(element, this.prefix, this.namespace),
+    };
+    if (local === 'userTask') Object.assign(common, {
+      assignee: get('assignee'), owner: get('owner'), candidateUsers: get('candidateUsers'), candidateGroups: get('candidateGroups'), formKey: get('formKey'), dueDate: get('dueDate'), priority: get('priority'), category: get('category'),
+    });
+    if (['serviceTask', 'sendTask', 'businessRuleTask'].includes(local)) Object.assign(common, parseImplementation(element, this.prefix, this.namespace), { resultVariable: get('resultVariable') || get('resultVariableName') });
+    if (local === 'scriptTask') common.resultVariable = get('resultVariable') || '';
+    if (local === 'callActivity') Object.assign(common, { businessKey: get('businessKey'), inheritBusinessKey: get('inheritBusinessKey') === 'true', inheritVariables: get('inheritVariables') === 'true', sameDeployment: get('sameDeployment') === 'true', processInstanceName: get('processInstanceName') });
+    return common;
+  },
+
+  nodeAttributes(node) {
+    const p = node.properties || {};
+    const attrs = { ...(p.extensionAttributes || {}) };
+    if (p.async) attrs[`${this.prefix}:async`] = 'true';
+    if (p.exclusive === false) attrs[`${this.prefix}:exclusive`] = 'false';
+    if (p.asyncLeave) attrs[`${this.prefix}:asyncLeave`] = 'true';
+    if (p.skipExpression) attrs[`${this.prefix}:skipExpression`] = p.skipExpression;
+    if (node.type === 'userTask') Object.assign(attrs, {
+      ...(p.assignee ? { [`${this.prefix}:assignee`]: p.assignee } : {}),
+      ...(p.owner ? { [`${this.prefix}:owner`]: p.owner } : {}),
+      ...(p.candidateUsers ? { [`${this.prefix}:candidateUsers`]: p.candidateUsers } : {}),
+      ...(p.candidateGroups ? { [`${this.prefix}:candidateGroups`]: p.candidateGroups } : {}),
+      ...(p.formKey ? { [`${this.prefix}:formKey`]: p.formKey } : {}),
+      ...(p.dueDate ? { [`${this.prefix}:dueDate`]: p.dueDate } : {}),
+      ...(p.priority !== '' && p.priority != null ? { [`${this.prefix}:priority`]: p.priority } : {}),
+      ...(p.category ? { [`${this.prefix}:category`]: p.category } : {}),
+    });
+    if (['serviceTask', 'sendTask', 'businessRuleTask'].includes(node.type) && p.implementation) attrs[`${this.prefix}:${p.implementationType || 'class'}`] = p.implementation;
+    if (['serviceTask', 'sendTask', 'businessRuleTask', 'scriptTask'].includes(node.type) && p.resultVariable) attrs[`${this.prefix}:resultVariable`] = p.resultVariable;
+    if (node.type === 'callActivity') Object.assign(attrs, {
+      ...(p.businessKey ? { [`${this.prefix}:businessKey`]: p.businessKey } : {}),
+      ...(p.inheritBusinessKey ? { [`${this.prefix}:inheritBusinessKey`]: 'true' } : {}),
+      ...(p.inheritVariables ? { [`${this.prefix}:inheritVariables`]: 'true' } : {}),
+      ...(p.sameDeployment ? { [`${this.prefix}:sameDeployment`]: 'true' } : {}),
+      ...(p.processInstanceName ? { [`${this.prefix}:processInstanceName`]: p.processInstanceName } : {}),
+    });
+    return attrs;
+  },
+
+  processExtensionElements(model) {
+    return (model.properties?.executionListeners || []).filter((item) => item.implementation).map((item) => listenerXml(this.prefix, 'executionListener', item));
+  },
+
+  nodeExtensionElements(node) {
+    const p = node.properties || {};
+    const result = [];
+    for (const listener of p.executionListeners || []) if (listener.implementation) result.push(listenerXml(this.prefix, 'executionListener', listener));
+    for (const listener of p.taskListeners || []) if (listener.implementation) result.push(listenerXml(this.prefix, 'taskListener', listener));
+    for (const field of p.fields || []) {
+      if (!field.name) continue;
+      const tag = field.type === 'expression' ? 'expression' : 'string';
+      result.push(`<${this.prefix}:field name="${escapeXml(field.name)}"><${this.prefix}:${tag}>${escapeXml(field.value || '')}</${this.prefix}:${tag}></${this.prefix}:field>`);
+    }
+    if (p.failedJobRetryTimeCycle) result.push(`<${this.prefix}:failedJobRetryTimeCycle>${escapeXml(p.failedJobRetryTimeCycle)}</${this.prefix}:failedJobRetryTimeCycle>`);
+    return result;
+  },
+
+  nodeChildElements(node) {
+    if (node.type !== 'callActivity') return [];
+    const result = [];
+    for (const row of node.properties?.inParameters || []) {
+      const attrs = [row.source ? `source="${escapeXml(row.source)}"` : '', row.sourceExpression ? `sourceExpression="${escapeXml(row.sourceExpression)}"` : '', row.target ? `target="${escapeXml(row.target)}"` : ''].filter(Boolean).join(' ');
+      if (attrs) result.push(`<${this.prefix}:in ${attrs} />`);
+    }
+    for (const row of node.properties?.outParameters || []) {
+      const attrs = [row.source ? `source="${escapeXml(row.source)}"` : '', row.sourceExpression ? `sourceExpression="${escapeXml(row.sourceExpression)}"` : '', row.target ? `target="${escapeXml(row.target)}"` : ''].filter(Boolean).join(' ');
+      if (attrs) result.push(`<${this.prefix}:out ${attrs} />`);
+    }
+    return result;
+  },
+
+  parseEdge(element) {
+    return { ...parseExtensionProperties(element, this.prefix, this.namespace) };
+  },
+
+  edgeExtensionElements(edge) {
+    return (edge.properties?.executionListeners || []).filter((item) => item.implementation).map((item) => listenerXml(this.prefix, 'executionListener', item));
+  },
+};

package/dist/modules/engine-flowable/index.d.ts

@@ -0,0 +1,19 @@
+import type { BpmnEdge, BpmnNode, ProcessModel } from '../core/index.js'
+
+export interface FlowableEngineProfile {
+  id: 'flowable'
+  label: 'Flowable'
+  prefix: 'flowable'
+  namespace: 'http://flowable.org/bpmn'
+  parseProcess(element: Element): Record<string, unknown>
+  processAttributes(model: ProcessModel): Record<string, unknown>
+  parseNode(element: Element): Record<string, unknown>
+  nodeAttributes(node: BpmnNode): Record<string, unknown>
+  processExtensionElements(model: ProcessModel): string[]
+  nodeExtensionElements(node: BpmnNode): string[]
+  nodeChildElements(node: BpmnNode): string[]
+  parseEdge(element: Element): Record<string, unknown>
+  edgeExtensionElements(edge: BpmnEdge): string[]
+}
+
+export const flowableProfile: FlowableEngineProfile

package/dist/modules/engine-flowable/index.js

@@ -0,0 +1,160 @@
+const escapeXml = (value = '') => String(value).replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;').replaceAll('"', '&quot;').replaceAll("'", '&apos;');
+
+function implementationAttrs(prefix, item = {}) {
+  const type = item.implementationType || 'class';
+  const value = item.implementation || '';
+  return value ? ` ${type}="${escapeXml(value)}"` : '';
+}
+
+function parseImplementation(element, prefix, namespace) {
+  const get = (name) => element.getAttributeNS(namespace, name) || element.getAttribute(`${prefix}:${name}`) || '';
+  const found = [['class', get('class')], ['delegateExpression', get('delegateExpression')], ['expression', get('expression')]].find(([, value]) => value);
+  return found ? { implementationType: found[0], implementation: found[1] } : {};
+}
+
+function parseExtensionProperties(element, prefix, namespace) {
+  const properties = { executionListeners: [], taskListeners: [], fields: [] };
+  const ext = Array.from(element.children || []).find((child) => child.localName === 'extensionElements');
+  if (ext) {
+    for (const child of Array.from(ext.children || [])) {
+      if (child.localName === 'executionListener') {
+        properties.executionListeners.push({ event: child.getAttribute('event') || 'start', ...parseImplementation(child, prefix, namespace) });
+      } else if (child.localName === 'taskListener') {
+        properties.taskListeners.push({ event: child.getAttribute('event') || 'create', ...parseImplementation(child, prefix, namespace) });
+      } else if (child.localName === 'field') {
+        const string = Array.from(child.children || []).find((item) => item.localName === 'string');
+        const expression = Array.from(child.children || []).find((item) => item.localName === 'expression');
+        properties.fields.push({ name: child.getAttribute('name') || '', type: expression ? 'expression' : 'string', value: (expression || string)?.textContent || '' });
+      } else if (child.localName === 'failedJobRetryTimeCycle') {
+        properties.failedJobRetryTimeCycle = child.textContent?.trim() || '';
+      }
+    }
+  }
+  const inParameters = [];
+  const outParameters = [];
+  for (const child of Array.from(element.children || [])) {
+    if (child.localName !== 'in' && child.localName !== 'out') continue;
+    const row = { source: child.getAttribute('source') || '', sourceExpression: child.getAttribute('sourceExpression') || '', target: child.getAttribute('target') || '' };
+    (child.localName === 'in' ? inParameters : outParameters).push(row);
+  }
+  if (inParameters.length) properties.inParameters = inParameters;
+  if (outParameters.length) properties.outParameters = outParameters;
+  return properties;
+}
+
+function listenerXml(prefix, kind, listener) {
+  return `<${prefix}:${kind} event="${escapeXml(listener.event || (kind === 'taskListener' ? 'create' : 'start'))}"${implementationAttrs(prefix, listener)} />`;
+}
+
+export const flowableProfile = {
+  id: 'flowable',
+  label: 'Flowable',
+  prefix: 'flowable',
+  namespace: 'http://flowable.org/bpmn',
+
+  parseProcess(element) {
+    const get = (name) => element.getAttributeNS(this.namespace, name) || element.getAttribute(`${this.prefix}:${name}`) || '';
+    return {
+      candidateStarterUsers: get('candidateStarterUsers'),
+      candidateStarterGroups: get('candidateStarterGroups'),
+      ...parseExtensionProperties(element, this.prefix, this.namespace),
+    };
+  },
+
+  processAttributes(model) {
+    const p = model.properties || {};
+    return {
+      ...(p.candidateStarterUsers ? { [`${this.prefix}:candidateStarterUsers`]: p.candidateStarterUsers } : {}),
+      ...(p.candidateStarterGroups ? { [`${this.prefix}:candidateStarterGroups`]: p.candidateStarterGroups } : {}),
+      ...(p.extensionAttributes || {}),
+    };
+  },
+
+  parseNode(element) {
+    const get = (name) => element.getAttributeNS(this.namespace, name) || element.getAttribute(`${this.prefix}:${name}`) || '';
+    const local = element.localName;
+    const common = {
+      async: get('async') === 'true',
+      exclusive: get('exclusive') !== 'false',
+      asyncLeave: get('asyncLeave') === 'true',
+      skipExpression: get('skipExpression'),
+      ...parseExtensionProperties(element, this.prefix, this.namespace),
+    };
+    if (local === 'userTask') Object.assign(common, {
+      assignee: get('assignee'), owner: get('owner'), candidateUsers: get('candidateUsers'), candidateGroups: get('candidateGroups'), formKey: get('formKey'), dueDate: get('dueDate'), priority: get('priority'), category: get('category'),
+    });
+    if (['serviceTask', 'sendTask', 'businessRuleTask'].includes(local)) Object.assign(common, parseImplementation(element, this.prefix, this.namespace), { resultVariable: get('resultVariable') || get('resultVariableName') });
+    if (local === 'scriptTask') common.resultVariable = get('resultVariable') || '';
+    if (local === 'callActivity') Object.assign(common, { businessKey: get('businessKey'), inheritBusinessKey: get('inheritBusinessKey') === 'true', inheritVariables: get('inheritVariables') === 'true', sameDeployment: get('sameDeployment') === 'true', processInstanceName: get('processInstanceName') });
+    return common;
+  },
+
+  nodeAttributes(node) {
+    const p = node.properties || {};
+    const attrs = { ...(p.extensionAttributes || {}) };
+    if (p.async) attrs[`${this.prefix}:async`] = 'true';
+    if (p.exclusive === false) attrs[`${this.prefix}:exclusive`] = 'false';
+    if (p.asyncLeave) attrs[`${this.prefix}:asyncLeave`] = 'true';
+    if (p.skipExpression) attrs[`${this.prefix}:skipExpression`] = p.skipExpression;
+    if (node.type === 'userTask') Object.assign(attrs, {
+      ...(p.assignee ? { [`${this.prefix}:assignee`]: p.assignee } : {}),
+      ...(p.owner ? { [`${this.prefix}:owner`]: p.owner } : {}),
+      ...(p.candidateUsers ? { [`${this.prefix}:candidateUsers`]: p.candidateUsers } : {}),
+      ...(p.candidateGroups ? { [`${this.prefix}:candidateGroups`]: p.candidateGroups } : {}),
+      ...(p.formKey ? { [`${this.prefix}:formKey`]: p.formKey } : {}),
+      ...(p.dueDate ? { [`${this.prefix}:dueDate`]: p.dueDate } : {}),
+      ...(p.priority !== '' && p.priority != null ? { [`${this.prefix}:priority`]: p.priority } : {}),
+      ...(p.category ? { [`${this.prefix}:category`]: p.category } : {}),
+    });
+    if (['serviceTask', 'sendTask', 'businessRuleTask'].includes(node.type) && p.implementation) attrs[`${this.prefix}:${p.implementationType || 'class'}`] = p.implementation;
+    if (['serviceTask', 'sendTask', 'businessRuleTask', 'scriptTask'].includes(node.type) && p.resultVariable) attrs[`${this.prefix}:resultVariable`] = p.resultVariable;
+    if (node.type === 'callActivity') Object.assign(attrs, {
+      ...(p.businessKey ? { [`${this.prefix}:businessKey`]: p.businessKey } : {}),
+      ...(p.inheritBusinessKey ? { [`${this.prefix}:inheritBusinessKey`]: 'true' } : {}),
+      ...(p.inheritVariables ? { [`${this.prefix}:inheritVariables`]: 'true' } : {}),
+      ...(p.sameDeployment ? { [`${this.prefix}:sameDeployment`]: 'true' } : {}),
+      ...(p.processInstanceName ? { [`${this.prefix}:processInstanceName`]: p.processInstanceName } : {}),
+    });
+    return attrs;
+  },
+
+  processExtensionElements(model) {
+    return (model.properties?.executionListeners || []).filter((item) => item.implementation).map((item) => listenerXml(this.prefix, 'executionListener', item));
+  },
+
+  nodeExtensionElements(node) {
+    const p = node.properties || {};
+    const result = [];
+    for (const listener of p.executionListeners || []) if (listener.implementation) result.push(listenerXml(this.prefix, 'executionListener', listener));
+    for (const listener of p.taskListeners || []) if (listener.implementation) result.push(listenerXml(this.prefix, 'taskListener', listener));
+    for (const field of p.fields || []) {
+      if (!field.name) continue;
+      const tag = field.type === 'expression' ? 'expression' : 'string';
+      result.push(`<${this.prefix}:field name="${escapeXml(field.name)}"><${this.prefix}:${tag}>${escapeXml(field.value || '')}</${this.prefix}:${tag}></${this.prefix}:field>`);
+    }
+    if (p.failedJobRetryTimeCycle) result.push(`<${this.prefix}:failedJobRetryTimeCycle>${escapeXml(p.failedJobRetryTimeCycle)}</${this.prefix}:failedJobRetryTimeCycle>`);
+    return result;
+  },
+
+  nodeChildElements(node) {
+    if (node.type !== 'callActivity') return [];
+    const result = [];
+    for (const row of node.properties?.inParameters || []) {
+      const attrs = [row.source ? `source="${escapeXml(row.source)}"` : '', row.sourceExpression ? `sourceExpression="${escapeXml(row.sourceExpression)}"` : '', row.target ? `target="${escapeXml(row.target)}"` : ''].filter(Boolean).join(' ');
+      if (attrs) result.push(`<${this.prefix}:in ${attrs} />`);
+    }
+    for (const row of node.properties?.outParameters || []) {
+      const attrs = [row.source ? `source="${escapeXml(row.source)}"` : '', row.sourceExpression ? `sourceExpression="${escapeXml(row.sourceExpression)}"` : '', row.target ? `target="${escapeXml(row.target)}"` : ''].filter(Boolean).join(' ');
+      if (attrs) result.push(`<${this.prefix}:out ${attrs} />`);
+    }
+    return result;
+  },
+
+  parseEdge(element) {
+    return { ...parseExtensionProperties(element, this.prefix, this.namespace) };
+  },
+
+  edgeExtensionElements(edge) {
+    return (edge.properties?.executionListeners || []).filter((item) => item.implementation).map((item) => listenerXml(this.prefix, 'executionListener', item));
+  },
+};

package/dist/modules/export-svg/index.d.ts

@@ -0,0 +1,112 @@
+import type { BpmnNode, ProcessModel } from '../core/index.js'
+import type { IconRegistry, NodeVisualResolution } from '../icons/index.js'
+import type { NodeRuntimePresentation, ProcessInstanceSnapshot, RuntimeApprovalActionPresentation, RuntimePresentation, RuntimeAssetRef } from '../runtime/index.js'
+import type { NovaResolvedTheme, NovaThemeSnapshot, RuntimeAppearanceOptions, RuntimeAppearanceResolver, ThemeController } from '../theme/index.js'
+
+export type SvgExportTheme = 'current' | NovaResolvedTheme
+export interface SvgExportOptions {
+  theme?: SvgExportTheme
+  transparentBackground?: boolean
+  padding?: number
+  filename?: string
+  title?: string
+  signal?: AbortSignal
+}
+export interface SvgExportWarning {
+  code: string
+  message: string
+  elementId?: string
+  assetId?: string
+}
+export interface SvgExportArtifact {
+  svg: string
+  blob: Blob
+  filename: string
+  mimeType: 'image/svg+xml'
+  width: number
+  height: number
+  viewBox: { x: number; y: number; width: number; height: number }
+  warnings: readonly SvgExportWarning[]
+}
+export interface SvgNodeRendererContext {
+  container: SVGGElement
+  node: BpmnNode
+  definition: Record<string, unknown>
+  runtimePresentation: NodeRuntimePresentation | null
+  visual: NodeVisualResolution
+  model: ProcessModel
+  themeSnapshot: NovaThemeSnapshot
+  iconRegistry: IconRegistry
+}
+export type SvgNodeRenderer = (context: SvgNodeRendererContext) => void | boolean
+export type RuntimeTimelineSvgRenderer = (context: {
+  container: SVGGElement
+  document: Document
+  projection: Record<string, unknown>
+  model: ProcessModel
+  runtime: ProcessInstanceSnapshot | null
+  themeSnapshot: NovaThemeSnapshot
+  appearance: RuntimeAppearanceResolver
+  resolveAsset?: SvgRuntimeAssetResolver
+  signal?: AbortSignal
+}) => void | { height?: number } | Promise<void | { height?: number }>
+export type SvgRuntimeAssetResolver = (asset: RuntimeAssetRef, purpose: 'export', action: RuntimeApprovalActionPresentation) => string | null | Promise<string | null>
+export interface DiagramSvgExportContext {
+  document?: Document
+  root?: HTMLElement
+  model: ProcessModel
+  visualModel?: ProcessModel
+  runtime?: ProcessInstanceSnapshot | null
+  runtimePresentation?: RuntimePresentation
+  runtimeAppearance?: RuntimeAppearanceOptions | RuntimeAppearanceResolver | null
+  themeController?: ThemeController
+  themeSnapshot?: NovaThemeSnapshot
+  iconRegistry?: IconRegistry
+  nodeRenderers?: Record<string, SvgNodeRenderer>
+  htmlNodeRenderers?: Record<string, Function>
+  htmlNodeRenderer?: Function
+  mode?: 'design' | 'viewer' | 'instance'
+  label?: string
+}
+export interface RuntimeTimelineSvgExportContext {
+  document?: Document
+  root?: HTMLElement
+  model: ProcessModel
+  runtime: ProcessInstanceSnapshot | null
+  projection: { items: any[]; groups: any[]; links: any[] }
+  title?: string | null
+  description?: string | null
+  runtimeAppearance?: RuntimeAppearanceOptions | RuntimeAppearanceResolver | null
+  themeController?: ThemeController
+  themeSnapshot?: NovaThemeSnapshot
+  iconRegistry?: IconRegistry
+  resolveAsset?: SvgRuntimeAssetResolver
+  assetCache?: Map<string, string>
+  timelineRenderer?: RuntimeTimelineSvgRenderer
+  label?: string
+}
+export function sanitizeSvgFilename(value: string, fallback?: string): string
+export function exportDiagramSvg(context: DiagramSvgExportContext, options?: SvgExportOptions): Promise<SvgExportArtifact>
+export function exportRuntimeTimelineSvg(context: RuntimeTimelineSvgExportContext, options?: SvgExportOptions & { width?: number; description?: string }): Promise<SvgExportArtifact>
+export function downloadSvg(artifact: SvgExportArtifact, options?: { document?: Document }): string
+
+export interface SvgExportPreviewOptions {
+  container: HTMLElement
+  createArtifact(options: SvgExportOptions): Promise<SvgExportArtifact>
+  title?: string
+  initialTheme?: SvgExportTheme
+  onClose?: () => void
+  onDownload?: (artifact: SvgExportArtifact) => void
+}
+export class SvgExportPreviewController {
+  constructor(options: SvgExportPreviewOptions)
+  readonly artifact: SvgExportArtifact | null
+  readonly closed: boolean
+  setTheme(theme: SvgExportTheme): void
+  setTransparentBackground(value: boolean): void
+  fit(): void
+  actualSize(): void
+  focus(): void
+  close(options?: { immediate?: boolean }): void
+}
+export function openSvgExportPreview(options: SvgExportPreviewOptions): SvgExportPreviewController

package/dist/modules/export-svg/index.js

@@ -0,0 +1,2 @@
+export { downloadSvg, exportDiagramSvg, exportRuntimeTimelineSvg, sanitizeSvgFilename } from './render.js';
+export { SvgExportPreviewController, openSvgExportPreview } from './preview.js';