@replicast/core 0.1.2 → 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

@@ -1,14 +1,17 @@
-import 'reflect-metadata';
 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(target: Function): StoreType | undefined;
-export declare function setStoreType(target: Function, type: StoreType): void;
+export declare function getStoreType(cls: Function): StoreType | undefined;
+export declare function setStoreType(metadata: DecoratorMetadata, type: StoreType): void;
 export declare function getPropertyRoles(proto: object): Record<string, PropertyRole>;
-export declare function setPropertyRole(proto: object, key: string, role: PropertyRole): void;
+export declare function setPropertyRole(metadata: DecoratorMetadata, key: string, role: PropertyRole): void;
 export declare function getMethodRoles(proto: object): Record<string, MethodRole>;
-export declare function setMethodRole(proto: object, key: string, role: MethodRole): void;
+export declare function setMethodRole(metadata: DecoratorMetadata, key: string, role: MethodRole): void;
 //# sourceMappingURL=metadata.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/decorators/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAA;AAEzB,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,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAEpE;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAEpE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAE5E;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAGpF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAExE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAGhF"}
+{"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

@@ -1,25 +1,32 @@
-import 'reflect-metadata';
+// Symbol.metadata polyfill for Node < 22
+;
+Symbol.metadata ??= Symbol('Symbol.metadata');
 export const storeTypeKey = Symbol('replicast:storeType');
 export const propertyRolesKey = Symbol('replicast:propertyRoles');
 export const methodRolesKey = Symbol('replicast:methodRoles');
-export function getStoreType(target) {
-    return Reflect.getMetadata(storeTypeKey, target);
+export function getStoreType(cls) {
+    const meta = cls[Symbol.metadata];
+    return meta?.[storeTypeKey];
 }
-export function setStoreType(target, type) {
-    Reflect.defineMetadata(storeTypeKey, type, target);
+export function setStoreType(metadata, type) {
+    metadata[storeTypeKey] = type;
 }
 export function getPropertyRoles(proto) {
-    return Reflect.getMetadata(propertyRolesKey, proto) ?? {};
+    const meta = proto.constructor[Symbol.metadata];
+    return meta?.[propertyRolesKey] ?? {};
 }
-export function setPropertyRole(proto, key, role) {
-    const existing = getPropertyRoles(proto);
-    Reflect.defineMetadata(propertyRolesKey, { ...existing, [key]: role }, proto);
+export function setPropertyRole(metadata, key, role) {
+    const m = metadata;
+    const existing = m[propertyRolesKey] ?? {};
+    m[propertyRolesKey] = { ...existing, [key]: role };
 }
 export function getMethodRoles(proto) {
-    return Reflect.getMetadata(methodRolesKey, proto) ?? {};
+    const meta = proto.constructor[Symbol.metadata];
+    return meta?.[methodRolesKey] ?? {};
 }
-export function setMethodRole(proto, key, role) {
-    const existing = getMethodRoles(proto);
-    Reflect.defineMetadata(methodRolesKey, { ...existing, [key]: role }, proto);
+export function setMethodRole(metadata, key, role) {
+    const m = metadata;
+    const existing = m[methodRolesKey] ?? {};
+    m[methodRolesKey] = { ...existing, [key]: role };
 }
 //# sourceMappingURL=metadata.js.map

package/dist/decorators/metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/decorators/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAA;AAEzB,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,MAAgB;IAC3C,OAAO,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,CAAA;AAClD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAgB,EAAE,IAAe;IAC5D,OAAO,CAAC,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;AACpD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,OAAO,CAAC,WAAW,CAAC,gBAAgB,EAAE,KAAK,CAAC,IAAI,EAAE,CAAA;AAC3D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,GAAW,EAAE,IAAkB;IAC5E,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;IACxC,OAAO,CAAC,cAAc,CAAC,gBAAgB,EAAE,EAAE,GAAG,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,KAAK,CAAC,CAAA;AAC/E,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,KAAK,CAAC,IAAI,EAAE,CAAA;AACzD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,GAAW,EAAE,IAAgB;IACxE,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;IACtC,OAAO,CAAC,cAAc,CAAC,cAAc,EAAE,EAAE,GAAG,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,KAAK,CAAC,CAAA;AAC7E,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/decorators/store.d.ts

@@ -1,9 +1,6 @@
-import 'reflect-metadata';
-type AnyConstructor = new (...args: any[]) => object;
-export declare function GlobalStore(target: AnyConstructor): void;
-export declare function OwnerStore(target: AnyConstructor): void;
-export declare function Global(target: object, propertyKey: string): void;
-export declare function OwnerOnly(target: object, propertyKey: string): void;
-export declare function ServerOnly(target: object, propertyKey: string): void;
-export {};
+export declare function GlobalStore(value: abstract new (...args: any[]) => object, context: ClassDecoratorContext): void;
+export declare function OwnerStore(value: abstract new (...args: any[]) => object, context: ClassDecoratorContext): void;
+export declare function Global(value: undefined, context: ClassFieldDecoratorContext): void;
+export declare function OwnerOnly(value: undefined, context: ClassFieldDecoratorContext): void;
+export declare function ServerOnly(value: undefined, context: ClassFieldDecoratorContext): void;
 //# sourceMappingURL=store.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/decorators/store.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAA;AAGzB,KAAK,cAAc,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAA;AAEpD,wBAAgB,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAExD;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAEvD;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAEhE;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAEnE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAEpE"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/decorators/store.ts"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,CACzB,KAAK,EAAE,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,EAC9C,OAAO,EAAE,qBAAqB,GAC7B,IAAI,CAEN;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,EAC9C,OAAO,EAAE,qBAAqB,GAC7B,IAAI,CAEN;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAElF;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAErF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAEtF"}

package/dist/decorators/store.js

@@ -1,18 +1,17 @@
-import 'reflect-metadata';
 import { setStoreType, setPropertyRole } from './metadata.js';
-export function GlobalStore(target) {
-    setStoreType(target, 'global');
+export function GlobalStore(value, context) {
+    setStoreType(context.metadata, 'global');
 }
-export function OwnerStore(target) {
-    setStoreType(target, 'owner');
+export function OwnerStore(value, context) {
+    setStoreType(context.metadata, 'owner');
 }
-export function Global(target, propertyKey) {
-    setPropertyRole(target, propertyKey, 'global');
+export function Global(value, context) {
+    setPropertyRole(context.metadata, String(context.name), 'global');
 }
-export function OwnerOnly(target, propertyKey) {
-    setPropertyRole(target, propertyKey, 'ownerOnly');
+export function OwnerOnly(value, context) {
+    setPropertyRole(context.metadata, String(context.name), 'ownerOnly');
 }
-export function ServerOnly(target, propertyKey) {
-    setPropertyRole(target, propertyKey, 'serverOnly');
+export function ServerOnly(value, context) {
+    setPropertyRole(context.metadata, String(context.name), 'serverOnly');
 }
 //# sourceMappingURL=store.js.map

package/dist/decorators/store.js.map

@@ -1 +1 @@
-{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/decorators/store.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAA;AACzB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAI7D,MAAM,UAAU,WAAW,CAAC,MAAsB;IAChD,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;AAChC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAsB;IAC/C,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAC/B,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,MAAc,EAAE,WAAmB;IACxD,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAA;AAChD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,WAAmB;IAC3D,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,CAAA;AACnD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,WAAmB;IAC5D,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,CAAC,CAAA;AACpD,CAAC"}
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/decorators/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAE7D,MAAM,UAAU,WAAW,CACzB,KAA8C,EAC9C,OAA8B;IAE9B,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;AAC1C,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,KAA8C,EAC9C,OAA8B;IAE9B,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAgB,EAAE,OAAmC;IAC1E,eAAe,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAA;AACnE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAgB,EAAE,OAAmC;IAC7E,eAAe,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,CAAA;AACtE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAgB,EAAE,OAAmC;IAC9E,eAAe,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,CAAA;AACvE,CAAC"}

package/dist/decorators/system.d.ts

@@ -1,11 +1,8 @@
-import 'reflect-metadata';
-declare const isSystemKey: unique symbol;
-declare const isServerClassKey: unique symbol;
-declare const isClientClassKey: unique symbol;
-type AnyConstructor = new (...args: any[]) => object;
-export declare function System(target: AnyConstructor): void;
-export declare function Server(target: object | AnyConstructor, propertyKey?: string): void;
-export declare function Client(target: object | AnyConstructor, propertyKey?: string): void;
-export declare function Multicast(target: object, propertyKey: string): void;
-export { isSystemKey, isServerClassKey, isClientClassKey };
+export declare const isSystemKey: unique symbol;
+export declare const isServerClassKey: unique symbol;
+export declare const isClientClassKey: unique symbol;
+export declare function System(value: Function, context: ClassDecoratorContext): void;
+export declare function Server(value: Function, context: ClassDecoratorContext | ClassMethodDecoratorContext): void;
+export declare function Client(value: Function, context: ClassDecoratorContext | ClassMethodDecoratorContext): void;
+export declare function Multicast(value: Function, context: ClassMethodDecoratorContext): void;
 //# sourceMappingURL=system.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/decorators/system.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAA;AAGzB,QAAA,MAAM,WAAW,eAAmC,CAAA;AACpD,QAAA,MAAM,gBAAgB,eAAwC,CAAA;AAC9D,QAAA,MAAM,gBAAgB,eAAwC,CAAA;AAE9D,KAAK,cAAc,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAA;AAEpD,wBAAgB,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAEnD;AAID,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAQlF;AAID,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAMlF;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAEnE;AAED,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAA"}
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/decorators/system.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,eAAmC,CAAA;AAC3D,eAAO,MAAM,gBAAgB,eAAwC,CAAA;AACrE,eAAO,MAAM,gBAAgB,eAAwC,CAAA;AAErE,wBAAgB,MAAM,CACpB,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,qBAAqB,GAC7B,IAAI,CAEN;AAED,wBAAgB,MAAM,CACpB,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,qBAAqB,GAAG,2BAA2B,GAC3D,IAAI,CAMN;AAED,wBAAgB,MAAM,CACpB,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,qBAAqB,GAAG,2BAA2B,GAC3D,IAAI,CAMN;AAED,wBAAgB,SAAS,CACvB,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,2BAA2B,GACnC,IAAI,CAEN"}

package/dist/decorators/system.js

@@ -1,35 +1,27 @@
-import 'reflect-metadata';
 import { setMethodRole } from './metadata.js';
-const isSystemKey = Symbol.for('replicast:isSystem');
-const isServerClassKey = Symbol.for('replicast:isServerClass');
-const isClientClassKey = Symbol.for('replicast:isClientClass');
-export function System(target) {
-    Reflect.defineMetadata(isSystemKey, true, target);
+export const isSystemKey = Symbol.for('replicast:isSystem');
+export const isServerClassKey = Symbol.for('replicast:isServerClass');
+export const isClientClassKey = Symbol.for('replicast:isClientClass');
+export function System(value, context) {
+    context.metadata[isSystemKey] = true;
 }
-// @Server on a method: marks it as a server-side RPC
-// @Server on a class: marks it as a server-only lifecycle class
-export function Server(target, propertyKey) {
-    if (propertyKey === undefined) {
-        // Class decorator
-        Reflect.defineMetadata(isServerClassKey, true, target);
+export function Server(value, context) {
+    if (context.kind === 'class') {
+        context.metadata[isServerClassKey] = true;
     }
     else {
-        // Method decorator
-        setMethodRole(target, propertyKey, 'server');
+        setMethodRole(context.metadata, String(context.name), 'server');
     }
 }
-// @Client on a method: marks it as a client-side RPC
-// @Client on a class: marks it as a client-only lifecycle class
-export function Client(target, propertyKey) {
-    if (propertyKey === undefined) {
-        Reflect.defineMetadata(isClientClassKey, true, target);
+export function Client(value, context) {
+    if (context.kind === 'class') {
+        context.metadata[isClientClassKey] = true;
     }
     else {
-        setMethodRole(target, propertyKey, 'client');
+        setMethodRole(context.metadata, String(context.name), 'client');
     }
 }
-export function Multicast(target, propertyKey) {
-    setMethodRole(target, propertyKey, 'multicast');
+export function Multicast(value, context) {
+    setMethodRole(context.metadata, String(context.name), 'multicast');
 }
-export { isSystemKey, isServerClassKey, isClientClassKey };
 //# sourceMappingURL=system.js.map

package/dist/decorators/system.js.map

@@ -1 +1 @@
-{"version":3,"file":"system.js","sourceRoot":"","sources":["../../src/decorators/system.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAA;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAE7C,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAA;AACpD,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAA;AAC9D,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAA;AAI9D,MAAM,UAAU,MAAM,CAAC,MAAsB;IAC3C,OAAO,CAAC,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;AACnD,CAAC;AAED,qDAAqD;AACrD,gEAAgE;AAChE,MAAM,UAAU,MAAM,CAAC,MAA+B,EAAE,WAAoB;IAC1E,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,kBAAkB;QAClB,OAAO,CAAC,cAAc,CAAC,gBAAgB,EAAE,IAAI,EAAE,MAAwB,CAAC,CAAA;IAC1E,CAAC;SAAM,CAAC;QACN,mBAAmB;QACnB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAA;IAC9C,CAAC;AACH,CAAC;AAED,qDAAqD;AACrD,gEAAgE;AAChE,MAAM,UAAU,MAAM,CAAC,MAA+B,EAAE,WAAoB;IAC1E,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,CAAC,cAAc,CAAC,gBAAgB,EAAE,IAAI,EAAE,MAAwB,CAAC,CAAA;IAC1E,CAAC;SAAM,CAAC;QACN,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAA;IAC9C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,WAAmB;IAC3D,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,CAAA;AACjD,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAA"}
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../src/decorators/system.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAE7C,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAA;AAC3D,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAA;AACrE,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAA;AAErE,MAAM,UAAU,MAAM,CACpB,KAAe,EACf,OAA8B;IAE7B,OAAO,CAAC,QAAoC,CAAC,WAAW,CAAC,GAAG,IAAI,CAAA;AACnE,CAAC;AAED,MAAM,UAAU,MAAM,CACpB,KAAe,EACf,OAA4D;IAE5D,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,OAAO,CAAC,QAAoC,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAA;IACxE,CAAC;SAAM,CAAC;QACN,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAA;IACjE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,MAAM,CACpB,KAAe,EACf,OAA4D;IAE5D,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,OAAO,CAAC,QAAoC,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAA;IACxE,CAAC;SAAM,CAAC;QACN,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAA;IACjE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,KAAe,EACf,OAAoC;IAEpC,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,CAAA;AACpE,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