@ntcore-ts/client 1.0.0-beta.2

package/dist/lib/pubsub/base-topic.d.ts

@@ -0,0 +1,104 @@
+import type { NetworkTablesPrefixTopic } from './prefix-topic';
+import type { PubSubClient } from './pubsub';
+import type { NetworkTablesTopic } from './topic';
+import type { AnnounceMessageParams, NetworkTablesTypes, PropertiesMessage, SubscribeOptions, TopicProperties } from '../types/types';
+export type CallbackFn<T> = (value: T | null, params: AnnounceMessageParams) => void;
+export declare abstract class NetworkTablesBaseTopic<T> {
+    protected abstract readonly type: 'regular' | 'prefix';
+    protected client: PubSubClient;
+    private _id?;
+    private readonly _name;
+    protected _lastChangedTime?: number;
+    protected _announceParams: AnnounceMessageParams | null;
+    private _subscribers;
+    isRegular(): this is NetworkTablesTopic<NetworkTablesTypes>;
+    isPrefix(): this is NetworkTablesPrefixTopic;
+    /**
+     * Gets the ID of the topic.
+     * @returns The ID of the topic.
+     */
+    get id(): number | undefined;
+    /**
+     * Gets the name of the topic.
+     * @returns The name of the topic.
+     */
+    get name(): string;
+    /**
+     * Gets the server time of the last value change.
+     * @returns The server time of the last value change.
+     */
+    get lastChangedTime(): number | undefined;
+    /**
+     * Whether the topic has been announced.
+     * @returns Whether the topic has been announced.
+     */
+    get announced(): boolean;
+    /**
+     * Gets the subscribers to the topic.
+     * @returns The subscribers to the topic.
+     */
+    get subscribers(): Map<number, {
+        callback: CallbackFn<T>;
+        options: SubscribeOptions;
+    }>;
+    /**
+     * Creates a new topic. This should only be done after the
+     * base NTCore client has been initialized.
+     * @param client - The client that owns the topic.
+     * @param name - The name of the topic.
+     */
+    constructor(client: PubSubClient, name: string);
+    /**
+     * Marks the topic as announced. This should only be called by the PubSubClient.
+     * @param params - The parameters of the announcement.
+     */
+    announce(params: AnnounceMessageParams): void;
+    /** Marks the topic as unannounced. This should only be called by the PubSubClient. */
+    unannounce(): void;
+    /**
+     * Creates a new subscriber.
+     * @param callback - The callback to call when the topic value changes.
+     * @param options - The options for the subscriber. `id` and `save` are not part of the public API;
+     *   use {@link subscribeWithId} for reconnect internals.
+     * @returns The UID of the subscriber.
+     */
+    abstract subscribe(callback: CallbackFn<T>, options?: Omit<SubscribeOptions, 'prefix'>): number;
+    /**
+     * Creates a new subscriber, optionally reusing a subscription UID.
+     * @internal Used by resubscribeAll and tests. Not part of the public subscribe() signature.
+     * @param callback - The callback to call when the topic value changes.
+     * @param options - The options for the subscriber.
+     * @param id - The UID of the subscriber.
+     * @param save - Whether to save the subscriber.
+     * @returns The UID of the subscriber.
+     */
+    protected abstract subscribeWithId(callback: CallbackFn<T>, options?: Omit<SubscribeOptions, 'prefix'>, id?: number, save?: boolean): number;
+    /**
+     * Resubscribes all local subscribers.
+     * @param client - The client to resubscribe with.
+     */
+    abstract resubscribeAll(client: PubSubClient): void;
+    /**
+     * Removes a subscriber
+     * @param subuid - The UID of the subscriber.
+     * @param removeCallback - Whether to remove the callback. Leave this as true unless you know what you're doing.
+     */
+    unsubscribe(subuid: number, removeCallback?: boolean): void;
+    /**
+     * Removes all local subscribers.
+     */
+    unsubscribeAll(): void;
+    /**
+     * Strips client-only subscribe options (e.g. `immediateNotify`) before sending to the NT server.
+     * @param options - The subscriber options, possibly including client-only fields.
+     * @returns Protocol subscribe options.
+     */
+    protected toProtocolSubscribeOptions(options?: Omit<SubscribeOptions, 'prefix'>): Omit<SubscribeOptions, 'prefix' | 'immediateNotify'>;
+    /**
+     * Sets the properties of the topic.
+     * @param properties - Topic properties to update (e.g. `{ persistent: true, retained: true }`).
+     * @returns The server's response.
+     */
+    setProperties(properties?: TopicProperties): Promise<PropertiesMessage>;
+}
+//# sourceMappingURL=base-topic.d.ts.map

