@theerapat-s28/ts-structural-eng-tools 3.1.0 → 3.3.0

package/dist/fea/frame/validation/validate-members.d.ts

@@ -0,0 +1,30 @@
+import { type FeaModelIssue } from "../../../core/errors/fea.error";
+import type { FeaId, FeaNode } from "../../shared/types/model.type";
+import type { Member, MemberLoad } from "../types/model.type";
+/**
+ * Checks each member on its own: its end nodes, section, `angle`, `connectIntermediateNodes`
+ * and release values, a non-zero length, and end releases that leave it stable. Ends at nodes with invalid
+ * coordinates are not checked further; those are reported on the node.
+ *
+ * @param members - The model's members
+ * @param nodeById - Model nodes by id
+ * @param validNode - Ids of the nodes whose coordinates are valid
+ * @returns `issues` (codes 301, 302, 305, 307 and 314), in model order, with `memberId`, and the
+ *   length (mm) of every member whose geometry is valid
+ */
+export declare const validateMembers: (members: Member[], nodeById: Map<FeaId, FeaNode>, validNode: Set<FeaId>) => {
+    issues: FeaModelIssue[];
+    memberLength: Map<FeaId, number>;
+};
+/**
+ * Checks member loads: their load case and member, `type`, direction and `projected`, finite
+ * intensities and positions, and an extent that lies within the member.
+ *
+ * @param loads - The model's member loads
+ * @param members - The model's members
+ * @param memberLength - Length of each member whose geometry is valid (from `validateMembers`)
+ * @param caseIds - Ids of the model's load cases
+ * @returns Every problem found (codes 302, 308, 309 and 314), in model order, with `memberId`
+ *   and `loadCaseId`
+ */
+export declare const validateMemberLoads: (loads: MemberLoad[], members: Member[], memberLength: Map<FeaId, number>, caseIds: Set<string>) => FeaModelIssue[];

package/dist/fea/frame/validation/validate-members.js

