@ferscloud/fers-calculation-web 0.2.55 → 0.2.58

package/fers-models.d.ts

@@ -471,6 +471,11 @@ export interface components {
          * @enum {string}
          */
         ConstantDimension: "Length" | "Force" | "Moment" | "Stress" | "Area" | "Angle";
+        /**
+         * @description What a connector does beyond the end of its tabulated diagram.
+         * @enum {string}
+         */
+        CurveEndBehaviour: "Continuous" | "Stop" | "Yielding" | "Failure";
         /**
          * @description Transverse deflection component, measured relative to the entity's end-to-end
          *     chord (local-frame axes perpendicular to the chord).
@@ -1137,20 +1142,63 @@ export interface components {
             hinge_type: string;
             /** Format: int32 */
             id: number;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description See [`Self::max_tension_vx`] — a design capacity, not read by the solver.
+             */
             max_bimoment_warp?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description See [`Self::max_tension_vx`] — a design capacity, not read by the solver.
+             */
             max_moment_mx?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description See [`Self::max_tension_vx`] — a design capacity, not read by the solver.
+             */
             max_moment_my?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description See [`Self::max_tension_vx`] — a design capacity, not read by the solver.
+             */
             max_moment_mz?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Connector **design capacities** — the connection's rated shear, moment and
+             *     bimoment resistance (e.g. an EN 15512 beam-end-connector test value).
+             *
+             *     **The solver does not read these, deliberately.** They are inputs to code
+             *     checking, not to the analysis: a capacity is a resistance to compare a
+             *     demand against, not a stiffness. Nothing here caps, redistributes or warns
+             *     — a hinge carrying a capacity solves exactly as one without.
+             *
+             *     To express a connector that actually *stops taking moment* during the
+             *     solve, give it a [`crate::models::moment_rotation::MomentRotationCurve`]
+             *     with `end: Yielding`; that is the analysis-side feature and it is
+             *     unrelated to these fields.
+             *
+             *     Not yet reachable from a unity check either: `QuantitySource` can read a
+             *     `Section` or `Material` property but has no hinge source, so a check
+             *     cannot name one of these today. That is the work these fields are waiting
+             *     on — see `Feedback_Folder/member-hinge-secant-state-and-damping/`.
+             *
+             *     Units follow the model's own (normalized to SI internally, like every
+             *     other force/moment quantity).
+             */
             max_tension_vx?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description See [`Self::max_tension_vx`] — a design capacity, not read by the solver.
+             */
             max_tension_vy?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description See [`Self::max_tension_vx`] — a design capacity, not read by the solver.
+             */
             max_tension_vz?: number | null;
+            moment_rotation_mx?: null | components["schemas"]["MomentRotationCurve"];
+            moment_rotation_my?: null | components["schemas"]["MomentRotationCurve"];
+            moment_rotation_mz?: null | components["schemas"]["MomentRotationCurve"];
             /** Format: double */
             rotational_release_mx?: number | null;
             /** Format: double */
@@ -1263,14 +1311,24 @@ export interface components {
             local_minimums?: null | components["schemas"]["NodeForces"];
             local_start_forces?: null | components["schemas"]["NodeForces"];
             maximums?: null | components["schemas"]["NodeForces"];
+            member_displacement_peak?: null | components["schemas"]["MemberDisplacementSample"];
             /**
              * @description Optional sampled deflected shape: the member's global displacement at
-             *     evenly-spaced stations from `x_frac = 0` to `1`, reconstructed by
-             *     cubic-Hermite interpolation of the end-node translations + rotations.
-             *     Empty unless `AnalysisOptions::include_member_deflected_shape` is enabled.
-             *     The interpolation is the end-DOF homogeneous cubic — exact for members with
-             *     no span load; under a member UDL the true shape is quartic, so mid-span sag
-             *     is slightly under-rendered (matching client-side Hermite reconstructions).
+             *     stations running from `x_frac = 0` to `1`, load-exact rather than
+             *     interpolated. Empty unless `AnalysisOptions::include_member_deflected_shape`
+             *     is enabled.
+             *
+             *     A member carrying span loads is reconstructed by integrating its own internal
+             *     force field (`u'' = −M/EI`, plus `V/GA_s` where the section has a shear area),
+             *     so the quartic mid-span sag under a UDL and the Timoshenko shear term are
+             *     both present. A member without span loads is the end-DOF cubic, which is
+             *     exact there — the two agree to machine precision.
+             *
+             *     Stations are evenly spaced, **except** on a member that was split internally
+             *     at a mid-span point load: there each segment is evenly sampled over its own
+             *     share of the parent's `x_frac` range and the segments are concatenated, which
+             *     keeps the slope kink exactly on the split. `x_frac` is monotonically
+             *     increasing in every case.
              */
             member_displacements?: components["schemas"]["MemberDisplacementSample"][];
             minimums?: null | components["schemas"]["NodeForces"];
@@ -1483,9 +1541,14 @@ export interface components {
             participation_factors: number[];
             /**
              * Format: double
-             * @description Period `T = 1 / f` (s).
+             * @description Period `T = 1 / f` (s), or `null` for a **rigid-body mode**.
+             *
+             *     A free-free structure has zero-frequency modes whose period is infinite, and
+             *     JSON has no `Infinity`. This was an `f64` until 0.2.56, so the serializer
+             *     wrote `null` into a field that could not deserialize it and the engine
+             *     emitted documents it could not read back.
              */
-            period: number;
+            period?: number | null;
         };
         /**
          * @description The structural model: nodes, members, plates and their supporting
@@ -1516,6 +1579,28 @@ export interface components {
             /** @default {} */
             workspace: components["schemas"]["Workspace"];
         };
+        /** @description A beam-end connector's moment–rotation characteristic. */
+        MomentRotationCurve: {
+            /** @description Behaviour above the last tabulated point. */
+            end?: components["schemas"]["CurveEndBehaviour"];
+            /**
+             * @description Sorted `[rotation, moment]` pairs (≥ 2 points): rotation in radians (the
+             *     model's length/force units never touch it), moment in the model's units.
+             *     Rotations must ascend strictly and moments must not decrease.
+             */
+            points: number[][];
+            /**
+             * @description Behaviour below the first tabulated point. Only reachable on an asymmetric
+             *     diagram — a symmetric one is read at `|M|` and so never runs off the bottom.
+             */
+            start?: components["schemas"]["CurveEndBehaviour"];
+            /**
+             * @description Mirror the diagram through the origin, so hogging and sagging behave
+             *     identically and the table only has to carry `φ ≥ 0`. The usual case, and the
+             *     default. Set `false` to tabulate an asymmetric connector across both signs.
+             */
+            symmetric?: boolean;
+        };
         /** @description Modal response spectrum analysis results (§4.3.3.3). */
         MrsaResults: {
             /** @description Final envelope after directional combination. */
@@ -2546,9 +2631,10 @@ export interface components {
             participation_factor: number;
             /**
              * Format: double
-             * @description Natural period `T = 2π/ω` (s).
+             * @description Natural period `T = 2π/ω` (s), or `null` for a zero-frequency (rigid-body)
+             *     mode — see [`crate::models::results::modalresult::ModeShape::period`].
              */
-            period: number;
+            period?: number | null;
             /**
              * Format: double
              * @description Design spectral acceleration `Sd(T)` (m/s²).

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ferscloud/fers-calculation-web",
   "type": "module",
-  "version": "0.2.55",
+  "version": "0.2.58",
   "license": "BSD-3-Clause",
   "repository": {
     "type": "git",