package/dist/lib/pubsub/base-topic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-topic.d.ts","sourceRoot":"","sources":["../../../src/lib/pubsub/base-topic.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EAEjB,gBAAgB,EAChB,eAAe,EAChB,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAAC;AAErF,8BAAsB,sBAAsB,CAAC,CAAC;IAC5C,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;IACvD,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC;IAC/B,OAAO,CAAC,GAAG,CAAC,CAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,SAAS,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACpC,SAAS,CAAC,eAAe,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACxD,OAAO,CAAC,YAAY,CAMlB;IAEF,SAAS,IAAI,IAAI,IAAI,kBAAkB,CAAC,kBAAkB,CAAC;IAI3D,QAAQ,IAAI,IAAI,IAAI,wBAAwB;IAI5C;;;OAGG;IACH,IAAI,EAAE,uBAEL;IAED;;;OAGG;IACH,IAAI,IAAI,WAEP;IAED;;;OAGG;IACH,IAAI,eAAe,uBAElB;IAED;;;OAGG;IACH,IAAI,SAAS,YAEZ;IAED;;;OAGG;IACH,IAAI,WAAW;kBAjDD,UAAU,CAAC,CAAC,CAAC;iBACd,gBAAgB;OAkD5B;IAED;;;;;OAKG;gBACS,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM;IAW9C;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,qBAAqB;IAMtC,sFAAsF;IACtF,UAAU;IAUV;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,GAAG,MAAM;IAE/F;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAQ,CAAC,eAAe,CAChC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,EACvB,OAAO,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,EAC1C,EAAE,CAAC,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,OAAO,GACb,MAAM;IAET;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAEnD;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,UAAO;IAWjD;;OAEG;IACH,cAAc;IAMd;;;;OAIG;IACH,SAAS,CAAC,0BAA0B,CAClC,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAM,GAC7C,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,iBAAiB,CAAC;IAUvD;;;;OAIG;IACG,aAAa,CAAC,UAAU,GAAE,eAAoB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CASlF"}

package/dist/lib/pubsub/index.d.ts

@@ -0,0 +1,6 @@
+export * from './prefix-topic';
+export * from './topic';
+export * from './struct-topic';
+export * from './protobuf-topic';
+export * from './json-topic';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/pubsub/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/pubsub/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC"}

package/dist/lib/pubsub/json-topic.d.ts

@@ -0,0 +1,50 @@
+import { NetworkTablesTopic } from './topic';
+import type { PubSubClient } from './pubsub';
+import type { z } from 'zod';
+/** Options for {@link NetworkTablesJsonTopic} and `getJsonTopic`. */
+export interface JsonTopicOptions<T extends object> {
+    validator?: z.ZodType<T>;
+}
+/**
+ * JSON topic: public value is a parsed object; wire format is a JSON string with type `'json'`.
+ */
+export declare class NetworkTablesJsonTopic<T extends object> extends NetworkTablesTopic<string, T> {
+    private decodedValue;
+    private _validator?;
+    /**
+     * Creates a new JSON topic.
+     * @param client - The client that owns the topic.
+     * @param name - The name of the topic.
+     * @param defaultValue - The default public value of the topic.
+     * @param options - Optional runtime validator for parsed JSON.
+     */
+    constructor(client: PubSubClient, name: string, defaultValue?: T, options?: JsonTopicOptions<T>);
+    /**
+     * Applies options to this topic. Used when returning a cached topic from getJsonTopic.
+     * A later defaultValue is ignored once a value exists (matches createTopic).
+     * A later `validator` replaces any previous validator because the topic is a singleton.
+     * @param options - The options to apply.
+     */
+    applyOptions(options?: {
+        defaultValue?: T;
+    } & JsonTopicOptions<T>): void;
+    private maybeValidate;
+    /**
+     * Gets the parsed JSON value of the topic.
+     * @returns The parsed JSON object, or null if no value has been set.
+     */
+    getValue(): T | null;
+    /**
+     * Sets the JSON value of the topic. The value is serialized with JSON.stringify for the wire.
+     * @param value - The object to publish.
+     */
+    setValue(value: T): void;
+    /**
+     * Updates the value of the topic from the wire JSON string.
+     * This should only be called by the PubSubClient.
+     * @param value - The wire-format JSON string.
+     * @param lastChangedTime - The server time of the last value change.
+     */
+    updateValue(value: string, lastChangedTime: number): void;
+}
+//# sourceMappingURL=json-topic.d.ts.map

