@crypto512/jicon-mcp 0.7.1 → 1.0.0

package/dist/utils/xhtml/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/utils/xhtml/parser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAwB,KAAK,QAAQ,EAAE,KAAK,OAAO,EAAE,MAAM,UAAU,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,eAAO,MAAM,qBAAqB;;;CAGxB,CAAC;AAsCX;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAW7F;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAuDvD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,CAWjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGrD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAE3D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO,CAGjF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAIrD"}

package/dist/utils/xhtml/parser.js

@@ -0,0 +1,180 @@
+/**
+ * XHTML Parser using linkedom
+ *
+ * Parses Confluence storage format (XHTML) with namespace support for ac: and ri: elements.
+ */
+import { parseHTML, DOMParser } from "linkedom";
+// Confluence namespaces
+export const CONFLUENCE_NAMESPACES = {
+    ac: "http://atlassian.com/content",
+    ri: "http://atlassian.com/resource/identifier",
+};
+// Root wrapper with namespace declarations
+const ROOT_OPEN = `<xhtml-root xmlns:ac="${CONFLUENCE_NAMESPACES.ac}" xmlns:ri="${CONFLUENCE_NAMESPACES.ri}">`;
+const ROOT_CLOSE = "</xhtml-root>";
+/**
+ * Check if content already has namespace declarations
+ */
+function hasNamespaces(content) {
+    return content.includes("xmlns:ac") || content.includes("xmlns:ri");
+}
+/**
+ * Check if content has a root element
+ */
+function hasRootElement(content) {
+    const trimmed = content.trim();
+    // Simple heuristic: if it starts with < and has a single root
+    if (!trimmed.startsWith("<"))
+        return false;
+    // Count top-level elements
+    const parser = new DOMParser();
+    try {
+        const doc = parser.parseFromString(`<wrapper>${trimmed}</wrapper>`, "text/html");
+        const wrapper = doc.querySelector("wrapper");
+        if (!wrapper)
+            return false;
+        let elementCount = 0;
+        for (const child of wrapper.childNodes) {
+            if (child.nodeType === 1)
+                elementCount++; // Element node
+        }
+        return elementCount === 1;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Unwrap CDATA sections to preserve their content during HTML parsing.
+ *
+ * The parseHTML function from linkedom treats CDATA as HTML comments and
+ * discards the content. This function converts CDATA sections to plain text
+ * before parsing, preserving the content as textContent of the element.
+ *
+ * @param content - XHTML content with potential CDATA sections
+ * @returns Content with CDATA markers removed but content preserved
+ */
+export function unwrapCdata(content) {
+    return content.replace(/<!\[CDATA\[([\s\S]*?)\]\]>/g, "$1");
+}
+/**
+ * Wrap content with namespace declarations if needed
+ */
+export function wrapWithNamespaces(content) {
+    // If already has namespaces and appears to be a complete document, don't wrap
+    if (hasNamespaces(content) && hasRootElement(content)) {
+        return { wrapped: content, needsUnwrap: false };
+    }
+    // Wrap with our root element that includes namespace declarations
+    return {
+        wrapped: `${ROOT_OPEN}${content}${ROOT_CLOSE}`,
+        needsUnwrap: true,
+    };
+}
+/**
+ * Parse XHTML content into a DOM Document
+ *
+ * @param content - XHTML content string (Confluence storage format)
+ * @returns ParseResult with document or error
+ */
+export function parseXhtml(content) {
+    try {
+        // Unwrap CDATA sections before parsing - linkedom's parseHTML treats
+        // CDATA as HTML comments and discards the content
+        const cdataUnwrapped = unwrapCdata(content);
+        const { wrapped, needsUnwrap } = wrapWithNamespaces(cdataUnwrapped);
+        // Use parseHTML from linkedom which handles XML/XHTML better
+        const { document } = parseHTML(wrapped);
+        // Store whether we need to unwrap when serializing
+        document.__needsUnwrap = needsUnwrap;
+        return { document, error: null };
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        // Try to extract line/column from error message
+        const lineMatch = message.match(/line\s*(\d+)/i);
+        const colMatch = message.match(/col(?:umn)?\s*(\d+)/i);
+        // Also try [row,col] format from some parsers
+        const rowColMatch = message.match(/\[row,col[^\]]*\]:\s*\[(\d+),(\d+)\]/i);
+        const line = lineMatch
+            ? parseInt(lineMatch[1], 10)
+            : rowColMatch
+                ? parseInt(rowColMatch[1], 10)
+                : undefined;
+        const column = colMatch
+            ? parseInt(colMatch[1], 10)
+            : rowColMatch
+                ? parseInt(rowColMatch[2], 10)
+                : undefined;
+        // Extract context snippet from the problematic line
+        let context;
+        if (line) {
+            const lines = content.split("\n");
+            if (lines[line - 1]) {
+                const errorLine = lines[line - 1];
+                // Show up to 100 chars, truncate if longer
+                context = errorLine.length > 100 ? errorLine.substring(0, 100) + "..." : errorLine;
+            }
+        }
+        return {
+            document: null,
+            error: {
+                message,
+                line,
+                column,
+                context,
+            },
+        };
+    }
+}
+/**
+ * Get the root element for operations
+ *
+ * If we wrapped the content, returns the wrapper's children.
+ * Otherwise returns the document root.
+ */
+export function getContentRoot(document) {
+    const needsUnwrap = document.__needsUnwrap;
+    if (needsUnwrap) {
+        // Return our wrapper element so operations work on its children
+        const root = document.querySelector("xhtml-root");
+        return root;
+    }
+    // Return the document's root element
+    return document.documentElement;
+}
+/**
+ * Check if content is valid XHTML (well-formed XML)
+ */
+export function isValidXhtml(content) {
+    const result = parseXhtml(content);
+    return result.document !== null;
+}
+/**
+ * Extract text content from an element, stripping all tags
+ */
+export function extractTextContent(element) {
+    return element.textContent || "";
+}
+/**
+ * Get the tag name including namespace prefix
+ */
+export function getQualifiedTagName(element) {
+    return element.tagName.toLowerCase();
+}
+/**
+ * Check if an element has a specific namespace prefix
+ */
+export function hasNamespacePrefix(element, prefix) {
+    const tagName = element.tagName.toLowerCase();
+    return tagName.startsWith(`${prefix}:`);
+}
+/**
+ * Get the local name (tag name without namespace prefix)
+ */
+export function getLocalName(element) {
+    const tagName = element.tagName.toLowerCase();
+    const colonIndex = tagName.indexOf(":");
+    return colonIndex >= 0 ? tagName.slice(colonIndex + 1) : tagName;
+}
+//# sourceMappingURL=parser.js.map

package/dist/utils/xhtml/parser.js.map

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

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

@@ -0,0 +1,112 @@
+/**
+ * PlantUML Support for Confluence
+ *
+ * Provides:
+ * - PlantUML syntax validation using Docker-based PlantUML server
+ * - Automatic @startuml/@enduml wrapping
+ * - Confluence macro generation
+ *
+ * Note: This module provides synchronous macro building functions.
+ * For async validation with Docker, use the plantuml service directly.
+ */
+import type { Element } from "linkedom";
+import type { PlantUmlValidationResult } from "./types.js";
+/**
+ * Normalize PlantUML code by ensuring @startuml/@enduml markers
+ * (Local implementation for synchronous use)
+ */
+export declare function normalizePlantUml(code: string): string;
+/**
+ * Detect the diagram type from PlantUML code
+ */
+export declare function detectDiagramType(code: string): string | undefined;
+/**
+ * Extract the diagram content (without @startuml/@enduml)
+ */
+export declare function extractDiagramContent(code: string): string;
+/**
+ * Validate PlantUML syntax (synchronous - basic validation only)
+ *
+ * This function performs basic structural validation synchronously.
+ * For full validation with the Docker PlantUML server, use:
+ *   import { validate } from "../plantuml/service.js"
+ *
+ * @param code - PlantUML code (with or without @startuml/@enduml)
+ * @returns Validation result with normalized code
+ */
+export declare function validatePlantUml(code: string): PlantUmlValidationResult;
+/**
+ * Generate a unique macro ID
+ */
+export declare function generateMacroId(): string;
+/**
+ * Build Confluence PlantUML macro XHTML
+ *
+ * @param plantumlCode - PlantUML code (will be normalized)
+ * @param macroId - Optional macro ID (generated if not provided)
+ * @returns Complete ac:structured-macro XHTML for PlantUML
+ */
+export declare function buildPlantUmlMacro(plantumlCode: string, macroId?: string): string;
+/**
+ * Validate and build PlantUML macro in one step (synchronous)
+ *
+ * Uses basic synchronous validation. For full Docker-based validation,
+ * use the plantuml service directly.
+ *
+ * @param plantumlCode - PlantUML code
+ * @param macroId - Optional macro ID
+ * @returns Object with success/error and macro XHTML if successful
+ */
+export declare function validateAndBuildPlantUmlMacro(plantumlCode: string, macroId?: string): {
+    success: true;
+    macro: string;
+    diagramType?: string;
+} | {
+    success: false;
+    error: PlantUmlValidationResult["error"];
+    diagramType?: string;
+};
+/**
+ * Result of PlantUML extraction with detailed error info
+ */
+export interface PlantUmlExtractionResult {
+    code: string | null;
+    error?: string;
+}
+/**
+ * Extract PlantUML code from a Confluence macro element with detailed error info
+ *
+ * @param macroElement - The ac:structured-macro element
+ * @returns Extraction result with code or error
+ */
+export declare function extractPlantUmlFromMacroWithError(macroElement: Element): PlantUmlExtractionResult;
+/**
+ * Extract PlantUML code from a Confluence macro element
+ *
+ * @param macroElement - The ac:structured-macro element
+ * @returns PlantUML code or null if not found
+ */
+export declare function extractPlantUmlFromMacro(macroElement: Element): string | null;
+/**
+ * Update PlantUML code in a macro element
+ *
+ * @param macroElement - The ac:structured-macro element
+ * @param newCode - New PlantUML code
+ * @returns Updated element or null if update failed
+ */
+export declare function updatePlantUmlInMacro(macroElement: Element, newCode: string): boolean;
+/**
+ * Check if content contains raw PlantUML code that needs proper wrapping.
+ *
+ * Returns match info if raw PlantUML is found outside of Confluence macros.
+ * This is used to detect when LLMs put raw @startuml blocks in content
+ * instead of using the buffer_edit_xhtml insert-plantuml operation.
+ *
+ * @param content - Content to check for raw PlantUML
+ * @returns Object with detected flag and hint, or null if no issues
+ */
+export declare function detectRawPlantUml(content: string): {
+    detected: boolean;
+    hint: string;
+} | null;
+//# sourceMappingURL=plantuml.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plantuml.d.ts","sourceRoot":"","sources":["../../../src/utils/xhtml/plantuml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAU3D;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAElE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK1D;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB,CAkEvE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAYjF;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,GACf;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAkB7I;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAAC,YAAY,EAAE,OAAO,GAAG,wBAAwB,CAgCjG;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAG7E;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAerF;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkB7F"}

package/dist/utils/xhtml/plantuml.js

@@ -0,0 +1,251 @@
+/**
+ * PlantUML Support for Confluence
+ *
+ * Provides:
+ * - PlantUML syntax validation using Docker-based PlantUML server
+ * - Automatic @startuml/@enduml wrapping
+ * - Confluence macro generation
+ *
+ * Note: This module provides synchronous macro building functions.
+ * For async validation with Docker, use the plantuml service directly.
+ */
+import { randomBytes } from "crypto";
+// Re-export normalizePlantUml and detectDiagramType from the plantuml service
+// for consistency, but also provide local implementations for sync operations
+import { normalizePlantUml as serviceNormalizePlantUml, detectDiagramType as serviceDetectDiagramType, } from "../plantuml/client.js";
+/**
+ * Normalize PlantUML code by ensuring @startuml/@enduml markers
+ * (Local implementation for synchronous use)
+ */
+export function normalizePlantUml(code) {
+    return serviceNormalizePlantUml(code);
+}
+/**
+ * Detect the diagram type from PlantUML code
+ */
+export function detectDiagramType(code) {
+    return serviceDetectDiagramType(code);
+}
+/**
+ * Extract the diagram content (without @startuml/@enduml)
+ */
+export function extractDiagramContent(code) {
+    return code
+        .replace(/^@startuml\b[^\n]*/im, "")
+        .replace(/@enduml\s*$/im, "")
+        .trim();
+}
+/**
+ * Validate PlantUML syntax (synchronous - basic validation only)
+ *
+ * This function performs basic structural validation synchronously.
+ * For full validation with the Docker PlantUML server, use:
+ *   import { validate } from "../plantuml/service.js"
+ *
+ * @param code - PlantUML code (with or without @startuml/@enduml)
+ * @returns Validation result with normalized code
+ */
+export function validatePlantUml(code) {
+    const normalizedCode = normalizePlantUml(code);
+    const diagramType = detectDiagramType(code);
+    // Basic structural validation (synchronous)
+    // Check for @startuml/@enduml presence after normalization
+    const hasStart = /^@startuml\b/im.test(normalizedCode);
+    const hasEnd = /@enduml\s*$/im.test(normalizedCode);
+    if (!hasStart || !hasEnd) {
+        return {
+            valid: false,
+            normalizedCode,
+            error: {
+                message: "Missing @startuml or @enduml markers",
+                line: 1,
+            },
+            diagramType,
+        };
+    }
+    // Check for external includes (not supported in Confluence)
+    const lines = normalizedCode.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const externalIncludeMatch = line.match(/!include\s+(https?:\/\/[^\s]+)/i);
+        if (externalIncludeMatch) {
+            return {
+                valid: false,
+                normalizedCode,
+                error: {
+                    message: `External includes are not supported in Confluence. Found: !include ${externalIncludeMatch[1]}`,
+                    line: i + 1,
+                    suggestion: "Use native PlantUML syntax instead of C4 includes. See help(topic='plantuml') for examples.",
+                },
+                diagramType,
+            };
+        }
+    }
+    // Check for common syntax errors
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Check for unclosed strings
+        const quoteCount = (line.match(/"/g) || []).length;
+        if (quoteCount % 2 !== 0) {
+            return {
+                valid: false,
+                normalizedCode,
+                error: {
+                    message: "Unclosed string literal",
+                    line: i + 1,
+                },
+                diagramType,
+            };
+        }
+    }
+    // Basic validation passed
+    // Note: For full validation, use the async plantuml service
+    return {
+        valid: true,
+        normalizedCode,
+        diagramType,
+    };
+}
+/**
+ * Generate a unique macro ID
+ */
+export function generateMacroId() {
+    return `plantuml-${randomBytes(8).toString("hex")}`;
+}
+/**
+ * Build Confluence PlantUML macro XHTML
+ *
+ * @param plantumlCode - PlantUML code (will be normalized)
+ * @param macroId - Optional macro ID (generated if not provided)
+ * @returns Complete ac:structured-macro XHTML for PlantUML
+ */
+export function buildPlantUmlMacro(plantumlCode, macroId) {
+    const normalizedCode = normalizePlantUml(plantumlCode);
+    const id = macroId || generateMacroId();
+    // Build the macro structure
+    // Note: The newline before @startuml inside CDATA is important for Confluence
+    return `<ac:structured-macro ac:name="plantuml" ac:schema-version="1" ac:macro-id="${id}">
+  <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
+  <ac:plain-text-body><![CDATA[
+${normalizedCode}
+]]></ac:plain-text-body>
+</ac:structured-macro>`;
+}
+/**
+ * Validate and build PlantUML macro in one step (synchronous)
+ *
+ * Uses basic synchronous validation. For full Docker-based validation,
+ * use the plantuml service directly.
+ *
+ * @param plantumlCode - PlantUML code
+ * @param macroId - Optional macro ID
+ * @returns Object with success/error and macro XHTML if successful
+ */
+export function validateAndBuildPlantUmlMacro(plantumlCode, macroId) {
+    const validation = validatePlantUml(plantumlCode);
+    if (!validation.valid) {
+        return {
+            success: false,
+            error: validation.error,
+            diagramType: validation.diagramType,
+        };
+    }
+    const macro = buildPlantUmlMacro(validation.normalizedCode, macroId);
+    return {
+        success: true,
+        macro,
+        diagramType: validation.diagramType,
+    };
+}
+/**
+ * Extract PlantUML code from a Confluence macro element with detailed error info
+ *
+ * @param macroElement - The ac:structured-macro element
+ * @returns Extraction result with code or error
+ */
+export function extractPlantUmlFromMacroWithError(macroElement) {
+    // Find the plain-text-body element
+    const bodyElement = macroElement.querySelector("ac\\:plain-text-body");
+    if (!bodyElement) {
+        return {
+            code: null,
+            error: "Missing <ac:plain-text-body> element. PlantUML macros must contain: <ac:plain-text-body><![CDATA[@startuml...@enduml]]></ac:plain-text-body>",
+        };
+    }
+    // Get the text content (CDATA will be unwrapped by the parser)
+    const content = bodyElement.textContent;
+    if (!content || !content.trim()) {
+        return {
+            code: null,
+            error: "Empty <ac:plain-text-body>. Add your PlantUML code inside CDATA: <![CDATA[@startuml...@enduml]]>",
+        };
+    }
+    const trimmedContent = content.trim();
+    // Check for @startuml marker
+    if (!trimmedContent.includes("@startuml") && !trimmedContent.includes("@startmindmap") &&
+        !trimmedContent.includes("@startgantt") && !trimmedContent.includes("@startwbs") &&
+        !trimmedContent.includes("@startjson") && !trimmedContent.includes("@startyaml")) {
+        return {
+            code: null,
+            error: `Missing @startuml marker. Content found: "${trimmedContent.substring(0, 50)}${trimmedContent.length > 50 ? "..." : ""}". PlantUML must start with @startuml (or @startmindmap, etc.)`,
+        };
+    }
+    return { code: trimmedContent };
+}
+/**
+ * Extract PlantUML code from a Confluence macro element
+ *
+ * @param macroElement - The ac:structured-macro element
+ * @returns PlantUML code or null if not found
+ */
+export function extractPlantUmlFromMacro(macroElement) {
+    const result = extractPlantUmlFromMacroWithError(macroElement);
+    return result.code;
+}
+/**
+ * Update PlantUML code in a macro element
+ *
+ * @param macroElement - The ac:structured-macro element
+ * @param newCode - New PlantUML code
+ * @returns Updated element or null if update failed
+ */
+export function updatePlantUmlInMacro(macroElement, newCode) {
+    // Find the plain-text-body element
+    const bodyElement = macroElement.querySelector("ac\\:plain-text-body");
+    if (!bodyElement) {
+        return false;
+    }
+    // Normalize the code
+    const normalizedCode = normalizePlantUml(newCode);
+    // Update the content with CDATA
+    // Note: Setting textContent will escape the CDATA properly in serialization
+    bodyElement.textContent = `\n${normalizedCode}\n`;
+    return true;
+}
+/**
+ * Check if content contains raw PlantUML code that needs proper wrapping.
+ *
+ * Returns match info if raw PlantUML is found outside of Confluence macros.
+ * This is used to detect when LLMs put raw @startuml blocks in content
+ * instead of using the buffer_edit_xhtml insert-plantuml operation.
+ *
+ * @param content - Content to check for raw PlantUML
+ * @returns Object with detected flag and hint, or null if no issues
+ */
+export function detectRawPlantUml(content) {
+    // Check for raw @startuml blocks not already inside CDATA
+    const rawMatch = content.match(/(?<!\[CDATA\[\s*\n?)(@startuml[\s\S]*?@enduml)/);
+    // Also check for markdown-style plantuml blocks
+    const markdownMatch = content.match(/```plantuml\s*\n[\s\S]*?```/);
+    if (rawMatch || markdownMatch) {
+        // Make sure it's not already wrapped in a Confluence macro
+        if (!content.includes('<ac:structured-macro ac:name="plantuml"')) {
+            return {
+                detected: true,
+                hint: "Use buffer_edit_xhtml with operation='insert-plantuml' to add PlantUML diagrams. Call help(topic='plantuml') for the correct workflow.",
+            };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=plantuml.js.map

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

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

package/dist/utils/xhtml/selector.d.ts

@@ -0,0 +1,35 @@
+/**
+ * CSS-like Selector Engine for Confluence XHTML
+ *
+ * Supports:
+ * - Tag name: p, h1, table
+ * - Namespaced: ac:structured-macro, ri:page
+ * - Attributes: [ac:name="plantuml"], ac:structured-macro[ac:name="code"]
+ * - Pseudo-selectors: :nth-child(2), :first-child, :last-child
+ * - Descendants: table tbody tr
+ * - Direct children: ul > li
+ */
+import type { Document } from "linkedom";
+import type { SelectorResult } from "./types.js";
+/**
+ * Check if a selector contains unsupported pseudo-selectors
+ * Returns the unsupported pseudo name or null
+ */
+export declare function findUnsupportedPseudo(selector: string): string | null;
+/**
+ * Execute a selector query on a document
+ *
+ * @param document - DOM Document to search
+ * @param selector - CSS-like selector string
+ * @returns SelectorResult with matches
+ */
+export declare function querySelector(document: Document, selector: string): SelectorResult;
+/**
+ * Check if a selector is valid
+ */
+export declare function isValidSelector(selector: string): boolean;
+/**
+ * Get a human-readable description of a selector
+ */
+export declare function describeSelector(selector: string): string;
+//# sourceMappingURL=selector.d.ts.map

package/dist/utils/xhtml/selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../../../src/utils/xhtml/selector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAW,MAAM,UAAU,CAAC;AAClD,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,YAAY,CAAC;AA8LhE;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWrE;AAqGD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAsClF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAOzD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA+BzD"}