docs: add index.d.ts file

---
type: pre_commit_static_analysis_report
description: Results of running static analysis checks when committing changes.
report:
  - task: lint_filenames
    status: passed
  - task: lint_editorconfig
    status: passed
  - task: lint_markdown
    status: na
  - task: lint_package_json
    status: na
  - task: lint_repl_help
    status: na
  - task: lint_javascript_src
    status: na
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: na
  - task: lint_javascript_tests
    status: na
  - task: lint_javascript_benchmarks
    status: na
  - task: lint_python
    status: na
  - task: lint_r
    status: na
  - task: lint_c_src
    status: na
  - task: lint_c_examples
    status: na
  - task: lint_c_benchmarks
    status: na
  - task: lint_c_tests_fixtures
    status: na
  - task: lint_shell
    status: na
  - task: lint_typescript_declarations
    status: passed
  - task: lint_typescript_tests
    status: na
  - task: lint_license_headers
    status: passed
---

Author: aayush0325

lib/node_modules/@stdlib/lapack/base/dlatrs/docs/types/index.d.ts

@@ -0,0 +1,142 @@
+/*
+* @license Apache-2.0
+*
+* Copyright (c) 2025 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+// TypeScript Version: 4.1
+
+/// <reference types="@stdlib/types"/>
+
+import { Layout, DiagonalType, MatrixTriangle, TransposeOperation } from '@stdlib/types/blas';
+
+/**
+* Specifies whether `CNORM` contains the column norms or do they have to be calculated.
+*/
+type Normin = number;
+
+/**
+* Interface describing `dlatrs`.
+*/
+interface Routine {
+	/**
+	* Solves a triangular system of equations with the scale factor set to prevent overflow.
+	*
+	* @param order - storage layout
+	* @param uplo - specifies whether `A` is an upper or lower triangular matrix
+	* @param trans - specifies whether `A` should be transposed or not transposed
+	* @param diag - specifies whether `A` has a unit diagonal
+	* @param normin - specifies whether `CNORM` has been set or not
+	* @param N - number of rows/columns in `A`
+	* @param A - input matrix
+	* @param LDA - stride of the first dimension of `A` (a.k.a., leading dimension of the matrix `A`)
+	* @param X - input vector, specifies the right hand side vector of the equation
+	* @param CNORM - used to store the column norms
+	* @returns permuted matrix `A`
+	*
+	* @example
+	* var Float64Array = require( '@stdlib/array/float64' );
+	*
+	* var A = new Float64Array( [ 2.0, 1.0, -1.0, 0.0, 3.0, 2.0, 0.0, 0.0, 4.0 ] ); // => [ [ 2.0, 1.0, -1.0 ], [ 0.0, 3.0, 2.0 ], [ 0.0, 0.0, 4.0 ] ]
+	* var X = new Float64Array( [ 5.0, 10.0, 20,0 ] );
+	* var CNORM = new Float64Array( 3 );
+	*
+	* var scale = dlatrs( 'row-major', 'upper', 'no-transpose', 'non-unit', 'no', 3, A, 3, X, CNORM );
+	* // returns 1.0
+	* // X => <Float64Array>[ 5.0, 0.0, 5.0 ]
+	* // CNORM => <Float64Array>[ 0.0, 1.0, 3.0 ]
+	*/
+	( order: Layout, uplo: MatrixTriangle, trans: TransposeOperation, diag: DiagonalType, normin: Normin, N: number, A: Float64Array, LDA: number, X: Float64Array, CNORM: Float64Array ): number;
+
+	/**
+	* Solves a triangular system of equations with the scale factor set to prevent overflow using alternative indexing semantics.
+	*
+	* @param uplo - specifies whether `A` is an upper or lower triangular matrix
+	* @param trans - specifies whether `A` should be transposed or not transposed
+	* @param diag - specifies whether `A` has a unit diagonal
+	* @param normin - specifies whether `CNORM` has been set or not
+	* @param N - number of rows/columns in `A`
+	* @param A - input matrix
+	* @param strideA1 - stride of the first dimension of `A`
+	* @param strideA2 - stride of the second dimension of `A`
+	* @param offsetA - starting index for `A`
+	* @param X - input vector, specifies the right hand side vector of the equation
+	* @param strideX - stride length for `X`
+	* @param offsetX - starting index for `X`
+	* @param CNORM - used to store the column norms
+	* @param strideCNORM - stride length for `CNORM`
+	* @param offsetCNORM - starting index for `CNORM`
+	* @returns permuted matrix `A`
+	*
+	* @example
+	* var Float64Array = require( '@stdlib/array/float64' );
+	*
+	* var A = new Float64Array( [ 2.0, 1.0, -1.0, 0.0, 3.0, 2.0, 0.0, 0.0, 4.0 ] ); // => [ [ 2.0, 1.0, -1.0 ], [ 0.0, 3.0, 2.0 ], [ 0.0, 0.0, 4.0 ] ]
+	* var X = new Float64Array( [ 5.0, 10.0, 20,0 ] );
+	* var CNORM = new Float64Array( 3 );
+	*
+	* var scale = dlatrs.ndarray( 'upper', 'no-transpose', 'non-unit', 'no', 3, A, 3, 1, 0, X, 1, 0, CNORM, 1, 0 );
+	* // returns 1.0
+	* // X => <Float64Array>[ 5.0, 0.0, 5.0 ]
+	* // CNORM => <Float64Array>[ 0.0, 1.0, 3.0 ]
+	*/
+	ndarray( uplo: MatrixTriangle, trans: TransposeOperation, diag: DiagonalType, normin: Normin, N: number, A: Float64Array, strideA1: number, strideA2: number, offsetA: number, X: Float64Array, strideX: number, offsetX: number, CNORM: Float64Array, strideCNORM: number, offsetCNORM: number ): number;
+}
+
+/**
+* Solves a triangular system of equations with the scale factor set to prevent overflow.
+*
+* @param order - storage layout
+* @param uplo - specifies whether `A` is an upper or lower triangular matrix
+* @param trans - specifies whether `A` should be transposed or not transposed
+* @param diag - specifies whether `A` has a unit diagonal
+* @param normin - specifies whether `CNORM` has been set or not
+* @param N - number of rows/columns in `A`
+* @param A - input matrix
+* @param LDA - stride of the first dimension of `A` (a.k.a., leading dimension of the matrix `A`)
+* @param X - input vector, specifies the right hand side vector of the equation
+* @param CNORM - used to store the column norms
+* @returns permuted matrix `A`
+*
+* @example
+* var Float64Array = require( '@stdlib/array/float64' );
+*
+* var A = new Float64Array( [ 2.0, 1.0, -1.0, 0.0, 3.0, 2.0, 0.0, 0.0, 4.0 ] ); // => [ [ 2.0, 1.0, -1.0 ], [ 0.0, 3.0, 2.0 ], [ 0.0, 0.0, 4.0 ] ]
+* var X = new Float64Array( [ 5.0, 10.0, 20,0 ] );
+* var CNORM = new Float64Array( 3 );
+*
+* var scale = dlatrs( 'row-major', 'upper', 'no-transpose', 'non-unit', 'no', 3, A, 3, X, CNORM );
+* // returns 1.0
+* // X => <Float64Array>[ 5.0, 0.0, 5.0 ]
+* // CNORM => <Float64Array>[ 0.0, 1.0, 3.0 ]
+*
+* @example
+* var Float64Array = require( '@stdlib/array/float64' );
+*
+* var A = new Float64Array( [ 2.0, 1.0, -1.0, 0.0, 3.0, 2.0, 0.0, 0.0, 4.0 ] ); // => [ [ 2.0, 1.0, -1.0 ], [ 0.0, 3.0, 2.0 ], [ 0.0, 0.0, 4.0 ] ]
+* var X = new Float64Array( [ 5.0, 10.0, 20,0 ] );
+* var CNORM = new Float64Array( 3 );
+*
+* var scale = dlatrs.ndarray( 'upper', 'no-transpose', 'non-unit', 'no', 3, A, 3, 1, 0, X, 1, 0, CNORM, 1, 0 );
+* // returns 1.0
+* // X => <Float64Array>[ 5.0, 0.0, 5.0 ]
+* // CNORM => <Float64Array>[ 0.0, 1.0, 3.0 ]
+*/
+declare var dlatrs: Routine;
+
+
+// EXPORTS //
+
+export = dlatrs;