@crypto512/jicon-mcp 1.0.4 → 1.1.1

package/dist/utils/xhtml/error-locator.d.ts

@@ -0,0 +1,70 @@
+/**
+ * XHTML Error Locator
+ *
+ * Parses Confluence XHTML error messages and maps them to buffer element IDs
+ * to enable targeted fixes instead of full buffer recreation.
+ */
+import type { ApiError } from "../../types.js";
+/**
+ * Parsed location from Confluence error message
+ */
+export interface ConfluenceErrorLocation {
+    row: number;
+    col: number;
+}
+/**
+ * Location mapped to buffer structure
+ */
+export interface BufferErrorLocation {
+    elementId: number;
+    elementType: string;
+    lineInElement: number;
+    lineContent: string;
+    errorContext: string;
+}
+/**
+ * Suggested action for error recovery
+ */
+export interface SuggestedAction {
+    tool: string;
+    args: Record<string, unknown>;
+    description: string;
+}
+/**
+ * Enhanced error with location and recovery actions
+ */
+export interface EnhancedXhtmlError extends ApiError {
+    errorLocation?: BufferErrorLocation;
+    suggestedActions?: SuggestedAction[];
+}
+/**
+ * Parse Confluence XHTML error message to extract row/col
+ *
+ * Handles formats:
+ * - "[row,col {unknown-source}]: [420,14]"
+ * - "at line 420, column 14"
+ * - "line 420:14"
+ */
+export declare function parseConfluenceXhtmlError(message: string): ConfluenceErrorLocation | null;
+/**
+ * Locate an error position within a buffer's element structure
+ */
+export declare function locateErrorInBuffer(bufferId: string, row: number, col: number): BufferErrorLocation | null;
+/**
+ * Enhance an API error with XHTML error location and recovery actions
+ *
+ * @param error - Original API error from Confluence
+ * @param bufferId - Buffer ID containing the content that caused the error
+ * @returns Enhanced error with location info and suggested actions, or null if not applicable
+ */
+export declare function enhanceXhtmlError(error: ApiError, bufferId: string): EnhancedXhtmlError | null;
+/**
+ * Get element content by ID from a buffer
+ * Returns the outerHTML of the element
+ */
+export declare function getElementContentById(bufferId: string, elementId: number): {
+    content: string;
+    elementType: string;
+    lineCount: number;
+} | null;
+//# sourceMappingURL=error-locator.d.ts.map

package/dist/utils/xhtml/error-locator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-locator.d.ts","sourceRoot":"","sources":["../../../src/utils/xhtml/error-locator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,QAAQ;IAClD,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;CACtC;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,uBAAuB,GAAG,IAAI,CA8BzF;AAwDD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,mBAAmB,GAAG,IAAI,CAyC5B;AAgDD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,MAAM,GACf,kBAAkB,GAAG,IAAI,CAmB3B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA8BpE"}

package/dist/utils/xhtml/error-locator.js

