@getodk/xforms-engine 0.6.0 → 0.8.0

package/dist/instance/internal-api/submission/ClientReactiveSubmittableLeafNode.d.ts

@@ -1,32 +0,0 @@
-import { SubmissionState } from '../../../client/submission/SubmissionState.ts';
-import { QualifiedName } from '../../../lib/names/QualifiedName.ts';
-import { EscapedXMLText } from '../../../lib/xml-serialization.ts';
-import { 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;
-}
-export {};

package/dist/instance/internal-api/submission/ClientReactiveSubmittableParentNode.d.ts

@@ -1,19 +0,0 @@
-import { SubmissionState } from '../../../client/submission/SubmissionState.ts';
-import { 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;
-}
-export {};

package/dist/instance/internal-api/submission/ClientReactiveSubmittableValueNode.d.ts

@@ -1,18 +0,0 @@
-import { SubmissionState } from '../../../client/submission/SubmissionState.ts';
-import { QualifiedName } from '../../../lib/names/QualifiedName.ts';
-import { 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;
-}
-export {};

package/dist/instance/unsupported/UploadControl.d.ts

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

package/dist/lib/client-reactivity/submission/createInstanceSubmissionState.d.ts

@@ -1,3 +0,0 @@
-import { SubmissionState } from '../../../client/submission/SubmissionState.ts';
-import { ClientReactiveSubmittableInstance } from '../../../instance/internal-api/submission/ClientReactiveSubmittableInstance.ts';
-export declare const createInstanceSubmissionState: (node: ClientReactiveSubmittableInstance) => SubmissionState;

package/dist/lib/client-reactivity/submission/createLeafNodeSubmissionState.d.ts

@@ -1,3 +0,0 @@
-import { SubmissionState } from '../../../client/submission/SubmissionState.ts';
-import { ClientReactiveSubmittableLeafNode } from '../../../instance/internal-api/submission/ClientReactiveSubmittableLeafNode.ts';
-export declare const createLeafNodeSubmissionState: <Value>(node: ClientReactiveSubmittableLeafNode<Value>) => SubmissionState;

package/dist/lib/client-reactivity/submission/createNodeRangeSubmissionState.d.ts

@@ -1,4 +0,0 @@
-import { SubmissionState } from '../../../client/submission/SubmissionState.ts';
-import { ClientReactiveSubmittableParentNode } from '../../../instance/internal-api/submission/ClientReactiveSubmittableParentNode.ts';
-import { RepeatInstance } from '../../../instance/repeat/RepeatInstance.ts';
-export declare const createNodeRangeSubmissionState: (node: ClientReactiveSubmittableParentNode<RepeatInstance>) => SubmissionState;

package/dist/lib/client-reactivity/submission/createParentNodeSubmissionState.d.ts

@@ -1,4 +0,0 @@
-import { SubmissionState } from '../../../client/submission/SubmissionState.ts';
-import { GeneralChildNode } from '../../../instance/hierarchy.ts';
-import { ClientReactiveSubmittableParentNode } from '../../../instance/internal-api/submission/ClientReactiveSubmittableParentNode.ts';
-export declare const createParentNodeSubmissionState: (node: ClientReactiveSubmittableParentNode<GeneralChildNode>) => SubmissionState;

package/dist/lib/client-reactivity/submission/createRootSubmissionState.d.ts

@@ -1,3 +0,0 @@
-import { SubmissionState } from '../../../client/submission/SubmissionState.ts';
-import { Root } from '../../../instance/Root.ts';
-export declare const createRootSubmissionState: (node: Root) => SubmissionState;

package/dist/lib/client-reactivity/submission/createValueNodeSubmissionState.d.ts

@@ -1,3 +0,0 @@
-import { SubmissionState } from '../../../client/submission/SubmissionState.ts';
-import { ClientReactiveSubmittableValueNode } from '../../../instance/internal-api/submission/ClientReactiveSubmittableValueNode.ts';
-export declare const createValueNodeSubmissionState: (node: ClientReactiveSubmittableValueNode) => SubmissionState;

package/dist/lib/client-reactivity/submission/prepareSubmission.d.ts

