@model-create/epanet-engine 0.8.0-alpha.9 → 0.9.0-alpha.1

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-// Generated from epanet2_2.h on 2026-03-01T05:14:14.541Z
+// Generated from epanet2_2.h on 2026-03-01T05:44:24.589Z
 // WARNING: This file is auto-generated. Do not edit manually.
 
 type Pointer = number;
@@ -84,7 +84,7 @@ from an input file then there is no need to call this function.
     _EN_init(ph: Pointer, rptFile: Pointer, outFile: Pointer, unitsType: number, headLossType: number): number;
 
     /**
-     * Opens an EPANET input file & reads in network data.
+     * Reads an EPANET input file with no errors allowed.
      *
      * @param ph an EPANET project handle.
      * @param inpFile the name of an existing EPANET-formatted input file.
@@ -92,10 +92,25 @@ from an input file then there is no need to call this function.
      * @param outFile the name of a binary output file to be created (or "" if not needed).
      * @returns an error code.
 This function should be called immediately after ::EN_createproject if an EPANET-formatted
-input file will be used to supply network data.
+input file will be used to supply network data. If errors are detected then the project is
+not opened and will not accept toolkit function calls.
      */
     _EN_open(ph: Pointer, inpFile: Pointer, rptFile: Pointer, outFile: Pointer): number;
 
+    /**
+     * Reads an EPANET input file with errors allowed.
+     *
+     * @param ph an EPANET project handle.
+     * @param inpFile the name of an existing EPANET-formatted input file.
+     * @param rptFile the name of a report file to be created (or "" if not needed).
+     * @param outFile the name of a binary output file to be created (or "" if not needed).
+     * @returns an error code.
+This function should be called immediately after ::EN_createproject if an EPANET-formatted
+input file will be used to supply network data. If formatting errors are detected (error
+code = 200) then the project remains open and will accept toolkit function calls.
+     */
+    _EN_openX(ph: Pointer, inpFile: Pointer, rptFile: Pointer, outFile: Pointer): number;
+
     /**
      * Retrieves the title lines of the project
      *
@@ -135,27 +150,49 @@ input file will be used to supply network data.
      * @param ph an EPANET project handle.
      * @param object a type of object (either EN_NODE, EN_LINK, EN_TIMEPAT or EN_CURVE)
      * @param index the object's index starting from 1
-     * @param comment [out] the comment string assigned to the object
+     * @param comment the comment string assigned to the object
      * @returns an error code
      */
     _EN_setcomment(ph: Pointer, object: number, index: number, comment: Pointer): number;
 
+    /**
+     * Retrieves a tag string assigned to a Node or Link.
+     *
+     * @param ph an EPANET project handle.
+     * @param object a type of object (either EN_NODE or EN_LINK)
+     * @param index the object's index starting from 1
+     * @param out_tag [out] the tag string assigned to the object
+     * @returns an error code
+     */
+    _EN_gettag(ph: Pointer, object: number, index: number, out_tag: Pointer): number;
+
+    /**
+     * Assigns a tag string to a Node or Link.
+     *
+     * @param ph an EPANET project handle.
+     * @param object a type of object (either EN_NODE or EN_LINK)
+     * @param index the object's index starting from 1
+     * @param tag the tag string assigned to the object
+     * @returns an error code
+     */
+    _EN_settag(ph: Pointer, object: number, index: number, tag: Pointer): number;
+
     /**
      * Retrieves the number of objects of a given type in a project.
      *
      * @param ph an EPANET project handle.
      * @param object a type of object to count (see @ref EN_CountType)
-     * @param count [out] number of objects of the specified type
+     * @param out_count [out] number of objects of the specified type
      * @returns an error code
      */
-    _EN_getcount(ph: Pointer, object: number, count: Pointer): number;
+    _EN_getcount(ph: Pointer, object: number, out_count: Pointer): number;
 
     /**
      * Saves a project's data to an EPANET-formatted text file.
      *
      * @param ph an EPANET project handle.
      * @param filename the name of the file to create.
-     * @returns Error code
+     * @returns an error code
      */
     _EN_saveinpfile(ph: Pointer, filename: Pointer): number;
 
@@ -163,7 +200,7 @@ input file will be used to supply network data.
      * Closes a project and frees all of its memory.
      *
      * @param ph an EPANET project handle.
-     * @returns Error code
+     * @returns an error code
 This function clears all existing data from a project but does not delete the
 project, so it can be re-used with another set of network data. Use ::EN_deleteproject
 to actually delete a project from memory.
@@ -251,27 +288,27 @@ and ::EN_getlinkvalue.
      * Computes a hydraulic solution for the current point in time.
      *
      * @param ph an EPANET project handle.
-     * @param currentTime [out] the current simulation time in seconds.
+     * @param out_currentTime [out] the current simulation time in seconds.
      * @returns an error or warning code.
 This function is used in a loop with ::EN_nextH to run an extended period hydraulic
-simulation. This process automatically updates the simulation clock time so \b currentTime
+simulation. This process automatically updates the simulation clock time so `currentTime`
 should be treated as a read-only variable.
 ::EN_initH must have been called prior to running the ::EN_runH - ::EN_nextH loop.
 See ::EN_nextH for an example of using this function.
      */
-    _EN_runH(ph: Pointer, currentTime: Pointer): number;
+    _EN_runH(ph: Pointer, out_currentTime: Pointer): number;
 
     /**
      * Determines the length of time until the next hydraulic event occurs in an
 extended period simulation.
      *
      * @param ph an EPANET project handle.
-     * @param tStep [out] the time (in seconds) until the next hydraulic event or 0 if at
+     * @param out_tStep [out] the time (in seconds) until the next hydraulic event or 0 if at
 the end of the full simulation duration.
      * @returns an error code.
 This function is used in a loop with ::EN_runH to run an extended period hydraulic
 simulation.
-The value of \b tstep should be treated as a read-only variable. It is automatically
+The value of `out_tstep` should be treated as a read-only variable. It is automatically
 computed as the smaller of:
 - the time interval until the next hydraulic time step begins
 - the time interval until the next reporting time step begins
@@ -291,7 +328,7 @@ EN_nextH(ph, &tstep);
 EN_closeH(ph);
 \endcode
      */
-    _EN_nextH(ph: Pointer, tStep: Pointer): number;
+    _EN_nextH(ph: Pointer, out_tStep: Pointer): number;
 
     /**
      * Transfers a project's hydraulics results from its temporary hydraulics file
@@ -317,7 +354,7 @@ The hydraulics file contains nodal demands and heads and link flows, status, and
 for all hydraulic time steps, even intermediate ones.
 Before calling this function hydraulic results must have been generated and saved by having
 called ::EN_solveH or the ::EN_initH - ::EN_runH - ::EN_nextH sequence with the initflag
-argument of ::EN_initH set to \b EN_SAVE or \b EN_SAVE_AND_INIT.
+argument of ::EN_initH set to `EN_SAVE` or `EN_SAVE_AND_INIT`.
      */
     _EN_savehydfile(ph: Pointer, filename: Pointer): number;
 