@@ -0,0 +1,169 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateMemberLoads = exports.validateMembers = void 0;
+const fea_error_1 = require("../../../core/errors/fea.error");
+const issues_1 = require("../../shared/validation/issues");
+const beam_3d_stiffness_1 = require("../elements/beam-3d-stiffness");
+const end_releases_1 = require("../elements/end-releases");
+const static_condensation_1 = require("../elements/static-condensation");
+const SECTION_KEYS = ["E", "G", "A", "I22", "I33", "J"];
+const DIRECTIONS = new Set(["1", "2", "3", "X", "Y", "Z"]);
+const GLOBAL_DIRECTIONS = new Set(["X", "Y", "Z"]);
+/**
+ * Checks each member on its own: its end nodes, section, `angle`, `connectIntermediateNodes`
+ * and release values, a non-zero length, and end releases that leave it stable. Ends at nodes with invalid
+ * coordinates are not checked further; those are reported on the node.
+ *
+ * @param members - The model's members
+ * @param nodeById - Model nodes by id
+ * @param validNode - Ids of the nodes whose coordinates are valid
+ * @returns `issues` (codes 301, 302, 305, 307 and 314), in model order, with `memberId`, and the
+ *   length (mm) of every member whose geometry is valid
+ */
+const validateMembers = (members, nodeById, validNode) => {
+    const issues = [];
+    const add = (std, details = {}) => issues.push((0, issues_1.modelIssue)(std, details));
+    const memberLength = new Map(); // only for members whose geometry is valid
+    for (const member of members) {
+        const at = { memberId: member.id };
+        let geometryOk = true;
+        for (const field of ["startNodeId", "endNodeId"]) {
+            if (!nodeById.has(member[field])) {
+                add(fea_error_1.FeaErrors.UNKNOWN_NODE_REFERENCE, { ...at, field });
+                geometryOk = false;
+            }
+            else if (!validNode.has(member[field])) {
+                geometryOk = false; // reported on the node
+            }
+        }
+        const section = member.section ?? {};
+        let sectionOk = true;
+        for (const field of SECTION_KEYS) {
+            const v = section[field];
+            if (!(0, issues_1.isFiniteNumber)(v) || v <= 0) {
+                add(fea_error_1.FeaErrors.INVALID_SECTION_PROPERTIES, { ...at, field });
+                sectionOk = false;
+            }
+        }
+        if (section.unitWeight !== undefined &&
+            (!(0, issues_1.isFiniteNumber)(section.unitWeight) || section.unitWeight < 0)) {
+            add(fea_error_1.FeaErrors.INVALID_SECTION_PROPERTIES, { ...at, field: "unitWeight" });
+        }
+        if (member.angle !== undefined && !(0, issues_1.isFiniteNumber)(member.angle)) {
+            add(fea_error_1.FeaErrors.INVALID_INPUT_VALUE, { ...at, field: "angle" });
+        }
+        if (member.connectIntermediateNodes !== undefined &&
+            typeof member.connectIntermediateNodes !== "boolean") {
+            add(fea_error_1.FeaErrors.INVALID_INPUT_VALUE, { ...at, field: "connectIntermediateNodes" });
+        }
+        // each release value: true/false, or a spring stiffness ≥ 0 (0 = full release)
+        let releasesOk = true;
+        for (const end of ["start", "end"]) {
+            const release = member.releases?.[end];
+            if (release === undefined)
+                continue;
+            for (const key of end_releases_1.RELEASE_KEYS) {
+                const v = release[key];
+                if (v === undefined || typeof v === "boolean" || ((0, issues_1.isFiniteNumber)(v) && v >= 0))
+                    continue;
+                add(fea_error_1.FeaErrors.INVALID_INPUT_VALUE, { ...at, field: `releases.${end}.${key}` });
+                releasesOk = false;
+            }
+        }
+        if (!geometryOk)
+            continue;
+        const a = nodeById.get(member.startNodeId);
+        const b = nodeById.get(member.endNodeId);
+        const L = Math.hypot(b.x - a.x, b.y - a.y, b.z - a.z);
+        if (!(L > 0)) {
+            add(fea_error_1.FeaErrors.ZERO_LENGTH_MEMBER, at);
+            continue;
+        }
+        memberLength.set(member.id, L);
+        const releases = releasesOk ? (0, end_releases_1.memberEndReleases)(member.releases) : [];
+        if (sectionOk && releases.length > 0) {
+            const { E, G, A, I22, I33, J } = section;
+            try {
+                (0, static_condensation_1.condenseMember)((0, beam_3d_stiffness_1.beam3dLocalStiffnessRightHanded)(E, G, A, I22, I33, J, L), releases);
+            }
+            catch {
+                add(fea_error_1.FeaErrors.INVALID_RELEASE, at);
+            }
+        }
+    }
+    return { issues, memberLength };
+};
+exports.validateMembers = validateMembers;
+/**
+ * Checks member loads: their load case and member, `type`, direction and `projected`, finite
+ * intensities and positions, and an extent that lies within the member.
+ *
+ * @param loads - The model's member loads
+ * @param members - The model's members
+ * @param memberLength - Length of each member whose geometry is valid (from `validateMembers`)
+ * @param caseIds - Ids of the model's load cases
+ * @returns Every problem found (codes 302, 308, 309 and 314), in model order, with `memberId`
+ *   and `loadCaseId`
+ */
+const validateMemberLoads = (loads, members, memberLength, caseIds) => {
+    const issues = [];
+    const add = (std, details = {}) => issues.push((0, issues_1.modelIssue)(std, details));
+    for (const load of loads) {
+        const at = { loadCaseId: load.loadCase, memberId: load.memberId };
+        if (!caseIds.has(load.loadCase))
+            add(fea_error_1.FeaErrors.UNKNOWN_LOAD_CASE, { ...at, field: "loadCase" });
+        const memberKnown = members.some((m) => m.id === load.memberId);
+        if (!memberKnown)
+            add(fea_error_1.FeaErrors.UNKNOWN_NODE_REFERENCE, { ...at, field: "memberId" });
+        if (load.type !== "torque" && !DIRECTIONS.has(load.direction))
+            add(fea_error_1.FeaErrors.INVALID_INPUT_VALUE, { ...at, field: "direction" });
+        // a projected length needs a distributed load in a global direction
+        const projected = load.projected;
+        if ((projected !== undefined && typeof projected !== "boolean") ||
+            (projected === true &&
+                ((load.type !== "udl" && load.type !== "trapezoidal") ||
+                    !GLOBAL_DIRECTIONS.has(load.direction)))) {
+            add(fea_error_1.FeaErrors.INVALID_INPUT_VALUE, { ...at, field: "projected" });
+        }
+        const L = memberLength.get(load.memberId);
+        if (load.type === "udl" || load.type === "trapezoidal" || load.type === "torque") {
+            const intensities = load.type === "udl"
+                ? { w: load.w }
+                : load.type === "trapezoidal"
+                    ? { w1: load.w1, w2: load.w2 }
+                    : { t: load.t };
+            const extent = { start: load.start, end: load.end };
+            let ok = true;
+            for (const [field, v] of [...Object.entries(intensities), ...Object.entries(extent)]) {
+                if ((field in intensities || v !== undefined) && !(0, issues_1.isFiniteNumber)(v)) {
+                    add(fea_error_1.FeaErrors.INVALID_INPUT_VALUE, { ...at, field });
+                    ok = false;
+                }
+            }
+            if (ok && L !== undefined) {
+                const start = load.start ?? 0;
+                const end = load.end ?? L;
+                if (!(start >= 0 && end <= L && start < end))
+                    add(fea_error_1.FeaErrors.LOAD_OUTSIDE_MEMBER, at);
+            }
+        }
+        else if (load.type === "point") {
+            let ok = true;
+            for (const field of ["P", "a"]) {
+                if (!(0, issues_1.isFiniteNumber)(load[field])) {
+                    add(fea_error_1.FeaErrors.INVALID_INPUT_VALUE, { ...at, field });
+                    ok = false;
+                }
+            }
+            if (ok && L !== undefined && !(load.a >= 0 && load.a <= L)) {
+                add(fea_error_1.FeaErrors.LOAD_OUTSIDE_MEMBER, at);
+            }
+        }
+        else {
+            add(fea_error_1.FeaErrors.INVALID_INPUT_VALUE, { ...at, field: "type" });
+        }
+    }
+    return issues;
+};
+exports.validateMemberLoads = validateMemberLoads;
+//# sourceMappingURL=validate-members.js.map