@@ -1,8 +0,0 @@
-import { SubmissionChunkedType } from '../../../client/submission/SubmissionOptions.ts';
-import { SubmissionResult } from '../../../client/submission/SubmissionResult.ts';
-import { ClientReactiveSubmittableInstance } from '../../../instance/internal-api/submission/ClientReactiveSubmittableInstance.ts';
-export interface PrepeareSubmissionOptions<ChunkedType extends SubmissionChunkedType> {
-    readonly chunked: ChunkedType;
-    readonly maxSize: number;
-}
-export declare const prepareSubmission: <ChunkedType extends SubmissionChunkedType>(instanceRoot: ClientReactiveSubmittableInstance, options: PrepeareSubmissionOptions<ChunkedType>) => SubmissionResult<ChunkedType>;

package/dist/lib/reactivity/createValueState.d.ts

@@ -1,40 +0,0 @@
-import { ValueContext } from '../../instance/internal-api/ValueContext.ts';
-import { SimpleAtomicState } from './types.ts';
-type InitialValueSource = 'FORM_DEFAULT' | 'PRIMARY_INSTANCE';
-export interface ValueStateOptions {
-    /**
-     * Specifies the source of a {@link createValueState} signal's initial
-     * value state, where:
-     *
-     * - 'FORM_DEFAULT': Derives the initial state from the form's
-     *   definition of the node itself. This is the default option, appropriate
-     *   when initializing a form without additional primary instance data. In
-     *   other words, this value should not be used for edits.
-     *
-     * - 'PRIMARY_INSTANCE': Derives the initial state from the current text
-     *   content of the {@link ValueNode.contextNode}. This option
-     *   should be specified when initializing a form with existing primary
-     *   instance data, such as when editing a previous submission.
-     *
-     * @default 'FORM_DEFAULT'
-     *
-     * Specifies whether a {@link createV} signal's initial state
-     * should be derived from the current text content of the
-     * {@link ValueNode.contextNode | primary instance DOM state}.
-     */
-    readonly initialValueSource?: InitialValueSource;
-}
-type ValueState<RuntimeValue> = SimpleAtomicState<RuntimeValue>;
-/**
- * Provides a consistent interface for value nodes of any type which:
- *
- * - derives initial state from either an existing instance (e.g. for edits) or
- *   the node's definition (e.g. initializing a new submission)
- * - decodes current primary instance state into the value node's runtime type
- * - encodes updated runtime values to store updated instance state
- * - initializes reactive computation of `calculate` bind expressions for those
- *   nodes defined with one
- * - prevents downstream writes to nodes in a readonly state
- */
-export declare const createValueState: <RuntimeValue>(context: ValueContext<RuntimeValue>, options?: ValueStateOptions) => ValueState<RuntimeValue>;
-export {};

package/dist/parse/model/ItextTranslation/ItextTranslationDefinition.d.ts

@@ -1,4 +0,0 @@
-import { StaticDocument } from '../../../integration/xpath/static-dom/StaticDocument.ts';
-import { ItextTranslationRootDefinition } from './ItextTranslationRootDefinition.ts';
-export declare class ItextTranslationDefinition extends StaticDocument<ItextTranslationRootDefinition> {
-}

package/dist/parse/model/ItextTranslation/ItextTranslationRootDefinition.d.ts

@@ -1,9 +0,0 @@
-import { XFormsItextTranslationElement, XFORMS_KNOWN_ATTRIBUTE, XFORMS_LOCAL_NAME } from '@getodk/xpath';
-import { StaticElement } from '../../../integration/xpath/static-dom/StaticElement.ts';
-import { ItextTranslationDefinition } from './ItextTranslationDefinition.ts';
-export declare class ItextTranslationRootDefinition extends StaticElement<ItextTranslationDefinition> implements XFormsItextTranslationElement<ItextTranslationRootDefinition> {
-    readonly [XFORMS_LOCAL_NAME] = "translation";
-    readonly [XFORMS_KNOWN_ATTRIBUTE] = "lang";
-    getAttributeValue(localName: 'lang'): string;
-    getAttributeValue(localName: string): string | null;
-}

package/dist/parse/model/ItextTranslation/ItextTranslationsDefinition.d.ts

@@ -1,8 +0,0 @@
-import { XFormsItextTranslationMap } from '@getodk/xpath';
-import { EngineXPathNode } from '../../../integration/xpath/adapter/kind.ts';
-import { XFormDOM } from '../../XFormDOM.ts';
-import { ItextTranslationRootDefinition } from './ItextTranslationRootDefinition.ts';
-export declare class ItextTranslationsDefinition extends Map<string, ItextTranslationRootDefinition> implements XFormsItextTranslationMap<EngineXPathNode> {
-    static from(xformDOM: XFormDOM): ItextTranslationsDefinition;
-    private constructor();
-}