package/dist/lib/pubsub/json-topic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-topic.d.ts","sourceRoot":"","sources":["../../../src/lib/pubsub/json-topic.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,qEAAqE;AACrE,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,MAAM;IAChD,SAAS,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,qBAAa,sBAAsB,CAAC,CAAC,SAAS,MAAM,CAAE,SAAQ,kBAAkB,CAAC,MAAM,EAAE,CAAC,CAAC;IACzF,OAAO,CAAC,YAAY,CAAY;IAChC,OAAO,CAAC,UAAU,CAAC,CAAe;IAElC;;;;;;OAMG;gBACS,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAQ/F;;;;;OAKG;IACH,YAAY,CAAC,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,CAAC,CAAA;KAAE,GAAG,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI;IASxE,OAAO,CAAC,aAAa;IAIrB;;;OAGG;IACM,QAAQ,IAAI,CAAC,GAAG,IAAI;IAI7B;;;OAGG;IACM,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAYjC;;;;;OAKG;IACM,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI;CAQnE"}

package/dist/lib/pubsub/prefix-topic.d.ts

@@ -0,0 +1,45 @@
+import { NetworkTablesBaseTopic } from './base-topic';
+import type { CallbackFn } from './base-topic';
+import type { PubSubClient } from './pubsub';
+import type { AnnounceMessageParams, NetworkTablesTypes, SubscribeOptions } from '../types/types';
+export declare class NetworkTablesPrefixTopic extends NetworkTablesBaseTopic<NetworkTablesTypes> {
+    readonly type = "prefix";
+    private readonly _lastSubtopicValues;
+    /**
+     * Creates a new topic. This should only be done after the
+     * base NTCore client has been initialized.
+     * @param client - The client that owns the topic.
+     * @param name - The name of the topic.
+     */
+    constructor(client: PubSubClient, name: string);
+    /** */
+    /** */
+    /**
+     * Creates a new subscriber.
+     * @param callback - The callback to call when the topic value changes.
+     * @param options - The options for the subscriber. `immediateNotify` is client-side only
+     *   and replays cached matching subtopic values (not sent to the NT server).
+     * @returns The UID of the subscriber.
+     */
+    subscribe(callback: CallbackFn<NetworkTablesTypes>, options?: Omit<SubscribeOptions, 'prefix'>): number;
+    /**
+     * Creates a new subscriber, optionally reusing a subscription UID.
+     * @internal Used by resubscribeAll. Does not honor `immediateNotify`.
+     * @param callback - The callback to call when the topic value changes.
+     * @param options - The options for the subscriber.
+     * @param id - The UID of the subscriber.
+     * @param save - Whether to save the subscriber.
+     * @returns The UID of the subscriber.
+     */
+    protected subscribeWithId(callback: CallbackFn<NetworkTablesTypes>, options?: Omit<SubscribeOptions, 'prefix'>, id?: number, save?: boolean): number;
+    resubscribeAll(client: PubSubClient): void;
+    /**
+     * Updates the value of a subtopic. Notifies all subscribers of the change.
+     * @param params - The params of the subtopic
+     * @param value - The value of the subtopic
+     * @param serverTime - The time the value was updated
+     */
+    updateValue(params: AnnounceMessageParams, value: NetworkTablesTypes | null, serverTime: number): void;
+    private notifySubscribers;
+}
+//# sourceMappingURL=prefix-topic.d.ts.map

package/dist/lib/pubsub/prefix-topic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefix-topic.d.ts","sourceRoot":"","sources":["../../../src/lib/pubsub/prefix-topic.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAElB,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAExB,qBAAa,wBAAyB,SAAQ,sBAAsB,CAAC,kBAAkB,CAAC;IACtF,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAGhC;IAEJ;;;;;OAKG;gBACS,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM;IAa9C,MAAM;IAEN,MAAM;IAEN;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,EAAE,UAAU,CAAC,kBAAkB,CAAC,EAAE,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAM;IAmBlG;;;;;;;;OAQG;IACH,SAAS,CAAC,eAAe,CACvB,QAAQ,EAAE,UAAU,CAAC,kBAAkB,CAAC,EACxC,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAM,EAC9C,EAAE,CAAC,EAAE,MAAM,EACX,IAAI,UAAO;IA0Bb,cAAc,CAAC,MAAM,EAAE,YAAY;IASnC;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,qBAAqB,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM;IAgB/F,OAAO,CAAC,iBAAiB;CA2B1B"}

package/dist/lib/pubsub/protobuf-schema-manager.d.ts