@@ -351,7 +388,7 @@ periods.
     /**
      * Opens a project's water quality solver.
      *
-     * @param ph n EPANET project handle.
+     * @param ph an EPANET project handle.
      * @returns an error code.
 Call ::EN_openQ prior to running the first water quality analysis using an
 ::EN_initQ - ::EN_runQ - ::EN_nextQ (or ::EN_stepQ) sequence. Multiple water
@@ -366,8 +403,8 @@ using ::EN_solveQ.
      * Initializes a network prior to running a water quality analysis.
      *
      * @param ph an EPANET project handle.
-     * @param saveFlag set to \b EN_SAVE (1) if results are to be saved to the project's
-binary output file, or to \b EN_NOSAVE (0) if not.
+     * @param saveFlag set to `EN_SAVE` (1) if results are to be saved to the project's
+binary output file, or to `EN_NOSAVE` (0) if not.
      * @returns an error code.
 Call ::EN_initQ prior to running a water quality analysis using ::EN_runQ in
 conjunction with either ::EN_nextQ or ::EN_stepQ.
@@ -381,7 +418,7 @@ Do not call ::EN_initQ if a complete water quality analysis will be made using :
 period available to a project's water quality solver.
      *
      * @param ph an EPANET project handle.
-     * @param currentTime [out] current simulation time in seconds.
+     * @param out_currentTime [out] current simulation time in seconds.
      * @returns an error code.
 Use ::EN_runQ along with ::EN_nextQ in a loop to access water quality results at the
 start of each hydraulic period in an extended period simulation. Or use it in a loop
@@ -389,24 +426,24 @@ with ::EN_stepQ to access results at the start of each water quality time step.
 each of these functions for examples of how to code such loops.
 ::EN_initQ must have been called prior to running an ::EN_runQ - ::EN_nextQ
 (or ::EN_stepQ) loop.
-The current time of the simulation is determined from information saved with the
-hydraulic analysis that preceded the water quality analysis. Treat it as a read-only
-variable.
+The current time of the simulation, `out_currentTime`, is determined from information
+saved with the hydraulic analysis that preceded the water quality analysis. Treat it
+as a read-only variable.
      */
-    _EN_runQ(ph: Pointer, currentTime: Pointer): number;
+    _EN_runQ(ph: Pointer, out_currentTime: Pointer): number;
 
     /**
      * Advances a water quality simulation over the time until the next hydraulic event.
      *
      * @param ph an EPANET project handle.
-     * @param tStep [out] time (in seconds) until the next hydraulic event or 0 if at the end
+     * @param out_tStep [out] time (in seconds) until the next hydraulic event or 0 if at the end
 of the full simulation duration.
      * @returns an error code.
 This function is used in a loop with ::EN_runQ to perform an extended period water
 quality analysis. It reacts and routes a project's water quality constituent over a
 time step determined by when the next hydraulic event occurs. Use ::EN_stepQ instead
 if you wish to generate results over each water quality time step.
-The value of \b tStep is determined from information produced by the hydraulic analysis
+The value of `out_tStep` is determined from information produced by the hydraulic analysis
 that preceded the water quality analysis. Treat it as a read-only variable.
 <b>Example:</b>
 \code {.c}
@@ -423,22 +460,22 @@ EN_nextQ(ph, &tStep);
 EN_closeQ(ph);
 \endcode
      */
-    _EN_nextQ(ph: Pointer, tStep: Pointer): number;
+    _EN_nextQ(ph: Pointer, out_tStep: Pointer): number;
 
     /**
      * Advances a water quality simulation by a single water quality time step.
      *
      * @param ph an EPANET project handle.
-     * @param timeLeft [out] time left (in seconds) to the overall simulation duration.
+     * @param out_timeLeft [out] time left (in seconds) to the overall simulation duration.
      * @returns an error code.
 This function is used in a loop with ::EN_runQ to perform an extended period water
 quality simulation. It allows one to generate water quality results at each water
 quality time step of the simulation, rather than over each hydraulic event period
 as with ::EN_nextQ.
-Use the argument \b timeLeft to determine when no more calls to ::EN_runQ are needed
-because the end of the simulation period has been reached (i.e., when \b timeLeft = 0).
+Use the argument `out_timeLeft` to determine when no more calls to ::EN_runQ are needed
+because the end of the simulation period has been reached (i.e., when `out_timeLeft` = 0).
      */
-    _EN_stepQ(ph: Pointer, timeLeft: Pointer): number;
+    _EN_stepQ(ph: Pointer, out_timeLeft: Pointer): number;
 
     /**
      * Closes the water quality solver, freeing all of its allocated memory.
@@ -451,12 +488,44 @@ Do not call this function if ::EN_solveQ is being used.
      */
     _EN_closeQ(ph: Pointer): number;
 
+    /**
+     * Sets a user-supplied callback function for reporting
+     *
+     * @param ph an EPANET project handle.
+     * @param callback a function pointer used for reporting.
+     * @returns an error code.
+The callback function replaces the project's report file as
+the destination for all output written by ::EN_writeline. It must have
+the following signature:
+`void(void *userData, void *EN_projectHandle p, const char* s)`
+The `userData` parameter is a pointer to a client-side data object.
+It can be changed using the ::EN_setreportcallbackuserdata function.
+The parameter `s` is a placeholder for the EPANET-generated string
+that was passed into ::EN_writeline. Setting the callback function to
+NULL reverts to having ::EN_writeline use the project's report file.
+     */
+    _EN_setreportcallback(ph: Pointer, callback: Pointer): number;
+
+    /**
+     * Sets a pointer to a client-side data object
+     *
+     * @param ph an EPANET project handle.
+     * @param userData a pointer to a client-side data object.
+     * @returns an error code.
+The data pointer supplied by this function is passed into the callback
+function declared in ::EN_setreportcallback that replaces a project's
+report file as the destination for output written with ::EN_writeline.
+     */
+    _EN_setreportcallbackuserdata(ph: Pointer, userData: Pointer): number;
+
     /**
      * Writes a line of text to a project's report file.
      *
      * @param ph an EPANET project handle.
      * @param line a text string to write.
      * @returns an error code.
+::EN_setreportcallback can be used to assign an alternative destination
+to write `line` to in place of the project's report file.
      */
     _EN_writeline(ph: Pointer, line: Pointer): number;
 
@@ -530,25 +599,25 @@ using the ::EN_report function.
      * @returns an error code.
 Status reporting writes changes in the hydraulics status of network elements to a
 project's  report file as a hydraulic simulation unfolds. There are three levels
-of reporting: \b EN_NO_REPORT (no status reporting), \b EN_NORMAL_REPORT (normal
-reporting) \b EN_FULL_REPORT (full status reporting).
+of reporting: `EN_NO_REPORT` (no status reporting), `EN_NORMAL_REPORT` (normal
+reporting) `EN_FULL_REPORT` (full status reporting).
 The full status report contains information at each trial of the solution to the
 system hydraulic equations at each time step of a simulation. It is useful mainly
 for debugging purposes.
 If many hydraulic analyses will be run in the application it is recommended that
-status reporting be turned off (<b>level = EN_NO_REPORT</b>).
+status reporting be turned off (`level` = `EN_NO_REPORT`).
      */
     _EN_setstatusreport(ph: Pointer, level: number): number;
 
     /**
      * Retrieves the toolkit API version number.
      *
-     * @param version [out] the version of the OWA-EPANET toolkit.
+     * @param out_version [out] the version of the OWA-EPANET toolkit.
      * @returns an error code.
 The version number is to be interpreted with implied decimals, i.e.,
 "20100" == "2(.)01(.)00"
      */
-    _EN_getversion(version: Pointer): number;
+    _EN_getversion(out_version: Pointer): number;
 
     /**
      * Returns the text of an error message generated by an error code.
@@ -557,7 +626,7 @@ The version number is to be interpreted with implied decimals, i.e.,
      * @param out_errmsg [out] the error message generated by the error code
      * @param maxLen maximum number of characters that errmsg can hold
      * @returns an error code
-Error message strings should be at least @ref EN_SizeLimits "EN_MAXMSG" characters in length.
+Error message strings should be greater than @ref EN_SizeLimits "EN_MAXMSG" characters in length.
      */
     _EN_geterror(errcode: number, out_errmsg: Pointer, maxLen: number): number;
 
@@ -566,10 +635,21 @@ Error message strings should be at least @ref EN_SizeLimits "EN_MAXMSG" characte
      *
      * @param ph an EPANET project handle.
      * @param type the type of statistic to retrieve (see @ref EN_AnalysisStatistic).
-     * @param value [out] the value of the statistic.
+     * @param out_value [out] the value of the statistic.
      * @returns an error code
      */