package/dist/parse/model/RepeatInstanceDefinition.d.ts

@@ -1,17 +0,0 @@
-import { NamespaceDeclarationMap } from '../../lib/names/NamespaceDeclarationMap.ts';
-import { QualifiedName } from '../../lib/names/QualifiedName.ts';
-import { RepeatElementDefinition } from '../body/RepeatElementDefinition.ts';
-import { DescendentNodeDefinition } from './DescendentNodeDefinition.ts';
-import { ChildNodeDefinition } from './NodeDefinition.ts';
-import { AnyRepeatRangeDefinition } from './RepeatRangeDefinition.ts';
-export declare class RepeatInstanceDefinition extends DescendentNodeDefinition<'repeat-instance', RepeatElementDefinition> {
-    readonly node: Element;
-    readonly type = "repeat-instance";
-    readonly namespaceDeclarations: NamespaceDeclarationMap;
-    readonly qualifiedName: QualifiedName;
-    readonly children: readonly ChildNodeDefinition[];
-    readonly instances: null;
-    readonly defaultValue: null;
-    constructor(range: AnyRepeatRangeDefinition, node: Element);
-    toJSON(): Omit<this, "parent" | "bind" | "toJSON" | "root" | "bodyElement">;
-}

package/dist/parse/model/RepeatRangeDefinition.d.ts

@@ -1,32 +0,0 @@
-import { NamespaceDeclarationMap } from '../../lib/names/NamespaceDeclarationMap.ts';
-import { QualifiedName } from '../../lib/names/QualifiedName.ts';
-import { RepeatElementDefinition } from '../body/RepeatElementDefinition.ts';
-import { RepeatCountControlExpression } from '../expression/RepeatCountControlExpression.ts';
-import { BindDefinition } from './BindDefinition.ts';
-import { DescendentNodeDefinition } from './DescendentNodeDefinition.ts';
-import { ParentNodeDefinition } from './NodeDefinition.ts';
-import { RepeatInstanceDefinition } from './RepeatInstanceDefinition.ts';
-import { RepeatTemplateDefinition } from './RepeatTemplateDefinition.ts';
-export interface ControlledRepeatRangeDefinition extends RepeatRangeDefinition {
-    readonly count: RepeatCountControlExpression;
-}
-export interface UncontrolledRepeatRangeDefinition extends RepeatRangeDefinition {
-    readonly count: null;
-}
-export type AnyRepeatRangeDefinition = ControlledRepeatRangeDefinition | UncontrolledRepeatRangeDefinition;
-export declare class RepeatRangeDefinition extends DescendentNodeDefinition<'repeat-range', RepeatElementDefinition> {
-    static from(parent: ParentNodeDefinition, bind: BindDefinition, bodyElement: RepeatElementDefinition, modelNodes: readonly [Element, ...Element[]]): AnyRepeatRangeDefinition;
-    readonly type = "repeat-range";
-    readonly template: RepeatTemplateDefinition;
-    readonly children: null;
-    readonly instances: RepeatInstanceDefinition[];
-    readonly count: RepeatCountControlExpression | null;
-    readonly node: null;
-    readonly namespaceDeclarations: NamespaceDeclarationMap;
-    readonly qualifiedName: QualifiedName;
-    readonly defaultValue: null;
-    private constructor();
-    isControlled(): this is ControlledRepeatRangeDefinition;
-    isUncontrolled(): this is UncontrolledRepeatRangeDefinition;
-    toJSON(): Omit<this, "parent" | "bind" | "toJSON" | "root" | "bodyElement" | "isControlled" | "isUncontrolled">;
-}

package/dist/parse/model/RepeatTemplateDefinition.d.ts