@@ -0,0 +1,96 @@
+import 'protobufjs/ext/descriptor/index.js';
+import type { PubSubClient } from './pubsub';
+/**
+ * Manages protobuf schema fetching and caching from NetworkTables.
+ * Schemas are automatically cached from `/.schema/proto:*` topics using a prefix subscription.
+ */
+export declare class ProtobufSchemaManager {
+    private readonly schemaCache;
+    private readonly registeredSchemas;
+    private readonly schemaPrefixTopic;
+    private readonly client;
+    private fileDescriptorProtoType;
+    constructor(client: PubSubClient);
+    /**
+     * Handles schema updates from the prefix topic subscription.
+     * Automatically decodes and caches all schema files that arrive.
+     * @param value - The value of the schema update (null when a topic is unannounced).
+     * @param params - The parameters of the announce message.
+     */
+    private handleSchemaUpdate;
+    /**
+     * Fetches a protobuf message type from the cache.
+     * Searches all loaded schemas in the cache to find one containing the requested message type.
+     * Returns null if the schema is not yet in cache (e.g. topic announced before schema topic arrived).
+     * @param messageName - The name of the protobuf message type (e.g., "frc.Pose2d").
+     * @returns The protobufjs Type, or null if not found in cache.
+     */
+    fetchMessageType(messageName: string): protobuf.Type | null;
+    /**
+     * Clears the schema cache.
+     */
+    clearCache(): void;
+    /**
+     * Gets the message name from a protobuf root.
+     * Auto-detects the first message type in the proto file.
+     * @param root - The protobuf root containing the schema.
+     * @returns The message name in format "package.MessageName" or "MessageName" if no package (no leading dot).
+     */
+    getMessageNameFromProto(root: protobuf.Namespace): string;
+    /**
+     * Recursively finds the first message type in a namespace.
+     * @param namespace - The namespace to search.
+     * @returns The first message type found, or null.
+     */
+    private findFirstMessage;
+    /**
+     * Registers a protobuf schema by loading a proto file and publishing it to NetworkTables.
+     * Node.js only — uses the filesystem. In the browser, use {@link registerSchemaFromSource} or
+     * {@link registerSchemaFromType} instead.
+     * @param protoFilePath - Path to the .proto file.
+     * @param messageName - Optional message name to use. If not provided, auto-detected from proto file.
+     * @returns A promise that resolves to the message name and schema root.
+     * @throws {Error} If called in a browser, or if the proto file cannot be loaded or schema cannot be registered.
+     */
+    registerSchema(protoFilePath: string, messageName?: string): Promise<{
+        messageName: string;
+        root: protobuf.Namespace;
+    }>;
+    /**
+     * Parses a `.proto` source string without publishing (no filesystem).
+     * @param protoSource - The contents of a .proto file.
+     * @returns The detected message name and resolved root.
+     */
+    parseSource(protoSource: string): {
+        messageName: string;
+        root: protobuf.Root;
+    };
+    registerSchemaFromSource(protoSource: string, filename?: string, messageName?: string): Promise<{
+        messageName: string;
+        root: protobuf.Namespace;
+    }>;
+    /**
+     * Registers a protobuf schema from a prebuilt protobufjs Type (no filesystem). Safe in the browser.
+     * @param messageType - A protobufjs Type used for encode/decode.
+     * @param filename - Optional filename used for the schema topic (defaults to the message name).
+     * @returns A promise that resolves to the message name and schema root.
+     */
+    registerSchemaFromType(messageType: protobuf.Type, filename?: string): Promise<{
+        messageName: string;
+        root: protobuf.Namespace;
+    }>;
+    /**
+     * Loads a root then publishes it, sharing in-flight protection by schema topic name.
+     */
+    private registerRootFromLoader;
+    /**
+     * Publishes an already-parsed root, sharing in-flight protection by schema topic name.
+     */
+    private publishRoot;
+    /**
+     * Encodes a FileDescriptorProto from a root, publishes the schema topic, and caches it.
+     * Must be called inside an in-flight operation.
+     */
+    private publishLoadedRoot;
+}
+//# sourceMappingURL=protobuf-schema-manager.d.ts.map

package/dist/lib/pubsub/protobuf-schema-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protobuf-schema-manager.d.ts","sourceRoot":"","sources":["../../../src/lib/pubsub/protobuf-schema-manager.ts"],"names":[],"mappings":"AAEA,OAAO,oCAAoC,CAAC;AAkB5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAgB7C;;;GAGG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8C;IAC1E,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA0B;IAC5D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA2B;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,uBAAuB,CAE7B;gBAEU,MAAM,EAAE,YAAY;IAWhC;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IA2B1B;;;;;;OAMG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,IAAI,GAAG,IAAI;IAc3D;;OAEG;IACH,UAAU;IAIV;;;;;OAKG;IACH,uBAAuB,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,GAAG,MAAM;IA4BzD;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAexB;;;;;;;;OAQG;IACG,cAAc,CAClB,aAAa,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAA;KAAE,CAAC;IAqB7D;;;;OAIG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAA;KAAE;IAaxE,wBAAwB,CAC5B,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAA;KAAE,CAAC;IAO7D;;;;;OAKG;IACG,sBAAsB,CAC1B,WAAW,EAAE,QAAQ,CAAC,IAAI,EAC1B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAA;KAAE,CAAC;IAO7D;;OAEG;YACW,sBAAsB;IAsBpC;;OAEG;YACW,WAAW;IAoBzB;;;OAGG;YACW,iBAAiB;CAgDhC"}

