@fluidframework/tree 2.91.0 → 2.93.0

package/src/text/textDomainFormatted.ts

@@ -6,8 +6,13 @@
 import { assert, compareArrays, debugAssert, fail } from "@fluidframework/core-utils/internal";
 import { UsageError } from "@fluidframework/telemetry-utils/internal";
 
-import { EmptyKey, mapCursorField, type ITreeCursorSynchronous } from "../core/index.js";
-import { currentObserver } from "../feature-libraries/index.js";
+import {
+	EmptyKey,
+	forEachNodeSubsequence,
+	type FieldKey,
+	type ITreeCursorSynchronous,
+} from "../core/index.js";
+import { currentObserver, buildNodeComparator } from "../feature-libraries/index.js";
 import { TreeAlpha } from "../shared-tree/index.js";
 import {
 	enumFromStrings,
@@ -24,7 +29,7 @@ import type {
 	TreeNodeFromImplicitAllowedTypes,
 	WithType,
 } from "../simple-tree/index.js";
-import { mapIterable, validateIndex, validateIndexRange } from "../util/index.js";
+import { brand, mapIterable, validateIndex, validateIndexRange } from "../util/index.js";
 
 import { charactersFromString, type TextAsTree } from "./textDomain.js";
 
@@ -172,6 +177,12 @@ class TextNode
 			});
 		}
 	}
