@getodk/xforms-engine 0.6.0 → 0.8.0

package/src/instance/abstract/UnsupportedControl.ts

@@ -1,175 +0,0 @@
-import { identity } from '@getodk/common/lib/identity.ts';
-import { XPathNodeKindKey } from '@getodk/xpath';
-import type { Accessor } from 'solid-js';
-import type { UnsupportedControlNodeType } from '../../client/node-types.ts';
-import type { SubmissionState } from '../../client/submission/SubmissionState.ts';
-import type { TextRange } from '../../client/TextRange.ts';
-import type {
-	UnsupportedControlDefinition,
-	UnsupportedControlElementDefinition,
-	UnsupportedControlNode,
-} from '../../client/unsupported/UnsupportedControlNode.ts';
-import type { AnyViolation, LeafNodeValidationState } from '../../client/validation.ts';
-import type { XFormsXPathElement } from '../../integration/xpath/adapter/XFormsXPathNode.ts';
-import { createLeafNodeSubmissionState } from '../../lib/client-reactivity/submission/createLeafNodeSubmissionState.ts';
-import { createValueState } from '../../lib/reactivity/createValueState.ts';
-import type { CurrentState } from '../../lib/reactivity/node-state/createCurrentState.ts';
-import type { EngineState } from '../../lib/reactivity/node-state/createEngineState.ts';
-import {
-	createSharedNodeState,
-	type SharedNodeState,
-} from '../../lib/reactivity/node-state/createSharedNodeState.ts';
-import { createFieldHint } from '../../lib/reactivity/text/createFieldHint.ts';
-import { createNodeLabel } from '../../lib/reactivity/text/createNodeLabel.ts';
-import type { SimpleAtomicState } from '../../lib/reactivity/types.ts';
-import {
-	createValidationState,
-	type SharedValidationState,
-} from '../../lib/reactivity/validation/createValidation.ts';
-import type { UnknownAppearanceDefinition } from '../../parse/body/appearance/unknownAppearanceParser.ts';
-import type { AnyUnsupportedControl, GeneralParentNode } from '../hierarchy.ts';
-import type { EvaluationContext } from '../internal-api/EvaluationContext.ts';
-import type { ClientReactiveSubmittableLeafNode } from '../internal-api/submission/ClientReactiveSubmittableLeafNode.ts';
-import type { ValidationContext } from '../internal-api/ValidationContext.ts';
-import type { ValueContext } from '../internal-api/ValueContext.ts';
-import { DescendantNode, type DescendantNodeStateSpec } from './DescendantNode.ts';
-
-type TypedUnsupportedControlElementDefinition<Type extends UnsupportedControlNodeType> = Extract<
-	UnsupportedControlElementDefinition,
-	{ readonly type: Type }
->;
-
-interface TypedUnsupportedControlDefinition<Type extends UnsupportedControlNodeType>
-	extends UnsupportedControlDefinition {
-	readonly bodyElement: TypedUnsupportedControlElementDefinition<Type>;
-}
-
-interface UnsupportedControlStateSpec extends DescendantNodeStateSpec<unknown> {
-	readonly label: Accessor<TextRange<'label'> | null>;
-	readonly hint: Accessor<TextRange<'hint'> | null>;
-	readonly children: null;
-	readonly value: SimpleAtomicState<unknown>;
-	readonly valueOptions: never;
-}
-
-class UnsupportedControlValueEncodeError extends Error {
-	constructor(type: UnsupportedControlNodeType) {
-		super(`Cannot encode state for node (type: ${type}) - not implemented`);
-	}
-}
-
-class UnsupportedControlWriteError extends Error {
-	constructor(type: UnsupportedControlNodeType) {
-		super(`Cannot write state for node (type: ${type}) - not implemented`);
-	}
-}
-
-export abstract class UnsupportedControl<Type extends UnsupportedControlNodeType>
-	extends DescendantNode<
-		TypedUnsupportedControlDefinition<Type>,
-		UnsupportedControlStateSpec,
-		GeneralParentNode,
-		null
-	>
-	implements
-		UnsupportedControlNode,
-		XFormsXPathElement,
-		EvaluationContext,
-		ValidationContext,
-		ValueContext<unknown>,
-		ClientReactiveSubmittableLeafNode<unknown>
-{
-	private readonly validation: SharedValidationState;
-	protected readonly state: SharedNodeState<UnsupportedControlStateSpec>;
-
-	// XFormsXPathElement
-	override readonly [XPathNodeKindKey] = 'element';
-
-	// InstanceNode
-	protected readonly engineState: EngineState<UnsupportedControlStateSpec>;
-
-	// UnsupportedControlNode
-	abstract override readonly nodeType: Type;
-
-	readonly appearances: UnknownAppearanceDefinition;
-	readonly nodeOptions = null;
-	readonly currentState: CurrentState<UnsupportedControlStateSpec>;
-
-	get validationState(): LeafNodeValidationState {
-		return this.validation.currentState;
-	}
-
-	readonly submissionState: SubmissionState;
-
-	// ValueContext
-	abstract override readonly contextNode: AnyUnsupportedControl & this;
-
-	readonly encodeValue = (instanceValue: unknown): string => {
-		const encoded = instanceValue;
-
-		if (typeof encoded === 'string') {
-			return encoded;
-		}
-
-		throw new UnsupportedControlValueEncodeError(this.nodeType);
-	};
-
-	readonly decodeValue = (instanceValue: unknown): unknown => {
-		return identity(instanceValue);
-	};
-
-	constructor(parent: GeneralParentNode, definition: TypedUnsupportedControlDefinition<Type>) {
-		super(parent, definition);
-
-		this.appearances = definition.bodyElement.appearances;
-
-		const sharedStateOptions = {
-			clientStateFactory: this.engineConfig.stateFactory,
-		};
-
-		const stateSpec: UnsupportedControlStateSpec = {
-			reference: this.contextReference,
-			readonly: this.isReadonly,
-			relevant: this.isRelevant,
-			required: this.isRequired,
-
-			label: createNodeLabel(this, definition),
-			hint: createFieldHint(this, definition),
-			children: null,
-			valueOptions: null as never,
-			value: createValueState<unknown>(this),
-		};
-
-		const state = createSharedNodeState(this.scope, stateSpec, sharedStateOptions);
-
-		this.state = state;
-		this.engineState = state.engineState;
-		this.currentState = state.currentState;
-		this.validation = createValidationState(this, sharedStateOptions);
-		this.submissionState = createLeafNodeSubmissionState(this);
-	}
-
-	// XFormsXPathElement
-	override getXPathValue(): string {
-		return this.encodeValue(this.engineState.value);
-	}
-
-	// ValidationContext
-	getViolation(): AnyViolation | null {
-		return this.validation.engineState.violation;
-	}
-
-	isBlank(): boolean {
-		return this.engineState.value === '';
-	}
-
-	// InstanceNode
-	getChildren(): readonly [] {
-		return [];
-	}
-
-	// UnsupportedControlNode
-	setValue(_: never): never {
-		throw new UnsupportedControlWriteError(this.nodeType);
-	}
-}

