GeometryPerimeterService
katanakit-js / GeometryPerimeterService
Class: GeometryPerimeterService
Section titled “Class: GeometryPerimeterService”Defined in: core/services/geometry.service.ts:213
GeometryPerimeterService — pure perimeter calculations for geometric shapes. All methods are stateless — input → formatted string only.
Applies the Singleton pattern (one shared instance via
GeometryPerimeterService.getInstance), exposed publicly through the
GeometryUtils.perimeter facade. Every public method uses the use* prefix
per CONTRIBUTING.md.
Methods
Section titled “Methods”useCircle()
Section titled “useCircle()”useCircle(radius, options?): string;Defined in: core/services/geometry.service.ts:299
Calculates the perimeter (circumference) of a circle.
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
radius |
number |
The radius of the circle. |
options? |
{ digits?: number; locale?: string; unit?: string; } |
Optional formatting options. |
options.digits? |
number |
- |
options.locale? |
string |
- |
options.unit? |
string |
- |
Returns
Section titled “Returns”string
The formatted perimeter string.
Example
Section titled “Example”import { GeometryUtils } from "katanakit-js";
GeometryUtils.perimeter.useCircle(5); // "31.42"useEllipse()
Section titled “useEllipse()”useEllipse( semiMajor, semiMinor, options?): string;Defined in: core/services/geometry.service.ts:363
Calculates the perimeter of an ellipse using Ramanujan’s approximation II.
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
semiMajor |
number |
The semi-major axis length. |
semiMinor |
number |
The semi-minor axis length. |
options? |
{ digits?: number; locale?: string; unit?: string; } |
Optional formatting options. |
options.digits? |
number |
- |
options.locale? |
string |
- |
options.unit? |
string |
- |
Returns
Section titled “Returns”string
The formatted perimeter string.
Example
Section titled “Example”import { GeometryUtils } from "katanakit-js";
GeometryUtils.perimeter.useEllipse(5, 3); // "25.53"useHexagon()
Section titled “useHexagon()”useHexagon(side, options?): string;Defined in: core/services/geometry.service.ts:317
Calculates the perimeter of a regular hexagon.
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
side |
number |
The side length of the hexagon. |
options? |
{ digits?: number; locale?: string; unit?: string; } |
Optional formatting options. |
options.digits? |
number |
- |
options.locale? |
string |
- |
options.unit? |
string |
- |
Returns
Section titled “Returns”string
The formatted perimeter string.
Example
Section titled “Example”import { GeometryUtils } from "katanakit-js";
GeometryUtils.perimeter.useHexagon(3); // "18.00"useParallelogram()
Section titled “useParallelogram()”useParallelogram( side1, side2, options?): string;Defined in: core/services/geometry.service.ts:391
Calculates the perimeter of a parallelogram.
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
side1 |
number |
The length of the first side. |
side2 |
number |
The length of the second side. |
options? |
{ digits?: number; locale?: string; unit?: string; } |
Optional formatting options. |
options.digits? |
number |
- |
options.locale? |
string |
- |
options.unit? |
string |
- |
Returns
Section titled “Returns”string
The formatted perimeter string.
Example
Section titled “Example”import { GeometryUtils } from "katanakit-js";
GeometryUtils.perimeter.useParallelogram(5, 3); // "16.00"useRectangle()
Section titled “useRectangle()”useRectangle( width, height, options?): string;Defined in: core/services/geometry.service.ts:243
Calculates the perimeter of a rectangle.
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
width |
number |
The width of the rectangle. |
height |
number |
The height of the rectangle. |
options? |
{ digits?: number; locale?: string; unit?: string; } |
Optional formatting options. |
options.digits? |
number |
- |
options.locale? |
string |
- |
options.unit? |
string |
- |
Returns
Section titled “Returns”string
The formatted perimeter string.
Example
Section titled “Example”import { GeometryUtils } from "katanakit-js";
GeometryUtils.perimeter.useRectangle(5, 10); // "30.00"GeometryUtils.perimeter.useRectangle(5, 10, { unit: "m" }); // "30.00 m"useSquare()
Section titled “useSquare()”useSquare(side, options?): string;Defined in: core/services/geometry.service.ts:261
Calculates the perimeter of a square.
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
side |
number |
The side length of the square. |
options? |
{ digits?: number; locale?: string; unit?: string; } |
Optional formatting options. |
options.digits? |
number |
- |
options.locale? |
string |
- |
options.unit? |
string |
- |
Returns
Section titled “Returns”string
The formatted perimeter string.
Example
Section titled “Example”import { GeometryUtils } from "katanakit-js";
GeometryUtils.perimeter.useSquare(4); // "16.00"useTrapezoid()
Section titled “useTrapezoid()”useTrapezoid( side1, side2, side3, side4, options?): string;Defined in: core/services/geometry.service.ts:338
Calculates the perimeter of a trapezoid.
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
side1 |
number |
The length of the first side. |
side2 |
number |
The length of the second side. |
side3 |
number |
The length of the third side. |
side4 |
number |
The length of the fourth side. |
options? |
{ digits?: number; locale?: string; unit?: string; } |
Optional formatting options. |
options.digits? |
number |
- |
options.locale? |
string |
- |
options.unit? |
string |
- |
Returns
Section titled “Returns”string
The formatted perimeter string.
Example
Section titled “Example”import { GeometryUtils } from "katanakit-js";
GeometryUtils.perimeter.useTrapezoid(3, 5, 4, 4); // "16.00"useTriangle()
Section titled “useTriangle()”useTriangle( side1, side2, side3, options?): string;Defined in: core/services/geometry.service.ts:281
Calculates the perimeter of a triangle.
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
side1 |
number |
The length of the first side. |
side2 |
number |
The length of the second side. |
side3 |
number |
The length of the third side. |
options? |
{ digits?: number; locale?: string; unit?: string; } |
Optional formatting options. |
options.digits? |
number |
- |
options.locale? |
string |
- |
options.unit? |
string |
- |
Returns
Section titled “Returns”string
The formatted perimeter string.
Example
Section titled “Example”import { GeometryUtils } from "katanakit-js";
GeometryUtils.perimeter.useTriangle(3, 4, 5); // "12.00"getInstance()
Section titled “getInstance()”static getInstance(): GeometryPerimeterService;Defined in: core/services/geometry.service.ts:220
Returns the shared instance (Singleton).
Returns
Section titled “Returns”GeometryPerimeterService