@swmmrs/swmmrs 0.1.0

package/lib/swmmrs/objects/collections.d.ts

@@ -0,0 +1,109 @@
+import type { NodeSnapshot, LinkSnapshot, SubcatchmentSnapshot } from "../snapshots.js";
+import { Node, type NodeQualitySnapshot, type NodeStatisticsSnapshot } from "./nodes.js";
+import { Link, type LinkQualitySnapshot, type LinkStatisticsSnapshot } from "./links.js";
+import { Subcatchment, RainGage, type SubcatchmentQualitySnapshot, type SubcatchmentStatisticsSnapshot } from "./subcatchments.js";
+/**
+ * Configured-order handles with synchronous, case-insensitive ID lookup and stable identity.
+ * Obtain simulation collections from the owner rather than constructing a replacement view.
+ * All access checks the owner lifecycle; no access is valid after close.
+ * @typeParam T - Handle type returned by lookup and iteration.
+ */
+export declare class ObjectCollection<T> implements Iterable<T> {
+    #private;
+    /** Construct the shared collection implementation.
+     * @param ids - Canonical IDs in configured order; copied on construction.
+     * @param create - Factory called once per looked-up canonical ID.
+     * @param assertOpen - Lifecycle guard called before collection access.
+     */
+    constructor(ids: readonly string[], create: (id: string) => T, assertOpen: () => void);
+    /** Canonical IDs in configured order; a frozen array. */
+    get ids(): readonly string[];
+    /** Number of configured objects. */
+    get size(): number;
+    /** Test membership synchronously.
+     * @param id - Case-insensitive object ID.
+     * @returns Whether the ID is configured.
+     */
+    has(id: string): boolean;
+    /** Look up a stable handle synchronously.
+     * @param id - Case-insensitive object ID.
+     * @returns The same handle instance for repeated lookups of one canonical ID.
+     * @throws ObjectNotFoundError for an unknown ID; lifecycle errors after close.
+     */
+    get(id: string): T;
+    /** Look up a configured-order handle synchronously.
+     * @param index - Zero-based integer index; negative and fractional values are invalid.
+     * @returns The stable handle at the index.
+     * @throws RangeError for an out-of-range or noninteger index.
+     */
+    at(index: number): T;
+    /** Iterate handles in configured order.
+     * @returns Synchronous iterator, checking the owner on each lookup.
+     */
+    [Symbol.iterator](): IterableIterator<T>;
+}
+/** Owner-bound node handles. Snapshot selections preserve requested order; omit IDs for all nodes. */
+export declare class NodeCollection extends ObjectCollection<Node> {
+    #private;
+    private constructor();
+    /** Read node hydraulics in `running`, `complete`, or `ended`.
+     * @param ids - Ordered selection; omit for all, use [] for empty columns. Unknown or case-insensitive duplicate IDs reject.
+     * @returns Detached columns aligned with canonical `objectIds`, without a timestamp.
+     */
+    snapshot(ids?: readonly string[]): Promise<NodeSnapshot>;
+    /** Read node quality in `running`, `complete`, or `ended`.
+     * @param ids - Ordered IDs; omit for all or use [] for none. Unknown/duplicate IDs reject.
+     * @returns Detached pollutant-major matrices; inner rows follow `objectIds`.
+     */
+    qualitySnapshot(ids?: readonly string[]): Promise<NodeQualitySnapshot>;
+    /** Read cumulative node statistics in `running` or `complete`, before ending the run.
+     * @param ids - Ordered IDs; omit for all or use [] for none. Unknown/duplicate IDs reject.
+     * @returns Detached statistics columns aligned with canonical `objectIds`.
+     */
+    statisticsSnapshot(ids?: readonly string[]): Promise<NodeStatisticsSnapshot>;
+}
+/** Owner-bound link handles. Snapshot selections preserve requested order; omit IDs for all links. */
+export declare class LinkCollection extends ObjectCollection<Link> {
+    #private;
+    private constructor();
+    /** Read link hydraulics in `running`, `complete`, or `ended`.
+     * @param ids - Ordered IDs; omit for all or use [] for none. Unknown/duplicate IDs reject, including case-only duplicates.
+     * @returns Detached hydraulic columns aligned with canonical `objectIds`, without a timestamp.
+     */
+    snapshot(ids?: readonly string[]): Promise<LinkSnapshot>;
+    /** Read link quality in `running`, `complete`, or `ended`.
+     * @param ids - Ordered IDs; omit for all or use [] for none. Unknown/duplicate IDs reject.
+     * @returns Detached pollutant-major matrices; inner rows follow `objectIds`.
+     */
+    qualitySnapshot(ids?: readonly string[]): Promise<LinkQualitySnapshot>;
+    /** Read cumulative link statistics in `running` or `complete`.
+     * @param ids - Ordered IDs; omit for all or use [] for none. Unknown/duplicate IDs reject.
+     * @returns Detached scalar columns; flow-class durations have one seven-value row per link.
+     */
+    statisticsSnapshot(ids?: readonly string[]): Promise<LinkStatisticsSnapshot>;
+}
+/** Owner-bound subcatchment handles and aligned hydraulic, quality, and statistics reads. */
+export declare class SubcatchmentCollection extends ObjectCollection<Subcatchment> {
+    #private;
+    private constructor();
+    /** Read runoff results in `running`, `complete`, or `ended`.
+     * @param ids - Ordered IDs; omit for all or use [] for none. Unknown/duplicate IDs reject, including case-only duplicates.
+     * @returns Detached runoff columns aligned with canonical `objectIds`, without a timestamp.
+     */
+    snapshot(ids?: readonly string[]): Promise<SubcatchmentSnapshot>;
+    /** Read subcatchment quality in `running`, `complete`, or `ended`.
+     * @param ids - Ordered IDs; omit for all or use [] for none. Unknown/duplicate IDs reject.
+     * @returns Detached pollutant-major matrices; inner rows follow `objectIds`.
+     */
+    qualitySnapshot(ids?: readonly string[]): Promise<SubcatchmentQualitySnapshot>;
+    /** Read cumulative runoff statistics in `running` or `complete`.
+     * @param ids - Ordered IDs; omit for all or use [] for none. Unknown/duplicate IDs reject.
+     * @returns Detached statistics columns aligned with canonical `objectIds`.
+     */
+    statisticsSnapshot(ids?: readonly string[]): Promise<SubcatchmentStatisticsSnapshot>;
+}
+/** Owner-bound rain-gage handles. Rain gages provide per-object results, not collection snapshots. */
+export declare class RainGageCollection extends ObjectCollection<RainGage> {
+    private constructor();
+}
+//# sourceMappingURL=collections.d.ts.map

