@getodk/xforms-engine 0.5.0 → 0.7.0

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

@@ -1,28 +0,0 @@
-import { JAVAROSA_NAMESPACE_URI } from '../../../../common/src/constants/xmlns.ts';
-import { RepeatElementDefinition } from '../body/RepeatElementDefinition.ts';
-import { DescendentNodeDefinition } from './DescendentNodeDefinition.ts';
-import { ChildNodeDefinition, NodeDefinition } 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> implements NodeDefinition<'repeat-template'> {
-    protected readonly templateNode: ExplicitRepeatTemplateElement;
-    static parseModelNodes(range: RepeatRangeDefinition, modelNodes: readonly [Element, ...Element[]]): ParsedRepeatNodes;
-    readonly type = "repeat-template";
-    readonly node: Element;
-    readonly nodeName: string;
-    readonly children: readonly ChildNodeDefinition[];
-    readonly instances: null;
-    readonly defaultValue: null;
-    protected constructor(range: RepeatRangeDefinition, templateNode: ExplicitRepeatTemplateElement);
-    toJSON(): Omit<this, "parent" | "toJSON" | "bind" | "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/RangeNode.ts

@@ -1,14 +0,0 @@
-import type { RangeControlDefinition } from '../../parse/body/control/RangeControlDefinition.ts';
-import type {
-	UnsupportedControlDefinition,
-	UnsupportedControlNode,
-} from './UnsupportedControlNode.ts';
-
-export interface RangeNodeDefinition extends UnsupportedControlDefinition {
-	readonly bodyElement: RangeControlDefinition;
-}
-
-export interface RangeNode extends UnsupportedControlNode {
-	readonly nodeType: 'range';
-	readonly definition: RangeNodeDefinition;
-}

package/src/client/unsupported/RankNode.ts

@@ -1,14 +0,0 @@
-import type { RankControlDefinition } from '../../parse/body/control/RankControlDefinition.ts';
-import type {
-	UnsupportedControlDefinition,
-	UnsupportedControlNode,
-} from './UnsupportedControlNode.ts';
-
-export interface RankNodeDefinition extends UnsupportedControlDefinition {
-	readonly bodyElement: RankControlDefinition;
-}
-
-export interface RankNode extends UnsupportedControlNode {
-	readonly nodeType: 'rank';
-	readonly definition: RankNodeDefinition;
-}

package/src/instance/SelectField.ts

@@ -1,263 +0,0 @@
-import { xmlXPathWhitespaceSeparatedList } from '@getodk/common/lib/string/whitespace.ts';
-import { XPathNodeKindKey } from '@getodk/xpath';
-import type { Accessor } from 'solid-js';
-import { createMemo, untrack } from 'solid-js';
-import type { SelectItem, SelectNode, SelectNodeAppearances } from '../client/SelectNode.ts';
-import type { TextRange } from '../client/TextRange.ts';
-import type { SubmissionState } from '../client/submission/SubmissionState.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 { createSelectItems } from '../lib/reactivity/createSelectItems.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 type { SharedNodeState } from '../lib/reactivity/node-state/createSharedNodeState.ts';
-import { createSharedNodeState } 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 type { SharedValidationState } from '../lib/reactivity/validation/createValidation.ts';
-import { createValidationState } from '../lib/reactivity/validation/createValidation.ts';
-import type { AnySelectDefinition } from '../parse/body/control/select/SelectDefinition.ts';
-import type { LeafNodeDefinition } from '../parse/model/LeafNodeDefinition.ts';
-import type { Root } from './Root.ts';
-import type { DescendantNodeStateSpec } from './abstract/DescendantNode.ts';
-import { DescendantNode } from './abstract/DescendantNode.ts';
-import type { GeneralParentNode } from './hierarchy.ts';
-import type { EvaluationContext } from './internal-api/EvaluationContext.ts';
-import type { ValidationContext } from './internal-api/ValidationContext.ts';
-import type { ValueContext } from './internal-api/ValueContext.ts';
-import type { ClientReactiveSubmittableLeafNode } from './internal-api/submission/ClientReactiveSubmittableLeafNode.ts';
-
-export interface SelectFieldDefinition extends LeafNodeDefinition {
-	readonly bodyElement: AnySelectDefinition;
-}
-
-interface SelectFieldStateSpec extends DescendantNodeStateSpec<readonly SelectItem[]> {
-	readonly label: Accessor<TextRange<'label'> | null>;
-	readonly hint: Accessor<TextRange<'hint'> | null>;
-	readonly children: null;
-	readonly value: SimpleAtomicState<readonly SelectItem[]>;
-	readonly valueOptions: Accessor<readonly SelectItem[]>;
-}
-
-export class SelectField
-	extends DescendantNode<SelectFieldDefinition, SelectFieldStateSpec, GeneralParentNode, null>
-	implements
-		SelectNode,
-		XFormsXPathElement,
-		EvaluationContext,
-		ValidationContext,
-		ValueContext<readonly SelectItem[]>,
-		ClientReactiveSubmittableLeafNode<readonly SelectItem[]>
-{
-	private readonly selectExclusive: boolean;
-	private readonly validation: SharedValidationState;
-
-	// XFormsXPathElement
-	override readonly [XPathNodeKindKey] = 'element';
-
-	// InstanceNode
-	protected readonly state: SharedNodeState<SelectFieldStateSpec>;
-	protected override engineState: EngineState<SelectFieldStateSpec>;
-
-	// SelectNode
-	readonly nodeType = 'select';
-	readonly appearances: SelectNodeAppearances;
-	readonly currentState: CurrentState<SelectFieldStateSpec>;
-
-	get validationState(): LeafNodeValidationState {
-		return this.validation.currentState;
-	}
-
-	readonly submissionState: SubmissionState;
-
-	// ValueContext
-	override readonly contextNode = this;
-
-	readonly encodeValue = (runtimeValue: readonly SelectItem[]): string => {
-		const itemValues = new Set(runtimeValue.map(({ value }) => value));
-		const selectedItems = this.getValueOptions().filter(({ value }) => {
-			return itemValues.has(value);
-		});
-
-		return selectedItems.map(({ value }) => value).join(' ');
-	};
-
-	readonly decodeValue = (instanceValue: string): readonly SelectItem[] => {
-		const itemValues = new Set(
-			xmlXPathWhitespaceSeparatedList(instanceValue, {
-				ignoreEmpty: true,
-			})
-		);
-
-		// TODO: also want set-like behavior, probably?
-		return this.getValueOptions().filter((option) => {
-			return itemValues.has(option.value);
-		});
-	};
-
-	protected readonly getValueOptions: Accessor<readonly SelectItem[]>;
-	protected readonly getValue: Accessor<readonly SelectItem[]>;
-
-	constructor(parent: GeneralParentNode, definition: SelectFieldDefinition) {
-		super(parent, definition);
-
-		this.appearances = definition.bodyElement.appearances;
-		this.selectExclusive = definition.bodyElement.type === 'select1';
-
-		const valueOptions = createSelectItems(this);
-
-		this.getValueOptions = valueOptions;
-
-		const [baseGetValue, setValue] = createValueState(this);
-
-		const getValue = this.scope.runTask(() => {
-			const selectItemsByValue = createMemo((): ReadonlyMap<string, SelectItem> => {
-				return new Map(valueOptions().map((item) => [item.value, item]));
-			});
-
-			return createMemo(() => {
-				const items = selectItemsByValue();
-
-				return baseGetValue().filter((item) => {
-					return items.has(item.value);
-				});
-			});
-		});
-
-		this.getValue = getValue;
-
-		const valueState: SimpleAtomicState<readonly SelectItem[]> = [getValue, setValue];
-
-		const sharedStateOptions = {
-			clientStateFactory: this.engineConfig.stateFactory,
-		};
-
-		const state = createSharedNodeState(
-			this.scope,
-			{
-				reference: this.contextReference,
-				readonly: this.isReadonly,
-				relevant: this.isRelevant,
-				required: this.isRequired,
-
-				label: createNodeLabel(this, definition),
-				hint: createFieldHint(this, definition),
-				children: null,
-				value: valueState,
-				valueOptions,
-			},
-			sharedStateOptions
-		);
-
-		this.state = state;
-		this.engineState = state.engineState;
-		this.currentState = state.currentState;
-		this.validation = createValidationState(this, sharedStateOptions);
-		this.submissionState = createLeafNodeSubmissionState(this);
-	}
-
-	protected getSelectItemsByValue(
-		valueOptions: readonly SelectItem[] = this.getValueOptions()
-	): ReadonlyMap<string, SelectItem> {
-		return new Map(
-			valueOptions.map((item) => {
-				return [item.value, item];
-			})
-		);
-	}
-
-	protected updateSelectedItemValues(values: readonly string[]) {
-		const itemsByValue = untrack(() => this.getSelectItemsByValue());
-
-		const items = values.flatMap((value) => {
-			const item = itemsByValue.get(value);
-
-			if (item == null) {
-				return [];
-			}
-
-			return item ?? [];
-		});
-
-		this.state.setProperty('value', items);
-	}
-
-	protected setSelectedItemValue(value: string | null) {
-		if (value == null) {
-			this.state.setProperty('value', []);
-
-			return;
-		}
-
-		this.updateSelectedItemValues([value]);
-	}
-
-	// XFormsXPathElement
-	override getXPathValue(): string {
-		return this.encodeValue(this.engineState.value);
-	}
-
-	// SelectNode
-	select(selectedItem: SelectItem): Root {
-		const { engineState, root } = this;
-
-		if (this.selectExclusive) {
-			this.setSelectedItemValue(selectedItem.value);
-
-			return root;
-		}
-
-		const currentValues = engineState.value.map(({ value }) => {
-			return value;
-		});
-
-		const selectedValue = selectedItem.value;
-
-		if (currentValues.includes(selectedValue)) {
-			return root;
-		}
-
-		this.updateSelectedItemValues(currentValues.concat(selectedValue));
-
-		return root;
-	}
-
-	deselect(deselectedItem: SelectItem): Root {
-		const { engineState, root } = this;
-
-		const currentValues = engineState.value.map(({ value }) => {
-			return value;
-		});
-
-		const selectedValue = deselectedItem.value;
-
-		if (!currentValues.includes(selectedValue)) {
-			return root;
-		}
-
-		const updatedValues = currentValues.filter((value) => {
-			return value !== selectedValue;
-		});
-
-		this.updateSelectedItemValues(updatedValues);
-
-		return root;
-	}
-
-	// InstanceNode
-	getChildren(): readonly [] {
-		return [];
-	}
-
-	// ValidationContext
-	getViolation(): AnyViolation | null {
-		return this.validation.engineState.violation;
-	}
-
-	isBlank(): boolean {
-		return this.engineState.value.length === 0;
-	}
-}