@descryy/adapter-java 0.2.0 → 0.3.1

package/dist/spring.d.ts

@@ -1,56 +1,26 @@
 /**
- * The HTTP-route framework extractor for Java — Spring MVC and Spring WebFlux.
- *
- * **An `API_ROUTE` is a framework claim, and this file is where it is earned.**
- * DEC-127 fixed the admission rules before any of this was written, for the
- * reason `adapter-python`'s ORM records: two of its rules were corrected by
- * counting after the fact, and a written rule is falsifiable by a count while a
- * rule living in code is falsifiable only by argument.
- *
- * ## Where the precision risk is NOT, measured first
- *
- * `adapter-python/src/routes.ts` spends most of its length defending against
- * `@mock.patch` being spelled like an HTTP verb — 1,150 of them in `saleor`, all
- * of which a name rule would have called routes. **Java has no equivalent
- * collision in this corpus.** Measured across `spring-petclinic`, `shopizer`,
- * `mall` and `airbyte` before writing this: `@Get(`, `@Path(` and Micronaut's
- * `@Controller` occur **0** times. Spring's annotation names do not collide with
- * anything.
- *
- * So the receiver-provenance machinery that dominates the Python extractor is
- * not the work here. **The work is the path join**, and getting that wrong is
- * silent.
- *
- * ## Where the precision risk IS
- *
- * A served path is the class-level prefix joined to the method-level suffix:
- *
- *     @RestController
- *     @RequestMapping("/orders")     <- the prefix
- *     class Routes {
- *         @GetMapping("/{id}")       <- the suffix
- *
- * **An extractor reading only the method annotation produces `/{id}`, which
- * normalises to `/{param}`, joins to no endpoint, and is a wrong edge** — worse
- * than emitting nothing under rule 2, because a wrong edge corrupts every layer
- * above it while a missing one is a disclosed gap. The Java conformance fixture
- * is deliberately shaped to fail that implementation.
- *
- * ## `@RequestMapping` is not a fallback — it is the dominant form
- *
- * Measured before writing, and it changed the shape of this file:
- *
- * | repository | `@GetMapping` | `@RequestMapping` |
- * | --- | --- | --- |
- * | `spring-petclinic` | 12 | 2 |
- * | `shopizer` | 85 | **194** |
- * | `mall` | **0** | **291** |
- *
- * **`mall` uses `@RequestMapping` exclusively.** An extractor supporting only
- * the verb-specific shortcuts scores zero on all 291 of its routes — not a
- * degraded number, zero, with nothing in the output to say why. Both mechanisms
- * are therefore first-class here, and the bench counts them separately so a
- * total miss on one cannot average into a single healthy-looking figure.
+ * The HTTP-route framework extractor for Java — Spring MVC and Spring WebFlux. **An `API_ROUTE`
+ * is a framework claim, earned here.** DEC-127 fixed the admission rules before any of this was
+ * written — a written rule is falsifiable by a count, one living only in code is not.
+ *
+ * Where the precision risk is NOT: `adapter-python/src/routes.ts` spends most of its length on
+ * `@mock.patch` looking like an HTTP verb (1,150 in `saleor`). Measured across
+ * `spring-petclinic`, `shopizer`, `mall` and `airbyte`: `@Get(`, `@Path(` and Micronaut's
+ * `@Controller` occur **0** times — Spring's annotation names don't collide with anything, so
+ * receiver-provenance machinery isn't the work here.
+ *
+ * Where the precision risk IS: the path join. A served path is the class-level prefix joined to
+ * the method-level suffix (`@RequestMapping("/orders")` on the class, `@GetMapping("/{id}")` on
+ * the method → `/orders/{id}`). **Reading only the method annotation produces `/{id}`,
+ * normalises to `/{param}`, and joins to no endpoint — a wrong edge**, worse than emitting
+ * nothing (rule 2: a wrong edge corrupts every layer above it). The conformance fixture is
+ * shaped to catch exactly this.
+ *
+ * `@RequestMapping` is the dominant form, not a fallback. Measured `@GetMapping`/`@RequestMapping`
+ * counts: `spring-petclinic` 12/2, `shopizer` 85/194, `mall` 0/291. `mall` uses
+ * `@RequestMapping` exclusively — an extractor supporting only verb-specific shortcuts scores
+ * zero on all 291 of its routes. Both mechanisms are first-class here, and the bench counts them
+ * separately so a total miss on one can't average into a healthy-looking figure.
  */
 import type { JavaUnit } from "./parse.ts";
 /** A route as written, before normalisation. Mirrors the Go adapter's shape. */
