@theerapat-s28/ts-structural-eng-tools 1.0.0 → 1.1.0

package/LICENSE

@@ -1,6 +1,6 @@
 ISC License
 
-Copyright (c) 2026, theerapat-s28
+Copyright (c) 2026 theerapat-s28
 
 Permission to use, copy, modify, and/or distribute this software for any
 purpose with or without fee is hereby granted, provided that the above

package/README.md

@@ -40,7 +40,7 @@ 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
@@ -81,6 +81,9 @@ 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
 

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

@@ -1,2 +1,19 @@
 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;

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

@@ -1,6 +1,35 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONCRETE_ULTIMATE_STRAIN = exports.FLEXURAL_STRENGTH_REDUCTION_FACTOR = void 0;
+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;
 //# 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"}

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

@@ -20,5 +20,17 @@ 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.",
+    },
 };
 //# 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,EACL,sFAAsF;KACzF;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,EACL,mEAAmE;KACtE;IACD,0BAA0B,EAAE;QAC1B,IAAI,EAAE,GAAG;QACT,OAAO,EACL,yGAAyG;KAC5G;CACF,CAAC"}

package/dist/core/index.d.ts

@@ -1,7 +1,7 @@
-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 { 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, } from "./constants/rc.constant";
 export { RCDesignError, Errors } from "./errors/rc-design.error";

package/dist/core/index.js

@@ -1,12 +1,13 @@
 "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.SHEAR_STRENGTH_REDUCTION_FACTOR = exports.CONCRETE_ULTIMATE_STRAIN = exports.FLEXURAL_STRENGTH_REDUCTION_FACTOR = 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; } });
 // 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; } });
 // 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;AAK3B,YAAY;AACZ,uDAIiC;AAH7B,iIAAA,kCAAkC,OAAA;AAClC,uHAAA,wBAAwB,OAAA;AACxB,8HAAA,+BAA+B,OAAA;AAGnC,SAAS;AACT,4DAAiE;AAAxD,gHAAA,aAAa,OAAA;AAAE,yGAAA,MAAM,OAAA"}

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.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,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"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export { rectBeamMomentCapacity, concreteBeta, concreteElasticModulus, psiToMpa, } from "./rc";
+export { rectBeamMomentCapacity, rectBeamBarLayout, concreteBeta, concreteElasticModulus, psiToMpa, } from "./rc";
 export { calculateSteelJacketedBeamMomentCapacity } from "./strengthening";
-export type { RectBeamSection, RectSinglyBeamSection, RectDoublyBeamSection, SteelJacketedProps, Warnings, calculationResult, unit, } from "./core";
+export type { RectBeamSection, RectSinglyBeamSection, RectDoublyBeamSection, RebarGroupInput, RectBeamBarLayoutInput, SteelJacketedProps, Warnings, calculationResult, unit, } from "./core";
 export { isSinglyReinforced, FLEXURAL_STRENGTH_REDUCTION_FACTOR, CONCRETE_ULTIMATE_STRAIN, RCDesignError, Errors, } from "./core";
 export { solveQuadratic, roundToDecimalPlaces, mergeWarnings } from "./utils";

package/dist/index.js

@@ -1,9 +1,10 @@
 "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.CONCRETE_ULTIMATE_STRAIN = exports.FLEXURAL_STRENGTH_REDUCTION_FACTOR = exports.isSinglyReinforced = exports.calculateSteelJacketedBeamMomentCapacity = exports.psiToMpa = exports.concreteElasticModulus = exports.concreteBeta = 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, "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; } });

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,2BAMc;AALZ,4GAAA,sBAAsB,OAAA;AACtB,uGAAA,iBAAiB,OAAA;AACjB,kGAAA,YAAY,OAAA;AACZ,4GAAA,sBAAsB,OAAA;AACtB,8FAAA,QAAQ,OAAA;AAGV,gBAAgB;AAChB,iDAA2E;AAAlE,yIAAA,wCAAwC,OAAA;AAejD,+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"}

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;AAJtB,wHAAA,sBAAsB,OAAA;AACtB,uHAAA,qBAAqB,OAAA;AACrB,sHAAA,oBAAoB,OAAA;AACpB,yHAAA,uBAAuB,OAAA;AAE3B,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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"}

package/dist/rc/rc-beam-design.d.ts