-    _EN_getstatistic(ph: Pointer, type: number, value: Pointer): number;
+    _EN_getstatistic(ph: Pointer, type: number, out_value: Pointer): number;
+
+    /**
+     * Gets information about when the next hydraulic time step occurs.
+     *
+     * @param ph an EPANET project handle.
+     * @param eventType [out] the type of event that will occur (see @ref EN_TimestepEvent).
+     * @param duration [out] the amount of time in the future this event will occur
+     * @param elementIndex [out] the index of the element causing the event.
+     * @returns an error code.
+     */
+    _EN_timetonextevent(ph: Pointer, eventType: Pointer, duration: Pointer, elementIndex: Pointer): number;
 
     /**
      * Retrieves the order in which a node or link appears in an @ref OutFile "output file".
@@ -577,27 +657,27 @@ Error message strings should be at least @ref EN_SizeLimits "EN_MAXMSG" characte
      * @param ph an EPANET project handle.
      * @param type a type of element (either @ref EN_NODE or @ref EN_LINK).
      * @param index the element's current index (starting from 1).
-     * @param value [out] the order in which the element's results were written to file.
+     * @param out_value [out] the order in which the element's results were written to file.
      * @returns an error code.
 If the element does not appear in the file then its result index is 0.
 This function can be used to correctly retrieve results from an EPANET binary output file
 after the order of nodes or links in a network's database has been changed due to editing
 operations.
      */
-    _EN_getresultindex(ph: Pointer, type: number, index: number, value: Pointer): number;
+    _EN_getresultindex(ph: Pointer, type: number, index: number, out_value: Pointer): number;
 
     /**
      * Retrieves the value of an analysis option.
      *
      * @param ph an EPANET project handle.
      * @param option a type of analysis option (see @ref EN_Option).
-     * @param value [out] the current value of the option.
+     * @param out_value [out] the current value of the option.
      * @returns an error code
      */
-    _EN_getoption(ph: Pointer, option: number, value: Pointer): number;
+    _EN_getoption(ph: Pointer, option: number, out_value: Pointer): number;
 
     /**
-     * Sets the value for an anlysis option.
+     * Sets the value for an analysis option.
      *
      * @param ph an EPANET project handle.
      * @param option a type of analysis option (see @ref EN_Option).
@@ -611,12 +691,12 @@ operations.
      * Retrieves a project's flow units.
      *
      * @param ph an EPANET project handle.
-     * @param units [out] a flow units code (see @ref EN_FlowUnits)
+     * @param out_units [out] a flow units code (see @ref EN_FlowUnits)
      * @returns an error code.
 Flow units in liters or cubic meters implies that SI metric units are used for all
 other quantities in addition to flow. Otherwise US Customary units are employed.
      */
-    _EN_getflowunits(ph: Pointer, units: Pointer): number;
+    _EN_getflowunits(ph: Pointer, out_units: Pointer): number;
 
     /**
      * Sets a project's flow units.
@@ -634,10 +714,10 @@ other quantities in addition to flow. Otherwise US Customary units are employed.
      *
      * @param ph an EPANET project handle.
      * @param param a time parameter code (see @ref EN_TimeParameter).
-     * @param value [out] the current value of the time parameter (in seconds).
+     * @param out_value [out] the current value of the time parameter (in seconds).
      * @returns an error code.
      */
-    _EN_gettimeparam(ph: Pointer, param: number, value: Pointer): number;
+    _EN_gettimeparam(ph: Pointer, param: number, out_value: Pointer): number;
 
     /**
      * Sets the value of a time parameter.
@@ -653,23 +733,23 @@ other quantities in addition to flow. Otherwise US Customary units are employed.
      * Gets information about the type of water quality analysis requested.
      *
      * @param ph an EPANET project handle.
-     * @param qualType [out] type of analysis to run (see @ref EN_QualityType).
+     * @param out_qualType [out] type of analysis to run (see @ref EN_QualityType).
      * @param out_chemName [out] name of chemical constituent.
      * @param out_chemUnits [out] concentration units of the constituent.
-     * @param traceNode [out] index of the node being traced (if applicable).
+     * @param out_traceNode [out] index of the node being traced (if applicable).
      * @returns an error code.
      */
-    _EN_getqualinfo(ph: Pointer, qualType: Pointer, out_chemName: Pointer, out_chemUnits: Pointer, traceNode: Pointer): number;
+    _EN_getqualinfo(ph: Pointer, out_qualType: Pointer, out_chemName: Pointer, out_chemUnits: Pointer, out_traceNode: Pointer): number;
 
     /**
      * Retrieves the type of water quality analysis to be run.
      *
      * @param ph an EPANET project handle.
-     * @param qualType [out] the type of analysis to run (see @ref EN_QualityType).
-     * @param traceNode [out] the index of node being traced, if <b>qualType = EN_TRACE</b>.
+     * @param out_qualType [out] the type of analysis to run (see @ref EN_QualityType).
+     * @param out_traceNode [out] the index of node being traced if `out_qualType` = `EN_TRACE`.
      * @returns an error code.
      */
-    _EN_getqualtype(ph: Pointer, qualType: Pointer, traceNode: Pointer): number;
+    _EN_getqualtype(ph: Pointer, out_qualType: Pointer, out_traceNode: Pointer): number;
 
     /**
      * Sets the type of water quality analysis to run.
@@ -678,7 +758,7 @@ other quantities in addition to flow. Otherwise US Customary units are employed.
      * @param qualType the type of analysis to run (see @ref EN_QualityType).
      * @param chemName the name of the quality constituent.
      * @param chemUnits the concentration units of the constituent.
-     * @param traceNode the ID name of the node being traced if <b>qualType = EN_TRACE</b>.
+     * @param traceNode the ID name of the node being traced if `qualType` = `EN_TRACE`.
      * @returns an error code.
 Chemical name and units can be an empty string if the analysis is not for a chemical.
 The same holds for the trace node if the analysis is not for source tracing.
@@ -692,11 +772,11 @@ Note that the trace node is specified by ID name and not by index.
      * @param ph an EPANET project handle.
      * @param id the ID name of the node to be added.
      * @param nodeType the type of node being added (see @ref EN_NodeType)
-     * @param index [out] the index of the newly added node
+     * @param out_index [out] the index of the newly added node
      * @returns an error code.
 When a new node is created all of its properties (see @ref EN_NodeProperty) are set to 0.
      */
-    _EN_addnode(ph: Pointer, id: Pointer, nodeType: number, index: Pointer): number;
+    _EN_addnode(ph: Pointer, id: Pointer, nodeType: number, out_index: Pointer): number;
 
     /**
      * Deletes a node from a project.
@@ -705,9 +785,9 @@ When a new node is created all of its properties (see @ref EN_NodeProperty) are
      * @param index the index of the node to be deleted.
      * @param actionCode the action taken if any control contains the node and its links.
      * @returns an error code.
-If \b actionCode is \b EN_UNCONDITIONAL then the node, its incident links and all
+If `actionCode` is `EN_UNCONDITIONAL` then the node, its incident links and all
 simple and rule-based controls that contain them are deleted. If set to
-\b EN_CONDITIONAL then the node is not deleted if it or its incident links appear
+`EN_CONDITIONAL` then the node is not deleted if it or its incident links appear
 in any controls and error code 261 is returned.
      */
     _EN_deletenode(ph: Pointer, index: number, actionCode: number): number;
@@ -717,10 +797,10 @@ in any controls and error code 261 is returned.
      *
      * @param ph an EPANET project handle.
      * @param id a node ID name.
-     * @param index [out] the node's index (starting from 1).
+     * @param out_index [out] the node's index (starting from 1).
      * @returns an error code
      */
-    _EN_getnodeindex(ph: Pointer, id: Pointer, index: Pointer): number;
+    _EN_getnodeindex(ph: Pointer, id: Pointer, out_index: Pointer): number;
 
     /**
      * Gets the ID name of a node given its index.
@@ -729,7 +809,7 @@ in any controls and error code 261 is returned.
      * @param index a node's index (starting from 1).
      * @param out_id [out] the node's ID name.
      * @returns an error code
-The ID name must be sized to hold at least @ref EN_SizeLimits "EN_MAXID" characters.
+The ID name must be sized to hold at least @ref EN_SizeLimits "EN_MAXID+1" characters.
      */
     _EN_getnodeid(ph: Pointer, index: number, out_id: Pointer): number;
 
