{
  "$schema": "../../schemas/utility.schema.json",
  "kind": "utility",
  "name": "Numbers",
  "version": "1.0.0-draft.1",
  "purpose": "Numbers value operations. No hidden external Service communication.",
  "types": "types.json",
  "functions": {
    "integer": {
      "parameters": [
        {
          "name": "value",
          "type": "Numbers.Convertible",
          "required": true
        }
      ],
      "returns": "core.integer",
      "purpose": "Checked integral conversion from a finite numeric value or base-ten string.",
      "statementOnly": false
    },
    "decimal": {
      "parameters": [
        {
          "name": "value",
          "type": "Numbers.Convertible",
          "required": true
        }
      ],
      "returns": "core.decimal",
      "purpose": "Decimal conversion from integer/decimal or finite base-ten string.",
      "statementOnly": false
    },
    "text": {
      "parameters": [
        {
          "name": "value",
          "type": "core.numeric",
          "required": true
        }
      ],
      "returns": "core.string",
      "purpose": "Locale-independent numeric text without grouping.",
      "statementOnly": false
    },
    "min": {
      "parameters": [
        {
          "name": "values",
          "type": "Numbers.Values",
          "required": true
        }
      ],
      "returns": "core.numeric",
      "purpose": "Numeric minimum/maximum; empty fails.",
      "statementOnly": false
    },
    "max": {
      "parameters": [
        {
          "name": "values",
          "type": "Numbers.Values",
          "required": true
        }
      ],
      "returns": "core.numeric",
      "purpose": "Numeric minimum/maximum; empty fails.",
      "statementOnly": false
    },
    "abs": {
      "parameters": [
        {
          "name": "value",
          "type": "core.numeric",
          "required": true
        }
      ],
      "returns": "core.numeric",
      "purpose": "Numeric absolute value; integer overflow fails.",
      "statementOnly": false
    },
    "format": {
      "parameters": [
        {
          "name": "value",
          "type": "core.numeric",
          "required": true
        },
        {
          "name": "places",
          "type": "core.integer",
          "required": true
        },
        {
          "name": "rounding",
          "type": "core.string",
          "required": true
        }
      ],
      "returns": "core.string",
      "purpose": "Fixed-place numeric string, using explicit rounding.",
      "statementOnly": false
    }
  },
  "rules": [
    "Conversions consume the complete base-ten string without whitespace or grouping. Integer conversion is checked against the signed 64-bit range.",
    "Calculations retain exact decimal digits. Overflow, invalid numeric input, empty min/max and required-but-unspecified rounding fail. Formatting uses explicit places and rounding."
  ]
}
