@defold-typescript/types 0.28.3 → 0.30.0

package/api-signatures.json

@@ -955,7 +955,7 @@
       "physics\u0000FUNCTION\u0000physics.get_joint_reaction_force\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"hash\",\"string\"],\"isOptional\":false}]->[{\"types\":[\"vector3\"],\"isOptional\":false}]": "function get_joint_reaction_force(collisionobject: string | Hash | Url, joint_id: string | Hash): Vector3;",
       "physics\u0000FUNCTION\u0000physics.get_joint_reaction_torque\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"hash\",\"string\"],\"isOptional\":false}]->[{\"types\":[\"number\"],\"isOptional\":false}]": "function get_joint_reaction_torque(collisionobject: string | Hash | Url, joint_id: string | Hash): number;",
       "physics\u0000FUNCTION\u0000physics.get_maskbit\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"string\"],\"isOptional\":false}]->[{\"types\":[\"boolean\"],\"isOptional\":false}]": "function get_maskbit(url: string | Hash | Url, group: string): boolean;",
-      "physics\u0000FUNCTION\u0000physics.get_shape\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"hash\",\"string\"],\"isOptional\":false}]->[{\"types\":[\"table\"],\"isOptional\":false}]": "function get_shape(url: string | Hash | Url, shape: string | Hash): { type: number; diameter: number; dimensions: Vector3; diameter: number; height: number };",
+      "physics\u0000FUNCTION\u0000physics.get_shape\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"hash\",\"string\"],\"isOptional\":false}]->[{\"types\":[\"table\"],\"isOptional\":false}]": "function get_shape(url: string | Hash | Url, shape: string | Hash): { type: number; diameter?: number; dimensions?: Vector3; height?: number };",
       "physics\u0000FUNCTION\u0000physics.raycast\u0000[{\"types\":[\"vector3\"],\"isOptional\":false},{\"types\":[\"vector3\"],\"isOptional\":false},{\"types\":[\"table\"],\"isOptional\":false},{\"types\":[\"table\"],\"isOptional\":true}]->[{\"types\":[\"nil\",\"table\"],\"isOptional\":false}]": "function raycast(from: Vector3, to: Vector3, groups: Hash[], options?: { all?: boolean }): { fraction: number; position: Vector3; normal: Vector3; id: Hash; group: Hash; request_id: number }[] | undefined;",
       "physics\u0000FUNCTION\u0000physics.raycast_async\u0000[{\"types\":[\"vector3\"],\"isOptional\":false},{\"types\":[\"vector3\"],\"isOptional\":false},{\"types\":[\"table\"],\"isOptional\":false},{\"types\":[\"number\"],\"isOptional\":true}]->[]": "function raycast_async(from: Vector3, to: Vector3, groups: Hash[], request_id?: number): void;",
       "physics\u0000FUNCTION\u0000physics.set_event_listener\u0000[{\"types\":[\"function(self, events)\",\"nil\"],\"isOptional\":false}]->[]": "function set_event_listener(callback?: (self: unknown, events: unknown) => void): void;",
@@ -964,7 +964,7 @@
       "physics\u0000FUNCTION\u0000physics.set_hflip\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"boolean\"],\"isOptional\":false}]->[]": "function set_hflip(url: string | Hash | Url, flip: boolean): void;",
       "physics\u0000FUNCTION\u0000physics.set_joint_properties\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"hash\",\"string\"],\"isOptional\":false},{\"types\":[\"table\"],\"isOptional\":false}]->[]": "function set_joint_properties(collisionobject: string | Hash | Url, joint_id: string | Hash, properties: { collide_connected?: boolean }): void;",
       "physics\u0000FUNCTION\u0000physics.set_maskbit\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"string\"],\"isOptional\":false},{\"types\":[\"boolean\"],\"isOptional\":false}]->[]": "function set_maskbit(url: string | Hash | Url, group: string, maskbit: boolean): void;",