@@ -749,23 +829,10 @@ The ID name must not be longer than @ref EN_SizeLimits "EN_MAXID" characters.
      *
      * @param ph an EPANET project handle.
      * @param index a node's index (starting from 1).
-     * @param nodeType [out] the node's type (see @ref EN_NodeType).
-     * @returns an error code.
-     */
-    _EN_getnodetype(ph: Pointer, index: number, nodeType: Pointer): number;
-
-    /**
-     * Retrieves a property value for a node.
-     *
-     * @param ph an EPANET project handle.
-     * @param index a node's index.
-     * @param property the property to retrieve (see @ref EN_NodeProperty).
-     * @param value [out] the current value of the property.
+     * @param out_nodeType [out] the node's type (see @ref EN_NodeType).
      * @returns an error code.
-Values are returned in units that depend on the units used for flow rate
-(see @ref Units).
      */
-    _EN_getnodevalue(ph: Pointer, index: number, property: number, value: Pointer): number;
+    _EN_getnodetype(ph: Pointer, index: number, out_nodeType: Pointer): number;
 
     /**
      * Sets a property value for a node.
@@ -814,11 +881,11 @@ These properties have units that depend on the units used for flow rate (see @re
      *
      * @param ph an EPANET project handle.
      * @param index a node index (starting from 1).
-     * @param x [out] the node's X-coordinate value.
-     * @param y [out] the node's Y-coordinate value.
+     * @param out_x [out] the node's X-coordinate value.
+     * @param out_y [out] the node's Y-coordinate value.
      * @returns an error code.
      */
-    _EN_getcoord(ph: Pointer, index: number, x: Pointer, y: Pointer): number;
+    _EN_getcoord(ph: Pointer, index: number, out_x: Pointer, out_y: Pointer): number;
 
     /**
      * Sets the (x,y) coordinates of a node.
@@ -835,14 +902,14 @@ These properties have units that depend on the units used for flow rate (see @re
      * Retrieves the type of demand model in use and its parameters.
      *
      * @param ph an EPANET project handle.
-     * @param type [out] Type of demand model (see @ref EN_DemandModel).
-     * @param pmin [out] Pressure below which there is no demand.
-     * @param preq [out] Pressure required to deliver full demand.
-     * @param pexp [out] Pressure exponent in demand function.
+     * @param out_type [out] Type of demand model (see @ref EN_DemandModel).
+     * @param out_pmin [out] Pressure below which there is no demand.
+     * @param out_preq [out] Pressure required to deliver full demand.
+     * @param out_pexp [out] Pressure exponent in demand function.
      * @returns an error code.
-Parameters <b>pmin, preq,</b> and \b pexp are only used when the demand model is \b EN_PDA.
+Parameters `out_pmin`, `out_preq`, and `out_pexp` are only used when the demand model is `EN_PDA`.
      */
-    _EN_getdemandmodel(ph: Pointer, type: Pointer, pmin: Pointer, preq: Pointer, pexp: Pointer): number;
+    _EN_getdemandmodel(ph: Pointer, out_type: Pointer, out_pmin: Pointer, out_preq: Pointer, out_pexp: Pointer): number;
 
     /**
      * Sets the type of demand model to use and its parameters.
@@ -853,14 +920,12 @@ Parameters <b>pmin, preq,</b> and \b pexp are only used when the demand model is
      * @param preq Pressure required to deliver full demand.
      * @param pexp Pressure exponent in demand function.
      * @returns an error code.
-Set \b type to \b EN_DDA for a traditional demand driven analysis (in which case the
-remaining three parameter values are ignored) or to \b EN_PDA for a pressure driven
-analysis. In the latter case a node's demand is computed as:
->  `Dfull * [ (P - pmin) / (preq - pmin) ] ^ pexp`
+Set `type` to `EN_DDA` for a traditional demand driven analysis (in which case the
+remaining three parameter values are ignored) or to `EN_PDA` for a pressure driven
+analysis. In the latter case a node's demand is 0 when pressure is below `pmin`, is at full demand when pressure is above `preq`, or is otherwise computed as:\n
+`Dfull * [ (P - pmin) / (preq - pmin) ] ^ pexp`\n
 where `Dfull` is the full demand and `P` is the current pressure.
-Setting \b preq equal to \b pmin will result in a solution with the smallest amount of
-demand reductions needed to insure that no node delivers positive demand at a pressure
-below \b pmin.
+A valid value for `preq` must be at least 0.1 pressure units larger than `pmin`.
      */
     _EN_setdemandmodel(ph: Pointer, type: number, pmin: number, preq: number, pexp: number): number;
 
@@ -894,20 +959,20 @@ that no time pattern or category name is associated with the demand.
      * @param ph an EPANET project handle.
      * @param nodeIndex the index of a node (starting from 1)
      * @param demandName the name of a demand category for the node
-     * @param demandIndex [out] the index of the demand being sought
+     * @param out_demandIndex [out] the index of the demand being sought
      * @returns an error code
      */
-    _EN_getdemandindex(ph: Pointer, nodeIndex: number, demandName: Pointer, demandIndex: Pointer): number;
+    _EN_getdemandindex(ph: Pointer, nodeIndex: number, demandName: Pointer, out_demandIndex: Pointer): number;
 
     /**
      * Retrieves the number of demand categories for a junction node.
      *
      * @param ph an EPANET project handle.
      * @param nodeIndex the index of a node (starting from 1).
-     * @param numDemands [out] the number of demand categories assigned to the node.
+     * @param out_numDemands [out] the number of demand categories assigned to the node.
      * @returns an error code.
      */
-    _EN_getnumdemands(ph: Pointer, nodeIndex: number, numDemands: Pointer): number;
+    _EN_getnumdemands(ph: Pointer, nodeIndex: number, out_numDemands: Pointer): number;
 
     /**
      * Gets the base demand for one of a node's demand categories.
@@ -915,10 +980,10 @@ that no time pattern or category name is associated with the demand.
      * @param ph an EPANET project handle.
      * @param nodeIndex a node's index (starting from 1).
      * @param demandIndex the index of a demand category for the node (starting from 1).
-     * @param baseDemand [out] the category's base demand.
+     * @param out_baseDemand [out] the category's base demand.
      * @returns an error code.
      */
-    _EN_getbasedemand(ph: Pointer, nodeIndex: number, demandIndex: number, baseDemand: Pointer): number;
+    _EN_getbasedemand(ph: Pointer, nodeIndex: number, demandIndex: number, out_baseDemand: Pointer): number;
 
     /**
      * Sets the base demand for one of a node's demand categories.
@@ -937,12 +1002,12 @@ that no time pattern or category name is associated with the demand.
      * @param ph an EPANET project handle.
      * @param nodeIndex the node's index (starting from 1).
      * @param demandIndex the index of a demand category for the node (starting from 1).
-     * @param patIndex [out] the index of the category's time pattern.
+     * @param out_patIndex [out] the index of the category's time pattern.
      * @returns an error code.
 A returned pattern index of 0 indicates that no time pattern has been assigned to the
 demand category.
      */
-    _EN_getdemandpattern(ph: Pointer, nodeIndex: number, demandIndex: number, patIndex: Pointer): number;
+    _EN_getdemandpattern(ph: Pointer, nodeIndex: number, demandIndex: number, out_patIndex: Pointer): number;
 
     /**
      * Sets the index of a time pattern used for one of a node's demand categories.
@@ -965,7 +1030,7 @@ demand category.
      * @param demandIndex the index of one of the node's demand categories (starting from 1).
      * @param out_demandName [out] The name of the selected category.
      * @returns an error code.
-\b demandName must be sized to contain at least @ref EN_SizeLimits "EN_MAXID" characters.
+`out_demandName` must be sized to contain at least @ref EN_SizeLimits "EN_MAXID+1" characters.
      */
     _EN_getdemandname(ph: Pointer, nodeIndex: number, demandIndex: number, out_demandName: Pointer): number;
 
@@ -976,7 +1041,7 @@ demand category.
      * @param nodeIndex a node's index (starting from 1).
      * @param demandIdx the index of one of the node's demand categories (starting from 1).
      * @param demandName the new name assigned to the category.