package/src/instance/index.ts

@@ -1,55 +0,0 @@
-import { identity } from '@getodk/common/lib/identity.ts';
-import { getOwner } from 'solid-js';
-import type { EngineConfig } from '../client/EngineConfig.ts';
-import type { RootNode } from '../client/RootNode.ts';
-import { MISSING_RESOURCE_BEHAVIOR } from '../client/constants.ts';
-import type {
-	InitializeFormOptions as BaseInitializeFormOptions,
-	FormResource,
-	InitializeForm,
-} from '../client/index.ts';
-import { retrieveSourceXMLResource } from '../instance/resource.ts';
-import { createReactiveScope } from '../lib/reactivity/scope.ts';
-import { createUniqueId } from '../lib/unique-id.ts';
-import { XFormDOM } from '../parse/XFormDOM.ts';
-import { XFormDefinition } from '../parse/XFormDefinition.ts';
-import { SecondaryInstancesDefinition } from '../parse/model/SecondaryInstance/SecondaryInstancesDefinition.ts';
-import { PrimaryInstance } from './PrimaryInstance.ts';
-import type { InstanceConfig } from './internal-api/InstanceConfig.ts';
-
-interface InitializeFormOptions extends BaseInitializeFormOptions {
-	readonly config: Partial<InstanceConfig>;
-}
-
-const buildInstanceConfig = (options: EngineConfig = {}): InstanceConfig => {
-	return {
-		createUniqueId,
-		fetchFormDefinition: options.fetchFormDefinition ?? fetch,
-		fetchFormAttachment: options.fetchFormAttachment ?? fetch,
-		missingResourceBehavior: options.missingResourceBehavior ?? MISSING_RESOURCE_BEHAVIOR.DEFAULT,
-		stateFactory: options.stateFactory ?? identity,
-	};
-};
-
-export const initializeForm = async (
-	input: FormResource,
-	options: Partial<InitializeFormOptions> = {}
-): Promise<RootNode> => {
-	const owner = getOwner();
-	const scope = createReactiveScope({ owner });
-	const engineConfig = buildInstanceConfig(options.config);
-	const sourceXML = await retrieveSourceXMLResource(input, {
-		fetchResource: engineConfig.fetchFormDefinition,
-	});
-	const xformDOM = XFormDOM.from(sourceXML);
-	const secondaryInstances = await SecondaryInstancesDefinition.load(xformDOM, {
-		fetchResource: engineConfig.fetchFormAttachment,
-		missingResourceBehavior: engineConfig.missingResourceBehavior,
-	});
-	const form = new XFormDefinition(xformDOM);
-	const primaryInstance = new PrimaryInstance(scope, form.model, secondaryInstances, engineConfig);
-
-	return primaryInstance.root;
-};
-
-initializeForm satisfies InitializeForm;

