@replicast/core 1.0.0-rc.1 → 1.0.0-rc.10

package/dist/decorators/entity.d.ts

@@ -0,0 +1,43 @@
+import type { EntityWorldView } from '../entity/types.js';
+/** Client lifecycle / server scheduler hooks an entity method can carry. */
+export type EntityHook = 'serverTick' | 'clientSpawn' | 'clientDespawn';
+/** Who may invoke an entity's `@Server` methods: its owner, anyone, or a custom predicate. */
+export type CanCall<T> = 'owner' | 'anyone' | ((callerId: string, entity: T, world: EntityWorldView) => boolean);
+export interface EntityOptions<T = any> {
+    /** Wire name for this type. Defaults to the class name (or the Vite plugin's `__replicastName` stamp). */
+    name?: string;
+    /** Scopes replication. Return false to hide the entity from that viewer. Default: visible to everyone. */
+    visibleTo?: (viewerId: string, entity: T, world: EntityWorldView) => boolean;
+    /** Authorisation for `@Server` methods on this entity. Default: `'owner'`. */
+    canCall?: CanCall<T>;
+}
+/**
+ * Registers a class as a replicated entity type. One class per entity type, written once and run on
+ * both sides; the field and method decorators below say which parts travel where.
+ */
+export declare function Entity<T extends object = object>(options?: EntityOptions<T>): (_value: abstract new (...args: any[]) => T, context: ClassDecoratorContext) => void;
+/** Replicated to every client that can see the entity; diffed per flush. */
+export declare function Replicated(_value: undefined, context: ClassFieldDecoratorContext): void;
+/** Replicated only to the client identified by `entity.ownerId`. */
+export declare function OwnerReplicated(_value: undefined, context: ClassFieldDecoratorContext): void;
+/**
+ * Rounds a numeric field to `step` on the server before diffing, so float noise does not produce
+ * updates. A pure modifier: combine with `@Replicated` / `@OwnerReplicated` to actually replicate.
+ */
+export declare function Quantized(step: number): (_value: undefined, context: ClassFieldDecoratorContext) => void;
+/** Runs on the server each sim tick with `dt` (seconds). Absent from the client bundle. */
+export declare function ServerTick(_value: Function, context: ClassMethodDecoratorContext): void;
+/** Runs on the client when the entity enters this viewer's set, after its fields are assigned. */
+export declare function ClientSpawn(_value: Function, context: ClassMethodDecoratorContext): void;
+/** Runs on the client when the entity leaves this viewer's set, before it is dropped. */
+export declare function ClientDespawn(_value: Function, context: ClassMethodDecoratorContext): void;
+export declare function isEntityClass(cls: Function): boolean;
+export declare function getEntityOptions<T = any>(cls: Function): EntityOptions<T> | undefined;
+/**
+ * Wire name for an entity type. Read lazily so the Vite plugin's `static __replicastName` stamp wins
+ * over `cls.name`, which bundlers and minifiers may rename.
+ */
+export declare function getEntityName(cls: Function): string;
+export declare function getQuantizedFields(proto: object): Record<string, number>;
+export declare function getEntityHooks(proto: object): Record<string, EntityHook>;
+//# sourceMappingURL=entity.d.ts.map

package/dist/decorators/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../src/decorators/entity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAMzD,4EAA4E;AAC5E,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,aAAa,GAAG,eAAe,CAAA;AAEvE,8FAA8F;AAC9F,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,OAAO,GAAG,QAAQ,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,CAAA;AAEhH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,GAAG;IACpC,0GAA0G;IAC1G,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0GAA0G;IAC1G,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,eAAe,KAAK,OAAO,CAAA;IAC5E,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;CACrB;AAMD;;;GAGG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,OAAO,GAAE,aAAa,CAAC,CAAC,CAAM,IAC7D,QAAQ,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,SAAS,qBAAqB,KAAG,IAAI,CAGnG;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAEvF;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAE5F;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,IACnB,QAAQ,SAAS,EAAE,SAAS,0BAA0B,KAAG,IAAI,CAK/E;AAQD,2FAA2F;AAC3F,wBAAgB,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,2BAA2B,GAAG,IAAI,CAEvF;AAED,kGAAkG;AAClG,wBAAgB,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,2BAA2B,GAAG,IAAI,CAExF;AAED,yFAAyF;AACzF,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,2BAA2B,GAAG,IAAI,CAE1F;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAEpD;AAED,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,QAAQ,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,CAErF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAInD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAExE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAExE"}

package/dist/decorators/entity.js