-     * @returns Error code.
+     * @returns an error code.
 The category name must contain no more than @ref EN_SizeLimits "EN_MAXID" characters.
      */
     _EN_setdemandname(ph: Pointer, nodeIndex: number, demandIdx: number, demandName: Pointer): number;
@@ -989,7 +1054,7 @@ The category name must contain no more than @ref EN_SizeLimits "EN_MAXID" charac
      * @param linkType The type of link being added (see @ref EN_LinkType)
      * @param fromNode The ID name of the link's starting node.
      * @param toNode The ID name of the link's ending node.
-     * @param index [out] the index of the newly added link.
+     * @param out_index [out] the index of the newly added link.
      * @returns an error code.
 A new pipe is assigned a diameter of 10 inches (254 mm) and a length of 330
 feet (~ 100 meters). Its roughness coefficient depends on the head loss formula in effect (see @ref EN_HeadLossType) as follows:
@@ -997,12 +1062,12 @@ feet (~ 100 meters). Its roughness coefficient depends on the head loss formula
 - Darcy-Weisbach formula: 0.5 millifeet (0.15 mm)
 - Chezy-Manning formula: 0.01
 All other pipe properties are set to 0.
-A new pump has a status of \b EN_OPEN, a speed setting of 1, and has no pump
+A new pump has a status of `EN_OPEN`, a speed setting of 1, and has no pump
 curve or power rating assigned to it.
 A new valve has a diameter of 10 inches (254 mm) and all other properties set to 0.
 See @ref EN_LinkProperty.
      */
-    _EN_addlink(ph: Pointer, id: Pointer, linkType: number, fromNode: Pointer, toNode: Pointer, index: Pointer): number;
+    _EN_addlink(ph: Pointer, id: Pointer, linkType: number, fromNode: Pointer, toNode: Pointer, out_index: Pointer): number;
 
     /**
      * Deletes a link from the project.
@@ -1011,8 +1076,8 @@ See @ref EN_LinkProperty.
      * @param index the index of the link to be deleted.
      * @param actionCode The action taken if any control contains the link.
      * @returns an error code.
-If \b actionCode is \b EN_UNCONDITIONAL then the link and all simple and rule-based
-controls that contain it are deleted. If set to \b EN_CONDITIONAL then the link
+If `actionCode` is `EN_UNCONDITIONAL` then the link and all simple and rule-based
+controls that contain it are deleted. If set to `EN_CONDITIONAL` then the link
 is not deleted if it appears in any control and error 261 is returned.
      */
     _EN_deletelink(ph: Pointer, index: number, actionCode: number): number;
@@ -1022,10 +1087,10 @@ is not deleted if it appears in any control and error 261 is returned.
      *
      * @param ph an EPANET project handle.
      * @param id a link's ID name.
-     * @param index [out] the link's index (starting from 1).
+     * @param out_index [out] the link's index (starting from 1).
      * @returns an error code.
      */
-    _EN_getlinkindex(ph: Pointer, id: Pointer, index: Pointer): number;
+    _EN_getlinkindex(ph: Pointer, id: Pointer, out_index: Pointer): number;
 
     /**
      * Gets the ID name of a link given its index.
@@ -1034,7 +1099,7 @@ is not deleted if it appears in any control and error 261 is returned.
      * @param index a link's index (starting from 1).
      * @param out_id [out] The link's ID name.
      * @returns an error code.
-The ID name must be sized to hold at least @ref EN_SizeLimits "EN_MAXID" characters.
+The ID name must be sized to hold at least @ref EN_SizeLimits "EN_MAXID+1" characters.
      */
     _EN_getlinkid(ph: Pointer, index: number, out_id: Pointer): number;
 
@@ -1044,7 +1109,7 @@ The ID name must be sized to hold at least @ref EN_SizeLimits "EN_MAXID" charact
      * @param ph an EPANET project handle.
      * @param index a link's index (starting from 1).
      * @param newid the new ID name for the link.
-     * @returns Error code.
+     * @returns an error code.
 The ID name must not be longer than @ref EN_SizeLimits "EN_MAXID" characters.
      */
     _EN_setlinkid(ph: Pointer, index: number, newid: Pointer): number;
@@ -1054,10 +1119,10 @@ The ID name must not be longer than @ref EN_SizeLimits "EN_MAXID" characters.
      *
      * @param ph an EPANET project handle.
      * @param index a link's index (starting from 1).
-     * @param linkType [out] the link's type (see @ref EN_LinkType).
+     * @param out_linkType [out] the link's type (see @ref EN_LinkType).
      * @returns an error code.
      */
-    _EN_getlinktype(ph: Pointer, index: number, linkType: Pointer): number;
+    _EN_getlinktype(ph: Pointer, index: number, out_linkType: Pointer): number;
 
     /**
      * Changes a link's type.
@@ -1067,10 +1132,11 @@ The ID name must not be longer than @ref EN_SizeLimits "EN_MAXID" characters.
      * @param linkType the new type to change the link to (see @ref EN_LinkType).
      * @param actionCode the action taken if any controls contain the link.
      * @returns an error code.
-If \b actionCode is \b EN_UNCONDITIONAL then all simple and rule-based controls that
+If `actionCode` is `EN_UNCONDITIONAL` then all simple and rule-based controls that
 contain the link are deleted when the link's type is changed. If set to
-\b EN_CONDITIONAL then the type change is cancelled if the link appears in any
+`EN_CONDITIONAL` then the type change is cancelled if the link appears in any
 control and error 261 is returned.
+To only change a valve's type (such as from PRV to PSV) use ::EN_setlinkvalue with property `EN_VALVE_TYPE` whose value is selected from the valves in @ref EN_LinkType.
      */
     _EN_setlinktype(ph: Pointer, inout_index: Pointer, linkType: number, actionCode: number): number;
 
@@ -1079,11 +1145,11 @@ control and error 261 is returned.
      *
      * @param ph an EPANET project handle.
      * @param index a link's index (starting from 1).
-     * @param node1 [out] the index of the link's start node (starting from 1).
-     * @param node2 [out] the index of the link's end node (starting from 1).
+     * @param out_node1 [out] the index of the link's start node (starting from 1).
+     * @param out_node2 [out] the index of the link's end node (starting from 1).
      * @returns an error code.
      */
-    _EN_getlinknodes(ph: Pointer, index: number, node1: Pointer, node2: Pointer): number;
+    _EN_getlinknodes(ph: Pointer, index: number, out_node1: Pointer, out_node2: Pointer): number;
 
     /**
      * Sets the indexes of a link's start- and end-nodes.
@@ -1102,11 +1168,22 @@ control and error 261 is returned.
      * @param ph an EPANET project handle.
      * @param index a link's index (starting from 1).
      * @param property the property to retrieve (see @ref EN_LinkProperty).
-     * @param value [out] the current value of the property.
+     * @param out_value [out] the current value of the property.
      * @returns an error code.
 Values are returned in units that depend on the units used for flow rate (see @ref Units).
      */
-    _EN_getlinkvalue(ph: Pointer, index: number, property: number, value: Pointer): number;
+    _EN_getlinkvalue(ph: Pointer, index: number, property: number, out_value: Pointer): number;
+
+    /**
+     * Retrieves an array of property values for all links.
+     *
+     * @param ph an EPANET project handle.
+     * @param property the property to retrieve (see @ref EN_LinkProperty).
+     * @param out_values [out] an array of values for all links.
+     * @returns an error code.
+Values are returned in units that depend on the units used for flow rate (see @ref Units).
+     */
+    _EN_getlinkvalues(ph: Pointer, property: number, out_values: Pointer): number;
 
     /**
      * Sets a property value for a link.
@@ -1139,22 +1216,34 @@ These properties have units that depend on the units used for flow rate (see @re
      *
      * @param ph an EPANET project handle.
      * @param index a link's index (starting from 1).
-     * @param count [out] the number of vertex points that describe the link's shape.
+     * @param out_count [out] the number of vertex points that describe the link's shape.
+     * @returns an error code.
+     */
+    _EN_getvertexcount(ph: Pointer, index: number, out_count: Pointer): number;
+
+    /**
+     * Retrieves the coordinates of a vertex point assigned to a link.
+     *
+     * @param ph an EPANET project handle.
+     * @param index a link's index (starting from 1).
+     * @param vertex a vertex point index (starting from 1).
+     * @param out_x [out] the vertex's X-coordinate value.
+     * @param out_y [out] the vertex's Y-coordinate value.
      * @returns an error code.
      */