@@ -0,0 +1,229 @@
+/**
+ * XHTML Error Locator
+ *
+ * Parses Confluence XHTML error messages and maps them to buffer element IDs
+ * to enable targeted fixes instead of full buffer recreation.
+ */
+import { contentBuffer } from "../content-buffer.js";
+import { parseXhtml, getContentRoot } from "./parser.js";
+/**
+ * Parse Confluence XHTML error message to extract row/col
+ *
+ * Handles formats:
+ * - "[row,col {unknown-source}]: [420,14]"
+ * - "at line 420, column 14"
+ * - "line 420:14"
+ */
+export function parseConfluenceXhtmlError(message) {
+    // Format: [row,col {unknown-source}]: [420,14]
+    // Handle whitespace variations: [row,col  {unknown-source}]:  [  123 , 45 ]
+    const bracketMatch = message.match(/\[row,col\s*\{[^}]*\}\]\s*:\s*\[\s*(\d+)\s*,\s*(\d+)\s*\]/i);
+    if (bracketMatch) {
+        return {
+            row: parseInt(bracketMatch[1], 10),
+            col: parseInt(bracketMatch[2], 10),
+        };
+    }
+    // Format: at line 420, column 14
+    const atLineMatch = message.match(/at line\s+(\d+),?\s*column\s+(\d+)/i);
+    if (atLineMatch) {
+        return {
+            row: parseInt(atLineMatch[1], 10),
+            col: parseInt(atLineMatch[2], 10),
+        };
+    }
+    // Format: line 420:14
+    const lineColonMatch = message.match(/line\s+(\d+):(\d+)/i);
+    if (lineColonMatch) {
+        return {
+            row: parseInt(lineColonMatch[1], 10),
+            col: parseInt(lineColonMatch[2], 10),
+        };
+    }
+    return null;
+}
+/**
+ * Count lines in a string
+ */
+function countLines(text) {
+    return (text.match(/\n/g) || []).length + 1;
+}
+/**
+ * Get start line number for an element in the serialized content
+ */
+function getElementStartLine(content, elementId) {
+    const lines = content.split("\n");
+    const idPattern = new RegExp(`data-jicon-id=["']${elementId}["']`);
+    for (let i = 0; i < lines.length; i++) {
+        if (idPattern.test(lines[i])) {
+            return i + 1; // 1-indexed
+        }
+    }
+    return null;
+}
+/**
+ * Get the line range for an element (start line to end line)
+ */
+function getElementLineRange(content, elementId) {
+    const parseResult = parseXhtml(content);
+    if (!parseResult.document)
+        return null;
+    const root = getContentRoot(parseResult.document);
+    if (!root)
+        return null;
+    const element = root.querySelector(`[data-jicon-id="${elementId}"]`);
+    if (!element)
+        return null;
+    // Get the outer HTML of the element
+    const outerHtml = element.outerHTML;
+    // Find where this element starts in the content
+    const startLine = getElementStartLine(content, elementId);
+    if (!startLine)
+        return null;
+    // Count lines in the element
+    const elementLines = countLines(outerHtml);
+    return {
+        startLine,
+        endLine: startLine + elementLines - 1,
+    };
+}
+/**
+ * Locate an error position within a buffer's element structure
+ */
+export function locateErrorInBuffer(bufferId, row, col) {
+    const bufferInfo = contentBuffer.getInfo(bufferId);
+    if (!bufferInfo)
+        return null;
+    // Get buffer content
+    const chunk = contentBuffer.getChunk(bufferId, 0, bufferInfo.totalSize);
+    if (!chunk)
+        return null;
+    const content = chunk.chunk;
+    const lines = content.split("\n");
+    // Validate row is within bounds
+    if (row < 1 || row > lines.length)
+        return null;
+    const lineContent = lines[row - 1]; // Convert to 0-indexed
+    const structure = bufferInfo.structure;
+    if (!structure || structure.length === 0)
+        return null;
+    // Find which element contains this line
+    for (const elem of structure) {
+        const range = getElementLineRange(content, elem.id);
+        if (range && row >= range.startLine && row <= range.endLine) {
+            // Calculate line within element
+            const lineInElement = row - range.startLine + 1;
+            // Extract error context around the column
+            const contextStart = Math.max(0, col - 25);
+            const contextEnd = Math.min(lineContent.length, col + 25);
+            const errorContext = lineContent.substring(contextStart, contextEnd);
+            return {
+                elementId: elem.id,
+                elementType: elem.type,
+                lineInElement,
+                lineContent: lineContent.length > 100 ? lineContent.substring(0, 100) + "..." : lineContent,
+                errorContext,
+            };
+        }
+    }
+    return null;
+}
+/**
+ * Build suggested actions for error recovery
+ */
+function buildSuggestedActions(bufferId, location) {
+    const actions = [];
+    if (location) {
+        // Action 1: Get element content for inspection
+        actions.push({
+            tool: "buffer_get_element",
+            args: {
+                bufferId,
+                elementId: location.elementId,
+            },
+            description: `Inspect element ${location.elementId} (${location.elementType}) containing the error`,
+        });
+        // Action 2: Replace element
+        actions.push({
+            tool: "buffer_edit",
+            args: {
+                bufferId,
+                replace: location.elementId,
+                content: "<!-- fixed content here -->",
+            },
+            description: `Replace element ${location.elementId} with fixed content`,
+        });
+    }
+    else {
+        // Fallback: use buffer_grep to find the problematic content
+        actions.push({
+            tool: "buffer_grep",
+            args: {
+                bufferId,
+                pattern: "<\\d|<[a-z]+\\|",
+                "-C": 2,
+            },
+            description: "Search for XML-like patterns that might cause parsing errors",
+        });
+    }
+    return actions;
+}
+/**
+ * Enhance an API error with XHTML error location and recovery actions
+ *
+ * @param error - Original API error from Confluence
+ * @param bufferId - Buffer ID containing the content that caused the error
+ * @returns Enhanced error with location info and suggested actions, or null if not applicable
+ */
+export function enhanceXhtmlError(error, bufferId) {
+    // Only enhance XHTML parsing errors
+    if (!error.message)
+        return null;
+    const parsedLocation = parseConfluenceXhtmlError(error.message);
+    if (!parsedLocation)
+        return null;
+    // Try to locate the error in the buffer
+    const bufferLocation = locateErrorInBuffer(bufferId, parsedLocation.row, parsedLocation.col);
+    // Build suggested actions
+    const suggestedActions = buildSuggestedActions(bufferId, bufferLocation);
+    // Return enhanced error
+    return {
+        ...error,
+        errorLocation: bufferLocation ?? undefined,
+        suggestedActions,
+    };
+}
+/**
+ * Get element content by ID from a buffer
+ * Returns the outerHTML of the element
+ */
+export function getElementContentById(bufferId, elementId) {
+    const bufferInfo = contentBuffer.getInfo(bufferId);
+    if (!bufferInfo)
+        return null;
+    const chunk = contentBuffer.getChunk(bufferId, 0, bufferInfo.totalSize);
+    if (!chunk)
+        return null;
+    const parseResult = parseXhtml(chunk.chunk);
+    if (!parseResult.document)
+        return null;
+    const root = getContentRoot(parseResult.document);
+    if (!root)
+        return null;
+    const element = root.querySelector(`[data-jicon-id="${elementId}"]`);
+    if (!element)
+        return null;
+    const content = element.outerHTML;
+    const lineCount = countLines(content);
+    // Determine element type
+    let elementType = element.tagName.toLowerCase();
+    if (elementType === "ac:structured-macro") {
+        elementType = element.getAttribute("ac:name") || "macro";
+    }
+    return {
+        content,
+        elementType,
+        lineCount,
+    };
+}
+//# sourceMappingURL=error-locator.js.map

