bradleyshep · Sep 8, 2026 · Sep 9, 2026 · Sep 9, 2026 · Sep 17, 2026 · Sep 17, 2026
@@ -2402,3 +2402,37 @@ jobs:
       # - name: Print rows in the user table
       #   if: always()
       #   run: spacetime sql quickstart-chat "SELECT * FROM user"
+
+  typescript-submodules:
+    needs: [merge_queue_noop, upload-build-artifacts-linux]
+    if: ${{ needs.merge_queue_noop.outputs.skip != 'true' }}
+    name: TypeScript - Submodules
+    runs-on: spacetimedb-new-runner-2
+    env:
+      ARTIFACT_SUFFIX: linux
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - uses: ./.github/actions/setup-pnpm
+        with:
+          run_install: true
+
+      - name: Install Rust toolchain
+        uses: dsherret/rust-toolchain-file@v1
+      - name: Set default rust toolchain
+        run: rustup default $(rustup show active-toolchain | cut -d' ' -f1)
+
+      - *set-cargo-target-dir
+      - *download-build-artifacts
+      - *extract-build-artifacts
+
+      - *expose-spacetime-cli
+
+      - name: Check TypeScript submodules
+        run: cargo ci typescript-submodules
diff --git a/.gitignore b/.gitignore
@@ -205,6 +205,14 @@ __pycache__/
 ## JetBrains
 .idea/
 
+# TypeScript submodule development outputs
+spacetime-*-ts/example/.stdb-server-token
+spacetime-*-ts/example/public/app.js
+spacetime-*-ts/example/public/app.js.map
+spacetime-*-ts/example/public/app.css
+spacetime-*-ts/example/public/app.css.map
+spacetime-*-ts/ts-codegen/
+
 /protobuf
 cs-src/
 crates/bench/spacetime.svg

diff --git a/.prettierignore b/.prettierignore
@@ -4,4 +4,9 @@ dist
 target
 .github
 coverage
+**/public/app.js
+**/public/app.js.map
+**/public/app.css
+**/public/app.css.map
+**/src/module_bindings/**
 crates/bindings-typescript/src/server/test-utils/portable-datastore-wasm
diff --git a/Cargo.lock b/Cargo.lock
diff --git a/Cargo.toml b/Cargo.toml
@@ -87,6 +87,7 @@ members = [
   "tools/ci/commands/publish-checks",
   "tools/ci/commands/run-spacetime",
   "tools/ci/commands/typescript-test",
+  "tools/ci/commands/typescript-submodules",
   "tools/ci/commands/version-upgrade-check",
   "tools/ci/commands/docs",
   "tools/ci/commands/codeowners-check",

diff --git a/crates/bindings-typescript/src/lib/type_builders.ts b/crates/bindings-typescript/src/lib/type_builders.ts
@@ -1762,6 +1762,9 @@ class SimpleSumBuilderImpl<Variants extends SimpleVariantsObj>
   }
 }
 
+// Named so declaration files can refer to enum and unit builder instances.
+export type { SumBuilderImpl, SimpleSumBuilderImpl, UnitBuilder };
+
 export const SimpleSumBuilder: {
   new <Variants extends SimpleVariantsObj>(
     variants: Variants,

diff --git a/crates/bindings-typescript/src/server/index.ts b/crates/bindings-typescript/src/server/index.ts
@@ -38,4 +38,13 @@ export { ScheduleAt } from '../lib/schedule_at';
 
 export type { Environment } from './environment';
 
+// Named so libraries built on this package can emit declaration files for
+// the tables, schemas, and exports they create.
+export type { CoerceRow } from '../lib/table';
+export type { TableSchema } from '../lib/table_schema';
+export type { TablesToSchema } from '../lib/schema';
+export type { EnvironmentValue } from '../lib/environment';
+export type { ReadonlyDbView } from './db_view';
+export type { Schema } from './schema';
+
 import './polyfills'; // Ensure polyfills are loaded
diff --git a/eslint.config.js b/eslint.config.js
@@ -20,6 +20,9 @@ export default tseslint.config(
       '**/dist/**',
       '**/build/**',
       '**/coverage/**',
+      '**/public/app.js',
+      '**/src/module_bindings/**',
+      '**/ts-codegen/**',
       '**/templates/angular-ts/.angular/**',
       '**/src/server/test-utils/portable-datastore-wasm/**',
     ],
@@ -63,6 +66,7 @@ export default tseslint.config(
           './tsconfig.json',
           './crates/bindings-typescript/tsconfig.json',
           './crates/bindings-typescript/test-app/tsconfig.json',
+          './spacetime-example-ui-ts/tsconfig.json',
           './templates/react-ts/tsconfig.json',
           './templates/chat-react-ts/tsconfig.json',
           './templates/money-exchange-react-ts/tsconfig.json',
@@ -119,6 +123,19 @@ export default tseslint.config(
       ],
     },
   },
+  {
+    files: ['spacetime-*-ts/**/example/public/ui.js'],
+    languageOptions: {
+      sourceType: 'script',
+      globals: globals.browser,
+    },
+  },
+  {
+    files: ['spacetime-*-ts/**/*.{ts,tsx}'],
+    rules: {
+      '@typescript-eslint/no-explicit-any': 'error',
+    },
+  },
   {
     files: ['templates/angular-ts/src/**/*.ts'],
     rules: {

diff --git a/package.json b/package.json
@@ -7,7 +7,7 @@
   },
   "type": "module",
   "scripts": {
-    "run-all": "pnpm -r -F ./crates/bindings-typescript -F ./crates/bindings-typescript/examples/quickstart-chat -F ./crates/bindings-typescript/test-app -F ./docs -F \"./templates/**\" run",
+    "run-all": "pnpm -r -F ./crates/bindings-typescript -F ./crates/bindings-typescript/test-app -F ./docs -F \"./templates/**\" -F \"./spacetime-*-ts/**\" run",
     "format": "pnpm run-all format && prettier eslint.config.js --write",
     "lint": "pnpm run-all lint && prettier eslint.config.js --check",
     "build": "pnpm run-all build",