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

package/README.md

@@ -2,7 +2,25 @@
 
 **📖 [API Reference — theerapat-s28.github.io/ts-structural-eng](https://theerapat-s28.github.io/ts-structural-eng/)**
 
-A TypeScript library of structural-engineering helper functions and beam design utilities. Designed to be copied and reused across TypeScript frameworks.
+A headless structural analysis and design engine for TypeScript: 3D frame analysis by the direct stiffness method, reinforced-concrete beam design per ACI 318-19, and strengthening methods. It is built to be installed by front-end applications as their calculation core.
+
+## Scope: an engine, not an application
+
+The library does the structural engineering and nothing else. A front-end application installs it, builds a model from its own UI, calls the engine, and draws the results.
+
+| The engine (this package)                                                   | The front-end application                                     |
+| --------------------------------------------------------------------------- | ------------------------------------------------------------- |
+| Model validation with located errors (`details` name the node, member, field…) | Input forms, drawing tools, highlighting the reported problems |
+| Analysis: load cases, combinations, envelopes, member diagrams              | Rendering the model, deformed shapes and diagrams             |
+| Design checks with code-clause warnings and `RCDesignError` / `FrameAnalysisError` | Display of results, member colours, view and display options |
+| Typed inputs and results in SI units                                         | Unit display, project files, undo history, other UI state     |
+
+What this means in practice:
+
+- **No UI, no rendering, no presentation data.** Inputs and results carry structural quantities only; no colours, labels or view state.
+- **Plain JSON in, plain JSON out.** Models and results are serialisable, so the engine runs in a Web Worker, in the browser or in Node.
+- **No runtime dependencies** and no DOM or Node-only APIs.
+- **ESM and CommonJS builds** with `.d.ts` types, tree-shakeable (`"sideEffects": false`), split into subpath exports (`/fea`, `/rc`, `/strengthening`, `/core`, `/utils`).
 
 ## Documentation
 
@@ -11,6 +29,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.
 
@@ -18,7 +37,7 @@ The pages are served from [`html-docs/`](https://github.com/theerapat-s28/ts-str
 
 - Package: `@theerapat-s28/ts-structural-eng-tools`
 - Entry: `src/index.ts`
-- Build output: `dist/` (JS + `.d.ts` files)
+- Build output: `dist/` (CommonJS + `.d.ts` files) and `dist/esm/` (ES modules)
 
 ## Prerequisites
 
@@ -61,32 +80,48 @@ 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
+│       ├── area/             # Null areas: geometry, edge-member chains, area-load distribution
+│       ├── 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. null areas, load cases, combinations) and result types
 ├── core/                 # Shared infrastructure
 │   ├── index.ts
-│   ├── constants/        # RC design constants (ACI 318)
+│   ├── constants/        # RC design constants (ACI 318) and frame-analysis tolerances
 │   ├── errors/           # Custom error classes
 │   └── types/            # Shared type definitions
 └── 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 +134,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 +170,19 @@ 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, trapezoidal and point loads in local or global directions, and torques about the member axis), each load tagged with its `loadCase`, so large models stay readable. Area loads (`model.areaLoads`, kN/m²) on null areas (`model.areas`) are first distributed to the members along each area's edges — see `distributeAreaLoads`. 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–317) 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`, `areaId`, `edge`, `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).