package/dist/utils/xhtml/error-locator.js.map

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

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

@@ -6,12 +6,15 @@
 export type { Position, Operation, SemanticPosition, BufferEditXhtmlArgs, ValidationError, ValidationWarning, ValidationResult, XhtmlEditSuccess, XhtmlEditError, XhtmlEditResult, PlantUmlValidationResult, ParseResult, SelectorMatch, SelectorResult, } from "./types.js";
 export { PositionSchema, OperationSchema, SemanticPositionSchema, BufferEditXhtmlSchema, } from "./types.js";
 export { parseXhtml, getContentRoot, isValidXhtml, wrapWithNamespaces, CONFLUENCE_NAMESPACES, } from "./parser.js";
-export { serializeXhtml, serializeFragment, prettyPrint, } from "./serializer.js";
+export { serializeXhtml, serializeFragment, prettyPrint, stripJiconIds, } from "./serializer.js";
 export { querySelector, isValidSelector, describeSelector, findUnsupportedPseudo, } from "./selector.js";
-export { executeOperation, executeInsert, executeUpdate, executeRemove, executeMoveOperation, executeWrap, resolveSemanticPosition, } from "./operations.js";
+export { executeOperation, executeInsert, executeUpdate, executeRemove, executeMoveOperation, executeWrap, resolveSemanticPosition, parseStructure, findElementById, insertById, appendToDocument, replaceById, removeById, } from "./operations.js";
+export type { ElementInfo } from "./operations.js";
 export { validateXhtml, validateXhtmlAsync, isValid, formatValidationErrors, formatValidationWarnings, getValidationReport, } from "./validator.js";
 export type { AsyncValidationResult, PlantUmlValidationInfo } from "./validator.js";
 export { CONFLUENCE_ELEMENTS, RESOURCE_IDENTIFIERS, KNOWN_MACROS, STANDARD_HTML_ELEMENTS, isConfluenceElement, isStandardHtmlElement, isKnownMacro, getElementDef, getRequiredAttributes, getValidAttributeValues, } from "./confluence-schema.js";