-      "physics\u0000FUNCTION\u0000physics.set_shape\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"hash\",\"string\"],\"isOptional\":false},{\"types\":[\"table\"],\"isOptional\":false}]->[]": "function set_shape(url: string | Hash | Url, shape: string | Hash, table: { type?: number; diameter?: number; dimensions?: Vector3; diameter?: number; height?: number }): void;",
+      "physics\u0000FUNCTION\u0000physics.set_shape\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"hash\",\"string\"],\"isOptional\":false},{\"types\":[\"table\"],\"isOptional\":false}]->[]": "function set_shape(url: string | Hash | Url, shape: string | Hash, table: { type?: number; diameter?: number; dimensions?: Vector3; height?: number }): void;",
       "physics\u0000FUNCTION\u0000physics.set_vflip\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"boolean\"],\"isOptional\":false}]->[]": "function set_vflip(url: string | Hash | Url, flip: boolean): void;",
       "physics\u0000FUNCTION\u0000physics.update_mass\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"number\"],\"isOptional\":false}]->[]": "function update_mass(collisionobject: string | Hash | Url, mass: number): void;",
       "physics\u0000FUNCTION\u0000physics.wakeup\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false}]->[]": "function wakeup(url: string | Hash | Url): void;",
@@ -2266,7 +2266,7 @@
       "physics\u0000FUNCTION\u0000physics.get_joint_reaction_force\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"hash\",\"string\"],\"isOptional\":false}]->[{\"types\":[\"vector3\"],\"isOptional\":false}]": "function get_joint_reaction_force(collisionobject: string | Hash | Url, joint_id: string | Hash): Vector3;",
       "physics\u0000FUNCTION\u0000physics.get_joint_reaction_torque\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"hash\",\"string\"],\"isOptional\":false}]->[{\"types\":[\"number\"],\"isOptional\":false}]": "function get_joint_reaction_torque(collisionobject: string | Hash | Url, joint_id: string | Hash): number;",
       "physics\u0000FUNCTION\u0000physics.get_maskbit\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"string\"],\"isOptional\":false}]->[{\"types\":[\"boolean\"],\"isOptional\":false}]": "function get_maskbit(url: string | Hash | Url, group: string): boolean;",
-      "physics\u0000FUNCTION\u0000physics.get_shape\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"hash\",\"string\"],\"isOptional\":false}]->[{\"types\":[\"table\"],\"isOptional\":false}]": "function get_shape(url: string | Hash | Url, shape: string | Hash): { type: number; diameter: number; dimensions: Vector3; diameter: number; height: number };",
+      "physics\u0000FUNCTION\u0000physics.get_shape\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"hash\",\"string\"],\"isOptional\":false}]->[{\"types\":[\"table\"],\"isOptional\":false}]": "function get_shape(url: string | Hash | Url, shape: string | Hash): { type: number; diameter?: number; dimensions?: Vector3; height?: number };",
       "physics\u0000FUNCTION\u0000physics.raycast\u0000[{\"types\":[\"vector3\"],\"isOptional\":false},{\"types\":[\"vector3\"],\"isOptional\":false},{\"types\":[\"table\"],\"isOptional\":false},{\"types\":[\"table\"],\"isOptional\":true}]->[{\"types\":[\"nil\",\"table\"],\"isOptional\":false}]": "function raycast(from: Vector3, to: Vector3, groups: Hash[], options?: { all?: boolean }): { fraction: number; position: Vector3; normal: Vector3; id: Hash; group: Hash; request_id: number }[] | undefined;",
       "physics\u0000FUNCTION\u0000physics.raycast_async\u0000[{\"types\":[\"vector3\"],\"isOptional\":false},{\"types\":[\"vector3\"],\"isOptional\":false},{\"types\":[\"table\"],\"isOptional\":false},{\"types\":[\"number\"],\"isOptional\":true}]->[]": "function raycast_async(from: Vector3, to: Vector3, groups: Hash[], request_id?: number): void;",
       "physics\u0000FUNCTION\u0000physics.set_event_listener\u0000[{\"types\":[\"function(self, events)\",\"nil\"],\"isOptional\":false}]->[]": "function set_event_listener(callback?: (self: unknown, events: unknown) => void): void;",
