@angular/language-service 22.0.0-next.3 → 22.0.0-next.5

package/api.d.ts

@@ -76,6 +76,57 @@ export interface ApplyRefactoringResult extends Omit<ts.RefactorEditInfo, 'notAp
     errorMessage?: string;
     warningMessage?: string;
 }
+/**
+ * Angular-specific LSP SymbolKind values for template symbols.
+ * These are used for symbols that don't have a direct TypeScript ScriptElementKind mapping.
+ * Values match LSP SymbolKind enum: https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#symbolKind
+ */
+export declare enum AngularSymbolKind {
+    Namespace = 3,
+    Class = 5,
+    Array = 18,
+    Object = 19,
+    Struct = 23,
+    Event = 24
+}
+/**
+ * A document symbol representing an Angular template element.
+ * This uses TypeScript's NavigationTree structure so it can be merged with TS symbols.
+ */
+export interface TemplateDocumentSymbol {
+    /** Display name for the symbol */
+    text: string;
+    /** Kind of symbol (using TypeScript's ScriptElementKind for compatibility) */
+    kind: ts.ScriptElementKind;
+    /**
+     * Optional LSP SymbolKind override for Angular-specific symbol types.
+     * When set, this takes precedence over the default ScriptElementKind mapping.
+     */
+    lspKind?: AngularSymbolKind;
+    /** Span covering the entire symbol */
+    spans: ts.TextSpan[];
+    /** Span for just the name (used for selection) */
+    nameSpan?: ts.TextSpan;
+    /** Child symbols */
+    childItems?: TemplateDocumentSymbol[];
+    /**
+     * The name of the class this template belongs to.
+     * Only set for root-level symbols in TypeScript files with inline templates.
+     * Used to merge template symbols into the correct component class when
+     * multiple components exist in the same file.
+     */
+    className?: string;
+}
+/**
+ * Options for customizing document symbols behavior.
+ */
+export interface DocumentSymbolsOptions {
+    /**
+     * Show all implicit @for loop variables ($index, $count, $first, $last, $even, $odd).
+     * When false (default), only explicitly aliased variables like `let i = $index` are shown.
+     */
+    showImplicitForVariables?: boolean;
+}
 /**
  * Result for linked editing ranges containing the ranges and optional word pattern.
  */
@@ -324,6 +375,15 @@ export interface NgLanguageService extends ts.LanguageService {
      * @param config Optional configuration for which hints to show
      */
     getAngularInlayHints(fileName: string, span: ts.TextSpan, config?: InlayHintsConfig): AngularInlayHint[];
+    /**
+     * Gets document symbols for Angular templates, including control flow blocks,
+     * elements, components, template references, and @let declarations.
+     * Returns symbols in NavigationTree format for compatibility with TypeScript.
+     *
+     * @param fileName The file path to get template symbols for
+     * @param options Optional configuration for document symbols behavior
+     */
+    getTemplateDocumentSymbols(fileName: string, options?: DocumentSymbolsOptions): TemplateDocumentSymbol[];
     applyRefactoring(fileName: string, positionOrRange: number | ts.TextRange, refactorName: string, reportProgress: ApplyRefactoringProgressFn): Promise<ApplyRefactoringResult | undefined>;
     hasCodeFixesForErrorCode(errorCode: number): boolean;
     getTokenTypeFromClassification(classification: number): number | undefined;

package/api_bundle.js

@@ -19,9 +19,19 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // packages/language-service/api.ts
 var api_exports = {};
 __export(api_exports, {
+  AngularSymbolKind: () => AngularSymbolKind,
   isNgLanguageService: () => isNgLanguageService
 });
 module.exports = __toCommonJS(api_exports);
+var AngularSymbolKind = /* @__PURE__ */ ((AngularSymbolKind2) => {
+  AngularSymbolKind2[AngularSymbolKind2["Namespace"] = 3] = "Namespace";
+  AngularSymbolKind2[AngularSymbolKind2["Class"] = 5] = "Class";
+  AngularSymbolKind2[AngularSymbolKind2["Array"] = 18] = "Array";
+  AngularSymbolKind2[AngularSymbolKind2["Object"] = 19] = "Object";
+  AngularSymbolKind2[AngularSymbolKind2["Struct"] = 23] = "Struct";
+  AngularSymbolKind2[AngularSymbolKind2["Event"] = 24] = "Event";
+  return AngularSymbolKind2;
+})(AngularSymbolKind || {});
 function isNgLanguageService(ls) {
   return "getTcb" in ls;
 }

package/api_bundle.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["api.ts"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA8aO,SAAS,oBACd,IACyB;AACzB,SAAO,YAAY;AACrB;",
-  "names": []
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgGO,IAAK,oBAAL,kBAAKA,uBAAL;AACL,EAAAA,sCAAA,eAAY,KAAZ;AACA,EAAAA,sCAAA,WAAQ,KAAR;AACA,EAAAA,sCAAA,WAAQ,MAAR;AACA,EAAAA,sCAAA,YAAS,MAAT;AACA,EAAAA,sCAAA,YAAS,MAAT;AACA,EAAAA,sCAAA,WAAQ,MAAR;AANU,SAAAA;AAAA,GAAA;AAiZL,SAAS,oBACd,IACyB;AACzB,SAAO,YAAY;AACrB;",
+  "names": ["AngularSymbolKind"]
 }