@@ -1,31 +0,0 @@
-import { JAVAROSA_NAMESPACE_URI } from '../../../../common/src/constants/xmlns.ts';
-import { NamespaceDeclarationMap } from '../../lib/names/NamespaceDeclarationMap.ts';
-import { QualifiedName } from '../../lib/names/QualifiedName.ts';
-import { RepeatElementDefinition } from '../body/RepeatElementDefinition.ts';
-import { DescendentNodeDefinition } from './DescendentNodeDefinition.ts';
-import { ChildNodeDefinition } from './NodeDefinition.ts';
-import { RepeatRangeDefinition } from './RepeatRangeDefinition.ts';
-interface ExplicitRepeatTemplateElement extends Element {
-    getAttributeNS(namespaceURI: typeof JAVAROSA_NAMESPACE_URI, name: 'template'): string;
-    getAttributeNS(namespaceURI: string | null, name: string): string | null;
-    hasAttributeNS(namespaceURI: typeof JAVAROSA_NAMESPACE_URI, name: 'template'): true;
-    (namespaceURI: string | null, name: string): boolean;
-}
-interface ParsedRepeatNodes {
-    readonly template: RepeatTemplateDefinition;
-    readonly instanceNodes: readonly Element[];
-}
-export declare class RepeatTemplateDefinition extends DescendentNodeDefinition<'repeat-template', RepeatElementDefinition> {
-    protected readonly templateNode: ExplicitRepeatTemplateElement;
-    static parseModelNodes(range: RepeatRangeDefinition, modelNodes: readonly [Element, ...Element[]]): ParsedRepeatNodes;
-    readonly type = "repeat-template";
-    readonly node: Element;
-    readonly namespaceDeclarations: NamespaceDeclarationMap;
-    readonly qualifiedName: QualifiedName;
-    readonly children: readonly ChildNodeDefinition[];
-    readonly instances: null;
-    readonly defaultValue: null;
-    protected constructor(range: RepeatRangeDefinition, templateNode: ExplicitRepeatTemplateElement);
-    toJSON(): Omit<this, "parent" | "bind" | "toJSON" | "root" | "bodyElement">;
-}
-export {};

package/dist/parse/model/SecondaryInstance/SecondaryInstanceDefinition.d.ts

@@ -1,4 +0,0 @@
-import { StaticDocument } from '../../../integration/xpath/static-dom/StaticDocument.ts';
-import { SecondaryInstanceRootDefinition } from './SecondaryInstanceRootDefinition.ts';
-export declare class SecondaryInstanceDefinition extends StaticDocument<SecondaryInstanceRootDefinition> {
-}

package/dist/parse/model/SecondaryInstance/SecondaryInstanceRootDefinition.d.ts

@@ -1,7 +0,0 @@
-import { XFormsSecondaryInstanceElement, XFORMS_KNOWN_ATTRIBUTE, XFORMS_LOCAL_NAME } from '@getodk/xpath';
-import { StaticElement } from '../../../integration/xpath/static-dom/StaticElement.ts';
-import { SecondaryInstanceDefinition } from './SecondaryInstanceDefinition.ts';
-export declare class SecondaryInstanceRootDefinition extends StaticElement<SecondaryInstanceDefinition> implements XFormsSecondaryInstanceElement<StaticElement> {
-    readonly [XFORMS_LOCAL_NAME] = "instance";
-    readonly [XFORMS_KNOWN_ATTRIBUTE] = "id";
-}

package/src/client/EngineConfig.ts