package/dist/fea/frame/validation/validate-members.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-members.js","sourceRoot":"","sources":["../../../../src/fea/frame/validation/validate-members.ts"],"names":[],"mappings":"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"}

package/dist/fea/frame/validation/validate-null-areas.d.ts

@@ -0,0 +1,38 @@
+import { type FeaModelIssue } from "../../../core/errors/fea.error";
+import type { FeaId, FeaNode } from "../../shared/types/model.type";
+import { type AreaPlane, type AreaSupports, type Vec3 } from "../area/area-geometry";
+import type { Member, NullArea } from "../types/model.type";
+/** A null area whose geometry and supports are valid, with its plane and loaded edges. */
+export interface NullAreaInfo {
+    area: NullArea;
+    plane: AreaPlane;
+    supports: AreaSupports;
+}
+/**
+ * Checks each null area: its `distribution`, corners (3 or 4 known nodes, planar and convex; a
+ * rectangle for a cantilever), `supportEdges`, and members covering every edge that receives
+ * load. Corners at nodes with invalid coordinates are skipped; those are reported on the node.
+ *
+ * @param areas - The model's null areas
+ * @param members - The model's members
+ * @param memberLength - Length of each member whose geometry is valid (from `validateMembers`);
+ *   only those can support an edge
+ * @param nodeById - Model nodes by id
+ * @param validNode - Ids of the nodes whose coordinates are valid
+ * @returns `issues` (codes 302, 314, 315, 316 and 317), in model order, with `areaId`, and the
+ *   plane and supports of every area that passed
+ */
+export declare const validateNullAreas: (areas: NullArea[], members: Member[], memberLength: Map<FeaId, number>, nodeById: Map<FeaId, FeaNode>, validNode: Set<FeaId>) => {
+    issues: FeaModelIssue[];
+    areaInfo: Map<FeaId, NullAreaInfo>;
+};
+/**
+ * Whether a load along global `direction` acts partly along the support edge of a cantilever
+ * area, which its distribution cannot carry: a cantilever sends its load to the support edge as
+ * a line load plus a torque about that edge, and a component along the edge would also need a
+ * distributed moment about the normal. Always false for other distributions.
+ *
+ * @param info - The area, as `validateNullAreas` returns it
+ * @param direction - The load's global direction (unit vector)
+ */
+export declare const loadsAlongCantileverSupport: (info: NullAreaInfo, direction: Vec3) => boolean;