-    _EN_getvertexcount(ph: Pointer, index: number, count: Pointer): number;
+    _EN_getvertex(ph: Pointer, index: number, vertex: number, out_x: Pointer, out_y: Pointer): number;
 
     /**
-     * Retrieves the coordinate's of a vertex point assigned to a link.
+     * Sets the coordinates of a vertex point assigned to a link.
      *
      * @param ph an EPANET project handle.
      * @param index a link's index (starting from 1).
      * @param vertex a vertex point index (starting from 1).
-     * @param x [out] the vertex's X-coordinate value.
-     * @param y [out] the vertex's Y-coordinate value.
+     * @param x the vertex's X-coordinate value.
+     * @param y the vertex's Y-coordinate value.
      * @returns an error code.
      */
-    _EN_getvertex(ph: Pointer, index: number, vertex: number, x: Pointer, y: Pointer): number;
+    _EN_setvertex(ph: Pointer, index: number, vertex: number, x: number, y: number): number;
 
     /**
      * Assigns a set of internal vertex points to a link.
@@ -1174,20 +1263,20 @@ Replaces any existing vertices previously assigned to the link.
      *
      * @param ph an EPANET project handle.
      * @param linkIndex the index of a pump link (starting from 1).
-     * @param pumpType [out] the type of head curve used by the pump (see @ref EN_PumpType).
+     * @param out_pumpType [out] the type of head curve used by the pump (see @ref EN_PumpType).
      * @returns an error code.
      */
-    _EN_getpumptype(ph: Pointer, linkIndex: number, pumpType: Pointer): number;
+    _EN_getpumptype(ph: Pointer, linkIndex: number, out_pumpType: Pointer): number;
 
     /**
      * Retrieves the curve assigned to a pump's head curve.
      *
      * @param ph an EPANET project handle.
      * @param linkIndex the index of a pump link (starting from 1).
-     * @param curveIndex [out] the index of the curve assigned to the pump's head curve.
+     * @param out_curveIndex [out] the index of the curve assigned to the pump's head curve.
      * @returns an error code.
      */
-    _EN_getheadcurveindex(ph: Pointer, linkIndex: number, curveIndex: Pointer): number;
+    _EN_getheadcurveindex(ph: Pointer, linkIndex: number, out_curveIndex: Pointer): number;
 
     /**
      * Assigns a curve to a pump's head curve.
@@ -1223,10 +1312,10 @@ The new pattern contains a single time period whose factor is 1.0.
      *
      * @param ph an EPANET project handle.
      * @param id the ID name of a time pattern.
-     * @param index [out] the time pattern's index (starting from 1).
+     * @param out_index [out] the time pattern's index (starting from 1).
      * @returns an error code.
      */
-    _EN_getpatternindex(ph: Pointer, id: Pointer, index: Pointer): number;
+    _EN_getpatternindex(ph: Pointer, id: Pointer, out_index: Pointer): number;
 
     /**
      * Retrieves the ID name of a time pattern given its index.
@@ -1235,7 +1324,7 @@ The new pattern contains a single time period whose factor is 1.0.
      * @param index a time pattern index (starting from 1).
      * @param out_id [out] the time pattern's ID name.
      * @returns an error code.
-The ID name must be sized to hold at least @ref EN_SizeLimits "EN_MAXID" characters.
+The ID name must be sized to hold at least @ref EN_SizeLimits "EN_MAXID+1" characters.
      */
     _EN_getpatternid(ph: Pointer, index: number, out_id: Pointer): number;
 
@@ -1255,10 +1344,10 @@ The new ID name must not exceed @ref EN_SizeLimits "EN_MAXID" characters.
      *
      * @param ph an EPANET project handle.
      * @param index a time pattern index (starting from 1).
-     * @param len [out] the number of time periods in the pattern.
+     * @param out_len [out] the number of time periods in the pattern.
      * @returns an error code.
      */
-    _EN_getpatternlen(ph: Pointer, index: number, len: Pointer): number;
+    _EN_getpatternlen(ph: Pointer, index: number, out_len: Pointer): number;
 
     /**
      * Retrieves a time pattern's factor for a given time period.
@@ -1266,10 +1355,10 @@ The new ID name must not exceed @ref EN_SizeLimits "EN_MAXID" characters.
      * @param ph an EPANET project handle.
      * @param index a time pattern index (starting from 1).
      * @param period a time period in the pattern (starting from 1).
-     * @param value [out] the pattern factor for the given time period.
+     * @param out_value [out] the pattern factor for the given time period.
      * @returns an error code.
      */
-    _EN_getpatternvalue(ph: Pointer, index: number, period: number, value: Pointer): number;
+    _EN_getpatternvalue(ph: Pointer, index: number, period: number, out_value: Pointer): number;
 
     /**
      * Sets a time pattern's factor for a given time period.
@@ -1287,10 +1376,10 @@ The new ID name must not exceed @ref EN_SizeLimits "EN_MAXID" characters.
      *
      * @param ph an EPANET project handle.
      * @param index a time pattern index (starting from 1).
-     * @param value [out] The average of all of the time pattern's factors.
+     * @param out_value [out] The average of all of the time pattern's factors.
      * @returns an error code.
      */
-    _EN_getaveragepatternvalue(ph: Pointer, index: number, value: Pointer): number;
+    _EN_getaveragepatternvalue(ph: Pointer, index: number, out_value: Pointer): number;
 
     /**
      * Sets the pattern factors for a given time pattern.
@@ -1300,12 +1389,22 @@ The new ID name must not exceed @ref EN_SizeLimits "EN_MAXID" characters.
      * @param values an array of new pattern factor values.
      * @param len the number of factor values supplied.
      * @returns an error code.
-\b values is a zero-based array that contains \b len elements.
+`values` is a zero-based array that contains `len` elements.
 Use this function to redefine (and resize) a time pattern all at once;
 use @ref EN_setpatternvalue to revise pattern factors one at a time.
      */
     _EN_setpattern(ph: Pointer, index: number, values: Pointer, len: number): number;
 
+    /**
+     * Loads time patterns from a file into a project under a specific pattern ID.
+     *
+     * @param ph an EPANET project handle.
+     * @param filename the name of the file containing pattern data.
+     * @param id the ID name of the new pattern to load.
+     * @returns an error code.
+     */
+    _EN_loadpatternfile(ph: Pointer, filename: Pointer, id: Pointer): number;
+
     /**
      * Adds a new data curve to a project.
      *
@@ -1330,10 +1429,10 @@ The new curve contains a single data point (1.0, 1.0).
      *
      * @param ph an EPANET project handle.
      * @param id the ID name of a curve.
-     * @param index [out] The curve's index (starting from 1).
+     * @param out_index [out] The curve's index (starting from 1).
      * @returns an error code.
      */
-    _EN_getcurveindex(ph: Pointer, id: Pointer, index: Pointer): number;
+    _EN_getcurveindex(ph: Pointer, id: Pointer, out_index: Pointer): number;
 
     /**
      * Retrieves the ID name of a curve given its index.
@@ -1342,7 +1441,7 @@ The new curve contains a single data point (1.0, 1.0).
      * @param index a curve's index (starting from 1).
      * @param out_id [out] the curve's ID name.
      * @returns an error code.
-The ID name must be sized to hold at least @ref EN_SizeLimits "EN_MAXID" characters.
+The ID name must be sized to hold at least @ref EN_SizeLimits "EN_MAXID+1" characters.
      */
     _EN_getcurveid(ph: Pointer, index: number, out_id: Pointer): number;
 
@@ -1362,20 +1461,30 @@ The new ID name must not exceed @ref EN_SizeLimits "EN_MAXID" characters.
      *
      * @param ph an EPANET project handle.
      * @param index a curve's index (starting from 1).