+- **`distributeAreaLoads(model)`** — Returns `{ memberLoads, warnings }`: the member loads that the model's null areas send to their edge members, exactly what `analyzeFrame` adds, for checking or previewing. A null area (`{ id, nodeIds, distribution, supportEdges? }`) has 3 or 4 nodes forming a planar convex polygon and adds no stiffness. `"twoWay"` sends each point to its nearest edge (the corner-bisector split, any convex shape); `"oneWay"` spans strips between the listed `supportEdges`, parallel to the unsupported edges, half to each end; `"cantilever"` (rectangles) puts `q·c` and a torque `q·c²/2` on its one support edge. Area loads (`{ loadCase, areaId, direction: "3" | "X" | "Y" | "Z", q }`) are per unit true area, `"3"` being the area's normal. Edges split by intermediate nodes are cut at them. Area problems throw 315 (geometry), 316 (an edge without members) or 317 (supports that do not fit the distribution).
+- **`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 +196,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,19 @@
+/** 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;
+/**
+ * Relative tolerance for null-area geometry (planarity, corners in line, parallel or square
+ * edges, nodes lying on an edge): distances are compared with this times the longest edge.
+ */
+export declare const AREA_GEOMETRY_TOLERANCE = 0.000001;

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

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AREA_GEOMETRY_TOLERANCE = 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;
+/**
+ * Relative tolerance for null-area geometry (planarity, corners in line, parallel or square
+ * edges, nodes lying on an edge): distances are compared with this times the longest edge.
+ */
+exports.AREA_GEOMETRY_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;AAE1C;;;GAGG;AACU,QAAA,uBAAuB,GAAG,IAAI,CAAC"}

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

@@ -0,0 +1,36 @@
+/**
+ * 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;
+    areaId?: string | number;
+    /** For an area: the edge index, edge i running from `nodeIds[i]` to `nodeIds[i + 1]`. */
+    edge?: 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,86 @@
+"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, area or load refers to a node, member or area id that is not in the model.",
+    },
+    DUPLICATE_ID: {
+        code: 303,
+        message: "Node ids, member ids, area 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.",
+    },
+    INVALID_AREA_GEOMETRY: {
+        code: 315,
+        message: "An area must have 3 or 4 distinct nodes forming a planar, convex polygon with no three corners in line; a cantilever area must be a rectangle.",
+    },
+    AREA_EDGE_UNSUPPORTED: {
+        code: 316,
+        message: "An area edge that carries load is not fully covered by members: every segment between the nodes along the edge needs a member.",
+    },
+    INVALID_AREA_DISTRIBUTION: {
+        code: 317,
+        message: "An area's supportEdges do not fit its distribution: two-way takes none; one-way needs at least one edge left unsupported, with every unsupported edge parallel to the others (the span direction); cantilever needs exactly one, and its loads may not act along that edge.",
+    },
+};
+//# 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":";;;AAiBA,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,EACL,iGAAiG;KACpG;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,GAAG;QACT,OAAO,EACL,iJAAiJ;KACpJ;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;IACD,qBAAqB,EAAE;QACrB,IAAI,EAAE,GAAG;QACT,OAAO,EACL,gJAAgJ;KACnJ;IACD,qBAAqB,EAAE;QACrB,IAAI,EAAE,GAAG;QACT,OAAO,EACL,gIAAgI;KACnI;IACD,yBAAyB,EAAE;QACzB,IAAI,EAAE,GAAG;QACT,OAAO,EACL,6QAA6Q;KAChR;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, AREA_GEOMETRY_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.AREA_GEOMETRY_TOLERANCE = 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,20 @@ 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; } });
+Object.defineProperty(exports, "AREA_GEOMETRY_TOLERANCE", { enumerable: true, get: function () { return frame_constant_1.AREA_GEOMETRY_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,6DASoC;AARlC,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;AACrB,yHAAA,uBAAuB,OAAA;AAGzB,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,20 @@
+/** 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;
+/**
+ * Relative tolerance for null-area geometry (planarity, corners in line, parallel or square
+ * edges, nodes lying on an edge): distances are compared with this times the longest edge.
+ */
+export const AREA_GEOMETRY_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;AAE1C;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,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,82 @@
+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, area or load refers to a node, member or area id that is not in the model.",
+    },
+    DUPLICATE_ID: {
+        code: 303,
+        message: "Node ids, member ids, area 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.",
+    },
+    INVALID_AREA_GEOMETRY: {
+        code: 315,
+        message: "An area must have 3 or 4 distinct nodes forming a planar, convex polygon with no three corners in line; a cantilever area must be a rectangle.",
+    },
+    AREA_EDGE_UNSUPPORTED: {
+        code: 316,
+        message: "An area edge that carries load is not fully covered by members: every segment between the nodes along the edge needs a member.",
+    },
+    INVALID_AREA_DISTRIBUTION: {
+        code: 317,
+        message: "An area's supportEdges do not fit its distribution: two-way takes none; one-way needs at least one edge left unsupported, with every unsupported edge parallel to the others (the span direction); cantilever needs exactly one, and its loads may not act along that edge.",
+    },
+};
+//# 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":"AAiBA,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,EACL,iGAAiG;KACpG;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,GAAG;QACT,OAAO,EACL,iJAAiJ;KACpJ;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;IACD,qBAAqB,EAAE;QACrB,IAAI,EAAE,GAAG;QACT,OAAO,EACL,gJAAgJ;KACnJ;IACD,qBAAqB,EAAE;QACrB,IAAI,EAAE,GAAG;QACT,OAAO,EACL,gIAAgI;KACnI;IACD,yBAAyB,EAAE;QACzB,IAAI,EAAE,GAAG;QACT,OAAO,EACL,6QAA6Q;KAChR;CACF,CAAC"}