package/dist/fea/frame/validation/validate-null-areas.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadsAlongCantileverSupport = exports.validateNullAreas = void 0;
+const frame_constant_1 = require("../../../core/constants/frame.constant");
+const fea_error_1 = require("../../../core/errors/fea.error");
+const issues_1 = require("../../shared/validation/issues");
+const area_geometry_1 = require("../area/area-geometry");
+const edge_members_1 = require("../area/edge-members");
+const AREA_DISTRIBUTIONS = new Set(["twoWay", "oneWay", "cantilever"]);
+/**
+ * Checks each null area: its `distribution`, corners (3 or 4 known nodes, planar and convex; a
+ * rectangle for a cantilever), `supportEdges`, and members covering every edge that receives
+ * load. Corners at nodes with invalid coordinates are skipped; those are reported on the node.
+ *
+ * @param areas - The model's null areas
+ * @param members - The model's members
+ * @param memberLength - Length of each member whose geometry is valid (from `validateMembers`);
+ *   only those can support an edge
+ * @param nodeById - Model nodes by id
+ * @param validNode - Ids of the nodes whose coordinates are valid
+ * @returns `issues` (codes 302, 314, 315, 316 and 317), in model order, with `areaId`, and the
+ *   plane and supports of every area that passed
+ */
+const validateNullAreas = (areas, members, memberLength, nodeById, validNode) => {
+    const issues = [];
+    const add = (std, details = {}) => issues.push((0, issues_1.modelIssue)(std, details));
+    const adjacency = (0, edge_members_1.memberAdjacency)(members.filter((m) => memberLength.has(m.id)));
+    const position = (id) => {
+        const node = nodeById.get(id);
+        return [node.x, node.y, node.z];
+    };
+    // only for areas whose geometry and supports are valid
+    const areaInfo = new Map();
+    for (const area of areas) {
+        const at = { areaId: area.id };
+        const distributionOk = AREA_DISTRIBUTIONS.has(area.distribution);
+        if (!distributionOk)
+            add(fea_error_1.FeaErrors.INVALID_INPUT_VALUE, { ...at, field: "distribution" });
+        const ids = Array.isArray(area.nodeIds) ? area.nodeIds : [];
+        if (ids.length !== 3 && ids.length !== 4) {
+            add(fea_error_1.FeaErrors.INVALID_AREA_GEOMETRY, { ...at, field: "nodeIds" });
+            continue;
+        }
+        if (ids.some((id) => !nodeById.has(id))) {
+            add(fea_error_1.FeaErrors.UNKNOWN_NODE_REFERENCE, { ...at, field: "nodeIds" });
+            continue;
+        }
+        if (!ids.every((id) => validNode.has(id)))
+            continue; // reported on the node
+        const plane = (0, area_geometry_1.areaPlane)(ids.map(position));
+        if ("problem" in plane) {
+            add(fea_error_1.FeaErrors.INVALID_AREA_GEOMETRY, { ...at, field: "nodeIds" });
+            continue;
+        }
+        if (!distributionOk)
+            continue;
+        if (area.distribution === "cantilever" && !(0, area_geometry_1.isRectangle)(plane)) {
+            add(fea_error_1.FeaErrors.INVALID_AREA_GEOMETRY, { ...at, field: "nodeIds" });
+            continue;
+        }
+        const supports = (0, area_geometry_1.resolveAreaSupports)(plane, area.distribution, area.supportEdges);
+        if (!supports) {
+            add(fea_error_1.FeaErrors.INVALID_AREA_DISTRIBUTION, { ...at, field: "supportEdges" });
+            continue;
+        }
+        for (const edge of supports.loadedEdges) {
+            const chain = (0, edge_members_1.edgeMemberChain)(ids[edge], ids[(edge + 1) % ids.length], position, adjacency);
+            if (!chain)
+                add(fea_error_1.FeaErrors.AREA_EDGE_UNSUPPORTED, { ...at, edge });
+        }
+        areaInfo.set(area.id, { area, plane, supports });
+    }
+    return { issues, areaInfo };
+};
+exports.validateNullAreas = validateNullAreas;
+/**
+ * Whether a load along global `direction` acts partly along the support edge of a cantilever
+ * area, which its distribution cannot carry: a cantilever sends its load to the support edge as
+ * a line load plus a torque about that edge, and a component along the edge would also need a
+ * distributed moment about the normal. Always false for other distributions.
+ *
+ * @param info - The area, as `validateNullAreas` returns it
+ * @param direction - The load's global direction (unit vector)
+ */
+const loadsAlongCantileverSupport = (info, direction) => {
+    if (info.area.distribution !== "cantilever")
+        return false;
+    const t = (0, area_geometry_1.edgeDirection)(info.plane, info.supports.loadedEdges[0]);
+    const along = direction[0] * t[0] + direction[1] * t[1] + direction[2] * t[2];
+    return Math.abs(along) > frame_constant_1.AREA_GEOMETRY_TOLERANCE;
+};
+exports.loadsAlongCantileverSupport = loadsAlongCantileverSupport;
+//# sourceMappingURL=validate-null-areas.js.map