@@ -0,0 +1,75 @@
+import { setPropertyRole } from './metadata.js';
+const entityOptionsKey = Symbol.for('replicast:entityOptions');
+const quantizedFieldsKey = Symbol.for('replicast:quantizedFields');
+const entityHooksKey = Symbol.for('replicast:entityHooks');
+function meta(cls) {
+    return cls[Symbol.metadata];
+}
+/**
+ * Registers a class as a replicated entity type. One class per entity type, written once and run on
+ * both sides; the field and method decorators below say which parts travel where.
+ */
+export function Entity(options = {}) {
+    return function (_value, context) {
+        ;
+        context.metadata[entityOptionsKey] = options;
+    };
+}
+/** Replicated to every client that can see the entity; diffed per flush. */
+export function Replicated(_value, context) {
+    setPropertyRole(context.metadata, String(context.name), 'replicated');
+}
+/** Replicated only to the client identified by `entity.ownerId`. */
+export function OwnerReplicated(_value, context) {
+    setPropertyRole(context.metadata, String(context.name), 'ownerReplicated');
+}
+/**
+ * Rounds a numeric field to `step` on the server before diffing, so float noise does not produce
+ * updates. A pure modifier: combine with `@Replicated` / `@OwnerReplicated` to actually replicate.
+ */
+export function Quantized(step) {
+    return function (_value, context) {
+        const m = context.metadata;
+        const existing = m[quantizedFieldsKey] ?? {};
+        m[quantizedFieldsKey] = { ...existing, [String(context.name)]: step };
+    };
+}
+function setHook(context, hook) {
+    const m = context.metadata;
+    const existing = m[entityHooksKey] ?? {};
+    m[entityHooksKey] = { ...existing, [String(context.name)]: hook };
+}
+/** Runs on the server each sim tick with `dt` (seconds). Absent from the client bundle. */
+export function ServerTick(_value, context) {
+    setHook(context, 'serverTick');
+}
+/** Runs on the client when the entity enters this viewer's set, after its fields are assigned. */
+export function ClientSpawn(_value, context) {
+    setHook(context, 'clientSpawn');
+}
+/** Runs on the client when the entity leaves this viewer's set, before it is dropped. */
+export function ClientDespawn(_value, context) {
+    setHook(context, 'clientDespawn');
+}
+export function isEntityClass(cls) {
+    return meta(cls)?.[entityOptionsKey] !== undefined;
+}
+export function getEntityOptions(cls) {
+    return meta(cls)?.[entityOptionsKey];
+}
+/**
+ * Wire name for an entity type. Read lazily so the Vite plugin's `static __replicastName` stamp wins
+ * over `cls.name`, which bundlers and minifiers may rename.
+ */
+export function getEntityName(cls) {
+    return cls.__replicastName
+        ?? getEntityOptions(cls)?.name
+        ?? cls.name;
+}
+export function getQuantizedFields(proto) {
+    return meta(proto.constructor)?.[quantizedFieldsKey] ?? {};
+}
+export function getEntityHooks(proto) {
+    return meta(proto.constructor)?.[entityHooksKey] ?? {};
+}
+//# sourceMappingURL=entity.js.map

package/dist/decorators/entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../src/decorators/entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAG/C,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAA;AAC9D,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAA;AAClE,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAA;AAiB1D,SAAS,IAAI,CAAC,GAAa;IACzB,OAAQ,GAAW,CAAC,MAAM,CAAC,QAAQ,CAAwC,CAAA;AAC7E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM,CAA4B,UAA4B,EAAE;IAC9E,OAAO,UAAU,MAA0C,EAAE,OAA8B;QACzF,CAAC;QAAC,OAAO,CAAC,QAAoC,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAA;IAC5E,CAAC,CAAA;AACH,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,UAAU,CAAC,MAAiB,EAAE,OAAmC;IAC/E,eAAe,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,CAAA;AACvE,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,eAAe,CAAC,MAAiB,EAAE,OAAmC;IACpF,eAAe,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAC,CAAA;AAC5E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,UAAU,MAAiB,EAAE,OAAmC;QACrE,MAAM,CAAC,GAAG,OAAO,CAAC,QAAmC,CAAA;QACrD,MAAM,QAAQ,GAAI,CAAC,CAAC,kBAAkB,CAA4B,IAAI,EAAE,CAAA;QACxE,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAA;IACvE,CAAC,CAAA;AACH,CAAC;AAED,SAAS,OAAO,CAAC,OAAoC,EAAE,IAAgB;IACrE,MAAM,CAAC,GAAG,OAAO,CAAC,QAAmC,CAAA;IACrD,MAAM,QAAQ,GAAI,CAAC,CAAC,cAAc,CAAgC,IAAI,EAAE,CAAA;IACxE,CAAC,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAA;AACnE,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,UAAU,CAAC,MAAgB,EAAE,OAAoC;IAC/E,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,CAAA;AAChC,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,WAAW,CAAC,MAAgB,EAAE,OAAoC;IAChF,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC,CAAA;AACjC,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,aAAa,CAAC,MAAgB,EAAE,OAAoC;IAClF,OAAO,CAAC,OAAO,EAAE,eAAe,CAAC,CAAA;AACnC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAa;IACzC,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,gBAAgB,CAAC,KAAK,SAAS,CAAA;AACpD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAU,GAAa;IACrD,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,gBAAgB,CAAiC,CAAA;AACtE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAa;IACzC,OAAQ,GAAoC,CAAC,eAAe;WACvD,gBAAgB,CAAC,GAAG,CAAC,EAAE,IAAI;WAC3B,GAAG,CAAC,IAAI,CAAA;AACf,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAQ,IAAI,CAAE,KAAa,CAAC,WAAW,CAAC,EAAE,CAAC,kBAAkB,CAA4B,IAAI,EAAE,CAAA;AACjG,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAQ,IAAI,CAAE,KAAa,CAAC,WAAW,CAAC,EAAE,CAAC,cAAc,CAAgC,IAAI,EAAE,CAAA;AACjG,CAAC"}