package/dist/lib/pubsub/protobuf-topic.d.ts

@@ -0,0 +1,126 @@
+import { type AnnounceMessage, type AnnounceMessageParams, type TopicProperties } from '../types/types';
+import { NetworkTablesTopic } from './topic';
+import type { PubSubClient } from './pubsub';
+import type { Type } from 'protobufjs';
+import type { z } from 'zod';
+/** Options for creating a protobuf topic. */
+export interface ProtobufTopicOptions<T extends object> {
+    defaultValue?: T;
+    validator?: z.ZodType<T>;
+    /** Path to a .proto file. Node.js only (uses the filesystem). */
+    protoFilePath?: string;
+    /** Contents of a .proto file. Parsed in-memory; safe in the browser. */
+    protoSource?: string;
+    /** Prebuilt protobufjs Type. Safe in the browser. */
+    messageType?: Type;
+}
+export declare class NetworkTablesProtobufTopic<T extends object> extends NetworkTablesTopic<Uint8Array<ArrayBufferLike>, T> {
+    private decodedValue;
+    private _protobufMessageName?;
+    private _protobufMessageType;
+    private _validator?;
+    private _protoFilePath?;
+    private _protoSource?;
+    private _providedMessageType?;
+    private _messageTypeString?;
+    private _schemaRegistered;
+    /** Stored error when constructor's fire-and-forget loadProtoSchema fails; re-thrown by ensureMessageType. */
+    private _schemaLoadError;
+    /**
+     * Creates a new topic. This should only be done after the
+     * base NTCore client has been initialized.
+     * @param client - The client that owns the topic.
+     * @param name - The name of the topic.
+     * @param options - The options for the topic.
+     * @param options.defaultValue
+     * @param options.validator
+     * @param options.protoFilePath - Node.js only. Use protoSource or messageType in the browser.
+     * @param options.protoSource - In-memory .proto text. Safe in the browser.
+     * @param options.messageType - Prebuilt protobufjs Type. Safe in the browser.
+     */
+    constructor(client: PubSubClient, name: string, options?: ProtobufTopicOptions<T>);
+    /**
+     * Applies options to an existing protobuf topic.
+     * Used when returning a cached topic from getProtobufTopic so the returned
+     * instance has the requested validator, protoFilePath, and defaultValue.
+     * A later `validator` replaces any previous validator because the topic is a singleton.
+     * @param options - The options to apply.
+     */
+    applyOptions(options?: ProtobufTopicOptions<T>): void;
+    private normalizeMessageName;
+    private assertMessageTypeUnchanged;
+    /**
+     * Gets the value of the topic.
+     * @returns The value of the topic.
+     */
+    getValue(): T | null;
+    setValue(value: T): void;
+    /**
+     * Ensures the protobuf message type is available, fetching it if necessary.
+     * @returns The protobuf message type.
+     * @throws {Error} If schema loading failed in the constructor (protoFilePath), re-throws that error.
+     * @throws {Error} If the protobuf message type cannot be found in the schema cache.
+     */
+    private ensureMessageType;
+    /**
+     * Decodes a protobuf-encoded value to a typed object.
+     * @param value - The protobuf-encoded Uint8Array value.
+     * @returns The decoded protobuf object.
+     * @throws {Error} If the protobuf message type is not found in the schema cache.
+     *                  This can occur if decoding is attempted before the schema has been
+     *                  fetched from NetworkTables (e.g., value update arrives before
+     *                  announcement is processed or schema topic is received).
+     */
+    private decodeValue;
+    /**
+     * Encodes a typed object to a protobuf-encoded Uint8Array.
+     * @param value - The typed object to encode.
+     * @returns The protobuf-encoded Uint8Array.
+     * @throws {Error} If the protobuf message type is not found in the schema cache.
+     *                  This can occur if encoding is attempted before the schema has been
+     *                  loaded (e.g., setValue called before protoFilePath schema is loaded
+     *                  or before the topic announcement provides the message type).
+     */
+    private encodeValue;
+    /**
+     * Updates the value of the topic.
+     * This should only be called by the PubSubClient.
+     * @param value - The value to update.
+     * @param lastChangedTime - The server time of the last value change.
+     */
+    updateValue(value: Uint8Array<ArrayBufferLike>, lastChangedTime: number): void;
+    /**
+     * Marks the topic as announced. This should only be called by the PubSubClient.
+     * @param params - The parameters of the announcement.
+     */
+    announce(params: AnnounceMessageParams): void;
+    /**
+     * Fetches the protobuf schema for this topic.
+     * @param messageName - The protobuf message name.
+     */
+    private fetchProtobufSchema;
+    /**
+     * Loads a proto schema from a file path (Node.js only).
+     * @param protoFilePath - Path to the .proto file.
+     */
+    private loadProtoSchema;
+    /**
+     * Loads a proto schema from an in-memory source string.
+     * @param protoSource - Contents of a .proto file.
+     */
+    private loadProtoSource;
+    /**
+     * Applies a prebuilt protobufjs Type for encode/decode.
+     * @param messageType - The protobufjs Type.
+     */
+    private applyMessageType;
+    /**
+     * Publishes the topic.
+     * If a proto file path was provided, registers the schema first.
+     * @param properties - The properties to publish the topic with.
+     * @param id - The UID of the publisher. You must verify that the ID is not already in use.
+     * @returns A promise that resolves when the topic is published.
+     */
+    publish(properties?: TopicProperties, id?: number): Promise<AnnounceMessage | void>;
+}
+//# sourceMappingURL=protobuf-topic.d.ts.map