package/src/instance/internal-api/ValueContext.ts

@@ -1,28 +0,0 @@
-import type { EngineXPathNode } from '../../integration/xpath/adapter/kind.ts';
-import type { ReactiveScope } from '../../lib/reactivity/scope.ts';
-import type { BindComputationExpression } from '../../parse/expression/BindComputationExpression.ts';
-import type { EvaluationContext } from './EvaluationContext.ts';
-
-export type InstanceValue = string;
-
-interface ValueContextDefinitionBind {
-	readonly calculate: BindComputationExpression<'calculate'> | null;
-	readonly readonly: BindComputationExpression<'readonly'>;
-}
-
-export interface ValueContextDefinition {
-	readonly bind: ValueContextDefinitionBind;
-	readonly defaultValue: InstanceValue;
-}
-
-export interface ValueContext<RuntimeValue> extends EvaluationContext {
-	readonly scope: ReactiveScope;
-	readonly definition: ValueContextDefinition;
-	readonly contextNode: EngineXPathNode & this;
-
-	isReadonly(): boolean;
-	isRelevant(): boolean;
-
-	readonly encodeValue: (this: unknown, runtimeValue: RuntimeValue) => InstanceValue;
-	readonly decodeValue: (this: unknown, instanceValue: InstanceValue) => RuntimeValue;
-}

package/src/instance/internal-api/submission/ClientReactiveSubmittableInstance.ts