@@ -1,4 +1,4 @@
-import { RectBeamSection } from "../core/types/rc-beam.type";
+import { RectBeamSection, RectShearSection, StirrupShearSection, ShearReinforcementCheckInput } from "../core/types/rc-beam.type";
 import { Warnings } from "../core/types/output-message.type";
 /**
  * Calculates the nominal moment capacity (φMn) of a rectangular RC beam section.
@@ -16,3 +16,60 @@ export declare const rectBeamMomentCapacity: (section: RectBeamSection) => {
     unit: string;
     warnings: Warnings;
 };
+/**
+ * Calculates the concrete contribution to shear capacity (φVc) of a beam section
+ * per ACI 318-19 22.5.5.1, Table 22.5.5.1(a): Vc = 0.17 λ √f'c bw d
+ *
+ * @param section - Shear section properties (fc_, bw, d, optional lambda)
+ * @returns Object containing `phiVc` (kN), `calculationDetails`, `unit`, and `warnings`
+ */
+export declare const concreteShearCapacity: (section: RectShearSection) => {
+    phiVc: number;
+    calculationDetails: {
+        Vc: number;
+        lambda: number;
+    };
+    unit: string;
+    warnings: Warnings;
+};
+/**
+ * Calculates the stirrup (shear reinforcement) contribution to shear capacity (φVs)
+ * of a beam section per ACI 318-19 22.5.10.5.3: Vs = Av fyt d / s
+ *
+ * @param section - Stirrup shear properties (fc_, bw, d, Av, fyt, s)
+ * @returns Object containing `phiVs` (kN), `calculationDetails`, `unit`, and `warnings`
+ * @throws {RCDesignError} If Vs exceeds the ACI 318-19 22.5.1.2 maximum (section too small)
+ */
+export declare const stirrupShearCapacity: (section: StirrupShearSection) => {
+    phiVs: number;
+    calculationDetails: {
+        Vs: number;
+        maxVs: number;
+    };
+    unit: string;
+    warnings: Warnings;
+};
+/**
+ * Checks whether shear reinforcement (stirrups) is required at a section, and if so,
+ * whether it may be at the code minimum or must be designed for strength, per
+ * ACI 318-19 9.6.3.1 (requirement thresholds), 9.6.3.3 (Av,min), and 9.7.6.2.2 (max spacing).
+ *
+ * If `Av` and `s` are supplied, the provided reinforcement is checked against the
+ * required Av/s ratio and maximum spacing, adding warnings on shortfalls.
+ *
+ * @param input - Section and demand properties (fc_, bw, d, Vu, fyt, optional Av, s, lambda)
+ * @returns Object containing requirement classification, required Av/s and max spacing, and warnings
+ * @throws {RCDesignError} If required Vs exceeds the ACI 318-19 22.5.1.2 maximum (section too small)
+ */
+export declare const checkStirrupRequirement: (input: ShearReinforcementCheckInput) => {
+    required: boolean;
+    minimumOnly: boolean;
+    calculationDetails: {
+        phiVc: number;
+        halfPhiVc: number;
+        requiredAvOverS: number;
+        maxSpacing: number | null;
+    };
+    unit: string;
+    warnings: Warnings;
+};

package/dist/rc/rc-beam-design.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.rectBeamMomentCapacity = void 0;
+exports.checkStirrupRequirement = exports.stirrupShearCapacity = exports.concreteShearCapacity = exports.rectBeamMomentCapacity = void 0;
 const rc_design_error_1 = require("../core/errors/rc-design.error");
 const MyMath = __importStar(require("../utils/math"));
 const rc_beam_type_1 = require("../core/types/rc-beam.type");
@@ -114,6 +114,152 @@ const rectBeamMomentCapacity = (section) => {
     };
 };
 exports.rectBeamMomentCapacity = rectBeamMomentCapacity;
