Split tool-base into focused modules

[alexander-yevsyukov]

Splits the monolithic tool-base module into focused modules, one per concern,
and retires the module itself. Package names are preserved throughout, so
consumers need dependency additions rather than import edits — with the
exceptions called out under Breaking changes.

Why

tool-base had accumulated everything: file-system abstractions, Java code-generation
types, Protobuf descriptor handling, archive reading and language-neutral code types.
Anyone needing one part compiled against all of them. classic-codegen had the same
problem on a smaller scale — its Classpath proto type dragged in JavaPoet and Roaster.

The result

Base
 ▲
 ├── fs ◄──────── plugin-base, proto-code, java-code, protobuf-setup-plugins
 ├── code ◄────── plugin-base, jvm-tool-plugins, protobuf-setup-plugins,
 │                java-code (test)
 ├── archive ◄─── proto-code
 └── kotlin-code

New module	Package(s)
fs	io.spine.tools.fs
code	io.spine.tools.code
archive	io.spine.tools.archive
kotlin-code	io.spine.tools.kotlin
java-code	io.spine.tools.java, .java.code, .java.fs, .java.javadoc
proto-code	io.spine.tools.proto.code, .proto.fs, .proto.type
fixtures	test-only Protobuf declarations — not published

classic-codegen keeps only the library wrappers, in io.spine.tools.java.code.poet
and .roaster. The tool-base module is gone; the repository keeps its name.

JavaScript and Dart are not supported in v2.x. Modules were extracted for them
mid-branch and then removed — TypeScript covers the front end for now. Nothing in this
repository referenced them; mc-js is the one repository that used
io.spine.tools.js.* and loses its source of those types.

Breaking changes

1. Generated.dir and SourceRoot.subDir take a String source-set name
   instead of SourceSetName. Extracting io.spine.tools.fs was otherwise
   impossible: a three-package cycle ran across the cut — fs → code.SourceSetName → io.spine.tools.titlecaseFirstChar → fs.DirectoryName — harmless inside one
   module, fatal as a circular Gradle project dependency. mc-js passes
   SourceSetName at 8 call sites and must pass a String. The blank-name check
   SourceSetName performed is preserved in SourceRoot.subDir.
2. io.spine.tools.OsFamily is gone. Base Libraries already publishes the same
   enum as io.spine.environment.OsFamily.
3. io.spine.tools.java.code.{classSpec, constructorSpec, methodSpec, codeBlock}
   move to …code.poet, and fullTextNormalized to …code.roaster.
   Method(MethodSpec) is replaced by MethodSpec.toMethod() in the poet package.
4. io.spine.tools.type → io.spine.tools.proto.type and
   io.spine.tools.code.proto → io.spine.tools.proto.code, consolidating
   proto-code under one package root. This required a matching change to the
   runtime guard in KnownTypes.Holder.extendWith, delivered by
   Allow extendWith for the new MoreKnownTypes package base-libraries#959 and picked up here via Base
   2.0.0-SNAPSHOT.441.
5. io.spine.tools.js.* and io.spine.tools.dart.* are gone, along with
   language support for JavaScript and Dart.

Notable details

• fixtures is deliberately unpublished. It is excluded from
  spinePublishing.modules, and :fixtures:tasks registers no publish* task.
  Five fixture protos that no test referenced were deleted.
• Test fixtures left the production namespace: the person/project/task
  protos declared io.spine.tools.type, the package proto-code now owns, so the
  package spanned two published JARs. They moved to io.spine.test.tools.type.
• Dependency scopes follow the code: api where a type reaches a public
  signature, implementation otherwise. Dependencies that became dead were dropped.

Verification

./gradlew clean build dokkaGenerate green, run with --no-build-cache at each
step. Artifact contents were checked per module: each JAR holds exactly its own
packages, no package is published by two artifacts, and java-code carries neither
JavaPoet nor Roaster.

Caching note: with org.gradle.caching=true, renaming a generated package leaves
the old classes restorable from the build cache, so artifact checks need
--no-build-cache. Also, clean build in one invocation is unreliable under
org.gradle.parallel=true — run clean separately.

Downstream follow-ups

• config — Declare the modules tool-base was split into config#748 declares the new modules and deprecates
  ToolBase.lib. It must not merge until 2.0.0-SNAPSHOT.420 is published.
• mc-js — loses io.spine.tools.js.* entirely, and has 8 SourceSetName call sites.
• core-jvm-compiler, compiler, ProtoTap, base-libraries — new coordinates;
  core-jvm-compiler also needs the poet/roaster and
  io.spine.tools.{div,resolve} → io.spine.tools.fs.{div,resolve} import moves.

🤖 Generated with Claude Code

[Copilot]

Pull request overview

Copilot reviewed 158 out of 271 changed files in this pull request and generated no new comments.

Suppressed comments (1)

code/src/main/java/io/spine/tools/code/IndentedLine.java:61

• IndentedLine.of(Indent, String) calls of(code), but there is no of(String) overload in this class and there is no static import for Line.of(..). As written, this does not compile. Use Line.of(code) to construct the underlying Line instance.

[Copilot]

Pull request overview

Copilot reviewed 158 out of 271 changed files in this pull request and generated no new comments.

Suppressed comments (1)

buildSrc/src/main/kotlin/io/spine/dependency/local/ToolBase.kt:40

• This PR retires the tool-base module, but ToolBase still declares lib = "$group:tool-base:$version" and its KDoc says “Artifacts of the tool-base module”. Keeping this constant around makes it easy to accidentally depend on a no-longer-published artifact.

[Copilot]

Pull request overview

Copilot reviewed 158 out of 271 changed files in this pull request and generated no new comments.

Suppressed comments (1)

code/src/main/java/io/spine/tools/code/IndentedLine.java:61

• var pure = of(code); relies on inheriting Line.of(String) via a static method call that looks like a self-call of IndentedLine.of(...). Qualifying it as Line.of(code) avoids confusion (and prevents accidental recursion if an of(String) overload is introduced here later).

[Copilot]

Pull request overview

Copilot reviewed 183 out of 269 changed files in this pull request and generated no new comments.