-export { validatePlantUml, normalizePlantUml, extractDiagramContent, buildPlantUmlMacro, validateAndBuildPlantUmlMacro, generateMacroId, extractPlantUmlFromMacro, extractPlantUmlFromMacroWithError, updatePlantUmlInMacro, } from "./plantuml.js";
+export { validatePlantUml, normalizePlantUml, extractDiagramContent, buildPlantUmlMacro, validateAndBuildPlantUmlMacro, generateMacroId, extractPlantUmlFromMacro, extractPlantUmlFromMacroWithError, updatePlantUmlInMacro, detectRawPlantUml, } from "./plantuml.js";
 export type { PlantUmlExtractionResult } from "./plantuml.js";
+export { parseConfluenceXhtmlError, locateErrorInBuffer, enhanceXhtmlError, getElementContentById, } from "./error-locator.js";
+export type { ConfluenceErrorLocation, BufferErrorLocation, SuggestedAction, EnhancedXhtmlError, } from "./error-locator.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/xhtml/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,QAAQ,EACR,SAAS,EACT,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,wBAAwB,EACxB,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,UAAU,EACV,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,WAAW,EACX,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,OAAO,EACP,sBAAsB,EACtB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAGpF,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,6BAA6B,EAC7B,eAAe,EACf,wBAAwB,EACxB,iCAAiC,EACjC,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/xhtml/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,QAAQ,EACR,SAAS,EACT,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,wBAAwB,EACxB,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,UAAU,EACV,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,WAAW,EACX,uBAAuB,EAEvB,cAAc,EACd,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGnD,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,OAAO,EACP,sBAAsB,EACtB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAGpF,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,6BAA6B,EAC7B,eAAe,EACf,wBAAwB,EACxB,iCAAiC,EACjC,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAG9D,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,uBAAuB,EACvB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,GACnB,MAAM,oBAAoB,CAAC"}

package/dist/utils/xhtml/index.js

