@dcl/protocol 1.0.0-2731649607.commit-890a990 → 1.0.0-27358757907.commit-3c70e8a

package/README.md

@@ -1 +1,267 @@
 # Protocol definitions
+
+This module is intended to be installed as a node_module via `npm install @dcl/protocol`.
+
+It is recommended that every project compiles the needed files only as part of its build process. Some imports are required:
+
+- `-I=$(pwd)/node_modules/@dcl/protocol/public`
+- `-I=$(pwd)/node_modules/@dcl/protocol/proto`
+
+An example compilation looks like this:
+
+```bash
+protoc \
+  --plugin=./node_modules/.bin/protoc-gen-dcl_ts_proto \
+  --dcl_ts_proto_opt=esModuleInterop=true,returnObservable=false,outputServices=generic-definitions,fileSuffix=.gen \
+  --dcl_ts_proto_out="$(pwd)/out-ts" \
+  -I="$(pwd)/node_modules/@dcl/protocol/public" \
+  -I="$(pwd)/node_modules/@dcl/protocol/proto" \
+  "$(pwd)/node_modules/@dcl/protocol/public/sdk-components.proto"
+```
+
+# Style Guidelines
+
+1. All .proto files are snake_case.proto.
+2. For pascal or camel case usage, please make a deterministic one from the snake case. Example: nft_shape will transform to NftShape.
+3. See https://docs.buf.build/best-practices/style-guide. The most of other styles are taken from there, the Buf configuration is in proto/buf.yml.
+4. Use public/ folder only for .proto with protocol exposing, that is only for files with `import public`. This folder is not processed by the linter.
+
+# Dev with Decentraland Repositories
+
+Many repositories depend on this protocol definition and that sometimes implies some merge order. We don't have to worry much about compatibility because the checks are running with each PR, if you break something, the CI will warn you. But, in some cases, it's desirable to merge the implementation in a specific order to avoid unexpected behavior in the corner cases (multiple repositories are waiting for the build at the same time).
+
+> **Important Note: Avoid Merging Protocol PR Without Completed Unity Implementation**
+>
+> Please don't merge a protocol PR into the main branch unless the corresponding implementation in Unity has been completed. This is important to avoid any potential issues or build failures in Unity.
+>
+> The ideal order for introducing breaking changes in the protocol is as follows:
+>
+> 1. Create a PR in the Protocol repository.
+> 2. Use the npm test link from the CI of the protocol PR in the protocol-dependent application for development.
+> 3. Once both the protocol PR and the protocol-dependent application (e.g. unity-renderer) PR are ready for merging, synchronize their merging as follows:
+>    1. Merge the protocol PR.
+>    2. Modify protocol-dependent application PR to use the `@dcl/protocol@next` package to stop using the PR npm test link.
+>    3. Merge the protocol-dependent application PR.
+
+Some dev-cases are described here:
+
+## SDK: New component or component modification
+
+Repositories: [unity-renderer](https://github.com/decentraland/unity-renderer/) and [js-sdk-toolchain](https://github.com/decentraland/js-sdk-toolchain/)
+
+At the protocol level both operations shouldn't be a problem, but `js-sdk-toolchain` CI will fail if the component is not tested. This can happen if the PR **`A`** from the protocol is merged, and you update your PR **`B`** from `js-sdk-toolchain` with the changes before the PR **`A`** from `js-sdk-toolchain` is merged.
+
+Some guidelines and testing before merge:
+
+- The protocol package is uploaded to S3 while developing in a PR. This can be used in the target repositories
+- Testing in the playground: Playground allows us to test by adding query parameters: `https://playground.decentraland.org/?&renderer-branch=**feat/my-new-component**&sdk-branch=**feat/new-component-approach**`
+- Testing locally: you can write an example scene and install the package `@dcl/sdk` uploaded to S3 commented in the PR comments.
+- Testing in the Unity Editor: if you need to test with the editor opened, write the `ws` query parameter in your local or playground test.
+- Start merging when the three PRs are already to merge: first merge the Protocol one, then update the other two with the version @next and merge them at the same time.
+
+## SDK: New APIs or APIs modifications
+
+Repositories: [kernel](https://github.com/decentraland/kernel/), [js-sdk-toolchain](https://github.com/decentraland/js-sdk-toolchain/) and [scene-runtime](https://github.com/decentraland/scene-runtime/)
+In this case, there is no problem with when each PR is merged. It's recommendable to merge first the rpc server-side (in this case, Kernel), second the `scene-runtime` (and this would require a second update from `kernel`) and last the `js-sdk-toolchain`.
+
+## Comms
+
+TODO
+
+---
+
+# Bitwise Serialization Plugin (`protoc-gen-bitwise`)
+
+A custom protoc plugin that generates C# partial classes with typed float
+accessors for quantized `uint32` fields in high-frequency MMO networking
+messages (position deltas, player input, etc.).  It runs alongside
+`--csharp_out` in the same protoc invocation; the two output files coexist
+via C# `partial class`.
+
+## How it works
+
+Protobuf encodes `uint32` values as varints, which are already compact for
+small values: a value up to 2¹⁴−1 costs 2 bytes, up to 2²¹−1 costs 3 bytes.
+Rather than a separate binary packing layer, the plugin leverages this:
+
+1. Declare quantized fields as `uint32` in the `.proto` schema and annotate
+   them with `[(decentraland.common.quantized)]` to specify the float range
+   and bit resolution.
+2. `--csharp_out` generates the standard protobuf class with the raw `uint32`
+   property (e.g. `PositionX`).
+3. `--bitwise_out` (this plugin) generates a `partial class` extension with a
+   cached float accessor (e.g. `PositionXQuantized`) that encodes/decodes
+   transparently via `Quantize.Encode` / `Quantize.Decode`.
+
+The wire representation is a standard protobuf message — any protobuf-capable
+client can read it without knowledge of the plugin.
+
+## Prerequisites
+
+| Requirement | Version |
+|---|---|
+| Python | 3.10+ |
+| `protobuf` Python package | 4.x or 3.20+ |
+| `protoc` | 3.19+ |
+
+```bash
+pip install protobuf
+```
+
+## Step 1 — Annotate your `.proto` file
+
+Declare quantized fields as `uint32` and import `options.proto`:
+
+```protobuf
+syntax = "proto3";
+
+import "decentraland/common/options.proto";
+
+package decentraland.kernel.comms.v3;
+
+message PositionDelta {
+  // Float range [-100, 100] quantized to 16 bits ≈ 0.003-unit precision.
+  // Stored as uint32 on the wire; protobuf encodes it as a 3-byte varint.
+  uint32 dx        = 1 [(decentraland.common.quantized)  = { min: -100.0, max: 100.0, bits: 16 }];
+  uint32 dy        = 2 [(decentraland.common.quantized)  = { min: -100.0, max: 100.0, bits: 16 }];
+  uint32 dz        = 3 [(decentraland.common.quantized)  = { min: -100.0, max: 100.0, bits: 16 }];
+
+  // Unannotated uint32: protobuf varint encodes small values compactly by default.
+  uint32 entity_id = 4 [(decentraland.common.bit_packed) = { bits: 20 }];
+}
+```
+
+### Annotation reference
+
+| Annotation | Target type | Parameters | Effect |
+|---|---|---|---|
+| `[(decentraland.common.quantized)]` | `uint32` | `min`, `max`, `bits` | Plugin emits a cached `float {Name}Quantized` accessor |
+| `[(decentraland.common.bit_packed)]` | `uint32` | `bits` | Documents the value range; protobuf handles varint compaction automatically |
+
+### Wire cost at worst-case (all bits set)
+
+| Quantization bits | Max value | Varint bytes | Tag (field ≤ 15) | Total per field |
+|---|---|---|---|---|
+| 8 | 255 | 2 | 1 | 3 B |
+| 12 | 4 095 | 2 | 1 | 3 B |
+| 14 | 16 383 | 2 | 1 | 3 B |
+| 16 | 65 535 | 3 | 1 | 4 B |
+| 20 | 1 048 575 | 3 | 1 | 4 B |
+
+Proto3 omits fields equal to their default value (0), so average cost is lower.
+
+## Step 2 — Run protoc
+
+```bash
+protoc \
+  --proto_path=proto \
+  --proto_path=/path/to/google/protobuf/include \
+  --csharp_out=generated/cs \
+  --plugin=protoc-gen-bitwise=protoc-gen-bitwise/plugin.py \
+  --bitwise_out=generated/cs \
+  proto/decentraland/kernel/comms/v3/comms.proto
+```
+
+The plugin emits one `*.Bitwise.cs` file (PascalCase, flat in the output
+directory) for each `.proto` file that contains at least one `[(quantized)]`
+field.
+
+## Step 3 — Copy the runtime
+
+Copy `Quantize.cs` into your project:
+
+```
+Assets/
+└── Scripts/
+    └── Networking/
+        └── Bitwise/
+            └── Quantize.cs   ← protoc-gen-bitwise/runtime/cs/Quantize.cs
+```
+
+`Quantize.cs` lives in the `Decentraland.Networking.Bitwise` namespace and
+provides two static methods used by the generated accessors:
+
+```csharp
+public static class Quantize
+{
+    public static uint  Encode(float value, float min, float max, int bits);
+    public static float Decode(uint encoded, float min, float max, int bits);
+}
+```
+
+## Step 4 — Use the generated code
+
+The plugin emits a `partial class` that adds float accessors on top of the
+standard protobuf-generated `uint32` properties:
+
+```csharp
+using Decentraland.Kernel.Comms.V3;
+
+// --- Build and send ---
+var delta = new PositionDelta();
+delta.DxQuantized = 3.14f;   // encodes to uint32, stored in delta.Dx
+delta.DyQuantized = 0f;
+delta.DzQuantized = -7.5f;
+delta.EntityId    = 42u;
+
+byte[] bytes = delta.ToByteArray();   // standard protobuf serialization
+SendOnChannel1(bytes);
+
+// --- Receive and read ---
+var received = PositionDelta.Parser.ParseFrom(receivedBytes);
+float x = received.DxQuantized;   // decoded on first access, cached thereafter
+float y = received.DyQuantized;
+float z = received.DzQuantized;
+
+// If raw uint32 fields are mutated directly after construction, invalidate the cache:
+received.ResetDecodedCache();
+```
+
+## Generated file example
+
+For the `PositionDelta` message above the plugin emits `PositionDelta.Bitwise.cs`:
+
+```csharp
+// <auto-generated>
+//   Generated by protoc-gen-bitwise. DO NOT EDIT.
+//   Source: decentraland/kernel/comms/v3/comms.proto
+// </auto-generated>
+
+using Decentraland.Networking.Bitwise;
+
+namespace Decentraland.Kernel.Comms.V3
+{
+    public partial class PositionDelta
+    {
+        private float? _dx;
+        public float DxQuantized
+        {
+            get => _dx ??= Quantize.Decode(Dx, -100.0f, 100.0f, 16);
+            set { _dx = value; Dx = Quantize.Encode(value, -100.0f, 100.0f, 16); }
+        }
+
+        private float? _dy;
+        public float DyQuantized
+        {
+            get => _dy ??= Quantize.Decode(Dy, -100.0f, 100.0f, 16);
+            set { _dy = value; Dy = Quantize.Encode(value, -100.0f, 100.0f, 16); }
+        }
+
+        private float? _dz;
+        public float DzQuantized
+        {
+            get => _dz ??= Quantize.Decode(Dz, -100.0f, 100.0f, 16);
+            set { _dz = value; Dz = Quantize.Encode(value, -100.0f, 100.0f, 16); }
+        }
+
+        /// <summary>Clears all cached decoded values. Call after mutating raw uint32 fields directly.</summary>
+        public void ResetDecodedCache()
+        {
+            _dx = null;
+            _dy = null;
+            _dz = null;
+        }
+    }
+
+} // namespace Decentraland.Kernel.Comms.V3
+```

package/out-js/about.gen.d.ts

@@ -0,0 +1 @@
+export declare const protobufPackage = "decentraland.realm";

package/out-js/about.gen.js

@@ -0,0 +1,6 @@
+"use strict";
+/* eslint-disable */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.protobufPackage = void 0;
+exports.protobufPackage = "decentraland.realm";
+//# sourceMappingURL=about.gen.js.map

package/out-js/about.gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"about.gen.js","sourceRoot":"","sources":["../out-ts/about.gen.ts"],"names":[],"mappings":";AAAA,oBAAoB;;;AAEP,QAAA,eAAe,GAAG,oBAAoB,CAAC"}

package/out-js/comms.gen.d.ts

@@ -0,0 +1 @@
+export declare const protobufPackage = "";

package/out-js/comms.gen.js

@@ -0,0 +1,6 @@
+"use strict";
+/* eslint-disable */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.protobufPackage = void 0;
+exports.protobufPackage = "";
+//# sourceMappingURL=comms.gen.js.map

package/out-js/comms.gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comms.gen.js","sourceRoot":"","sources":["../out-ts/comms.gen.ts"],"names":[],"mappings":";AAAA,oBAAoB;;;AAEP,QAAA,eAAe,GAAG,EAAE,CAAC"}

package/out-js/decentraland/common/border_rect.gen.d.ts

@@ -0,0 +1,49 @@
+import _m0 from "protobufjs/minimal";
+export declare const protobufPackage = "decentraland.common";
+/** Defines indents from respective edges */
+export interface BorderRect {
+    top: number;
+    left: number;
+    right: number;
+    bottom: number;
+}
+/** Defines a rect with x, y, width and height */
+export interface Rect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export declare namespace BorderRect {
+    function encode(message: BorderRect, writer?: _m0.Writer): _m0.Writer;
+    function decode(input: _m0.Reader | Uint8Array, length?: number): BorderRect;
+    function fromJSON(object: any): BorderRect;
+    function toJSON(message: BorderRect): unknown;
+    function create<I extends Exact<DeepPartial<BorderRect>, I>>(base?: I): BorderRect;
+    function fromPartial<I extends Exact<DeepPartial<BorderRect>, I>>(object: I): BorderRect;
+}
+export declare namespace Rect {
+    function encode(message: Rect, writer?: _m0.Writer): _m0.Writer;
+    function decode(input: _m0.Reader | Uint8Array, length?: number): Rect;
+    function fromJSON(object: any): Rect;
+    function toJSON(message: Rect): unknown;
+    function create<I extends Exact<DeepPartial<Rect>, I>>(base?: I): Rect;
+    function fromPartial<I extends Exact<DeepPartial<Rect>, I>>(object: I): Rect;
+}
+type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
+export type DeepPartial<T> = T extends Builtin ? T : T extends Array<infer U> ? Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {
+    $case: string;
+} ? {
+    [K in keyof Omit<T, "$case">]?: DeepPartial<T[K]>;
+} & {
+    $case: T["$case"];
+} : T extends {} ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : Partial<T>;
+type KeysOfUnion<T> = T extends T ? keyof T : never;
+export type Exact<P, I extends P> = P extends Builtin ? P : P & {
+    [K in keyof P]: Exact<P[K], I[K]>;
+} & {
+    [K in Exclude<keyof I, KeysOfUnion<P>>]: never;
+};
+export {};

package/out-js/decentraland/common/border_rect.gen.js

@@ -0,0 +1,201 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Rect = exports.BorderRect = exports.protobufPackage = void 0;
+/* eslint-disable */
+const minimal_1 = __importDefault(require("protobufjs/minimal"));
+exports.protobufPackage = "decentraland.common";
+function createBaseBorderRect() {
+    return { top: 0, left: 0, right: 0, bottom: 0 };
+}
+var BorderRect;
+(function (BorderRect) {
+    function encode(message, writer = minimal_1.default.Writer.create()) {
+        if (message.top !== 0) {
+            writer.uint32(13).float(message.top);
+        }
+        if (message.left !== 0) {
+            writer.uint32(21).float(message.left);
+        }
+        if (message.right !== 0) {
+            writer.uint32(29).float(message.right);
+        }
+        if (message.bottom !== 0) {
+            writer.uint32(37).float(message.bottom);
+        }
+        return writer;
+    }
+    BorderRect.encode = encode;
+    function decode(input, length) {
+        const reader = input instanceof minimal_1.default.Reader ? input : minimal_1.default.Reader.create(input);
+        let end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseBorderRect();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1:
+                    if (tag !== 13) {
+                        break;
+                    }
+                    message.top = reader.float();
+                    continue;
+                case 2:
+                    if (tag !== 21) {
+                        break;
+                    }
+                    message.left = reader.float();
+                    continue;
+                case 3:
+                    if (tag !== 29) {
+                        break;
+                    }
+                    message.right = reader.float();
+                    continue;
+                case 4:
+                    if (tag !== 37) {
+                        break;
+                    }
+                    message.bottom = reader.float();
+                    continue;
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skipType(tag & 7);
+        }
+        return message;
+    }
+    BorderRect.decode = decode;
+    function fromJSON(object) {
+        return {
+            top: isSet(object.top) ? Number(object.top) : 0,
+            left: isSet(object.left) ? Number(object.left) : 0,
+            right: isSet(object.right) ? Number(object.right) : 0,
+            bottom: isSet(object.bottom) ? Number(object.bottom) : 0,
+        };
+    }
+    BorderRect.fromJSON = fromJSON;
+    function toJSON(message) {
+        const obj = {};
+        message.top !== undefined && (obj.top = message.top);
+        message.left !== undefined && (obj.left = message.left);
+        message.right !== undefined && (obj.right = message.right);
+        message.bottom !== undefined && (obj.bottom = message.bottom);
+        return obj;
+    }
+    BorderRect.toJSON = toJSON;
+    function create(base) {
+        return BorderRect.fromPartial(base !== null && base !== void 0 ? base : {});
+    }
+    BorderRect.create = create;
+    function fromPartial(object) {
+        var _a, _b, _c, _d;
+        const message = createBaseBorderRect();
+        message.top = (_a = object.top) !== null && _a !== void 0 ? _a : 0;
+        message.left = (_b = object.left) !== null && _b !== void 0 ? _b : 0;
+        message.right = (_c = object.right) !== null && _c !== void 0 ? _c : 0;
+        message.bottom = (_d = object.bottom) !== null && _d !== void 0 ? _d : 0;
+        return message;
+    }
+    BorderRect.fromPartial = fromPartial;
+})(BorderRect || (exports.BorderRect = BorderRect = {}));
+function createBaseRect() {
+    return { x: 0, y: 0, width: 0, height: 0 };
+}
+var Rect;
+(function (Rect) {
+    function encode(message, writer = minimal_1.default.Writer.create()) {
+        if (message.x !== 0) {
+            writer.uint32(13).float(message.x);
+        }
+        if (message.y !== 0) {
+            writer.uint32(21).float(message.y);
+        }
+        if (message.width !== 0) {
+            writer.uint32(29).float(message.width);
+        }
+        if (message.height !== 0) {
+            writer.uint32(37).float(message.height);
+        }
+        return writer;
+    }
+    Rect.encode = encode;
+    function decode(input, length) {
+        const reader = input instanceof minimal_1.default.Reader ? input : minimal_1.default.Reader.create(input);
+        let end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseRect();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1:
+                    if (tag !== 13) {
+                        break;
+                    }
+                    message.x = reader.float();
+                    continue;
+                case 2:
+                    if (tag !== 21) {
+                        break;
+                    }
+                    message.y = reader.float();
+                    continue;
+                case 3:
+                    if (tag !== 29) {
+                        break;
+                    }
+                    message.width = reader.float();
+                    continue;
+                case 4:
+                    if (tag !== 37) {
+                        break;
+                    }
+                    message.height = reader.float();
+                    continue;
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skipType(tag & 7);
+        }
+        return message;
+    }
+    Rect.decode = decode;
+    function fromJSON(object) {
+        return {
+            x: isSet(object.x) ? Number(object.x) : 0,
+            y: isSet(object.y) ? Number(object.y) : 0,
+            width: isSet(object.width) ? Number(object.width) : 0,
+            height: isSet(object.height) ? Number(object.height) : 0,
+        };
+    }
+    Rect.fromJSON = fromJSON;
+    function toJSON(message) {
+        const obj = {};
+        message.x !== undefined && (obj.x = message.x);
+        message.y !== undefined && (obj.y = message.y);
+        message.width !== undefined && (obj.width = message.width);
+        message.height !== undefined && (obj.height = message.height);
+        return obj;
+    }
+    Rect.toJSON = toJSON;
+    function create(base) {
+        return Rect.fromPartial(base !== null && base !== void 0 ? base : {});
+    }
+    Rect.create = create;
+    function fromPartial(object) {
+        var _a, _b, _c, _d;
+        const message = createBaseRect();
+        message.x = (_a = object.x) !== null && _a !== void 0 ? _a : 0;
+        message.y = (_b = object.y) !== null && _b !== void 0 ? _b : 0;
+        message.width = (_c = object.width) !== null && _c !== void 0 ? _c : 0;
+        message.height = (_d = object.height) !== null && _d !== void 0 ? _d : 0;
+        return message;
+    }
+    Rect.fromPartial = fromPartial;
+})(Rect || (exports.Rect = Rect = {}));
+function isSet(value) {
+    return value !== null && value !== undefined;
+}
+//# sourceMappingURL=border_rect.gen.js.map