package/lib/swmmrs/objects/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../../src/swmmrs/objects/collections.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACxF,OAAO,EAAE,IAAI,EAAE,KAAK,mBAAmB,EAAE,KAAK,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,EAAE,IAAI,EAAE,KAAK,mBAAmB,EAAE,KAAK,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,2BAA2B,EAAE,KAAK,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AAEnI;;;;;GAKG;AACH,qBAAa,gBAAgB,CAAC,CAAC,CAAE,YAAW,QAAQ,CAAC,CAAC,CAAC;;IAOrD;;;;OAIG;IACH,YAAY,GAAG,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,CAAC,EAAE,UAAU,EAAE,MAAM,IAAI,EAKpF;IACD,yDAAyD;IACzD,IAAI,GAAG,IAAI,SAAS,MAAM,EAAE,CAA0C;IACtE,oCAAoC;IACpC,IAAI,IAAI,IAAI,MAAM,CAAiD;IACnE;;;OAGG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAiE;IACzF;;;;OAIG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,CAOjB;IACD;;;;OAIG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,CAKnB;IACD;;OAEG;IACF,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAGxC;CACF;AAED,sGAAsG;AACtG,qBAAa,cAAe,SAAQ,gBAAgB,CAAC,IAAI,CAAC;;IAExD,OAAO,eAEN;IAGD;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAqC;IAC7F;;;OAGG;IACH,eAAe,CAAC,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAmD;IACzH;;;OAGG;IACH,kBAAkB,CAAC,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAsD;CACnI;AACD,sGAAsG;AACtG,qBAAa,cAAe,SAAQ,gBAAgB,CAAC,IAAI,CAAC;;IAExD,OAAO,eAEN;IAGD;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAqC;IAC7F;;;OAGG;IACH,eAAe,CAAC,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAmD;IACzH;;;OAGG;IACH,kBAAkB,CAAC,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAsD;CACnI;AACD,6FAA6F;AAC7F,qBAAa,sBAAuB,SAAQ,gBAAgB,CAAC,YAAY,CAAC;;IAExE,OAAO,eAEN;IAGD;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAA6C;IAC7G;;;OAGG;IACH,eAAe,CAAC,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAA2D;IACzI;;;OAGG;IACH,kBAAkB,CAAC,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAA8D;CACnJ;AACD,sGAAsG;AACtG,qBAAa,kBAAmB,SAAQ,gBAAgB,CAAC,QAAQ,CAAC;IAChE,OAAO,eAEN;CAGF"}