package/dist/fea/frame/validation/validate-null-areas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-null-areas.js","sourceRoot":"","sources":["../../../../src/fea/frame/validation/validate-null-areas.ts"],"names":[],"mappings":"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"}

package/dist/fea/index.d.ts

@@ -1 +1,5 @@
+export * from "./shared";
+export * from "./shell";
 export * from "./frame";
+export * from "./analysis";
+export * from "./deprecated";

package/dist/fea/index.js

@@ -14,6 +14,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-// Frame analysis
+__exportStar(require("./shared"), exports);
+__exportStar(require("./shell"), exports);
 __exportStar(require("./frame"), exports);
+__exportStar(require("./analysis"), exports);
+__exportStar(require("./deprecated"), exports);
 //# sourceMappingURL=index.js.map

package/dist/fea/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fea/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iBAAiB;AACjB,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fea/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,0CAAwB;AACxB,0CAAwB;AACxB,6CAA2B;AAC3B,+CAA6B"}

package/dist/fea/shared/index.d.ts

@@ -0,0 +1 @@
+export type { FeaId, FeaNode, DofRestraint, Restraint, AreaLoadDirection, AreaLoad, } from "./types/model.type";

package/dist/fea/shared/index.js

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

package/dist/fea/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/fea/shared/index.ts"],"names":[],"mappings":""}

package/dist/fea/shared/solver/auto-restraint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-restraint.js","sourceRoot":"","sources":["../../../../src/fea/shared/solver/auto-restraint.ts"],"names":[],"mappings":"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"}

package/dist/fea/{frame → shared}/solver/boundary-conditions.d.ts

@@ -1,4 +1,9 @@
 import type { Restraint } from "../types/model.type";