+/**
+ * Calculates the concrete contribution to shear capacity (φVc) of a beam section
+ * per ACI 318-19 22.5.5.1, Table 22.5.5.1(a): Vc = 0.17 λ √f'c bw d
+ *
+ * @param section - Shear section properties (fc_, bw, d, optional lambda)
+ * @returns Object containing `phiVc` (kN), `calculationDetails`, `unit`, and `warnings`
+ */
+const concreteShearCapacity = (section) => {
+    const warnings = [];
+    const lambda = section.lambda ?? 1.0;
+    const sqrtFc = Math.sqrt(section.fc_);
+    if (sqrtFc > RCConstants.SQRT_FC_SHEAR_LIMIT) {
+        warnings.push({
+            reference: "ACI318-19, 22.5.3.1",
+            message: `sqrt(fc') (${MyMath.roundToDecimalPlaces(sqrtFc, 2)}) > ${RCConstants.SQRT_FC_SHEAR_LIMIT} MPa limit for Vc; capped at ${RCConstants.SQRT_FC_SHEAR_LIMIT} MPa unless minimum shear reinforcement per 9.6.3.3 is provided.`,
+        });
+    }
+    const cappedSqrtFc = Math.min(sqrtFc, RCConstants.SQRT_FC_SHEAR_LIMIT);
+    const Vc = RCConstants.CONCRETE_SHEAR_VC_COEFFICIENT *
+        lambda *
+        cappedSqrtFc *
+        section.bw *
+        section.d; // N
+    return {
+        phiVc: MyMath.roundToDecimalPlaces(RCConstants.SHEAR_STRENGTH_REDUCTION_FACTOR * Vc * 0.001, 2),
+        calculationDetails: {
+            Vc: MyMath.roundToDecimalPlaces(Vc * 0.001, 2),
+            lambda,
+        },
+        unit: "kN",
+        warnings,
+    };
+};
+exports.concreteShearCapacity = concreteShearCapacity;
+/**
+ * Calculates the stirrup (shear reinforcement) contribution to shear capacity (φVs)
+ * of a beam section per ACI 318-19 22.5.10.5.3: Vs = Av fyt d / s
+ *
+ * @param section - Stirrup shear properties (fc_, bw, d, Av, fyt, s)
+ * @returns Object containing `phiVs` (kN), `calculationDetails`, `unit`, and `warnings`
+ * @throws {RCDesignError} If Vs exceeds the ACI 318-19 22.5.1.2 maximum (section too small)
+ */
+const stirrupShearCapacity = (section) => {
+    const warnings = [];
+    const { fc_, bw, d, Av, fyt, s } = section;
+    const Vs = (Av * fyt * d) / s; // N
+    const maxVs = RCConstants.MAX_VS_COEFFICIENT * Math.sqrt(fc_) * bw * d; // N
+    if (Vs > maxVs) {
+        throw new rc_design_error_1.RCDesignError(rc_design_error_1.Errors.SHEAR_STRENGTH_EXCEEDS_MAX);
+    }
+    return {
+        phiVs: MyMath.roundToDecimalPlaces(RCConstants.SHEAR_STRENGTH_REDUCTION_FACTOR * Vs * 0.001, 2),
+        calculationDetails: {
+            Vs: MyMath.roundToDecimalPlaces(Vs * 0.001, 2),
+            maxVs: MyMath.roundToDecimalPlaces(maxVs * 0.001, 2),
+        },
+        unit: "kN",
+        warnings,
+    };
+};
+exports.stirrupShearCapacity = stirrupShearCapacity;
+/**
+ * Checks whether shear reinforcement (stirrups) is required at a section, and if so,
+ * whether it may be at the code minimum or must be designed for strength, per
+ * ACI 318-19 9.6.3.1 (requirement thresholds), 9.6.3.3 (Av,min), and 9.7.6.2.2 (max spacing).
+ *
+ * If `Av` and `s` are supplied, the provided reinforcement is checked against the
+ * required Av/s ratio and maximum spacing, adding warnings on shortfalls.
+ *
+ * @param input - Section and demand properties (fc_, bw, d, Vu, fyt, optional Av, s, lambda)
+ * @returns Object containing requirement classification, required Av/s and max spacing, and warnings
+ * @throws {RCDesignError} If required Vs exceeds the ACI 318-19 22.5.1.2 maximum (section too small)
+ */
+const checkStirrupRequirement = (input) => {
+    const warnings = [];
+    const { fc_, bw, d, Vu, fyt, Av, s } = input;
+    const { phiVc, calculationDetails } = (0, exports.concreteShearCapacity)({
+        fc_,
+        bw,
+        d,
+        lambda: input.lambda,
+    });
+    const Vc = calculationDetails.Vc; // kN
+    const halfPhiVc = 0.5 * phiVc;
+    let required = false;
+    let minimumOnly = false;
+    let requiredAvOverS = 0; // mm^2/mm
+    let maxSpacing = null;
+    if (Vu > halfPhiVc) {
+        required = true;
+        const sqrtFc = Math.sqrt(fc_);
+        const minAvOverS = Math.max((RCConstants.MIN_AV_SQRT_FC_COEFFICIENT * sqrtFc * bw) / fyt, (RCConstants.MIN_AV_ABSOLUTE_COEFFICIENT * bw) / fyt);
+        if (Vu <= phiVc) {
+            minimumOnly = true;
+            requiredAvOverS = minAvOverS;
+            maxSpacing =
+                RCConstants.MAX_STIRRUP_SPACING_LOW_VS_DEPTH_FACTOR * d <
+                    RCConstants.MAX_STIRRUP_SPACING_LOW_VS
+                    ? RCConstants.MAX_STIRRUP_SPACING_LOW_VS_DEPTH_FACTOR * d
+                    : RCConstants.MAX_STIRRUP_SPACING_LOW_VS;
+        }
+        else {
+            const requiredVs = Vu / RCConstants.SHEAR_STRENGTH_REDUCTION_FACTOR - Vc; // kN
+            const maxVs = (RCConstants.MAX_VS_COEFFICIENT * sqrtFc * bw * d) * 0.001; // kN
+            if (requiredVs > maxVs) {
+                throw new rc_design_error_1.RCDesignError(rc_design_error_1.Errors.SHEAR_STRENGTH_EXCEEDS_MAX);
+            }
+            const strengthAvOverS = (requiredVs * 1000) / (fyt * d); // mm^2/mm
+            requiredAvOverS = Math.max(minAvOverS, strengthAvOverS);
+            const vsThreshold = (RCConstants.VS_SPACING_THRESHOLD_COEFFICIENT * sqrtFc * bw * d) *
+                0.001; // kN
+            maxSpacing =
+                requiredVs <= vsThreshold
+                    ? Math.min(RCConstants.MAX_STIRRUP_SPACING_LOW_VS_DEPTH_FACTOR * d, RCConstants.MAX_STIRRUP_SPACING_LOW_VS)
+                    : Math.min(RCConstants.MAX_STIRRUP_SPACING_HIGH_VS_DEPTH_FACTOR * d, RCConstants.MAX_STIRRUP_SPACING_HIGH_VS);
+        }
+        if (Av !== undefined && s !== undefined) {
+            const providedAvOverS = Av / s;
+            if (providedAvOverS < requiredAvOverS) {
+                warnings.push({
+                    reference: "ACI318-19, 9.6.3.1",
+                    message: `Provided Av/s (${MyMath.roundToDecimalPlaces(providedAvOverS, 4)} mm2/mm) < required Av/s (${MyMath.roundToDecimalPlaces(requiredAvOverS, 4)} mm2/mm).`,
+                });
+            }
+            if (maxSpacing !== null && s > maxSpacing) {
+                warnings.push({
+                    reference: "ACI318-19, 9.7.6.2.2",
+                    message: `Provided spacing s (${s} mm) > max allowed spacing (${MyMath.roundToDecimalPlaces(maxSpacing, 2)} mm).`,
+                });
+            }
+        }
+    }
+    return {
+        required,
+        minimumOnly,
+        calculationDetails: {
+            phiVc,
+            halfPhiVc: MyMath.roundToDecimalPlaces(halfPhiVc, 2),
+            requiredAvOverS: MyMath.roundToDecimalPlaces(requiredAvOverS, 4),
+            maxSpacing: maxSpacing === null ? null : MyMath.roundToDecimalPlaces(maxSpacing, 2),
+        },
+        unit: "kN",
+        warnings,
+    };
+};
+exports.checkStirrupRequirement = checkStirrupRequirement;
 const calculateRectSinglyMn = (singlySection) => {
     const { Es, fy, fc_, As, b, h, d } = singlySection;
     const warnings = [];

package/dist/rc/rc-beam-design.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theerapat-s28/ts-structural-eng-tools",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "TypeScript structural-engineering helper functions and beam design utilities",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -31,17 +31,6 @@
     "README.md",
     "LICENSE"
   ],