@@ -2275,7 +2275,7 @@
       "physics\u0000FUNCTION\u0000physics.set_hflip\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"boolean\"],\"isOptional\":false}]->[]": "function set_hflip(url: string | Hash | Url, flip: boolean): void;",
       "physics\u0000FUNCTION\u0000physics.set_joint_properties\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"hash\",\"string\"],\"isOptional\":false},{\"types\":[\"table\"],\"isOptional\":false}]->[]": "function set_joint_properties(collisionobject: string | Hash | Url, joint_id: string | Hash, properties: { collide_connected?: boolean }): void;",
       "physics\u0000FUNCTION\u0000physics.set_maskbit\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"string\"],\"isOptional\":false},{\"types\":[\"boolean\"],\"isOptional\":false}]->[]": "function set_maskbit(url: string | Hash | Url, group: string, maskbit: boolean): void;",
-      "physics\u0000FUNCTION\u0000physics.set_shape\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"hash\",\"string\"],\"isOptional\":false},{\"types\":[\"table\"],\"isOptional\":false}]->[]": "function set_shape(url: string | Hash | Url, shape: string | Hash, table: { type?: number; diameter?: number; dimensions?: Vector3; diameter?: number; height?: number }): void;",
+      "physics\u0000FUNCTION\u0000physics.set_shape\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"hash\",\"string\"],\"isOptional\":false},{\"types\":[\"table\"],\"isOptional\":false}]->[]": "function set_shape(url: string | Hash | Url, shape: string | Hash, table: { type?: number; diameter?: number; dimensions?: Vector3; height?: number }): void;",
       "physics\u0000FUNCTION\u0000physics.set_vflip\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"boolean\"],\"isOptional\":false}]->[]": "function set_vflip(url: string | Hash | Url, flip: boolean): void;",
       "physics\u0000FUNCTION\u0000physics.update_mass\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"number\"],\"isOptional\":false}]->[]": "function update_mass(collisionobject: string | Hash | Url, mass: number): void;",
       "physics\u0000FUNCTION\u0000physics.wakeup\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false}]->[]": "function wakeup(url: string | Hash | Url): void;",
@@ -3279,7 +3279,7 @@
       "physics\u0000FUNCTION\u0000physics.get_joint_reaction_force\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"hash\",\"string\"],\"isOptional\":false}]->[{\"types\":[\"vector3\"],\"isOptional\":false}]": "function get_joint_reaction_force(collisionobject: string | Hash | Url, joint_id: string | Hash): Vector3;",
       "physics\u0000FUNCTION\u0000physics.get_joint_reaction_torque\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"hash\",\"string\"],\"isOptional\":false}]->[{\"types\":[\"number\"],\"isOptional\":false}]": "function get_joint_reaction_torque(collisionobject: string | Hash | Url, joint_id: string | Hash): number;",
       "physics\u0000FUNCTION\u0000physics.get_maskbit\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"string\"],\"isOptional\":false}]->[{\"types\":[\"boolean\"],\"isOptional\":false}]": "function get_maskbit(url: string | Hash | Url, group: string): boolean;",
