[scripts] Add 'Used by' sections to API reference pages (#428)

* Add 'Used by' sections to API reference pages

Adds a reverse-reference index built from the API Extractor JSON output.
Every type that is used as a property type, return type, or parameter type
by another API member now gets a '#### Used by' section in its remarks.

The section groups callers by containing class and links to both the
class page and the specific member, helping readers understand the object
model and navigate between related pages.

Implementation details:
- buildUsedByIndex() reads json-preview/ExcelScript.api.json and
  OfficeScript.api.json to build a reverse map of typeUID -> callers
- analyzeMembers/analyzeMemberTypeReferences/analyzeExcerptTokens walk
  the API JSON extracting Reference tokens from property, return, and
  parameter type token ranges
- injectUsedBySection() filters self-references, deduplicates method
  overloads, and injects the section into each YAML item's remarks
- Enum fields are excluded (OPS does not support remarks on enum fields)
- URLs follow the /javascript/api/office-scripts/<pkg>/<class>#<anchor>
  pattern already used in this repo

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Fix namespace-level function URLs in 'Used by' sections

Namespace-level functions (e.g., OfficeScript.downloadFile,
OfficeScript.sendMail) live on the package page, not a class subpage.
When the classPath equals the package name, the correct URL is
/javascript/api/office-scripts/<pkg> rather than
/javascript/api/office-scripts/<pkg>/<pkg>.

Added isNamespace check to both convertUidToUrl() and the classUrl
calculation in generateUsedBySection().

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Rerun GenerateDocs

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: AlexJerabek

docs/docs-ref-autogen/excelscript/excelscript.aggregationfunction.yml

@@ -4,12 +4,24 @@ uid: ExcelScript!ExcelScript.AggregationFunction:enum
 package: ExcelScript!
 fullName: ExcelScript.AggregationFunction
 summary: Aggregation function for the `DataPivotHierarchy`<!-- -->.
-remarks: |-
+remarks: >-
 
 
+
+
+  #### Used by
+
+
+  -
+  [ExcelScript.DataPivotHierarchy](/javascript/api/office-scripts/excelscript/excelscript.datapivothierarchy):
+  [getSummarizeBy](/javascript/api/office-scripts/excelscript/excelscript.datapivothierarchy#excelscript-excelscript-datapivothierarchy-getsummarizeby-member(1)),
+  [setSummarizeBy](/javascript/api/office-scripts/excelscript/excelscript.datapivothierarchy#excelscript-excelscript-datapivothierarchy-setsummarizeby-member(1))
+
   #### Examples
 
+
   ```TypeScript
+
   /**
    * This script changes how the data in a PivotTable is aggregated.
    */
@@ -21,6 +33,7 @@ remarks: |-
     const dataHierarchy = pivotTable.getDataHierarchies()[0];
     dataHierarchy.setSummarizeBy(ExcelScript.AggregationFunction.average);
   }
+
   ```
 
 isPreview: false

docs/docs-ref-autogen/excelscript/excelscript.alloweditrange.yml

@@ -8,7 +8,14 @@ summary: >-
   with worksheet protection properties. When worksheet protection is enabled, an
   `AllowEditRange` object can be used to allow editing of a specific range,
   while maintaining protection on the rest of the worksheet.
-remarks: ''
+remarks: >-
+  #### Used by
+
+
+  -
+  [ExcelScript.WorksheetProtection](/javascript/api/office-scripts/excelscript/excelscript.worksheetprotection):
+  [getAllowEditRange](/javascript/api/office-scripts/excelscript/excelscript.worksheetprotection#excelscript-excelscript-worksheetprotection-getalloweditrange-member(1)),
+  [getAllowEditRanges](/javascript/api/office-scripts/excelscript/excelscript.worksheetprotection#excelscript-excelscript-worksheetprotection-getalloweditranges-member(1))
 
 isPreview: false
 isDeprecated: false

docs/docs-ref-autogen/excelscript/excelscript.alloweditrangeoptions.yml

@@ -6,12 +6,23 @@ fullName: ExcelScript.AllowEditRangeOptions
 summary: >-
   The interface used to construct optional fields of the `AllowEditRange`
   object.
-remarks: |-
+remarks: >-
 
 
+
+
+  #### Used by
+
+
+  -
+  [ExcelScript.WorksheetProtection](/javascript/api/office-scripts/excelscript/excelscript.worksheetprotection):
+  [addAllowEditRange](/javascript/api/office-scripts/excelscript/excelscript.worksheetprotection#excelscript-excelscript-worksheetprotection-addalloweditrange-member(1))
+
   #### Examples
 
+
   ```TypeScript
+
   /**
    * This script adds a password-protected, editable range
    * to an otherwise protected worksheet.
@@ -32,6 +43,7 @@ remarks: |-
       // Protect the worksheet.
       sheetProtection.protect();
   }
+
   ```
 
 isPreview: false

docs/docs-ref-autogen/excelscript/excelscript.application.yml

@@ -4,7 +4,13 @@ uid: ExcelScript!ExcelScript.Application:interface
 package: ExcelScript!
 fullName: ExcelScript.Application
 summary: Represents the Excel application that manages the workbook.
-remarks: ''
+remarks: >-
+  #### Used by
+
+
+  -
+  [ExcelScript.Workbook](/javascript/api/office-scripts/excelscript/excelscript.workbook):
+  [getApplication](/javascript/api/office-scripts/excelscript/excelscript.workbook#excelscript-excelscript-workbook-getapplication-member(1))
 
 isPreview: false
 isDeprecated: false

docs/docs-ref-autogen/excelscript/excelscript.arrowheadlength.yml

@@ -4,12 +4,26 @@ uid: ExcelScript!ExcelScript.ArrowheadLength:enum
 package: ExcelScript!
 fullName: ExcelScript.ArrowheadLength
 summary: ''
-remarks: |-
+remarks: >-
 
 
+
+
+  #### Used by
+
+
+  -
+  [ExcelScript.Line](/javascript/api/office-scripts/excelscript/excelscript.line):
+  [getBeginArrowheadLength](/javascript/api/office-scripts/excelscript/excelscript.line#excelscript-excelscript-line-getbeginarrowheadlength-member(1)),
+  [getEndArrowheadLength](/javascript/api/office-scripts/excelscript/excelscript.line#excelscript-excelscript-line-getendarrowheadlength-member(1)),
+  [setBeginArrowheadLength](/javascript/api/office-scripts/excelscript/excelscript.line#excelscript-excelscript-line-setbeginarrowheadlength-member(1)),
+  [setEndArrowheadLength](/javascript/api/office-scripts/excelscript/excelscript.line#excelscript-excelscript-line-setendarrowheadlength-member(1))
+
   #### Examples
 
+
   ```TypeScript
+
   /**
    * This script adds a line that goes from cell B2 to cell F4 on the current worksheet.
    */ 
@@ -34,6 +48,7 @@ remarks: |-
     line.setEndArrowheadStyle(ExcelScript.ArrowheadStyle.open);
     line.setEndArrowheadLength(ExcelScript.ArrowheadLength.long);
   }
+
   ```
 
 isPreview: false

docs/docs-ref-autogen/excelscript/excelscript.arrowheadstyle.yml

@@ -4,12 +4,26 @@ uid: ExcelScript!ExcelScript.ArrowheadStyle:enum
 package: ExcelScript!
 fullName: ExcelScript.ArrowheadStyle
 summary: ''
-remarks: |-
+remarks: >-
 
 
+
+
+  #### Used by
+
+
+  -
+  [ExcelScript.Line](/javascript/api/office-scripts/excelscript/excelscript.line):
+  [getBeginArrowheadStyle](/javascript/api/office-scripts/excelscript/excelscript.line#excelscript-excelscript-line-getbeginarrowheadstyle-member(1)),
+  [getEndArrowheadStyle](/javascript/api/office-scripts/excelscript/excelscript.line#excelscript-excelscript-line-getendarrowheadstyle-member(1)),
+  [setBeginArrowheadStyle](/javascript/api/office-scripts/excelscript/excelscript.line#excelscript-excelscript-line-setbeginarrowheadstyle-member(1)),
+  [setEndArrowheadStyle](/javascript/api/office-scripts/excelscript/excelscript.line#excelscript-excelscript-line-setendarrowheadstyle-member(1))
+
   #### Examples
 
+
   ```TypeScript
+
   /**
    * This script adds a line that goes from cell B2 to cell F4 on the current worksheet.
    */ 
@@ -33,6 +47,7 @@ remarks: |-
     const line = newShape.getLine();
     line.setEndArrowheadStyle(ExcelScript.ArrowheadStyle.open);
   }
+
   ```
 
 isPreview: false

docs/docs-ref-autogen/excelscript/excelscript.arrowheadwidth.yml

@@ -4,12 +4,26 @@ uid: ExcelScript!ExcelScript.ArrowheadWidth:enum
 package: ExcelScript!
 fullName: ExcelScript.ArrowheadWidth
 summary: ''
-remarks: |-
+remarks: >-
 
 
+
+
+  #### Used by
+
+
+  -
+  [ExcelScript.Line](/javascript/api/office-scripts/excelscript/excelscript.line):
+  [getBeginArrowheadWidth](/javascript/api/office-scripts/excelscript/excelscript.line#excelscript-excelscript-line-getbeginarrowheadwidth-member(1)),
+  [getEndArrowheadWidth](/javascript/api/office-scripts/excelscript/excelscript.line#excelscript-excelscript-line-getendarrowheadwidth-member(1)),
+  [setBeginArrowheadWidth](/javascript/api/office-scripts/excelscript/excelscript.line#excelscript-excelscript-line-setbeginarrowheadwidth-member(1)),
+  [setEndArrowheadWidth](/javascript/api/office-scripts/excelscript/excelscript.line#excelscript-excelscript-line-setendarrowheadwidth-member(1))
+
   #### Examples
 
+
   ```TypeScript
+
   /**
    * This script adds a line that goes from cell B2 to cell F4 on the current worksheet.
    */ 
@@ -34,6 +48,7 @@ remarks: |-
     line.setEndArrowheadStyle(ExcelScript.ArrowheadStyle.triangle);
     line.setEndArrowheadWidth(ExcelScript.ArrowheadWidth.wide);
   }
+
   ```
 
 isPreview: false

docs/docs-ref-autogen/excelscript/excelscript.autofilltype.yml

@@ -4,12 +4,23 @@ uid: ExcelScript!ExcelScript.AutoFillType:enum
 package: ExcelScript!
 fullName: ExcelScript.AutoFillType
 summary: The behavior types when AutoFill is used on a range in the workbook.
-remarks: |-
+remarks: >-
 
 
+
+
+  #### Used by
+
+
+  -
+  [ExcelScript.Range](/javascript/api/office-scripts/excelscript/excelscript.range):
+  [autoFill](/javascript/api/office-scripts/excelscript/excelscript.range#excelscript-excelscript-range-autofill-member(1))
+
   #### Examples
 
+
   ```TypeScript
+
   /**
    * This script uses the autofill feature to complete a table with days of the month.
    * See https://support.microsoft.com/office/74e31bdd-d993-45da-aa82-35a236c5b5db
@@ -25,6 +36,7 @@ remarks: |-
     // Autofill the connected range. C2:C3 are filled in with dates. C4:C54 are blank.
     dataRange.autoFill("C2:C54", ExcelScript.AutoFillType.fillDays);
   }
+
   ```
 
 isPreview: false

docs/docs-ref-autogen/excelscript/excelscript.autofilter.yml

@@ -6,12 +6,27 @@ fullName: ExcelScript.AutoFilter
 summary: >-
   Represents the `AutoFilter` object. AutoFilter turns the values in Excel
   column into specific filters based on the cell contents.
-remarks: |-
+remarks: >-
 
 
+
+
+  #### Used by
+
+
+  -
+  [ExcelScript.Table](/javascript/api/office-scripts/excelscript/excelscript.table):
+  [getAutoFilter](/javascript/api/office-scripts/excelscript/excelscript.table#excelscript-excelscript-table-getautofilter-member(1))
+
+  -
+  [ExcelScript.Worksheet](/javascript/api/office-scripts/excelscript/excelscript.worksheet):
+  [getAutoFilter](/javascript/api/office-scripts/excelscript/excelscript.worksheet#excelscript-excelscript-worksheet-getautofilter-member(1))
+
   #### Examples
 
+
   ```TypeScript
+
   /**
    * This script creates an autoFilter on the worksheet that filters out rows based on column values. 
    * The autoFilter filters to only include rows that have a value in column C in the lowest 10 values 
@@ -30,6 +45,7 @@ remarks: |-
       filterOn: ExcelScript.FilterOn.bottomItems
     });
   }
+
   ```
 
 isPreview: false

docs/docs-ref-autogen/excelscript/excelscript.basicdatavalidation.yml

@@ -4,12 +4,25 @@ uid: ExcelScript!ExcelScript.BasicDataValidation:interface
 package: ExcelScript!
 fullName: ExcelScript.BasicDataValidation
 summary: Represents the basic type data validation criteria.
-remarks: |-
+remarks: >-
 
 
+
+
+  #### Used by
+
+
+  -
+  [ExcelScript.DataValidationRule](/javascript/api/office-scripts/excelscript/excelscript.datavalidationrule):
+  [decimal](/javascript/api/office-scripts/excelscript/excelscript.datavalidationrule#excelscript-excelscript-datavalidationrule-decimal-member),
+  [textLength](/javascript/api/office-scripts/excelscript/excelscript.datavalidationrule#excelscript-excelscript-datavalidationrule-textlength-member),
+  [wholeNumber](/javascript/api/office-scripts/excelscript/excelscript.datavalidationrule#excelscript-excelscript-datavalidationrule-wholenumber-member)
+
   #### Examples
 
+
   ```TypeScript
+
   /**
    * This script creates a data validation rule for the range B1:B5.
    * All values in that range must be a positive number.
@@ -42,6 +55,7 @@ remarks: |-
     };
     rangeDataValidation.setErrorAlert(positiveNumberOnlyAlert);
   }
+
   ```
 
 isPreview: false