@crypto512/jicon-mcp 1.3.0 → 2.0.0

package/dist/utils/plantuml/include-expander.d.ts

@@ -1,47 +1,48 @@
 /**
- * PlantUML Include Expander
+ * PlantUML Include Converter
  *
- * Expands !include directives by fetching whitelisted URLs client-side.
- * This bypasses PlantUML server SSRF restrictions for trusted stdlib libraries.
- */
-export declare const ALLOWED_INCLUDE_URLS: string[];
-/**
- * Expand !include directives in PlantUML code
+ * Converts !include directives from GitHub URLs to PlantUML stdlib syntax.
+ * This enables diagrams to work with PlantUML's built-in standard library
+ * without requiring HTTP fetching.
  *
- * Only expands URLs that match the whitelist.
- * Recursively expands nested includes up to MAX_DEPTH.
+ * Example: !include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml
+ *       -> !include <C4/C4_Context>
  */
-export declare function expandIncludes(code: string, depth?: number): Promise<string>;
 /**
- * Expand PlantUML includes within XHTML content
- *
- * Finds all PlantUML macros in XHTML and expands !include directives
- * in their CDATA content before sending to Confluence.
+ * Error thrown when an HTTP include URL cannot be converted to stdlib syntax.
  */
-export declare function expandPlantUmlInXhtml(xhtml: string): Promise<string>;
+export declare class IncludeConversionError extends Error {
+    readonly url: string;
+    readonly suggestion: string;
+    constructor(url: string, suggestion: string);
+}
 /**
- * Clear the include cache
+ * Convert a GitHub URL to PlantUML stdlib syntax if possible.
+ * Returns null if the URL doesn't match any known pattern.
  */
-export declare function clearIncludeCache(): void;
+export declare function urlToStdlib(url: string): string | null;
 /**
- * Get cache statistics (for debugging)
+ * Find all HTTP include URLs in PlantUML code that cannot be converted.
+ * Returns an array of unconvertible URLs.
  */
-export declare function getIncludeCacheStats(): {
-    size: number;
-    urls: string[];
-};
+export declare function findUnconvertibleIncludes(code: string): string[];
 /**
- * Collapse expanded includes back to !include/!includeurl directives
+ * Convert !include directives from GitHub URLs to stdlib syntax.
+ * Throws IncludeConversionError if any HTTP URL cannot be converted.
  *
- * Reverses the expansion by finding the marker comments and replacing
- * the entire block with the original include directive.
+ * @param code - PlantUML code with !include directives
+ * @returns PlantUML code with converted includes
+ * @throws IncludeConversionError if an HTTP URL cannot be converted
  */
-export declare function collapseExpandedIncludes(code: string): string;
+export declare function convertIncludes(code: string): string;
 /**
- * Collapse expanded includes within XHTML content
+ * Convert PlantUML includes within XHTML content.
+ * Throws IncludeConversionError if any HTTP URL cannot be converted.
+ *
+ * Finds all PlantUML macros in XHTML and converts !include directives
+ * in their CDATA content.
  *
- * Finds all PlantUML macros in XHTML and collapses expanded includes
- * back to !include directives when reading from Confluence.
+ * @throws IncludeConversionError if an HTTP URL cannot be converted
  */
-export declare function collapseExpandedIncludesInXhtml(xhtml: string): string;
+export declare function convertPlantUmlIncludesInXhtml(xhtml: string): string;
 //# sourceMappingURL=include-expander.d.ts.map

