@series-inc/rundot-kinetix 0.0.0-bootstrap.0

package/src/index.mjs

@@ -0,0 +1,57 @@
+// Public surface of the Kinetix core. Consumers that want a single module can
+// import from here; the granular subpath exports in package.json stay available
+// for callers that would rather not pull the compiler (and with it TypeScript)
+// into a runtime-only process.
+export { compileKinetixProject, compileTrustedKinetixSource } from './kinetix-project-compiler.mjs';
+export { kinetixCanonicalSourceDigest } from './kinetix-source-snapshot.mjs';
+export {
+  bakeKinetixEnvelope,
+  bakeKinetixProjectDefinition,
+  kinetixBakerVersion,
+  kinetixPhases,
+  scanKinetixPayloadTree,
+  stableKinetixProductBytes,
+  stableKinetixSourceBytes,
+  validateInstalledKinetixProfile,
+} from './kinetix-baker.mjs';
+export { defineKinetixProject } from './kinetix-authoring.mjs';
+export { createKinetixWorld } from './kinetix-world-kernel.mjs';
+export { createKinetixWorldRuntime } from './kinetix-world-runtime.mjs';
+export { createInstalledF64Runtime } from './kinetix-installed-f64-runtime-adapter.mjs';
+export { createInstalledSurvivalRuntime } from './kinetix-survival-runtime-adapter.mjs';
+export { createFixed1000Runtime } from './kinetix-fixed1000-runtime-adapter.mjs';
+export {
+  decodeKinetixSessionConfig,
+  encodeKinetixSessionConfig,
+  kinetixSessionConfigDigest,
+} from './kinetix-session-config.mjs';
+export {
+  createInstalledKinetixProfile,
+  kinetixRuntimeContractForProfile,
+} from './kinetix-installed-systems.mjs';
+export { createKinetixRenderProjection } from './kinetix-render-projection.mjs';
+export {
+  compileStableKinetixProducts,
+  compileStableKinetixProductsFromTrustedSource,
+  nativeFixed1000ProductBytes,
+} from './kinetix-native-product.mjs';
+export {
+  canonicalFixedStateBytes,
+  canonicalFixedTickHash,
+  createFixedRuntime,
+  tickFixedRuntime,
+} from './kinetix-fixed1000-runtime.mjs';
+export { canonicalF64TickHash, runF64Replay } from './kinetix-installed-f64-reference.mjs';
+export { buildNative } from '../scripts/build-native.mjs';
+export {
+  assertKinetixProductContract,
+  assertKinetixRuntimeContract,
+  assertKinetixRuntimeIdentityMatchesProducts,
+  deriveKinetixRuntimeIdentity,
+  kinetixProductKinds,
+} from './kinetix-product-contract.mjs';
+export {
+  assertKinetixRuntime,
+  assertKinetixRuntimeIdentity,
+  kinetixRuntimeAbiVersion,
+} from './kinetix-runtime-contract.mjs';

package/src/kinetix-authoring.mjs

@@ -0,0 +1,69 @@
+import { normalizeKinetixSessionConfigSchema } from './kinetix-session-config.mjs';
+
+const projectKeys = new Set([
+  'id',
+  'installedProfile',
+  'tickRate',
+  'inputSchema',
+  'sessionConfigSchema',
+  'mechanics',
+  'components',
+  'systems',
+  'presentationBindings',
+]);
+
+function fail(code) {
+  throw new Error(code);
+}
+
+function isPlainObject(value) {
+  return typeof value === 'object' && value !== null && !Array.isArray(value)
+    && Object.getPrototypeOf(value) === Object.prototype;
+}
+
+function canonicalData(value) {
+  if (Array.isArray(value)) return value.map(canonicalData);
+  if (isPlainObject(value)) {
+    return Object.fromEntries(Object.keys(value).sort().map((key) => [key, canonicalData(value[key])]));
+  }
+  if (value === null || typeof value === 'string' || typeof value === 'boolean'
+    || (typeof value === 'number' && Number.isFinite(value) && Number.isSafeInteger(value))) {
+    return value;
+  }
+  fail('KINETIX_AUTHORING_VALUE_INVALID');
+}
+
+function deepFreeze(value) {
+  if (value && typeof value === 'object') {
+    Object.freeze(value);
+    Object.values(value).forEach(deepFreeze);
+  }
+  return value;
+}
+
+export function defineKinetixProject(input) {
+  if (!isPlainObject(input)) fail('KINETIX_AUTHORING_INVALID');
+  if (Object.keys(input).some((key) => !projectKeys.has(key))) fail('KINETIX_AUTHORING_FIELD_UNKNOWN');
+  if (typeof input.id !== 'string' || input.id.length === 0
+    || !['deterministic-f64', 'fixed-1000-3d'].includes(input.installedProfile)
+    || ![10, 20, 30, 60].includes(input.tickRate)
+    || !isPlainObject(input.inputSchema)
+    || !Array.isArray(input.mechanics)
+    || !Array.isArray(input.components)
+    || !Array.isArray(input.systems)
+    || !Array.isArray(input.presentationBindings)) {
+    fail('KINETIX_AUTHORING_INVALID');
+  }
+  const project = canonicalData({
+    id: input.id,
+    installedProfile: input.installedProfile,
+    tickRate: input.tickRate,
+    inputSchema: input.inputSchema,
+    sessionConfigSchema: normalizeKinetixSessionConfigSchema(input.sessionConfigSchema),
+    mechanics: input.mechanics,
+    components: input.components,
+    systems: input.systems,
+    presentationBindings: input.presentationBindings,
+  });
+  return deepFreeze(project);
+}