@@ -1,20 +0,0 @@
-import type { SubmissionDefinition } from '../../../client/submission/SubmissionDefinition.ts';
-import type { AncestorNodeValidationState } from '../../../client/validation.ts';
-import type { Root } from '../../Root.ts';
-import type {
-	ClientReactiveSubmittableParentNode,
-	ClientReactiveSubmittableParentNodeDefinition,
-} from './ClientReactiveSubmittableParentNode.ts';
-
-interface ClientReactiveSubmittableInstanceDefinition
-	extends ClientReactiveSubmittableParentNodeDefinition {
-	readonly submission: SubmissionDefinition;
-}
-
-export interface ClientReactiveSubmittableInstance
-	extends ClientReactiveSubmittableParentNode<Root> {
-	readonly definition: ClientReactiveSubmittableInstanceDefinition;
-	readonly root: Root;
-	readonly parent: null;
-	readonly validationState: AncestorNodeValidationState;
-}

package/src/instance/internal-api/submission/ClientReactiveSubmittableLeafNode.ts

@@ -1,43 +0,0 @@
-import type { SubmissionState } from '../../../client/submission/SubmissionState.ts';
-import type { QualifiedName } from '../../../lib/names/QualifiedName.ts';
-import type { EscapedXMLText } from '../../../lib/xml-serialization.ts';
-import type {
-	ClientReactiveSubmittableChildNode,
-	ClientReactiveSubmittableParentNode,
-} from './ClientReactiveSubmittableParentNode.ts';
-
-interface ClientReactiveSubmittableLeafNodeCurrentState<RuntimeValue> {
-	get relevant(): boolean;
-	get value(): RuntimeValue;
-}
-
-export type SerializedSubmissionValue = string;
-
-interface ClientReactiveSubmittableLeafNodeDefinition {
-	readonly qualifiedName: QualifiedName;
-}
-
-export interface ClientReactiveSubmittableLeafNode<RuntimeValue> {
-	readonly definition: ClientReactiveSubmittableLeafNodeDefinition;
-	readonly parent: ClientReactiveSubmittableParentNode<ClientReactiveSubmittableChildNode>;
-	readonly currentState: ClientReactiveSubmittableLeafNodeCurrentState<RuntimeValue>;
-
-	/**
-	 * A client-reactive submittable leaf node is responsible for producing a
-	 * string representation of its value state, suitable for serialization for
-	 * submission. It **MUST NOT** perform any further submission-specific
-	 * serialization duties: in particular, the value **MUST NOT** be escaped for
-	 * XML. This responsibility is delegated up the stack, to avoid repeat
-	 * escaping.
-	 *
-	 * Note: excluding {@link EscapedXMLText} here does not have an effect on the
-	 * type system, it is a documentation-only hint, to help guard against future
-	 * double-escaping mistakes.
-	 */
-	readonly encodeValue: (
-		this: unknown,
-		runtimeValue: RuntimeValue
-	) => Exclude<string, EscapedXMLText>;
-
-	readonly submissionState: SubmissionState;
-}

package/src/instance/internal-api/submission/ClientReactiveSubmittableParentNode.ts

@@ -1,26 +0,0 @@
-import type { SubmissionState } from '../../../client/submission/SubmissionState.ts';
-import type { QualifiedName } from '../../../lib/names/QualifiedName.ts';
-
-export interface ClientReactiveSubmittableChildNode {
-	readonly submissionState: SubmissionState;
-}
-
-interface ClientReactiveSubmittableParentNodeCurrentState<
-	Child extends ClientReactiveSubmittableChildNode,
-> {
-	get relevant(): boolean;
-	get children(): readonly Child[];
-}
-
-export interface ClientReactiveSubmittableParentNodeDefinition {
-	readonly qualifiedName: QualifiedName;
-}
-
-export interface ClientReactiveSubmittableParentNode<
-	Child extends ClientReactiveSubmittableChildNode,
-> {
-	readonly definition: ClientReactiveSubmittableParentNodeDefinition;
-	readonly parent: ClientReactiveSubmittableParentNode<ClientReactiveSubmittableChildNode> | null;
-	readonly currentState: ClientReactiveSubmittableParentNodeCurrentState<Child>;
-	readonly submissionState: SubmissionState;
-}

package/src/instance/internal-api/submission/ClientReactiveSubmittableValueNode.ts