@@ -65,12 +35,8 @@ export interface SpringRoute {
     readonly framework: string;
 }
 /**
- * Every JAX-RS route this compilation unit declares.
- *
- * A resource class is one carrying `@Path` — a class with verb-annotated
- * methods but no `@Path` of its own is an abstract base, not itself served,
- * mirroring Spring's own "no class mapping still needs a route-bearing
- * annotation somewhere" shape.
+ * Every JAX-RS route this compilation unit declares. A resource class carries `@Path`;
+ * verb-annotated methods with no class `@Path` are an abstract base, not served.
  */
 export declare function jaxrsRoutes(unit: JavaUnit): SpringRoute[];
 /** Every route this compilation unit declares. */

package/dist/spring.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spring.d.ts","sourceRoot":"","sources":["../src/spring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAEH,OAAO,KAAK,EAAwC,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEjF,gFAAgF;AAChF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAiPD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,WAAW,EAAE,CAyCzD;AAED,kDAAkD;AAClD,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,WAAW,EAAE,CA6D1D"}
+{"version":3,"file":"spring.d.ts","sourceRoot":"","sources":["../src/spring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAwC,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEjF,gFAAgF;AAChF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AA0JD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,WAAW,EAAE,CAuCzD;AAED,kDAAkD;AAClD,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,WAAW,EAAE,CAuD1D"}

package/dist/spring.js

@@ -1,56 +1,26 @@
 /**
- * The HTTP-route framework extractor for Java — Spring MVC and Spring WebFlux.
- *
- * **An `API_ROUTE` is a framework claim, and this file is where it is earned.**
- * DEC-127 fixed the admission rules before any of this was written, for the
- * reason `adapter-python`'s ORM records: two of its rules were corrected by
- * counting after the fact, and a written rule is falsifiable by a count while a
- * rule living in code is falsifiable only by argument.
- *
- * ## Where the precision risk is NOT, measured first
- *
- * `adapter-python/src/routes.ts` spends most of its length defending against
- * `@mock.patch` being spelled like an HTTP verb — 1,150 of them in `saleor`, all
- * of which a name rule would have called routes. **Java has no equivalent
- * collision in this corpus.** Measured across `spring-petclinic`, `shopizer`,
- * `mall` and `airbyte` before writing this: `@Get(`, `@Path(` and Micronaut's
- * `@Controller` occur **0** times. Spring's annotation names do not collide with
- * anything.
- *
- * So the receiver-provenance machinery that dominates the Python extractor is
- * not the work here. **The work is the path join**, and getting that wrong is
- * silent.
- *
- * ## Where the precision risk IS
- *
- * A served path is the class-level prefix joined to the method-level suffix:
- *
- *     @RestController
- *     @RequestMapping("/orders")     <- the prefix
- *     class Routes {
- *         @GetMapping("/{id}")       <- the suffix
- *
- * **An extractor reading only the method annotation produces `/{id}`, which
- * normalises to `/{param}`, joins to no endpoint, and is a wrong edge** — worse
- * than emitting nothing under rule 2, because a wrong edge corrupts every layer
- * above it while a missing one is a disclosed gap. The Java conformance fixture
- * is deliberately shaped to fail that implementation.
- *
- * ## `@RequestMapping` is not a fallback — it is the dominant form
- *
- * Measured before writing, and it changed the shape of this file:
- *
- * | repository | `@GetMapping` | `@RequestMapping` |
- * | --- | --- | --- |
- * | `spring-petclinic` | 12 | 2 |
- * | `shopizer` | 85 | **194** |
- * | `mall` | **0** | **291** |
- *
- * **`mall` uses `@RequestMapping` exclusively.** An extractor supporting only
- * the verb-specific shortcuts scores zero on all 291 of its routes — not a
- * degraded number, zero, with nothing in the output to say why. Both mechanisms
- * are therefore first-class here, and the bench counts them separately so a
- * total miss on one cannot average into a single healthy-looking figure.
+ * The HTTP-route framework extractor for Java — Spring MVC and Spring WebFlux. **An `API_ROUTE`
+ * is a framework claim, earned here.** DEC-127 fixed the admission rules before any of this was
+ * written — a written rule is falsifiable by a count, one living only in code is not.
+ *
+ * Where the precision risk is NOT: `adapter-python/src/routes.ts` spends most of its length on
+ * `@mock.patch` looking like an HTTP verb (1,150 in `saleor`). Measured across
+ * `spring-petclinic`, `shopizer`, `mall` and `airbyte`: `@Get(`, `@Path(` and Micronaut's
+ * `@Controller` occur **0** times — Spring's annotation names don't collide with anything, so
+ * receiver-provenance machinery isn't the work here.
+ *
+ * Where the precision risk IS: the path join. A served path is the class-level prefix joined to
+ * the method-level suffix (`@RequestMapping("/orders")` on the class, `@GetMapping("/{id}")` on
+ * the method → `/orders/{id}`). **Reading only the method annotation produces `/{id}`,
+ * normalises to `/{param}`, and joins to no endpoint — a wrong edge**, worse than emitting
+ * nothing (rule 2: a wrong edge corrupts every layer above it). The conformance fixture is
+ * shaped to catch exactly this.
+ *
+ * `@RequestMapping` is the dominant form, not a fallback. Measured `@GetMapping`/`@RequestMapping`
+ * counts: `spring-petclinic` 12/2, `shopizer` 85/194, `mall` 0/291. `mall` uses
+ * `@RequestMapping` exclusively — an extractor supporting only verb-specific shortcuts scores
+ * zero on all 291 of its routes. Both mechanisms are first-class here, and the bench counts them
+ * separately so a total miss on one can't average into a healthy-looking figure.
  */
 /** Verb-specific shortcuts. The verb is fixed by the annotation's own name. */
 const SHORTCUTS = new Map([
@@ -63,14 +33,10 @@ const SHORTCUTS = new Map([
 const MAPPING = "RequestMapping";
 const ALL_VERBS = ["GET", "POST", "PUT", "PATCH", "DELETE"];
 /**
- * The packages whose presence makes an annotation Spring's.
- *
- * Provenance, not spelling — the rule Lane C arrived at independently in Go and
- * the one this project applies everywhere: a node type comes from an import, a
- * decorator or a base class, or from nothing. A `@GetMapping` in a file that
- * imports no Spring package is not a Spring route, and this corpus contains
- * exactly the counter-case that matters: `airbyte` is a large, active, real Java
- * codebase on Micronaut where the correct output of this file is **nothing**.
+ * The packages whose presence makes an annotation Spring's. Provenance, not spelling: a node
+ * type comes from an import, a decorator or a base class, or from nothing. `airbyte` is the
+ * counter-case that matters — a large, real Java codebase on Micronaut where this file's
+ * correct output is **nothing**.
  */
 const SPRING_PACKAGES = [
     "org.springframework.web.bind.annotation",
@@ -85,18 +51,12 @@ function importsSpring(unit) {
     return unit.wildcardImports.some((pkg) => SPRING_PACKAGES.includes(pkg));
 }
 /**
- * The path an annotation declares, or `undefined` when it declares none.
- *
- * Spring accepts the path as the unnamed argument, as `value =`, or as
- * `path =`. All three are the same thing and an extractor reading only the first
- * misses `@RequestMapping(value = "/x", method = …)`, which is the form that
- * dominates `mall` and `shopizer` — the named form is *required* as soon as a
- * second argument appears, so the dominant mechanism and the named form arrive
- * together.
+ * The path an annotation declares, or `undefined` when it declares none. Reads all three
+ * equivalent forms — unnamed argument, `value =`, `path =` — since the named form is required
+ * once a second argument appears, and that's the dominant shape in `mall`/`shopizer`.
  *
- * **A list, because every element is a served path.** `@GetMapping({"/a","/b"})`
- * serves both, and `shopizer` writes 140 of its 356 mappings that way. Taking
- * only the first would lose 39% of one corpus silently.
+ * Returns a list: `@GetMapping({"/a","/b"})` serves both, and `shopizer` writes 140 of its 356
+ * mappings that way — taking only the first would lose 39% of one corpus silently.
  */
 function pathsOf(annotation) {
     if (annotation.values.length > 0)
@@ -104,16 +64,12 @@ function pathsOf(annotation) {
     return annotation.named.get("value") ?? annotation.named.get("path") ?? [];
 }
 /**
- * The verbs a mapping annotation covers.
+ * The verbs a mapping annotation covers. `method = RequestMethod.GET` is a field access, not a
+ * literal, so it's read from raw argument text — the parse doesn't special-case Spring's enum
+ * (rule 1: no framework vocabulary in the language layer).
  *
- * `method = RequestMethod.GET` is a field access rather than a literal, so it is
- * read from the raw argument text — the parse deliberately does not special-case
- * Spring's enum, because a framework's vocabulary in the language layer is the
- * leak rule 1 forbids.
- *
- * **`@RequestMapping` with no `method` covers every verb**, and DEC-127 says to
- * emit one route per verb rather than one route with an unknown verb. A route
- * whose method is a guess joins to the wrong endpoint or to none.
+ * `@RequestMapping` with no `method` covers every verb; DEC-127 emits one route per verb rather
+ * than guessing, since a guessed method joins to the wrong endpoint or to none.
  */
 function verbsOf(annotation) {
     const shortcut = SHORTCUTS.get(annotation.name);
@@ -135,11 +91,9 @@ function mappingOf(annotations) {
     return annotations.find((each) => SHORTCUTS.has(each.name) || each.name === MAPPING);
 }
 /**
- * Join a class prefix to a method suffix.
- *
- * Spring is forgiving about the slash on either side and a repository mixes both
- * spellings freely; the template has to come out the same either way or two
- * files declaring the same URL mint two endpoint ids and join to nothing.
+ * Join a class prefix to a method suffix. Spring is forgiving about the slash on either side;
+ * the template must come out the same regardless, or two files declaring the same URL mint two
+ * endpoint ids that join to nothing.
  */
 function join(prefix, suffix) {
     const left = prefix.replace(/\/+$/, "");
@@ -149,71 +103,21 @@ function join(prefix, suffix) {
     return `${left}/${right}`;
 }
 /**
- * Is this type a Spring web controller, and does it serve DATA or PAGES?
- *
- * `@RestController` is `@Controller` + `@ResponseBody`: every handler returns
- * data. A bare `@Controller` returns **view names** unless a handler opts out
- * with its own `@ResponseBody`.
- *
- * ## Why this is implemented rather than disclosed
- *
- * The first pass admitted both and recorded the over-admission as a known gap.
- * Predicting the rate before drawing — `bench/spring-viewroutes.mjs`, registered
- * in advance — showed the gap was not small:
- *
- * | corpus | routes | from `@Controller` with no `@ResponseBody` |
- * | --- | --- | --- |
- * | `spring-petclinic` | 16 | **15 — 93.8%** |
- * | `shopizer` | 195 | 3 |
- * | `mall` | 239 | 0 |
- *
- * **`spring-petclinic` is a server-rendered Thymeleaf application.** Nearly
- * every one of its handlers returns a template name. Shipping the disclosure
- * would have put the predicted precision ceiling at ~96%, under this lane's 98%
- * bar, on a **wrong edge** rather than a gap — and rule 2 does not treat those
- * the same. So the prediction did its job: it turned "a known limit, disclosed"
- * into "too large to disclose", before a draw rather than after.
- *
- * ## The rule, and the recall it used to cost
- *
- * A handler is admitted when its class is `@RestController`, **or** its class or
- * the handler itself carries `@ResponseBody`, **or** it returns
- * `ResponseEntity<T>`.
- *
- * The third clause was a disclosed gap and is now closed, and the way it closed
- * is the point. The disclosure pre-registered its own threshold — *"not worth
- * it yet… if a corpus later shows the number in the dozens, it becomes worth
- * it, and the count is here to be re-run"* — so re-running the count is what
- * decided it, not a later reading of the same evidence.
- *
- * **Both halves of the old disclosure were wrong, and in opposite directions.**
- *
- * | corpus | files, as disclosed → recounted | sites refused, disclosed → recounted |
- * | --- | --- | --- |
- * | `spring-petclinic` | 5 → 6 | 17 → 17 |
- * | `shopizer` | 3 → **20** | 6 → **74** |
- * | `mall` | 0 → 2 | 0 → 5 |
- *
- * The refused population was **twelve times** what the disclosure claimed for
- * `shopizer`. *"The gap carries its population, because a disclosure without one
- * is a sentence that has shed its scope"* — and a population stated once and
- * never re-measured sheds its scope quietly, which is worse than never stating
- * one, because it reads as due diligence.
- *
- * The other half went the other way: `ResponseEntity` was counted in
- * **mentions** (12), and a mention is not a refused route. Counted as routes
- * the widening actually emits, it is **13 on `shopizer` and 0 on the other
- * two** — the unit the rule's subject is in, which is the only unit a threshold
- * can be compared against.
- *
- * `spring-petclinic`'s 17 remain refused and must: they return `String` view
- * names, and it is five files of server-rendered pages. The widening is
- * therefore narrow by construction — `ResponseEntity` is Spring's own response
- * type, never resolved through a view resolver, and no other return type
- * answers the question on its own.
- *
- * Re-run after the widening, as every widening in this lane is: route precision
- * 200/200 on a 538 population, Wilson LB 98.1%, negative control 0/200.
+ * Is this type a Spring web controller, and does it serve DATA or PAGES? `@RestController` is
+ * `@Controller` + `@ResponseBody`: every handler returns data. A bare `@Controller` returns
+ * **view names** unless a handler opts out with its own `@ResponseBody`.
+ *
+ * Measured before implementing the view/data split (routes admitted from `@Controller` with no
+ * `@ResponseBody`): `spring-petclinic` 16 routes, **15 — 93.8%**; `shopizer` 195 routes, 3;
+ * `mall` 239 routes, 0. `spring-petclinic` is a server-rendered Thymeleaf app — admitting both
+ * kinds would put the precision ceiling at ~96%, under this lane's 98% bar, on a **wrong edge**
+ * rather than a gap (rule 2 doesn't treat those the same).
+ *
+ * A handler is admitted when its class is `@RestController`, **or** its class or the handler
+ * carries `@ResponseBody`, **or** it returns `ResponseEntity<T>` — Spring's own response type,
+ * which never resolves through a view resolver and so answers the data/page question on its own
+ * regardless of annotations. Route precision after this rule: 200/200 on a 538 population,
+ * Wilson LB 98.1%, negative control 0/200.
  */
 function controllerKind(type) {
     const names = new Set(type.annotations.map((each) => each.name));
@@ -224,45 +128,28 @@ function controllerKind(type) {
     return names.has("ResponseBody") ? "data" : "view";
 }
 /**
- * Does this handler return an HTTP body rather than a view name?
- *
- * `ResponseEntity<T>` is Spring's own response type and never resolves through
- * a view resolver, so a `@Controller` method returning one is an API route with
- * or without `@ResponseBody`. It is the one return type that answers this
- * question on its own; anything else — `String`, `ModelAndView`, a DTO — either
- * *is* a view name or needs the annotation to say it is not.
+ * Does this handler return an HTTP body rather than a view name? `ResponseEntity<T>` never
+ * resolves through a view resolver, so it answers this on its own; anything else needs
+ * `@ResponseBody` to say it isn't a view.
  */
 function returnsBody(method) {
     const returned = method.returnType;
     return returned.kind === "named" && returned.name === "ResponseEntity";
 }
-// ---------------------------------------------------------------------------
-// JAX-RS — `javax.ws.rs`/`jakarta.ws.rs`. `language-problems.md` §3's third
-// row: `SPRING_PACKAGES` only ever named Spring's own packages, so a JAX-RS
-// resource — real in any Java shop that predates or skipped Spring Boot, or
-// that uses Quarkus/RESTEasy/Jersey, all of which build on the same
-// annotations — produced nothing here, correctly refused by
-// {@link importsSpring} rather than misread, but with no route reader for the
-// framework it was refusing in favour of.
+// JAX-RS (`javax.ws.rs`/`jakarta.ws.rs`) — a resource on Quarkus/RESTEasy/Jersey/plain JAX-RS
+// previously produced nothing, correctly refused by {@link importsSpring} but with no reader
+// for the framework it refused in favour of.
 //
-// The shape is structurally different from Spring's, which is why this is a
-// second reader rather than a second provenance list on the same one: Spring
-// puts the verb and the path on *one* annotation (`@GetMapping("/x")`);
-// JAX-RS puts them on *two* — a bare verb marker (`@GET`, no arguments at
-// all) and a separate, optional `@Path` that may sit on the class, the
-// method, or both. `@RequestMapping`'s "no method means every verb" rule
-// (DEC-127) has no JAX-RS analogue: a JAX-RS handler with no verb annotation
-// is not a route at all, so there is nothing to widen to every verb — it is
-// simply skipped, the same way a plain non-`@Path` class is.
-// ---------------------------------------------------------------------------
+// Structurally different from Spring, hence a second reader: Spring puts verb and path on one
+// annotation; JAX-RS splits them into a bare verb marker (`@GET`, no arguments) and a separate,
+// optional `@Path` (class, method, or both). No analogue to `@RequestMapping`'s "no method means
+// every verb" (DEC-127) — a JAX-RS handler with no verb annotation isn't a route at all, so it's
+// simply skipped.
 const JAXRS_PACKAGES = ["javax.ws.rs", "jakarta.ws.rs"];
 /**
- * Does this unit import JAX-RS at all?
- *
- * Both the old `javax.ws.rs` and the Jakarta-renamed `jakarta.ws.rs` are
- * checked — a real migration takes years, and a corpus written against either
- * spelling is real code, the same reasoning `adapter-java`'s JPA reader
- * already applies to `javax.persistence`/`jakarta.persistence`.
+ * Does this unit import JAX-RS at all? Both `javax.ws.rs` and the Jakarta-renamed
+ * `jakarta.ws.rs` are checked — a real migration takes years, same reasoning as the JPA reader's
+ * `javax`/`jakarta.persistence` split.
  */
 function importsJaxRs(unit) {
     for (const fqn of unit.singleTypeImports.values()) {
@@ -271,11 +158,7 @@ function importsJaxRs(unit) {
     }
     return unit.wildcardImports.some((pkg) => JAXRS_PACKAGES.includes(pkg));
 }
-/**
- * JAX-RS's verb annotations. Each is a bare marker with no arguments — the
- * verb is the annotation's own name, never a `method = ` attribute the way
- * Spring's `@RequestMapping` carries one.
- */
+/** JAX-RS verb annotations — bare markers, unlike Spring's `method =` attribute. */
 const JAXRS_VERBS = new Set(["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]);
 function jaxrsVerbOf(annotations) {
     return annotations.map((each) => each.name).find((name) => JAXRS_VERBS.has(name));
@@ -284,12 +167,8 @@ function jaxrsPathOf(annotations) {
     return annotations.find((each) => each.name === "Path");
 }
 /**
- * Every JAX-RS route this compilation unit declares.
- *
- * A resource class is one carrying `@Path` — a class with verb-annotated
- * methods but no `@Path` of its own is an abstract base, not itself served,
- * mirroring Spring's own "no class mapping still needs a route-bearing
- * annotation somewhere" shape.
+ * Every JAX-RS route this compilation unit declares. A resource class carries `@Path`;
+ * verb-annotated methods with no class `@Path` are an abstract base, not served.
  */
 export function jaxrsRoutes(unit) {
     if (!importsJaxRs(unit))
@@ -307,10 +186,8 @@ export function jaxrsRoutes(unit) {
                 continue;
             const methodPath = jaxrsPathOf(method.annotations);
             const suffixes = methodPath === undefined ? [] : pathsOf(methodPath);
-            // Mirrors Spring's own `unreadable` rule: a `@Path` with an argument
-            // this reader could not turn into a literal is refused rather than
-            // guessed; a handler with no `@Path` at all legally serves the class
-            // prefix bare.
+            // Mirrors Spring's `unreadable` rule: an unreadable `@Path` argument is refused, not
+            // guessed; no `@Path` at all legally serves the bare prefix.
             const unreadable = methodPath !== undefined && suffixes.length === 0 && methodPath.rawArguments.length > 0;
             if (unreadable)
                 continue;
@@ -343,10 +220,8 @@ export function springRoutes(unit) {
         const kind = controllerKind(type);
         if (kind === null)
             continue;
-        // The class-level prefix. A controller may carry `@RequestMapping` with no
-        // path at all, which contributes nothing rather than a slash.
-        // The class-level prefix. A controller mapped to several prefixes serves
-        // every combination, so the empty case is one empty prefix rather than none.
+        // Class-level prefix: no `@RequestMapping` path contributes nothing (not a slash); several
+        // prefixes serve every combination, so empty means one empty prefix, not zero.
         const classMapping = mappingOf(type.annotations);
         const classPaths = classMapping === undefined ? [] : pathsOf(classMapping);
         const prefixes = classPaths.length > 0 ? classPaths : [""];
@@ -354,21 +229,17 @@ export function springRoutes(unit) {
             const mapping = mappingOf(method.annotations);
             if (mapping === undefined)
                 continue;
-            // A view controller's handler serves a page unless it opts out itself.
-            // `spring-petclinic`'s VetController holds both kinds in one file, which is
-            // why this is decided per handler and not per class.
+            // A view handler serves a page unless it opts out itself — decided per handler, not per
+            // class: `spring-petclinic`'s VetController mixes both.
             if (kind === "view" &&
                 !method.annotations.some((each) => each.name === "ResponseBody") &&
                 !returnsBody(method)) {
                 continue;
             }
             const suffixes = pathsOf(mapping);
-            // A mapping whose path is a constant reference or a concatenation yields
-            // no literal. DEC-127 refuses it: a path this adapter cannot read is not a
-            // path it may invent, and the alternative is an endpoint id that joins to
-            // the wrong service. A mapping with no argument at all is legal and means
-            // "the class prefix", so it is only refused when there was something to
-            // read and it could not be read.
+            // A constant-reference or concatenated path yields no literal. DEC-127: refused rather
+            // than invented (else it joins to the wrong service). No argument at all is legal and
+            // means "the class prefix" — only refused when something was there and unreadable.
             const unreadable = suffixes.length === 0 && mapping.rawArguments.length > 0;
             if (unreadable)
                 continue;

package/dist/spring.js.map

@@ -1 +1 @@
-{"version":3,"file":"spring.js","sourceRoot":"","sources":["../src/spring.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"spring.js","sourceRoot":"","sources":["../src/spring.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,9 +1,18 @@
 {
   "name": "@descryy/adapter-java",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "type": "module",
-  "description": "Java adapter, breadth tier. One grammar and one query set over the shared tree-sitter harness \u2014 no JDT, no SCIP, no Spring. Reaches R1 on explicit imports, which is further than a breadth adapter reaches in most languages.",
+  "description": "Java adapter, breadth tier. One grammar and one query set over the shared tree-sitter harness — no JDT, no SCIP, no Spring. Reaches R1 on explicit imports, which is further than a breadth adapter reaches in most languages.",
   "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/descryhq-wq/descry-adapters.git",
+    "directory": "packages/adapter-java"
+  },
+  "bugs": {
+    "url": "https://github.com/descryhq-wq/descry-adapters/issues"
+  },
+  "homepage": "https://github.com/descryhq-wq/descry-adapters#readme",
   "engines": {
     "node": ">=22.5"
   },
@@ -25,12 +34,12 @@
     "build:assets": "node -e \"require('fs').copyFileSync(require.resolve('tree-sitter-java/tree-sitter-java.wasm'),'dist/tree-sitter-java.wasm')\""
   },
   "dependencies": {
-    "@descryy/adapter-common": "0.1.0",
+    "@descryy/adapter-common": "0.2.0",
     "@descryy/adapter-jvm": "0.1.0",
-    "@descryy/adapter-treesitter": "0.1.0",
-    "@descryy/ir": "0.4.0",
+    "@descryy/adapter-treesitter": "0.2.0",
+    "@descryy/ir": "0.5.1",
     "tree-sitter-java": "0.23.5",
-    "@descryy/adapter-sql": "0.2.0",
-    "@descryy/adapter-openapi": "0.2.0"
+    "@descryy/adapter-sql": "0.3.1",
+    "@descryy/adapter-openapi": "0.3.1"
   }
 }