@chilkat/react-native 11.6.1

package/src/specs/JsonObject.nitro.ts

@@ -0,0 +1,1454 @@
+// Generated by ReactNativeNs.RnGenerator -- do not edit.
+import type { HybridObject } from 'react-native-nitro-modules'
+import type { BinData } from './BinData.nitro'
+import type { CkDateTime } from './CkDateTime.nitro'
+import type { DtObj } from './DtObj.nitro'
+import type { Hashtable } from './Hashtable.nitro'
+import type { JsonArray } from './JsonArray.nitro'
+import type { StringBuilder } from './StringBuilder.nitro'
+import type { StringTable } from './StringTable.nitro'
+
+/**
+ * Load, navigate, create, modify, search, sort, and emit JSON objects.
+ *
+ * `JsonObject` provides DOM-style access to JSON objects.
+ * It can load, inspect, modify, create, search, sort, emit, and save JSON data.
+ * It supports path-based access, index-based member access, automatic creation
+ * of nested paths, object and array references, Firebase-style updates, record
+ * searches, date/time conversion, binary data encoding, variable substitution,
+ * and optional secure secret resolution.
+ *
+ * **Load and emit JSON**
+ *
+ * Load JSON from strings, files, buffers, or Chilkat objects, then emit the
+ * result as compact or pretty-formatted JSON.
+ *
+ * **Path-based navigation**
+ *
+ * Read and update nested values using JSON paths, with support for
+ * automatically creating missing object or array paths.
+ *
+ * **Member access**
+ *
+ * Access object members by name or index, inspect member types, retrieve
+ * values, and remove or rename members as needed.
+ *
+ * **Nested objects and arrays**
+ *
+ * Work directly with child `JsonObject` and
+ * `JsonArray` references to navigate and modify complex JSON
+ * structures.
+ *
+ * **Search and transform**
+ *
+ * Search records, sort object members, perform Firebase-style updates, and
+ * prepare JSON for API requests or application storage.
+ *
+ * **Special value handling**
+ *
+ * Handle date/time values, binary data encodings, exact numeric text,
+ * variable substitution, and secure secret resolution.
+ *
+ * **Common pattern:**
+ * Load or create a `JsonObject`, navigate named members and nested
+ * paths, retrieve child arrays as `JsonArray` objects when ordered
+ * lists are encountered, update values as needed, then emit or save the final
+ * JSON. Use `JsonObject` for named JSON members and
+ * `JsonArray` for ordered lists.
+ *
+ * For an extended overview, see
+ * [JsonObject Class Overview](https://www.chilkatsoft.com/jsonobject_class_overview.asp).
+ *
+ * Each `JsonObject` instance owns a native Chilkat object. It is released when the JavaScript
+ * object is
+ * garbage collected, or immediately by `dispose()`; any use after `dispose()` throws.
+ * Create one with `new JsonObject()`.
+ */
+export interface JsonObject extends HybridObject<{ ios: 'c++', android: 'c++' }> {
+  // ---- Properties ----
+
+  /**
+   * Provides HTML-formatted information about the last called method or property. If a method call
+   * fails or behaves unexpectedly, check this property for details. Note that information is
+   * available regardless of the method call's success.
+   *
+   * This property is read-only.
+   */
+  readonly lastErrorHtml: string
+
+  /**
+   * Provides plain text information about the last called method or property. If a method call
+   * fails or behaves unexpectedly, check this property for details. Note that information is
+   * available regardless of the method call's success.
+   *
+   * This property is read-only.
+   */
+  readonly lastErrorText: string
+
+  /**
+   * Provides XML-formatted information about the last called method or property. If a method call
+   * fails or behaves unexpectedly, check this property for details. Note that information is
+   * available regardless of the method call's success.
+   *
+   * This property is read-only.
+   */
+  readonly lastErrorXml: string
+
+  /**
+   * Version of the component/library, such as "10.1.0"
+   *
+   * This property is read-only.
+   */
+  readonly version: string
+
+  /**
+   * If set to a file path, this property logs the LastErrorText of each Chilkat method or property
+   * call to the specified file. This logging helps identify the context and history of Chilkat
+   * calls leading up to any crash or hang, aiding in debugging.
+   *
+   * Enabling the VerboseLogging property provides more detailed information.
+   *
+   * This property is mainly used for debugging rare instances where a Chilkat method call causes a
+   * hang or crash, which should generally not happen.
+   *
+   * Possible causes of hangs include:
+   *
+   * - A timeout property set to 0, indicating an infinite timeout.
+   *
+   * - A hang occurring within an event callback in the application code.
+   *
+   * - An internal bug in the Chilkat code causing the hang.
+   */
+  debugLogFilePath: string
+
+  /**
+   * If set to `true`, then the contents of LastErrorText (or LastErrorXml, or LastErrorHtml) may
+   * contain more verbose information. The default value is `false`. Verbose logging should only be
+   * used for debugging. The potentially large quantity of logged information may adversely affect
+   * peformance.
+   */
+  verboseLogging: boolean
+
+  /**
+   * Indicates the success or failure of the most recent method call: `true` means success, `false`
+   * means failure. This property remains unchanged by property setters or getters. This method is
+   * present to address challenges in checking for null or Nothing returns in certain programming
+   * languages. Note: This property does not apply to methods that return integer values or to
+   * boolean-returning methods where the boolean does not indicate success or failure.
+   */
+  lastMethodSuccess: boolean
+
+  /**
+   * Specifies the character used to separate object-member names in Chilkat JSON paths. The default
+   * is `.`. Set it to `/` for Firebase-style paths. This property should contain exactly one
+   * character.
+   *
+   * **Arrays in paths:** Array indexes continue to use square brackets, such as `orders[0].id`. If
+   * a member name itself contains a path-separator character, quote that path component with double
+   * quotes.
+   */
+  delimiterChar: string
+
+  /**
+   * Controls whether emitted JSON is compact or pretty-printed. The default is `true`.
+   *
+   * | `_TRUE_` |  | Emit a compact representation with no extra formatting whitespace. |
+   *
+   * | `_FALSE_` |  | Emit indented, human-readable JSON. |
+   *
+   * **JSON semantics:** Formatting whitespace does not change the JSON data. Use compact output for
+   * transport/storage and pretty output for diagnostics or human review.
+   */
+  emitCompact: boolean
+
+  /**
+   * Controls line endings when pretty-printed JSON is emitted (`EmitCompact = _FALSE_`). The
+   * default is `true`.
+   *
+   * | `_TRUE_` |  | Use CRLF line endings. |
+   *
+   * | `_FALSE_` |  | Use LF line endings. |
+   *
+   * **Compact output:** This setting has no effect when `EmitCompact` is `true` because compact
+   * JSON is emitted without formatting line breaks.
+   */
+  emitCrLf: boolean
+
+  /**
+   * Supplies the integer substituted for `i` when a JSON path contains an array index such as
+   * `[i]`. This is useful for loop-based navigation without constructing a new path string for
+   * every iteration.
+   *
+   * **Related properties:** The `J` and `K` properties provide the same substitution behavior for
+   * `[j]` and `[k]`.
+   */
+  i: number
+
+  /**
+   * Supplies the integer substituted for `j` when a JSON path contains `[j]`. It is commonly used
+   * with nested-array paths such as `matrix[i][j]`.
+   */
+  j: number
+
+  /**
+   * Supplies the integer substituted for `k` when a JSON path contains `[k]`. It can be combined
+   * with `I` and `J` for deeper nested-array traversal.
+   */
+  k: number
+
+  /**
+   * Returns the number of direct name/value members in this JSON object. Nested members inside
+   * child objects are not included.
+   *
+   * **JSON objects and order:** RFC 8259 defines a JSON object as an unordered collection of
+   * name/value pairs. Chilkat preserves a member order so index-based APIs and deterministic
+   * emission are possible, but interoperable application logic should generally use member names
+   * rather than depend on object order.
+   *
+   * This property is read-only.
+   */
+  readonly size: number
+
+  /**
+   * Specifies a path prefix automatically prepended to JSON paths passed to path-based methods such
+   * as `StringOf`, `ObjectOf`, `UpdateString`, `SetBoolOf`, and `SizeOfArray`. The default is the
+   * empty string.
+   *
+   * **Use case:** Set a prefix when many operations target the same nested object. The individual
+   * method calls can then use paths relative to that prefix.
+   */
+  pathPrefix: string
+
+  /**
+   * If `true`, member names are converted to lowercase while JSON is loaded by `Load`, `LoadBd`,
+   * `LoadSb`, or `LoadFile`. The default is `false`.
+   *
+   * **Important:** This changes member names in the parsed document; it is not merely a
+   * case-insensitive lookup mode. Use it only when normalizing names is intentional.
+   */
+  lowerCaseNames: boolean
+
+  /**
+   * Provides a catch-all string for uncommon, implementation-specific options. The default is the
+   * empty string and it should normally remain empty.
+   *
+   * **Recommendation:** Do not invent option keywords. Set this property only when a specific
+   * `JsonObject` option is documented by Chilkat or provided by Chilkat support.
+   */
+  uncommonOptions: string
+
+  /**
+   * Enables automatic resolution of Chilkat secret specification strings for supported
+   * string-setting methods. The default is `false`. When enabled, a value beginning with `!!` can
+   * identify a credential stored in Windows Credential Manager or Apple Keychain instead of
+   * embedding the literal secret in application code.
+   *
+   * Secret specification format: `!![appName|]service[|domain]|username`.
+   *
+   * This feature applies to `AddStringAt`, `AppendString`, `SetStringAt`, `SetStringOf`,
+   * `UpdateSb`, and `UpdateString`.
+   *
+   * **Security:** Secret resolution changes where the string value comes from; the resulting JSON
+   * member still contains the resolved value. Avoid emitting or logging JSON that contains
+   * credentials unless that exposure is explicitly intended.
+   */
+  enableSecrets: boolean
+
+  /**
+   * When `Strict` is **true**, the Load methods first check that the data is well-formed JSON. If
+   * it is not, the load fails and the contents of this JsonObject are left **unchanged**. The
+   * default is `false`.
+   *
+   * This applies to {@link JsonObject.load}, {@link JsonObject.loadSb}, {@link JsonObject.loadBd},
+   * {@link JsonObject.loadFile} and {@link JsonObject.loadPredefined}.
+   *
+   * Chilkat's JSON parser is deliberately tolerant. By default it can accept text that is not
+   * well-formed, succeed, and leave an empty or partially populated document. That is convenient
+   * when the goal is a best-effort parse of imperfect input, but it is the wrong behavior when a
+   * silently missing member changes what the application does. A single missing comma, for example,
+   * can cause the members after it to be dropped while the load still reports success.
+   *
+   * Set `Strict` to `true` for JSON carrying configuration, credentials, or security parameters,
+   * where a member that quietly failed to load would be acted on as though it had never been
+   * specified.
+   *
+   * **Note:** The default is `false` so that existing applications are unaffected. When a strict
+   * load is rejected, this JsonObject keeps whatever it held before the call, so a failed reload
+   * never leaves the object empty.
+   */
+  strict: boolean
+
+  // ---- Methods ----
+
+  /**
+   * Inserts a new JSON array member named `name` at the zero-based member position `index`. The new
+   * array is empty.
+   *
+   * | `0` |  | Insert as the first member. |
+   *
+   * | `-1` |  | Append as the last member. |
+   *
+   * | `n` |  | Insert at zero-based position n. |
+   *
+   * **Member name vs. JSON path:** `name` is a direct member name, not a JSON path. Use an
+   * `Update*` or `Set*Of` method when addressing a nested value by path.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  addArrayAt(index: number, name: string): void
+
+  /**
+   * Inserts a new JSON boolean member named `name` at the zero-based member position `index`. The
+   * value is taken from `value`.
+   *
+   * | `0` |  | Insert as the first member. |
+   *
+   * | `-1` |  | Append as the last member. |
+   *
+   * | `n` |  | Insert at zero-based position n. |
+   *
+   * **Member name vs. JSON path:** `name` is a direct member name, not a JSON path. Use an
+   * `Update*` or `Set*Of` method when addressing a nested value by path.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  addBoolAt(index: number, name: string, value: boolean): void
+
+  /**
+   * Inserts a new JSON number member named `name` at the zero-based member position `index`. The
+   * integer `value` is emitted as a JSON number, not as a quoted string.
+   *
+   * | `0` |  | Insert as the first member. |
+   *
+   * | `-1` |  | Append as the last member. |
+   *
+   * | `n` |  | Insert at zero-based position n. |
+   *
+   * **Member name vs. JSON path:** `name` is a direct member name, not a JSON path. Use an
+   * `Update*` or `Set*Of` method when addressing a nested value by path.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  addIntAt(index: number, name: string, value: number): void
+
+  /**
+   * Inserts a new JSON null member named `name` at the zero-based member position `index`.
+   *
+   * | `0` |  | Insert as the first member. |
+   *
+   * | `-1` |  | Append as the last member. |
+   *
+   * | `n` |  | Insert at zero-based position n. |
+   *
+   * **Member name vs. JSON path:** `name` is a direct member name, not a JSON path. Use an
+   * `Update*` or `Set*Of` method when addressing a nested value by path.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  addNullAt(index: number, name: string): void
+
+  /**
+   * Inserts a new JSON number member named `name` at the zero-based member position `index`. The
+   * `numericStr` argument supplies the exact JSON numeric text to store.
+   *
+   * | `0` |  | Insert as the first member. |
+   *
+   * | `-1` |  | Append as the last member. |
+   *
+   * | `n` |  | Insert at zero-based position n. |
+   *
+   * **Member name vs. JSON path:** `name` is a direct member name, not a JSON path. Use an
+   * `Update*` or `Set*Of` method when addressing a nested value by path.
+   *
+   * **Exact numeric text:** Use this method when lexical form or precision matters, for example
+   * `12345678901234567890`, `1.2500`, or scientific notation. The supplied text must be valid JSON
+   * number syntax; JSON does not permit `NaN` or infinity.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  addNumberAt(index: number, name: string, numericStr: string): void
+
+  /**
+   * Inserts a new JSON object member named `name` at the zero-based member position `index`. The
+   * new object is empty.
+   *
+   * | `0` |  | Insert as the first member. |
+   *
+   * | `-1` |  | Append as the last member. |
+   *
+   * | `n` |  | Insert at zero-based position n. |
+   *
+   * **Member name vs. JSON path:** `name` is a direct member name, not a JSON path. Use an
+   * `Update*` or `Set*Of` method when addressing a nested value by path.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  addObjectAt(index: number, name: string): void
+
+  /**
+   * Inserts a new JSON string member named `name` at the zero-based member position `index`. The
+   * value is stored as a JSON string and is escaped as needed when emitted.
+   *
+   * | `0` |  | Insert as the first member. |
+   *
+   * | `-1` |  | Append as the last member. |
+   *
+   * | `n` |  | Insert at zero-based position n. |
+   *
+   * **Member name vs. JSON path:** `name` is a direct member name, not a JSON path. Use an
+   * `Update*` or `Set*Of` method when addressing a nested value by path.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  addStringAt(index: number, name: string, value: string): void
+
+  /**
+   * Appends a new JSON array member named `name` to this object. The newly appended array is empty
+   * and the returned `JsonArray` references that array in this document, so changes made through it
+   * modify the same JSON tree.
+   *
+   * **Member name vs. JSON path:** `name` is a direct member name. It is not interpreted as a JSON
+   * path. Use the corresponding `Update*` method when a nested path should be addressed or created.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  appendArray(name: string): JsonArray
+
+  /**
+   * Appends a new JSON boolean member named `name` to this object. The value is taken from `value`.
+   *
+   * **Member name vs. JSON path:** `name` is a direct member name. It is not interpreted as a JSON
+   * path. Use the corresponding `Update*` method when a nested path should be addressed or created.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  appendBool(name: string, value: boolean): void
+
+  /**
+   * Appends a new JSON number member named `name` to this object. The integer value is stored as a
+   * JSON number.
+   *
+   * **Member name vs. JSON path:** `name` is a direct member name. It is not interpreted as a JSON
+   * path. Use the corresponding `Update*` method when a nested path should be addressed or created.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  appendInt(name: string, value: number): void
+
+  /**
+   * Appends a new JSON object member named `name` to this object. The newly appended object is
+   * empty and the returned `JsonObject` references that object in this document.
+   *
+   * **Member name vs. JSON path:** `name` is a direct member name. It is not interpreted as a JSON
+   * path. Use the corresponding `Update*` method when a nested path should be addressed or created.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  appendObject(name: string): JsonObject
+
+  /**
+   * Appends a new JSON string member named `name` to this object. The value is JSON-escaped as
+   * needed when emitted.
+   *
+   * **Member name vs. JSON path:** `name` is a direct member name. It is not interpreted as a JSON
+   * path. Use the corresponding `Update*` method when a nested path should be addressed or created.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  appendString(name: string, value: string): void
+
+  /**
+   * Returns the JSON array stored in the member at zero-based position `index`. The returned
+   * `JsonArray` references the existing array in the same document; it is not a detached copy.
+   *
+   * **Type requirement:** The member at `index` must be an array. Use `TypeAt` when the member type
+   * is not already known.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  arrayAt(index: number): JsonArray
+
+  /**
+   * Returns the JSON array at `jsonPath`. The returned `JsonArray` references the existing array in
+   * the same document, so modifications through it are reflected in the parent JSON.
+   *
+   * **JSON paths:** Paths are relative to this object and may include object-member separators and
+   * array indexes, for example `orders[0].items`.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  arrayOf(jsonPath: string): JsonArray
+
+  /**
+   * Returns the boolean value of the member at zero-based position `index`.
+   *
+   * **Indexing:** Member indexes are based on the order maintained by this `JsonObject` instance.
+   * JSON objects are semantically unordered, so application protocols should normally identify
+   * values by member name rather than by position.
+   */
+  boolAt(index: number): boolean
+
+  /**
+   * Returns the boolean value at `jsonPath`. The path is evaluated relative to this `JsonObject`,
+   * after applying `PathPrefix` if one is set.
+   */
+  boolOf(jsonPath: string): boolean
+
+  /**
+   * Deletes the direct member named `name` from this JSON object.
+   *
+   * **Not a path:** `name` is a member name, not a JSON path. Use a path-based operation when
+   * deleting or replacing a nested value requires navigation first.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  deleteMember(name: string): void
+
+  /**
+   * Deletes the member at zero-based position `index`. Members after the deleted position shift
+   * toward the beginning.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  deleteAt(index: number): void
+
+  /**
+   * Serializes the JSON document rooted at this object and returns the JSON text. Formatting is
+   * controlled by `EmitCompact` and, for pretty output, `EmitCrLf`.
+   *
+   * **Object member order:** Chilkat emits members in its maintained order, but JSON object
+   * ordering is not semantically significant under RFC 8259.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  emit(): string
+
+  /**
+   * Applies a Firebase Realtime Database event to this JSON object. `name` should be `put` or
+   * `patch`, and `data` should contain event JSON such as `{"path":"/","data":{"a":1,"b":2}}`.
+   *
+   * **Purpose:** This method is useful when maintaining a local JSON representation from Firebase
+   * server-sent events: `put` replaces the value at a path, while `patch` updates individual child
+   * keys.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  firebaseApplyEvent(name: string, data: string): void
+
+  /**
+   * Applies Firebase-style patch semantics at `jsonPath`. `jsonData` must contain a JSON object;
+   * each key in that object updates or adds the corresponding key at the target path.
+   *
+   * **Relative path:** `jsonPath` is relative to this `JsonObject`.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  firebasePatch(jsonPath: string, jsonData: string): void
+
+  /**
+   * Applies Firebase-style put semantics at `jsonPath`, replacing or inserting the value at that
+   * path. `value` is JSON text and may represent an object, array, number, boolean, `null`, or a
+   * quoted JSON string.
+   *
+   * **Quoted strings:** To store a string through this method, `value` must contain a valid JSON
+   * string literal, including its surrounding double quotes. Use `UpdateString` when you already
+   * have an ordinary application string.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  firebasePut(jsonPath: string, value: string): void
+
+  /**
+   * Returns a `JsonObject` reference to the root object of the JSON document containing this
+   * object. This can be called from any nested object reference.
+   *
+   * **Shared document lifetime:** Nested `JsonObject` references share the same underlying JSON
+   * document. The document remains available while at least one such reference is retained by the
+   * application.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  getDocRoot(): JsonObject
+
+  /**
+   * Returns `true` if a value exists at `jsonPath`; otherwise returns `false`.
+   *
+   * **Missing vs. null:** A member whose JSON value is `null` still exists. Use `IsNullOf` to test
+   * specifically for JSON `null`.
+   */
+  hasMember(jsonPath: string): boolean
+
+  /**
+   * Returns the zero-based position of the direct member named `name`, or `-1` if that member name
+   * is not found.
+   *
+   * **Not a path:** `name` is searched only among the direct members of this object.
+   */
+  indexOf(name: string): number
+
+  /**
+   * Returns the integer value of the member at zero-based position `index`.
+   *
+   * **Indexing:** Member indexes are based on the order maintained by this `JsonObject` instance.
+   * JSON objects are semantically unordered, so application protocols should normally identify
+   * values by member name rather than by position.
+   */
+  intAt(index: number): number
+
+  /**
+   * Returns the integer value at `jsonPath`. The path is evaluated relative to this `JsonObject`,
+   * after applying `PathPrefix` if one is set.
+   *
+   * **Large numbers:** Use `StringOf` or the exact numeric-text APIs when a JSON integer may exceed
+   * the range of the language binding's integer type.
+   */
+  intOf(jsonPath: string): number
+
+  /**
+   * Returns `true` if the member at zero-based position `index` has the JSON value `null`;
+   * otherwise returns `false`.
+   */
+  isNullAt(index: number): boolean
+
+  /**
+   * Returns `true` if the value at `jsonPath` is the JSON literal `null`; otherwise returns
+   * `false`.
+   *
+   * **Null is a value:** JSON `null` is different from a missing member and from an empty string.
+   * Use `HasMember` when existence must be tested separately.
+   */
+  isNullOf(jsonPath: string): boolean
+
+  /**
+   * Parses the JSON text in `json` and loads the parsed data into this object for DOM-style access
+   * and modification.
+   *
+   * **JSON data model:** JSON values are strings, numbers, booleans, `null`, objects, or arrays.
+   * Object member names should be unique for interoperable JSON; RFC 8259 notes that consumers
+   * differ in how duplicate names are handled.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  load(json: string): void
+
+  /**
+   * Reads JSON text from the file at `path`, parses it, and loads the result into this object.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  loadFile(path: string): void
+
+  /**
+   * Returns the name of the member at zero-based position `index`. Use this with `Size` and
+   * `TypeAt` to iterate through an object's direct members.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  nameAt(index: number): string
+
+  /**
+   * Returns the JSON object stored in the member at zero-based position `index`. The returned
+   * `JsonObject` references the existing child object in the same document; changes made through it
+   * modify that document.
+   *
+   * **Type requirement:** The member at `index` must be a JSON object. Use `TypeAt` when the type
+   * is not already known.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  objectAt(index: number): JsonObject
+
+  /**
+   * Returns the JSON object at `jsonPath`. The returned object is a live reference into the same
+   * JSON document, not a copy.
+   *
+   * **Relative paths:** A path is evaluated relative to the current object. Use `GetDocRoot` when
+   * access must start from the document root.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  objectOf(jsonPath: string): JsonObject
+
+  /**
+   * Renames the direct member `oldName` to `newName`. The member value and its position are
+   * otherwise unchanged.
+   *
+   * **JSON interoperability:** JSON object member names should be unique. Avoid renaming a member
+   * to a name already used by another member unless duplicate names are intentionally required.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  rename(oldName: string, newName: string): void
+
+  /**
+   * Renames the member at zero-based position `index` to `name`. The member value is not changed.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  renameAt(index: number, name: string): void
+
+  /**
+   * Sets the member at zero-based position `index` to a JSON boolean value.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  setBoolAt(index: number, value: boolean): void
+
+  /**
+   * Sets the value at `jsonPath` to a JSON boolean value.
+   *
+   * **Set vs. Update:** Use `UpdateBool` when missing objects or array positions along the path
+   * should be created automatically.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  setBoolOf(jsonPath: string, value: boolean): void
+
+  /**
+   * Sets the member at zero-based position `index` to a JSON number value. The integer is emitted
+   * as a JSON number.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  setIntAt(index: number, value: number): void
+
+  /**
+   * Sets the value at `jsonPath` to an integer JSON number.
+   *
+   * **Set vs. Update:** Use `UpdateInt` when missing objects or array positions along the path
+   * should be created automatically.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  setIntOf(jsonPath: string, value: number): void
+
+  /**
+   * Sets the member at zero-based position `index` to a JSON null value.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  setNullAt(index: number): void
+
+  /**
+   * Sets the value at `jsonPath` to a JSON null value.
+   *
+   * **Set vs. Update:** Use `UpdateNull` when missing objects or array positions along the path
+   * should be created automatically.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  setNullOf(jsonPath: string): void
+
+  /**
+   * Sets the member at zero-based position `index` to a JSON number value. The `value` argument is
+   * the exact textual representation of the JSON number.
+   *
+   * **JSON number syntax:** The text may contain an integer, fraction, or exponent. It must be
+   * valid JSON number syntax; leading zeros (except for zero itself), `NaN`, and infinity are not
+   * valid JSON numbers.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  setNumberAt(index: number, value: string): void
+
+  /**
+   * Sets the value at `jsonPath` to a JSON number value. The `value` argument supplies the exact
+   * textual form of the JSON number.
+   *
+   * **Set vs. Update:** Use `UpdateNumber` when missing objects or array positions along the path
+   * should be created automatically.
+   *
+   * **Precision:** Using numeric text avoids an intermediate conversion through a floating-point
+   * type and can therefore preserve large integers or application-specific decimal formatting.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  setNumberOf(jsonPath: string, value: string): void
+
+  /**
+   * Sets the member at zero-based position `index` to a JSON string value. The string is escaped as
+   * required when JSON is emitted.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  setStringAt(index: number, value: string): void
+
+  /**
+   * Sets the value at `jsonPath` to a JSON string value. The string is escaped as required when
+   * JSON is emitted.
+   *
+   * **Set vs. Update:** Use `UpdateString` when missing objects or array positions along the path
+   * should be created automatically.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  setStringOf(jsonPath: string, value: string): void
+
+  /**
+   * Returns the number of elements in the JSON array at `jsonPath`. Returns `-1` if the path does
+   * not resolve to an existing JSON array.
+   */
+  sizeOfArray(jsonPath: string): number
+
+  /**
+   * Returns the string value of the member at zero-based position `index`.
+   *
+   * **Indexing:** Member indexes are based on the order maintained by this `JsonObject` instance.
+   * JSON objects are semantically unordered, so application protocols should normally identify
+   * values by member name rather than by position.
+   *
+   * **Non-string values:** `StringOf` can also provide textual representations of scalar JSON
+   * values such as numbers, booleans, and `null`; use the type-specific methods when the JSON type
+   * itself matters.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  stringAt(index: number): string
+
+  /**
+   * Returns the value at `jsonPath` as text. For a JSON string, the string value is returned.
+   * Scalar non-string values such as numbers, booleans, and `null` are returned using their JSON
+   * textual representation.
+   *
+   * **Type-sensitive code:** Use `JsonTypeOf`, `IntOf`, `BoolOf`, or `IsNullOf` when the
+   * distinction between JSON types is important.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  stringOf(jsonPath: string): string
+
+  /**
+   * Returns an integer identifying the JSON type of the member at zero-based position `index`.
+   * Returns `-1` if no member exists at that index.
+   *
+   * | `1` |  | string |
+   *
+   * | `2` |  | number |
+   *
+   * | `3` |  | object |
+   *
+   * | `4` |  | array |
+   *
+   * | `5` |  | boolean |
+   *
+   * | `6` |  | null |
+   */
+  typeAt(index: number): number
+
+  /**
+   * Parses JSON from the current contents of `sb` and loads it into this object.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  loadSb(sb: StringBuilder): void
+
+  /**
+   * Serializes this JSON and appends the resulting text to `sb`. Formatting follows `EmitCompact`
+   * and `EmitCrLf`.
+   *
+   * **Append behavior:** Existing text in the destination `StringBuilder` is preserved; the emitted
+   * JSON is added after it.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  emitSb(sb: StringBuilder): void
+
+  /**
+   * Updates the value at `jsonPath` to a JSON string value, or creates the member and any missing
+   * path components as needed. The supplied string is JSON-escaped as needed.
+   *
+   * **Path-based operation:** `jsonPath` is interpreted using `DelimiterChar`, `PathPrefix`, and
+   * the `I`/`J`/`K` index substitutions.
+   *
+   * **Version note:** Chilkat versions prior to 9.5.0.68 did not correctly escape all characters
+   * for this method. Version 9.5.0.68 and later correct that behavior.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  updateString(jsonPath: string, value: string): void
+
+  /**
+   * Updates the value at `jsonPath` to a JSON number value, or creates the member and any missing
+   * path components as needed. The integer value is stored as a JSON number.
+   *
+   * **Path-based operation:** `jsonPath` is interpreted using `DelimiterChar`, `PathPrefix`, and
+   * the `I`/`J`/`K` index substitutions.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  updateInt(jsonPath: string, value: number): void
+
+  /**
+   * Updates the value at `jsonPath` to a JSON boolean value, or creates the member and any missing
+   * path components as needed.
+   *
+   * **Path-based operation:** `jsonPath` is interpreted using `DelimiterChar`, `PathPrefix`, and
+   * the `I`/`J`/`K` index substitutions.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  updateBool(jsonPath: string, value: boolean): void
+
+  /**
+   * Searches the JSON array at `arrayPath` for the first object whose value at relative path
+   * `relPath` equals or wildcard-matches `value`. The `caseSensitive` argument controls string
+   * comparison. Returns the matching record object.
+   *
+   * **Wildcard matching:** The search value may contain `*` to match zero or more characters.
+   * `relPath` is evaluated relative to each record object in the array.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  findRecord(arrayPath: string, relPath: string, value: string, caseSensitive: boolean): JsonObject
+
+  /**
+   * Searches the JSON array at `arrayPath` for the first record whose `relPath` value equals or
+   * wildcard-matches `value`, then returns the value at `retRelPath` from that same record as a
+   * string.
+   *
+   * **Typical use:** This is useful for lookups such as “find the record where `Name` is
+   * `Advertising` and return its `Id`.” The `*` wildcard may be used in `value`.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  findRecordString(arrayPath: string, relPath: string, value: string, caseSensitive: boolean, retRelPath: string): string
+
+  /**
+   * Updates the value at `jsonPath` to a JSON number value, or creates the member and any missing
+   * path components as needed. The `numericStr` argument is stored as the exact textual
+   * representation of the JSON number.
+   *
+   * **Path-based operation:** `jsonPath` is interpreted using `DelimiterChar`, `PathPrefix`, and
+   * the `I`/`J`/`K` index substitutions.
+   *
+   * **When to use:** Use `UpdateNumber` instead of `UpdateInt` for decimal/exponent forms, very
+   * large integers, or when preserving exact numeric text is important.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  updateNumber(jsonPath: string, numericStr: string): void
+
+  /**
+   * Updates the value at `jsonPath` to a JSON null value, or creates the member and any missing
+   * path components as needed.
+   *
+   * **Path-based operation:** `jsonPath` is interpreted using `DelimiterChar`, `PathPrefix`, and
+   * the `I`/`J`/`K` index substitutions.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  updateNull(jsonPath: string): void
+
+  /**
+   * Serializes the JSON after substituting variables from `subs` into template strings. A
+   * placeholder such as `{$name}` is replaced by the corresponding hashtable value. Prefixing the
+   * variable name with `i.`, as in `{$i.count}`, emits the substituted value as a JSON integer
+   * instead of a quoted string.
+   *
+   * If `omitEmpty` is `true`, members whose substituted result is an empty string or empty array
+   * are omitted from the emitted JSON.
+   *
+   * **Template reuse:** This method does not require rebuilding the JSON template. It is commonly
+   * paired with `Predefine` and `LoadPredefined` when the same JSON shape is emitted repeatedly
+   * with different values.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  emitWithSubs(subs: Hashtable, omitEmpty: boolean): string
+
+  /**
+   * Stores this JSON document in Chilkat's internal global collection of predefined JSON documents
+   * under `name`. If the name already exists, the predefined value is replaced.
+   *
+   * **Template use:** After predefining a document, another `JsonObject` can load it by name with
+   * `LoadPredefined`.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  predefine(name: string): void
+
+  /**
+   * Loads this object from the predefined JSON document identified by `name`. Predefined documents
+   * are created with `Predefine`.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  loadPredefined(name: string): void
+
+  /**
+   * Appends a new JSON array member named `name` to this object. The array is populated with the
+   * strings contained in `values`.
+   *
+   * **Member name vs. JSON path:** `name` is a direct member name. It is not interpreted as a JSON
+   * path. Use the corresponding `Update*` method when a nested path should be addressed or created.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  appendStringArray(name: string, values: StringTable): void
+
+  /**
+   * Recursively searches this JSON subtree for the first JSON object containing a direct member
+   * named `name`. Returns that object, or _NULL_ if no matching object is found.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  findObjectWithMember(name: string): JsonObject
+
+  /**
+   * Returns an integer identifying the JSON type of the value at `jsonPath`. Returns `-1` if no
+   * member exists at that path.
+   *
+   * | `1` |  | string |
+   *
+   * | `2` |  | number |
+   *
+   * | `3` |  | object |
+   *
+   * | `4` |  | array |
+   *
+   * | `5` |  | boolean |
+   *
+   * | `6` |  | null |
+   */
+  jsonTypeOf(jsonPath: string): number
+
+  /**
+   * Retrieves the value at `jsonPath` as text and appends it to `sb`.
+   *
+   * **Append behavior:** Existing contents of the destination `StringBuilder` are preserved.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  stringOfSb(jsonPath: string, sb: StringBuilder): void
+
+  /**
+   * Reads the string value at `jsonPath`, decodes it using `encoding` (for example, `base64` or
+   * `hex`), and appends the resulting bytes to `bd`.
+   *
+   * **Binary-in-JSON convention:** The JSON member itself is text. The `encoding` argument tells
+   * Chilkat how that text represents the original bytes.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  bytesOf(jsonPath: string, encoding: string, bd: BinData): void
+
+  /**
+   * Updates the value at `jsonPath` to a JSON string value, or creates the member and any missing
+   * path components as needed. The new string value is taken from the contents of `sb`.
+   *
+   * **Path-based operation:** `jsonPath` is interpreted using `DelimiterChar`, `PathPrefix`, and
+   * the `I`/`J`/`K` index substitutions.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  updateSb(jsonPath: string, sb: StringBuilder): void
+
+  /**
+   * Updates the value at `jsonPath` to a JSON string value, or creates the member and any missing
+   * path components as needed. The bytes in `bd` are first encoded according to `encoding` (for
+   * example, `base64` or `hex`) and the encoded text is stored as the JSON string value.
+   *
+   * **Path-based operation:** `jsonPath` is interpreted using `DelimiterChar`, `PathPrefix`, and
+   * the `I`/`J`/`K` index substitutions.
+   *
+   * **Binary data in JSON:** JSON has no native byte-array type. Binary content must therefore be
+   * represented using a textual encoding agreed upon by the producer and consumer.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  updateBd(jsonPath: string, encoding: string, bd: BinData): void
+
+  /**
+   * Parses the date/time value at `jsonPath` and loads the result into `dt`. Recognized forms
+   * include ISO 8601 timestamps (for example, `2009-11-04T19:55:41Z`), RFC 822-style date/time
+   * strings, and Unix timestamp integers.
+   *
+   * **JSON has no native date type:** Dates in JSON are application conventions, usually
+   * represented as strings or numbers. This method recognizes common conventions and converts them
+   * to `CkDateTime`.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  dateOf(jsonPath: string, dt: CkDateTime): void
+
+  /**
+   * Parses the date/time value at `jsonPath` into `dt`. If `bLocal` is `true`, the destination
+   * receives local date/time fields; otherwise it receives UTC/GMT fields. Recognized inputs
+   * include ISO 8601 timestamps, RFC 822-style date/time strings, and Unix timestamp integers.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  dtOf(jsonPath: string, bLocal: boolean, dt: DtObj): void
+
+  /**
+   * Creates or replaces the value at `jsonPath` with a new empty JSON array. Missing path
+   * components are created automatically as needed.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  updateNewArray(jsonPath: string): void
+
+  /**
+   * Creates or replaces the value at `jsonPath` with a new empty JSON object. Missing path
+   * components are created automatically as needed.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  updateNewObject(jsonPath: string): void
+
+  /**
+   * Removes all members from this JSON object, leaving an empty object equivalent to `{}`.
+   */
+  clear(): void
+
+  /**
+   * Swaps the positions of the direct members at zero-based indexes `index1` and `index2`. Member
+   * names and values are unchanged.
+   *
+   * **Ordering:** JSON object order is not semantically significant, but Chilkat preserves an order
+   * for index-based access and emission.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  swap(index1: number, index2: number): void
+
+  /**
+   * Serializes this JSON and writes it to the file at `path`. Output formatting follows
+   * `EmitCompact` and `EmitCrLf`.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  writeFile(path: string): void
+
+  /**
+   * Parses JSON from the bytes contained in `bd` and loads it into this object.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  loadBd(bd: BinData): void
+
+  /**
+   * Serializes this JSON and appends the resulting bytes to `bd`.
+   *
+   * **Append behavior:** Existing data in the destination `BinData` is preserved.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  emitBd(bd: BinData): void
+
+  /**
+   * Moves the direct member at zero-based position `fromIndex` to `toIndex`. Use `toIndex = 0` to
+   * move it first or `-1` to move it last.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  moveMember(fromIndex: number, toIndex: number): void
+
+  /**
+   * Inserts a new JSON array member named `name` at the zero-based member position `index`. The
+   * array value is copied from `jarr`; subsequent changes to the source array do not modify the
+   * inserted copy.
+   *
+   * | `0` |  | Insert as the first member. |
+   *
+   * | `-1` |  | Append as the last member. |
+   *
+   * | `n` |  | Insert at zero-based position n. |
+   *
+   * **Member name vs. JSON path:** `name` is a direct member name, not a JSON path. Use an
+   * `Update*` or `Set*Of` method when addressing a nested value by path.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  addArrayCopyAt(index: number, name: string, jarr: JsonArray): void
+
+  /**
+   * Inserts a new JSON object member named `name` at the zero-based member position `index`. The
+   * object value is copied from `jsonObj`; the inserted value is independent of the source.
+   *
+   * | `0` |  | Insert as the first member. |
+   *
+   * | `-1` |  | Append as the last member. |
+   *
+   * | `n` |  | Insert at zero-based position n. |
+   *
+   * **Member name vs. JSON path:** `name` is a direct member name, not a JSON path. Use an
+   * `Update*` or `Set*Of` method when addressing a nested value by path.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  addObjectCopyAt(index: number, name: string, jsonObj: JsonObject): void
+
+  /**
+   * Appends a new JSON array member named `name` to this object. The array is copied from `jarr`,
+   * so the appended array is independent of the source array.
+   *
+   * **Member name vs. JSON path:** `name` is a direct member name. It is not interpreted as a JSON
+   * path. Use the corresponding `Update*` method when a nested path should be addressed or created.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  appendArrayCopy(name: string, jarr: JsonArray): void
+
+  /**
+   * Appends a new JSON object member named `name` to this object. The object is copied from
+   * `jsonObj`, so the appended object is independent of the source object.
+   *
+   * **Member name vs. JSON path:** `name` is a direct member name. It is not interpreted as a JSON
+   * path. Use the corresponding `Update*` method when a nested path should be addressed or created.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  appendObjectCopy(name: string, jsonObj: JsonObject): void
+
+  /**
+   * Deletes every object record in the array at `arrayPath` whose value at relative path `relpath`
+   * equals or wildcard-matches `value`. The `caseSensitive` argument controls matching. Returns the
+   * number of records deleted.
+   */
+  deleteRecords(arrayPath: string, relpath: string, value: string, caseSensitive: boolean): number
+
+  /**
+   * Updates the value at `jsonPath` to a JSON number value, or creates the member and any missing
+   * path components as needed. The unsigned integer is stored as a JSON number.
+   *
+   * **Path-based operation:** `jsonPath` is interpreted using `DelimiterChar`, `PathPrefix`, and
+   * the `I`/`J`/`K` index substitutions.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  updateUInt(jsonPath: string, value: number): void
+
+  /**
+   * Returns the unsigned integer value at `jsonPath`.
+   */
+  uIntOf(jsonPath: string): number
+
+  /**
+   * Returns `true` if the textual value at `jsonPath` equals `value` according to the
+   * `caseSensitive` setting; otherwise returns `false`.
+   */
+  stringOfEquals(jsonPath: string, value: string, caseSensitive: boolean): boolean
+
+  /**
+   * Sorts this object's direct members by member name. `ascending` selects ascending or descending
+   * order, and `caseSensitive` controls how names are compared.
+   *
+   * **JSON semantics:** Member ordering is not significant to JSON consumers, but sorting can make
+   * emitted JSON deterministic and easier to compare or review.
+   */
+  sort(ascending: boolean, caseSensitive: boolean): void
+
+  /**
+   * Appends a new JSON array member named `name` to this object. A new empty array is created and
+   * `jarr` is updated to reference it. The method returns `true` on success.
+   *
+   * **Member name vs. JSON path:** `name` is a direct member name. It is not interpreted as a JSON
+   * path. Use the corresponding `Update*` method when a nested path should be addressed or created.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  appendArray2(name: string, jarr: JsonArray): void
+
+  /**
+   * Appends a new JSON object member named `name` to this object. A new empty object is created and
+   * `jsonObj` is updated to reference it. The method returns `true` on success.
+   *
+   * **Member name vs. JSON path:** `name` is a direct member name. It is not interpreted as a JSON
+   * path. Use the corresponding `Update*` method when a nested path should be addressed or created.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  appendObject2(name: string, jsonObj: JsonObject): void
+
+  /**
+   * Updates `jarr` to reference the JSON array stored at zero-based member position `index` and
+   * returns `true` on success.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  arrayAt2(index: number, jarr: JsonArray): void
+
+  /**
+   * Updates `jsonObj` to reference the JSON object stored at zero-based member position `index` and
+   * returns `true` on success.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  objectAt2(index: number, jsonObj: JsonObject): void
+
+  /**
+   * Copies this JSON object into `json`. The destination receives an independent JSON copy rather
+   * than another reference to the same underlying object.
+   *
+   * **Copy vs. reference:** Use `CopyRef` when two `JsonObject` instances should refer to the same
+   * JSON object instead of duplicating its data.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  makeCopy(json: JsonObject): void
+
+  /**
+   * Updates `jsonObj` so that it references the same JSON object as the caller. No JSON data is
+   * copied.
+   *
+   * **Shared state:** After this call, modifications through either reference affect the same
+   * underlying JSON object.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  copyRef(jsonObj: JsonObject): void
+
+  /**
+   * Recursively searches this JSON subtree for the first object containing a direct member named
+   * `name`. On success, `jsonObj` is updated to reference the matching object and the method
+   * returns `true`.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  findObjectWithMember2(name: string, jsonObj: JsonObject): void
+
+  /**
+   * Searches the JSON array at `arrayPath` using the same matching rules as `FindRecord`. On
+   * success, `jsonObj` is updated to reference the first matching record and the method returns
+   * `true`.
+   *
+   * **Reference semantics:** The destination references the record in the original JSON document;
+   * changes made through `jsonObj` modify that record.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  findRecord2(arrayPath: string, relPath: string, value: string, caseSensitive: boolean, jsonObj: JsonObject): void
+
+  /**
+   * Updates `docRoot` to reference the root object of the JSON document containing the caller and
+   * returns `true` on success.
+   *
+   * **Reference semantics:** The destination is another reference into the same underlying
+   * document; it is not a copy.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  getDocRoot2(docRoot: JsonObject): void
+
+  /**
+   * Updates `jsonObj` to reference the JSON object at `jsonPath` and returns `true` on success.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  objectOf2(jsonPath: string, jsonObj: JsonObject): void
+
+  /**
+   * Updates `jarr` to reference the JSON array at `jsonPath` and returns `true` on success.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  arrayOf2(jsonPath: string, jarr: JsonArray): void
+
+  /**
+   * Creates a JSON object at `path` and loads that object from the JSON text in `jObj`. The
+   * supplied text should represent a JSON object.
+   *
+   * **Difference from UpdateNewObject:** `UpdateNewObject` creates an empty object. `NewObjectOf`
+   * creates the object and immediately populates it from JSON text.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  newObjectOf(path: string, jObj: string): void
+
+  /**
+   * Creates a JSON array at `path` and loads that array from the JSON text in `jArr`. The supplied
+   * text should represent a JSON array.
+   *
+   * **Difference from UpdateNewArray:** `UpdateNewArray` creates an empty array. `NewArrayOf`
+   * creates the array and immediately populates it from JSON text.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link JsonObject.lastErrorText}.
+   */
+  newArrayOf(path: string, jArr: string): void
+}