@@ -1,24 +0,0 @@
-import type { SubmissionState } from '../../../client/submission/SubmissionState.ts';
-import type { QualifiedName } from '../../../lib/names/QualifiedName.ts';
-import type {
-	ClientReactiveSubmittableChildNode,
-	ClientReactiveSubmittableParentNode,
-} from './ClientReactiveSubmittableParentNode.ts';
-
-interface ClientReactiveSubmittableValueNodeCurrentState {
-	get relevant(): boolean;
-	get instanceValue(): string;
-}
-
-export type SerializedSubmissionValue = string;
-
-interface ClientReactiveSubmittableValueNodeDefinition {
-	readonly qualifiedName: QualifiedName;
-}
-
-export interface ClientReactiveSubmittableValueNode {
-	readonly definition: ClientReactiveSubmittableValueNodeDefinition;
-	readonly parent: ClientReactiveSubmittableParentNode<ClientReactiveSubmittableChildNode>;
-	readonly currentState: ClientReactiveSubmittableValueNodeCurrentState;
-	readonly submissionState: SubmissionState;
-}

package/src/instance/unsupported/UploadControl.ts

@@ -1,9 +0,0 @@
-import { UnsupportedControl } from '../abstract/UnsupportedControl.ts';
-import type { ValueContext } from '../internal-api/ValueContext.ts';
-
-export class UploadControl extends UnsupportedControl<'upload'> implements ValueContext<unknown> {
-	readonly nodeType = 'upload';
-
-	// ValueContext
-	readonly contextNode = this;
-}

package/src/lib/client-reactivity/submission/createInstanceSubmissionState.ts

@@ -1,12 +0,0 @@
-import type { SubmissionState } from '../../../client/submission/SubmissionState.ts';
-import type { ClientReactiveSubmittableInstance } from '../../../instance/internal-api/submission/ClientReactiveSubmittableInstance.ts';
-
-export const createInstanceSubmissionState = (
-	node: ClientReactiveSubmittableInstance
-): SubmissionState => {
-	return {
-		get submissionXML(): string {
-			return node.root.submissionState.submissionXML;
-		},
-	};
-};

package/src/lib/client-reactivity/submission/createLeafNodeSubmissionState.ts

@@ -1,20 +0,0 @@
-import type { SubmissionState } from '../../../client/submission/SubmissionState.ts';
-import type { ClientReactiveSubmittableLeafNode } from '../../../instance/internal-api/submission/ClientReactiveSubmittableLeafNode.ts';
-import { escapeXMLText, serializeLeafElementXML } from '../../xml-serialization.ts';
-
-export const createLeafNodeSubmissionState = <Value>(
-	node: ClientReactiveSubmittableLeafNode<Value>
-): SubmissionState => {
-	return {
-		get submissionXML() {
-			if (!node.currentState.relevant) {
-				return '';
-			}
-
-			const value = node.encodeValue(node.currentState.value);
-			const xmlValue = escapeXMLText(value);
-
-			return serializeLeafElementXML(node.definition.qualifiedName, xmlValue);
-		},
-	};
-};

package/src/lib/client-reactivity/submission/createNodeRangeSubmissionState.ts

@@ -1,17 +0,0 @@
-import type { SubmissionState } from '../../../client/submission/SubmissionState.ts';
-import type { ClientReactiveSubmittableParentNode } from '../../../instance/internal-api/submission/ClientReactiveSubmittableParentNode.ts';
-import type { RepeatInstance } from '../../../instance/repeat/RepeatInstance.ts';
-
-export const createNodeRangeSubmissionState = (
-	node: ClientReactiveSubmittableParentNode<RepeatInstance>
-): SubmissionState => {
-	return {
-		get submissionXML() {
-			const serializedChildren = node.currentState.children.map((child) => {
-				return child.submissionState.submissionXML;
-			});
-
-			return serializedChildren.join('');
-		},
-	};
-};

package/src/lib/client-reactivity/submission/createParentNodeSubmissionState.ts

