arxml-tree-domain

name	arxml-tree-domain
description	Modify ARXML parsing, tree providers, and hover navigation for this extension.
compatibility	Requires VS Code API types and SAX parser usage.

Use this skill for ARXML parsing, tree behavior, filtering/search, and navigation logic.

Shared conventions

• Follow AGENTS.md for coding style, TypeScript/lint rules, testing conventions, and shared engineering constraints.
• Keep this skill focused on domain-specific ARXML/tree guidance only.

Core files

• src/arxmlParser.ts: streaming SAX parsing into ArxmlNode tree.
• src/arxmlNode.ts: core node shape and equality.
• src/treeProvider.ts: tree provider, bookmarks, indexing, and navigation.
• src/integratedTreeProvider.ts: integrated tree with filter/view controls.
• src/optimizedTreeProvider.ts: optimized rendering/filtering path for large trees.
• src/crossFileSearchProvider.ts: cross-file search and cached lookup.
• src/hoverProvider.ts: hover detection and goto-link creation.
• src/viewBehavior.ts: extensible node presentation/service-summary contracts.
• src/viewBehaviorRegistry.ts: registration and lookup for view behaviors.
• src/cddViewBehavior.ts: CDD-specific behavior and diagnostic service summary.
• src/customViewStore.ts: custom view persistence and storage scope handling.
• src/customViewTreeProvider.ts: custom-view UI tree provider logic.
• src/searchViewProvider.ts: webview messaging for filter/search/history/saved filters.
• src/searchHistoryStore.ts: persistent search history.
• src/savedFiltersStore.ts: persistent saved filters.
• .claude/skills/arxml-tree-domain/references/custom-views.md: custom view JSON schema and examples.

Guidelines

• Follow AGENTS.md for design-first and minimal-change principles.
• Keep parsing streaming; avoid full DOM parsing.
• Preserve cross-file navigation by indexing open documents.
• Use ArxmlNode consistently and keep ranges accurate.
• Keep filter-mode behavior consistent: per-field (nameMode, arpathMode, elementMode) falls back to mode.
• Keep view-behavior extensions behind ViewBehavior/registry abstractions.
• Maintain workspace/global storage scope behavior for custom views and persisted filters.
• Handle errors with vscode.window.showErrorMessage(...).
• Avoid refactors when fixing a specific bug.

Custom view schema & examples

• See .claude/skills/arxml-tree-domain/references/custom-views.md for the JSON schema, field reference, and built-in examples.
• Custom views are stored per-workspace or globally based on arxmlTree.customViewStorageScope.

Indexing behavior

• ArxmlTreeProvider rebuilds an ARPATH index for quick lookup.
• findNodeWithArPath uses index, tree walk, then text search fallback.

Testing

• Add/update tests in:
  • src/test/extension.test.ts for parser/tree/bookmark/performance behavior.
  • src/test/crossFileSearchProvider.test.ts for workspace search behavior.
  • src/test/searchViewProvider.test.ts for webview message handling.
  • src/test/searchViewProvider.integration.test.ts for integration message flow.
• Use in-memory ARXML samples and createPositionResolver pattern for parser tests.