* Make already deprecated APIs package private
* Add deprecation warnings to a few that we missed

* Bump SBT to latest (1.9.8)

* [CI] Change all ubuntu runners to ubuntu-22.04

This bumps some things running on the older runner which seems to have a
problem with SBT 1.9.8. It also removes any uses of ubuntu-latest to
ensure that we control the version explicitly.

* Width, KnownWidth, and Unknown width promoted to package chisel3
* Other classes moved to new package private chisel3.internal.firrtl.ir

Also change to an object (from a def) so that it shows up in ScalaDoc
search.

This avoids starting any Bloop servers which avoids hangs in CI.

* Revert "[binder] Remove firtool-1.61.0 features"
* [binder] Implement OM
* [binder] Implement probe IR emissions
* Change Trace API to only trace leaves (#3682)

Change the behavior of the Trace API to only trace leaves.  This aligns
with recent changes to CIRCT which error if annotations are applied to
aggregates which are then mandatorily split due to FIRRTL ABIs.  This
should have no practical effect on use of the Trace API only that
downstream consumers will need to work at the level of leaf types and not
on aggregates.

* [binder] Truncate for aggregate connection
* [binder] Set `inner_sym` only when needed
* [binder] Set module visibility
* [binder] Add function for exporting split verilog
* [binder] Support secret ports
* [binder] Refer with `SourceInfo` instead of `MlirLocation`
* [binder] Emit IR for probe read
* [binder] Handle secret ports for instance
* [binder] Fix extmodule emission
* [binder] Handle secret commands
* [binder] Handle probe ops without `Node`
* [binder] Flush the buffer at the end of `Writable` streams
* [binder] Keep original integer types from foreign API
* [binder] fix return type of asAsyncReset
* [cd] Bump CIRCT from firtool-1.61.0 to firtool-1.62.0

Signed-off-by: Schuyler Eldridge <schuyler.eldridge@sifive.com>
Co-authored-by: Schuyler Eldridge <schuyler.eldridge@sifive.com>
Co-authored-by: Sprite <SpriteOvO@gmail.com>
Co-authored-by: Jiuyang Liu <liu@jiuyang.me>
Co-authored-by: chiselbot <chiselbot@users.noreply.github.com>

Co-authored-by: Aditya Naik <aditya.naik@sifive.com>
Co-authored-by: Jack Koenig <koenig@sifive.com>

To override which firtool is used by Chisel, users should now set
environment variable CHISEL_FIRTOOL_PATH (rather than the old
FIRTOOL_PATH).

bump and update nix to use upstreamed packages

When creating large numbers of Definitions, copying the
globalNamespace back and forth becomes a performance bottleneck.

Now it will fetch llvm-firtool with classifier for the current system
rather than the full artifact which contains binaries for all platforms.

Legacy `--print-ir-after-all` has been replaced by this new argument.

* Use Java 17 to build documentation in CI

This avoids CI flakiness due to scala-cli needing to download Java 17 at
runtime and timing out.

* Exclude docs project from Unidoc

The docs project includes logic only used for generating mdoc, it should
not be included in the generated ScalaDoc as it is not actually included
in the published Chisel artifacts.

This also helps avoid flaky CI issues--the publish step will no longer
compile the docs subproject. Compiling the docs subproject requires
scala-cli which requires Java 17. Downloading Java 17 at build time can
timeout, causing flaky CI. Note that the publish step uses Java 8 so
that we can guarantee the published artifacts work on Java 8.

fix up path issue in build.sc

Whereas in the past, the user was expected to provide the firtool binary
on the PATH, Chisel will now manage the firtool binary automatically.
Chisel users the following 3-step process for determining which binary
to use:

1. If environment variable FIRTOOL_PATH is set, it will check for
   firtool in that directory
2. It will check the classpath for firtool provided by
   chipsalliance/llvm-firtool
3. It will download a default version of chipsalliance/llvm-firtool

Both (2) and (3) will store the firtool binary in a sensible location
depending on the user's operating system. See dirs-dev/directories-jvm
for more information. The user can override this location by setting the
FIRTOOL_CACHE environment variable.

* [docs] Fix release ordering
   Ensure that 6.0.0 > 6.0.0-RC1 > 6.0.0-M3
* [docs] Release candidates count for latest

Go all in on leaf marking for don't touched values. This preserves current behavior. As options expand, the API can change then.

Go all in on leaf marking for don't touched values.  This preserves current behavior.  As options expand, the API can change then.

Add an argument to dontTouch which allows placing don't touch annotations on the leaves of aggregates. Default this option. This results in the same behavior as what the current dontTouch effectively does today. Don't touch of an aggregate is on it's plain meaning different from don't touch on the leaves of an aggregate. Making the annotation a bit more precise allows greater freedom in code generation and allows catching contradictory requests by the programmer.

* [binder] Update API `FIRRTLDirection` for CIRCT 1.60.0
* [binder] Remove dedup option (#3641)
* [ci] bump circt/update-staging-branch to 1.2.0
* [cd] Bump CIRCT from firtool-1.59.0 to firtool-1.60.0
* [binder] Update firtool-lib C-API to allow the creation of multiple options
* [binder] Remove firtool-1.61.0 features
* [circt] Use new public-modules option

This is an automated commit generated by the `circt/update-circt` GitHub
Action.

Signed-off-by: Schuyler Eldridge <schuyler.eldridge@sifive.com>
Co-authored-by: Sprite <SpriteOvO@gmail.com>
Co-authored-by: Schuyler Eldridge <schuyler.eldridge@sifive.com>
Co-authored-by: chiselbot <chiselbot@users.noreply.github.com>