@@ -1,84 +0,0 @@
-import type { initializeForm } from '../instance/index.ts';
-import type { MissingResourceBehavior, MissingResourceBehaviorDefault } from './constants.ts';
-import type { OpaqueReactiveObjectFactory } from './OpaqueReactiveObjectFactory.ts';
-import type { FetchFormAttachment, FetchResource } from './resources.ts';
-
-/**
- * Options provided by a client to specify certain aspects of engine runtime
- * behavior. These options will generally be intended to facilitate cooperation
- * where there is mixed responsibility between a client and the engine, or where
- * the engine may provide sensible defaults which a client could be expected to
- * override or augment.
- */
-export interface EngineConfig {
-	/**
-	 * A client may specify a generic function for constructing stateful objects.
-	 * The only hard requirement of this function is that it accepts an **object**
-	 * and returns an object of the same shape. The engine will use this function
-	 * to initialize client-facing state, and will mutate properties of the object
-	 * when their corresponding state is changed.
-	 *
-	 * A client may use this function to provide its own implementation of
-	 * reactivity with semantics like those described above. The mechanism of
-	 * reactivity, if any, is at the discretion of the client. It is expected
-	 * that clients providing this function will use a reactive subscribe-on-read
-	 * mechanism to handle state updates conveyed by the engine.
-	 */
-	readonly stateFactory?: OpaqueReactiveObjectFactory;
-
-	/**
-	 *
-	 * A client may specify an arbitrary {@link fetch}-like function for retrieving an XML XForm form
-	 * definition.
-	 *
-	 * Notes:
-	 *
-	 * - This configuration will only be consuled for calls to
-	 *   {@link initializeForm} with a URL referencing an XML XForm definition. It
-	 *   will be ignored for calls passing an XML XForm form definition directly.
-	 *
-	 * - For calls to {@link initializeForm} with a URL, if this configuration is
-	 *   not specified it will default to the global {@link fetch} function (if
-	 *   one is defined).
-	 */
-	readonly fetchFormDefinition?: FetchResource;
-
-	/**
-	 * A client may specify an arbitrary {@link fetch}-like function to retrieve a
-	 * form's attachments, i.e. any `jr:` URL referenced by the form (as specified
-	 * by {@link https://getodk.github.io/xforms-spec/ | ODK XForms}).
-	 *
-	 * Notes:
-	 *
-	 * - This configuration will be consulted for all supported form attachments,
-	 *   as a part of {@link initializeForm | form initialization}.
-	 *
-	 * - If this configuration is not specified it will default to the global
-	 *   {@link fetch} function (if one is defined).
-	 *
-	 * This default behavior will typically result in failure to load form
-	 * attachments—and in most cases this will also cause
-	 * {@link initializeForm | form initialization} to fail overall—with the
-	 * following exceptions:
-	 *
-	 * - **CLIENT-SPECIFIC:** Usage in coordination with a client-implemented
-	 *   {@link https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API | Serivce Worker},
-	 *   which can intercept network requests **generally**. Clients already using
-	 *   a Service Worker may opt for the convenience of handling network requests
-	 *   for `jr:` URLs along with any other network interception logic. Client
-	 *   implementors should be warned, however, that such `jr:` URLs are not
-	 *   namespaced or otherwise scoped to a particular form; such a client would
-	 *   therefore inherently need to coordinate state between the Service Worker
-	 *   and the main thread (or whatever other realm calls
-	 *   {@link initializeForm}).
-	 */
-	readonly fetchFormAttachment?: FetchFormAttachment;
-
-	/**
-	 * @see {@link MissingResourceBehavior}
-	 * @see {@link MissingResourceBehaviorDefault}
-	 *
-	 * @default MissingResourceBehaviorDefault
-	 */
-	readonly missingResourceBehavior?: MissingResourceBehavior;
-}

package/src/client/submission/SubmissionData.ts

@@ -1,12 +0,0 @@
-import type {
-	SubmissionInstanceFile,
-	SubmissionInstanceFileName,
-} from './SubmissionInstanceFile.ts';
-
-export interface SubmissionData extends FormData {
-	get(name: SubmissionInstanceFileName): SubmissionInstanceFile;
-	get(name: string): FormDataEntryValue | null;
-
-	has(name: SubmissionInstanceFileName): true;
-	has(name: string): boolean;
-}

package/src/client/submission/SubmissionInstanceFile.ts

@@ -1,9 +0,0 @@
-import type { SubmissionInstanceFileName, SubmissionInstanceFileType } from '../constants.ts';
-
-// Re-export for convenient `SubmissionInstanceFile` construction/access flows
-export type { SubmissionInstanceFileName, SubmissionInstanceFileType };
-
-export interface SubmissionInstanceFile extends File {
-	readonly name: SubmissionInstanceFileName;
-	readonly type: SubmissionInstanceFileType;
-}

package/src/client/submission/SubmissionOptions.ts

@@ -1,28 +0,0 @@
-export type SubmissionChunkedType = 'chunked' | 'monolithic';
-
-interface BaseSubmissionOptions<ChunkedType extends SubmissionChunkedType> {
-	readonly chunked?: ChunkedType | undefined;
-
-	/**
-	 * As described in the
-	 * {@link https://docs.getodk.org/openrosa-form-submission/#extended-transmission-considerations | OpenRosa Form Submission API},
-	 * clients may obtain this value from an OpenRosa server's
-	 * `X-OpenRosa-Accept-Content-Length` header.
-	 */
-	readonly maxSize?: number;
-}
-
-interface ChunkedSubmissionOptions extends BaseSubmissionOptions<'chunked'> {
-	readonly maxSize: number;
-}
-
-interface MonolithicSubmissionOptions extends BaseSubmissionOptions<'monolithic'> {
-	readonly chunked?: 'monolithic' | undefined;
-	readonly maxSize?: never;
-}
-
-// prettier-ignore
-export type SubmissionOptions<ChunkedType extends SubmissionChunkedType = 'monolithic'> = {
-	chunked: ChunkedSubmissionOptions;
-	monolithic: MonolithicSubmissionOptions;
-}[ChunkedType];