package/dist/decorators/index.d.ts

@@ -1,5 +1,7 @@
 export { GlobalStore, OwnerStore, Global, OwnerOnly, ServerOnly } from './store.js';
 export { System, Server, Client, Multicast, isSystemKey, isServerClassKey, isClientClassKey } from './system.js';
+export { Entity, Replicated, OwnerReplicated, Quantized, ServerTick, ClientSpawn, ClientDespawn, isEntityClass, getEntityName, getEntityOptions, getEntityHooks, getQuantizedFields, } from './entity.js';
+export type { EntityOptions, EntityHook, CanCall } from './entity.js';
 export { getStoreType, getPropertyRoles, getMethodRoles } from './metadata.js';
 export type { StoreType, PropertyRole, MethodRole } from './metadata.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/decorators/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAChH,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9E,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAChH,OAAO,EACL,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EACtF,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAE,kBAAkB,GACnF,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AACrE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9E,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA"}

package/dist/decorators/index.js

@@ -1,4 +1,5 @@
 export { GlobalStore, OwnerStore, Global, OwnerOnly, ServerOnly } from './store.js';
 export { System, Server, Client, Multicast, isSystemKey, isServerClassKey, isClientClassKey } from './system.js';
+export { Entity, Replicated, OwnerReplicated, Quantized, ServerTick, ClientSpawn, ClientDespawn, isEntityClass, getEntityName, getEntityOptions, getEntityHooks, getQuantizedFields, } from './entity.js';
 export { getStoreType, getPropertyRoles, getMethodRoles } from './metadata.js';
 //# sourceMappingURL=index.js.map

package/dist/decorators/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAChH,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAChH,OAAO,EACL,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EACtF,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAE,kBAAkB,GACnF,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA"}

package/dist/decorators/metadata.d.ts

@@ -2,7 +2,11 @@ export declare const storeTypeKey: unique symbol;
 export declare const propertyRolesKey: unique symbol;
 export declare const methodRolesKey: unique symbol;
 export type StoreType = 'global' | 'owner';
-export type PropertyRole = 'global' | 'ownerOnly' | 'serverOnly';
+/**
+ * Where a decorated field is allowed to travel. `global` / `ownerOnly` are store roles;
+ * `replicated` / `ownerReplicated` are the entity equivalents. `serverOnly` is shared by both.
+ */
+export type PropertyRole = 'global' | 'ownerOnly' | 'serverOnly' | 'replicated' | 'ownerReplicated';
 export type MethodRole = 'server' | 'client' | 'multicast';
 export declare function getStoreType(cls: Function): StoreType | undefined;
 export declare function setStoreType(metadata: DecoratorMetadata, type: StoreType): void;

package/dist/decorators/metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/decorators/metadata.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,eAAgC,CAAA;AACzD,eAAO,MAAM,gBAAgB,eAAoC,CAAA;AACjE,eAAO,MAAM,cAAc,eAAkC,CAAA;AAE7D,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAA;AAC1C,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,WAAW,GAAG,YAAY,CAAA;AAChE,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAA;AAE1D,wBAAgB,YAAY,CAAC,GAAG,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAGjE;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAE/E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAG5E;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAIlG;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAGxE;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAI9F"}
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/decorators/metadata.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,eAAgC,CAAA;AACzD,eAAO,MAAM,gBAAgB,eAAoC,CAAA;AACjE,eAAO,MAAM,cAAc,eAAkC,CAAA;AAE7D,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAA;AAC1C;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,WAAW,GAAG,YAAY,GAAG,YAAY,GAAG,iBAAiB,CAAA;AACnG,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAA;AAE1D,wBAAgB,YAAY,CAAC,GAAG,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAGjE;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAE/E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAG5E;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAIlG;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAGxE;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAI9F"}

