@series-inc/rundot-syncplay 5.26.0-beta.1 → 5.26.0-beta.3

package/README.md

@@ -23,6 +23,23 @@ late join, secrets, and transport.
 | Inputs, prediction, confirmation, rollback policy, replay log, late join, secrets, transport | Syncplay |
 | Rendering/interpolation/effects | Presentation adapters outside authoritative state |
 
+## External monorepos
+
+Pin an **exact** published version. Fold that version string into
+`deterministicVersion` when deriving a custom runtime identity, so a silent
+dependency float cannot keep the same engine hash.
+
+| Subpath | Role |
+|---------|------|
+| `/core/runtime` | `createInstalledRuntimeAdapter`, identity helpers |
+| `/core/physics` | WASM physics (`initPhysics`, …) — reference solver |
+| `/` or `/browser` | KCC, runner, session, **TypeScript** physics — the solver `stepDeterministicKcc3D` collides against |
+| `/testing` | Simulated multi-peer / synctest |
+| `/node` | Authority room helpers (not for browser bundles) |
+
+Do not deep-import `@series-inc/rundot-syncplay/core/src/**`. Do not put a
+non-deterministic third-party engine inside a checksummed step.
+
 There is one session factory:
 
 ```ts

package/core/authoring.d.ts

@@ -1,4 +1,8 @@
-export type KinetixInstalledProfileName = 'deterministic-f64' | 'fixed-1000-3d';
+// Types-only entrypoint. The declarative `defineKinetixProject` lane it used to
+// carry was removed with the engine-owned numeric profiles it validated; games
+// build simulations with `createInstalledRuntimeAdapter` +
+// `deriveCustomRuntimeIdentity` instead. Session-config schema types stay here
+// because game runtimes declare their match configuration with them.
 
 export type KinetixSessionField =
   | { type: 'string'; maxBytes: number; required?: boolean }
@@ -12,19 +16,3 @@ export interface KinetixSessionConfigSchema {
   maxBytes: number;
   fields: Readonly<Record<string, KinetixSessionField>>;
 }
-
-export interface KinetixProjectDeclaration {
-  id: string;
-  installedProfile: KinetixInstalledProfileName;
-  tickRate: 10 | 20 | 30 | 60;
-  inputSchema: Readonly<Record<string, unknown>>;
-  sessionConfigSchema: KinetixSessionConfigSchema;
-  mechanics: readonly Readonly<Record<string, unknown>>[];
-  components: readonly Readonly<Record<string, unknown>>[];
-  systems: readonly Readonly<Record<string, unknown>>[];
-  presentationBindings: readonly Readonly<Record<string, unknown>>[];
-}
-
-export function defineKinetixProject<const Project extends KinetixProjectDeclaration>(
-  project: Project,
-): Readonly<Project>;

package/core/deterministic-stdlib.d.ts

@@ -84,19 +84,6 @@ export interface DeterministicMathApi {
   clamp(value: number, min: number, max: number): number;
 }
 
-export interface FixedTurnsMathApi {
-  readonly ONE: number;
-  F(value: number): number;
-  mul(a: number, b: number): number;
-  div(a: number, b: number): number;
-  clamp(value: number, min: number, max: number): number;
-  fabs(value: number): number;
-  fsign(value: number): number;
-  lerp(a: number, b: number, t: number): number;
-  fsin(turns: number): number;
-  fcos(turns: number): number;
-}
-
 export interface DeterministicRandomSnapshot {
   readonly state: number;
 }
@@ -107,8 +94,6 @@ export function createDeterministicMath(
   maxFixed?: number,
 ): DeterministicMathApi;
 
-export function createFixedTurnsMath(scale: number): FixedTurnsMathApi;
-
 export class DeterministicRandom {
   state: number;
   constructor(seed: number);

package/core/index.d.ts

@@ -80,11 +80,9 @@ export type {
   KinetixPlatformerLevelErrorCode,
   KinetixRuntimeModuleManifestEntry,
 } from './runtime';
-export { defineKinetixProject } from './authoring';
-export type { KinetixProjectDeclaration, KinetixSessionConfigSchema } from './authoring';
+export type { KinetixSessionConfigSchema } from './authoring';
 export {
   createDeterministicMath,
-  createFixedTurnsMath,
   DeterministicRandom,
 } from './deterministic-stdlib';
 export {
@@ -145,15 +143,11 @@ export type {
   DeterministicRandomSnapshot,
   DeterministicVec2,
   DeterministicVec3,
-  FixedTurnsMathApi,
 } from './deterministic-stdlib';
 
-export type KinetixTargetProfile = 'deterministic-f64' | 'fixed-1000-3d';
-
 export interface KinetixCompileInput {
   projectRoot: string;
   expectedCommit: string;
-  targetProfile: KinetixTargetProfile;
 }
 
 export interface KinetixDiagnostic {
@@ -180,7 +174,7 @@ export interface KinetixCompiled {
 
 export interface KinetixRuntimeContract {
   readonly tickRate: 10 | 20 | 30 | 60;
-  readonly targetProfile: KinetixTargetProfile;
+  readonly targetProfile: string;
   readonly numericProfile: string;
   readonly deterministicAbi: string;
   readonly deterministicVersion: string;
@@ -263,7 +257,6 @@ export function compileKinetixProject(input: KinetixCompileInput): KinetixCompil
 export function compileTrustedKinetixSource(input: {
   sourceRoot: string;
   expectedCommit: string;
-  targetProfile: KinetixTargetProfile;
   classifyInstalledBranches?: boolean;
 }): KinetixCompiled;
 export function kinetixCanonicalSourceDigest(sourceRoot: string): string;
@@ -274,27 +267,6 @@ export function bakeKinetixEnvelope(
 ): KinetixBakeResult;
 export type KinetixRuntimeModuleDeclaration = import('./runtime').KinetixRuntimeModuleManifestEntry;
 
-export interface KinetixBakeOptions {
-  /**
-   * Canonical manifest of the installed runtime's implementation modules,
-   * sorted by path. Folded into the simulation payload (and so into
-   * engineIdentityHash), binding the custom step implementation to the signed
-   * product. Build with kinetixRuntimeModuleManifest.
-   */
-  runtimeModules?: readonly KinetixRuntimeModuleDeclaration[];
-  /** Emitted as manifest.auxiliaryAssets; bound into engineIdentityHash when non-empty. */
-  auxiliaryAssets?: readonly { name: string; digest: string; byteLength: number }[];
-}
-
-export function bakeKinetixProjectDefinition(
-  project: import('./authoring').KinetixProjectDeclaration,
-  options?: KinetixBakeOptions,
-): {
-  products: KinetixProducts;
-  runtimeIdentity: import('./runtime').KinetixRuntimeIdentity;
-  contentDigest: string;
-};
-
 /** Node-only build-time helper: hashes module files into a sorted canonical manifest. */
 export function kinetixRuntimeModuleManifest(
   sourceRoot: string,
@@ -351,8 +323,8 @@ export interface CustomRuntimeIdentityOptions {
  * folding its `runtimeModules` manifest (and optional `auxiliaryAssets` /
  * `sessionConfigSchema` / `deterministicAbi`) into `engineIdentityHash` the same
  * canonical way `deriveKinetixRuntimeIdentity` does. The supported path for
- * custom `createInstalledRuntimeAdapter` runtimes, which cannot go through the
- * profile-locked `defineKinetixProject` baker.
+ * custom `createInstalledRuntimeAdapter` runtimes. It replaces the removed
+ * profile-locked declarative baker.
  */
 export function deriveCustomRuntimeIdentity(
   options: CustomRuntimeIdentityOptions,
@@ -383,7 +355,6 @@ export function compileStableKinetixProducts(input: KinetixCompileInput): Kineti
 export function compileStableKinetixProductsFromTrustedSource(input: {
   sourceRoot: string;
   expectedCommit: string;
-  targetProfile: KinetixTargetProfile;
 }): KinetixCompilation;
 
 /** Builds the portable C++ core and returns the binary path. */

package/core/native/deterministic_math.hpp

@@ -1,8 +1,9 @@
 // Deterministic-f64 math for the component runtime: C++ transliteration of the
 // fdlibm-style JS shim (kinetix-deterministic-math.mjs). Every function must be
-// bit-identical to the JS implementation for all finite inputs — verified by the
-// parity battery (deterministic-f64-battery.mjs vs
-// deterministic-math-battery-main.cpp).
+// bit-identical to the JS implementation — gated by
+// core/tests/js-cpp-parity.test.mjs against the --math-vectors mode in
+// core/native/kinetix-native-main.cpp. NaN is compared canonically; its payload
+// is architecture-defined.
 //
 // Compile with FMA contraction disabled (-ffp-contract=off): the algorithms
 // depend on exact IEEE double rounding of each written operation.