Azure / Azure/azure-sdk-tools

[js-api-parser] Refactor JS API view Parser - Phase 1

Open
#13,061 0 comments 0 reactions 1 assignee Claimed by @KarishmaGhiya View on GitHub
APIView Javascript needs-triage
Dominant language
C#
Stars
135
Forks
260
Avg merge
3d 2h
Merged PRs (30d)
130

Description

### Phase 1: Core Top-Level Items (P0)

**Goal**: Replace most common API patterns with semantic generators

1. **Class Generator** (`ApiItemKind.Class`)
- Access modifiers: `public`, `private`, `protected`
- Abstract classes
- Type parameters with constraints
- `extends` and `implements` clauses
- Handle members separately (they have their own generators)

2. **Interface Generator** (`ApiItemKind.Interface`)
- Type parameters with constraints
- `extends` clauses
- Handle members separately

3. **Method/MethodSignature Generators**
- Static vs instance
- Access modifiers
- Optional/rest parameters
- Overload handling (if needed)
- Async functions

**Testing**:
- Create test fixtures for each generator
- Unit tests with API model objects
- Integration tests comparing output with legacy approach

**Success Criteria**:
- All P0 generators implemented
- Test coverage > 90%
- Zero regressions on existing API JSON files

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.