-      "physics\u0000FUNCTION\u0000physics.get_shape\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"hash\",\"string\"],\"isOptional\":false}]->[{\"types\":[\"table\"],\"isOptional\":false}]": "function get_shape(url: string | Hash | Url, shape: string | Hash): { type: number; diameter: number; dimensions: Vector3; diameter: number; height: number };",
+      "physics\u0000FUNCTION\u0000physics.get_shape\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"hash\",\"string\"],\"isOptional\":false}]->[{\"types\":[\"table\"],\"isOptional\":false}]": "function get_shape(url: string | Hash | Url, shape: string | Hash): { type: number; diameter?: number; dimensions?: Vector3; height?: number };",
       "physics\u0000FUNCTION\u0000physics.raycast\u0000[{\"types\":[\"vector3\"],\"isOptional\":false},{\"types\":[\"vector3\"],\"isOptional\":false},{\"types\":[\"table\"],\"isOptional\":false},{\"types\":[\"table\"],\"isOptional\":true}]->[{\"types\":[\"nil\",\"table\"],\"isOptional\":false}]": "function raycast(from: Vector3, to: Vector3, groups: Hash[], options?: { all?: boolean }): { fraction: number; position: Vector3; normal: Vector3; id: Hash; group: Hash; request_id: number }[] | undefined;",
       "physics\u0000FUNCTION\u0000physics.raycast_async\u0000[{\"types\":[\"vector3\"],\"isOptional\":false},{\"types\":[\"vector3\"],\"isOptional\":false},{\"types\":[\"table\"],\"isOptional\":false},{\"types\":[\"number\"],\"isOptional\":true}]->[]": "function raycast_async(from: Vector3, to: Vector3, groups: Hash[], request_id?: number): void;",
       "physics\u0000FUNCTION\u0000physics.set_event_listener\u0000[{\"types\":[\"function(self, events)\",\"nil\"],\"isOptional\":false}]->[]": "function set_event_listener(callback?: (self: unknown, events: unknown) => void): void;",
@@ -3288,7 +3288,7 @@
       "physics\u0000FUNCTION\u0000physics.set_hflip\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"boolean\"],\"isOptional\":false}]->[]": "function set_hflip(url: string | Hash | Url, flip: boolean): void;",
       "physics\u0000FUNCTION\u0000physics.set_joint_properties\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"hash\",\"string\"],\"isOptional\":false},{\"types\":[\"table\"],\"isOptional\":false}]->[]": "function set_joint_properties(collisionobject: string | Hash | Url, joint_id: string | Hash, properties: { collide_connected?: boolean }): void;",
       "physics\u0000FUNCTION\u0000physics.set_maskbit\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"string\"],\"isOptional\":false},{\"types\":[\"boolean\"],\"isOptional\":false}]->[]": "function set_maskbit(url: string | Hash | Url, group: string, maskbit: boolean): void;",
-      "physics\u0000FUNCTION\u0000physics.set_shape\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"hash\",\"string\"],\"isOptional\":false},{\"types\":[\"table\"],\"isOptional\":false}]->[]": "function set_shape(url: string | Hash | Url, shape: string | Hash, table: { type?: number; diameter?: number; dimensions?: Vector3; diameter?: number; height?: number }): void;",
+      "physics\u0000FUNCTION\u0000physics.set_shape\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"hash\",\"string\"],\"isOptional\":false},{\"types\":[\"table\"],\"isOptional\":false}]->[]": "function set_shape(url: string | Hash | Url, shape: string | Hash, table: { type?: number; diameter?: number; dimensions?: Vector3; height?: number }): void;",
       "physics\u0000FUNCTION\u0000physics.set_vflip\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"boolean\"],\"isOptional\":false}]->[]": "function set_vflip(url: string | Hash | Url, flip: boolean): void;",
       "physics\u0000FUNCTION\u0000physics.update_mass\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false},{\"types\":[\"number\"],\"isOptional\":false}]->[]": "function update_mass(collisionobject: string | Hash | Url, mass: number): void;",
       "physics\u0000FUNCTION\u0000physics.wakeup\u0000[{\"types\":[\"hash\",\"string\",\"url\"],\"isOptional\":false}]->[]": "function wakeup(url: string | Hash | Url): void;",

package/generated/physics.d.ts