package/dist/lib/pubsub/protobuf-topic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protobuf-topic.d.ts","sourceRoot":"","sources":["../../../src/lib/pubsub/protobuf-topic.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAE1B,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,6CAA6C;AAC7C,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,MAAM;IACpD,YAAY,CAAC,EAAE,CAAC,CAAC;IACjB,SAAS,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACzB,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB;AAED,qBAAa,0BAA0B,CAAC,CAAC,SAAS,MAAM,CAAE,SAAQ,kBAAkB,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IAElH,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,oBAAoB,CAAC,CAAS;IACtC,OAAO,CAAC,oBAAoB,CAAqB;IACjD,OAAO,CAAC,UAAU,CAAC,CAAe;IAClC,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,oBAAoB,CAAC,CAAO;IACpC,OAAO,CAAC,kBAAkB,CAAC,CAAS;IACpC,OAAO,CAAC,iBAAiB,CAAS;IAClC,6GAA6G;IAC7G,OAAO,CAAC,gBAAgB,CAAsB;IAE9C;;;;;;;;;;;OAWG;gBACS,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC;IA4CjF;;;;;;OAMG;IACH,YAAY,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,IAAI;IAiDrD,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,0BAA0B;IAQlC;;;OAGG;IACM,QAAQ,IAAI,CAAC,GAAG,IAAI;IAIpB,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAajC;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAgBzB;;;;;;;;OAQG;IACH,OAAO,CAAC,WAAW;IAcnB;;;;;;;;OAQG;IACH,OAAO,CAAC,WAAW;IAMnB;;;;;OAKG;IACM,WAAW,CAAC,KAAK,EAAE,UAAU,CAAC,eAAe,CAAC,EAAE,eAAe,EAAE,MAAM;IAShF;;;OAGG;IACM,QAAQ,CAAC,MAAM,EAAE,qBAAqB;IA2B/C;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;;OAGG;YACW,eAAe;IAgB7B;;;OAGG;YACW,eAAe;IAY7B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;;;;;OAMG;IACY,OAAO,CAAC,UAAU,GAAE,eAAoB,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;CAkDvG"}

package/dist/lib/pubsub/pubsub.d.ts