package/dist/decorators/metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/decorators/metadata.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,CAAC;AAAC,MAAc,CAAC,QAAQ,KAAK,MAAM,CAAC,iBAAiB,CAAC,CAAA;AAEvD,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAA;AACzD,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAA;AACjE,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAA;AAM7D,MAAM,UAAU,YAAY,CAAC,GAAa;IACxC,MAAM,IAAI,GAAI,GAAW,CAAC,MAAM,CAAC,QAAQ,CAA+C,CAAA;IACxF,OAAO,IAAI,EAAE,CAAC,YAAY,CAA0B,CAAA;AACtD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAA2B,EAAE,IAAe;IACtE,QAAoC,CAAC,YAAY,CAAC,GAAG,IAAI,CAAA;AAC5D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,IAAI,GAAI,KAAa,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAA+C,CAAA;IACtG,OAAQ,IAAI,EAAE,CAAC,gBAAgB,CAAkC,IAAI,EAAE,CAAA;AACzE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAA2B,EAAE,GAAW,EAAE,IAAkB;IAC1F,MAAM,CAAC,GAAG,QAAmC,CAAA;IAC7C,MAAM,QAAQ,GAAI,CAAC,CAAC,gBAAgB,CAAkC,IAAI,EAAE,CAAA;IAC5E,CAAC,CAAC,gBAAgB,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAA;AACpD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,IAAI,GAAI,KAAa,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAA+C,CAAA;IACtG,OAAQ,IAAI,EAAE,CAAC,cAAc,CAAgC,IAAI,EAAE,CAAA;AACrE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAA2B,EAAE,GAAW,EAAE,IAAgB;IACtF,MAAM,CAAC,GAAG,QAAmC,CAAA;IAC7C,MAAM,QAAQ,GAAI,CAAC,CAAC,cAAc,CAAgC,IAAI,EAAE,CAAA;IACxE,CAAC,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAA;AAClD,CAAC"}
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/decorators/metadata.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,CAAC;AAAC,MAAc,CAAC,QAAQ,KAAK,MAAM,CAAC,iBAAiB,CAAC,CAAA;AAEvD,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAA;AACzD,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAA;AACjE,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAA;AAU7D,MAAM,UAAU,YAAY,CAAC,GAAa;IACxC,MAAM,IAAI,GAAI,GAAW,CAAC,MAAM,CAAC,QAAQ,CAA+C,CAAA;IACxF,OAAO,IAAI,EAAE,CAAC,YAAY,CAA0B,CAAA;AACtD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAA2B,EAAE,IAAe;IACtE,QAAoC,CAAC,YAAY,CAAC,GAAG,IAAI,CAAA;AAC5D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,IAAI,GAAI,KAAa,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAA+C,CAAA;IACtG,OAAQ,IAAI,EAAE,CAAC,gBAAgB,CAAkC,IAAI,EAAE,CAAA;AACzE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAA2B,EAAE,GAAW,EAAE,IAAkB;IAC1F,MAAM,CAAC,GAAG,QAAmC,CAAA;IAC7C,MAAM,QAAQ,GAAI,CAAC,CAAC,gBAAgB,CAAkC,IAAI,EAAE,CAAA;IAC5E,CAAC,CAAC,gBAAgB,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAA;AACpD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,IAAI,GAAI,KAAa,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAA+C,CAAA;IACtG,OAAQ,IAAI,EAAE,CAAC,cAAc,CAAgC,IAAI,EAAE,CAAA;AACrE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAA2B,EAAE,GAAW,EAAE,IAAgB;IACtF,MAAM,CAAC,GAAG,QAAmC,CAAA;IAC7C,MAAM,QAAQ,GAAI,CAAC,CAAC,cAAc,CAAgC,IAAI,EAAE,CAAA;IACxE,CAAC,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAA;AAClD,CAAC"}

package/dist/entity/base-entity.d.ts

@@ -0,0 +1,19 @@
+import type { EntityId } from './types.js';
+/**
+ * Optional base for `@Entity` classes. The runtime assigns these on spawn (server) and on enter
+ * (client), so extending is not required — it just makes them visible to TypeScript.
+ *
+ * Entity constructors must take no arguments: the client mirror creates the instance first and
+ * assigns replicated fields afterwards.
+ */
+export declare class BaseEntity {
+    /** Server-assigned id. 0 until the entity is spawned. */
+    id: EntityId;
+    /** The player this entity belongs to, or null. Replicated to every viewer. */
+    ownerId: string | null;
+    /** True in the server runtime, false on a client mirror. */
+    isServer: boolean;
+    /** True on the server; on a client, true only for entities this client owns. */
+    hasAuthority: boolean;
+}
+//# sourceMappingURL=base-entity.d.ts.map

package/dist/entity/base-entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-entity.d.ts","sourceRoot":"","sources":["../../src/entity/base-entity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE1C;;;;;;GAMG;AACH,qBAAa,UAAU;IACrB,yDAAyD;IACzD,EAAE,EAAE,QAAQ,CAAI;IAChB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAO;IAC7B,4DAA4D;IAC5D,QAAQ,EAAE,OAAO,CAAQ;IACzB,gFAAgF;IAChF,YAAY,EAAE,OAAO,CAAQ;CAC9B"}