package/out-js/decentraland/common/border_rect.gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"border_rect.gen.js","sourceRoot":"","sources":["../../../out-ts/decentraland/common/border_rect.gen.ts"],"names":[],"mappings":"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"}

package/out-js/decentraland/common/colors.gen.d.ts

@@ -0,0 +1,59 @@
+import _m0 from "protobufjs/minimal";
+export declare const protobufPackage = "decentraland.common";
+export interface Color3 {
+    r: number;
+    g: number;
+    b: number;
+}
+export interface Color4 {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+/** A range of Color4 values. Randomized or lerped between start and end. */
+export interface ColorRange {
+    start: Color4 | undefined;
+    end: Color4 | undefined;
+}
+export declare namespace Color3 {
+    function encode(message: Color3, writer?: _m0.Writer): _m0.Writer;
+    function decode(input: _m0.Reader | Uint8Array, length?: number): Color3;
+    function fromJSON(object: any): Color3;
+    function toJSON(message: Color3): unknown;
+    function create<I extends Exact<DeepPartial<Color3>, I>>(base?: I): Color3;
+    function fromPartial<I extends Exact<DeepPartial<Color3>, I>>(object: I): Color3;
+}
+export declare namespace Color4 {
+    function encode(message: Color4, writer?: _m0.Writer): _m0.Writer;
+    function decode(input: _m0.Reader | Uint8Array, length?: number): Color4;
+    function fromJSON(object: any): Color4;
+    function toJSON(message: Color4): unknown;
+    function create<I extends Exact<DeepPartial<Color4>, I>>(base?: I): Color4;
+    function fromPartial<I extends Exact<DeepPartial<Color4>, I>>(object: I): Color4;
+}
+export declare namespace ColorRange {
+    function encode(message: ColorRange, writer?: _m0.Writer): _m0.Writer;
+    function decode(input: _m0.Reader | Uint8Array, length?: number): ColorRange;
+    function fromJSON(object: any): ColorRange;
+    function toJSON(message: ColorRange): unknown;
+    function create<I extends Exact<DeepPartial<ColorRange>, I>>(base?: I): ColorRange;
+    function fromPartial<I extends Exact<DeepPartial<ColorRange>, I>>(object: I): ColorRange;
+}
+type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
+export type DeepPartial<T> = T extends Builtin ? T : T extends Array<infer U> ? Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {
+    $case: string;
+} ? {
+    [K in keyof Omit<T, "$case">]?: DeepPartial<T[K]>;
+} & {
+    $case: T["$case"];
+} : T extends {} ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : Partial<T>;
+type KeysOfUnion<T> = T extends T ? keyof T : never;
+export type Exact<P, I extends P> = P extends Builtin ? P : P & {
+    [K in keyof P]: Exact<P[K], I[K]>;
+} & {
+    [K in Exclude<keyof I, KeysOfUnion<P>>]: never;
+};
+export {};