@theerapat-s28/ts-structural-eng-tools 1.5.0 → 2.0.1

package/README.md

@@ -11,6 +11,7 @@ Full API reference, with parameter tables, worked examples, warnings and error c
 - **[API reference](https://theerapat-s28.github.io/ts-structural-eng/)** — landing page
 - [RC Beam Design](https://theerapat-s28.github.io/ts-structural-eng/rc/) — `@theerapat-s28/ts-structural-eng-tools/rc`
 - [Strengthening](https://theerapat-s28.github.io/ts-structural-eng/strengthening/) — `@theerapat-s28/ts-structural-eng-tools/strengthening`
+- [FEA — Frame Analysis](https://theerapat-s28.github.io/ts-structural-eng/fea/) — `@theerapat-s28/ts-structural-eng-tools/fea`
 
 The pages are served from [`html-docs/`](https://github.com/theerapat-s28/ts-structural-eng/tree/main/html-docs) via GitHub Pages.
 
@@ -61,12 +62,23 @@ 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) and shear capacity (Vc, Vs, stirrup requirement)
+│   ├── rc-beam-design.ts # Beam moment capacity (singly/doubly reinforced) and shear capacity (Vc, Vs, stirrup requirement)
+│   └── rc-section-properties.ts # Section properties (E, G, A, I22, I33, J) for frame analysis
 ├── strengthening/        # Strengthening methods
 │   ├── index.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
 │   └── rc-beam-side-plate-shear.ts       # Shear capacity before/after bolted side plates (two models)
+├── fea/                  # Finite-element analysis
+│   ├── index.ts
+│   └── frame/            # 3D frame analysis (direct stiffness method)
+│       ├── index.ts
+│       ├── elements/         # Reference beam stiffness matrix, fixed-end forces, end-release condensation
+│       ├── transformation/   # ETABS-style local axes and the 12×12 transformation
+│       ├── solver/           # System build + skyline factorisation, per-case solve, combinations, analyzeFrame
+│       ├── validation/       # validateFrameModel: every input problem, with its location
+│       ├── post/             # Result presentation, member force diagrams, envelopes, design demands
+│       └── types/            # Model (incl. load cases, combinations) and result types
 ├── core/                 # Shared infrastructure
 │   ├── index.ts
 │   ├── constants/        # RC design constants (ACI 318)
@@ -75,18 +87,22 @@ src/
 └── utils/                # Helper utilities
     ├── index.ts
     ├── math.ts           # Quadratic solver, rounding
+    ├── matrix.ts         # Dense matrix helpers, Cholesky (factor once, solve many) and general linear solvers
+    ├── skyline.ts        # Skyline (banded) Cholesky solver and reverse Cuthill–McKee ordering
     └── merge-warning.ts  # Warning array merging
 examples/
 └── basic-usage.ts        # Example usage of the library
 tests/
 ├── rc/                   # Tests for RC module
 ├── strengthening/        # Tests for strengthening module
+├── fea/frame/            # Tests for frame analysis
 └── utils/                # Tests for utilities
 html-docs/                # HTML API reference, deployed to GitHub Pages
 ├── DESIGN.md             # Style guide for the doc pages
 ├── index.html            # Landing page
 ├── rc/index.html
-└── strengthening/index.html
+├── strengthening/index.html
+└── fea/index.html
 ```
 
 ## TypeScript path aliases
@@ -99,7 +115,8 @@ This project uses `baseUrl` + `paths` for clean imports:
   "@app-types/*": ["src/core/types/*"],
   "@app-utils/*": ["src/utils/*"],
   "@app-rc/*": ["src/rc/*"],
-  "@app-strg/*": ["src/strengthening/*"]
+  "@app-strg/*": ["src/strengthening/*"],
+  "@app-fea/*": ["src/fea/*"]
 }
 ```
 
@@ -134,6 +151,18 @@ Plates bolted to the sides of the web strengthen the beam in shear instead. ACI
 ACI 440.2R-17 11.4.2 (spacing, which defers to the ACI 318 limits) and 11.4.3 (`Vs + Vf ≤ 0.66·√f'c·bw·d`) are verified against the guide; the subsections carrying the 0.004 strain cap and `psi_f` are still cited at §11.4 only. See the citation-status note at the top of `src/strengthening/rc-beam-side-plate-shear.ts`.
 - **`compareSidePlateShearCapacity(section, plates)`** — Runs both models and reports the lower `phiVn` as `governing`; the intended entry point for a conservative design capacity.
 
+### FEA — Frame Analysis
+
+Linear-elastic 3D frame analysis by the direct stiffness method, imported from `@theerapat-s28/ts-structural-eng-tools/fea`. Global axes X, Y, Z (Z up) and ETABS-style local axes 1, 2, 3; inputs in mm, MPa, kN and kN·m, results in kN, kN·m, mm and rad.
+
+- **`analyzeFrame(model, options?)`** — Analyses every load case in `model.loadCases` (dead, superimposed dead, live, wind…, each with an optional `selfWeight` multiplier) and forms every combination in `model.combinations` by superposition. The loads are flat top-level lists, `model.nodalLoads` and `model.memberLoads` (uniform and point loads in local or global directions), each load tagged with its `loadCase`, so large models stay readable. A combination is a list of factored terms `{ case, factor }` or `{ combination, factor }`; factors are entered by the user, and nested combinations are expanded. Supports end releases and fixed or spring supports. The stiffness matrix is factorised once for all cases. Returns `cases` and `combinations` keyed by id — each with displacements, reactions, member end forces, member diagrams along each member (forces `N`, `V2`, `V3`, `T`, `M2`, `M3` and deflections `u1`–`u3` local / `ux`–`uz` global, ready for plotting) and an equilibrium check — and an `envelope` of max/min over the combinations with the governing combination. Combination diagrams are rebuilt exactly, not summed from case extremes. The stiffness is stored in skyline (banded) form with nodes in reverse Cuthill–McKee order, so a building of ~850 nodes runs in about 1.5 s. Model and result are plain JSON, so it runs in a Web Worker. Invalid models, load cases or combinations and mechanisms throw `FrameAnalysisError` (codes 301–314) with `details` locating the problem.
+- **`createFrameAnalysis(model, options?)`** — Same analysis, keeping the solution: returns `{ result, memberDiagram(resultId, memberId) }` so full member diagrams can be computed on demand. Combine with `options.diagrams: "extremes"`, which keeps diagram extremes (and the envelope) but drops the station arrays, for results about 4× smaller on large models.
+- **`validateFrameModel(model)`** — Checks a model without analysing it and returns every problem, each with `details` (`nodeId`, `memberId`, `loadCaseId`, `combinationId`, `field`, `dof`) for highlighting in a UI. `analyzeFrame` runs it first and throws the first problem as a `FrameAnalysisError` whose `issues` lists all of them; non-finite numbers, negative springs and unknown option values are rejected (314).
+- **`memberDemandEnvelope(result, memberId, options?)`** — Reduces a member's diagrams to `MuPositive`, `MuNegative`, `Vu` (optionally at distance `d` from the supports) and `Nu`, enveloped over all combinations (or the `combinations` / `cases` you select), with the `governing` combination of each, for the RC capacity functions.
+- **`rectBeamToSectionProperties(section, options?)`** (from `rc`) — Converts a rectangular RC section into `SectionProperties` (`E`, `G`, `A`, `I22`, `I33`, `J`, `unitWeight`) with the ACI 318-19 6.6.3.1.1 inertia modifiers (0.35 beams, 0.70 columns) and a unit weight for self-weight (default 24 kN/m³, common practice rather than an ACI value).
+- **`beam3dLocalStiffness(E, G, A, I22, I33, J, L)`** — The 12×12 local stiffness matrix exactly as in the reference "Complete Beam Stiffness Matrix". Its bending rotations R2 and R3 follow the opposite sign to the right-hand rule; **`beam3dLocalStiffnessRightHanded`** returns the right-handed form that `analyzeFrame` uses.
+- **`memberAxes(start, end, angle?)`** — The ETABS-style local axes of a member as a direction-cosine matrix.
+
 ### General Utilities
 
 - **`concreteBeta(fc_)`** — ACI 318 β₁ factor
@@ -147,6 +176,8 @@ pnpm run build
 node dist/index.js
 ```
 
+The build emits a CommonJS build in `dist/` (for `require`, with the `.d.ts` types) and an ES-module build in `dist/esm/` (for `import` and bundlers such as Vite); `package.json` `exports` routes each subpath to the right one, and `"sideEffects": false` lets bundlers drop unused code.
+
 ## Tests
 
 ```bash

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

@@ -0,0 +1,14 @@
+/** Poisson's ratio of concrete, for G = E / (2(1 + ν)). */
+export declare const CONCRETE_POISSON_RATIO = 0.2;
+/** ACI 318-19 Table 6.6.3.1.1(a): effective I of beams for elastic analysis at factored load. */
+export declare const BEAM_INERTIA_MODIFIER = 0.35;
+/** ACI 318-19 Table 6.6.3.1.1(a): effective I of columns for elastic analysis at factored load. */
+export declare const COLUMN_INERTIA_MODIFIER = 0.7;
+/** Unit weight of reinforced concrete in kN/m³ — common design practice, not an ACI 318-19 value. */
+export declare const CONCRETE_UNIT_WEIGHT = 24;
+/** A member is vertical when the horizontal projection of its unit axis is below this value. */
+export declare const VERTICAL_MEMBER_TOLERANCE = 0.000001;
+/** Smallest pivot, relative to its own diagonal term, accepted when factorising a stiffness matrix. */
+export declare const SINGULARITY_TOLERANCE = 1e-9;
+/** Relative global-equilibrium residual above which a warning is added. */
+export declare const EQUILIBRIUM_TOLERANCE = 0.000001;

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

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EQUILIBRIUM_TOLERANCE = exports.SINGULARITY_TOLERANCE = exports.VERTICAL_MEMBER_TOLERANCE = exports.CONCRETE_UNIT_WEIGHT = exports.COLUMN_INERTIA_MODIFIER = exports.BEAM_INERTIA_MODIFIER = exports.CONCRETE_POISSON_RATIO = void 0;
+/** Poisson's ratio of concrete, for G = E / (2(1 + ν)). */
+exports.CONCRETE_POISSON_RATIO = 0.2;
+/** ACI 318-19 Table 6.6.3.1.1(a): effective I of beams for elastic analysis at factored load. */
+exports.BEAM_INERTIA_MODIFIER = 0.35;
+/** ACI 318-19 Table 6.6.3.1.1(a): effective I of columns for elastic analysis at factored load. */
+exports.COLUMN_INERTIA_MODIFIER = 0.7;
+/** Unit weight of reinforced concrete in kN/m³ — common design practice, not an ACI 318-19 value. */
+exports.CONCRETE_UNIT_WEIGHT = 24;
+/** A member is vertical when the horizontal projection of its unit axis is below this value. */
+exports.VERTICAL_MEMBER_TOLERANCE = 1e-6;
+/** Smallest pivot, relative to its own diagonal term, accepted when factorising a stiffness matrix. */
+exports.SINGULARITY_TOLERANCE = 1e-9;
+/** Relative global-equilibrium residual above which a warning is added. */
+exports.EQUILIBRIUM_TOLERANCE = 1e-6;
+//# sourceMappingURL=frame.constant.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frame.constant.js","sourceRoot":"","sources":["../../../src/core/constants/frame.constant.ts"],"names":[],"mappings":";;;AAAA,2DAA2D;AAC9C,QAAA,sBAAsB,GAAG,GAAG,CAAC;AAE1C,iGAAiG;AACpF,QAAA,qBAAqB,GAAG,IAAI,CAAC;AAE1C,mGAAmG;AACtF,QAAA,uBAAuB,GAAG,GAAG,CAAC;AAE3C,qGAAqG;AACxF,QAAA,oBAAoB,GAAG,EAAE,CAAC;AAEvC,gGAAgG;AACnF,QAAA,yBAAyB,GAAG,IAAI,CAAC;AAE9C,uGAAuG;AAC1F,QAAA,qBAAqB,GAAG,IAAI,CAAC;AAE1C,2EAA2E;AAC9D,QAAA,qBAAqB,GAAG,IAAI,CAAC"}

package/dist/core/errors/frame-analysis.error.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Where a frame-analysis problem is, so a UI can highlight it. Only the fields that apply are set.
+ */
+export interface FrameErrorDetails {
+    nodeId?: string | number;
+    memberId?: string | number;
+    loadCaseId?: string;
+    combinationId?: string;
+    /** The offending input field, e.g. "x", "fz", "w", "direction", "uz". */
+    field?: string;
+    /** For an unstable structure: a degree of freedom involved in the mechanism. */
+    dof?: "ux" | "uy" | "uz" | "rx" | "ry" | "rz";
+}
+export declare class FrameAnalysisError extends Error {
+    code: number;
+    message: string;
+    details: FrameErrorDetails;
+    /** Every problem found when the model was validated; this error is the first of them. */
+    issues: FrameModelIssue[];
+    constructor(std?: FrameAnalysisErrorType, details?: FrameErrorDetails, issues?: FrameModelIssue[]);
+}
+/** One problem found in a frame model, as returned by `validateFrameModel`. */
+export interface FrameModelIssue {
+    code: number;
+    message: string;
+    details: FrameErrorDetails;
+}
+type FrameAnalysisErrorType = {
+    code: number;
+    message: string;
+};
+export declare const FrameErrors: Record<string, FrameAnalysisErrorType>;
+export {};

package/dist/core/errors/frame-analysis.error.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrameErrors = exports.FrameAnalysisError = void 0;
+class FrameAnalysisError extends Error {
+    constructor(std = { code: 0, message: "Unknown error" }, details = {}, issues) {
+        super(std.message);
+        this.code = std.code;
+        this.message = std.message;
+        this.details = details;
+        this.issues = issues ?? [{ code: std.code, message: std.message, details }];
+        Object.setPrototypeOf(this, FrameAnalysisError.prototype);
+    }
+}
+exports.FrameAnalysisError = FrameAnalysisError;
+exports.FrameErrors = {
+    // 3XX : Frame analysis errors
+    ZERO_LENGTH_MEMBER: {
+        code: 301,
+        message: "A member's start and end nodes coincide; the member has zero length.",
+    },
+    UNKNOWN_NODE_REFERENCE: {
+        code: 302,
+        message: "A member, restraint or load refers to a node or member id that is not in the model.",
+    },
+    DUPLICATE_ID: {
+        code: 303,
+        message: "Node ids, member ids and restrained node ids must each be unique, and load case and combination ids must be unique across both lists.",
+    },
+    STRUCTURE_UNSTABLE: {
+        code: 304,
+        message: "The restrained structure is unstable (singular stiffness matrix); add supports or members to prevent a mechanism.",
+    },
+    INVALID_SECTION_PROPERTIES: {
+        code: 305,
+        message: "Member section properties E, G, A, I22, I33 and J must all be positive, and unitWeight, when given, must not be negative.",
+    },
+    NO_RESTRAINTS: {
+        code: 306,
+        message: "The model has no restrained degrees of freedom.",
+    },
+    INVALID_RELEASE: {
+        code: 307,
+        message: "The end releases on a member make it a mechanism (rigid-body motion within the member).",
+    },
+    LOAD_OUTSIDE_MEMBER: {
+        code: 308,
+        message: "A member load lies outside the member, or its start is not before its end.",
+    },
+    UNKNOWN_LOAD_CASE: {
+        code: 309,
+        message: "A load or a load combination term refers to a load case or combination that is not in the model, or a term names neither.",
+    },
+    CIRCULAR_COMBINATION: {
+        code: 310,
+        message: "Load combinations reference each other in a loop.",
+    },
+    INVALID_LOAD_FACTOR: {
+        code: 311,
+        message: "A combination factor or self-weight multiplier is not a finite number, or a load combination has no terms.",
+    },
+    NO_LOAD_CASES: {
+        code: 312,
+        message: "The model has no load cases; define at least one in loadCases.",
+    },
+    MISSING_UNIT_WEIGHT: {
+        code: 313,
+        message: "A load case requests self-weight but a member section has no unitWeight; set unitWeight (0 for a weightless member).",
+    },
+    INVALID_INPUT_VALUE: {
+        code: 314,
+        message: "An input value is invalid: a number that is not finite (NaN, Infinity or not a number), a negative spring stiffness, or a value outside its allowed options.",
+    },
+};
+//# sourceMappingURL=frame-analysis.error.js.map

package/dist/core/errors/frame-analysis.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-analysis.error.js","sourceRoot":"","sources":["../../../src/core/errors/frame-analysis.error.ts"],"names":[],"mappings":";;;AAcA,MAAa,kBAAmB,SAAQ,KAAK;IAO3C,YACE,MAA8B,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,EACnE,UAA6B,EAAE,EAC/B,MAA0B;QAE1B,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,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QAC5E,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC;CACF;AAnBD,gDAmBC;AAcY,QAAA,WAAW,GAA2C;IACjE,8BAA8B;IAC9B,kBAAkB,EAAE;QAClB,IAAI,EAAE,GAAG;QACT,OAAO,EAAE,sEAAsE;KAChF;IACD,sBAAsB,EAAE;QACtB,IAAI,EAAE,GAAG;QACT,OAAO,EAAE,qFAAqF;KAC/F;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,GAAG;QACT,OAAO,EACL,uIAAuI;KAC1I;IACD,kBAAkB,EAAE;QAClB,IAAI,EAAE,GAAG;QACT,OAAO,EACL,mHAAmH;KACtH;IACD,0BAA0B,EAAE;QAC1B,IAAI,EAAE,GAAG;QACT,OAAO,EACL,2HAA2H;KAC9H;IACD,aAAa,EAAE;QACb,IAAI,EAAE,GAAG;QACT,OAAO,EAAE,iDAAiD;KAC3D;IACD,eAAe,EAAE;QACf,IAAI,EAAE,GAAG;QACT,OAAO,EACL,yFAAyF;KAC5F;IACD,mBAAmB,EAAE;QACnB,IAAI,EAAE,GAAG;QACT,OAAO,EAAE,4EAA4E;KACtF;IACD,iBAAiB,EAAE;QACjB,IAAI,EAAE,GAAG;QACT,OAAO,EACL,2HAA2H;KAC9H;IACD,oBAAoB,EAAE;QACpB,IAAI,EAAE,GAAG;QACT,OAAO,EAAE,mDAAmD;KAC7D;IACD,mBAAmB,EAAE;QACnB,IAAI,EAAE,GAAG;QACT,OAAO,EACL,4GAA4G;KAC/G;IACD,aAAa,EAAE;QACb,IAAI,EAAE,GAAG;QACT,OAAO,EAAE,gEAAgE;KAC1E;IACD,mBAAmB,EAAE;QACnB,IAAI,EAAE,GAAG;QACT,OAAO,EACL,sHAAsH;KACzH;IACD,mBAAmB,EAAE;QACnB,IAAI,EAAE,GAAG;QACT,OAAO,EACL,8JAA8J;KACjK;CACF,CAAC"}

package/dist/core/index.d.ts

@@ -2,7 +2,11 @@ export type { RectBeamSection, RectSinglyBeamSection, RectDoublyBeamSection, Rec
 export { isSinglyReinforced } from "./types/rc-beam.type";
 export type { SteelJacketedProps, SectionState, PlateShearFlowInput, BoltProps, PlateInterfaceBoltInput, SidePlateConfiguration, SidePlateAnchorage, SidePlateShearProps, } from "./types/plate-jacketing.type";
 export { hasTopPlate, hasBottomPlate, hasSidePlate } from "./types/plate-jacketing.type";
+export type { SectionProperties } from "./types/section-properties.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, SHEAR_STRENGTH_REDUCTION_FACTOR, ANCHOR_SHEAR_STRENGTH_REDUCTION_FACTOR, MAX_PLATE_BOLT_SPACING, PLATE_SHEAR_YIELD_COEFFICIENT, SIDE_PLATE_EFFECTIVE_STRAIN_LIMIT, SIDE_PLATE_REDUCTION_FACTOR_PSI, } from "./constants/rc.constant";
+export { CONCRETE_POISSON_RATIO, CONCRETE_UNIT_WEIGHT, BEAM_INERTIA_MODIFIER, COLUMN_INERTIA_MODIFIER, VERTICAL_MEMBER_TOLERANCE, SINGULARITY_TOLERANCE, EQUILIBRIUM_TOLERANCE, } from "./constants/frame.constant";
 export { RCDesignError, Errors } from "./errors/rc-design.error";
+export { FrameAnalysisError, FrameErrors } from "./errors/frame-analysis.error";
+export type { FrameErrorDetails, FrameModelIssue } from "./errors/frame-analysis.error";

package/dist/core/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Errors = exports.RCDesignError = exports.SIDE_PLATE_REDUCTION_FACTOR_PSI = exports.SIDE_PLATE_EFFECTIVE_STRAIN_LIMIT = exports.PLATE_SHEAR_YIELD_COEFFICIENT = 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.hasSidePlate = exports.hasBottomPlate = exports.hasTopPlate = exports.isSinglyReinforced = void 0;
+exports.FrameErrors = exports.FrameAnalysisError = exports.Errors = exports.RCDesignError = exports.EQUILIBRIUM_TOLERANCE = exports.SINGULARITY_TOLERANCE = exports.VERTICAL_MEMBER_TOLERANCE = exports.COLUMN_INERTIA_MODIFIER = exports.BEAM_INERTIA_MODIFIER = exports.CONCRETE_UNIT_WEIGHT = exports.CONCRETE_POISSON_RATIO = exports.SIDE_PLATE_REDUCTION_FACTOR_PSI = exports.SIDE_PLATE_EFFECTIVE_STRAIN_LIMIT = exports.PLATE_SHEAR_YIELD_COEFFICIENT = 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.hasSidePlate = 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");
@@ -17,8 +17,19 @@ Object.defineProperty(exports, "MAX_PLATE_BOLT_SPACING", { enumerable: true, get
 Object.defineProperty(exports, "PLATE_SHEAR_YIELD_COEFFICIENT", { enumerable: true, get: function () { return rc_constant_1.PLATE_SHEAR_YIELD_COEFFICIENT; } });
 Object.defineProperty(exports, "SIDE_PLATE_EFFECTIVE_STRAIN_LIMIT", { enumerable: true, get: function () { return rc_constant_1.SIDE_PLATE_EFFECTIVE_STRAIN_LIMIT; } });
 Object.defineProperty(exports, "SIDE_PLATE_REDUCTION_FACTOR_PSI", { enumerable: true, get: function () { return rc_constant_1.SIDE_PLATE_REDUCTION_FACTOR_PSI; } });
+var frame_constant_1 = require("./constants/frame.constant");
+Object.defineProperty(exports, "CONCRETE_POISSON_RATIO", { enumerable: true, get: function () { return frame_constant_1.CONCRETE_POISSON_RATIO; } });
+Object.defineProperty(exports, "CONCRETE_UNIT_WEIGHT", { enumerable: true, get: function () { return frame_constant_1.CONCRETE_UNIT_WEIGHT; } });
+Object.defineProperty(exports, "BEAM_INERTIA_MODIFIER", { enumerable: true, get: function () { return frame_constant_1.BEAM_INERTIA_MODIFIER; } });
+Object.defineProperty(exports, "COLUMN_INERTIA_MODIFIER", { enumerable: true, get: function () { return frame_constant_1.COLUMN_INERTIA_MODIFIER; } });
+Object.defineProperty(exports, "VERTICAL_MEMBER_TOLERANCE", { enumerable: true, get: function () { return frame_constant_1.VERTICAL_MEMBER_TOLERANCE; } });
+Object.defineProperty(exports, "SINGULARITY_TOLERANCE", { enumerable: true, get: function () { return frame_constant_1.SINGULARITY_TOLERANCE; } });
+Object.defineProperty(exports, "EQUILIBRIUM_TOLERANCE", { enumerable: true, get: function () { return frame_constant_1.EQUILIBRIUM_TOLERANCE; } });
 // 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; } });
 Object.defineProperty(exports, "Errors", { enumerable: true, get: function () { return rc_design_error_1.Errors; } });
+var frame_analysis_error_1 = require("./errors/frame-analysis.error");
+Object.defineProperty(exports, "FrameAnalysisError", { enumerable: true, get: function () { return frame_analysis_error_1.FrameAnalysisError; } });
+Object.defineProperty(exports, "FrameErrors", { enumerable: true, get: function () { return frame_analysis_error_1.FrameErrors; } });
 //# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";;;AAWA,qDAA0D;AAAjD,kHAAA,kBAAkB,OAAA;AAW3B,qEAAyF;AAAhF,mHAAA,WAAW,OAAA;AAAE,sHAAA,cAAc,OAAA;AAAE,oHAAA,YAAY,OAAA;AAIlD,YAAY;AACZ,uDASiC;AAR/B,iIAAA,kCAAkC,OAAA;AAClC,uHAAA,wBAAwB,OAAA;AACxB,8HAAA,+BAA+B,OAAA;AAC/B,qIAAA,sCAAsC,OAAA;AACtC,qHAAA,sBAAsB,OAAA;AACtB,4HAAA,6BAA6B,OAAA;AAC7B,gIAAA,iCAAiC,OAAA;AACjC,8HAAA,+BAA+B,OAAA;AAGjC,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;AAW3B,qEAAyF;AAAhF,mHAAA,WAAW,OAAA;AAAE,sHAAA,cAAc,OAAA;AAAE,oHAAA,YAAY,OAAA;AAKlD,YAAY;AACZ,uDASiC;AAR/B,iIAAA,kCAAkC,OAAA;AAClC,uHAAA,wBAAwB,OAAA;AACxB,8HAAA,+BAA+B,OAAA;AAC/B,qIAAA,sCAAsC,OAAA;AACtC,qHAAA,sBAAsB,OAAA;AACtB,4HAAA,6BAA6B,OAAA;AAC7B,gIAAA,iCAAiC,OAAA;AACjC,8HAAA,+BAA+B,OAAA;AAGjC,6DAQoC;AAPlC,wHAAA,sBAAsB,OAAA;AACtB,sHAAA,oBAAoB,OAAA;AACpB,uHAAA,qBAAqB,OAAA;AACrB,yHAAA,uBAAuB,OAAA;AACvB,2HAAA,yBAAyB,OAAA;AACzB,uHAAA,qBAAqB,OAAA;AACrB,uHAAA,qBAAqB,OAAA;AAGvB,SAAS;AACT,4DAAiE;AAAxD,gHAAA,aAAa,OAAA;AAAE,yGAAA,MAAM,OAAA;AAC9B,sEAAgF;AAAvE,0HAAA,kBAAkB,OAAA;AAAE,mHAAA,WAAW,OAAA"}

package/dist/core/types/section-properties.type.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Prismatic member properties for frame analysis, using ETABS-style local axes:
+ * local 1 runs along the member, local 2 and 3 are the transverse axes.
+ */
+export interface SectionProperties {
+    E: number;
+    G: number;
+    A: number;
+    I22: number;
+    I33: number;
+    J: number;
+    unitWeight?: number;
+}

package/dist/core/types/section-properties.type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=section-properties.type.js.map

package/dist/core/types/section-properties.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-properties.type.js","sourceRoot":"","sources":["../../../src/core/types/section-properties.type.ts"],"names":[],"mappings":""}

package/dist/esm/core/constants/frame.constant.js

@@ -0,0 +1,15 @@
+/** Poisson's ratio of concrete, for G = E / (2(1 + ν)). */
+export const CONCRETE_POISSON_RATIO = 0.2;
+/** ACI 318-19 Table 6.6.3.1.1(a): effective I of beams for elastic analysis at factored load. */
+export const BEAM_INERTIA_MODIFIER = 0.35;
+/** ACI 318-19 Table 6.6.3.1.1(a): effective I of columns for elastic analysis at factored load. */
+export const COLUMN_INERTIA_MODIFIER = 0.7;
+/** Unit weight of reinforced concrete in kN/m³ — common design practice, not an ACI 318-19 value. */
+export const CONCRETE_UNIT_WEIGHT = 24;
+/** A member is vertical when the horizontal projection of its unit axis is below this value. */
+export const VERTICAL_MEMBER_TOLERANCE = 1e-6;
+/** Smallest pivot, relative to its own diagonal term, accepted when factorising a stiffness matrix. */
+export const SINGULARITY_TOLERANCE = 1e-9;
+/** Relative global-equilibrium residual above which a warning is added. */
+export const EQUILIBRIUM_TOLERANCE = 1e-6;
+//# sourceMappingURL=frame.constant.js.map

package/dist/esm/core/constants/frame.constant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.constant.js","sourceRoot":"","sources":["../../../../src/core/constants/frame.constant.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAE1C,iGAAiG;AACjG,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAE1C,mGAAmG;AACnG,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAE3C,qGAAqG;AACrG,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEvC,gGAAgG;AAChG,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAC;AAE9C,uGAAuG;AACvG,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAE1C,2EAA2E;AAC3E,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC"}

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

@@ -0,0 +1,63 @@
+export const FLEXURAL_STRENGTH_REDUCTION_FACTOR = 0.9;
+export const 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
+export const DEFAULT_BEAM_COVER = 40; // mm, clear cover to stirrup
+export const DEFAULT_STIRRUP_DIAMETER = 10; // mm
+export const 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
+export const MIN_BAR_CLEAR_SPACING = 25; // mm
+export const AGGREGATE_SPACING_FACTOR = 4 / 3;
+// ACI 318-19 25.2.2: min clear distance between layers
+export const MIN_LAYER_CLEAR_SPACING = 25; // mm
+// ACI 318-19 21.2.1: strength reduction factor for shear
+export const 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
+export const 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
+export const SQRT_FC_SHEAR_LIMIT = 8.3; // MPa
+// ACI 318-19 22.5.1.2: Vs shall not exceed 0.66 * sqrt(fc') * bw * d
+export const MAX_VS_COEFFICIENT = 0.66;
+// ACI 318-19 9.7.6.2.2: spacing threshold at which the tighter max-spacing limit applies
+export const 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
+export const MAX_STIRRUP_SPACING_LOW_VS = 600; // mm
+export const 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
+export const MAX_STIRRUP_SPACING_HIGH_VS = 300; // mm
+export const 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)
+export const MIN_AV_SQRT_FC_COEFFICIENT = 0.062;
+export const MIN_AV_ABSOLUTE_COEFFICIENT = 0.35;
+// ACI 318-19 Table 17.5.3: strength reduction factor for anchor steel in shear
+export const ANCHOR_SHEAR_STRENGTH_REDUCTION_FACTOR = 0.65;
+// ACI 318-19 17.7.1.2b: Vsa = 0.6 * Ase,V * futa
+export const ANCHOR_STEEL_SHEAR_COEFFICIENT = 0.6;
+// ACI 318-19 17.6.1.2: futa shall not exceed min(1.9 * fya, 860 MPa)
+export const ANCHOR_FUTA_FYA_FACTOR = 1.9;
+export const MAX_ANCHOR_FUTA = 860; // MPa
+// ACI 318-19 17.9.2: min center-to-center spacing of cast-in anchors = 4 * da
+export const MIN_ANCHOR_SPACING_DIAMETER_FACTOR = 4;
+// Default elastic modulus of structural steel plate, used when the plate props omit Es
+export const DEFAULT_PLATE_ELASTIC_MODULUS = 200000; // MPa
+// AISC 360 G2.1 / von Mises: shear yield stress of a steel web = 0.6 * Fy
+export const PLATE_SHEAR_YIELD_COEFFICIENT = 0.6;
+// AISC 360 G2.1(a): a web of slenderness h/tw <= 2.24*sqrt(E/Fy) reaches shear
+// yielding before shear buckling
+export const PLATE_SHEAR_SLENDERNESS_COEFFICIENT = 2.24; // * sqrt(Es / fy)
+// ACI 440.2R-17, 11.4: effective strain in bonded shear reinforcement is capped
+// to preserve aggregate interlock in the concrete. Subsection unverified — see the
+// TODO in strengthening/rc-beam-side-plate-shear.ts.
+export const SIDE_PLATE_EFFECTIVE_STRAIN_LIMIT = 0.004;
+// ACI 440.2R-17, 11.4: additional reduction factor psi_f for two-sided bonded
+// shear strengthening (not fully wrapped). Subsection unverified — see the TODO in
+// strengthening/rc-beam-side-plate-shear.ts.
+export const SIDE_PLATE_REDUCTION_FACTOR_PSI = 0.85;
+// Both faces of the web plated, unless the caller says otherwise
+export const DEFAULT_SIDE_PLATE_SIDES = 2;
+// Vertical strips, unless the caller gives an inclination
+export const DEFAULT_SIDE_PLATE_ANGLE = 90; // degrees from the beam axis
+// Practical detailing limit on bolt pitch along a bonded strengthening plate,
+// so the plate is restrained against local buckling / peeling between fasteners
+export const MAX_PLATE_BOLT_SPACING = 300; // mm
+//# sourceMappingURL=rc.constant.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rc.constant.js","sourceRoot":"","sources":["../../../../src/core/constants/rc.constant.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kCAAkC,GAAG,GAAG,CAAC;AACtD,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,CAAC;AAE9C,qGAAqG;AACrG,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC,CAAC,6BAA6B;AACnE,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC,CAAC,KAAK;AACjD,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAC,CAAC,iCAAiC;AAE/E,wEAAwE;AACxE,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC,CAAC,KAAK;AAC9C,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,GAAG,CAAC,CAAC;AAE9C,uDAAuD;AACvD,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC,CAAC,KAAK;AAEhD,yDAAyD;AACzD,MAAM,CAAC,MAAM,+BAA+B,GAAG,IAAI,CAAC;AAEpD,kFAAkF;AAClF,MAAM,CAAC,MAAM,6BAA6B,GAAG,IAAI,CAAC;AAElD,gFAAgF;AAChF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC,CAAC,MAAM;AAE9C,qEAAqE;AACrE,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEvC,yFAAyF;AACzF,MAAM,CAAC,MAAM,gCAAgC,GAAG,IAAI,CAAC,CAAC,uBAAuB;AAE7E,6EAA6E;AAC7E,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC,CAAC,KAAK;AACpD,MAAM,CAAC,MAAM,uCAAuC,GAAG,GAAG,CAAC,CAAC,MAAM;AAElE,4EAA4E;AAC5E,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAC,CAAC,KAAK;AACrD,MAAM,CAAC,MAAM,wCAAwC,GAAG,IAAI,CAAC,CAAC,MAAM;AAEpE,0FAA0F;AAC1F,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,CAAC;AAChD,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,CAAC;AAEhD,+EAA+E;AAC/E,MAAM,CAAC,MAAM,sCAAsC,GAAG,IAAI,CAAC;AAE3D,iDAAiD;AACjD,MAAM,CAAC,MAAM,8BAA8B,GAAG,GAAG,CAAC;AAElD,qEAAqE;AACrE,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAC1C,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC,CAAC,MAAM;AAE1C,8EAA8E;AAC9E,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC;AAEpD,uFAAuF;AACvF,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC,CAAC,MAAM;AAE3D,0EAA0E;AAC1E,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAG,CAAC;AAEjD,+EAA+E;AAC/E,iCAAiC;AACjC,MAAM,CAAC,MAAM,mCAAmC,GAAG,IAAI,CAAC,CAAC,kBAAkB;AAE3E,gFAAgF;AAChF,mFAAmF;AACnF,qDAAqD;AACrD,MAAM,CAAC,MAAM,iCAAiC,GAAG,KAAK,CAAC;AAEvD,8EAA8E;AAC9E,mFAAmF;AACnF,6CAA6C;AAC7C,MAAM,CAAC,MAAM,+BAA+B,GAAG,IAAI,CAAC;AAEpD,iEAAiE;AACjE,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAE1C,0DAA0D;AAC1D,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC,CAAC,6BAA6B;AAEzE,8EAA8E;AAC9E,gFAAgF;AAChF,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC,CAAC,KAAK"}

package/dist/esm/core/errors/frame-analysis.error.js

@@ -0,0 +1,70 @@
+export class FrameAnalysisError extends Error {
+    constructor(std = { code: 0, message: "Unknown error" }, details = {}, issues) {
+        super(std.message);
+        this.code = std.code;
+        this.message = std.message;
+        this.details = details;
+        this.issues = issues ?? [{ code: std.code, message: std.message, details }];
+        Object.setPrototypeOf(this, FrameAnalysisError.prototype);
+    }
+}
+export const FrameErrors = {
+    // 3XX : Frame analysis errors
+    ZERO_LENGTH_MEMBER: {
+        code: 301,
+        message: "A member's start and end nodes coincide; the member has zero length.",
+    },
+    UNKNOWN_NODE_REFERENCE: {
+        code: 302,
+        message: "A member, restraint or load refers to a node or member id that is not in the model.",
+    },
+    DUPLICATE_ID: {
+        code: 303,
+        message: "Node ids, member ids and restrained node ids must each be unique, and load case and combination ids must be unique across both lists.",
+    },
+    STRUCTURE_UNSTABLE: {
+        code: 304,
+        message: "The restrained structure is unstable (singular stiffness matrix); add supports or members to prevent a mechanism.",
+    },
+    INVALID_SECTION_PROPERTIES: {
+        code: 305,
+        message: "Member section properties E, G, A, I22, I33 and J must all be positive, and unitWeight, when given, must not be negative.",
+    },
+    NO_RESTRAINTS: {
+        code: 306,
+        message: "The model has no restrained degrees of freedom.",
+    },
+    INVALID_RELEASE: {
+        code: 307,
+        message: "The end releases on a member make it a mechanism (rigid-body motion within the member).",
+    },
+    LOAD_OUTSIDE_MEMBER: {
+        code: 308,
+        message: "A member load lies outside the member, or its start is not before its end.",
+    },
+    UNKNOWN_LOAD_CASE: {
+        code: 309,
+        message: "A load or a load combination term refers to a load case or combination that is not in the model, or a term names neither.",
+    },
+    CIRCULAR_COMBINATION: {
+        code: 310,
+        message: "Load combinations reference each other in a loop.",
+    },
+    INVALID_LOAD_FACTOR: {
+        code: 311,
+        message: "A combination factor or self-weight multiplier is not a finite number, or a load combination has no terms.",
+    },
+    NO_LOAD_CASES: {
+        code: 312,
+        message: "The model has no load cases; define at least one in loadCases.",
+    },
+    MISSING_UNIT_WEIGHT: {
+        code: 313,
+        message: "A load case requests self-weight but a member section has no unitWeight; set unitWeight (0 for a weightless member).",
+    },
+    INVALID_INPUT_VALUE: {
+        code: 314,
+        message: "An input value is invalid: a number that is not finite (NaN, Infinity or not a number), a negative spring stiffness, or a value outside its allowed options.",
+    },
+};
+//# sourceMappingURL=frame-analysis.error.js.map

package/dist/esm/core/errors/frame-analysis.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-analysis.error.js","sourceRoot":"","sources":["../../../../src/core/errors/frame-analysis.error.ts"],"names":[],"mappings":"AAcA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAO3C,YACE,MAA8B,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,EACnE,UAA6B,EAAE,EAC/B,MAA0B;QAE1B,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,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QAC5E,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC;CACF;AAcD,MAAM,CAAC,MAAM,WAAW,GAA2C;IACjE,8BAA8B;IAC9B,kBAAkB,EAAE;QAClB,IAAI,EAAE,GAAG;QACT,OAAO,EAAE,sEAAsE;KAChF;IACD,sBAAsB,EAAE;QACtB,IAAI,EAAE,GAAG;QACT,OAAO,EAAE,qFAAqF;KAC/F;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,GAAG;QACT,OAAO,EACL,uIAAuI;KAC1I;IACD,kBAAkB,EAAE;QAClB,IAAI,EAAE,GAAG;QACT,OAAO,EACL,mHAAmH;KACtH;IACD,0BAA0B,EAAE;QAC1B,IAAI,EAAE,GAAG;QACT,OAAO,EACL,2HAA2H;KAC9H;IACD,aAAa,EAAE;QACb,IAAI,EAAE,GAAG;QACT,OAAO,EAAE,iDAAiD;KAC3D;IACD,eAAe,EAAE;QACf,IAAI,EAAE,GAAG;QACT,OAAO,EACL,yFAAyF;KAC5F;IACD,mBAAmB,EAAE;QACnB,IAAI,EAAE,GAAG;QACT,OAAO,EAAE,4EAA4E;KACtF;IACD,iBAAiB,EAAE;QACjB,IAAI,EAAE,GAAG;QACT,OAAO,EACL,2HAA2H;KAC9H;IACD,oBAAoB,EAAE;QACpB,IAAI,EAAE,GAAG;QACT,OAAO,EAAE,mDAAmD;KAC7D;IACD,mBAAmB,EAAE;QACnB,IAAI,EAAE,GAAG;QACT,OAAO,EACL,4GAA4G;KAC/G;IACD,aAAa,EAAE;QACb,IAAI,EAAE,GAAG;QACT,OAAO,EAAE,gEAAgE;KAC1E;IACD,mBAAmB,EAAE;QACnB,IAAI,EAAE,GAAG;QACT,OAAO,EACL,sHAAsH;KACzH;IACD,mBAAmB,EAAE;QACnB,IAAI,EAAE,GAAG;QACT,OAAO,EACL,8JAA8J;KACjK;CACF,CAAC"}

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

@@ -0,0 +1,64 @@
+export class RCDesignError extends Error {
+    constructor(std = { code: 0, message: "Unknown error" }) {
+        super(std.message);
+        this.code = std.code;
+        this.message = std.message;
+        Object.setPrototypeOf(this, RCDesignError.prototype);
+    }
+}
+export const Errors = {
+    // 1XX : RC Beam Design Errors
+    /**
+     * @deprecated Never thrown since 1.4.0. A section whose compression steel
+     * lies below the neutral axis is valid — that steel acts in tension and
+     * `rectBeamMomentCapacity` now returns a reduced Mn with a warning instead.
+     * Retained so existing `Errors.COMP_STEEL_DISTANCE_OVER_AC` references and
+     * `code === 101` checks keep compiling; safe to delete in the next major.
+     */
+    COMP_STEEL_DISTANCE_OVER_AC: {
+        code: 101,
+        message: "d' of compressive steel is greater than c, consider using singly reinforced section.",
+    },
+    TENSILE_STEEL_NOT_YIELDING: {
+        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.",
+    },
+    SIDE_PLATE_GEOMETRY_INVALID: {
+        code: 205,
+        message: "Inconsistent side plate geometry; thickness, engaged depth, fy and sides must be positive, the depth must fit within the section, and a stripped layout requires a positive width and spacing.",
+    },
+    STRENGTHENED_SHEAR_NO_HEADROOM: {
+        code: 206,
+        message: "Existing Vs already reaches 0.66*sqrt(fc')*bw*d (ACI318-19, 22.5.1.2); the web crushes before any added side plate force can be developed, so shear strengthening cannot be realised on this section.",
+    },
+};
+//# sourceMappingURL=rc-design.error.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rc-design.error.js","sourceRoot":"","sources":["../../../../src/core/errors/rc-design.error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,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;AAOD,MAAM,CAAC,MAAM,MAAM,GAAsC;IACvD,8BAA8B;IAE9B;;;;;;OAMG;IACH,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;IACD,2BAA2B,EAAE;QAC3B,IAAI,EAAE,GAAG;QACT,OAAO,EACL,gMAAgM;KACnM;IACD,8BAA8B,EAAE;QAC9B,IAAI,EAAE,GAAG;QACT,OAAO,EACL,uMAAuM;KAC1M;CACF,CAAC"}

package/dist/esm/core/index.js

@@ -0,0 +1,9 @@
+export { isSinglyReinforced } from "./types/rc-beam.type.js";
+export { hasTopPlate, hasBottomPlate, hasSidePlate } from "./types/plate-jacketing.type.js";
+// Constants
+export { FLEXURAL_STRENGTH_REDUCTION_FACTOR, CONCRETE_ULTIMATE_STRAIN, SHEAR_STRENGTH_REDUCTION_FACTOR, ANCHOR_SHEAR_STRENGTH_REDUCTION_FACTOR, MAX_PLATE_BOLT_SPACING, PLATE_SHEAR_YIELD_COEFFICIENT, SIDE_PLATE_EFFECTIVE_STRAIN_LIMIT, SIDE_PLATE_REDUCTION_FACTOR_PSI, } from "./constants/rc.constant.js";
+export { CONCRETE_POISSON_RATIO, CONCRETE_UNIT_WEIGHT, BEAM_INERTIA_MODIFIER, COLUMN_INERTIA_MODIFIER, VERTICAL_MEMBER_TOLERANCE, SINGULARITY_TOLERANCE, EQUILIBRIUM_TOLERANCE, } from "./constants/frame.constant.js";
+// Errors
+export { RCDesignError, Errors } from "./errors/rc-design.error.js";
+export { FrameAnalysisError, FrameErrors } from "./errors/frame-analysis.error.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAW1D,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAKzF,YAAY;AACZ,OAAO,EACL,kCAAkC,EAClC,wBAAwB,EACxB,+BAA+B,EAC/B,sCAAsC,EACtC,sBAAsB,EACtB,6BAA6B,EAC7B,iCAAiC,EACjC,+BAA+B,GAChC,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AAEpC,SAAS;AACT,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/esm/core/types/output-message.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=output-message.type.js.map

package/dist/esm/core/types/output-message.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-message.type.js","sourceRoot":"","sources":["../../../../src/core/types/output-message.type.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,18 @@
+/**
+ * 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 function hasTopPlate(props) {
+    return (props.topSteelWidth ?? 0) > 0 && (props.topSteelThickness ?? 0) > 0;
+}
+export function hasBottomPlate(props) {
+    return (props.bottomSteelWidth ?? 0) > 0 && (props.bottomSteelThickness ?? 0) > 0;
+}
+/**
+ * A side plate counts as present only when both its thickness and engaged depth
+ * are positive.
+ */
+export function hasSidePlate(props) {
+    return props.thickness > 0 && props.depth > 0;
+}
+//# sourceMappingURL=plate-jacketing.type.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plate-jacketing.type.js","sourceRoot":"","sources":["../../../../src/core/types/plate-jacketing.type.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,MAAM,UAAU,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,MAAM,UAAU,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;AA6DD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAA0B;IACrD,OAAO,KAAK,CAAC,SAAS,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;AAChD,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * A section counts as singly reinforced when it carries no compression steel.
+ *
+ * `d_` is deliberately not sign-checked: it is measured from the extreme
+ * concrete compression fibre, so compression steel above that face — a steel
+ * plate bonded to the top of the beam — legitimately has `d_ <= 0`.
+ */
+export function isSinglyReinforced(section) {
+    return !("As_" in section) || !("d_" in section) || section.As_ <= 0;
+}
+//# sourceMappingURL=rc-beam.type.js.map