-  "scripts": {
-    "dev": "ts-node -r tsconfig-paths/register examples/basic-usage.ts",
-    "build": "tsc -p tsconfig.json && tsc-alias -p tsconfig.json",
-    "prepublishOnly": "pnpm run build",
-    "lint": "eslint src/",
-    "lint:fix": "eslint src/ --fix",
-    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\" \"examples/**/*.ts\"",
-    "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\" \"examples/**/*.ts\"",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
   "keywords": [
     "structural-engineering",
     "beam-design",
@@ -55,19 +44,31 @@
   "license": "ISC",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/theerapat-s28/ts-structural-eng.git"
+    "url": ""
+  },
+  "publishConfig": {
+    "access": "public"
   },
-  "packageManager": "pnpm@10.18.3",
   "devDependencies": {
     "@eslint/js": "^9.20.0",
     "@types/node": "^24.9.1",
     "eslint": "^9.20.0",
     "prettier": "^3.5.3",
     "ts-node": "^10.9.2",
-    "tsc-alias": "^1.8.16",
+    "tsc-alias": "^1.9.1",
     "tsconfig-paths": "^4.2.0",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.25.0",
     "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "dev": "ts-node -r tsconfig-paths/register examples/basic-usage.ts",
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\" \"examples/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\" \"examples/**/*.ts\"",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
 }