@@ -7,15 +7,19 @@ export { PositionSchema, OperationSchema, SemanticPositionSchema, BufferEditXhtm
 // Parser
 export { parseXhtml, getContentRoot, isValidXhtml, wrapWithNamespaces, CONFLUENCE_NAMESPACES, } from "./parser.js";
 // Serializer
-export { serializeXhtml, serializeFragment, prettyPrint, } from "./serializer.js";
+export { serializeXhtml, serializeFragment, prettyPrint, stripJiconIds, } from "./serializer.js";
 // Selector
 export { querySelector, isValidSelector, describeSelector, findUnsupportedPseudo, } from "./selector.js";
 // Operations
-export { executeOperation, executeInsert, executeUpdate, executeRemove, executeMoveOperation, executeWrap, resolveSemanticPosition, } from "./operations.js";
+export { executeOperation, executeInsert, executeUpdate, executeRemove, executeMoveOperation, executeWrap, resolveSemanticPosition, 
+// Element ID-based operations
+parseStructure, findElementById, insertById, appendToDocument, replaceById, removeById, } from "./operations.js";
 // Validator
 export { validateXhtml, validateXhtmlAsync, isValid, formatValidationErrors, formatValidationWarnings, getValidationReport, } from "./validator.js";
 // Confluence Schema
 export { CONFLUENCE_ELEMENTS, RESOURCE_IDENTIFIERS, KNOWN_MACROS, STANDARD_HTML_ELEMENTS, isConfluenceElement, isStandardHtmlElement, isKnownMacro, getElementDef, getRequiredAttributes, getValidAttributeValues, } from "./confluence-schema.js";
 // PlantUML
-export { validatePlantUml, normalizePlantUml, extractDiagramContent, buildPlantUmlMacro, validateAndBuildPlantUmlMacro, generateMacroId, extractPlantUmlFromMacro, extractPlantUmlFromMacroWithError, updatePlantUmlInMacro, } from "./plantuml.js";
+export { validatePlantUml, normalizePlantUml, extractDiagramContent, buildPlantUmlMacro, validateAndBuildPlantUmlMacro, generateMacroId, extractPlantUmlFromMacro, extractPlantUmlFromMacroWithError, updatePlantUmlInMacro, detectRawPlantUml, } from "./plantuml.js";
+// Error Locator
+export { parseConfluenceXhtmlError, locateErrorInBuffer, enhanceXhtmlError, getElementContentById, } from "./error-locator.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/xhtml/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,OAAO,EACL,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAEpB,SAAS;AACT,OAAO,EACL,UAAU,EACV,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,aAAa;AACb,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAEzB,WAAW;AACX,OAAO,EACL,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,aAAa;AACb,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,WAAW,EACX,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AAEzB,YAAY;AACZ,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,OAAO,EACP,sBAAsB,EACtB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAGxB,oBAAoB;AACpB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAEhC,WAAW;AACX,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,6BAA6B,EAC7B,eAAe,EACf,wBAAwB,EACxB,iCAAiC,EACjC,qBAAqB,GACtB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/xhtml/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,OAAO,EACL,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAEpB,SAAS;AACT,OAAO,EACL,UAAU,EACV,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,aAAa;AACb,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,WAAW;AACX,OAAO,EACL,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,aAAa;AACb,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,WAAW,EACX,uBAAuB;AACvB,8BAA8B;AAC9B,cAAc,EACd,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,UAAU,GACX,MAAM,iBAAiB,CAAC;AAGzB,YAAY;AACZ,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,OAAO,EACP,sBAAsB,EACtB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAGxB,oBAAoB;AACpB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAEhC,WAAW;AACX,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,6BAA6B,EAC7B,eAAe,EACf,wBAAwB,EACxB,iCAAiC,EACjC,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAGvB,gBAAgB;AAChB,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC"}

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

@@ -96,5 +96,59 @@ export declare function executeOperation(document: Document, operation: Operatio
     matchIndex?: number;
     matchAll?: boolean;
 }): XhtmlEditSuccess | XhtmlEditError;
