@mermkit/adapters 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+import type { Diagram } from "@mermkit/core";
+export type ChatTarget = "slack" | "discord" | "github" | "generic";
+export type ChatImage = {
+    bytes: Uint8Array;
+    mime: string;
+    filename?: string;
+};
+export type AdapterResult<TPayload = Record<string, unknown>> = {
+    target: ChatTarget;
+    payload: TPayload;
+    files?: ChatImage[];
+    markdown?: string;
+    meta?: Record<string, unknown>;
+};
+export type ChatPayload<TPayload = Record<string, unknown>> = AdapterResult<TPayload>;
+export type SlackPayload = {
+    text?: string;
+    blocks?: unknown[];
+};
+export type DiscordPayload = {
+    content?: string;
+    embeds?: unknown[];
+};
+export type GitHubPayload = {
+    body: string;
+};
+export type GenericPayload = {
+    text?: string;
+    markdown?: string;
+};
+export type ChatFormatOptions = {
+    image?: ChatImage;
+    altText?: string;
+    includeCodeBlock?: boolean;
+    title?: string;
+};
+export declare function formatForChat(diagram: Diagram, target: ChatTarget, options?: ChatFormatOptions): ChatPayload;
+export declare function formatGenericMessage(diagram: Diagram, options?: ChatFormatOptions): AdapterResult<GenericPayload>;
+export declare function formatSlackMessage(diagram: Diagram, options?: ChatFormatOptions): AdapterResult<SlackPayload>;
+export declare function formatDiscordMessage(diagram: Diagram, options?: ChatFormatOptions): AdapterResult<DiscordPayload>;
+export declare function formatGitHubComment(diagram: Diagram, options?: ChatFormatOptions): AdapterResult<GitHubPayload>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEpE,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,aAAa,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IAC9D,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,QAAQ,CAAC;IAClB,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,WAAW,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,CAAC;AAEtF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,iBAAsB,GAC9B,WAAW,CAYb;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,iBAAsB,GAC9B,aAAa,CAAC,cAAc,CAAC,CAa/B;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,iBAAsB,GAC9B,aAAa,CAAC,YAAY,CAAC,CAiC7B;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,iBAAsB,GAC9B,aAAa,CAAC,cAAc,CAAC,CAwB/B;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,iBAAsB,GAC9B,aAAa,CAAC,aAAa,CAAC,CAc9B"}

package/dist/index.js

@@ -0,0 +1,103 @@
+export function formatForChat(diagram, target, options = {}) {
+    switch (target) {
+        case "slack":
+            return formatSlackMessage(diagram, options);
+        case "discord":
+            return formatDiscordMessage(diagram, options);
+        case "github":
+            return formatGitHubComment(diagram, options);
+        case "generic":
+        default:
+            return formatGenericMessage(diagram, options);
+    }
+}
+export function formatGenericMessage(diagram, options = {}) {
+    const markdown = options.includeCodeBlock === false ? undefined : toMermaidCode(diagram.source);
+    const payload = {
+        text: options.title ?? "Mermaid diagram",
+        markdown
+    };
+    return {
+        target: "generic",
+        payload,
+        files: options.image ? [ensureFilename(options.image)] : undefined,
+        markdown,
+        meta: options.image ? { requiresUpload: true } : undefined
+    };
+}
+export function formatSlackMessage(diagram, options = {}) {
+    const blocks = [];
+    const code = options.includeCodeBlock === false ? undefined : toMermaidCode(diagram.source);
+    if (code) {
+        blocks.push({
+            type: "section",
+            text: { type: "mrkdwn", text: code }
+        });
+    }
+    if (options.image) {
+        const filename = options.image.filename ?? "diagram.png";
+        blocks.push({
+            type: "image",
+            image_url: `attachment://${filename}`,
+            alt_text: options.altText ?? "Mermaid diagram",
+            title: options.title ? { type: "plain_text", text: options.title } : undefined
+        });
+    }
+    const payload = {
+        text: options.title ?? "Mermaid diagram",
+        blocks: blocks.length > 0 ? blocks : undefined
+    };
+    return {
+        target: "slack",
+        payload,
+        files: options.image ? [ensureFilename(options.image)] : undefined,
+        markdown: code,
+        meta: options.image ? { requiresUpload: true } : undefined
+    };
+}
+export function formatDiscordMessage(diagram, options = {}) {
+    const content = options.includeCodeBlock === false ? undefined : toMermaidCode(diagram.source);
+    const embeds = [];
+    if (options.image) {
+        const filename = options.image.filename ?? "diagram.png";
+        embeds.push({
+            title: options.title,
+            image: { url: `attachment://${filename}` },
+            description: options.altText
+        });
+    }
+    const payload = {
+        content,
+        embeds: embeds.length > 0 ? embeds : undefined
+    };
+    return {
+        target: "discord",
+        payload,
+        files: options.image ? [ensureFilename(options.image)] : undefined,
+        markdown: content
+    };
+}
+export function formatGitHubComment(diagram, options = {}) {
+    const code = options.includeCodeBlock === false ? "" : `${toMermaidCode(diagram.source)}\n\n`;
+    const filename = options.image?.filename ?? "diagram.png";
+    const markdown = options.image
+        ? `${code}![Mermaid diagram](<upload_url>)`
+        : code.trim() || undefined;
+    return {
+        target: "github",
+        payload: { body: markdown ?? "" },
+        files: options.image ? [ensureFilename({ ...options.image, filename })] : undefined,
+        markdown,
+        meta: options.image ? { imageFilename: filename, needsUploadUrl: true } : undefined
+    };
+}
+function toMermaidCode(source) {
+    return `\`\`\`mermaid\n${source}\n\`\`\``;
+}
+function ensureFilename(image) {
+    if (image.filename)
+        return image;
+    const ext = image.mime.includes("svg") ? "svg" : image.mime.includes("pdf") ? "pdf" : "png";
+    return { ...image, filename: `diagram.${ext}` };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@mermkit/adapters",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "dependencies": {
+    "@mermkit/core": "0.1.0"
+  }
+}