package/src/client/submission/SubmissionResult.ts

@@ -1,124 +0,0 @@
-import type { AnyViolation, DescendantNodeViolationReference } from '../validation.ts';
-import type { SubmissionData } from './SubmissionData.ts';
-import type { SubmissionDefinition } from './SubmissionDefinition.ts';
-import type { SubmissionChunkedType, SubmissionOptions } from './SubmissionOptions.ts';
-
-// prettier-ignore
-export type SubmissionResultStatus =
-	// eslint-disable-next-line @typescript-eslint/sort-type-constituents
-	| 'pending'
-	| 'max-size-exceeded'
-	| 'ready';
-
-// prettier-ignore
-type SubmissionResultData<ChunkedType extends SubmissionChunkedType> = {
-	chunked: readonly [SubmissionData, ...SubmissionData[]];
-	monolithic: SubmissionData;
-}[ChunkedType];
-
-/**
- * Provides detail about an individual submission attachment {@link File}s which
- * exceeds the client-specified {@link maxSize} for a
- * {@link SubmissionResult<'chunked'> | chunked submission result}. Clients may
- * use this value to provide guidance to users.
- *
- * @todo We may want to consider (a) making {@link maxSize} a configuration the
- * client can provide when initializing a form instance, rather than only on
- * submission; and then (b) treating a maximum size violation as another kind of
- * node-level violation. This would go beyond the kinds of validation specified
- * by ODK XForms, but it would make a lot of _conceptual sense_.
- *
- * It would almost certainly be helpful to alert users to violations as the
- * occur, rather than only at submission time (where they have likely already
- * moved on). This is something clients can do without engine support, but it
- * would likely promote good usability patterns if the engine makes it an
- * obvious and uniform option at the main engine/client entrypoint.
- *
- * @todo If we consider the above, we'd want to reframe _this interface_ to
- * match the shape of other {@link AnyViolation | violations} (adding it as a
- * member of that union). We'd also likely eliminate
- * {@link MaxSizeExceededResult} in the process, since
- * {@link PendingSubmissionResult} would then cover the case.
- */
-interface MaxSizeViolation {
-	/**
-	 * Specifies the index of
-	 * {@link SubmissionResultData<'chunked'> | chunked submission data} where a
-	 * submission attachment {@link File} exceeds the client-specified
-	 * {@link maxSize}.
-	 */
-	readonly dataIndex: number;
-
-	/**
-	 * Specifies the name of the file which exceeds the client-specified
-	 * {@link maxSize}. This name can also be used as a key to access the
-	 * violating {@link File}/submission attachment, in the {@link SubmissionData}
-	 * at the specified {@link dataIndex}.
-	 */
-	readonly fileName: string;
-
-	/**
-	 * Reflects the client-specified maximum size for each chunk of a
-	 * {@link SubmissionResult<'chunked'> | chunked submission result}.
-	 */
-	readonly maxSize: number;
-
-	/**
-	 * Details the actual size of the violating {@link File}/submission
-	 * attachment. Along with {@link maxSize}. Clients may use the delta between
-	 * this value and {@link maxSize} to provide detailed guidance to users.
-	 */
-	readonly actualSize: number;
-}
-
-// prettier-ignore
-type SubmissionResultViolation =
-	| DescendantNodeViolationReference
-	| MaxSizeViolation;
-
-interface BaseSubmissionResult<ChunkedType extends SubmissionChunkedType> {
-	readonly status: SubmissionResultStatus;
-	readonly definition: SubmissionDefinition;
-	get violations(): readonly SubmissionResultViolation[] | null;
-
-	/**
-	 * Submission data may be chunked according to the
-	 * {@link SubmissionOptions.maxSize | maxSize submission option}
-	 */
-	readonly data: SubmissionResultData<ChunkedType>;
-}
-
-interface PendingSubmissionResult<ChunkedType extends SubmissionChunkedType>
-	extends BaseSubmissionResult<ChunkedType> {
-	readonly status: 'pending';
-	get violations(): readonly DescendantNodeViolationReference[];
-}
-
-interface MaxSizeExceededResult extends BaseSubmissionResult<'chunked'> {
-	readonly status: 'max-size-exceeded';
-	get violations(): readonly MaxSizeViolation[];
-}
-
-interface ReadySubmissionResult<ChunkedType extends SubmissionChunkedType>
-	extends BaseSubmissionResult<ChunkedType> {
-	readonly status: 'ready';
-	get violations(): null;
-}
-
-// prettier-ignore
-type CommonSubmissionResult<ChunkedType extends SubmissionChunkedType> =
-	| PendingSubmissionResult<ChunkedType>
-	| ReadySubmissionResult<ChunkedType>;
-
-// prettier-ignore
-export type ChunkedSubmissionResult =
-	| CommonSubmissionResult<'chunked'>
-	| MaxSizeExceededResult;
-
-export type MonolithicSubmissionResult = CommonSubmissionResult<'monolithic'>;
-
-// prettier-ignore
-export type SubmissionResult<ChunkedType extends SubmissionChunkedType> = {
-	chunked: ChunkedSubmissionResult;
-	monolithic: MonolithicSubmissionResult;
-}[ChunkedType];

