{
  "$schema": "../../schemas/utility.schema.json",
  "kind": "utility",
  "name": "Object",
  "version": "1.0.0-draft.1",
  "purpose": "Object value operations. No hidden external Service communication.",
  "types": "types.json",
  "functions": {
    "has": {
      "parameters": [
        {
          "name": "object",
          "type": "core.object",
          "required": true
        },
        {
          "name": "key",
          "type": "core.string",
          "required": true
        }
      ],
      "returns": "core.boolean",
      "purpose": "Direct property presence.",
      "statementOnly": false
    },
    "get": {
      "parameters": [
        {
          "name": "object",
          "type": "core.object",
          "required": true
        },
        {
          "name": "path",
          "type": "core.string",
          "required": true
        },
        {
          "name": "fallback",
          "type": {
            "nullable": "core.data"
          },
          "required": false,
          "default": null
        }
      ],
      "returns": "core.data",
      "purpose": "Nested dot-path lookup with fallback for missing paths, not explicit null.",
      "statementOnly": false
    },
    "keys": {
      "parameters": [
        {
          "name": "object",
          "type": "core.object",
          "required": true
        }
      ],
      "returns": {
        "arrayOf": "core.string"
      },
      "purpose": "Own keys in insertion order.",
      "statementOnly": false
    },
    "remove": {
      "parameters": [
        {
          "name": "object",
          "type": "core.object",
          "required": true
        },
        {
          "name": "key",
          "type": "core.string",
          "required": true
        }
      ],
      "returns": "core.void",
      "purpose": "none; remove one direct local property.",
      "statementOnly": true
    },
    "copy": {
      "parameters": [
        {
          "name": "value",
          "type": "core.data",
          "required": true
        }
      ],
      "returns": "core.data",
      "purpose": "Deep copy data; reject cyclic data and handles.",
      "statementOnly": false
    },
    "equal": {
      "parameters": [
        {
          "name": "left",
          "type": "core.data",
          "required": true
        },
        {
          "name": "right",
          "type": "core.data",
          "required": true
        }
      ],
      "returns": "core.boolean",
      "purpose": "Structural equality of data; object key order ignored, array order significant.",
      "statementOnly": false
    },
    "parse": {
      "parameters": [
        {
          "name": "text",
          "type": "core.string",
          "required": true
        }
      ],
      "returns": "core.data",
      "purpose": "Data read from its text representation; invalid text and duplicate property names fail.",
      "statementOnly": false
    },
    "asString": {
      "parameters": [
        {
          "name": "value",
          "type": "core.data",
          "required": true
        },
        {
          "name": "indent",
          "type": "core.integer",
          "required": false,
          "default": 0
        }
      ],
      "returns": "core.string",
      "purpose": "Text representation of data; preserves nulls and numeric digits, rejects handles and cycles. Durations become ISO-8601 elapsed-duration strings; nested bytes become Base64 strings.",
      "statementOnly": false
    }
  },
  "rules": [
    "Objects contain named data properties. Missing properties differ from explicit null. get uses dot paths; direct indexing accesses a key containing dots.",
    "copy is a deep data copy; equal is structural and ignores object key order. remove mutates one direct property and returns no value.",
    "parse accepts strict JSON data and rejects duplicate property names. It preserves integer and decimal digits. asString preserves nulls and digits and rejects handles and cycles.",
    "Dates and datetimes serialize as ISO strings; durations as ISO elapsed-duration strings; nested bytes as Base64. Parsing does not infer dates or bytes without an explicit typed contract."
  ]
}