+/**
+ * Spring stiffness unit conversion per DOF of one node or member end:
+ * kN/mm → N/mm for translations, kN·m/rad → N·mm/rad for rotations.
+ */
+export declare const SPRING_UNIT_FACTOR: readonly [1000, 1000, 1000, 1000000, 1000000, 1000000];
 export interface BoundaryConditions {
     fixed: boolean[];
     spring: number[];

package/dist/fea/{frame → shared}/solver/boundary-conditions.js

@@ -1,8 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildBoundaryConditions = void 0;
-const end_releases_1 = require("../elements/end-releases");
+exports.buildBoundaryConditions = exports.SPRING_UNIT_FACTOR = void 0;
 const DOF_KEYS = ["ux", "uy", "uz", "rx", "ry", "rz"];
+/**
+ * Spring stiffness unit conversion per DOF of one node or member end:
+ * kN/mm → N/mm for translations, kN·m/rad → N·mm/rad for rotations.
+ */
+exports.SPRING_UNIT_FACTOR = [1e3, 1e3, 1e3, 1e6, 1e6, 1e6];
 const parse = (value, factor) => {
     if (value === true)
         return { fixed: true, spring: 0 };
@@ -23,7 +27,7 @@ const buildBoundaryConditions = (restraints, nodeIndex, dofCount) => {
     for (const restraint of restraints) {
         const base = 6 * nodeIndex.get(restraint.nodeId);
         DOF_KEYS.forEach((key, k) => {
-            const parsed = parse(restraint[key], end_releases_1.SPRING_UNIT_FACTOR[k]);
+            const parsed = parse(restraint[key], exports.SPRING_UNIT_FACTOR[k]);
             if (parsed.fixed)
                 fixed[base + k] = true;
             spring[base + k] = parsed.spring;

package/dist/fea/shared/solver/boundary-conditions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundary-conditions.js","sourceRoot":"","sources":["../../../../src/fea/shared/solver/boundary-conditions.ts"],"names":[],"mappings":";;;AAEA,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AAE/D;;;GAGG;AACU,QAAA,kBAAkB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAU,CAAC;AAQ1E,MAAM,KAAK,GAAG,CACZ,KAA+B,EAC/B,MAAc,EACsB,EAAE;IACtC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACtD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,GAAG,MAAM,EAAE,CAAC;IAC5F,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;AACrC,CAAC,CAAC;AAEF;;;;;;GAMG;AACI,MAAM,uBAAuB,GAAG,CACrC,UAAuB,EACvB,SAA2C,EAC3C,QAAgB,EACI,EAAE;IACtB,MAAM,KAAK,GAAG,IAAI,KAAK,CAAU,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,IAAI,KAAK,CAAS,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,CAAC,GAAI,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAY,CAAC;QAC7D,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,0BAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5D,IAAI,MAAM,CAAC,KAAK;gBAAE,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC;YACzC,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QACnC,CAAC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AACvC,CAAC,CAAC;AAjBW,QAAA,uBAAuB,2BAiBlC"}

package/dist/fea/shared/solver/global-assembly.d.ts

@@ -0,0 +1,12 @@
+import type { Matrix } from "../../../utils/matrix";
+/**
+ * A stiffness contribution to the global system: the nodes it connects and its stiffness over
+ * their DOFs (6 per node, in node order) in global axes. A member is a 2-node element; elements
+ * with more nodes assemble the same way.
+ */
+export interface StiffnessElement {
+    nodes: number[];
+    kGlobal: Matrix;
+}
+/** Global DOF numbers (6 per node, in node order) of an element connecting `nodes`. */
+export declare const elementDofs: (nodes: readonly number[]) => number[];

package/dist/fea/shared/solver/global-assembly.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.elementDofs = void 0;
+/** Global DOF numbers (6 per node, in node order) of an element connecting `nodes`. */
+const elementDofs = (nodes) => {
+    const dofs = [];
+    for (const node of nodes) {
+        for (let k = 0; k < 6; k++)
+            dofs.push(6 * node + k);
+    }
+    return dofs;
+};
+exports.elementDofs = elementDofs;
+//# sourceMappingURL=global-assembly.js.map

package/dist/fea/shared/solver/global-assembly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-assembly.js","sourceRoot":"","sources":["../../../../src/fea/shared/solver/global-assembly.ts"],"names":[],"mappings":";;;AAYA,uFAAuF;AAChF,MAAM,WAAW,GAAG,CAAC,KAAwB,EAAY,EAAE;IAChE,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;YAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AANW,QAAA,WAAW,eAMtB"}

package/dist/fea/shared/types/model.type.d.ts

@@ -0,0 +1,34 @@
+export type FeaId = string | number;
+export interface FeaNode {
+    id: FeaId;
+    x: number;
+    y: number;
+    z: number;
+}
+/** A restrained DOF: `true` is fixed, a number is a spring stiffness, omitted/`false` is free. */
+export type DofRestraint = boolean | number;
+export interface Restraint {
+    nodeId: FeaId;
+    ux?: DofRestraint;
+    uy?: DofRestraint;
+    uz?: DofRestraint;
+    rx?: DofRestraint;
+    ry?: DofRestraint;
+    rz?: DofRestraint;
+}
+/** Area load direction: the area's local normal "3" or a global axis. */
+export type AreaLoadDirection = "3" | "X" | "Y" | "Z";
+/**
+ * Uniform load on a null area or a shell area. `q` is per unit true area, or with
+ * `projected: true` (global directions only) per unit area projected onto the plane normal to
+ * `direction`, e.g. per plan area on a ramp; it is then applied as `q · |n · direction|` on
+ * the true area. A null area sends it to the members along its edges; a shell area takes it
+ * as forces at its corners, each corner the share `∫ Nᵢ dA` of its area.
+ */
+export interface AreaLoad {
+    loadCase: string;
+    areaId: FeaId;
+    direction: AreaLoadDirection;
+    q: number;
+    projected?: boolean;
+}

package/dist/fea/shared/types/model.type.js

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

package/dist/fea/shared/types/model.type.js.map

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

package/dist/fea/shared/validation/issues.d.ts

@@ -0,0 +1,9 @@
+import { type FeaErrorDetails, type FeaModelIssue } from "../../../core/errors/fea.error";
+export declare const isFiniteNumber: (v: unknown) => v is number;
+/** Builds an issue whose message names where the problem is. */
+export declare const modelIssue: (std: {
+    code: number;
+    message: string;
+}, details?: FeaErrorDetails) => FeaModelIssue;
+/** Throws the first issue as a `FeaError` carrying all of them. */
+export declare const throwIssues: (issues: FeaModelIssue[]) => never;

package/dist/fea/shared/validation/issues.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.throwIssues = exports.modelIssue = exports.isFiniteNumber = void 0;
+const fea_error_1 = require("../../../core/errors/fea.error");
+const isFiniteNumber = (v) => typeof v === "number" && Number.isFinite(v);
+exports.isFiniteNumber = isFiniteNumber;
+const describe = (d) => {
+    const parts = [];
+    if (d.nodeId !== undefined)
+        parts.push(`node "${String(d.nodeId)}"`);
+    if (d.memberId !== undefined)
+        parts.push(`member "${String(d.memberId)}"`);
+    if (d.areaId !== undefined)
+        parts.push(`area "${String(d.areaId)}"`);
+    if (d.shellId !== undefined)
+        parts.push(`shell "${String(d.shellId)}"`);
+    if (d.edge !== undefined)
+        parts.push(`edge ${d.edge}`);
+    if (d.loadCaseId !== undefined)
+        parts.push(`load case "${d.loadCaseId}"`);
+    if (d.combinationId !== undefined)
+        parts.push(`combination "${d.combinationId}"`);
+    if (d.field !== undefined)
+        parts.push(`field "${d.field}"`);
+    if (d.dof !== undefined)
+        parts.push(`DOF ${d.dof}`);
+    return parts.length > 0 ? ` [${parts.join(", ")}]` : "";
+};
+/** Builds an issue whose message names where the problem is. */
+const modelIssue = (std, details = {}) => ({ code: std.code, message: std.message + describe(details), details });
+exports.modelIssue = modelIssue;
+/** Throws the first issue as a `FeaError` carrying all of them. */
+const throwIssues = (issues) => {
+    const first = issues[0];
+    throw new fea_error_1.FeaError({ code: first.code, message: first.message }, first.details, issues);
+};
+exports.throwIssues = throwIssues;
+//# sourceMappingURL=issues.js.map

package/dist/fea/shared/validation/issues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issues.js","sourceRoot":"","sources":["../../../../src/fea/shared/validation/issues.ts"],"names":[],"mappings":";;;AAAA,0DAAgG;AAEzF,MAAM,cAAc,GAAG,CAAC,CAAU,EAAe,EAAE,CACxD,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AADjC,QAAA,cAAc,kBACmB;AAE9C,MAAM,QAAQ,GAAG,CAAC,CAAkB,EAAU,EAAE;IAC9C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACrE,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC3E,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACrE,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACxE,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACvD,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC;IAC1E,IAAI,CAAC,CAAC,aAAa,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC;IAClF,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;IAC5D,IAAI,CAAC,CAAC,GAAG,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1D,CAAC,CAAC;AAEF,gEAAgE;AACzD,MAAM,UAAU,GAAG,CACxB,GAAsC,EACtC,UAA2B,EAAE,EACd,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;AAH/E,QAAA,UAAU,cAGqE;AAE5F,mEAAmE;AAC5D,MAAM,WAAW,GAAG,CAAC,MAAuB,EAAS,EAAE;IAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,IAAI,oBAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAC1F,CAAC,CAAC;AAHW,QAAA,WAAW,eAGtB"}

package/dist/fea/{frame/elements/shell → shell/elements}/dkq-plate.d.ts

@@ -1,4 +1,4 @@
-import { type Matrix } from "../../../../utils/matrix";
+import { type Matrix } from "../../../utils/matrix";
 import { type Vec2 } from "./quad-geometry";
 import { type RigidityModifiers } from "./rigidity";
 /** Material and thickness of a plate: E in MPa, ν, t in mm. */

package/dist/fea/{frame/elements/shell → shell/elements}/dkq-plate.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.dkqPlateStiffness = exports.plateRigidity = exports.dkqCurvatureRows = void 0;
-const matrix_1 = require("../../../../utils/matrix");
+const matrix_1 = require("../../../utils/matrix");
 const quad_geometry_1 = require("./quad-geometry");
 const rigidity_1 = require("./rigidity");
 const edgeCoefficients = (corners) => [0, 1, 2, 3].map((k) => {

package/dist/fea/shell/elements/dkq-plate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dkq-plate.js","sourceRoot":"","sources":["../../../../src/fea/shell/elements/dkq-plate.ts"],"names":[],"mappings":"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"}