+	public getUniformRun(startIndex: number, endIndex?: number): number {
+		return this.content.getUniformRun(startIndex, endIndex);
+	}
+	public getString(startIndex: number, endIndex?: number): string {
+		return this.content.getString(startIndex, endIndex);
+	}
 }
 
 const defaultFormat = {
@@ -182,6 +193,8 @@ const defaultFormat = {
 	font: "Arial",
 } as const;
 
+const formatKey: FieldKey = brand("format");
+
 function textAtomsFromString(
 	value: string,
 	format: FormattedTextAsTree.CharacterFormat,
@@ -210,9 +223,10 @@ class StringArray extends sf.array("StringArray", [() => FormattedTextAsTree.Str
 		return result;
 	}
 
-	public charactersCopy(): string[] {
-		return this.withBorrowedSequenceCursor((cursor) =>
-			mapCursorField(cursor, () => {
+	private getCharactersSubarray(startIndex: number, endIndex: number): string[] {
+		return this.withBorrowedSequenceCursor((cursor) => {
+			const result: string[] = [];
+			forEachNodeSubsequence(cursor, startIndex, endIndex, () => {
 				debugAssert(
 					() =>
 						cursor.type === FormattedTextAsTree.StringAtom.identifier ||
@@ -243,14 +257,80 @@ class StringArray extends sf.array("StringArray", [() => FormattedTextAsTree.Str
 				}
 				cursor.exitNode();
 				cursor.exitField();
-				return content;
-			}),
-		);
+				result.push(content);
+			});
+			return result;
+		});
+	}
+
+	public charactersCopy(): string[] {
+		return this.getCharactersSubarray(0, this.length);
 	}
 
 	public fullString(): string {
 		return this.charactersCopy().join("");
 	}
+
+	public getString(startIndex: number, endIndex: number = this.length): string {
+		validateIndexRange(startIndex, endIndex, this, "FormattedTextAsTree.getString");
+		return this.getCharactersSubarray(startIndex, endIndex).join("");
+	}
+
+	public getUniformRun(startIndex: number, endIndex: number = this.length): number {
+		validateIndexRange(startIndex, endIndex, this, "FormattedTextAsTree.getUniformRun");
+		if (endIndex === startIndex) {
+			throw new UsageError("endIndex must be greater than startIndex for getUniformRun.");
+		}
+		const arrayLength = this.length;
+		return this.withBorrowedSequenceCursor((cursor) => {
+			cursor.enterNode(startIndex);
+
+			// Capture the content type of the first atom
+			cursor.enterField(EmptyKey);
+			cursor.enterNode(0);
+			const contentType = cursor.type;
+			cursor.exitNode();
+			cursor.exitField();
+
+			// Build a comparator from the format subtree of the first atom
+			// This compares by field key
+			cursor.enterField(formatKey);
+			cursor.enterNode(0);
+			const formatComparator = buildNodeComparator(cursor);
+			cursor.exitNode();
+			cursor.exitField();
+
+			let runLength = 1;
+			const limit = Math.min(endIndex, arrayLength) - startIndex;
+
+			while (runLength < limit && cursor.nextNode()) {
+				// Compare atom type
+				cursor.enterField(EmptyKey);
+				cursor.enterNode(0);
+				const typeMatches = cursor.type === contentType;
+				cursor.exitNode();
+				cursor.exitField();
+				if (!typeMatches) {
+					break;
+				}
+
+				// Compare format subtree using the compiled comparator
+				cursor.enterField(formatKey);
+				cursor.enterNode(0);
+				const formatMatches = formatComparator(cursor);
+				cursor.exitNode();
+				cursor.exitField();
+
+				if (formatMatches !== true) {
+					break;
+				}
+
+				runLength++;
+			}
+			cursor.exitNode();
+			return runLength;
+		});
+	}
 }
 
 /**
@@ -305,6 +385,11 @@ export namespace FormattedTextAsTree {
 		"h4",
 		"h5",
 		"li",
+		"ol",
+		"checked",
+		"unchecked",
+		"blockquote",
+		"codeBlock",
 	]);
 	/**
 	 * {@inheritdoc FormattedTextAsTree.(LineTag:variable)}
@@ -316,12 +401,16 @@ export namespace FormattedTextAsTree {
 	 * Unit in the string representing a new line character with line formatting.
 	 * @remarks
 	 * This aligns with how Quill represents line formatting.
-	 * Note that not all new lines will use this,
-	 * but only ones using this can have line specific formatting.
+	 * Quill formats line attributes (headers, list, blockquote, etc... ) on the newline character
+	 * and only lines using this atom can have line-specific formatting.
+	 * The optional indent level mirrors Quill's indent attribute,
+	 * which is applies to the line before the line break.
+	 * Any tagged line can be indented independently.
 	 * @internal
 	 */
 	export class StringLineAtom extends sf.object("StringLineAtom", {
 		tag: LineTag.schema,
+		indent: SchemaFactory.number,
 	}) {
 		public readonly content = "\n";
 	}
@@ -427,6 +516,19 @@ export namespace FormattedTextAsTree {
 			endIndex: number | undefined,
 			format: Partial<CharacterFormat>,
 		): void;
+
+		/**
+		 * Returns the length of the run of characters starting at `startIndex` which have the same formatting and atom type, up to `endIndex`.
+		 * @param startIndex - The starting index of the run.
+		 * @param endIndex - The ending index (exclusive) of the run. Defaults to the end of the text.
+		 */
+		getUniformRun(startIndex: number, endIndex?: number): number;
+		/**
+		 * Returns a substring of the text from `startIndex` to `endIndex`
+		 * @param startIndex - starting index (inclusive)
+		 * @param endIndex - Optional ending index (exclusive). Defaults to the end of the text.
+		 */
+		getString(startIndex: number, endIndex?: number): string;
 	}
 
 	/**

package/src/treeFactory.ts

@@ -16,7 +16,7 @@ import {
 } from "@fluidframework/shared-object-base/internal";
 import { UsageError } from "@fluidframework/telemetry-utils/internal";
 
-import { FluidClientVersion } from "./codec/index.js";
+import { FluidClientVersion, type FormatVersion } from "./codec/index.js";
 import {
 	SharedTreeKernel,
 	type ITreePrivate,
@@ -26,8 +26,10 @@ import {
 	type SharedTreeKernelView,
 } from "./shared-tree/index.js";
 import {
-	editManagerFormatVersionSelectorForSharedBranches,
-	messageFormatVersionSelectorForSharedBranches,
+	editManagerCodecName,
+	EditManagerFormatVersion,
+	messageCodecName,
+	MessageFormatVersion,
 } from "./shared-tree-core/index.js";
 import { SharedTreeFactoryType, SharedTreeAttributes } from "./sharedTreeAttributes.js";
 import type { ITree } from "./simple-tree/index.js";
@@ -222,6 +224,9 @@ function resolveFormatOptions(options: SharedTreeOptions): SharedTreeOptionsInte
 }
 
 const sharedBranchesOptions: SharedTreeOptionsInternal = {
-	messageFormatSelector: messageFormatVersionSelectorForSharedBranches,
-	editManagerFormatSelector: editManagerFormatVersionSelectorForSharedBranches,
+	writeVersionOverrides: new Map<string, FormatVersion>([
+		[editManagerCodecName, EditManagerFormatVersion.vSharedBranches],
+		[messageCodecName, MessageFormatVersion.vSharedBranches],
+	]),
+	allowPossiblyIncompatibleWriteVersionOverrides: true,
 };

package/src/util/index.ts

@@ -66,7 +66,6 @@ export { StackyIterator } from "./stackyIterator.js";
 export {
 	asMutable,
 	balancedReduce,
-	clone,
 	compareSets,
 	getOrAddEmptyToMap,
 	getOrCreate,

package/src/util/referenceCounting.ts

@@ -39,7 +39,6 @@ export interface ReferenceCounted {
  * Base class to assist with implementing ReferenceCounted.
  */
 export abstract class ReferenceCountedBase implements ReferenceCounted {
-	// eslint-disable-next-line @typescript-eslint/prefer-readonly -- false positive; modified in multiple places
 	protected constructor(private refCount: number = 1) {}
 
 	public referenceAdded(count = 1): void {

package/src/util/utils.ts

@@ -44,8 +44,6 @@ export function asMutable<T>(readonly: T): Mutable<T> {
 	return readonly as Mutable<T>;
 }
 
-export { default as clone } from "@ungap/structured-clone";
-
 /**
  * Checks whether or not the given object is a `readonly` array.
  *

package/.mocharc.customBenchmarks.cjs

@@ -1,25 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
- * Licensed under the MIT License.
- */
-
-/**
- * Mocha configuration file to run memory-profiling tests
- */
-"use strict";
-
-const getFluidTestMochaConfig = require("@fluid-internal/mocha-test-setup/mocharc-common");
-
-const packageDir = __dirname;
-const baseConfig = getFluidTestMochaConfig(packageDir);
-
-baseConfig["node-option"].push("gc-global");
-
-module.exports = {
-	...baseConfig,
-	"fgrep": ["@CustomBenchmark"],
-	"recursive": true,
-	"reporter": "@fluid-tools/benchmark/dist/MochaReporter.js",
-	"reporterOptions": ["reportDir=.customBenchmarksOutput/"],
-	"spec": ["lib/test/**/*.*js"],
-};

package/dist/feature-libraries/chunked-forest/codec/format.d.ts

@@ -1,383 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
- * Licensed under the MIT License.
- */
-import { type Static } from "@sinclair/typebox";
-import { type Values } from "../../../util/index.js";
-/**
- * The format version for the field batch.
- */
-export declare const FieldBatchFormatVersion: {
-    readonly v1: import("../../../util/brand.js").Brand<1, "FieldBatchFormatVersion">;
-    readonly v2: import("../../../util/brand.js").Brand<2, "FieldBatchFormatVersion">;
-};
-export type FieldBatchFormatVersion = Values<typeof FieldBatchFormatVersion>;
-export declare const validVersions: Set<import("../../../util/brand.js").Brand<1, "FieldBatchFormatVersion"> | import("../../../util/brand.js").Brand<2, "FieldBatchFormatVersion">>;
-/**
- * Top level length is implied from length of data array.
- * All content are of this shape.
- */
-export declare const EncodedNestedArrayShape: import("@sinclair/typebox").TNumber;
-/**
- * Inline array.
- */
-export declare const EncodedInlineArrayShape: import("@sinclair/typebox").TObject<{
-    length: import("@sinclair/typebox").TNumber;
-    /**
-     * All entries are this shape.
-     */
-    shape: import("@sinclair/typebox").TNumber;
-}>;
-/**
- * Encoded as `shape, ...[data for shape]`.
- *
- * Used for polymorphism.
- */
-export declare const EncodedAnyShape: import("@sinclair/typebox").TLiteral<0>;
-/**
- * Encoded content is a {@link ChunkReferenceId}.
- * This represents the shape of a chunk that is encoded separately and is referenced by its {@link ChunkReferenceId}.
- */
-export declare const EncodedIncrementalChunkShape: import("@sinclair/typebox").TLiteral<0>;
-/**
- * Content of the encoded field is specified by the Shape referenced by the ShapeIndex.
- * This is a tuple for conciseness.
- */
-export declare const EncodedFieldShape: import("@sinclair/typebox").TTuple<[import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber]>, import("@sinclair/typebox").TNumber]>;
-export type EncodedFieldShape = Static<typeof EncodedFieldShape>;
-declare enum CounterRelativeTo {
-    PreviousNodeOfType_DepthFirstPreOrder = 0
-}
-declare enum CounterMode {
-    Number = 0,
-    UUID = 1
-}
-/**
- * Delta encoded value relative to a previous node's value.
- */
-export declare const EncodedCounter: import("@sinclair/typebox").TObject<{
-    relativeTo: import("@sinclair/typebox").TEnum<typeof CounterRelativeTo>;
-    delta: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-    mode: import("@sinclair/typebox").TEnum<typeof CounterMode>;
-}>;
-/**
- * Used in {@link EncodedValueShape} for special field kind handling.
- */
-export declare enum SpecialField {
-    /**
-     * Special case for Identifier field kind.
-     */
-    Identifier = 0
-}
-/**
- * Shape of a value on a node.
- *
- * Due to limitations of TypeBox and differences between JavaScript objects, TypeScript types and JSON,
- * the case where no information about the value is captured in the shape is a bit confusing.
- * In TypeBox this is allowed by the user of this type putting it in an optional property.
- * In TypeScript it is modeled using `undefined`.
- * In JavaScript the property may be missing or explicitly `undefined`.
- * In JSON this will serialize as the property being omitted.
- * In this case, the value will be encoded as either:
- * - `false` (when there is no value) OR
- * - `true, value` when there is a value.
- *
- * For a more compact encoding, there are 4 options for the shape:
- * - `true`: there is a value, and it will simply be encoded by putting it in the output buffer (so `value`).
- * - `false`: there is never a value, and it takes up no space in the output buffer.
- * - `[value]`: there is a value, and its always the same.
- * - `SpecialField.Identifier`: special case for node identifier handling.
- * Takes up no space in the output buffer: the value comes from the shape arrays's content.
- * It is wrapped in an array to differentiate value shape types.
- *
- * In the future other value shape formats may be added, likely as objects.
- *
- * @remarks
- * See {@link EncodedNodeShape} for usage.
- */
-export declare const EncodedValueShape: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TBoolean, import("@sinclair/typebox").TArray<import("@sinclair/typebox").TAny>, import("@sinclair/typebox").TEnum<typeof SpecialField>]>;
-export type EncodedValueShape = undefined | Static<typeof EncodedValueShape>;
-export declare const EncodedNodeShape: import("@sinclair/typebox").TObject<{
-    /**
-     * If not provided, inlined in data.
-     */
-    type: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber]>>;
-    value: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TBoolean, import("@sinclair/typebox").TArray<import("@sinclair/typebox").TAny>, import("@sinclair/typebox").TEnum<typeof SpecialField>]>>;
-    /**
-     * Fields with fixed (per key) shapes.
-     * They are encoded in the order they are specified here.
-     * To ensure the order is preserved, this is an array instead of an object with keys.
-     */
-    fields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TTuple<[import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber]>, import("@sinclair/typebox").TNumber]>>>;
-    /**
-     * If undefined, no data. Otherwise, nested array of `[key, ...data]*`
-     * Covers any fields beyond those in `fields`.
-     */
-    extraFields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-}>;
-/**
- * Discriminated union that represents the shapes of chunks in the encoded data.
- * "Chunk" here refers to a chunk of tree data, rooted at a range of nodes, that is encoded as a
- * single unit in a specific format represented by one of the shapes in this union.
- *
- * The concept of "chunk" is same for the tree data in memory and in the encoded wire format.
- * The physical representation of the chunk may differ, but the logical structure remains the same.
- * This is similar to other such concepts in the system.
- *
- * See {@link DiscriminatedUnionDispatcher} for more information on this pattern.
- */
-export declare const EncodedChunkShape: import("@sinclair/typebox").TObject<{
-    /**
-     * {@link EncodedNestedArrayShape} union member.
-     */
-    a: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-    /**
-     * {@link EncodedInlineArrayShape} union member.
-     */
-    b: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
-        length: import("@sinclair/typebox").TNumber;
-        /**
-         * All entries are this shape.
-         */
-        shape: import("@sinclair/typebox").TNumber;
-    }>>;
-    /**
-     * {@link EncodedNodeShape} union member.
-     */
-    c: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
-        /**
-         * If not provided, inlined in data.
-         */
-        type: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber]>>;
-        value: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TBoolean, import("@sinclair/typebox").TArray<import("@sinclair/typebox").TAny>, import("@sinclair/typebox").TEnum<typeof SpecialField>]>>;
-        /**
-         * Fields with fixed (per key) shapes.
-         * They are encoded in the order they are specified here.
-         * To ensure the order is preserved, this is an array instead of an object with keys.
-         */
-        fields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TTuple<[import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber]>, import("@sinclair/typebox").TNumber]>>>;
-        /**
-         * If undefined, no data. Otherwise, nested array of `[key, ...data]*`
-         * Covers any fields beyond those in `fields`.
-         */
-        extraFields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-    }>>;
-    /**
-     * {@link EncodedAnyShape} union member.
-     */
-    d: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TLiteral<0>>;
-    /**
-     * {@link EncodedIncrementalChunkShape} union member.
-     */
-    e: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TLiteral<0>>;
-}>;
-export type EncodedChunkShape = Static<typeof EncodedChunkShape>;
-export type EncodedNestedArrayShape = Static<typeof EncodedNestedArrayShape>;
-export type EncodedInlineArrayShape = Static<typeof EncodedInlineArrayShape>;
-export type EncodedNodeShape = Static<typeof EncodedNodeShape>;
-export type EncodedAnyShape = Static<typeof EncodedAnyShape>;
-export type EncodedIncrementalChunkShape = Static<typeof EncodedIncrementalChunkShape>;
-export declare const EncodedFieldBatchV1: import("@sinclair/typebox").TObject<{
-    data: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TAny>>;
-    version: import("@sinclair/typebox").TIntersect<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TLiteral<FieldBatchFormatVersion>]>;
-    identifiers: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
-    shapes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-        /**
-         * {@link EncodedNestedArrayShape} union member.
-         */
-        a: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-        /**
-         * {@link EncodedInlineArrayShape} union member.
-         */
-        b: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
-            length: import("@sinclair/typebox").TNumber;
-            /**
-             * All entries are this shape.
-             */
-            shape: import("@sinclair/typebox").TNumber;
-        }>>;
-        /**
-         * {@link EncodedNodeShape} union member.
-         */
-        c: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
-            /**
-             * If not provided, inlined in data.
-             */
-            type: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber]>>;
-            value: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TBoolean, import("@sinclair/typebox").TArray<import("@sinclair/typebox").TAny>, import("@sinclair/typebox").TEnum<typeof SpecialField>]>>;
-            /**
-             * Fields with fixed (per key) shapes.
-             * They are encoded in the order they are specified here.
-             * To ensure the order is preserved, this is an array instead of an object with keys.
-             */
-            fields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TTuple<[import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber]>, import("@sinclair/typebox").TNumber]>>>;
-            /**
-             * If undefined, no data. Otherwise, nested array of `[key, ...data]*`
-             * Covers any fields beyond those in `fields`.
-             */
-            extraFields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-        }>>;
-        /**
-         * {@link EncodedAnyShape} union member.
-         */
-        d: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TLiteral<0>>;
-        /**
-         * {@link EncodedIncrementalChunkShape} union member.
-         */
-        e: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TLiteral<0>>;
-    }>>;
-}>;
-export type EncodedFieldBatchV1 = Static<typeof EncodedFieldBatchV1>;
-export declare const EncodedFieldBatchV2: import("@sinclair/typebox").TObject<{
-    data: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TAny>>;
-    version: import("@sinclair/typebox").TIntersect<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TLiteral<FieldBatchFormatVersion>]>;
-    identifiers: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
-    shapes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-        /**
-         * {@link EncodedNestedArrayShape} union member.
-         */
-        a: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-        /**
-         * {@link EncodedInlineArrayShape} union member.
-         */
-        b: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
-            length: import("@sinclair/typebox").TNumber;
-            /**
-             * All entries are this shape.
-             */
-            shape: import("@sinclair/typebox").TNumber;
-        }>>;
-        /**
-         * {@link EncodedNodeShape} union member.
-         */
-        c: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
-            /**
-             * If not provided, inlined in data.
-             */
-            type: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber]>>;
-            value: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TBoolean, import("@sinclair/typebox").TArray<import("@sinclair/typebox").TAny>, import("@sinclair/typebox").TEnum<typeof SpecialField>]>>;
-            /**
-             * Fields with fixed (per key) shapes.
-             * They are encoded in the order they are specified here.
-             * To ensure the order is preserved, this is an array instead of an object with keys.
-             */
-            fields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TTuple<[import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber]>, import("@sinclair/typebox").TNumber]>>>;
-            /**
-             * If undefined, no data. Otherwise, nested array of `[key, ...data]*`
-             * Covers any fields beyond those in `fields`.
-             */
-            extraFields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-        }>>;
-        /**
-         * {@link EncodedAnyShape} union member.
-         */
-        d: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TLiteral<0>>;
-        /**
-         * {@link EncodedIncrementalChunkShape} union member.
-         */
-        e: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TLiteral<0>>;
-    }>>;
-}>;
-export type EncodedFieldBatchV2 = Static<typeof EncodedFieldBatchV2>;
-export declare const EncodedFieldBatch: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
-    data: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TAny>>;
-    version: import("@sinclair/typebox").TIntersect<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TLiteral<FieldBatchFormatVersion>]>;
-    identifiers: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
-    shapes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-        /**
-         * {@link EncodedNestedArrayShape} union member.
-         */
-        a: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-        /**
-         * {@link EncodedInlineArrayShape} union member.
-         */
-        b: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
-            length: import("@sinclair/typebox").TNumber;
-            /**
-             * All entries are this shape.
-             */
-            shape: import("@sinclair/typebox").TNumber;
-        }>>;
-        /**
-         * {@link EncodedNodeShape} union member.
-         */
-        c: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
-            /**
-             * If not provided, inlined in data.
-             */
-            type: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber]>>;
-            value: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TBoolean, import("@sinclair/typebox").TArray<import("@sinclair/typebox").TAny>, import("@sinclair/typebox").TEnum<typeof SpecialField>]>>;
-            /**
-             * Fields with fixed (per key) shapes.
-             * They are encoded in the order they are specified here.
-             * To ensure the order is preserved, this is an array instead of an object with keys.
-             */
-            fields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TTuple<[import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber]>, import("@sinclair/typebox").TNumber]>>>;
-            /**
-             * If undefined, no data. Otherwise, nested array of `[key, ...data]*`
-             * Covers any fields beyond those in `fields`.
-             */
-            extraFields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-        }>>;
-        /**
-         * {@link EncodedAnyShape} union member.
-         */
-        d: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TLiteral<0>>;
-        /**
-         * {@link EncodedIncrementalChunkShape} union member.
-         */
-        e: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TLiteral<0>>;
-    }>>;
-}>, import("@sinclair/typebox").TObject<{
-    data: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TAny>>;
-    version: import("@sinclair/typebox").TIntersect<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TLiteral<FieldBatchFormatVersion>]>;
-    identifiers: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
-    shapes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-        /**
-         * {@link EncodedNestedArrayShape} union member.
-         */
-        a: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-        /**
-         * {@link EncodedInlineArrayShape} union member.
-         */
-        b: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
-            length: import("@sinclair/typebox").TNumber;
-            /**
-             * All entries are this shape.
-             */
-            shape: import("@sinclair/typebox").TNumber;
-        }>>;
-        /**
-         * {@link EncodedNodeShape} union member.
-         */
-        c: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
-            /**
-             * If not provided, inlined in data.
-             */
-            type: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber]>>;
-            value: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TBoolean, import("@sinclair/typebox").TArray<import("@sinclair/typebox").TAny>, import("@sinclair/typebox").TEnum<typeof SpecialField>]>>;
-            /**
-             * Fields with fixed (per key) shapes.
-             * They are encoded in the order they are specified here.
-             * To ensure the order is preserved, this is an array instead of an object with keys.
-             */
-            fields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TTuple<[import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber]>, import("@sinclair/typebox").TNumber]>>>;
-            /**
-             * If undefined, no data. Otherwise, nested array of `[key, ...data]*`
-             * Covers any fields beyond those in `fields`.
-             */
-            extraFields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-        }>>;
-        /**
-         * {@link EncodedAnyShape} union member.
-         */
-        d: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TLiteral<0>>;
-        /**
-         * {@link EncodedIncrementalChunkShape} union member.
-         */
-        e: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TLiteral<0>>;
-    }>>;
-}>]>;
-export type EncodedFieldBatch = Static<typeof EncodedFieldBatch>;
-export {};
-//# sourceMappingURL=format.d.ts.map