@theerapat-s28/ts-structural-eng-tools 1.0.1 → 1.2.0

package/README.md

@@ -40,10 +40,11 @@ src/
 ├── rc/                   # Reinforced concrete design
 │   ├── index.ts          # Module exports
 │   ├── general.ts        # Concrete properties (beta1, Ec, unit conversion)
-│   └── rc-beam-design.ts # Beam moment capacity (singly/doubly reinforced)
+│   └── rc-beam-design.ts # Beam moment capacity (singly/doubly reinforced) and shear capacity (Vc, Vs, stirrup requirement)
 ├── strengthening/        # Strengthening methods
 │   ├── index.ts
-│   └── rc-beam-steel-plate-jacketing.ts
+│   ├── rc-beam-steel-plate-jacketing.ts   # Moment capacity before/after plate jacketing
+│   └── rc-beam-plate-interface-bolts.ts  # Interface shear flow and required interface bolts
 ├── core/                 # Shared infrastructure
 │   ├── index.ts
 │   ├── constants/        # RC design constants (ACI 318)
@@ -57,6 +58,7 @@ examples/
 └── basic-usage.ts        # Example usage of the library
 tests/
 ├── rc/                   # Tests for RC module
+├── strengthening/        # Tests for strengthening module
 └── utils/                # Tests for utilities
 ```
 
@@ -81,10 +83,18 @@ For runtime resolution, `tsconfig-paths` is registered in the `dev` script.
 ### RC Beam Design
 
 - **`rectBeamMomentCapacity(section)`** — Computes φMn for a rectangular RC beam (singly or doubly reinforced). Returns `phiMn` in kN·m with calculation details and ACI 318-19 warnings.
+- **`concreteShearCapacity(section)`** — Computes φVc, the concrete contribution to shear capacity (ACI 318-19, 22.5.5.1).
+- **`stirrupShearCapacity(section)`** — Computes φVs, the stirrup contribution to shear capacity (ACI 318-19, 22.5.10.5.3).
+- **`checkStirrupRequirement(input)`** — Determines whether stirrups are required, and the required Av/s ratio and max spacing (ACI 318-19, 9.6.3.1, 9.6.3.3, 9.7.6.2.2).
 
 ### Strengthening
 
-- **`calculateSteelJacketedBeamMomentCapacity(section, jacketedProperties)`** — Computes φMn for a beam strengthened with steel plate jacketing.
+- **`calculateSteelJacketedBeamMomentCapacity(section, jacketedProperties)`** — Computes φMn for a beam strengthened with steel plate jacketing, as a `before` / `after` pair.
+- **`plateInterfaceShearFlow(input)`** — Computes the shear flow `q = V·Q/I` (N/mm) to transfer across each concrete-to-plate interface, from a cracked (default) or uncracked elastic transformed section. Returns a per-plate `top` / `bottom` result, `null` where a plate is absent.
+- **`boltShearCapacity(bolt)`** — Computes φVsa for one anchor bolt from the steel strength (ACI 318-19, 17.7.1.2b, φ per Table 17.5.3). Concrete breakout and pryout are not evaluated and must be checked separately.
+- **`plateInterfaceBoltRequirement(input)`** — Computes the required bolt pitch and count at each interface, taking the larger of the shear-flow requirement (`s = n·φVbolt / q`) and the count needed to develop the full plate yield force, and reports which one governs.
+
+Both plates are independently optional: a plate counts as present only when its width and thickness are both positive, so the same functions cover a bottom-only jacket and a top-and-bottom jacket. Use `hasTopPlate(props)` / `hasBottomPlate(props)` to test for presence.
 
 ### General Utilities
 

package/dist/core/constants/rc.constant.d.ts

@@ -1,2 +1,25 @@
 export declare const FLEXURAL_STRENGTH_REDUCTION_FACTOR = 0.9;
 export declare const CONCRETE_ULTIMATE_STRAIN = 0.003;
+export declare const DEFAULT_BEAM_COVER = 40;
+export declare const DEFAULT_STIRRUP_DIAMETER = 10;
+export declare const DEFAULT_MAX_AGGREGATE_SIZE = 20;
+export declare const MIN_BAR_CLEAR_SPACING = 25;
+export declare const AGGREGATE_SPACING_FACTOR: number;
+export declare const MIN_LAYER_CLEAR_SPACING = 25;
+export declare const SHEAR_STRENGTH_REDUCTION_FACTOR = 0.75;
+export declare const CONCRETE_SHEAR_VC_COEFFICIENT = 0.17;
+export declare const SQRT_FC_SHEAR_LIMIT = 8.3;
+export declare const MAX_VS_COEFFICIENT = 0.66;
+export declare const VS_SPACING_THRESHOLD_COEFFICIENT = 0.33;
+export declare const MAX_STIRRUP_SPACING_LOW_VS = 600;
+export declare const MAX_STIRRUP_SPACING_LOW_VS_DEPTH_FACTOR = 0.5;
+export declare const MAX_STIRRUP_SPACING_HIGH_VS = 300;
+export declare const MAX_STIRRUP_SPACING_HIGH_VS_DEPTH_FACTOR = 0.25;
+export declare const MIN_AV_SQRT_FC_COEFFICIENT = 0.062;
+export declare const MIN_AV_ABSOLUTE_COEFFICIENT = 0.35;
+export declare const ANCHOR_SHEAR_STRENGTH_REDUCTION_FACTOR = 0.65;
+export declare const ANCHOR_STEEL_SHEAR_COEFFICIENT = 0.6;
+export declare const ANCHOR_FUTA_FYA_FACTOR = 1.9;
+export declare const MAX_ANCHOR_FUTA = 860;
+export declare const MIN_ANCHOR_SPACING_DIAMETER_FACTOR = 4;
+export declare const MAX_PLATE_BOLT_SPACING = 300;

package/dist/core/constants/rc.constant.js

@@ -1,6 +1,47 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONCRETE_ULTIMATE_STRAIN = exports.FLEXURAL_STRENGTH_REDUCTION_FACTOR = void 0;
+exports.MAX_PLATE_BOLT_SPACING = exports.MIN_ANCHOR_SPACING_DIAMETER_FACTOR = exports.MAX_ANCHOR_FUTA = exports.ANCHOR_FUTA_FYA_FACTOR = exports.ANCHOR_STEEL_SHEAR_COEFFICIENT = exports.ANCHOR_SHEAR_STRENGTH_REDUCTION_FACTOR = exports.MIN_AV_ABSOLUTE_COEFFICIENT = exports.MIN_AV_SQRT_FC_COEFFICIENT = exports.MAX_STIRRUP_SPACING_HIGH_VS_DEPTH_FACTOR = exports.MAX_STIRRUP_SPACING_HIGH_VS = exports.MAX_STIRRUP_SPACING_LOW_VS_DEPTH_FACTOR = exports.MAX_STIRRUP_SPACING_LOW_VS = exports.VS_SPACING_THRESHOLD_COEFFICIENT = exports.MAX_VS_COEFFICIENT = exports.SQRT_FC_SHEAR_LIMIT = exports.CONCRETE_SHEAR_VC_COEFFICIENT = exports.SHEAR_STRENGTH_REDUCTION_FACTOR = exports.MIN_LAYER_CLEAR_SPACING = exports.AGGREGATE_SPACING_FACTOR = exports.MIN_BAR_CLEAR_SPACING = exports.DEFAULT_MAX_AGGREGATE_SIZE = exports.DEFAULT_STIRRUP_DIAMETER = exports.DEFAULT_BEAM_COVER = exports.CONCRETE_ULTIMATE_STRAIN = exports.FLEXURAL_STRENGTH_REDUCTION_FACTOR = void 0;
 exports.FLEXURAL_STRENGTH_REDUCTION_FACTOR = 0.9;
 exports.CONCRETE_ULTIMATE_STRAIN = 0.003;
+// ACI 318-19 Table 20.6.1.3.1: cast-in-place beams, not exposed to weather or in contact with ground
+exports.DEFAULT_BEAM_COVER = 40; // mm, clear cover to stirrup
+exports.DEFAULT_STIRRUP_DIAMETER = 10; // mm
+exports.DEFAULT_MAX_AGGREGATE_SIZE = 20; // mm, nominal max aggregate size
+// ACI 318-19 25.2.1: min clear spacing between parallel bars in a layer
+exports.MIN_BAR_CLEAR_SPACING = 25; // mm
+exports.AGGREGATE_SPACING_FACTOR = 4 / 3;
+// ACI 318-19 25.2.2: min clear distance between layers
+exports.MIN_LAYER_CLEAR_SPACING = 25; // mm
+// ACI 318-19 21.2.1: strength reduction factor for shear
+exports.SHEAR_STRENGTH_REDUCTION_FACTOR = 0.75;
+// ACI 318-19 22.5.5.1, Table 22.5.5.1(a): Vc = 0.17 * lambda * sqrt(fc') * bw * d
+exports.CONCRETE_SHEAR_VC_COEFFICIENT = 0.17;
+// ACI 318-19 22.5.3.1: sqrt(fc') used to compute Vc shall not exceed this limit
+// unless minimum shear reinforcement per 9.6.3.3 is provided
+exports.SQRT_FC_SHEAR_LIMIT = 8.3; // MPa
+// ACI 318-19 22.5.1.2: Vs shall not exceed 0.66 * sqrt(fc') * bw * d
+exports.MAX_VS_COEFFICIENT = 0.66;
+// ACI 318-19 9.7.6.2.2: spacing threshold at which the tighter max-spacing limit applies
+exports.VS_SPACING_THRESHOLD_COEFFICIENT = 0.33; // * sqrt(fc') * bw * d
+// ACI 318-19 9.7.6.2.2: max stirrup spacing, Vs <= 0.33 * sqrt(fc') * bw * d
+exports.MAX_STIRRUP_SPACING_LOW_VS = 600; // mm
+exports.MAX_STIRRUP_SPACING_LOW_VS_DEPTH_FACTOR = 0.5; // * d
+// ACI 318-19 9.7.6.2.2: max stirrup spacing, Vs > 0.33 * sqrt(fc') * bw * d
+exports.MAX_STIRRUP_SPACING_HIGH_VS = 300; // mm
+exports.MAX_STIRRUP_SPACING_HIGH_VS_DEPTH_FACTOR = 0.25; // * d
+// ACI 318-19 9.6.3.3: Av,min = max(0.062 * sqrt(fc') * bw * s / fyt, 0.35 * bw * s / fyt)
+exports.MIN_AV_SQRT_FC_COEFFICIENT = 0.062;
+exports.MIN_AV_ABSOLUTE_COEFFICIENT = 0.35;
+// ACI 318-19 Table 17.5.3: strength reduction factor for anchor steel in shear
+exports.ANCHOR_SHEAR_STRENGTH_REDUCTION_FACTOR = 0.65;
+// ACI 318-19 17.7.1.2b: Vsa = 0.6 * Ase,V * futa
+exports.ANCHOR_STEEL_SHEAR_COEFFICIENT = 0.6;
+// ACI 318-19 17.6.1.2: futa shall not exceed min(1.9 * fya, 860 MPa)
+exports.ANCHOR_FUTA_FYA_FACTOR = 1.9;
+exports.MAX_ANCHOR_FUTA = 860; // MPa
+// ACI 318-19 17.9.2: min center-to-center spacing of cast-in anchors = 4 * da
+exports.MIN_ANCHOR_SPACING_DIAMETER_FACTOR = 4;
+// Practical detailing limit on bolt pitch along a bonded strengthening plate,
+// so the plate is restrained against local buckling / peeling between fasteners
+exports.MAX_PLATE_BOLT_SPACING = 300; // mm
 //# sourceMappingURL=rc.constant.js.map

package/dist/core/constants/rc.constant.js.map

@@ -1 +1 @@
-{"version":3,"file":"rc.constant.js","sourceRoot":"","sources":["../../../src/core/constants/rc.constant.ts"],"names":[],"mappings":";;;AAAa,QAAA,kCAAkC,GAAG,GAAG,CAAC;AACzC,QAAA,wBAAwB,GAAG,KAAK,CAAC"}
+{"version":3,"file":"rc.constant.js","sourceRoot":"","sources":["../../../src/core/constants/rc.constant.ts"],"names":[],"mappings":";;;AAAa,QAAA,kCAAkC,GAAG,GAAG,CAAC;AACzC,QAAA,wBAAwB,GAAG,KAAK,CAAC;AAE9C,qGAAqG;AACxF,QAAA,kBAAkB,GAAG,EAAE,CAAC,CAAC,6BAA6B;AACtD,QAAA,wBAAwB,GAAG,EAAE,CAAC,CAAC,KAAK;AACpC,QAAA,0BAA0B,GAAG,EAAE,CAAC,CAAC,iCAAiC;AAE/E,wEAAwE;AAC3D,QAAA,qBAAqB,GAAG,EAAE,CAAC,CAAC,KAAK;AACjC,QAAA,wBAAwB,GAAG,CAAC,GAAG,CAAC,CAAC;AAE9C,uDAAuD;AAC1C,QAAA,uBAAuB,GAAG,EAAE,CAAC,CAAC,KAAK;AAEhD,yDAAyD;AAC5C,QAAA,+BAA+B,GAAG,IAAI,CAAC;AAEpD,kFAAkF;AACrE,QAAA,6BAA6B,GAAG,IAAI,CAAC;AAElD,gFAAgF;AAChF,6DAA6D;AAChD,QAAA,mBAAmB,GAAG,GAAG,CAAC,CAAC,MAAM;AAE9C,qEAAqE;AACxD,QAAA,kBAAkB,GAAG,IAAI,CAAC;AAEvC,yFAAyF;AAC5E,QAAA,gCAAgC,GAAG,IAAI,CAAC,CAAC,uBAAuB;AAE7E,6EAA6E;AAChE,QAAA,0BAA0B,GAAG,GAAG,CAAC,CAAC,KAAK;AACvC,QAAA,uCAAuC,GAAG,GAAG,CAAC,CAAC,MAAM;AAElE,4EAA4E;AAC/D,QAAA,2BAA2B,GAAG,GAAG,CAAC,CAAC,KAAK;AACxC,QAAA,wCAAwC,GAAG,IAAI,CAAC,CAAC,MAAM;AAEpE,0FAA0F;AAC7E,QAAA,0BAA0B,GAAG,KAAK,CAAC;AACnC,QAAA,2BAA2B,GAAG,IAAI,CAAC;AAEhD,+EAA+E;AAClE,QAAA,sCAAsC,GAAG,IAAI,CAAC;AAE3D,iDAAiD;AACpC,QAAA,8BAA8B,GAAG,GAAG,CAAC;AAElD,qEAAqE;AACxD,QAAA,sBAAsB,GAAG,GAAG,CAAC;AAC7B,QAAA,eAAe,GAAG,GAAG,CAAC,CAAC,MAAM;AAE1C,8EAA8E;AACjE,QAAA,kCAAkC,GAAG,CAAC,CAAC;AAEpD,8EAA8E;AAC9E,gFAAgF;AACnE,QAAA,sBAAsB,GAAG,GAAG,CAAC,CAAC,KAAK"}

package/dist/core/errors/rc-design.error.js

@@ -20,5 +20,34 @@ exports.Errors = {
         code: 102,
         message: "Out of tension controlled region, tensile steel is not yielding.",
     },
+    SECTION_TOO_NARROW_FOR_BAR: {
+        code: 103,
+        message: "Section width is too narrow to fit even one bar of the given diameter with the required cover and spacing.",
+    },
+    BAR_LAYOUT_EXCEEDS_SECTION_HEIGHT: {
+        code: 104,
+        message: "Combined top and bottom rebar layers exceed the section height h.",
+    },
+    SHEAR_STRENGTH_EXCEEDS_MAX: {
+        code: 105,
+        message: "Vs exceeds 0.66*sqrt(fc')*bw*d (ACI318-19, 22.5.1.2); section is too small for shear, increase bw or d.",
+    },
+    // 2XX : Strengthening / plate-to-concrete connection errors
+    NON_POSITIVE_SHEAR_FLOW: {
+        code: 201,
+        message: "Interface shear flow requires a positive shear force V and at least one jacketing plate with non-zero area.",
+    },
+    INVALID_BOLT_CAPACITY: {
+        code: 202,
+        message: "Resolved bolt shear capacity is not positive; check Ase, futa, or the supplied phiVboltOverride.",
+    },
+    PLATE_OUTSIDE_SECTION: {
+        code: 203,
+        message: "Inconsistent jacketed section geometry; plate and section dimensions must be positive and d must lie within h.",
+    },
+    CRACKED_NA_NOT_FOUND: {
+        code: 204,
+        message: "No valid cracked neutral axis was found within the concrete depth; check the section and plate properties.",
+    },
 };
 //# sourceMappingURL=rc-design.error.js.map

package/dist/core/errors/rc-design.error.js.map

@@ -1 +1 @@
-{"version":3,"file":"rc-design.error.js","sourceRoot":"","sources":["../../../src/core/errors/rc-design.error.ts"],"names":[],"mappings":";;;AAAA,MAAa,aAAc,SAAQ,KAAK;IAItC,YAAY,MAAyB,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE;QACxE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAC3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC;CACF;AAVD,sCAUC;AAOY,QAAA,MAAM,GAAsC;IACvD,8BAA8B;IAC9B,2BAA2B,EAAE;QAC3B,IAAI,EAAE,GAAG;QACT,OAAO,EACL,sFAAsF;KACzF;IACD,0BAA0B,EAAE;QAC1B,IAAI,EAAE,GAAG;QACT,OAAO,EAAE,kEAAkE;KAC5E;CACF,CAAC"}
+{"version":3,"file":"rc-design.error.js","sourceRoot":"","sources":["../../../src/core/errors/rc-design.error.ts"],"names":[],"mappings":";;;AAAA,MAAa,aAAc,SAAQ,KAAK;IAItC,YAAY,MAAyB,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE;QACxE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAC3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC;CACF;AAVD,sCAUC;AAOY,QAAA,MAAM,GAAsC;IACvD,8BAA8B;IAC9B,2BAA2B,EAAE;QAC3B,IAAI,EAAE,GAAG;QACT,OAAO,EAAE,sFAAsF;KAChG;IACD,0BAA0B,EAAE;QAC1B,IAAI,EAAE,GAAG;QACT,OAAO,EAAE,kEAAkE;KAC5E;IACD,0BAA0B,EAAE;QAC1B,IAAI,EAAE,GAAG;QACT,OAAO,EACL,4GAA4G;KAC/G;IACD,iCAAiC,EAAE;QACjC,IAAI,EAAE,GAAG;QACT,OAAO,EAAE,mEAAmE;KAC7E;IACD,0BAA0B,EAAE;QAC1B,IAAI,EAAE,GAAG;QACT,OAAO,EACL,yGAAyG;KAC5G;IAED,4DAA4D;IAC5D,uBAAuB,EAAE;QACvB,IAAI,EAAE,GAAG;QACT,OAAO,EACL,6GAA6G;KAChH;IACD,qBAAqB,EAAE;QACrB,IAAI,EAAE,GAAG;QACT,OAAO,EACL,kGAAkG;KACrG;IACD,qBAAqB,EAAE;QACrB,IAAI,EAAE,GAAG;QACT,OAAO,EACL,gHAAgH;KACnH;IACD,oBAAoB,EAAE;QACpB,IAAI,EAAE,GAAG;QACT,OAAO,EACL,4GAA4G;KAC/G;CACF,CAAC"}

package/dist/core/index.d.ts

@@ -1,7 +1,8 @@
-export type { RectBeamSection, RectSinglyBeamSection, RectDoublyBeamSection, } from "./types/rc-beam.type";
+export type { RectBeamSection, RectSinglyBeamSection, RectDoublyBeamSection, RectShearSection, StirrupShearSection, ShearReinforcementCheckInput, RebarGroupInput, RectBeamBarLayoutInput, } from "./types/rc-beam.type";
 export { isSinglyReinforced } from "./types/rc-beam.type";
-export type { SteelJacketedProps } from "./types/plate-jacketing.type";
+export type { SteelJacketedProps, SectionState, PlateShearFlowInput, BoltProps, PlateInterfaceBoltInput, } from "./types/plate-jacketing.type";
+export { hasTopPlate, hasBottomPlate } from "./types/plate-jacketing.type";
 export type { Warnings, calculationResult } from "./types/output-message.type";
 export type { unit } from "./types/unit.type";
-export { FLEXURAL_STRENGTH_REDUCTION_FACTOR, CONCRETE_ULTIMATE_STRAIN, } from "./constants/rc.constant";
+export { FLEXURAL_STRENGTH_REDUCTION_FACTOR, CONCRETE_ULTIMATE_STRAIN, SHEAR_STRENGTH_REDUCTION_FACTOR, ANCHOR_SHEAR_STRENGTH_REDUCTION_FACTOR, MAX_PLATE_BOLT_SPACING, } from "./constants/rc.constant";
 export { RCDesignError, Errors } from "./errors/rc-design.error";

package/dist/core/index.js

@@ -1,12 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Errors = exports.RCDesignError = exports.CONCRETE_ULTIMATE_STRAIN = exports.FLEXURAL_STRENGTH_REDUCTION_FACTOR = exports.isSinglyReinforced = void 0;
+exports.Errors = exports.RCDesignError = exports.MAX_PLATE_BOLT_SPACING = exports.ANCHOR_SHEAR_STRENGTH_REDUCTION_FACTOR = exports.SHEAR_STRENGTH_REDUCTION_FACTOR = exports.CONCRETE_ULTIMATE_STRAIN = exports.FLEXURAL_STRENGTH_REDUCTION_FACTOR = exports.hasBottomPlate = exports.hasTopPlate = exports.isSinglyReinforced = void 0;
 var rc_beam_type_1 = require("./types/rc-beam.type");
 Object.defineProperty(exports, "isSinglyReinforced", { enumerable: true, get: function () { return rc_beam_type_1.isSinglyReinforced; } });
+var plate_jacketing_type_1 = require("./types/plate-jacketing.type");
+Object.defineProperty(exports, "hasTopPlate", { enumerable: true, get: function () { return plate_jacketing_type_1.hasTopPlate; } });
+Object.defineProperty(exports, "hasBottomPlate", { enumerable: true, get: function () { return plate_jacketing_type_1.hasBottomPlate; } });
 // Constants
 var rc_constant_1 = require("./constants/rc.constant");
 Object.defineProperty(exports, "FLEXURAL_STRENGTH_REDUCTION_FACTOR", { enumerable: true, get: function () { return rc_constant_1.FLEXURAL_STRENGTH_REDUCTION_FACTOR; } });
 Object.defineProperty(exports, "CONCRETE_ULTIMATE_STRAIN", { enumerable: true, get: function () { return rc_constant_1.CONCRETE_ULTIMATE_STRAIN; } });
+Object.defineProperty(exports, "SHEAR_STRENGTH_REDUCTION_FACTOR", { enumerable: true, get: function () { return rc_constant_1.SHEAR_STRENGTH_REDUCTION_FACTOR; } });
+Object.defineProperty(exports, "ANCHOR_SHEAR_STRENGTH_REDUCTION_FACTOR", { enumerable: true, get: function () { return rc_constant_1.ANCHOR_SHEAR_STRENGTH_REDUCTION_FACTOR; } });
+Object.defineProperty(exports, "MAX_PLATE_BOLT_SPACING", { enumerable: true, get: function () { return rc_constant_1.MAX_PLATE_BOLT_SPACING; } });
 // Errors
 var rc_design_error_1 = require("./errors/rc-design.error");
 Object.defineProperty(exports, "RCDesignError", { enumerable: true, get: function () { return rc_design_error_1.RCDesignError; } });

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";;;AAMA,qDAA0D;AAAjD,kHAAA,kBAAkB,OAAA;AAK3B,YAAY;AACZ,uDAGiC;AAF7B,iIAAA,kCAAkC,OAAA;AAClC,uHAAA,wBAAwB,OAAA;AAG5B,SAAS;AACT,4DAAiE;AAAxD,gHAAA,aAAa,OAAA;AAAE,yGAAA,MAAM,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";;;AAWA,qDAA0D;AAAjD,kHAAA,kBAAkB,OAAA;AAQ3B,qEAA2E;AAAlE,mHAAA,WAAW,OAAA;AAAE,sHAAA,cAAc,OAAA;AAIpC,YAAY;AACZ,uDAMiC;AAL/B,iIAAA,kCAAkC,OAAA;AAClC,uHAAA,wBAAwB,OAAA;AACxB,8HAAA,+BAA+B,OAAA;AAC/B,qIAAA,sCAAsC,OAAA;AACtC,qHAAA,sBAAsB,OAAA;AAGxB,SAAS;AACT,4DAAiE;AAAxD,gHAAA,aAAa,OAAA;AAAE,yGAAA,MAAM,OAAA"}

package/dist/core/types/plate-jacketing.type.d.ts

@@ -1,8 +1,35 @@
+import { RectBeamSection } from "./rc-beam.type";
 export interface SteelJacketedProps {
     Es: number;
     fy: number;
-    topSteelWidth: number;
-    topSteelThickness: number;
-    bottomSteelWidth: number;
-    bottomSteelThickness: number;
+    topSteelWidth?: number;
+    topSteelThickness?: number;
+    bottomSteelWidth?: number;
+    bottomSteelThickness?: number;
+}
+/**
+ * A plate counts as present only when both its width and thickness are positive,
+ * so a bottom-only jacket may omit the top plate fields or pass them as zero.
+ */
+export declare function hasTopPlate(props: SteelJacketedProps): boolean;
+export declare function hasBottomPlate(props: SteelJacketedProps): boolean;
+export type SectionState = "cracked" | "uncracked";
+export interface PlateShearFlowInput {
+    section: RectBeamSection;
+    plates: SteelJacketedProps;
+    V: number;
+    sectionState?: SectionState;
+}
+export interface BoltProps {
+    Ase: number;
+    futa: number;
+    fya?: number;
+    diameter?: number;
+    shearPlanes?: number;
+    phiVboltOverride?: number;
+}
+export interface PlateInterfaceBoltInput extends PlateShearFlowInput {
+    bolt: BoltProps;
+    boltsPerRow: number;
+    transferLength: number;
 }

package/dist/core/types/plate-jacketing.type.js

@@ -1,3 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasTopPlate = hasTopPlate;
+exports.hasBottomPlate = hasBottomPlate;
+/**
+ * A plate counts as present only when both its width and thickness are positive,
+ * so a bottom-only jacket may omit the top plate fields or pass them as zero.
+ */
+function hasTopPlate(props) {
+    return (props.topSteelWidth ?? 0) > 0 && (props.topSteelThickness ?? 0) > 0;
+}
+function hasBottomPlate(props) {
+    return (props.bottomSteelWidth ?? 0) > 0 && (props.bottomSteelThickness ?? 0) > 0;
+}
 //# sourceMappingURL=plate-jacketing.type.js.map

package/dist/core/types/plate-jacketing.type.js.map

@@ -1 +1 @@
-{"version":3,"file":"plate-jacketing.type.js","sourceRoot":"","sources":["../../../src/core/types/plate-jacketing.type.ts"],"names":[],"mappings":""}
+{"version":3,"file":"plate-jacketing.type.js","sourceRoot":"","sources":["../../../src/core/types/plate-jacketing.type.ts"],"names":[],"mappings":";;AAeA,kCAEC;AAED,wCAEC;AAVD;;;GAGG;AACH,SAAgB,WAAW,CAAC,KAAyB;IACnD,OAAO,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;AAC9E,CAAC;AAED,SAAgB,cAAc,CAAC,KAAyB;IACtD,OAAO,CAAC,KAAK,CAAC,gBAAgB,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,oBAAoB,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;AACpF,CAAC"}

package/dist/core/types/rc-beam.type.d.ts

@@ -12,4 +12,34 @@ export interface RectDoublyBeamSection extends RectSinglyBeamSection {
     As_: number;
     d_: number;
 }
+export interface RectShearSection {
+    fc_: number;
+    bw: number;
+    d: number;
+    lambda?: number;
+}
+export interface StirrupShearSection extends RectShearSection {
+    Av: number;
+    fyt: number;
+    s: number;
+}
+export interface ShearReinforcementCheckInput extends RectShearSection {
+    Vu: number;
+    fyt: number;
+    Av?: number;
+    s?: number;
+}
+export interface RebarGroupInput {
+    count: number;
+    diameter: number;
+}
+export interface RectBeamBarLayoutInput {
+    b: number;
+    h: number;
+    topBars: RebarGroupInput;
+    bottomBars: RebarGroupInput;
+    cover?: number;
+    stirrupDiameter?: number;
+    maxAggregateSize?: number;
+}
 export declare function isSinglyReinforced(section: RectBeamSection): section is RectSinglyBeamSection;

package/dist/core/types/rc-beam.type.js

@@ -2,9 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isSinglyReinforced = isSinglyReinforced;
 function isSinglyReinforced(section) {
-    return (!("As_" in section) ||
-        !("d_" in section) ||
-        section.As_ <= 0 ||
-        section.d_ <= 0);
+    return !("As_" in section) || !("d_" in section) || section.As_ <= 0 || section.d_ <= 0;
 }
 //# sourceMappingURL=rc-beam.type.js.map

package/dist/core/types/rc-beam.type.js.map

@@ -1 +1 @@
-{"version":3,"file":"rc-beam.type.js","sourceRoot":"","sources":["../../../src/core/types/rc-beam.type.ts"],"names":[],"mappings":";;AAiBA,gDASC;AATD,SAAgB,kBAAkB,CAChC,OAAwB;IAExB,OAAO,CACL,CAAC,CAAC,KAAK,IAAI,OAAO,CAAC;QACnB,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC;QAClB,OAAO,CAAC,GAAG,IAAI,CAAC;QAChB,OAAO,CAAC,EAAE,IAAI,CAAC,CAChB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"rc-beam.type.js","sourceRoot":"","sources":["../../../src/core/types/rc-beam.type.ts"],"names":[],"mappings":";;AAoDA,gDAEC;AAFD,SAAgB,kBAAkB,CAAC,OAAwB;IACzD,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;AAC1F,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export { rectBeamMomentCapacity, concreteBeta, concreteElasticModulus, psiToMpa, } from "./rc";
-export { calculateSteelJacketedBeamMomentCapacity } from "./strengthening";
-export type { RectBeamSection, RectSinglyBeamSection, RectDoublyBeamSection, SteelJacketedProps, Warnings, calculationResult, unit, } from "./core";
-export { isSinglyReinforced, FLEXURAL_STRENGTH_REDUCTION_FACTOR, CONCRETE_ULTIMATE_STRAIN, RCDesignError, Errors, } from "./core";
+export { rectBeamMomentCapacity, rectBeamBarLayout, concreteShearCapacity, stirrupShearCapacity, checkStirrupRequirement, concreteBeta, concreteElasticModulus, psiToMpa, } from "./rc";
+export { calculateSteelJacketedBeamMomentCapacity, plateInterfaceShearFlow, boltShearCapacity, plateInterfaceBoltRequirement, } from "./strengthening";
+export type { RectBeamSection, RectSinglyBeamSection, RectDoublyBeamSection, RectShearSection, StirrupShearSection, ShearReinforcementCheckInput, RebarGroupInput, RectBeamBarLayoutInput, SteelJacketedProps, SectionState, PlateShearFlowInput, BoltProps, PlateInterfaceBoltInput, Warnings, calculationResult, unit, } from "./core";
+export { isSinglyReinforced, hasTopPlate, hasBottomPlate, FLEXURAL_STRENGTH_REDUCTION_FACTOR, CONCRETE_ULTIMATE_STRAIN, SHEAR_STRENGTH_REDUCTION_FACTOR, ANCHOR_SHEAR_STRENGTH_REDUCTION_FACTOR, MAX_PLATE_BOLT_SPACING, RCDesignError, Errors, } from "./core";
 export { solveQuadratic, roundToDecimalPlaces, mergeWarnings } from "./utils";

package/dist/index.js

@@ -1,19 +1,31 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mergeWarnings = exports.roundToDecimalPlaces = exports.solveQuadratic = exports.Errors = exports.RCDesignError = exports.CONCRETE_ULTIMATE_STRAIN = exports.FLEXURAL_STRENGTH_REDUCTION_FACTOR = exports.isSinglyReinforced = exports.calculateSteelJacketedBeamMomentCapacity = exports.psiToMpa = exports.concreteElasticModulus = exports.concreteBeta = exports.rectBeamMomentCapacity = void 0;
+exports.mergeWarnings = exports.roundToDecimalPlaces = exports.solveQuadratic = exports.Errors = exports.RCDesignError = exports.MAX_PLATE_BOLT_SPACING = exports.ANCHOR_SHEAR_STRENGTH_REDUCTION_FACTOR = exports.SHEAR_STRENGTH_REDUCTION_FACTOR = exports.CONCRETE_ULTIMATE_STRAIN = exports.FLEXURAL_STRENGTH_REDUCTION_FACTOR = exports.hasBottomPlate = exports.hasTopPlate = exports.isSinglyReinforced = exports.plateInterfaceBoltRequirement = exports.boltShearCapacity = exports.plateInterfaceShearFlow = exports.calculateSteelJacketedBeamMomentCapacity = exports.psiToMpa = exports.concreteElasticModulus = exports.concreteBeta = exports.checkStirrupRequirement = exports.stirrupShearCapacity = exports.concreteShearCapacity = exports.rectBeamBarLayout = exports.rectBeamMomentCapacity = void 0;
 // RC Beam Design
 var rc_1 = require("./rc");
 Object.defineProperty(exports, "rectBeamMomentCapacity", { enumerable: true, get: function () { return rc_1.rectBeamMomentCapacity; } });
+Object.defineProperty(exports, "rectBeamBarLayout", { enumerable: true, get: function () { return rc_1.rectBeamBarLayout; } });
+Object.defineProperty(exports, "concreteShearCapacity", { enumerable: true, get: function () { return rc_1.concreteShearCapacity; } });
+Object.defineProperty(exports, "stirrupShearCapacity", { enumerable: true, get: function () { return rc_1.stirrupShearCapacity; } });
+Object.defineProperty(exports, "checkStirrupRequirement", { enumerable: true, get: function () { return rc_1.checkStirrupRequirement; } });
 Object.defineProperty(exports, "concreteBeta", { enumerable: true, get: function () { return rc_1.concreteBeta; } });
 Object.defineProperty(exports, "concreteElasticModulus", { enumerable: true, get: function () { return rc_1.concreteElasticModulus; } });
 Object.defineProperty(exports, "psiToMpa", { enumerable: true, get: function () { return rc_1.psiToMpa; } });
 // Strengthening
 var strengthening_1 = require("./strengthening");
 Object.defineProperty(exports, "calculateSteelJacketedBeamMomentCapacity", { enumerable: true, get: function () { return strengthening_1.calculateSteelJacketedBeamMomentCapacity; } });
+Object.defineProperty(exports, "plateInterfaceShearFlow", { enumerable: true, get: function () { return strengthening_1.plateInterfaceShearFlow; } });
+Object.defineProperty(exports, "boltShearCapacity", { enumerable: true, get: function () { return strengthening_1.boltShearCapacity; } });
+Object.defineProperty(exports, "plateInterfaceBoltRequirement", { enumerable: true, get: function () { return strengthening_1.plateInterfaceBoltRequirement; } });
 var core_1 = require("./core");
 Object.defineProperty(exports, "isSinglyReinforced", { enumerable: true, get: function () { return core_1.isSinglyReinforced; } });
+Object.defineProperty(exports, "hasTopPlate", { enumerable: true, get: function () { return core_1.hasTopPlate; } });
+Object.defineProperty(exports, "hasBottomPlate", { enumerable: true, get: function () { return core_1.hasBottomPlate; } });
 Object.defineProperty(exports, "FLEXURAL_STRENGTH_REDUCTION_FACTOR", { enumerable: true, get: function () { return core_1.FLEXURAL_STRENGTH_REDUCTION_FACTOR; } });
 Object.defineProperty(exports, "CONCRETE_ULTIMATE_STRAIN", { enumerable: true, get: function () { return core_1.CONCRETE_ULTIMATE_STRAIN; } });
+Object.defineProperty(exports, "SHEAR_STRENGTH_REDUCTION_FACTOR", { enumerable: true, get: function () { return core_1.SHEAR_STRENGTH_REDUCTION_FACTOR; } });
+Object.defineProperty(exports, "ANCHOR_SHEAR_STRENGTH_REDUCTION_FACTOR", { enumerable: true, get: function () { return core_1.ANCHOR_SHEAR_STRENGTH_REDUCTION_FACTOR; } });
+Object.defineProperty(exports, "MAX_PLATE_BOLT_SPACING", { enumerable: true, get: function () { return core_1.MAX_PLATE_BOLT_SPACING; } });
 Object.defineProperty(exports, "RCDesignError", { enumerable: true, get: function () { return core_1.RCDesignError; } });
 Object.defineProperty(exports, "Errors", { enumerable: true, get: function () { return core_1.Errors; } });
 // Utilities

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iBAAiB;AACjB,2BAKc;AAJZ,4GAAA,sBAAsB,OAAA;AACtB,kGAAA,YAAY,OAAA;AACZ,4GAAA,sBAAsB,OAAA;AACtB,8FAAA,QAAQ,OAAA;AAGV,gBAAgB;AAChB,iDAA2E;AAAlE,yIAAA,wCAAwC,OAAA;AAajD,+BAMgB;AALd,0GAAA,kBAAkB,OAAA;AAClB,0HAAA,kCAAkC,OAAA;AAClC,gHAAA,wBAAwB,OAAA;AACxB,qGAAA,aAAa,OAAA;AACb,8FAAA,MAAM,OAAA;AAGR,YAAY;AACZ,iCAA8E;AAArE,uGAAA,cAAc,OAAA;AAAE,6GAAA,oBAAoB,OAAA;AAAE,sGAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iBAAiB;AACjB,2BASc;AARZ,4GAAA,sBAAsB,OAAA;AACtB,uGAAA,iBAAiB,OAAA;AACjB,2GAAA,qBAAqB,OAAA;AACrB,0GAAA,oBAAoB,OAAA;AACpB,6GAAA,uBAAuB,OAAA;AACvB,kGAAA,YAAY,OAAA;AACZ,4GAAA,sBAAsB,OAAA;AACtB,8FAAA,QAAQ,OAAA;AAGV,gBAAgB;AAChB,iDAKyB;AAJvB,yIAAA,wCAAwC,OAAA;AACxC,wHAAA,uBAAuB,OAAA;AACvB,kHAAA,iBAAiB,OAAA;AACjB,8HAAA,6BAA6B,OAAA;AAuB/B,+BAWgB;AAVd,0GAAA,kBAAkB,OAAA;AAClB,mGAAA,WAAW,OAAA;AACX,sGAAA,cAAc,OAAA;AACd,0HAAA,kCAAkC,OAAA;AAClC,gHAAA,wBAAwB,OAAA;AACxB,uHAAA,+BAA+B,OAAA;AAC/B,8HAAA,sCAAsC,OAAA;AACtC,8GAAA,sBAAsB,OAAA;AACtB,qGAAA,aAAa,OAAA;AACb,8FAAA,MAAM,OAAA;AAGR,YAAY;AACZ,iCAA8E;AAArE,uGAAA,cAAc,OAAA;AAAE,6GAAA,oBAAoB,OAAA;AAAE,sGAAA,aAAa,OAAA"}

package/dist/rc/index.d.ts

@@ -1,2 +1,3 @@
-export { rectBeamMomentCapacity } from "./rc-beam-design";
+export { rectBeamMomentCapacity, concreteShearCapacity, stirrupShearCapacity, checkStirrupRequirement, } from "./rc-beam-design";
 export { concreteBeta, concreteElasticModulus, psiToMpa } from "./general";
+export { rectBeamBarLayout } from "./rc-bar-layout";

package/dist/rc/index.js

@@ -1,10 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.psiToMpa = exports.concreteElasticModulus = exports.concreteBeta = exports.rectBeamMomentCapacity = void 0;
+exports.rectBeamBarLayout = exports.psiToMpa = exports.concreteElasticModulus = exports.concreteBeta = exports.checkStirrupRequirement = exports.stirrupShearCapacity = exports.concreteShearCapacity = exports.rectBeamMomentCapacity = void 0;
 var rc_beam_design_1 = require("./rc-beam-design");
 Object.defineProperty(exports, "rectBeamMomentCapacity", { enumerable: true, get: function () { return rc_beam_design_1.rectBeamMomentCapacity; } });
+Object.defineProperty(exports, "concreteShearCapacity", { enumerable: true, get: function () { return rc_beam_design_1.concreteShearCapacity; } });
+Object.defineProperty(exports, "stirrupShearCapacity", { enumerable: true, get: function () { return rc_beam_design_1.stirrupShearCapacity; } });
+Object.defineProperty(exports, "checkStirrupRequirement", { enumerable: true, get: function () { return rc_beam_design_1.checkStirrupRequirement; } });
 var general_1 = require("./general");
 Object.defineProperty(exports, "concreteBeta", { enumerable: true, get: function () { return general_1.concreteBeta; } });
 Object.defineProperty(exports, "concreteElasticModulus", { enumerable: true, get: function () { return general_1.concreteElasticModulus; } });
 Object.defineProperty(exports, "psiToMpa", { enumerable: true, get: function () { return general_1.psiToMpa; } });
+var rc_bar_layout_1 = require("./rc-bar-layout");
+Object.defineProperty(exports, "rectBeamBarLayout", { enumerable: true, get: function () { return rc_bar_layout_1.rectBeamBarLayout; } });
 //# sourceMappingURL=index.js.map

package/dist/rc/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rc/index.ts"],"names":[],"mappings":";;;AAAA,mDAA0D;AAAjD,wHAAA,sBAAsB,OAAA;AAC/B,qCAA2E;AAAlE,uGAAA,YAAY,OAAA;AAAE,iHAAA,sBAAsB,OAAA;AAAE,mGAAA,QAAQ,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rc/index.ts"],"names":[],"mappings":";;;AAAA,mDAK0B;AAJxB,wHAAA,sBAAsB,OAAA;AACtB,uHAAA,qBAAqB,OAAA;AACrB,sHAAA,oBAAoB,OAAA;AACpB,yHAAA,uBAAuB,OAAA;AAEzB,qCAA2E;AAAlE,uGAAA,YAAY,OAAA;AAAE,iHAAA,sBAAsB,OAAA;AAAE,mGAAA,QAAQ,OAAA;AACvD,iDAAoD;AAA3C,kHAAA,iBAAiB,OAAA"}

package/dist/rc/rc-bar-layout.d.ts

@@ -0,0 +1,34 @@
+import { RectBeamBarLayoutInput } from "../core/types/rc-beam.type";
+import { Warnings } from "../core/types/output-message.type";
+/**
+ * Lays out top and bottom rebar groups within a rectangular beam section,
+ * determining the number of layers required to satisfy ACI 318-19 minimum
+ * bar spacing (25.2.1) and layer spacing (25.2.2), and returns the resulting
+ * effective depth `d` and compression steel depth `d_`, both measured from
+ * the top (compression) face so they plug directly into
+ * {@link rectBeamMomentCapacity}'s `d` / `d_` inputs.
+ *
+ * @param input - Section dimensions, top/bottom bar groups, and optional
+ *   cover / stirrup diameter / max aggregate size (default to ACI 318-19
+ *   Table 20.6.1.3.1 values for cast-in-place beams not exposed to weather
+ *   or in contact with ground)
+ * @returns `d`, `d_`, per-group layer counts and areas, `unit`, and `warnings`
+ * @throws {RCDesignError} If a bar does not fit within the section width, or
+ *   if the combined top/bottom layers exceed the section height
+ */
+export declare const rectBeamBarLayout: (input: RectBeamBarLayoutInput) => {
+    d: number;
+    d_: number;
+    top: {
+        numberOfLayers: number;
+        barsPerLayer: number[];
+        As: number;
+    };
+    bottom: {
+        numberOfLayers: number;
+        barsPerLayer: number[];
+        As: number;
+    };
+    unit: string;
+    warnings: Warnings;
+};

package/dist/rc/rc-bar-layout.js

@@ -0,0 +1,125 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rectBeamBarLayout = void 0;
+const rc_design_error_1 = require("../core/errors/rc-design.error");
+const MyMath = __importStar(require("../utils/math"));
+const RCConstants = __importStar(require("../core/constants/rc.constant"));
+/**
+ * Lays out a group of same-diameter bars (top or bottom) into the minimum
+ * number of layers that fit within the section width, per ACI 318-19 25.2.1
+ * (min clear spacing within a layer) and 25.2.2 (min clear spacing between
+ * layers), then returns the centroid distance from the near face.
+ */
+const calculateBarGroupLayout = (group, b, cover, stirrupDiameter, maxAggregateSize) => {
+    const { count, diameter } = group;
+    if (count <= 0) {
+        return {
+            numberOfLayers: 0,
+            barsPerLayer: [],
+            distanceFromFace: 0,
+            outerExtent: 0,
+            As: 0,
+        };
+    }
+    const minClearSpacing = Math.max(RCConstants.MIN_BAR_CLEAR_SPACING, diameter, RCConstants.AGGREGATE_SPACING_FACTOR * maxAggregateSize);
+    const availableWidth = b - 2 * (cover + stirrupDiameter);
+    const maxBarsPerLayer = Math.min(count, Math.floor((availableWidth + minClearSpacing) / (diameter + minClearSpacing)));
+    if (maxBarsPerLayer < 1) {
+        throw new rc_design_error_1.RCDesignError(rc_design_error_1.Errors.SECTION_TOO_NARROW_FOR_BAR);
+    }
+    const numberOfLayers = Math.ceil(count / maxBarsPerLayer);
+    const baseBarsPerLayer = Math.floor(count / numberOfLayers);
+    const remainder = count % numberOfLayers;
+    const barsPerLayer = Array.from({ length: numberOfLayers }, (_, i) => i < remainder ? baseBarsPerLayer + 1 : baseBarsPerLayer);
+    const layerPitch = diameter + RCConstants.MIN_LAYER_CLEAR_SPACING;
+    const firstLayerDistance = cover + stirrupDiameter + diameter / 2;
+    const weightedSum = barsPerLayer.reduce((sum, n, i) => sum + n * (firstLayerDistance + i * layerPitch), 0);
+    return {
+        numberOfLayers,
+        barsPerLayer,
+        distanceFromFace: weightedSum / count,
+        outerExtent: cover +
+            stirrupDiameter +
+            numberOfLayers * diameter +
+            (numberOfLayers - 1) * RCConstants.MIN_LAYER_CLEAR_SPACING,
+        As: count * (Math.PI / 4) * diameter ** 2,
+    };
+};
+/**
+ * Lays out top and bottom rebar groups within a rectangular beam section,
+ * determining the number of layers required to satisfy ACI 318-19 minimum
+ * bar spacing (25.2.1) and layer spacing (25.2.2), and returns the resulting
+ * effective depth `d` and compression steel depth `d_`, both measured from
+ * the top (compression) face so they plug directly into
+ * {@link rectBeamMomentCapacity}'s `d` / `d_` inputs.
+ *
+ * @param input - Section dimensions, top/bottom bar groups, and optional
+ *   cover / stirrup diameter / max aggregate size (default to ACI 318-19
+ *   Table 20.6.1.3.1 values for cast-in-place beams not exposed to weather
+ *   or in contact with ground)
+ * @returns `d`, `d_`, per-group layer counts and areas, `unit`, and `warnings`
+ * @throws {RCDesignError} If a bar does not fit within the section width, or
+ *   if the combined top/bottom layers exceed the section height
+ */
+const rectBeamBarLayout = (input) => {
+    const warnings = [];
+    const cover = input.cover ?? RCConstants.DEFAULT_BEAM_COVER;
+    const stirrupDiameter = input.stirrupDiameter ?? RCConstants.DEFAULT_STIRRUP_DIAMETER;
+    const maxAggregateSize = input.maxAggregateSize ?? RCConstants.DEFAULT_MAX_AGGREGATE_SIZE;
+    const top = calculateBarGroupLayout(input.topBars, input.b, cover, stirrupDiameter, maxAggregateSize);
+    const bottom = calculateBarGroupLayout(input.bottomBars, input.b, cover, stirrupDiameter, maxAggregateSize);
+    if (top.outerExtent + bottom.outerExtent > input.h) {
+        throw new rc_design_error_1.RCDesignError(rc_design_error_1.Errors.BAR_LAYOUT_EXCEEDS_SECTION_HEIGHT);
+    }
+    return {
+        d: MyMath.roundToDecimalPlaces(input.h - bottom.distanceFromFace, 1),
+        d_: MyMath.roundToDecimalPlaces(top.distanceFromFace, 1),
+        top: {
+            numberOfLayers: top.numberOfLayers,
+            barsPerLayer: top.barsPerLayer,
+            As: MyMath.roundToDecimalPlaces(top.As, 1),
+        },
+        bottom: {
+            numberOfLayers: bottom.numberOfLayers,
+            barsPerLayer: bottom.barsPerLayer,
+            As: MyMath.roundToDecimalPlaces(bottom.As, 1),
+        },
+        unit: "mm",
+        warnings: warnings,
+    };
+};
+exports.rectBeamBarLayout = rectBeamBarLayout;
+//# sourceMappingURL=rc-bar-layout.js.map

package/dist/rc/rc-bar-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rc-bar-layout.js","sourceRoot":"","sources":["../../src/rc/rc-bar-layout.ts"],"names":[],"mappings":"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"}