@@ -181,7 +181,7 @@ declare global {
      * end
      * `
      */
-    function get_shape(url: string | Hash | Url, shape: string | Hash): { type: number; diameter: number; dimensions: Vector3; diameter: number; height: number };
+    function get_shape(url: string | Hash | Url, shape: string | Hash): { type: number; diameter?: number; dimensions?: Vector3; height?: number };
     /**
      * Ray casts are used to test for intersections against collision objects in the physics world.
      * Collision objects of types kinematic, dynamic and static are tested against. Trigger objects
@@ -472,7 +472,7 @@ declare global {
      * end
      * `
      */
-    function set_shape(url: string | Hash | Url, shape: string | Hash, table: { type?: number; diameter?: number; dimensions?: Vector3; diameter?: number; height?: number }): void;
+    function set_shape(url: string | Hash | Url, shape: string | Hash, table: { type?: number; diameter?: number; dimensions?: Vector3; height?: number }): void;
     /**
      * Flips the collision shapes vertically for a collision object
      *

package/generated/versions/defold-1.12.4/index.d.ts

@@ -1,3 +1,5 @@
+/// <reference types="lua-types/5.1" />
+/// <reference types="lua-types/special/jit-only" />
 import "./b2d";
 import "./b2d_body";
 import "./buffer";

package/generated/versions/defold-1.12.4/physics.d.ts

@@ -183,7 +183,7 @@ declare global {
      * end
      * `
      */
-    function get_shape(url: string | Hash | Url, shape: string | Hash): { type: number; diameter: number; dimensions: Vector3; diameter: number; height: number };
+    function get_shape(url: string | Hash | Url, shape: string | Hash): { type: number; diameter?: number; dimensions?: Vector3; height?: number };
     /**
      * Ray casts are used to test for intersections against collision objects in the physics world.
      * Collision objects of types kinematic, dynamic and static are tested against. Trigger objects
@@ -474,7 +474,7 @@ declare global {
      * end
      * `
      */
-    function set_shape(url: string | Hash | Url, shape: string | Hash, table: { type?: number; diameter?: number; dimensions?: Vector3; diameter?: number; height?: number }): void;
+    function set_shape(url: string | Hash | Url, shape: string | Hash, table: { type?: number; diameter?: number; dimensions?: Vector3; height?: number }): void;
     /**
      * Flips the collision shapes vertically for a collision object
      *

package/generated/versions/defold-1.13.0/index.d.ts

@@ -1,3 +1,5 @@
+/// <reference types="lua-types/5.1" />
+/// <reference types="lua-types/special/jit-only" />
 import "./b2d";
 import "./b2d_body";
 import "./b2d_chain";

package/generated/versions/defold-1.13.0/physics.d.ts

@@ -181,7 +181,7 @@ declare global {
      * end
      * `
      */
-    function get_shape(url: string | Hash | Url, shape: string | Hash): { type: number; diameter: number; dimensions: Vector3; diameter: number; height: number };
+    function get_shape(url: string | Hash | Url, shape: string | Hash): { type: number; diameter?: number; dimensions?: Vector3; height?: number };
     /**
      * Ray casts are used to test for intersections against collision objects in the physics world.
      * Collision objects of types kinematic, dynamic and static are tested against. Trigger objects
@@ -472,7 +472,7 @@ declare global {
      * end
      * `
      */
-    function set_shape(url: string | Hash | Url, shape: string | Hash, table: { type?: number; diameter?: number; dimensions?: Vector3; diameter?: number; height?: number }): void;
+    function set_shape(url: string | Hash | Url, shape: string | Hash, table: { type?: number; diameter?: number; dimensions?: Vector3; height?: number }): void;
     /**
      * Flips the collision shapes vertically for a collision object
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defold-typescript/types",
-  "version": "0.28.3",
+  "version": "0.30.0",
   "description": "TypeScript types for the Defold engine's Lua APIs.",
   "license": "MIT",
   "repository": {

package/scripts/materialize-version.ts

@@ -2,17 +2,25 @@ import { mkdirSync, writeFileSync } from "node:fs";
 import { dirname, resolve } from "node:path";
 import {
   type ApiTarget,
+  generateBuiltinMessagesDeclaration,
   generateModuleDeclaration,
   generateVersionIndex,
   KIND_MODULE_MANIFEST,
   type KindManifestEntry,
   kindStdlibReferences,
+  loadSrcAugmentations,
   loadTargetEditorModules,
+  MESSAGES_MANIFEST,
   type ResolveTargetOptions,
   resolveTargetModules,
 } from "./regen";
 
-export { RUNTIME_KIND_MANIFEST, targetKindManifest } from "./regen";
+export { RUNTIME_KIND_MANIFEST, SRC_AUGMENTATION_MODULES, targetKindManifest } from "./regen";
+
+// The surface's own `core-types` module: a re-export of the installed package's,
+// so every declaration in the surface reaches the brand types through a
+// specifier that resolves from the surface root wherever it is written.
+export const CORE_TYPES_REEXPORT = 'export * from "@defold-typescript/types/core-types";\n';
 
 export interface RenderMaterializedKindIndexOptions {
   readonly kind: string;
@@ -64,6 +72,10 @@ export interface BuildVersionedSurfaceOptions {
   // file and its aggregate-index import. Lets a caller narrow the surface to a
   // script kind without the generator knowing what a script kind is.
   readonly excludeModules?: readonly string[];
+  // The hand-authored `src/*` augmentations to carry beside the modules.
+  // Defaults to reading them from the types package on disk; a caller with no
+  // filesystem (a Worker) supplies the bytes and gets an identical file map.
+  readonly augmentations?: readonly VersionedSurfaceFile[];
 }
 
 export interface MaterializeVersionedSurfaceOptions extends BuildVersionedSurfaceOptions {
@@ -82,6 +94,15 @@ export interface VersionedSurfaceFile {
 // the aggregate side-effect entrypoint and a minimal package.json. Pure — no
 // `node:fs` — so a Worker with no filesystem can serve a version generated at
 // request time; `materializeVersionedSurface` is the disk sink over the same map.
+// A surface is self-contained: every declaration reaches `core-types` through a
+// specifier relative to the surface root, not through the target's in-repo
+// `coreTypesImport`. An editor VM module sits one directory down and so needs
+// the deeper form.
+function surfaceCoreTypesImport(outFile: string): string {
+  const depth = outFile.split("/").length - 1;
+  return depth === 0 ? "./core-types" : `${"../".repeat(depth)}core-types`;
+}
+
 export async function buildVersionedSurfaceFiles(
   target: ApiTarget,
   opts: BuildVersionedSurfaceOptions = {},
@@ -99,15 +120,46 @@ export async function buildVersionedSurfaceFiles(
     opts.resolveOpts?.packageRoot ?? undefined,
   ).filter((entry) => kept(entry.outFile));
 
+  const augmentations = (
+    opts.augmentations ?? loadSrcAugmentations(opts.resolveOpts?.packageRoot ?? undefined)
+  ).filter((file) => kept(file.path));
+
   const files: VersionedSurfaceFile[] = [...modules, ...editorModules].map((entry) => ({
     path: entry.outFile,
-    contents: generateModuleDeclaration(entry).contents,
+    contents: generateModuleDeclaration({
+      ...entry,
+      importsFrom: surfaceCoreTypesImport(entry.outFile),
+    }).contents,
   }));
 
+  files.push(...augmentations);
+  files.push({ path: "core-types.d.ts", contents: CORE_TYPES_REEXPORT });
+
+  // A generated sibling rather than a `src/*` augmentation, so it falls outside
+  // `SRC_AUGMENTATION_MODULES` — but the carried `msg-overloads` and
+  // `message-guard` reference `BuiltinMessages`, so a surface without it ships
+  // dangling names. The emit is version-independent, so render it here.
+  const generated = [
+    {
+      path: MESSAGES_MANIFEST.outFile,
+      contents: generateBuiltinMessagesDeclaration(MESSAGES_MANIFEST, {
+        importsFrom: surfaceCoreTypesImport(MESSAGES_MANIFEST.outFile),
+      }),
+    },
+  ].filter((file) => kept(file.path));
+  files.push(...generated);
+
   // The aggregate entrypoint stays the runtime surface: importing the editor VM
-  // there would drag it into every program that pins this version.
+  // there would drag it into every program that pins this version. `core-types`
+  // is type-only and stays out of it, exactly as on the packaged path.
   const versioned = modules.map((entry) => ({ ...entry, versionId: target.id }));
-  files.push({ path: "index.d.ts", contents: generateVersionIndex(target.id, versioned) });
+  files.push({
+    path: "index.d.ts",
+    contents: generateVersionIndex(target.id, versioned, [
+      ...generated.map((file) => file.path.replace(/\.d\.ts$/, "")),
+      ...augmentations.map((file) => file.path.replace(/\.d\.ts$/, "")),
+    ]),
+  });
 
   files.push({
     path: "package.json",

package/scripts/regen.ts

@@ -10,6 +10,7 @@ import {
 } from "../src/emit-dts";
 import {
   applyMessageDeprecations,
+  type EmitBuiltinMessagesOptions,
   emitBuiltinMessages,
   parseMessagesDoc,
 } from "../src/emit-messages";
@@ -359,8 +360,11 @@ export const MESSAGES_MANIFEST: MessagesManifestEntry = {
   outFile: "builtin-messages.d.ts",
 };
 
-export function generateBuiltinMessagesDeclaration(entry: MessagesManifestEntry): string {
-  return emitBuiltinMessages(applyMessageDeprecations(parseMessagesDoc(entry.doc)));
+export function generateBuiltinMessagesDeclaration(
+  entry: MessagesManifestEntry,
+  opts: EmitBuiltinMessagesOptions = {},
+): string {
+  return emitBuiltinMessages(applyMessageDeprecations(parseMessagesDoc(entry.doc)), opts);
 }
 
 export interface GenerateResult {
@@ -551,6 +555,34 @@ const UNIVERSAL_EXTRA_IMPORTS: readonly string[] = [
   "../../src/vmath-overloads",
 ];
 
+const SRC_IMPORT_PREFIX = "../../src/";
+
+// The hand-authored `src/*` augmentations a complete script surface needs,
+// derived from the one declaration the generated kind index renders from so a
+// new augmentation reaches every materialization path with no second edit.
+export const SRC_AUGMENTATION_MODULES: readonly string[] = UNIVERSAL_EXTRA_IMPORTS.filter(
+  (specifier) => specifier.startsWith(SRC_IMPORT_PREFIX),
+).map((specifier) => specifier.slice(SRC_IMPORT_PREFIX.length));
+
+// Read those augmentations as surface-root files. Mirrors
+// `loadTargetEditorModules`: a missing file throws with its path rather than
+// filtering silently, so a renamed augmentation fails loud instead of vanishing
+// from every materialized surface.
+export function loadSrcAugmentations(
+  packageRoot: string = PACKAGE_ROOT,
+): { path: string; contents: string }[] {
+  return SRC_AUGMENTATION_MODULES.map((name) => {
+    const from = resolve(packageRoot, "src", `${name}.d.ts`);
+    let contents: string;
+    try {
+      contents = readFileSync(from, "utf8");
+    } catch {
+      throw new Error(`src augmentation "${name}" not found: ${from}`);
+    }
+    return { path: `${name}.d.ts`, contents };
+  });
+}
+
 const DEFAULT_FACTORY_MODULE = "../../src/lifecycle";
 
 export interface KindManifestEntry {
@@ -654,14 +686,23 @@ export function generateKindIndex(kind: string, target: ApiTarget = DEFAULT_TARG
 export function generateVersionIndex(
   versionId: string,
   manifest: readonly VersionedModuleManifestEntry[] = VERSIONED_MODULE_MANIFEST,
+  // Bare names appended after the module imports. A materialized surface carries
+  // the `src/*` augmentations beside its modules; the in-repo emit does not.
+  extraImports: readonly string[] = [],
 ): string {
-  const imports = manifest
-    .filter((entry) => entry.versionId === versionId && entry.editor !== true)
-    .map((entry) => entry.outFile.replace(/\.d\.ts$/, ""))
-    .sort()
+  const imports = [
+    ...manifest
+      .filter((entry) => entry.versionId === versionId && entry.editor !== true)
+      .map((entry) => entry.outFile.replace(/\.d\.ts$/, ""))
+      .sort(),
+    ...extraImports,
+  ]
     .map((module) => `import "./${module}";`)
     .join("\n");
-  return `${imports}\n\nexport {};\n`;
+  // A pinned consumer names this surface in `types` and never loads the
+  // package entrypoint, so the stdlib directives have to lead here too. A
+  // runtime surface is LuaJIT, so it takes both lines.
+  return `${LUA_STDLIB_REFERENCES}${imports}\n\nexport {};\n`;
 }
 
 // The `src/`-relative prefix a kind index living in `<generatedDir>/kinds/` needs

package/src/emit-dts.ts

@@ -392,6 +392,21 @@ const B2D_CAST_HIT_FIELDS: readonly TableField[] = [
   { name: "fraction", types: ["number"] },
 ];
 
+// The physics shape record, shared by `physics.get_shape`'s return and
+// `physics.set_shape`'s cross-referencing `table` param. The ref-doc describes
+// it as one `<dl>` for the common `type` field followed by one `<dl>` per shape
+// kind (sphere: `diameter`; box: `dimensions`; capsule: `diameter` + `height`),
+// which parseTableFields flattens into a single list — emitting `diameter`
+// twice. Field order is the doc's first-occurrence order, and every
+// kind-specific field is optional because only one kind's fields are present
+// per value.
+const PHYSICS_SHAPE_TABLE_FIELDS: readonly TableField[] = [
+  { name: "type", types: ["number"] },
+  { name: "diameter", types: ["number"], optional: true },
+  { name: "dimensions", types: ["vector3"], optional: true },
+  { name: "height", types: ["number"], optional: true },
+];
+
 export const TABLE_SLOT_CURATIONS: ReadonlyMap<string, TableSlotCuration> = new Map([
   ["collectionfactory.create:return:ids", { kind: "mapping", key: "hash", value: "hash" }],
   // font.get_info's `info` return is a `<dl>` with `path: hash` and a nested
@@ -1045,6 +1060,8 @@ export const TABLE_SLOT_CURATIONS: ReadonlyMap<string, TableSlotCuration> = new
   ["b2d.world.cast_mover:param:filter", { kind: "object", fields: B2D_MOVER_FILTER_FIELDS }],
   ["b2d.world.collide_mover:param:capsule", { kind: "object", fields: B2D_CAPSULE_FIELDS }],
   ["b2d.world.collide_mover:param:filter", { kind: "object", fields: B2D_MOVER_FILTER_FIELDS }],
+  ["physics.get_shape:return:table", { kind: "object", fields: PHYSICS_SHAPE_TABLE_FIELDS }],
+  ["physics.set_shape:param:table", { kind: "object", fields: PHYSICS_SHAPE_TABLE_FIELDS }],
 ]);
 
 // Slot-keyed (`element:param:name`, mirroring TABLE_SLOT_CURATIONS) replacements

package/src/emit-messages.ts

@@ -140,7 +140,17 @@ function parsePayload(raw: unknown): MessageField[] {
   return fields;
 }
 
-export function emitBuiltinMessages(catalog: MessageCatalog): string {
+export interface EmitBuiltinMessagesOptions {
+  // Where the brand types are reached from. Defaults to the committed
+  // `generated/` emit's sibling-relative path; a materialized surface has no
+  // `src/` above it and supplies its own surface-root specifier.
+  readonly importsFrom?: string;
+}
+
+export function emitBuiltinMessages(
+  catalog: MessageCatalog,
+  opts: EmitBuiltinMessagesOptions = {},
+): string {
   const entries = [...catalog.entries].sort((a, b) => a.name.localeCompare(b.name));
   const body = entries.map(emitEntry).join("\n");
   const inner = [
@@ -155,8 +165,9 @@ export function emitBuiltinMessages(catalog: MessageCatalog): string {
     "",
   ].join("\n");
   const used = collectEngineTypes(inner);
+  const importsFrom = opts.importsFrom ?? "../src/core-types";
   const importLine =
-    used.length === 0 ? "" : `import type { ${used.join(", ")} } from "../src/core-types";\n\n`;
+    used.length === 0 ? "" : `import type { ${used.join(", ")} } from "${importsFrom}";\n\n`;
   return `${importLine}${inner}`;
 }