package/dist/entity/base-entity.js

@@ -0,0 +1,18 @@
+/**
+ * Optional base for `@Entity` classes. The runtime assigns these on spawn (server) and on enter
+ * (client), so extending is not required — it just makes them visible to TypeScript.
+ *
+ * Entity constructors must take no arguments: the client mirror creates the instance first and
+ * assigns replicated fields afterwards.
+ */
+export class BaseEntity {
+    /** Server-assigned id. 0 until the entity is spawned. */
+    id = 0;
+    /** The player this entity belongs to, or null. Replicated to every viewer. */
+    ownerId = null;
+    /** True in the server runtime, false on a client mirror. */
+    isServer = false;
+    /** True on the server; on a client, true only for entities this client owns. */
+    hasAuthority = false;
+}
+//# sourceMappingURL=base-entity.js.map

package/dist/entity/base-entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-entity.js","sourceRoot":"","sources":["../../src/entity/base-entity.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAO,UAAU;IACrB,yDAAyD;IACzD,EAAE,GAAa,CAAC,CAAA;IAChB,8EAA8E;IAC9E,OAAO,GAAkB,IAAI,CAAA;IAC7B,4DAA4D;IAC5D,QAAQ,GAAY,KAAK,CAAA;IACzB,gFAAgF;IAChF,YAAY,GAAY,KAAK,CAAA;CAC9B"}

package/dist/entity/fields.d.ts