package/dist/utils/plantuml/include-expander.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"include-expander.d.ts","sourceRoot":"","sources":["../../../src/utils/plantuml/include-expander.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,eAAO,MAAM,oBAAoB,UAIhC,CAAC;AA8CF;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,MAAU,GAChB,OAAO,CAAC,MAAM,CAAC,CAwCjB;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA6B1E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAKvE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM7D;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAwBrE"}
+{"version":3,"file":"include-expander.d.ts","sourceRoot":"","sources":["../../../src/utils/plantuml/include-expander.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;aAE7B,GAAG,EAAE,MAAM;aACX,UAAU,EAAE,MAAM;gBADlB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM;CASrC;AAiHD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQtD;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAahE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA6BpE"}

package/dist/utils/plantuml/include-expander.js

@@ -1,168 +1,202 @@
 /**
- * PlantUML Include Expander
+ * PlantUML Include Converter
  *
- * Expands !include directives by fetching whitelisted URLs client-side.
- * This bypasses PlantUML server SSRF restrictions for trusted stdlib libraries.
+ * Converts !include directives from GitHub URLs to PlantUML stdlib syntax.
+ * This enables diagrams to work with PlantUML's built-in standard library
+ * without requiring HTTP fetching.
+ *
+ * Example: !include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml
+ *       -> !include <C4/C4_Context>
  */
-// Whitelisted URL prefixes - only these are allowed
-export const ALLOWED_INCLUDE_URLS = [
-    "https://raw.githubusercontent.com/plantuml-stdlib/", // C4, Azure, Kubernetes, etc.
-    "https://raw.githubusercontent.com/plantuml/", // Official stdlib
-    "https://raw.githubusercontent.com/awslabs/aws-icons-for-plantuml/", // AWS icons
-];
-const MAX_DEPTH = 5; // Maximum recursion depth for nested includes
-const MAX_SIZE = 100_000; // 100KB max per include file
-const FETCH_TIMEOUT = 5000; // 5 second timeout per fetch
-// In-memory cache (cleared on process restart)
-const cache = new Map();
 /**
- * Check if a URL is in the whitelist
+ * Error thrown when an HTTP include URL cannot be converted to stdlib syntax.
  */
-function isAllowedUrl(url) {
-    return ALLOWED_INCLUDE_URLS.some((prefix) => url.startsWith(prefix));
+export class IncludeConversionError extends Error {
+    url;
+    suggestion;
+    constructor(url, suggestion) {
+        super(`Cannot convert include URL to stdlib syntax: ${url}\n\n` +
+            `The PlantUML server cannot fetch external URLs. You must use PlantUML's built-in stdlib syntax.\n\n` +
+            `${suggestion}`);
+        this.url = url;
+        this.suggestion = suggestion;
+        this.name = "IncludeConversionError";
+    }
 }
 /**
- * Fetch an include file with caching
+ * URL pattern to stdlib mapping rules.
+ * Order matters - more specific patterns should come first.
  */
-async function fetchInclude(url) {
-    // Return cached content if available
-    if (cache.has(url)) {
-        return cache.get(url);
-    }
-    const response = await fetch(url, {
-        signal: AbortSignal.timeout(FETCH_TIMEOUT),
-    });
-    if (!response.ok) {
-        throw new Error(`Failed to fetch include ${url}: ${response.status}`);
-    }
-    const content = await response.text();
-    if (content.length > MAX_SIZE) {
-        throw new Error(`Include file too large (${content.length} bytes): ${url}`);
-    }
-    // Cache the content
-    cache.set(url, content);
-    return content;
-}
+const STDLIB_MAPPINGS = [
+    // C4-PlantUML: plantuml-stdlib/C4-PlantUML/*/C4_*.puml -> <C4/C4_*>
+    {
+        pattern: /^https:\/\/raw\.githubusercontent\.com\/plantuml-stdlib\/C4-PlantUML\/[^/]+\/(.+)\.puml$/,
+        transform: (m) => `<C4/${m[1]}>`,
+    },
+    // AWS Icons (awslabs): awslabs/aws-icons-for-plantuml/*/dist/* -> <awslib/*>
+    {
+        pattern: /^https:\/\/raw\.githubusercontent\.com\/awslabs\/aws-icons-for-plantuml\/[^/]+\/dist\/(.+)\.puml$/,
+        transform: (m) => `<awslib/${m[1]}>`,
+    },
+    // Azure: plantuml-stdlib/Azure-PlantUML/*/* -> <azure/*>
+    {
+        pattern: /^https:\/\/raw\.githubusercontent\.com\/plantuml-stdlib\/Azure-PlantUML\/[^/]+\/(.+)\.puml$/,
+        transform: (m) => `<azure/${m[1]}>`,
+    },
+    // Kubernetes: plantuml-stdlib/plantuml-kubernetes-sprites/*/* -> <kubernetes/*>
+    {
+        pattern: /^https:\/\/raw\.githubusercontent\.com\/plantuml-stdlib\/plantuml-kubernetes-sprites\/[^/]+\/(.+)\.puml$/,
+        transform: (m) => `<kubernetes/${m[1]}>`,
+    },
+    // ArchiMate: plantuml/plantuml-stdlib/master/stdlib/archimate/* -> <archimate/*>
+    {
+        pattern: /^https:\/\/raw\.githubusercontent\.com\/plantuml\/plantuml-stdlib\/[^/]+\/stdlib\/archimate\/(.+)\.puml$/,
+        transform: (m) => `<archimate/${m[1]}>`,
+    },
+    // Generic plantuml-stdlib libraries (fallback for other stdlib repos)
+    {
+        pattern: /^https:\/\/raw\.githubusercontent\.com\/plantuml-stdlib\/([^/]+)\/[^/]+\/(.+)\.puml$/,
+        transform: (m) => {
+            // Map known library names to their stdlib equivalents
+            const libMap = {
+                "Cloudogu-Icons": "cloudogu",
+                "EIP-PlantUML": "eip",
+                "gilbarbara-plantuml-sprites": "logos",
+                "tupadr3-plantuml-sprites": "tupadr3",
+                "office-plantuml": "office",
+            };
+            const lib = libMap[m[1]] || m[1].toLowerCase();
+            return `<${lib}/${m[2]}>`;
+        },
+    },
+];
 /**
- * Expand !include directives in PlantUML code
- *
- * Only expands URLs that match the whitelist.
- * Recursively expands nested includes up to MAX_DEPTH.
+ * Generate a helpful suggestion for fixing an unconvertible include URL.
  */
-export async function expandIncludes(code, depth = 0) {
-    // Prevent infinite recursion
-    if (depth > MAX_DEPTH) {
-        return code;
+function getSuggestionForUrl(url) {
+    // Check if it looks like a known library but wrong format
+    if (url.includes("C4-PlantUML") || url.includes("C4_")) {
+        return (`For C4 diagrams, use the stdlib syntax:\n` +
+            `  !include <C4/C4_Context>\n` +
+            `  !include <C4/C4_Container>\n` +
+            `  !include <C4/C4_Component>\n` +
+            `  !include <C4/C4_Deployment>\n` +
+            `  !include <C4/C4_Dynamic>`);
     }
-    // Match !include and !includeurl directives with HTTP(S) URLs
-    const includePattern = /^(\s*)(!include(?:url)?)\s+(https?:\/\/\S+)/gm;
-    const matches = [...code.matchAll(includePattern)];
-    if (matches.length === 0) {
-        return code;
+    if (url.includes("aws-icons") || url.includes("awslabs")) {
+        return (`For AWS diagrams, use the stdlib syntax:\n` +
+            `  !include <awslib/AWSCommon>\n` +
+            `  !include <awslib/AWSSimplified>\n` +
+            `  !include <awslib/Compute/EC2>\n` +
+            `  !include <awslib/Storage/SimpleStorageService>`);
     }
-    let result = code;
-    for (const match of matches) {
-        const [fullMatch, indent, directive, url] = match;
-        // Skip non-whitelisted URLs
-        if (!isAllowedUrl(url)) {
-            continue;
-        }
-        try {
-            const content = await fetchInclude(url);
-            // Recursively expand nested includes
-            const expanded = await expandIncludes(content, depth + 1);
-            // Wrap expanded content in comments with original include line preserved
-            // This allows easy removal by deleting from opening to closing comment
-            const wrapped = `${indent}' <<<< EXPANDED: ${directive} ${url}\n${expanded}\n${indent}' >>>> END EXPANDED`;
-            result = result.replace(fullMatch, wrapped);
-        }
-        catch (error) {
-            // Re-throw with context
-            const message = error instanceof Error ? error.message : String(error);
-            throw new Error(`Failed to expand include: ${message}`);
-        }
+    if (url.includes("Azure") || url.includes("azure")) {
+        return (`For Azure diagrams, use the stdlib syntax:\n` +
+            `  !include <azure/AzureCommon>\n` +
+            `  !include <azure/Compute/VirtualMachine>\n` +
+            `  !include <azure/Storage/StorageAccounts>`);
     }
-    return result;
+    if (url.includes("kubernetes") || url.includes("k8s")) {
+        return (`For Kubernetes diagrams, use the stdlib syntax:\n` +
+            `  !include <kubernetes/k8s>`);
+    }
+    // Generic suggestion
+    return (`Supported stdlib libraries:\n` +
+        `  - C4: !include <C4/C4_Context>\n` +
+        `  - AWS: !include <awslib/AWSCommon>\n` +
+        `  - Azure: !include <azure/AzureCommon>\n` +
+        `  - Kubernetes: !include <kubernetes/k8s>\n` +
+        `  - ArchiMate: !include <archimate/Archimate>\n\n` +
+        `If you need a custom library, you must inline the definitions directly in your diagram.`);
 }
 /**
- * Expand PlantUML includes within XHTML content
- *
- * Finds all PlantUML macros in XHTML and expands !include directives
- * in their CDATA content before sending to Confluence.
+ * Convert a GitHub URL to PlantUML stdlib syntax if possible.
+ * Returns null if the URL doesn't match any known pattern.
  */
-export async function expandPlantUmlInXhtml(xhtml) {
-    // Match PlantUML macro CDATA content
-    const macroPattern = /(<ac:plain-text-body><!\[CDATA\[)([\s\S]*?)(\]\]><\/ac:plain-text-body>)/g;
-    const matches = [...xhtml.matchAll(macroPattern)];
-    if (matches.length === 0) {
-        return xhtml;
-    }
-    let result = xhtml;
-    for (const match of matches) {
-        const [fullMatch, prefix, code, suffix] = match;
-        // Only process if contains !include or !includeurl
-        if (code.includes("!include")) { // matches both !include and !includeurl
-            try {
-                const expanded = await expandIncludes(code);
-                result = result.replace(fullMatch, prefix + expanded + suffix);
-            }
-            catch (error) {
-                // Log error but don't fail - let Confluence show the error
-                console.error("PlantUML include expansion failed:", error);
-            }
+export function urlToStdlib(url) {
+    for (const mapping of STDLIB_MAPPINGS) {
+        const match = url.match(mapping.pattern);
+        if (match) {
+            return mapping.transform(match);
         }
     }
-    return result;
+    return null;
 }
 /**
- * Clear the include cache
+ * Find all HTTP include URLs in PlantUML code that cannot be converted.
+ * Returns an array of unconvertible URLs.
  */
-export function clearIncludeCache() {
-    cache.clear();
-}
-/**
- * Get cache statistics (for debugging)
- */
-export function getIncludeCacheStats() {
-    return {
-        size: cache.size,
-        urls: [...cache.keys()],
-    };
+export function findUnconvertibleIncludes(code) {
+    const includePattern = /^(\s*)(!include(?:url)?)\s+(https?:\/\/\S+)/gm;
+    const unconvertible = [];
+    let match;
+    while ((match = includePattern.exec(code)) !== null) {
+        const url = match[3];
+        if (urlToStdlib(url) === null) {
+            unconvertible.push(url);
+        }
+    }
+    return unconvertible;
 }
 /**
- * Collapse expanded includes back to !include/!includeurl directives
+ * Convert !include directives from GitHub URLs to stdlib syntax.
+ * Throws IncludeConversionError if any HTTP URL cannot be converted.
  *
- * Reverses the expansion by finding the marker comments and replacing
- * the entire block with the original include directive.
+ * @param code - PlantUML code with !include directives
+ * @returns PlantUML code with converted includes
+ * @throws IncludeConversionError if an HTTP URL cannot be converted
  */
-export function collapseExpandedIncludes(code) {
-    // Pattern matches: ' <<<< EXPANDED: !include[url] URL\n...content...\n' >>>> END EXPANDED
-    // The indent is captured to handle different nesting levels
-    const pattern = /^(\s*)' <<<< EXPANDED: (!include(?:url)? \S+)\n[\s\S]*?\n\1' >>>> END EXPANDED/gm;
-    return code.replace(pattern, "$1$2");
+export function convertIncludes(code) {
+    // First, check for unconvertible URLs
+    const unconvertible = findUnconvertibleIncludes(code);
+    if (unconvertible.length > 0) {
+        const url = unconvertible[0];
+        throw new IncludeConversionError(url, getSuggestionForUrl(url));
+    }
+    // All URLs are convertible, proceed with conversion
+    const includePattern = /^(\s*)(!include(?:url)?)\s+(https?:\/\/\S+)/gm;
+    return code.replace(includePattern, (fullMatch, indent, _directive, url) => {
+        const stdlibPath = urlToStdlib(url);
+        if (stdlibPath) {
+            return `${indent}!include ${stdlibPath}`;
+        }
+        // This shouldn't happen since we checked above, but keep for safety
+        return fullMatch;
+    });
 }
 /**
- * Collapse expanded includes within XHTML content
+ * Convert PlantUML includes within XHTML content.
+ * Throws IncludeConversionError if any HTTP URL cannot be converted.
+ *
+ * Finds all PlantUML macros in XHTML and converts !include directives
+ * in their CDATA content.
  *
- * Finds all PlantUML macros in XHTML and collapses expanded includes
- * back to !include directives when reading from Confluence.
+ * @throws IncludeConversionError if an HTTP URL cannot be converted
  */
-export function collapseExpandedIncludesInXhtml(xhtml) {
+export function convertPlantUmlIncludesInXhtml(xhtml) {
     // Match PlantUML macro CDATA content
     const macroPattern = /(<ac:plain-text-body><!\[CDATA\[)([\s\S]*?)(\]\]><\/ac:plain-text-body>)/g;
-    const matches = [...xhtml.matchAll(macroPattern)];
-    if (matches.length === 0) {
-        return xhtml;
-    }
-    let result = xhtml;
-    for (const match of matches) {
-        const [fullMatch, prefix, code, suffix] = match;
-        // Only process if contains expansion markers
-        if (code.includes("' <<<< EXPANDED:")) {
-            const collapsed = collapseExpandedIncludes(code);
-            result = result.replace(fullMatch, prefix + collapsed + suffix);
+    // First pass: check for unconvertible includes in all macros
+    let match;
+    while ((match = macroPattern.exec(xhtml)) !== null) {
+        const code = match[2];
+        if (code.includes("!include") && code.includes("http")) {
+            const unconvertible = findUnconvertibleIncludes(code);
+            if (unconvertible.length > 0) {
+                const url = unconvertible[0];
+                throw new IncludeConversionError(url, getSuggestionForUrl(url));
+            }
         }
     }
-    return result;
+    // Reset regex for second pass
+    macroPattern.lastIndex = 0;
+    // Second pass: convert all includes
+    return xhtml.replace(macroPattern, (fullMatch, prefix, code, suffix) => {
+        if (code.includes("!include") && code.includes("http")) {
+            const converted = convertIncludes(code);
+            return prefix + converted + suffix;
+        }
+        return fullMatch;
+    });
 }
 //# sourceMappingURL=include-expander.js.map

package/dist/utils/plantuml/include-expander.js.map

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

package/dist/utils/plantuml/index.d.ts

@@ -1,11 +1,11 @@
 /**
  * PlantUML Module Exports
  *
- * Docker-based PlantUML validation and rendering service.
+ * PlantUML validation and rendering service using external PlantUML server.
  */
 export * from "./types.js";
-export { validate, render, isAvailable, getStatus, shutdown, configure, normalizePlantUml, detectDiagramType, initializePlantUml, getUnavailableReason, expandPlantUmlInXhtml, collapseExpandedIncludesInXhtml, ALLOWED_INCLUDE_URLS, } from "./service.js";
-export { startContainer, stopContainer, ensureContainer, getContainerState, isContainerHealthy, cleanupOrphanedContainers, } from "./docker-manager.js";
+export { validate, render, isAvailable, getStatus, shutdown, normalizePlantUml, detectDiagramType, initializePlantUml, getUnavailableReason, convertPlantUmlIncludesInXhtml, } from "./service.js";
+export { IncludeConversionError } from "./include-expander.js";
 export { PlantUmlClient, encodePlantUml } from "./client.js";
 export { createPlantUmlTools, PLANTUML_TOOLS } from "./tools.js";
 export { validatePlantUmlWithFallback, type PlantUmlValidation, type PlantUmlValidationResult, type PlantUmlValidationError, } from "./validation-helper.js";

package/dist/utils/plantuml/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/plantuml/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,YAAY,CAAC;AAG3B,OAAO,EACL,QAAQ,EACR,MAAM,EACN,WAAW,EACX,SAAS,EACT,QAAQ,EACR,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,+BAA+B,EAC/B,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7D,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjE,OAAO,EACL,4BAA4B,EAC5B,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/plantuml/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,YAAY,CAAC;AAG3B,OAAO,EACL,QAAQ,EACR,MAAM,EACN,WAAW,EACX,SAAS,EACT,QAAQ,EACR,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,8BAA8B,GAC/B,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAG/D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7D,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjE,OAAO,EACL,4BAA4B,EAC5B,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,wBAAwB,CAAC"}

package/dist/utils/plantuml/index.js

@@ -1,14 +1,14 @@
 /**
  * PlantUML Module Exports
  *
- * Docker-based PlantUML validation and rendering service.
+ * PlantUML validation and rendering service using external PlantUML server.
  */
 // Types
 export * from "./types.js";
 // Service (main API)
-export { validate, render, isAvailable, getStatus, shutdown, configure, normalizePlantUml, detectDiagramType, initializePlantUml, getUnavailableReason, expandPlantUmlInXhtml, collapseExpandedIncludesInXhtml, ALLOWED_INCLUDE_URLS, } from "./service.js";
-// Docker manager (for lifecycle control)
-export { startContainer, stopContainer, ensureContainer, getContainerState, isContainerHealthy, cleanupOrphanedContainers, } from "./docker-manager.js";
+export { validate, render, isAvailable, getStatus, shutdown, normalizePlantUml, detectDiagramType, initializePlantUml, getUnavailableReason, convertPlantUmlIncludesInXhtml, } from "./service.js";
+// Include converter error (for error handling in tools)
+export { IncludeConversionError } from "./include-expander.js";
 // HTTP client (for direct access if needed)
 export { PlantUmlClient, encodePlantUml } from "./client.js";
 // MCP Tools

package/dist/utils/plantuml/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/plantuml/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,qBAAqB;AACrB,OAAO,EACL,QAAQ,EACR,MAAM,EACN,WAAW,EACX,SAAS,EACT,QAAQ,EACR,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,+BAA+B,EAC/B,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAEtB,yCAAyC;AACzC,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,4CAA4C;AAC5C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7D,YAAY;AACZ,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjE,0CAA0C;AAC1C,OAAO,EACL,4BAA4B,GAI7B,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/plantuml/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,qBAAqB;AACrB,OAAO,EACL,QAAQ,EACR,MAAM,EACN,WAAW,EACX,SAAS,EACT,QAAQ,EACR,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,8BAA8B,GAC/B,MAAM,cAAc,CAAC;AAEtB,wDAAwD;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,4CAA4C;AAC5C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7D,YAAY;AACZ,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjE,0CAA0C;AAC1C,OAAO,EACL,4BAA4B,GAI7B,MAAM,wBAAwB,CAAC"}

package/dist/utils/plantuml/service.d.ts

@@ -2,29 +2,21 @@
  * PlantUML Service
  *
  * Unified service facade for PlantUML operations.
- * Handles eager container initialization at MCP startup and provides high-level API.
- * Does NOT auto-restart if container dies - requires MCP restart.
+ * Connects to an external PlantUML server configured via JICON_PLANTUML_SERVER_URL.
  */
 import { normalizePlantUml, detectDiagramType } from "./client.js";
-import type { PlantUmlConfig, PlantUmlValidationResult, PlantUmlRenderResult, RenderFormat } from "./types.js";
+import type { PlantUmlValidationResult, PlantUmlRenderResult, RenderFormat } from "./types.js";
 /**
- * Configure the PlantUML service
- */
-export declare function configure(config: PlantUmlConfig & {
-    includeExpansion?: boolean;
-}): void;
-/**
- * Initialize PlantUML service at MCP startup.
- * Returns success/failure status. Does not throw.
+ * Initialize PlantUML service with external server URL.
+ * Called at MCP startup.
  */
 export declare function initializePlantUml(options?: {
-    disabled?: boolean;
+    serverUrl?: string;
 }): Promise<{
     success: boolean;
     disabled?: boolean;
     error?: string;
-    containerId?: string;
-    port?: number;
+    serverUrl?: string;
 }>;
 /**
  * Check if PlantUML service can be used.
@@ -33,16 +25,16 @@ export declare function initializePlantUml(options?: {
 export declare function getUnavailableReason(): string | null;
 /**
  * Validate PlantUML syntax
- * Expands !include directives for validation but returns original code
+ * Converts !include URLs to stdlib syntax for validation but returns original code
  */
 export declare function validate(code: string): Promise<PlantUmlValidationResult>;
 /**
  * Render PlantUML diagram to specified format
- * Expands !include directives before rendering
+ * Converts !include URLs to stdlib syntax before rendering
  */
 export declare function render(code: string, format: RenderFormat): Promise<PlantUmlRenderResult>;
 /**
- * Check if PlantUML service is available (container running and healthy)
+ * Check if PlantUML service is available
  */
 export declare function isAvailable(): boolean;
 /**
@@ -51,20 +43,17 @@ export declare function isAvailable(): boolean;
 export declare function getStatus(): {
     available: boolean;
     disabled?: boolean;
-    startupFailed?: boolean;
-    containerDied?: boolean;
+    serverDied?: boolean;
     error?: string;
-    containerId?: string;
-    port?: number;
-    baseUrl?: string;
+    serverUrl?: string;
 };
 /**
- * Shutdown the PlantUML service (stop container)
+ * Shutdown the PlantUML service (cleanup client)
  */
 export declare function shutdown(): Promise<void>;
 /**
  * Re-export utility functions for convenience
  */
 export { normalizePlantUml, detectDiagramType };
-export { expandPlantUmlInXhtml, collapseExpandedIncludesInXhtml, ALLOWED_INCLUDE_URLS, } from "./include-expander.js";
+export { convertPlantUmlIncludesInXhtml } from "./include-expander.js";
 //# sourceMappingURL=service.d.ts.map

package/dist/utils/plantuml/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/utils/plantuml/service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAkB,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEnF,OAAO,KAAK,EACV,cAAc,EACd,wBAAwB,EACxB,oBAAoB,EACpB,YAAY,EACb,MAAM,YAAY,CAAC;AAsBpB;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAQvF;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC;IACtF,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC,CA2BD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,IAAI,CAWpD;AAmCD;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAc9E;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,oBAAoB,CAAC,CAS/B;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAMrC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAqBA;AAED;;GAEG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAG9C;AAED;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,CAAC;AAChD,OAAO,EACL,qBAAqB,EACrB,+BAA+B,EAC/B,oBAAoB,GACrB,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/utils/plantuml/service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAkB,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEnF,OAAO,KAAK,EACV,wBAAwB,EACxB,oBAAoB,EACpB,YAAY,EACb,MAAM,YAAY,CAAC;AAkBpB;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC;IACtF,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC,CAYD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,IAAI,CAQpD;AAsCD;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAY9E;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,oBAAoB,CAAC,CAO/B;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAKrC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAWA;AAED;;GAEG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAE9C;AAED;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,CAAC;AAChD,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC"}