arxml-tree-domain

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.