+/**
+ * Element info for structure tracking
+ */
+export interface ElementInfo {
+    id: number;
+    type: string;
+    text?: string;
+    children?: number;
+}
+/**
+ * Parse XHTML document and build structure with element IDs
+ * IDs are assigned via data-jicon-id attributes for stability
+ */
+export declare function parseStructure(document: Document): {
+    structure: ElementInfo[];
+    nextId: number;
+};
+/**
+ * Find element by its jicon ID
+ */
+export declare function findElementById(document: Document, id: number): Element | null;
+/**
+ * Insert content relative to an element ID
+ * Returns the ID(s) assigned to the new element(s)
+ */
+export declare function insertById(document: Document, targetId: number, position: "before" | "after", content: string, nextId: number): {
+    success: boolean;
+    insertedIds: number[];
+    nextId: number;
+    error?: string;
+};
+/**
+ * Append content at document end
+ */
+export declare function appendToDocument(document: Document, content: string, nextId: number): {
+    success: boolean;
+    insertedIds: number[];
+    nextId: number;
+    error?: string;
+};
+/**
+ * Replace element by ID with new content
+ */
+export declare function replaceById(document: Document, targetId: number, content: string): {
+    success: boolean;
+    error?: string;
+};
+/**
+ * Remove element by ID
+ */
+export declare function removeById(document: Document, targetId: number): {
+    success: boolean;
+    error?: string;
+};
 export {};
 //# sourceMappingURL=operations.d.ts.map

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

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

package/dist/utils/xhtml/operations.js

@@ -593,4 +593,209 @@ export function executeOperation(document, operation, selector, options) {
             return { error: true, message: `Unknown operation: ${operation}` };
     }
 }