@@ -0,0 +1,21 @@
+import type { EntityConstructor } from './types.js';
+/** Which fields of an entity type travel to whom, and how they are rounded first. */
+export interface FieldPlan {
+    replicated: string[];
+    ownerReplicated: string[];
+    quantized: Record<string, number>;
+}
+/** `ownerId` is a replicated built-in: `@OwnerReplicated` fields and `@Client` calls key off it. */
+export declare const ownerIdField = "ownerId";
+/** Derives the field plan for an entity type. Pure — callers cache it per registered type. */
+export declare function fieldPlanOf(Type: EntityConstructor<object> | Function): FieldPlan;
+/** Rounds a numeric value to `step` so float noise does not produce updates. */
+export declare function quantize(value: unknown, step: number | undefined): unknown;
+/**
+ * The replicated field set of one entity as one viewer should see it. `isOwner` adds the
+ * `@OwnerReplicated` fields.
+ */
+export declare function snapshotFields(entity: object, plan: FieldPlan, isOwner: boolean): Record<string, unknown>;
+/** Keys of `next` whose value changed since `prev`, plus keys that disappeared (as `undefined`). */
+export declare function diffFields(prev: Record<string, unknown>, next: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=fields.d.ts.map

package/dist/entity/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/entity/fields.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEnD,qFAAqF;AACrF,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;AAED,oGAAoG;AACpG,eAAO,MAAM,YAAY,YAAY,CAAA;AAErC,8FAA8F;AAC9F,wBAAgB,WAAW,CAAC,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAAG,QAAQ,GAAG,SAAS,CAUjF;AAED,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAG1E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzG;AAgBD,oGAAoG;AACpG,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB"}

package/dist/entity/fields.js

@@ -0,0 +1,67 @@
+import { getPropertyRoles } from '../decorators/metadata.js';
+import { getQuantizedFields } from '../decorators/entity.js';
+/** `ownerId` is a replicated built-in: `@OwnerReplicated` fields and `@Client` calls key off it. */
+export const ownerIdField = 'ownerId';
+/** Derives the field plan for an entity type. Pure — callers cache it per registered type. */
+export function fieldPlanOf(Type) {
+    const proto = Type.prototype;
+    const roles = getPropertyRoles(proto);
+    const replicated = [];
+    const ownerReplicated = [];
+    for (const [key, role] of Object.entries(roles)) {
+        if (role === 'replicated')
+            replicated.push(key);
+        else if (role === 'ownerReplicated')
+            ownerReplicated.push(key);
+    }
+    return { replicated, ownerReplicated, quantized: getQuantizedFields(proto) };
+}
+/** Rounds a numeric value to `step` so float noise does not produce updates. */
+export function quantize(value, step) {
+    if (step === undefined || step <= 0 || typeof value !== 'number' || !Number.isFinite(value))
+        return value;
+    return Math.round(value / step) * step;
+}
+/**
+ * The replicated field set of one entity as one viewer should see it. `isOwner` adds the
+ * `@OwnerReplicated` fields.
+ */
+export function snapshotFields(entity, plan, isOwner) {
+    const source = entity;
+    const out = { [ownerIdField]: source[ownerIdField] ?? null };
+    for (const key of plan.replicated)
+        out[key] = quantize(source[key], plan.quantized[key]);
+    if (isOwner) {
+        for (const key of plan.ownerReplicated)
+            out[key] = quantize(source[key], plan.quantized[key]);
+    }
+    return out;
+}
+/** Shallow value equality: primitives by Object.is, arrays and plain objects one level deep. */
+function valuesEqual(a, b) {
+    if (Object.is(a, b))
+        return true;
+    if (Array.isArray(a) && Array.isArray(b)) {
+        return a.length === b.length && a.every((v, i) => Object.is(v, b[i]));
+    }
+    if (typeof a === 'object' && typeof b === 'object' && a !== null && b !== null) {
+        const ka = Object.keys(a), kb = Object.keys(b);
+        return ka.length === kb.length
+            && ka.every(k => Object.is(a[k], b[k]));
+    }
+    return false;
+}
+/** Keys of `next` whose value changed since `prev`, plus keys that disappeared (as `undefined`). */
+export function diffFields(prev, next) {
+    const patch = {};
+    for (const [key, value] of Object.entries(next)) {
+        if (!valuesEqual(prev[key], value))
+            patch[key] = value;
+    }
+    for (const key of Object.keys(prev)) {
+        if (!(key in next))
+            patch[key] = undefined;
+    }
+    return patch;
+}
+//# sourceMappingURL=fields.js.map

package/dist/entity/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../src/entity/fields.ts"],"names":[],"mappings":"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"}

package/dist/entity/registry.d.ts

@@ -0,0 +1,53 @@
+import type { EntityConstructor, EntityId, EntitySync } from './types.js';
+/** The slice of the transport a mirrored entity needs for its `@Server` calls. */
+export interface EntityCaller {
+    callEntity(id: EntityId, method: string, args: unknown[]): Promise<unknown> | void;
+}
+export interface ClientEntityRegistryOptions {
+    types: EntityConstructor<object>[];
+    /** Reads the local playerId lazily — it is only known after the connection is authenticated. */
+    getPlayerId: () => string | null;
+    client?: EntityCaller;
+}
+type Listener<T extends object = object> = (entity: T) => void;
+/**
+ * The client's mirror of the entities it can currently see. Creates the same class on `enter`,
+ * applies `update` patches in place, and calls `@ClientSpawn` / `@ClientDespawn` as entities join
+ * and leave this viewer's set.
+ */
+export declare class ClientEntityRegistry {
+    private options;
+    private entities;
+    private infoByName;
+    private infoByCtor;
+    private spawnListeners;
+    private despawnListeners;
+    private subscribers;
+    private byTypeCache;
+    /** Per-type version, bumped only for types actually touched by a sync — keeps an update to one
+     *  type from invalidating every other type's `byType()` cache (and its `useEntities()` callers). */
+    private typeVersions;
+    private version;
+    constructor(options: ClientEntityRegistryOptions);
+    get(id: EntityId): object | undefined;
+    all(): object[];
+    /** Entities of one type. The array is referentially stable until that type's entities change. */
+    byType<T extends object>(Type: EntityConstructor<T>): T[];
+    private touchType;
+    private hasAuthorityFor;
+    /** Called when an entity of `Type` enters this viewer's set, after its fields are assigned. */
+    onSpawn<T extends object>(Type: EntityConstructor<T>, listener: Listener<T>): () => void;
+    /** Called when an entity of `Type` leaves this viewer's set, before it is dropped. */
+    onDespawn<T extends object>(Type: EntityConstructor<T>, listener: Listener<T>): () => void;
+    /** Fires once per applied sync, after the whole batch is in place. For game loops and React. */
+    subscribe(listener: () => void): () => void;
+    /** Applies one `{ enter, update, leave }` delta from the server. */
+    applySync(sync: EntitySync): void;
+    /** Dispatches a server-pushed `@Client` / `@Multicast` call onto the mirrored entity. */
+    applyRpc(id: EntityId, method: string, args: unknown[]): void;
+    /** Despawns every mirror — used when the connection drops so a reconnect starts clean. */
+    clear(): void;
+    private remove;
+}
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/entity/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/entity/registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEzE,kFAAkF;AAClF,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAA;CACnF;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAA;IAClC,gGAAgG;IAChG,WAAW,EAAE,MAAM,MAAM,GAAG,IAAI,CAAA;IAChC,MAAM,CAAC,EAAE,YAAY,CAAA;CACtB;AAQD,KAAK,QAAQ,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAA;AAE9D;;;;GAIG;AACH,qBAAa,oBAAoB;IAanB,OAAO,CAAC,OAAO;IAZ3B,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,cAAc,CAAqC;IAC3D,OAAO,CAAC,gBAAgB,CAAqC;IAC7D,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,WAAW,CAA2D;IAC9E;wGACoG;IACpG,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,OAAO,CAAI;gBAEC,OAAO,EAAE,2BAA2B;IAqBxD,GAAG,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS;IAIrC,GAAG,IAAI,MAAM,EAAE;IAIf,iGAAiG;IACjG,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE;IASzD,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,eAAe;IAIvB,+FAA+F;IAC/F,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAIxF,sFAAsF;IACtF,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAI1F,gGAAgG;IAChG,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAK3C,oEAAoE;IACpE,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAsCjC,yFAAyF;IACzF,QAAQ,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAO7D,0FAA0F;IAC1F,KAAK,IAAI,IAAI;IAOb,OAAO,CAAC,MAAM;CASf"}

package/dist/entity/registry.js

@@ -0,0 +1,167 @@
+import { getEntityHooks, getEntityName } from '../decorators/entity.js';
+import { isEmptySync } from './types.js';
+/**
+ * The client's mirror of the entities it can currently see. Creates the same class on `enter`,
+ * applies `update` patches in place, and calls `@ClientSpawn` / `@ClientDespawn` as entities join
+ * and leave this viewer's set.
+ */
+export class ClientEntityRegistry {
+    options;
+    entities = new Map();
+    infoByName = new Map();
+    infoByCtor = new Map();
+    spawnListeners = new Map();
+    despawnListeners = new Map();
+    subscribers = new Set();
+    byTypeCache = new Map();
+    /** Per-type version, bumped only for types actually touched by a sync — keeps an update to one
+     *  type from invalidating every other type's `byType()` cache (and its `useEntities()` callers). */
+    typeVersions = new Map();
+    version = 0;
+    constructor(options) {
+        this.options = options;
+        for (const Type of options.types) {
+            const proto = Type.prototype;
+            const hooks = getEntityHooks(proto);
+            const name = getEntityName(Type);
+            const existing = this.infoByName.get(name);
+            if (existing && existing.Type !== Type) {
+                throw new Error(`[replicast] two @Entity classes are both named "${name}" — give one an explicit @Entity({ name }) option`);
+            }
+            const info = {
+                Type,
+                spawnHooks: Object.keys(hooks).filter(m => hooks[m] === 'clientSpawn'),
+                despawnHooks: Object.keys(hooks).filter(m => hooks[m] === 'clientDespawn'),
+            };
+            this.infoByName.set(name, info);
+            this.infoByCtor.set(Type, info);
+        }
+    }
+    get(id) {
+        return this.entities.get(id);
+    }
+    all() {
+        return [...this.entities.values()];
+    }
+    /** Entities of one type. The array is referentially stable until that type's entities change. */
+    byType(Type) {
+        const version = this.typeVersions.get(Type) ?? 0;
+        const cached = this.byTypeCache.get(Type);
+        if (cached?.version === version)
+            return cached.list;
+        const list = this.all().filter(e => e instanceof Type);
+        this.byTypeCache.set(Type, { version, list });
+        return list;
+    }
+    touchType(entity) {
+        const Type = Object.getPrototypeOf(entity).constructor;
+        this.typeVersions.set(Type, (this.typeVersions.get(Type) ?? 0) + 1);
+    }
+    hasAuthorityFor(entity) {
+        return entity['ownerId'] != null && entity['ownerId'] === this.options.getPlayerId();
+    }
+    /** Called when an entity of `Type` enters this viewer's set, after its fields are assigned. */
+    onSpawn(Type, listener) {
+        return addListener(this.spawnListeners, Type, listener);
+    }
+    /** Called when an entity of `Type` leaves this viewer's set, before it is dropped. */
+    onDespawn(Type, listener) {
+        return addListener(this.despawnListeners, Type, listener);
+    }
+    /** Fires once per applied sync, after the whole batch is in place. For game loops and React. */
+    subscribe(listener) {
+        this.subscribers.add(listener);
+        return () => { this.subscribers.delete(listener); };
+    }
+    /** Applies one `{ enter, update, leave }` delta from the server. */
+    applySync(sync) {
+        if (isEmptySync(sync))
+            return;
+        for (const { type, id, fields } of sync.enter) {
+            const info = this.infoByName.get(type);
+            if (!info) {
+                console.warn(`[replicast] received an unknown entity type "${type}" — register it in createApp({ entities })`);
+                continue;
+            }
+            const entity = new info.Type();
+            entity['id'] = id;
+            entity['isServer'] = false;
+            if (this.options.client)
+                entity['__wsClient'] = this.options.client;
+            Object.assign(entity, fields);
+            entity['hasAuthority'] = this.hasAuthorityFor(entity);
+            this.entities.set(id, entity);
+            this.touchType(entity);
+            callHooks(entity, info.spawnHooks);
+            notify(this.spawnListeners, entity);
+        }
+        for (const { id, fields } of sync.update) {
+            const entity = this.entities.get(id);
+            if (entity) {
+                Object.assign(entity, fields);
+                // ownerId is a replicated built-in and can change on an already-mirrored entity
+                // (e.g. a ship changes hands) — hasAuthority must track it, not just the initial enter.
+                entity['hasAuthority'] = this.hasAuthorityFor(entity);
+                this.touchType(entity);
+            }
+        }
+        for (const id of sync.leave)
+            this.remove(id);
+        this.version++;
+        for (const listener of this.subscribers)
+            listener();
+    }
+    /** Dispatches a server-pushed `@Client` / `@Multicast` call onto the mirrored entity. */
+    applyRpc(id, method, args) {
+        const entity = this.entities.get(id);
+        const methodName = method.split('.')[1];
+        if (!entity || !methodName || typeof entity[methodName] !== 'function')
+            return;
+        entity[methodName].apply(entity, args);
+    }
+    /** Despawns every mirror — used when the connection drops so a reconnect starts clean. */
+    clear() {
+        if (this.entities.size === 0)
+            return;
+        for (const id of [...this.entities.keys()])
+            this.remove(id);
+        this.version++;
+        for (const listener of this.subscribers)
+            listener();
+    }
+    remove(id) {
+        const entity = this.entities.get(id);
+        if (!entity)
+            return;
+        const info = this.infoByCtor.get(Object.getPrototypeOf(entity).constructor);
+        callHooks(entity, info?.despawnHooks ?? []);
+        this.entities.delete(id);
+        this.touchType(entity);
+        notify(this.despawnListeners, entity);
+    }
+}
+function addListener(map, Type, listener) {
+    let set = map.get(Type);
+    if (!set) {
+        set = new Set();
+        map.set(Type, set);
+    }
+    set.add(listener);
+    return () => { set.delete(listener); };
+}
+function notify(map, entity) {
+    for (const [Type, listeners] of map) {
+        if (!(entity instanceof Type))
+            continue;
+        for (const listener of listeners)
+            listener(entity);
+    }
+}
+function callHooks(entity, methods) {
+    for (const method of methods) {
+        const fn = entity[method];
+        if (typeof fn === 'function')
+            fn.call(entity);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/entity/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/entity/registry.ts"],"names":[],"mappings":"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"}

package/dist/entity/replicator.d.ts

@@ -0,0 +1,40 @@
+import type { FieldPlan } from './fields.js';
+import type { VisibleTo } from './visibility.js';
+import type { EntityId, EntitySync, EntityWorldView } from './types.js';
+/** One live entity as the replicator needs to see it: identity, wire type, field plan, scoping. */
+export interface ReplicationEntry {
+    id: EntityId;
+    entity: object;
+    type: string;
+    plan: FieldPlan;
+    visibleTo?: VisibleTo;
+}
+/**
+ * Tracks, per client, which entities that client has been sent and the fields it last saw, and turns
+ * the current world into that client's `{ enter, update, leave }` delta.
+ *
+ * Cost is O(clients x entities) per flush — deliberate for now; a spatial index hook comes later.
+ */
+export declare class EntityReplicator {
+    /** playerId → entityId → last-sent field snapshot. */
+    private views;
+    /** True when `playerId` currently has `id` in their set (i.e. as of the last flush). */
+    hasInView(playerId: string, id: EntityId): boolean;
+    /** The clients that currently see `id` — the audience for a `@Multicast`. */
+    viewersOf(id: EntityId): string[];
+    /** Forget a disconnected client so they re-enter from scratch on reconnect. */
+    dropViewer(playerId: string): void;
+    /**
+     * Records `id` as already sent to `playerId` with `fields`, without waiting for the next flush —
+     * for a caller that must guarantee delivery order (an `@Client`/`@Multicast` send that needs the
+     * recipient's mirror to exist before the rpc arrives). The next real `flush()` then sees this id
+     * already in `view` and sends only a diff, never a duplicate `enter`.
+     */
+    recordEnter(playerId: string, id: EntityId, fields: Record<string, unknown>): void;
+    /**
+     * Builds one client's delta and records it as sent. An entity is visible when the client owns it
+     * (owners always see their own entities) or the type's `visibleTo` hook allows it.
+     */
+    computeSync(playerId: string, entries: Iterable<ReplicationEntry>, world: EntityWorldView): EntitySync;
+}
+//# sourceMappingURL=replicator.d.ts.map

package/dist/entity/replicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replicator.d.ts","sourceRoot":"","sources":["../../src/entity/replicator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEvE,mGAAmG;AACnG,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,QAAQ,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,SAAS,CAAA;IACf,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAED;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,sDAAsD;IACtD,OAAO,CAAC,KAAK,CAA4D;IAEzE,wFAAwF;IACxF,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,GAAG,OAAO;IAIlD,6EAA6E;IAC7E,SAAS,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,EAAE;IAQjC,+EAA+E;IAC/E,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIlC;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAMlF;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,eAAe,GAAG,UAAU;CAmCvG"}