@@ -1,22 +0,0 @@
-import type { SubmissionState } from '../../../client/submission/SubmissionState.ts';
-import type { GeneralChildNode } from '../../../instance/hierarchy.ts';
-import type { ClientReactiveSubmittableParentNode } from '../../../instance/internal-api/submission/ClientReactiveSubmittableParentNode.ts';
-import { serializeParentElementXML } from '../../xml-serialization.ts';
-
-export const createParentNodeSubmissionState = (
-	node: ClientReactiveSubmittableParentNode<GeneralChildNode>
-): SubmissionState => {
-	return {
-		get submissionXML() {
-			if (!node.currentState.relevant) {
-				return '';
-			}
-
-			const serializedChildren = node.currentState.children.map((child) => {
-				return child.submissionState.submissionXML;
-			});
-
-			return serializeParentElementXML(node.definition.qualifiedName, serializedChildren);
-		},
-	};
-};

package/src/lib/client-reactivity/submission/createValueNodeSubmissionState.ts

@@ -1,21 +0,0 @@
-import type { SubmissionState } from '../../../client/submission/SubmissionState.ts';
-import type { ClientReactiveSubmittableValueNode } from '../../../instance/internal-api/submission/ClientReactiveSubmittableValueNode.ts';
-import { escapeXMLText, serializeLeafElementXML } from '../../xml-serialization.ts';
-
-export const createValueNodeSubmissionState = (
-	node: ClientReactiveSubmittableValueNode
-): SubmissionState => {
-	const { qualifiedName } = node.definition;
-
-	return {
-		get submissionXML() {
-			if (!node.currentState.relevant) {
-				return '';
-			}
-
-			const xmlValue = escapeXMLText(node.currentState.instanceValue);
-
-			return serializeLeafElementXML(qualifiedName, xmlValue);
-		},
-	};
-};

package/src/lib/client-reactivity/submission/prepareSubmission.ts