@@ -0,0 +1,134 @@
+import { Messenger } from '../socket/messenger';
+import { type AnnounceMessageParams, type NetworkTablesTypes } from '../types/types';
+import { ProtobufSchemaManager } from './protobuf-schema-manager';
+import { StructSchemaManager } from '../struct/struct-schema-manager';
+import type { NetworkTablesBaseTopic } from './base-topic';
+import type { NetworkTablesPrefixTopic } from './prefix-topic';
+import type { NetworkTablesTopic } from './topic';
+/** The client for the PubSub protocol. */
+export declare class PubSubClient {
+    private readonly _messenger;
+    private readonly topics;
+    private readonly prefixTopics;
+    private readonly knownTopicParams;
+    /** Value updates that arrived before the topic announcement (topicId -> latest message). Flushed when announce arrives. */
+    private readonly pendingValueUpdates;
+    private readonly _protobufSchemaManager;
+    private readonly _structSchemaManager;
+    private static _instances;
+    private readonly inFlightOperations;
+    private _isCleaningUp;
+    private readonly beforeUnloadHandler;
+    get messenger(): Messenger;
+    get protobufSchemaManager(): ProtobufSchemaManager;
+    get structSchemaManager(): StructSchemaManager;
+    private constructor();
+    /**
+     * Gets the instance of the NetworkTables client.
+     * @param serverUrl - The URL of the server to connect to. This is not used after the first call.
+     * @returns The instance of the NetworkTables client.
+     */
+    static getInstance(serverUrl: string): PubSubClient;
+    /**
+     * Reinstantiates the client by resubscribing to all previously subscribed topics
+     * and republishing for all previously published topics.
+     * @param url - The URL of the server to connect to.
+     */
+    reinstantiate(url: string): void;
+    /**
+     * Registers a topic with this PubSubClient.
+     * @param topic - The topic to register
+     */
+    registerTopic<T>(topic: NetworkTablesBaseTopic<T>): void;
+    /**
+     * Called by the messenger when a topic is updated.
+     * @param message - The message data.
+     */
+    private onTopicUpdate;
+    /**
+     * Called by the messenger when a topic is announced.
+     * @param params - The announce message parameters.
+     */
+    private onTopicAnnounce;
+    /**
+     * Delivers a value update to the regular topic (if any) and all matching prefix topics.
+     */
+    private _deliverValueUpdate;
+    /**
+     * Called by the messenger when a topic is unannounced.
+     * @param params - The unannounce message parameters.
+     */
+    private onTopicUnannounce;
+    /**
+     * Called by the messenger when a topic's properties are updated.
+     * @param params - The properties message parameters.
+     */
+    private onTopicProperties;
+    /**
+     * Updates the value of a topic on the server.
+     * @param topic - The topic to update.
+     * @param value - The new value (wire format) to send.
+     */
+    updateServer<TWire extends NetworkTablesTypes, TPublic = TWire>(topic: NetworkTablesTopic<TWire, TPublic>, value: TWire): void;
+    /**
+     * Notifies all prefix topics that match the given topic name of a local value update.
+     * Called when a regular/protobuf topic's setValue() runs so prefix subscribers (e.g. "all topics" table) see locally published values.
+     */
+    notifyPrefixTopicsForLocalUpdate(params: AnnounceMessageParams, value: NetworkTablesTypes): void;
+    /**
+     * Gets the topic with the given ID.
+     * @param topicId - The ID of the topic to get.
+     * @returns The topic with the given ID, or null if no topic with that ID exists.
+     */
+    private getTopicFromId;
+    /**
+     * Gets the topic with the given name.
+     * @param topicName - The name of the topic to get.
+     * @returns The topic with the given name, or null if no topic with that name exists.
+     */
+    getTopicFromName<T extends NetworkTablesTypes>(topicName: string): NetworkTablesTopic<T> | null;
+    /**
+     * Gets the topic with the given name.
+     * @param topicName - The name of the topic to get.
+     * @returns The topic with the given name, or null if no topic with that name exists.
+     */
+    getPrefixTopicFromName(topicName: string): NetworkTablesPrefixTopic | null;
+    /**
+     * Gets the known announcement parameters for a topic.
+     * @param id - The ID of the topic.
+     * @returns The known announcement parameters for the topic, or undefined if the topic is not known.
+     */
+    getKnownTopicParams(id: number): {
+        name: string;
+        id: number;
+        type: string;
+        properties: {
+            persistent?: boolean | undefined;
+            retained?: boolean | undefined;
+            cached?: boolean | undefined;
+        };
+        pubuid?: number | undefined;
+    } | undefined;
+    /**
+     * Gets or creates an in-flight operation to prevent race conditions.
+     * If an operation with the same key is already in progress, returns the existing promise.
+     * Otherwise, creates a new operation and stores it.
+     * @param key - Unique key for the operation (e.g., "schema:/.schema/proto:filename" or "publish:/topic/name")
+     * @param operation - The async operation to execute
+     * @returns A promise that resolves to the operation result
+     * @throws Error if the client is cleaning up and no existing operation is found
+     */
+    getOrCreateInFlightOperation<T>(key: string, operation: () => Promise<T>): Promise<T>;
+    /**
+     * Cleans up the client by unsubscribing from all topics and stopping publishing for all topics.
+     * Prevents new in-flight operations from starting, but allows existing ones to complete naturally.
+     * The socket is closed immediately, which will cause any in-flight operations to fail.
+     */
+    cleanup(): void;
+    /**
+     * Removes this client, its messenger, and its socket from their singleton maps.
+     * Call after {@link cleanup} so a later getInstance creates a fresh client.
+     */
+    releaseInstance(): void;
+}
+//# sourceMappingURL=pubsub.d.ts.map