package/src/client/submission/SubmissionState.ts

@@ -1,14 +0,0 @@
-import type { RootNode } from '../RootNode.ts';
-
-export interface SubmissionState {
-	/**
-	 * Represents the serialized XML state of a given node, as it will be prepared
-	 * for submission. The value produced in {@link RootNode.submissionState} is
-	 * the same serialization which will be produced for the complete submission.
-	 *
-	 * @todo Note that this particular aspect of the design doesn't yet address
-	 * production of unique file names. As such, this may change as we introduce
-	 * affected data types (and their supporting nodes).
-	 */
-	get submissionXML(): string;
-}

package/src/client/unsupported/UnsupportedControlNode.ts

@@ -1,36 +0,0 @@
-import type { UnknownAppearanceDefinition } from '../../parse/body/appearance/unknownAppearanceParser.ts';
-import type { UploadControlDefinition } from '../../parse/body/control/UploadControlDefinition.ts';
-import type { LeafNodeDefinition } from '../../parse/model/LeafNodeDefinition.ts';
-import type { BaseNode, BaseNodeState } from '../BaseNode.ts';
-import type { RootNode } from '../RootNode.ts';
-import type { GeneralParentNode } from '../hierarchy.ts';
-import type { UnsupportedControlNodeType } from '../node-types.ts';
-import type { LeafNodeValidationState } from '../validation.ts';
-
-export interface UnsupportedControlNodeState extends BaseNodeState {
-	get children(): null;
-	get valueOptions(): unknown;
-	get value(): unknown;
-}
-
-// prettier-ignore
-export type UnsupportedControlElementDefinition = UploadControlDefinition;
-
-export interface UnsupportedControlDefinition extends LeafNodeDefinition {
-	readonly bodyElement: UnsupportedControlElementDefinition;
-}
-
-/**
- * Stub node, for form controls pending further engine support.
- */
-export interface UnsupportedControlNode extends BaseNode {
-	readonly nodeType: UnsupportedControlNodeType;
-	readonly appearances: UnknownAppearanceDefinition;
-	readonly definition: UnsupportedControlDefinition;
-	readonly root: RootNode;
-	readonly parent: GeneralParentNode;
-	readonly currentState: UnsupportedControlNodeState;
-	readonly validationState: LeafNodeValidationState;
-
-	setValue?(value: never): never;
-}

package/src/client/unsupported/UploadNode.ts

@@ -1,14 +0,0 @@
-import type { UploadControlDefinition } from '../../parse/body/control/UploadControlDefinition.ts';
-import type {
-	UnsupportedControlDefinition,
-	UnsupportedControlNode,
-} from './UnsupportedControlNode.ts';
-
-export interface UploadNodeDefinition extends UnsupportedControlDefinition {
-	readonly bodyElement: UploadControlDefinition;
-}
-
-export interface UploadNode extends UnsupportedControlNode {
-	readonly nodeType: 'upload';
-	readonly definition: UploadNodeDefinition;
-}