-     * @param len [out] The number of data points assigned to the curve.
+     * @param out_len [out] The number of data points assigned to the curve.
      * @returns an error code.
      */
-    _EN_getcurvelen(ph: Pointer, index: number, len: Pointer): number;
+    _EN_getcurvelen(ph: Pointer, index: number, out_len: Pointer): number;
 
     /**
      * Retrieves a curve's type.
      *
      * @param ph an EPANET project handle.
      * @param index a curve's index (starting from 1).
-     * @param type [out] the curve's type (see @ref EN_CurveType).
+     * @param out_type [out] the curve's type (see @ref EN_CurveType).
+     * @returns an error code.
+     */
+    _EN_getcurvetype(ph: Pointer, index: number, out_type: Pointer): number;
+
+    /**
+     * Sets a curve's type.
+     *
+     * @param ph an EPANET project handle.
+     * @param index a curve's index (starting from 1).
+     * @param type the curve's type (see @ref EN_CurveType).
      * @returns an error code.
      */
-    _EN_getcurvetype(ph: Pointer, index: number, type: Pointer): number;
+    _EN_setcurvetype(ph: Pointer, index: number, type: number): number;
 
     /**
      * Retrieves the value of a single data point for a curve.
@@ -1383,11 +1492,11 @@ The new ID name must not exceed @ref EN_SizeLimits "EN_MAXID" characters.
      * @param ph an EPANET project handle.
      * @param curveIndex a curve's index (starting from 1).
      * @param pointIndex the index of a point on the curve (starting from 1).
-     * @param x [out] the point's x-value.
-     * @param y [out] the point's y-value.
+     * @param out_x [out] the point's x-value.
+     * @param out_y [out] the point's y-value.
      * @returns an error code.
      */
-    _EN_getcurvevalue(ph: Pointer, curveIndex: number, pointIndex: number, x: Pointer, y: Pointer): number;
+    _EN_getcurvevalue(ph: Pointer, curveIndex: number, pointIndex: number, out_x: Pointer, out_y: Pointer): number;
 
     /**
      * Sets the value of a single data point for a curve.
@@ -1407,15 +1516,15 @@ The new ID name must not exceed @ref EN_SizeLimits "EN_MAXID" characters.
      * @param ph an EPANET project handle.
      * @param index a curve's index (starting from 1).
      * @param out_id [out] the curve's ID name.
-     * @param nPoints [out] the number of data points on the curve.
-     * @param xValues [out] the curve's x-values.
-     * @param yValues [out] the curve's y-values.
+     * @param out_nPoints [out] the number of data points on the curve.
+     * @param out_xValues [out] the curve's x-values.
+     * @param out_yValues [out] the curve's y-values.
      * @returns an error code.
-The calling program is responsible for making `xValues` and `yValues` large enough
-to hold `nPoints` number of data points and for sizing `id` to hold at least
-@ref EN_SizeLimits "EN_MAXID" characters.
+The calling program is responsible for making `out_xValues` and `out_yValues` large enough
+to hold `out_nPoints` number of data points and for sizing `out_id` to hold at least
+@ref EN_SizeLimits "EN_MAXID+1" characters.
      */
-    _EN_getcurve(ph: Pointer, index: number, out_id: Pointer, nPoints: Pointer, xValues: Pointer, yValues: Pointer): number;
+    _EN_getcurve(ph: Pointer, index: number, out_id: Pointer, out_nPoints: Pointer, out_xValues: Pointer, out_yValues: Pointer): number;
 
     /**
      * assigns a set of data points to a curve.
@@ -1426,7 +1535,7 @@ to hold `nPoints` number of data points and for sizing `id` to hold at least
      * @param yValues an array of new y-values for the curve.
      * @param nPoints the new number of data points for the curve.
      * @returns an error code.
-\b xValues and \b yValues are zero-based arrays that contains \b nPoints elements.
+`xValues` and `yValues` are zero-based arrays that contains `nPoints` elements.
 Use this function to redefine (and resize) a curve all at once;
 use @ref EN_setcurvevalue to revise a curve's data points one at a time.
      */
@@ -1440,13 +1549,13 @@ use @ref EN_setcurvevalue to revise a curve's data points one at a time.
      * @param linkIndex the index of a link to control (starting from 1).
      * @param setting control setting applied to the link.
      * @param nodeIndex index of the node used to control the link
-(0 for \b EN_TIMER and \b EN_TIMEOFDAY controls).
+(0 for `EN_TIMER` and `EN_TIMEOFDAY` controls).
      * @param level action level (tank level, junction pressure, or time in seconds)
 that triggers the control.
-     * @param index [out] index of the new control.
+     * @param out_index [out] index of the new control.
      * @returns an error code.
      */
-    _EN_addcontrol(ph: Pointer, type: number, linkIndex: number, setting: number, nodeIndex: number, level: number, index: Pointer): number;
+    _EN_addcontrol(ph: Pointer, type: number, linkIndex: number, setting: number, nodeIndex: number, level: number, out_index: Pointer): number;
 
     /**
      * Deletes an existing simple control.
@@ -1462,16 +1571,16 @@ that triggers the control.
      *
      * @param ph an EPANET project handle.
      * @param index the control's index (starting from 1).
-     * @param type [out] the type of control (see @ref EN_ControlType).
-     * @param linkIndex [out] the index of the link being controlled.
-     * @param setting [out] the control setting applied to the link.
-     * @param nodeIndex [out] the index of the node used to trigger the control
-(0 for \b EN_TIMER and  \b EN_TIMEOFDAY controls).
-     * @param level [out] the action level (tank level, junction pressure, or time in seconds)
+     * @param out_type [out] the type of control (see @ref EN_ControlType).
+     * @param out_linkIndex [out] the index of the link being controlled.
+     * @param out_setting [out] the control setting applied to the link.
+     * @param out_nodeIndex [out] the index of the node used to trigger the control
+(0 for `EN_TIMER` and  `EN_TIMEOFDAY` controls).
+     * @param out_level [out] the action level (tank level, junction pressure, or time in seconds)
 that triggers the control.
      * @returns an error code.
      */
-    _EN_getcontrol(ph: Pointer, index: number, type: Pointer, linkIndex: Pointer, setting: Pointer, nodeIndex: Pointer, level: Pointer): number;
+    _EN_getcontrol(ph: Pointer, index: number, out_type: Pointer, out_linkIndex: Pointer, out_setting: Pointer, out_nodeIndex: Pointer, out_level: Pointer): number;
 
     /**
      * Sets the properties of an existing simple control.
@@ -1482,13 +1591,33 @@ that triggers the control.
      * @param linkIndex the index of the link being controlled.
      * @param setting the control setting applied to the link.
      * @param nodeIndex the index of the node used to trigger the control
-(0 for \b EN_TIMER and \b EN_TIMEOFDAY controls).
+(0 for `EN_TIMER` and `EN_TIMEOFDAY` controls).
      * @param level the action level (tank level, junction pressure, or time in seconds)
 that triggers the control.
      * @returns an error code.
      */
     _EN_setcontrol(ph: Pointer, index: number, type: number, linkIndex: number, setting: number, nodeIndex: number, level: number): number;
 
+    /**
+     * Gets the enabled status of a simple control.
+     *
+     * @param ph an EPANET project handle.
+     * @param index the control's index (starting from 1).
+     * @param out_enabled `EN_TRUE` (= 1) if the control is enabled or `EN_FALSE` (= 0) if it is disabled.
+     * @returns an error code.
+     */
+    _EN_getcontrolenabled(ph: Pointer, index: number, out_enabled: Pointer): number;
+
+    /**
+     * Sets the enabled status of a simple control.
+     *
+     * @param ph an EPANET project handle.
+     * @param index the control's index (starting from 1).
+     * @param enabled `EN_TRUE` (= 1) sets the control to enabled, `EN_FALSE` (= 0) sets it to disabled.
+     * @returns an error code.
+     */
+    _EN_setcontrolenabled(ph: Pointer, index: number, enabled: number): number;
+
     /**
      * Adds a new rule-based control to a project.
      *
@@ -1514,13 +1643,13 @@ rule's format. Each clause of the rule must end with a newline character <b>`\n`
      *
      * @param ph an EPANET project handle.
      * @param index the rule's index (starting from 1).
-     * @param nPremises [out] number of premises in the rule's IF section.
-     * @param nThenActions [out] number of actions in the rule's THEN section.
-     * @param nElseActions [out] number of actions in the rule's ELSE section.
-     * @param priority [out] the rule's priority value.
+     * @param out_nPremises [out] number of premises in the rule's IF section.
+     * @param out_nThenActions [out] number of actions in the rule's THEN section.
+     * @param out_nElseActions [out] number of actions in the rule's ELSE section.
+     * @param out_priority [out] the rule's priority value.
      * @returns an error code.
      */