@@ -1,172 +0,0 @@
-import { UnreachableError } from '@getodk/common/lib/error/UnreachableError.ts';
-import {
-	SUBMISSION_INSTANCE_FILE_NAME,
-	SUBMISSION_INSTANCE_FILE_TYPE,
-} from '../../../client/constants.ts';
-import type { SubmissionData } from '../../../client/submission/SubmissionData.ts';
-import type { SubmissionDefinition } from '../../../client/submission/SubmissionDefinition.ts';
-import type { SubmissionInstanceFile } from '../../../client/submission/SubmissionInstanceFile.ts';
-import type { SubmissionChunkedType } from '../../../client/submission/SubmissionOptions.ts';
-import type { SubmissionResult } from '../../../client/submission/SubmissionResult.ts';
-import type { DescendantNodeViolationReference } from '../../../client/validation.ts';
-import type { ClientReactiveSubmittableInstance } from '../../../instance/internal-api/submission/ClientReactiveSubmittableInstance.ts';
-
-class InstanceFile extends File implements SubmissionInstanceFile {
-	override readonly name = SUBMISSION_INSTANCE_FILE_NAME;
-	override readonly type = SUBMISSION_INSTANCE_FILE_TYPE;
-
-	constructor(instanceRoot: ClientReactiveSubmittableInstance) {
-		const { submissionXML } = instanceRoot.submissionState;
-
-		super([submissionXML], SUBMISSION_INSTANCE_FILE_NAME, {
-			type: SUBMISSION_INSTANCE_FILE_TYPE,
-		});
-	}
-}
-
-type AssertSubmissionData = (data: FormData) => asserts data is SubmissionData;
-
-const assertSubmissionData: AssertSubmissionData = (data) => {
-	const instanceFile = data.get(SUBMISSION_INSTANCE_FILE_NAME);
-
-	if (!(instanceFile instanceof InstanceFile)) {
-		throw new Error(`Invalid SubmissionData`);
-	}
-};
-
-class InstanceSubmissionData extends FormData {
-	static from(instanceFile: InstanceFile, attachments: readonly File[]): SubmissionData {
-		const data = new this(instanceFile, attachments);
-
-		assertSubmissionData(data);
-
-		return data;
-	}
-
-	private constructor(
-		readonly instanceFile: InstanceFile,
-		readonly attachments: readonly File[]
-	) {
-		super();
-
-		this.set(SUBMISSION_INSTANCE_FILE_NAME, instanceFile);
-
-		attachments.forEach((attachment) => {
-			const { name } = attachment;
-
-			if (name === SUBMISSION_INSTANCE_FILE_NAME && attachment !== instanceFile) {
-				throw new Error(
-					`Failed to add conflicting attachment with name ${SUBMISSION_INSTANCE_FILE_NAME}`
-				);
-			}
-
-			this.set(name, attachment);
-		});
-	}
-}
-
-interface PendingValidation {
-	readonly status: 'pending';
-	readonly violations: readonly DescendantNodeViolationReference[];
-}
-
-interface ReadyValidation {
-	readonly status: 'ready';
-	readonly violations: null;
-}
-
-type SubmissionInstanceStateValidation = PendingValidation | ReadyValidation;
-
-const validateSubmission = (
-	instanceRoot: ClientReactiveSubmittableInstance
-): SubmissionInstanceStateValidation => {
-	const { violations } = instanceRoot.validationState;
-
-	if (violations.length === 0) {
-		return {
-			status: 'ready',
-			violations: null,
-		};
-	}
-
-	return {
-		status: 'pending',
-		violations,
-	};
-};
-
-const monolithicSubmissionResult = (
-	validation: SubmissionInstanceStateValidation,
-	definition: SubmissionDefinition,
-	instanceFile: InstanceFile,
-	attachments: readonly File[]
-): SubmissionResult<'monolithic'> => {
-	const data = InstanceSubmissionData.from(instanceFile, attachments);
-
-	return {
-		...validation,
-		definition,
-		data,
-	};
-};
-
-interface ChunkedSubmissionResultOptions {
-	readonly maxSize: number;
-}
-
-const chunkedSubmissionResult = (
-	validation: SubmissionInstanceStateValidation,
-	definition: SubmissionDefinition,
-	instanceFile: InstanceFile,
-	attachments: readonly File[],
-	options: ChunkedSubmissionResultOptions
-): SubmissionResult<'chunked'> => {
-	if (attachments.length > 0 || options.maxSize !== Infinity) {
-		throw new Error('Submission chunking pending implementation');
-	}
-
-	const data = InstanceSubmissionData.from(instanceFile, attachments);
-
-	return {
-		...validation,
-		definition,
-		data: [data],
-	};
-};
-
-export interface PrepeareSubmissionOptions<ChunkedType extends SubmissionChunkedType> {
-	readonly chunked: ChunkedType;
-	readonly maxSize: number;
-}
-
-export const prepareSubmission = <ChunkedType extends SubmissionChunkedType>(
-	instanceRoot: ClientReactiveSubmittableInstance,
-	options: PrepeareSubmissionOptions<ChunkedType>
-): SubmissionResult<ChunkedType> => {
-	const validation = validateSubmission(instanceRoot);
-	const definition = instanceRoot.definition.submission;
-	const instanceFile = new InstanceFile(instanceRoot);
-	const attachments: readonly File[] = [];
-
-	switch (options.chunked) {
-		case 'chunked':
-			return chunkedSubmissionResult(
-				validation,
-				definition,
-				instanceFile,
-				attachments,
-				options
-			) satisfies SubmissionResult<'chunked'> as SubmissionResult<ChunkedType>;
-
-		case 'monolithic':
-			return monolithicSubmissionResult(
-				validation,
-				definition,
-				instanceFile,
-				attachments
-			) satisfies SubmissionResult<'monolithic'> as SubmissionResult<ChunkedType>;
-
-		default:
-			throw new UnreachableError(options.chunked);
-	}
-};