@aotui/runtime 1.0.0

package/dist/engine/view/transformer/types.js

@@ -0,0 +1,16 @@
+/**
+ * Transformer Types
+ *
+ * 共享类型定义，供纯函数和兼容层使用
+ */
+/**
+ * 创建新的 TransformContext
+ */
+export function createTransformContext(appId) {
+    return {
+        indexMap: {},
+        currentAppId: appId || null,
+        currentViewId: null
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/engine/view/transformer/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/engine/view/transformer/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA6BH;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACjD,OAAO;QACH,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,KAAK,IAAI,IAAI;QAC3B,aAAa,EAAE,IAAI;KACtB,CAAC;AACN,CAAC"}

package/dist/engine/view/transformer/visitors/application.visitor.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Application Visitor
+ *
+ * Handles <application> tags or elements with data-app-id.
+ * Responsible for maintaining currentAppId context.
+ */
+import type { IElementVisitor } from './interface.js';
+export declare const applicationVisitor: IElementVisitor;

package/dist/engine/view/transformer/visitors/application.visitor.js

@@ -0,0 +1,37 @@
+/**
+ * Application Visitor
+ *
+ * Handles <application> tags or elements with data-app-id.
+ * Responsible for maintaining currentAppId context.
+ */
+export const applicationVisitor = {
+    name: 'application',
+    priority: 10,
+    matches(el, ctx) {
+        // [Refactor] Corresponds to: if (appId)
+        return el.hasAttribute('data-app-id');
+    },
+    transform(el, ctx, children) {
+        const appId = el.getAttribute('data-app-id');
+        const appName = el.getAttribute('name');
+        // Manage Context
+        const prevAppId = ctx.currentAppId;
+        ctx.currentAppId = appId;
+        // Clean up context on return
+        const restoreContext = () => {
+            ctx.currentAppId = prevAppId;
+        };
+        const isCollapsed = el.getAttribute('data-state') === 'collapsed';
+        const isClosed = el.getAttribute('data-state') === 'closed';
+        if (isCollapsed || isClosed) {
+            restoreContext();
+            return `\n<application id="${appId}" name="${appName || ''}" state="${isClosed ? 'closed' : 'collapsed'}" />\n`;
+        }
+        // Recursively process children
+        const childMarkup = children(el, ctx);
+        const childrenContent = childMarkup.join('\n');
+        restoreContext();
+        return `\n<application id="${appId}" name="${appName || ''}">\n${childrenContent}\n</application>\n`;
+    }
+};
+//# sourceMappingURL=application.visitor.js.map

package/dist/engine/view/transformer/visitors/application.visitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application.visitor.js","sourceRoot":"","sources":["../../../../../src/engine/view/transformer/visitors/application.visitor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,CAAC,MAAM,kBAAkB,GAAoB;IAC/C,IAAI,EAAE,aAAa;IACnB,QAAQ,EAAE,EAAE;IAEZ,OAAO,CAAC,EAAW,EAAE,GAA+B;QAChD,wCAAwC;QACxC,OAAO,EAAE,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;IAC1C,CAAC;IAED,SAAS,CACL,EAAW,EACX,GAAqB,EACrB,QAA2B;QAE3B,MAAM,KAAK,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,CAAE,CAAC;QAC9C,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAExC,iBAAiB;QACjB,MAAM,SAAS,GAAG,GAAG,CAAC,YAAY,CAAC;QACnC,GAAG,CAAC,YAAY,GAAG,KAAK,CAAC;QAEzB,6BAA6B;QAC7B,MAAM,cAAc,GAAG,GAAG,EAAE;YACxB,GAAG,CAAC,YAAY,GAAG,SAAS,CAAC;QACjC,CAAC,CAAC;QAEF,MAAM,WAAW,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC,KAAK,WAAW,CAAC;QAClE,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC,KAAK,QAAQ,CAAC;QAE5D,IAAI,WAAW,IAAI,QAAQ,EAAE,CAAC;YAC1B,cAAc,EAAE,CAAC;YACjB,OAAO,sBAAsB,KAAK,WAAW,OAAO,IAAI,EAAE,YAAY,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,QAAQ,CAAC;QACpH,CAAC;QAED,+BAA+B;QAC/B,MAAM,WAAW,GAAG,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACtC,MAAM,eAAe,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE/C,cAAc,EAAE,CAAC;QACjB,OAAO,sBAAsB,KAAK,WAAW,OAAO,IAAI,EAAE,OAAO,eAAe,oBAAoB,CAAC;IACzG,CAAC;CACJ,CAAC"}

package/dist/engine/view/transformer/visitors/html.visitor.d.ts

@@ -0,0 +1,8 @@
+/**
+ * HTML Visitor (Fallback)
+ *
+ * Handles generic HTML elements not matched by other visitors.
+ * Converts standard HTML tags to Markdown.
+ */
+import type { IElementVisitor } from './interface.js';
+export declare const htmlVisitor: IElementVisitor;

package/dist/engine/view/transformer/visitors/html.visitor.js

@@ -0,0 +1,161 @@
+/**
+ * HTML Visitor (Fallback)
+ *
+ * Handles generic HTML elements not matched by other visitors.
+ * Converts standard HTML tags to Markdown.
+ */
+/**
+ * Transform nested list with proper prefixes using recursive Visitor calls
+ *
+ * [RFC-FIX] Use traverse instead of textContent to preserve semantic information
+ */
+function transformNestedList(list, ctx, traverse) {
+    const items = [];
+    const isOrdered = list.tagName.toLowerCase() === 'ol';
+    const children = list.children;
+    for (let i = 0; i < children.length; i++) {
+        const child = children[i];
+        if (child.tagName.toLowerCase() === 'li') {
+            const prefix = isOrdered ? `${i + 1}. ` : '- ';
+            // [FIX] Use recursive traversal instead of textContent
+            const content = traverse(child, ctx);
+            items.push(prefix + content.trim());
+        }
+    }
+    return items;
+}
+/**
+ * Transform list item with proper indentation for nested lists
+ *
+ * [RFC-FIX] Use recursive Visitor Pattern for all child elements,
+ * ensuring Operation/ViewLink inside <li> are properly transformed.
+ */
+function transformListItem(li, prefix, ctx, traverse) {
+    const parts = [];
+    let mainContent = '';
+    // Process children of li
+    const childNodes = li.childNodes;
+    for (let i = 0; i < childNodes.length; i++) {
+        const node = childNodes[i];
+        if (node.nodeType === 3) { // Text node
+            mainContent += node.textContent?.trim() || '';
+        }
+        else if (node.nodeType === 1) { // Element node
+            const el = node;
+            const tagName = el.tagName.toLowerCase();
+            if (tagName === 'ul' || tagName === 'ol') {
+                // Nested list - process with indentation using recursive traversal
+                const nestedItems = transformNestedList(el, ctx, traverse);
+                parts.push(...nestedItems);
+            }
+            else {
+                // [RFC-FIX] Use recursive traversal for ALL other elements
+                // This allows Operation, ViewLink, and other semantic elements
+                // to be properly recognized by their respective Visitors
+                const childOutput = traverse(el, ctx);
+                mainContent += childOutput;
+            }
+        }
+    }
+    // Build result: main content with prefix, then nested items indented
+    let result = prefix + mainContent.trim();
+    if (parts.length > 0) {
+        result += '\n' + parts.map(p => '    ' + p).join('\n');
+    }
+    return result;
+}
+// ============ HTML Visitor ============
+export const htmlVisitor = {
+    name: 'html-fallback',
+    priority: 100, // Lowest priority
+    matches(el, ctx) {
+        return true;
+    },
+    transform(el, ctx, children, traverseElement) {
+        const tagName = el.tagName.toLowerCase();
+        // Skip specialized internal tags
+        if (tagName === 'param')
+            return '';
+        // Handle line breaks
+        if (tagName === 'br')
+            return '\n';
+        const childTexts = children(el, ctx);
+        // G. Handle standard HTML elements integration from pure.ts
+        if (/^h[1-6]$/.test(tagName)) {
+            const level = '#'.repeat(parseInt(tagName[1]));
+            return `\n${level} ${childTexts.join(' ')}\n`;
+        }
+        if (tagName === 'p') {
+            const content = childTexts.join(' ').trim();
+            return content ? `\n${content}\n` : '';
+        }
+        if (tagName === 'strong' || tagName === 'b') {
+            return `**${childTexts.join(' ')}**`;
+        }
+        if (tagName === 'em' || tagName === 'i') {
+            return `*${childTexts.join(' ')}*`;
+        }
+        if (tagName === 'code' && el.parentElement?.tagName.toLowerCase() !== 'pre') {
+            return `\`${childTexts.join('')}\``;
+        }
+        if (tagName === 'pre') {
+            const codeEl = el.querySelector('code');
+            const lang = codeEl?.getAttribute('class')?.replace('language-', '') || '';
+            const codeContent = codeEl ? (codeEl.textContent || '') : childTexts.join('\n');
+            return `\n\`\`\`${lang}\n${codeContent.trim()}\n\`\`\`\n`;
+        }
+        if (tagName === 'a') {
+            const href = el.getAttribute('href') || '';
+            const text = childTexts.join(' ').trim() || href;
+            return `[${text}](${href})`;
+        }
+        if (tagName === 'blockquote') {
+            const quoted = childTexts.join(' ').trim()
+                .split('\n')
+                .map(line => `> ${line}`)
+                .join('\n');
+            return `\n${quoted}\n`;
+        }
+        if (tagName === 'hr') {
+            return '\n---\n';
+        }
+        // Handle lists (ul, ol)
+        if (tagName === 'ul' || tagName === 'ol') {
+            const items = [];
+            const listChildren = el.children;
+            // [RFC-FIX] Use ElementTraverser for proper Visitor Pattern
+            // This enables semantic elements (Operation, ViewLink) inside lists
+            // to be properly recognized by their respective Visitors
+            const singleTraverse = traverseElement
+                ? traverseElement
+                : (childEl, childCtx) => children(childEl, childCtx).join(' '); // Fallback
+            let liIndex = 0;
+            for (let i = 0; i < listChildren.length; i++) {
+                const child = listChildren[i];
+                const childTag = child.tagName.toLowerCase();
+                if (childTag === 'li') {
+                    // Standard list item
+                    const prefix = tagName === 'ol' ? `${++liIndex}. ` : '- ';
+                    const liContent = transformListItem(child, prefix, ctx, singleTraverse);
+                    items.push(liContent);
+                }
+                else {
+                    // [RFC-FIX] Non-<li> children inside <ol>/<ul> (e.g., <button operation="...">)
+                    // Use ElementTraverser to apply full Visitor Chain
+                    const childOutput = singleTraverse(child, ctx);
+                    if (childOutput.trim()) {
+                        items.push(childOutput.trim());
+                    }
+                }
+            }
+            return '\n' + items.join('\n') + '\n';
+        }
+        // Handle orphan li (shouldn't happen normally)
+        if (tagName === 'li') {
+            return childTexts.join(' ');
+        }
+        // Default: Join children
+        return childTexts.join(' ');
+    }
+};
+//# sourceMappingURL=html.visitor.js.map

package/dist/engine/view/transformer/visitors/html.visitor.js.map

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

package/dist/engine/view/transformer/visitors/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Transformer Visitors Registry
+ *
+ * Exports the default set of visitors used by the Transformer.
+ * Visitors are executed in order of their priority.
+ */
+import type { IElementVisitor } from './interface.js';
+export declare const DEFAULT_VISITORS: IElementVisitor[];
+/**
+ * Sorts visitors by priority type
+ */
+export declare function sortVisitors(visitors: IElementVisitor[]): IElementVisitor[];

package/dist/engine/view/transformer/visitors/index.js

@@ -0,0 +1,27 @@
+/**
+ * Transformer Visitors Registry
+ *
+ * Exports the default set of visitors used by the Transformer.
+ * Visitors are executed in order of their priority.
+ */
+import { applicationVisitor } from './application.visitor.js';
+import { viewVisitor } from './view.visitor.js';
+import { viewLinkVisitor } from './view-link.visitor.js';
+import { operationVisitor } from './operation.visitor.js';
+import { htmlVisitor } from './html.visitor.js';
+// Default visitors sorted by priority
+// Default visitors sorted by priority
+export const DEFAULT_VISITORS = sortVisitors([
+    applicationVisitor,
+    viewVisitor,
+    viewLinkVisitor,
+    operationVisitor,
+    htmlVisitor
+]);
+/**
+ * Sorts visitors by priority type
+ */
+export function sortVisitors(visitors) {
+    return [...visitors].sort((a, b) => a.priority - b.priority);
+}
+//# sourceMappingURL=index.js.map

package/dist/engine/view/transformer/visitors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/engine/view/transformer/visitors/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,sCAAsC;AACtC,sCAAsC;AACtC,MAAM,CAAC,MAAM,gBAAgB,GAAsB,YAAY,CAAC;IAC5D,kBAAkB;IAClB,WAAW;IACX,eAAe;IACf,gBAAgB;IAChB,WAAW;CACd,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAA2B;IACpD,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;AACjE,CAAC"}

package/dist/engine/view/transformer/visitors/interface.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Element Visitor Interface
+ *
+ * Each Visitor is responsible for identifying and processing a specific type of DOM element.
+ * Visitors should be stateless pure functions.
+ */
+import type { TransformContext } from '../types.js';
+export interface IElementVisitor {
+    /**
+     * Visitor name (for debugging and logging)
+     */
+    readonly name: string;
+    /**
+     * Processing priority
+     *
+     * Lower numbers execute earlier. A rule of thumb:
+     * - 0-30: Structural (Application, View, ViewLink)
+     * - 30-60: Semantic (Operation)
+     * - 60-99: Reserved for extensions
+     * - 100+: General HTML fallback
+     */
+    readonly priority: number;
+    /**
+     * Determines if this visitor should handle the element
+     */
+    matches(el: Element, ctx: Readonly<TransformContext>): boolean;
+    /**
+     * Executes the transformation
+     *
+     * @param el - The current element
+     * @param ctx - Transformation context (can modify indexMap)
+     * @param children - Function to traverse child nodes
+     * @param traverseElement - Function to traverse a single element with full Visitor Chain
+     * @returns TUI Markup string
+     */
+    transform(el: Element, ctx: TransformContext, children: ChildrenTraverser, traverseElement?: ElementTraverser): string;
+}
+/**
+ * Child node traverser type
+ *
+ * Used by Visitors to recursively process child nodes of an element.
+ * This does NOT apply Visitor matching to the element itself.
+ */
+export type ChildrenTraverser = (el: Element, ctx: TransformContext) => string[];
+/**
+ * Element traverser type
+ *
+ * Used by Visitors to recursively process a single element with full Visitor Chain.
+ * This DOES apply Visitor matching, allowing Operation/ViewLink/etc to be recognized.
+ *
+ * [RFC-FIX] Added to support semantic elements inside List items.
+ */
+export type ElementTraverser = (el: Element, ctx: TransformContext) => string;

package/dist/engine/view/transformer/visitors/interface.js

@@ -0,0 +1,8 @@
+/**
+ * Element Visitor Interface
+ *
+ * Each Visitor is responsible for identifying and processing a specific type of DOM element.
+ * Visitors should be stateless pure functions.
+ */
+export {};
+//# sourceMappingURL=interface.js.map

package/dist/engine/view/transformer/visitors/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../../../../src/engine/view/transformer/visitors/interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/engine/view/transformer/visitors/operation.visitor.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Operation Visitor
+ *
+ * Handles <operation> or data-operation elements.
+ * Parses parameter definitions, types, and constraints.
+ * Populates IndexMap with detailed operation signatures.
+ */
+import type { IElementVisitor } from './interface.js';
+export declare const operationVisitor: IElementVisitor;

package/dist/engine/view/transformer/visitors/operation.visitor.js

@@ -0,0 +1,122 @@
+/**
+ * Operation Visitor
+ *
+ * Handles <operation> or data-operation elements.
+ * Parses parameter definitions, types, and constraints.
+ * Populates IndexMap with detailed operation signatures.
+ */
+export const operationVisitor = {
+    name: 'operation',
+    priority: 50,
+    matches(el, ctx) {
+        // [Reference] if (operationId)
+        const operationId = el.getAttribute('data-operation') || el.getAttribute('operation');
+        return !!operationId;
+    },
+    transform(el, ctx, children) {
+        const operationId = (el.getAttribute('data-operation') || el.getAttribute('operation'));
+        const operationDesc = el.getAttribute('data-operation-desc') || el.getAttribute('desc');
+        // Extract display text (excluding <param> tags)
+        const displayText = Array.from(el.childNodes)
+            .filter((child) => {
+            if (child.nodeType === 3)
+                return true; // Text node
+            if (child.nodeType === 1 && child.tagName.toLowerCase() === 'param')
+                return false;
+            return true;
+        })
+            .map((child) => {
+            if (child.nodeType === 3)
+                return child.data.trim();
+            return '';
+        })
+            .filter(Boolean)
+            .join(' ')
+            .trim() || operationId;
+        let opOutput = `- [${displayText}](tool:${operationId})\n`;
+        if (operationDesc) {
+            opOutput += `    - Desc: ${operationDesc}\n`;
+        }
+        // Parse Parameters
+        const params = Array.from(el.querySelectorAll('param'));
+        const paramDefs = [];
+        if (params.length > 0) {
+            opOutput += `    - Parameters:\n`;
+            params.forEach((p) => {
+                const name = p.getAttribute('name') || 'param';
+                const type = p.getAttribute('type') || 'string';
+                const required = p.getAttribute('required') === 'true';
+                const desc = p.getAttribute('desc') || undefined;
+                // Extended attributes
+                const itemType = p.getAttribute('item-type') || undefined;
+                const optionsStr = p.getAttribute('options') || undefined;
+                const defaultVal = p.getAttribute('default') || undefined;
+                // Constraints
+                const minLength = p.getAttribute('min-length');
+                const maxLength = p.getAttribute('max-length');
+                const pattern = p.getAttribute('pattern');
+                const min = p.getAttribute('min');
+                const max = p.getAttribute('max');
+                // Build type description string
+                let typeDesc = type;
+                if (type === 'array' && itemType) {
+                    typeDesc = `array<${itemType}>`;
+                }
+                else if (type === 'enum' && optionsStr) {
+                    typeDesc = `enum(${optionsStr.split(',').join(' | ')})`;
+                }
+                // Output Format
+                opOutput += `        - ${name}: ${typeDesc}${required ? ' (required)' : ''}`;
+                if (desc) {
+                    opOutput += ` - ${desc}`;
+                }
+                opOutput += '\n';
+                // Output Constraints
+                const constraints = {};
+                if (minLength) {
+                    constraints.minLength = parseInt(minLength);
+                    opOutput += `            - min length: ${minLength}\n`;
+                }
+                if (maxLength) {
+                    constraints.maxLength = parseInt(maxLength);
+                    opOutput += `            - max length: ${maxLength}\n`;
+                }
+                if (pattern) {
+                    constraints.pattern = pattern;
+                    opOutput += `            - pattern: /${pattern}/\n`;
+                }
+                if (min) {
+                    constraints.min = parseFloat(min);
+                    opOutput += `            - min value: ${min}\n`;
+                }
+                if (max) {
+                    constraints.max = parseFloat(max);
+                    opOutput += `            - max value: ${max}\n`;
+                }
+                if (defaultVal !== undefined) {
+                    opOutput += `            - default: ${defaultVal}\n`;
+                }
+                paramDefs.push({
+                    name,
+                    type,
+                    required,
+                    description: desc,
+                    itemType,
+                    options: optionsStr ? optionsStr.split(',') : undefined,
+                    constraints: Object.keys(constraints).length > 0 ? constraints : undefined,
+                    default: defaultVal
+                });
+            });
+        }
+        // Register in IndexMap (if context valid)
+        if (ctx.currentAppId && ctx.currentViewId) {
+            const operationPath = `tool:${ctx.currentAppId}.${ctx.currentViewId}.${operationId}`;
+            ctx.indexMap[operationPath] = {
+                description: operationDesc || undefined,
+                params: paramDefs
+            };
+        }
+        return opOutput;
+    }
+};
+//# sourceMappingURL=operation.visitor.js.map

package/dist/engine/view/transformer/visitors/operation.visitor.js.map

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

package/dist/engine/view/transformer/visitors/view-link.visitor.d.ts

@@ -0,0 +1,15 @@
+/**
+ * View Link Visitor
+ *
+ * [RFC-006] Updated to support new ViewLink format:
+ * - data-link-id: LinkID for V2 mount API
+ * - data-unique-id: Business key for cross-snapshot matching
+ * - data-view-type: View type name
+ * - data-bound-view: Already mounted ViewID (if any)
+ *
+ * Output format:
+ * - V2: [content](mount:parent_view:link_id) - for Agent to mount via link
+ * - Already mounted: [content](view:viewId) - direct navigation
+ */
+import type { IElementVisitor } from './interface.js';
+export declare const viewLinkVisitor: IElementVisitor;

package/dist/engine/view/transformer/visitors/view-link.visitor.js

@@ -0,0 +1,98 @@
+/**
+ * View Link Visitor
+ *
+ * [RFC-006] Updated to support new ViewLink format:
+ * - data-link-id: LinkID for V2 mount API
+ * - data-unique-id: Business key for cross-snapshot matching
+ * - data-view-type: View type name
+ * - data-bound-view: Already mounted ViewID (if any)
+ *
+ * Output format:
+ * - V2: [content](mount:parent_view:link_id) - for Agent to mount via link
+ * - Already mounted: [content](view:viewId) - direct navigation
+ */
+export const viewLinkVisitor = {
+    name: 'view-link',
+    priority: 30,
+    matches(el, ctx) {
+        // [RFC-006] Match new data-link-id format (highest priority)
+        if (el.hasAttribute('data-link-id')) {
+            return true;
+        }
+        // Legacy: data-view-link attribute
+        if (el.hasAttribute('data-view-link') && el.getAttribute('data-view-link') !== '') {
+            return true;
+        }
+        // Legacy: view-target
+        const viewTargetId = el.getAttribute('data-view-target-id');
+        const viewTarget = el.getAttribute('view-target');
+        return !!(viewTargetId || viewTarget);
+    },
+    transform(el, ctx, children) {
+        const childTexts = children(el, ctx);
+        const content = childTexts.join(' ').trim() || 'View';
+        // [RFC-006] Handle new ViewLink format with data-link-id
+        const linkId = el.getAttribute('data-link-id');
+        if (linkId) {
+            const boundViewId = el.getAttribute('data-bound-view');
+            const viewType = el.getAttribute('data-view-type') || 'View';
+            const description = el.getAttribute('data-view-description');
+            // If already mounted, output link with ViewID in title
+            // Format: [Content](link:LinkID "Mounted: ViewID")
+            // This preserves the LinkID for context while showing the ViewID
+            if (boundViewId && boundViewId !== '') {
+                let output = `[${content}](link:${linkId} "Mounted: ${boundViewId}")`;
+                if (description) {
+                    output += ` - ${description}`;
+                }
+                return output + '\n';
+            }
+            // Not mounted: output mount link with V2 format
+            // Agent will call: mount(link_id=linkId)
+            let output = `[${content}](link:${linkId})`;
+            if (description) {
+                output += ` - ${description}`;
+            }
+            return output + '\n';
+        }
+        // Legacy: data-view-link format
+        const dataViewLink = el.getAttribute('data-view-link');
+        if (dataViewLink && dataViewLink !== '') {
+            const linkDesc = el.getAttribute('data-view-description');
+            let linkOutput = `[${content}](view:${dataViewLink})`;
+            if (linkDesc) {
+                linkOutput += ` - ${linkDesc}`;
+            }
+            return linkOutput + '\n';
+        }
+        // Legacy: view-target format
+        const viewTargetId = el.getAttribute('data-view-target-id');
+        const viewTarget = el.getAttribute('view-target');
+        const viewLinkName = el.getAttribute('view');
+        const viewParams = el.getAttribute('view-params');
+        const targetId = viewTargetId || viewTarget;
+        const legacyContent = content || viewLinkName || viewTarget || 'View';
+        const desc = el.getAttribute('desc');
+        let targetUrl = `view:${targetId}`;
+        if (viewParams) {
+            try {
+                const paramsObj = JSON.parse(viewParams);
+                const queryParts = Object.entries(paramsObj)
+                    .map(([key, value]) => `${key}=${encodeURIComponent(String(value))}`)
+                    .join('&');
+                if (queryParts) {
+                    targetUrl += `?${queryParts}`;
+                }
+            }
+            catch {
+                // Invalid JSON, ignore params
+            }
+        }
+        let linkOutput = `- [${legacyContent}](${targetUrl})\n`;
+        if (desc) {
+            linkOutput += `    - Description: ${desc}\n`;
+        }
+        return linkOutput;
+    }
+};
+//# sourceMappingURL=view-link.visitor.js.map

package/dist/engine/view/transformer/visitors/view-link.visitor.js.map

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

package/dist/engine/view/transformer/visitors/view.visitor.d.ts

@@ -0,0 +1,8 @@
+/**
+ * View Visitor
+ *
+ * Handles <view> definition elements (view="..." or data-is-view).
+ * Responsible for maintaining currentViewId context.
+ */
+import type { IElementVisitor } from './interface.js';
+export declare const viewVisitor: IElementVisitor;