-    _EN_getrule(ph: Pointer, index: number, nPremises: Pointer, nThenActions: Pointer, nElseActions: Pointer, priority: Pointer): number;
+    _EN_getrule(ph: Pointer, index: number, out_nPremises: Pointer, out_nThenActions: Pointer, out_nElseActions: Pointer, out_priority: Pointer): number;
 
     /**
      * Gets the ID name of a rule-based control given its index.
@@ -1528,8 +1657,8 @@ rule's format. Each clause of the rule must end with a newline character <b>`\n`
      * @param ph an EPANET project handle.
      * @param index the rule's index (starting from 1).
      * @param out_id [out] the rule's ID name.
-     * @returns Error code.
-The ID name must be sized to hold at least @ref EN_SizeLimits "EN_MAXID" characters.
+     * @returns an error code.
+The ID name must be sized to hold at least @ref EN_SizeLimits "EN_MAXID+1" characters.
      */
     _EN_getruleID(ph: Pointer, index: number, out_id: Pointer): number;
 
@@ -1540,17 +1669,17 @@ The ID name must be sized to hold at least @ref EN_SizeLimits "EN_MAXID" charact
      * @param ruleIndex the rule's index (starting from 1).
      * @param premiseIndex the position of the premise in the rule's list of premises
 (starting from 1).
-     * @param logop [out] the premise's logical operator ( \b IF = 1, \b AND = 2, \b OR = 3 ).
-     * @param object [out] the type of object the premise refers to (see @ref EN_RuleObject).
-     * @param objIndex [out] the index of the object (e.g. the index of a tank).
-     * @param variable [out] the object's variable being compared (see @ref EN_RuleVariable).
-     * @param relop [out] the premise's comparison operator (see @ref EN_RuleOperator).
-     * @param status [out] the status that the object's status is compared to
+     * @param out_logop [out] the premise's logical operator (`IF` = 1, `AND` = 2, `OR` = 3` ).
+     * @param out_object [out] the type of object the premise refers to (see @ref EN_RuleObject).
+     * @param out_objIndex [out] the index of the object (e.g. the index of a tank).
+     * @param out_variable [out] the object's variable being compared (see @ref EN_RuleVariable).
+     * @param out_relop [out] the premise's comparison operator (see @ref EN_RuleOperator).
+     * @param out_status [out] the status that the object's status is compared to
 (see @ref EN_RuleStatus).
-     * @param value [out] the value that the object's variable is compared to.
+     * @param out_value [out] the value that the object's variable is compared to.
      * @returns an error code.
      */
-    _EN_getpremise(ph: Pointer, ruleIndex: number, premiseIndex: number, logop: Pointer, object: Pointer, objIndex: Pointer, variable: Pointer, relop: Pointer, status: Pointer, value: Pointer): number;
+    _EN_getpremise(ph: Pointer, ruleIndex: number, premiseIndex: number, out_logop: Pointer, out_object: Pointer, out_objIndex: Pointer, out_variable: Pointer, out_relop: Pointer, out_status: Pointer, out_value: Pointer): number;
 
     /**
      * Sets the properties of a premise in a rule-based control.
@@ -1558,7 +1687,7 @@ The ID name must be sized to hold at least @ref EN_SizeLimits "EN_MAXID" charact
      * @param ph an EPANET project handle.
      * @param ruleIndex the rule's index (starting from 1).
      * @param premiseIndex the position of the premise in the rule's list of premises.
-     * @param logop the premise's logical operator ( \b IF = 1, \b AND = 2, \b OR = 3 ).
+     * @param logop the premise's logical operator (`IF` = 1, `AND` = 2, `OR` = 3 ).
      * @param object the type of object the premise refers to (see @ref EN_RuleObject).
      * @param objIndex the index of the object (e.g. the index of a tank).
      * @param variable the object's variable being compared (see @ref EN_RuleVariable).
@@ -1610,12 +1739,12 @@ The ID name must be sized to hold at least @ref EN_SizeLimits "EN_MAXID" charact
      * @param ph an EPANET project handle.
      * @param ruleIndex the rule's index (starting from 1).
      * @param actionIndex the index of the THEN action to retrieve (starting from 1).
-     * @param linkIndex [out] the index of the link in the action (starting from 1).
-     * @param status [out] the status assigned to the link (see @ref EN_RuleStatus)
-     * @param setting [out] the value assigned to the link's setting.
+     * @param out_linkIndex [out] the index of the link in the action (starting from 1).
+     * @param out_status [out] the status assigned to the link (see @ref EN_RuleStatus)
+     * @param out_setting [out] the value assigned to the link's setting.
      * @returns an error code.
      */
-    _EN_getthenaction(ph: Pointer, ruleIndex: number, actionIndex: number, linkIndex: Pointer, status: Pointer, setting: Pointer): number;
+    _EN_getthenaction(ph: Pointer, ruleIndex: number, actionIndex: number, out_linkIndex: Pointer, out_status: Pointer, out_setting: Pointer): number;
 
     /**
      * Sets the properties of a THEN action in a rule-based control.
@@ -1636,12 +1765,12 @@ The ID name must be sized to hold at least @ref EN_SizeLimits "EN_MAXID" charact
      * @param ph an EPANET project handle.
      * @param ruleIndex the rule's index (starting from 1).
      * @param actionIndex the index of the ELSE action to retrieve (starting from 1).
-     * @param linkIndex [out] the index of the link in the action.
-     * @param status [out] the status assigned to the link (see @ref EN_RuleStatus).
-     * @param setting [out] the value assigned to the link's setting.
+     * @param out_linkIndex [out] the index of the link in the action.
+     * @param out_status [out] the status assigned to the link (see @ref EN_RuleStatus).
+     * @param out_setting [out] the value assigned to the link's setting.
      * @returns an error code.
      */
-    _EN_getelseaction(ph: Pointer, ruleIndex: number, actionIndex: number, linkIndex: Pointer, status: Pointer, setting: Pointer): number;
+    _EN_getelseaction(ph: Pointer, ruleIndex: number, actionIndex: number, out_linkIndex: Pointer, out_status: Pointer, out_setting: Pointer): number;
 
     /**
      * Sets the properties of an ELSE action in a rule-based control.
@@ -1665,6 +1794,26 @@ The ID name must be sized to hold at least @ref EN_SizeLimits "EN_MAXID" charact
      * @returns an error code.
      */
     _EN_setrulepriority(ph: Pointer, index: number, priority: number): number;
+
+    /**
+     * Gets the enabled status of a rule-based control.
+     *
+     * @param ph an EPANET project handle.
+     * @param index the rule's index (starting from 1).
+     * @param out_enabled the rule will be either EN_TRUE=enabled or EN_FALSE=disabled.
+     * @returns an error code.
+     */
+    _EN_getruleenabled(ph: Pointer, index: number, out_enabled: Pointer): number;
+
+    /**
+     * Sets the enabled status of a rule-based control.
+     *
+     * @param ph an EPANET project handle.
+     * @param index the rule's index (starting from 1).
+     * @param enabled set the rule to either EN_TRUE=enabled or EN_FALSE=disabled.
+     * @returns an error code.
+     */
+    _EN_setruleenabled(ph: Pointer, index: number, enabled: number): number;
 }
 
 // Default export factory function matching Emscripten MODULARIZE=1 and EXPORT_ES6=1