+const JICON_ID_ATTR = "data-jicon-id";
+/**
+ * Get element type from tag name, handling Confluence macros specially
+ */
+function getElementType(el) {
+    const tagName = el.tagName.toLowerCase();
+    // Handle Confluence macros
+    if (tagName === "ac:structured-macro") {
+        const macroName = el.getAttribute("ac:name");
+        if (macroName) {
+            return macroName; // "plantuml", "code", "info", etc.
+        }
+    }
+    return tagName;
+}
+/**
+ * Get preview text from element (truncated)
+ */
+function getPreviewText(el, maxLength = 50) {
+    const text = el.textContent?.trim();
+    if (!text)
+        return undefined;
+    if (text.length <= maxLength)
+        return text;
+    return text.substring(0, maxLength) + "...";
+}
+/**
+ * Count children for container elements
+ */
+function getChildCount(el) {
+    const tagName = el.tagName.toLowerCase();
+    if (tagName === "ul" || tagName === "ol") {
+        return el.querySelectorAll("li").length;
+    }
+    if (tagName === "table") {
+        return el.querySelectorAll("tr").length;
+    }
+    return undefined;
+}
+/**
+ * Parse XHTML document and build structure with element IDs
+ * IDs are assigned via data-jicon-id attributes for stability
+ */
+export function parseStructure(document) {
+    const structure = [];
+    const root = getContentRoot(document);
+    if (!root) {
+        return { structure, nextId: 1 };
+    }
+    let maxId = 0;
+    // Walk top-level elements and assign IDs
+    for (const child of root.children) {
+        const el = child;
+        // Get existing ID or assign new one
+        let id = parseInt(el.getAttribute(JICON_ID_ATTR) || "0", 10);
+        if (!id || isNaN(id)) {
+            id = ++maxId;
+            el.setAttribute(JICON_ID_ATTR, String(id));
+        }
+        else {
+            maxId = Math.max(maxId, id);
+        }
+        structure.push({
+            id,
+            type: getElementType(el),
+            text: getPreviewText(el),
+            children: getChildCount(el),
+        });
+    }
+    return { structure, nextId: maxId + 1 };
+}
+/**
+ * Find element by its jicon ID
+ */
+export function findElementById(document, id) {
+    const root = getContentRoot(document);
+    if (!root)
+        return null;
+    return root.querySelector(`[${JICON_ID_ATTR}="${id}"]`);
+}
+/**
+ * Insert content relative to an element ID
+ * Returns the ID(s) assigned to the new element(s)
+ */
+export function insertById(document, targetId, position, content, nextId) {
+    const targetEl = findElementById(document, targetId);
+    if (!targetEl) {
+        return { success: false, insertedIds: [], nextId, error: `Element not found: ${targetId}` };
+    }
+    try {
+        const nodes = parseContent(document, content);
+        if (nodes.length === 0) {
+            return { success: false, insertedIds: [], nextId, error: "Content to insert is empty or invalid" };
+        }
+        const insertedIds = [];
+        let currentNextId = nextId;
+        // Assign IDs to new elements and insert
+        for (const node of nodes) {
+            if (node.nodeType === 1) { // Element node
+                const el = node;
+                el.setAttribute(JICON_ID_ATTR, String(currentNextId));
+                insertedIds.push(currentNextId);
+                currentNextId++;
+            }
+        }
+        // Insert nodes
+        const parent = targetEl.parentNode;
+        if (!parent) {
+            return { success: false, insertedIds: [], nextId, error: "Target element has no parent" };
+        }
+        if (position === "before") {
+            for (const node of nodes) {
+                parent.insertBefore(node, targetEl);
+            }
+        }
+        else {
+            const nextSibling = targetEl.nextSibling;
+            for (const node of nodes) {
+                parent.insertBefore(node, nextSibling);
+            }
+        }
+        return { success: true, insertedIds, nextId: currentNextId };
+    }
+    catch (e) {
+        return { success: false, insertedIds: [], nextId, error: e instanceof Error ? e.message : String(e) };
+    }
+}
+/**
+ * Append content at document end
+ */
+export function appendToDocument(document, content, nextId) {
+    const root = getContentRoot(document);
+    if (!root) {
+        return { success: false, insertedIds: [], nextId, error: "Document has no content root" };
+    }
+    try {
+        const nodes = parseContent(document, content);
+        if (nodes.length === 0) {
+            return { success: false, insertedIds: [], nextId, error: "Content to insert is empty or invalid" };
+        }
+        const insertedIds = [];
+        let currentNextId = nextId;
+        for (const node of nodes) {
+            if (node.nodeType === 1) {
+                const el = node;
+                el.setAttribute(JICON_ID_ATTR, String(currentNextId));
+                insertedIds.push(currentNextId);
+                currentNextId++;
+            }
+            root.appendChild(node);
+        }
+        return { success: true, insertedIds, nextId: currentNextId };
+    }
+    catch (e) {
+        return { success: false, insertedIds: [], nextId, error: e instanceof Error ? e.message : String(e) };
+    }
+}
+/**
+ * Replace element by ID with new content
+ */
+export function replaceById(document, targetId, content) {
+    const targetEl = findElementById(document, targetId);
+    if (!targetEl) {
+        return { success: false, error: `Element not found: ${targetId}` };
+    }
+    try {
+        const nodes = parseContent(document, content);
+        if (nodes.length === 0) {
+            return { success: false, error: "Replacement content is empty or invalid" };
+        }
+        const parent = targetEl.parentNode;
+        if (!parent) {
+            return { success: false, error: "Target element has no parent" };
+        }
+        // Preserve the original ID on the first replacement element
+        if (nodes[0].nodeType === 1) {
+            nodes[0].setAttribute(JICON_ID_ATTR, String(targetId));
+        }
+        // Insert new nodes before the target
+        for (const node of nodes) {
+            parent.insertBefore(node, targetEl);
+        }
+        // Remove the target
+        parent.removeChild(targetEl);
+        return { success: true };
+    }
+    catch (e) {
+        return { success: false, error: e instanceof Error ? e.message : String(e) };
+    }
+}
+/**
+ * Remove element by ID
+ */
+export function removeById(document, targetId) {
+    const targetEl = findElementById(document, targetId);
+    if (!targetEl) {
+        return { success: false, error: `Element not found: ${targetId}` };
+    }
+    const parent = targetEl.parentNode;
+    if (!parent) {
+        return { success: false, error: "Target element has no parent" };
+    }
+    parent.removeChild(targetEl);
+    return { success: true };
+}
 //# sourceMappingURL=operations.js.map