package/dist/lib/pubsub/pubsub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pubsub.d.ts","sourceRoot":"","sources":["../../../src/lib/pubsub/pubsub.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAEL,KAAK,qBAAqB,EAE1B,KAAK,kBAAkB,EAGxB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAEtE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,0CAA0C;AAC1C,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAY;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsD;IAC7E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwC;IAErE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqC;IACtE,2HAA2H;IAC3H,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAiC;IACrE,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAwB;IAC/D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAsB;IAC3D,OAAO,CAAC,MAAM,CAAC,UAAU,CAAmC;IAE5D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAuC;IAC1E,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAElC;IAEF,IAAI,SAAS,cAEZ;IAED,IAAI,qBAAqB,0BAExB;IAED,IAAI,mBAAmB,wBAEtB;IAED,OAAO;IAsEP;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;IAUnD;;;;OAIG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM;IA6CzB;;;OAGG;IACH,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,sBAAsB,CAAC,CAAC,CAAC;IAoBjD;;;OAGG;IACH,OAAO,CAAC,aAAa,CAkEnB;IAEF;;;OAGG;IACH,OAAO,CAAC,eAAe,CAoCrB;IAEF;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA8B3B;;;OAGG;IACH,OAAO,CAAC,iBAAiB,CAyBvB;IAEF;;;OAGG;IACH,OAAO,CAAC,iBAAiB,CASvB;IAEF;;;;OAIG;IACH,YAAY,CAAC,KAAK,SAAS,kBAAkB,EAAE,OAAO,GAAG,KAAK,EAC5D,KAAK,EAAE,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,EACzC,KAAK,EAAE,KAAK,GACX,IAAI;IAIP;;;OAGG;IACH,gCAAgC,CAAC,MAAM,EAAE,qBAAqB,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAiBhG;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAYtB;;;;OAIG;IACH,gBAAgB,CAAC,CAAC,SAAS,kBAAkB,EAAE,SAAS,EAAE,MAAM,GAAG,kBAAkB,CAAC,CAAC,CAAC,GAAG,IAAI;IAU/F;;;;OAIG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM;IAIxC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,EAAE,MAAM;;;;;;;;;;;IAU9B;;;;;;;;OAQG;IACH,4BAA4B,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA6BrF;;;;OAIG;IACH,OAAO;IAmCP;;;OAGG;IACH,eAAe,IAAI,IAAI;CAQxB"}

package/dist/lib/pubsub/struct-topic.d.ts

@@ -0,0 +1,40 @@
+import { type AnnounceMessage, type AnnounceMessageParams, type TopicProperties } from '../types/types';
+import { NetworkTablesTopic } from './topic';
+import type { PubSubClient } from './pubsub';
+import type { z } from 'zod';
+export declare class NetworkTablesStructTopic<T extends object | object[]> extends NetworkTablesTopic<Uint8Array, T> {
+    private decodedValue;
+    private _typeName;
+    private _isArray;
+    private _validator?;
+    private _descriptor;
+    /** When schema option build fails (e.g. nested not yet available), store and retry in ensureDescriptor. */
+    private _pendingSchema;
+    constructor(client: PubSubClient, name: string, options?: {
+        typeName?: string;
+        schema?: string;
+        defaultValue?: T;
+        validator?: z.ZodType<T>;
+    });
+    /**
+     * Applies options to this topic. Used when returning a cached topic from getStructTopic.
+     * A later `validator` replaces any previous validator because the topic is a singleton.
+     * @param options - The options to apply.
+     */
+    applyOptions(options?: {
+        typeName?: string;
+        schema?: string;
+        defaultValue?: T;
+        validator?: z.ZodType<T>;
+    }): void;
+    private ensureDescriptor;
+    private maybeValidate;
+    getValue(): T | null;
+    setValue(value: T): void;
+    private decodeValue;
+    private encodeValue;
+    updateValue(value: Uint8Array, lastChangedTime: number): void;
+    announce(params: AnnounceMessageParams): void;
+    publish(properties?: TopicProperties, id?: number): Promise<AnnounceMessage | void>;
+}
+//# sourceMappingURL=struct-topic.d.ts.map

package/dist/lib/pubsub/struct-topic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"struct-topic.d.ts","sourceRoot":"","sources":["../../../src/lib/pubsub/struct-topic.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAE1B,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAU7B,qBAAa,wBAAwB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,CAAE,SAAQ,kBAAkB,CAAC,UAAU,EAAE,CAAC,CAAC;IAC1G,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,UAAU,CAAC,CAAe;IAClC,OAAO,CAAC,WAAW,CAAiC;IACpD,2GAA2G;IAC3G,OAAO,CAAC,cAAc,CAAuB;gBAG3C,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,CAAC,CAAC;QACjB,SAAS,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;KAC1B;IA2BH;;;;OAIG;IACH,YAAY,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAAC,SAAS,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;KAAE,GAAG,IAAI;IA6BhH,OAAO,CAAC,gBAAgB;IAyBxB,OAAO,CAAC,aAAa;IAIZ,QAAQ,IAAI,CAAC,GAAG,IAAI;IAIpB,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAYjC,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,WAAW;IAmBV,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI;IAK7D,QAAQ,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI;IAWvC,OAAO,CAAC,UAAU,GAAE,eAAoB,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;CAkBvG"}