package/lib/swmmrs/objects/collections.js

@@ -0,0 +1,158 @@
+import { ObjectNotFoundError } from "../exceptions.js";
+import { Node } from "./nodes.js";
+import { Link } from "./links.js";
+import { Subcatchment, RainGage } from "./subcatchments.js";
+/**
+ * Configured-order handles with synchronous, case-insensitive ID lookup and stable identity.
+ * Obtain simulation collections from the owner rather than constructing a replacement view.
+ * All access checks the owner lifecycle; no access is valid after close.
+ * @typeParam T - Handle type returned by lookup and iteration.
+ */
+export class ObjectCollection {
+    #ids;
+    #byId;
+    #views = new Map();
+    #create;
+    #assertOpen;
+    /** Construct the shared collection implementation.
+     * @param ids - Canonical IDs in configured order; copied on construction.
+     * @param create - Factory called once per looked-up canonical ID.
+     * @param assertOpen - Lifecycle guard called before collection access.
+     */
+    constructor(ids, create, assertOpen) {
+        this.#ids = Object.freeze([...ids]);
+        this.#byId = new Map(ids.map((id) => [id.toLowerCase(), id]));
+        this.#create = create;
+        this.#assertOpen = assertOpen;
+    }
+    /** Canonical IDs in configured order; a frozen array. */
+    get ids() { this.#assertOpen(); return this.#ids; }
+    /** Number of configured objects. */
+    get size() { this.#assertOpen(); return this.#ids.length; }
+    /** Test membership synchronously.
+     * @param id - Case-insensitive object ID.
+     * @returns Whether the ID is configured.
+     */
+    has(id) { this.#assertOpen(); return this.#byId.has(id.toLowerCase()); }
+    /** Look up a stable handle synchronously.
+     * @param id - Case-insensitive object ID.
+     * @returns The same handle instance for repeated lookups of one canonical ID.
+     * @throws ObjectNotFoundError for an unknown ID; lifecycle errors after close.
+     */
+    get(id) {
+        this.#assertOpen();
+        const canonical = this.#byId.get(id.toLowerCase());
+        if (canonical === undefined)
+            throw new ObjectNotFoundError({ message: `Unknown object: ${id}`, code: 505, operation: "lookup" });
+        let view = this.#views.get(canonical);
+        if (view === undefined) {
+            view = this.#create(canonical);
+            this.#views.set(canonical, view);
+        }
+        return view;
+    }
+    /** Look up a configured-order handle synchronously.
+     * @param index - Zero-based integer index; negative and fractional values are invalid.
+     * @returns The stable handle at the index.
+     * @throws RangeError for an out-of-range or noninteger index.
+     */
+    at(index) {
+        this.#assertOpen();
+        const id = this.#ids[index];
+        if (!Number.isInteger(index) || id === undefined)
+            throw new RangeError(`Object index out of range: ${index}`);
+        return this.get(id);
+    }
+    /** Iterate handles in configured order.
+     * @returns Synchronous iterator, checking the owner on each lookup.
+     */
+    *[Symbol.iterator]() {
+        this.#assertOpen();
+        for (const id of this.#ids)
+            yield this.get(id);
+    }
+}
+/** Owner-bound node handles. Snapshot selections preserve requested order; omit IDs for all nodes. */
+export class NodeCollection extends ObjectCollection {
+    #call;
+    constructor(ids, call, assertOpen) {
+        super(ids, (id) => Node.create(id, call), assertOpen);
+        this.#call = call;
+    }
+    /** @internal */
+    static create(ids, call, assertOpen) { return new NodeCollection(ids, call, assertOpen); }
+    /** Read node hydraulics in `running`, `complete`, or `ended`.
+     * @param ids - Ordered selection; omit for all, use [] for empty columns. Unknown or case-insensitive duplicate IDs reject.
+     * @returns Detached columns aligned with canonical `objectIds`, without a timestamp.
+     */
+    snapshot(ids) { return this.#call("nodes", ids); }
+    /** Read node quality in `running`, `complete`, or `ended`.
+     * @param ids - Ordered IDs; omit for all or use [] for none. Unknown/duplicate IDs reject.
+     * @returns Detached pollutant-major matrices; inner rows follow `objectIds`.
+     */
+    qualitySnapshot(ids) { return this.#call("nodeQualitySnapshot", ids); }
+    /** Read cumulative node statistics in `running` or `complete`, before ending the run.
+     * @param ids - Ordered IDs; omit for all or use [] for none. Unknown/duplicate IDs reject.
+     * @returns Detached statistics columns aligned with canonical `objectIds`.
+     */
+    statisticsSnapshot(ids) { return this.#call("nodeStatisticsSnapshot", ids); }
+}
+/** Owner-bound link handles. Snapshot selections preserve requested order; omit IDs for all links. */
+export class LinkCollection extends ObjectCollection {
+    #call;
+    constructor(ids, call, assertOpen) {
+        super(ids, (id) => Link.create(id, call), assertOpen);
+        this.#call = call;
+    }
+    /** @internal */
+    static create(ids, call, assertOpen) { return new LinkCollection(ids, call, assertOpen); }
+    /** Read link hydraulics in `running`, `complete`, or `ended`.
+     * @param ids - Ordered IDs; omit for all or use [] for none. Unknown/duplicate IDs reject, including case-only duplicates.
+     * @returns Detached hydraulic columns aligned with canonical `objectIds`, without a timestamp.
+     */
+    snapshot(ids) { return this.#call("links", ids); }
+    /** Read link quality in `running`, `complete`, or `ended`.
+     * @param ids - Ordered IDs; omit for all or use [] for none. Unknown/duplicate IDs reject.
+     * @returns Detached pollutant-major matrices; inner rows follow `objectIds`.
+     */
+    qualitySnapshot(ids) { return this.#call("linkQualitySnapshot", ids); }
+    /** Read cumulative link statistics in `running` or `complete`.
+     * @param ids - Ordered IDs; omit for all or use [] for none. Unknown/duplicate IDs reject.
+     * @returns Detached scalar columns; flow-class durations have one seven-value row per link.
+     */
+    statisticsSnapshot(ids) { return this.#call("linkStatisticsSnapshot", ids); }
+}
+/** Owner-bound subcatchment handles and aligned hydraulic, quality, and statistics reads. */
+export class SubcatchmentCollection extends ObjectCollection {
+    #call;
+    constructor(ids, call, assertOpen) {
+        super(ids, (id) => Subcatchment.create(id, call), assertOpen);
+        this.#call = call;
+    }
+    /** @internal */
+    static create(ids, call, assertOpen) { return new SubcatchmentCollection(ids, call, assertOpen); }
+    /** Read runoff results in `running`, `complete`, or `ended`.
+     * @param ids - Ordered IDs; omit for all or use [] for none. Unknown/duplicate IDs reject, including case-only duplicates.
+     * @returns Detached runoff columns aligned with canonical `objectIds`, without a timestamp.
+     */
+    snapshot(ids) { return this.#call("subcatchments", ids); }
+    /** Read subcatchment quality in `running`, `complete`, or `ended`.
+     * @param ids - Ordered IDs; omit for all or use [] for none. Unknown/duplicate IDs reject.
+     * @returns Detached pollutant-major matrices; inner rows follow `objectIds`.
+     */
+    qualitySnapshot(ids) { return this.#call("subcatchmentQualitySnapshot", ids); }
+    /** Read cumulative runoff statistics in `running` or `complete`.
+     * @param ids - Ordered IDs; omit for all or use [] for none. Unknown/duplicate IDs reject.
+     * @returns Detached statistics columns aligned with canonical `objectIds`.
+     */
+    statisticsSnapshot(ids) { return this.#call("subcatchmentStatisticsSnapshot", ids); }
+}
+/** Owner-bound rain-gage handles. Rain gages provide per-object results, not collection snapshots. */
+export class RainGageCollection extends ObjectCollection {
+    constructor(ids, call, assertOpen) {
+        super(ids, (id) => RainGage.create(id, call), assertOpen);
+    }
+    /** @internal */
+    static create(ids, call, assertOpen) { return new RainGageCollection(ids, call, assertOpen); }
+}
+//# sourceMappingURL=collections.js.map

package/lib/swmmrs/objects/collections.js.map

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

package/lib/swmmrs/objects/definitions.d.ts

@@ -0,0 +1,215 @@
+import type { Call } from "../protocol.js";
+/** Operations used by definition handles. Main extends the worker protocol with these entries. */
+export interface DefinitionOperations {
+    aquiferConfiguration: {
+        args: [string];
+        result: AquiferConfiguration;
+    };
+    configureAquifer: {
+        args: [string, AquiferPatch];
+        result: void;
+    };
+    snowmeltConfiguration: {
+        args: [string];
+        result: SnowmeltParameterSetConfiguration;
+    };
+    configureSnowmelt: {
+        args: [string, SnowmeltParameterSetPatch];
+        result: void;
+    };
+    snowmeltSurfaceConfiguration: {
+        args: [string, SnowmeltSurfaceName];
+        result: SnowmeltSurfaceConfiguration;
+    };
+    configureSnowmeltSurface: {
+        args: [string, SnowmeltSurfaceName, SnowmeltSurfacePatch];
+        result: void;
+    };
+}
+/** Read-only identity for a configured definition. Generic handles do not expose editable curve/time-series data. */
+export declare class Definition {
+    /** Canonical configured definition ID. */
+    readonly id: string;
+    protected readonly call: Call;
+    protected constructor(id: string, call: Call);
+}
+/** Read-only pollutant identity handle. */
+export type Pollutant = Definition;
+/** Read-only land-use identity handle. */
+export type LandUse = Definition;
+/** Read-only time-pattern identity handle. */
+export type TimePattern = Definition;
+/** Read-only curve identity handle. */
+export type Curve = Definition;
+/** Read-only time-series identity handle. */
+export type TimeSeries = Definition;
+/** Read-only control-rule identity handle. */
+export type ControlRule = Definition;
+/** Read-only transect identity handle. */
+export type Transect = Definition;
+/** Read-only custom-shape identity handle. */
+export type CustomShape = Definition;
+/** Read-only street identity handle. */
+export type Street = Definition;
+/** Read-only inlet-design identity handle. */
+export type InletDesign = Definition;
+/** Detached aquifer declarations in configured project units. */
+export interface AquiferConfiguration {
+    /** Soil porosity fraction. */
+    readonly porosity: number;
+    /** Wilting-point moisture fraction. */
+    readonly wiltingPoint: number;
+    /** Field-capacity moisture fraction. */
+    readonly fieldCapacity: number;
+    /** Saturated hydraulic conductivity in project rainfall-rate units. */
+    readonly hydraulicConductivity: number;
+    /** Native conductivity-response slope. */
+    readonly conductivitySlope: number;
+    /** Tension-response slope in project length units (ft or m). */
+    readonly tensionSlope: number;
+    /** Fraction of evaporation drawn from the upper zone. */
+    readonly upperEvaporationFraction: number;
+    /** Lower-zone evaporation depth in project length units. */
+    readonly lowerEvaporationDepth: number;
+    /** Lower-zone loss coefficient in in/h or mm/h. */
+    readonly lowerLossCoefficient: number;
+    /** Aquifer bottom elevation in ft or m. */
+    readonly bottomElevation: number;
+    /** Initial water-table elevation in ft or m. */
+    readonly waterTableElevation: number;
+    /** Initial upper-zone moisture fraction. */
+    readonly upperMoisture: number;
+    /** Canonical upper-evaporation time-pattern ID, or null. */
+    readonly upperEvaporationPattern: string | null;
+}
+/** Sparse aquifer update; omitted fields retain their values. */
+export interface AquiferPatch {
+    /** {@inheritDoc AquiferConfiguration.porosity} */
+    porosity?: number;
+    /** {@inheritDoc AquiferConfiguration.wiltingPoint} */
+    wiltingPoint?: number;
+    /** {@inheritDoc AquiferConfiguration.fieldCapacity} */
+    fieldCapacity?: number;
+    /** {@inheritDoc AquiferConfiguration.hydraulicConductivity} */
+    hydraulicConductivity?: number;
+    /** {@inheritDoc AquiferConfiguration.conductivitySlope} */
+    conductivitySlope?: number;
+    /** {@inheritDoc AquiferConfiguration.tensionSlope} */
+    tensionSlope?: number;
+    /** {@inheritDoc AquiferConfiguration.upperEvaporationFraction} */
+    upperEvaporationFraction?: number;
+    /** {@inheritDoc AquiferConfiguration.lowerEvaporationDepth} */
+    lowerEvaporationDepth?: number;
+    /** {@inheritDoc AquiferConfiguration.lowerLossCoefficient} */
+    lowerLossCoefficient?: number;
+    /** {@inheritDoc AquiferConfiguration.bottomElevation} */
+    bottomElevation?: number;
+    /** {@inheritDoc AquiferConfiguration.waterTableElevation} */
+    waterTableElevation?: number;
+    /** {@inheritDoc AquiferConfiguration.upperMoisture} */
+    upperMoisture?: number;
+    /** Clear with null; omission retains the current relationship. */
+    upperEvaporationPattern?: string | null;
+}
+/** Editable aquifer handle obtained from `simulation.aquifers`. */
+export declare class Aquifer extends Definition {
+    private constructor();
+    /** Read aquifer declarations in any healthy owner state.
+     * @returns Detached aquifer configuration in project units.
+     */
+    configuration(): Promise<AquiferConfiguration>;
+    /** Atomically update aquifer declarations in `open` or `ended`; accepted edits return the owner to `open`.
+     * @param patch - Sparse field values; null clears the optional time-pattern relationship.
+     * @returns Resolves after all fields are accepted.
+     */
+    configure(patch: AquiferPatch): Promise<void>;
+}
+/** Snowmelt surface selector within a parameter set. */
+export type SnowmeltSurfaceName = "plowable" | "impervious" | "pervious";
+/** Detached snowmelt-surface declarations. */
+export interface SnowmeltSurfaceConfiguration {
+    /** Minimum melt coefficient in in/(h·°F) for US projects or mm/(h·°C) for SI projects. */
+    readonly minimumMeltCoefficient: number;
+    /** Maximum melt coefficient in in/(h·°F) for US projects or mm/(h·°C) for SI projects. */
+    readonly maximumMeltCoefficient: number;
+    /** Base melt temperature in °F for US projects or °C for SI projects. */
+    readonly baseTemperature: number;
+    /** Free-water holding-capacity fraction. */
+    readonly freeWaterFraction: number;
+    /** Initial snow water-equivalent depth in in or mm. */
+    readonly initialSnowDepth: number;
+    /** Initial free-water depth in in or mm. */
+    readonly initialFreeWater: number;
+    /** Snow water-equivalent depth for full coverage in in or mm. */
+    readonly snowDepthForFullCoverage: number;
+}
+/** Sparse snowmelt-surface update; omission retains a field. */
+export interface SnowmeltSurfacePatch {
+    /** {@inheritDoc SnowmeltSurfaceConfiguration.minimumMeltCoefficient} */
+    minimumMeltCoefficient?: number;
+    /** {@inheritDoc SnowmeltSurfaceConfiguration.maximumMeltCoefficient} */
+    maximumMeltCoefficient?: number;
+    /** {@inheritDoc SnowmeltSurfaceConfiguration.baseTemperature} */
+    baseTemperature?: number;
+    /** {@inheritDoc SnowmeltSurfaceConfiguration.freeWaterFraction} */
+    freeWaterFraction?: number;
+    /** {@inheritDoc SnowmeltSurfaceConfiguration.initialSnowDepth} */
+    initialSnowDepth?: number;
+    /** {@inheritDoc SnowmeltSurfaceConfiguration.initialFreeWater} */
+    initialFreeWater?: number;
+    /** {@inheritDoc SnowmeltSurfaceConfiguration.snowDepthForFullCoverage} */
+    snowDepthForFullCoverage?: number;
+}
+/** Detached snowmelt parameter set with all three surface records. */
+export interface SnowmeltParameterSetConfiguration {
+    /** Plowable fraction of impervious area. */
+    readonly plowableFraction: number;
+    /** Plowable-surface melt parameters. */
+    readonly plowable: SnowmeltSurfaceConfiguration;
+    /** Impervious-surface melt parameters. */
+    readonly impervious: SnowmeltSurfaceConfiguration;
+    /** Pervious-surface melt parameters. */
+    readonly pervious: SnowmeltSurfaceConfiguration;
+    /** Snow water-equivalent depth triggering plowing, in in or mm. */
+    readonly plowDepth: number;
+    /** Five removal fractions in native solver destination order. */
+    readonly removalFractions: readonly [number, number, number, number, number];
+    /** Canonical receiving subcatchment ID, or null. */
+    readonly removalSubcatchment: string | null;
+}
+/** Sparse parameter-set update; use `configureSurface` for individual surface parameters. */
+export interface SnowmeltParameterSetPatch {
+    /** {@inheritDoc SnowmeltParameterSetConfiguration.plowableFraction} */
+    plowableFraction?: number;
+    /** {@inheritDoc SnowmeltParameterSetConfiguration.plowDepth} */
+    plowDepth?: number;
+    /** {@inheritDoc SnowmeltParameterSetConfiguration.removalFractions} */
+    removalFractions?: readonly [number, number, number, number, number];
+    /** Clear with null; omission retains the current relationship. */
+    removalSubcatchment?: string | null;
+}
+/** Editable snowmelt parameter-set identity handle. */
+export declare class SnowmeltParameterSet extends Definition {
+    private constructor();
+    /** Read all parameter-set declarations in a healthy owner state.
+     * @returns Detached parameter set with three surface records.
+     */
+    configuration(): Promise<SnowmeltParameterSetConfiguration>;
+    /** Atomically update set-level declarations in `open` or `ended`; accepted edits return the owner to `open`.
+     * @param patch - Sparse set fields; null clears the optional receiving-subcatchment relation.
+     * @returns Resolves after the update is accepted.
+     */
+    configure(patch: SnowmeltParameterSetPatch): Promise<void>;
+    /** Read one surface in a healthy owner state.
+     * @param surface - Plowable, impervious, or pervious surface selector.
+     * @returns Detached surface parameters.
+     */
+    surfaceConfiguration(surface: SnowmeltSurfaceName): Promise<SnowmeltSurfaceConfiguration>;
+    /** Atomically update one surface in `open` or `ended`; accepted edits return the owner to `open`.
+     * @param surface - Surface to update.
+     * @param patch - Sparse surface values; omitted fields retain their values.
+     * @returns Resolves after all supplied fields are accepted.
+     */
+    configureSurface(surface: SnowmeltSurfaceName, patch: SnowmeltSurfacePatch): Promise<void>;
+}
+//# sourceMappingURL=definitions.d.ts.map

package/lib/swmmrs/objects/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../../src/swmmrs/objects/definitions.ts"],"names":[],"mappings":"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"}

package/lib/swmmrs/objects/definitions.js

@@ -0,0 +1,69 @@
+/** Read-only identity for a configured definition. Generic handles do not expose editable curve/time-series data. */
+export class Definition {
+    /** Canonical configured definition ID. */
+    id;
+    call;
+    constructor(id, call) {
+        this.id = id;
+        this.call = call;
+        Object.freeze(this);
+    }
+    /** @internal */
+    static create(id, call) { return new Definition(id, call); }
+}
+/** Editable aquifer handle obtained from `simulation.aquifers`. */
+export class Aquifer extends Definition {
+    constructor(id, call) { super(id, call); }
+    /** @internal */
+    static create(id, call) { return new Aquifer(id, call); }
+    /** Read aquifer declarations in any healthy owner state.
+     * @returns Detached aquifer configuration in project units.
+     */
+    configuration() {
+        return this.call("aquiferConfiguration", this.id);
+    }
+    /** Atomically update aquifer declarations in `open` or `ended`; accepted edits return the owner to `open`.
+     * @param patch - Sparse field values; null clears the optional time-pattern relationship.
+     * @returns Resolves after all fields are accepted.
+     */
+    configure(patch) {
+        return this.call("configureAquifer", this.id, patch);
+    }
+}
+/** Editable snowmelt parameter-set identity handle. */
+export class SnowmeltParameterSet extends Definition {
+    constructor(id, call) { super(id, call); }
+    /** @internal */
+    static create(id, call) {
+        return new SnowmeltParameterSet(id, call);
+    }
+    /** Read all parameter-set declarations in a healthy owner state.
+     * @returns Detached parameter set with three surface records.
+     */
+    configuration() {
+        return this.call("snowmeltConfiguration", this.id);
+    }
+    /** Atomically update set-level declarations in `open` or `ended`; accepted edits return the owner to `open`.
+     * @param patch - Sparse set fields; null clears the optional receiving-subcatchment relation.
+     * @returns Resolves after the update is accepted.
+     */
+    configure(patch) {
+        return this.call("configureSnowmelt", this.id, patch);
+    }
+    /** Read one surface in a healthy owner state.
+     * @param surface - Plowable, impervious, or pervious surface selector.
+     * @returns Detached surface parameters.
+     */
+    surfaceConfiguration(surface) {
+        return this.call("snowmeltSurfaceConfiguration", this.id, surface);
+    }
+    /** Atomically update one surface in `open` or `ended`; accepted edits return the owner to `open`.
+     * @param surface - Surface to update.
+     * @param patch - Sparse surface values; omitted fields retain their values.
+     * @returns Resolves after all supplied fields are accepted.
+     */
+    configureSurface(surface, patch) {
+        return this.call("configureSnowmeltSurface", this.id, surface, patch);
+    }
+}
+//# sourceMappingURL=definitions.js.map

package/lib/swmmrs/objects/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../../src/swmmrs/objects/definitions.ts"],"names":[],"mappings":"AAeA,qHAAqH;AACrH,MAAM,OAAO,UAAU;IACrB,0CAA0C;IACjC,EAAE,CAAS;IACD,IAAI,CAAO;IAE9B,YAAsB,EAAU,EAAE,IAAU;QAC1C,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,gBAAgB;IAChB,MAAM,CAAC,MAAM,CAAC,EAAU,EAAE,IAAU,IAAgB,OAAO,IAAI,UAAU,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;CACvF;AAmFD,mEAAmE;AACnE,MAAM,OAAO,OAAQ,SAAQ,UAAU;IACrC,YAAoB,EAAU,EAAE,IAAU,IAAI,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAEhE,gBAAgB;IAChB,MAAM,CAAC,MAAM,CAAC,EAAU,EAAE,IAAU,IAAa,OAAO,IAAI,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAEhF;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,KAAmB;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC;CACF;AAuED,uDAAuD;AACvD,MAAM,OAAO,oBAAqB,SAAQ,UAAU;IAClD,YAAoB,EAAU,EAAE,IAAU,IAAI,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAEhE,gBAAgB;IAChB,MAAM,CAAC,MAAM,CAAC,EAAU,EAAE,IAAU;QAClC,OAAO,IAAI,oBAAoB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IACrD,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,KAAgC;QACxC,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACxD,CAAC;IAED;;;OAGG;IACH,oBAAoB,CAAC,OAA4B;QAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,8BAA8B,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;IAED;;;;OAIG;IACH,gBAAgB,CAAC,OAA4B,EAAE,KAA2B;QACxE,OAAO,IAAI,CAAC,IAAI,CAAC,0BAA0B,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACxE,CAAC;CACF"}