@wunk/lb-script-api-types 0.38.3 → 0.38.4

package/README.md

@@ -60,6 +60,30 @@ import { AttackEntityEvent } from "@wunk/lb-script-api-types/types/net/ccbluex/l
 The package ships one `.d.ts` per class (mirroring the JVM package layout), so
 `tsc` only parses the types a script actually imports.
 
+### Typed `Java.type` (opt-in registry)
+
+By default `Java.type(...)` returns `any` (or takes an explicit generic).
+Opt into the string-literal registry and it is fully typed from the class
+name alone — autocomplete on the string, typed statics/constructors on the
+result. Works in plain JS too (the editor language service picks it up from
+jsconfig):
+
+```jsonc
+"types": [
+  "@wunk/lb-script-api-types/ambient",
+  "@wunk/lb-script-api-types/registry-lb"   // net.ccbluex.* (~2.6k classes, ~+1s tsc)
+]
+```
+
+```ts
+const SilentHotbar = Java.type("net.ccbluex.liquidbounce.utils.client.SilentHotbar");
+SilentHotbar.INSTANCE.serversideSlot;   // typed — no generic, no import
+```
+
+`registry-full` covers every generated class (~49k) — great for editor use,
+but it adds tens of seconds to batch `tsc` runs, so prefer `registry-lb` in
+CI. Unknown class names fall back to the generic `any` overload either way.
+
 LiquidBounce internals that have a generated type but are **not** runtime
 globals (e.g. `SilentHotbar`) are reached via `Java.type`, typed with the
 matching import:

package/ambient/ambient.d.ts

@@ -32,9 +32,16 @@ declare global {
     // script but invisible to `Object.entries(globalThis)`. See:
     //   https://www.graalvm.org/jdk25/reference-manual/js/JavaInteroperability/
     //   https://www.graalvm.org/jdk25/reference-manual/polyglot-programming/
+    /** Merge target for the optional Java.type string-literal registry —
+     *  add "@wunk/lb-script-api-types/registry-lb" (or registry-full) to your
+     *  tsconfig "types" to populate it. Empty by default: zero compile cost,
+     *  Java.type falls back to the generic overload. */
+    interface JavaTypeRegistry {}
+
     interface JavaIntrinsic {
         /** Resolve a Java class by FQN. Returns a "type" handle: callable as
          *  a constructor and indexable for static members. */
+        type<K extends keyof JavaTypeRegistry>(className: K): JavaTypeRegistry[K];
         type<T = any>(className: string): T;
         /** Convert a Java array (or Iterable) to a JS array. */
         from<T = unknown>(javaArray: any): T[];

package/package.json

@@ -1,56 +1,64 @@
 {
-  "name": "@wunk/lb-script-api-types",
-  "version": "0.38.3",
-  "description": "TypeScript types for the LiquidBounce (nextgen, MC 1.21+) GraalJS script API — a heavily-refined fork of CCBlueX's @ccbluex/liquidbounce-script-api with typed per-event on() overloads, KDoc→TSDoc docs, binding fixes, and ambient globals.",
-  "license": "GPL-3.0-or-later",
-  "author": "obus-globus",
-  "homepage": "https://github.com/obus-globus/lb-script-api-types#readme",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/obus-globus/lb-script-api-types.git",
-    "directory": "typings"
-  },
-  "bugs": {
-    "url": "https://github.com/obus-globus/lb-script-api-types/issues"
-  },
-  "keywords": [
-    "liquidbounce",
-    "minecraft",
-    "graaljs",
-    "graalvm",
-    "script-api",
-    "scripting",
-    "types",
-    "typescript",
-    "ccbluex"
-  ],
-  "types": "ambient/ambient.d.ts",
-  "files": [
-    "types/**/*.d.ts",
-    "augmentations/**/*.d.ts",
-    "ambient/ambient.d.ts"
-  ],
-  "typesVersions": {
-    "*": {
-      "types/*": [
-        "./types/*"
-      ],
-      "augmentations/*": [
-        "./augmentations/*"
-      ],
-      "ambient": [
-        "./ambient/ambient.d.ts"
-      ]
+    "name": "@wunk/lb-script-api-types",
+    "version": "0.38.4",
+    "description": "TypeScript types for the LiquidBounce (nextgen, MC 1.21+) GraalJS script API — a heavily-refined fork of CCBlueX's @ccbluex/liquidbounce-script-api with typed per-event on() overloads, KDoc→TSDoc docs, binding fixes, and ambient globals.",
+    "license": "GPL-3.0-or-later",
+    "author": "obus-globus",
+    "homepage": "https://github.com/obus-globus/lb-script-api-types#readme",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/obus-globus/lb-script-api-types.git",
+        "directory": "typings"
+    },
+    "bugs": {
+        "url": "https://github.com/obus-globus/lb-script-api-types/issues"
+    },
+    "keywords": [
+        "liquidbounce",
+        "minecraft",
+        "graaljs",
+        "graalvm",
+        "script-api",
+        "scripting",
+        "types",
+        "typescript",
+        "ccbluex"
+    ],
+    "types": "ambient/ambient.d.ts",
+    "files": [
+        "types/**/*.d.ts",
+        "augmentations/**/*.d.ts",
+        "ambient/ambient.d.ts",
+        "registry-lb/index.d.ts",
+        "registry-full/index.d.ts"
+    ],
+    "typesVersions": {
+        "*": {
+            "types/*": [
+                "./types/*"
+            ],
+            "augmentations/*": [
+                "./augmentations/*"
+            ],
+            "ambient": [
+                "./ambient/ambient.d.ts"
+            ],
+            "registry-lb": [
+                "./registry-lb/index.d.ts"
+            ],
+            "registry-full": [
+                "./registry-full/index.d.ts"
+            ]
+        }
+    },
+    "sideEffects": false,
+    "publishConfig": {
+        "access": "public"
+    },
+    "liquidbounce": {
+        "version": "0.38.1",
+        "minecraft": "26.1.2",
+        "commit": "b759cac57b26e54694d8c4d48af024a8fb598f62",
+        "ref": "v0.38.0-33-gb759cac57"
     }
-  },
-  "sideEffects": false,
-  "publishConfig": {
-    "access": "public"
-  },
-  "liquidbounce": {
-    "version": "0.38.1",
-    "minecraft": "26.1.2",
-    "commit": "b759cac57b26e54694d8c4d48af024a8fb598f62",
-    "ref": "v0.38.0-33-gb759cac57"
-  }
 }