@getodk/xforms-engine 0.3.0 → 0.5.0

package/dist/lib/xml-serialization.d.ts

@@ -0,0 +1,41 @@
+declare const ESCAPED_XML_TEXT_BRAND: unique symbol;
+export type EscapedXMLText = string & {
+    readonly [ESCAPED_XML_TEXT_BRAND]: true;
+};
+/**
+ * This is based on the `escapeHTML` implementation in
+ * {@link https://github.com/ryansolid/dom-expressions} (Solid's JSX transform).
+ *
+ * @see {@link https://github.com/ryansolid/dom-expressions/pull/27} for
+ * motivation to derive this implementation approach.
+ *
+ * The intent is that this can be updated easily if the base implementation
+ * changes. As such, some aspects of this implementation differ from some of our
+ * typical code style preferences.
+ *
+ * Notable changes from the base implementation:
+ *
+ * - Formatting: automated only.
+ * - Naming: the {@link text} parameter is named `html` in the base
+ *   implementation. That would be confusing if preserved.
+ * - Types:
+ *     - Parameter types are added (of course)
+ *     - Return type is branded as {@link EscapedXMLText}, to allow downstream
+ *       checks that escaping has been performed. Return statements are cast
+ *       accordingly.
+ *     - {@link text} attempts to minimize risk of double-escaping by excluding
+ *       that same branded type.
+ * - The '>' character is also escaped, necessary for producing valid XML.
+ *
+ * As with the base implementation, we leave some characters unescaped:
+ *
+ * - " (double quote): except when {@link attr} is `true`.
+ *
+ * - ' (single quote): on the assumption that attributes are always serialized
+ *   in double quotes. If we ever move this to `@getodk/common`, we'd want to
+ *   reconsider this assumption.
+ */
+export declare const escapeXMLText: <Text extends string>(text: Exclude<Text, EscapedXMLText>, attr?: boolean) => EscapedXMLText;
+export declare const serializeParentElementXML: (nodeName: string, serializedChildren: readonly string[]) => string;
+export declare const serializeLeafElementXML: (nodeName: string, xmlValue: EscapedXMLText) => string;
+export {};

package/dist/parse/XFormDOM.d.ts

@@ -0,0 +1,42 @@
+import { KnownAttributeLocalNamedElement } from '../../../common/types/dom.ts';
+interface DOMBindElement extends KnownAttributeLocalNamedElement<'bind', 'nodeset'> {
+}
+export interface DOMItextTranslationElement extends KnownAttributeLocalNamedElement<'translation', 'lang'> {
+}
+export interface DOMSecondaryInstanceElement extends KnownAttributeLocalNamedElement<'instance', 'id'> {
+}
+interface XFormDOMOptions {
+    readonly isNormalized: boolean;
+}
+/**
+ * @todo **Everything** in this class should be cacheable. Maybe not worth it
+ * for small forms, but may make a pretty substantial difference for very large
+ * forms (in bytes) in sessions creating multiple instances of the same form.
+ */
+export declare class XFormDOM {
+    protected readonly sourceXML: string;
+    static from(sourceXML: string): XFormDOM;
+    protected readonly normalizedXML: string;
+    readonly xformDocument: XMLDocument;
+    readonly html: Element;
+    readonly head: Element;
+    readonly title: Element;
+    readonly model: Element;
+    readonly binds: readonly DOMBindElement[];
+    readonly primaryInstance: Element;
+    readonly primaryInstanceRoot: Element;
+    readonly itextTranslationElements: readonly DOMItextTranslationElement[];
+    readonly secondaryInstanceElements: readonly DOMSecondaryInstanceElement[];
+    readonly body: Element;
+    protected constructor(sourceXML: string, options: XFormDOMOptions);
+    toJSON(): Omit<this, "head" | "html" | "title" | "toJSON" | "model" | "primaryInstanceRoot" | "primaryInstance" | "xformDocument"> & {
+        xformDocument: string;
+        html: string;
+        head: string;
+        title: string;
+        model: string;
+        primaryInstance: string;
+        primaryInstanceRoot: string;
+    };
+}
+export {};

package/dist/{XFormDefinition.d.ts → parse/XFormDefinition.d.ts}

@@ -1,9 +1,7 @@
-import { XFormDOM } from './XFormDOM.ts';
-import { BodyDefinition } from './body/BodyDefinition.ts';
+import { BodyDefinition } from '../parse/body/BodyDefinition.ts';
 import { ModelDefinition } from './model/ModelDefinition.ts';
-
+import { XFormDOM } from './XFormDOM.ts';
 export declare class XFormDefinition {
-    readonly sourceXML: string;
     readonly xformDOM: XFormDOM;
     readonly xformDocument: XMLDocument;
     readonly id: string;
@@ -11,5 +9,5 @@ export declare class XFormDefinition {
     readonly rootReference: string;
     readonly body: BodyDefinition;
     readonly model: ModelDefinition;
-    constructor(sourceXML: string);
+    constructor(xformDOM: XFormDOM);
 }

package/dist/parse/attachments/FormAttachmentResource.d.ts

@@ -0,0 +1,27 @@
+import { JRResourceURL } from '../../../../common/src/jr-resources/JRResourceURL.ts';
+export type FormAttachmentDataType = 'media' | 'secondary-instance';
+/**
+ * @todo This type anticipates work to support media form attachments, which
+ * will tend to be associated with binary data. The
+ * expectation is that:
+ *
+ * - {@link Blob} would be appropriate for representing data from attachment
+ *   resources which are conventionally loaded to completion (where network
+ *   conditions are favorable), such as images
+ *
+ * - {@link MediaSource} or {@link ReadableStream} may be more appropriate for
+ *   representing data from resources which are conventionally streamed in a
+ *   browser context (often regardless of network conditions), such as video and
+ *   audio
+ */
+export type FormAttachmentMediaData = Blob | MediaSource | ReadableStream<unknown>;
+export type FormAttachmentSecondaryInstanceData = string;
+type FormAttachmentData<DataType extends FormAttachmentDataType> = DataType extends 'media' ? FormAttachmentMediaData : FormAttachmentSecondaryInstanceData;
+export declare abstract class FormAttachmentResource<DataType extends FormAttachmentDataType> {
+    readonly dataType: DataType;
+    readonly resourceURL: JRResourceURL;
+    readonly contentType: string;
+    readonly data: FormAttachmentData<DataType>;
+    protected constructor(dataType: DataType, resourceURL: JRResourceURL, contentType: string, data: FormAttachmentData<DataType>);
+}
+export {};

package/dist/{body → parse/body}/BodyDefinition.d.ts

@@ -1,19 +1,23 @@
-import { XFormDefinition } from '../XFormDefinition.ts';
-import { DependencyContext } from '../expression/DependencyContext.ts';
-import { ParsedTokenList, TokenListParser } from '../lib/TokenListParser.ts';
-import { RepeatElementDefinition } from './RepeatElementDefinition.ts';
-import { UnsupportedBodyElementDefinition } from './UnsupportedBodyElementDefinition.ts';
-import { InputDefinition } from './control/InputDefinition.ts';
+import { ParsedTokenList, TokenListParser } from '../../lib/TokenListParser.ts';
+import { XFormDefinition } from '../../parse/XFormDefinition.ts';
+import { DependencyContext } from '../expression/abstract/DependencyContext.ts';
+import { InputControlDefinition } from './control/InputControlDefinition.ts';
+import { RangeControlDefinition } from './control/RangeControlDefinition.ts';
+import { RankControlDefinition } from './control/RankControlDefinition.ts';
 import { AnySelectDefinition } from './control/select/SelectDefinition.ts';
+import { TriggerControlDefinition } from './control/TriggerControlDefinition.ts';
+import { UploadControlDefinition } from './control/UploadControlDefinition.ts';
 import { LogicalGroupDefinition } from './group/LogicalGroupDefinition.ts';
 import { PresentationGroupDefinition } from './group/PresentationGroupDefinition.ts';
 import { StructuralGroupDefinition } from './group/StructuralGroupDefinition.ts';
-
+import { RepeatElementDefinition } from './RepeatElementDefinition.ts';
+import { UnsupportedBodyElementDefinition } from './UnsupportedBodyElementDefinition.ts';
 export interface BodyElementParentContext {
+    readonly body: BodyDefinition;
     readonly reference: string | null;
     readonly element: Element;
 }
-export type ControlElementDefinition = AnySelectDefinition | InputDefinition;
+export type ControlElementDefinition = AnySelectDefinition | InputControlDefinition | RangeControlDefinition | RankControlDefinition | TriggerControlDefinition | UploadControlDefinition;
 type SupportedBodyElementDefinition = RepeatElementDefinition | LogicalGroupDefinition | PresentationGroupDefinition | StructuralGroupDefinition | ControlElementDefinition;
 export type AnyBodyElementDefinition = SupportedBodyElementDefinition | UnsupportedBodyElementDefinition;
 export type BodyElementDefinitionArray = readonly AnyBodyElementDefinition[];
@@ -38,9 +42,9 @@ declare class BodyElementMap extends Map<BodyElementReference, AnyBodyElementDef
 }
 declare const bodyClassParser: TokenListParser<"pages", "pages">;
 export type BodyClassList = ParsedTokenList<typeof bodyClassParser>;
-export declare class BodyDefinition extends DependencyContext {
+export declare class BodyDefinition extends DependencyContext implements BodyElementParentContext {
     protected readonly form: XFormDefinition;
-    static getChildElementDefinitions(form: XFormDefinition, parent: BodyElementParentContext, parentElement: Element, children?: readonly Element[]): readonly AnyBodyElementDefinition[];
+    readonly body: BodyDefinition;
     readonly element: Element;
     /**
      * @todo this class is already an oddity in that it's **like** an element
@@ -65,6 +69,7 @@ export declare class BodyDefinition extends DependencyContext {
     readonly reference: string;
     constructor(form: XFormDefinition);
     getBodyElement(reference: string): AnyBodyElementDefinition | null;
-    toJSON(): Omit<this, "toJSON" | "form" | "isTranslated" | "registerDependentExpression" | "dependencyExpressions" | "getBodyElement">;
+    getChildElementDefinitions(form: XFormDefinition, parent: BodyElementParentContext, parentElement: Element, children?: readonly Element[]): readonly AnyBodyElementDefinition[];
+    toJSON(): Omit<this, "form" | "toJSON" | "isTranslated" | "getBodyElement" | "getChildElementDefinitions">;
 }
 export {};

package/dist/{body → parse/body}/BodyElementDefinition.d.ts

@@ -1,21 +1,21 @@
+import { DependencyContext } from '../expression/abstract/DependencyContext.ts';
+import { HintDefinition } from '../text/HintDefinition.ts';
+import { ItemLabelDefinition } from '../text/ItemLabelDefinition.ts';
+import { LabelDefinition } from '../text/LabelDefinition.ts';
 import { XFormDefinition } from '../XFormDefinition.ts';
-import { DependencyContext } from '../expression/DependencyContext.ts';
-import { HintDefinition } from '../parse/text/HintDefinition.ts';
-import { ItemLabelDefinition } from '../parse/text/ItemLabelDefinition.ts';
-import { LabelDefinition } from '../parse/text/LabelDefinition.ts';
-import { BodyElementParentContext } from './BodyDefinition.ts';
-
+import { BodyDefinition, BodyElementParentContext } from './BodyDefinition.ts';
 /**
  * These category names roughly correspond to each of the ODK XForms spec's
  * {@link https://getodk.github.io/xforms-spec/#body-elements | Body Elements}
  * tables.
  */
 type BodyElementCategory = 'control' | 'structure' | 'support' | 'UNSUPPORTED';
-export declare abstract class BodyElementDefinition<Type extends string> extends DependencyContext {
+export declare abstract class BodyElementDefinition<Type extends string> extends DependencyContext implements BodyElementParentContext {
     protected readonly form: XFormDefinition;
     readonly parent: BodyElementParentContext;
     readonly element: Element;
     static isCompatible(localName: string, element: Element): boolean;
+    readonly body: BodyDefinition;
     abstract readonly category: BodyElementCategory;
     abstract readonly type: Type;
     readonly hint: HintDefinition | null;

package/dist/{body → parse/body}/RepeatElementDefinition.d.ts

@@ -1,9 +1,8 @@
 import { XFormDefinition } from '../XFormDefinition.ts';
-import { LabelDefinition } from '../parse/text/LabelDefinition.ts';
-import { BodyElementDefinitionArray, BodyElementParentContext } from './BodyDefinition.ts';
+import { BodyElementDefinitionArray, BodyElementParentContext } from '../body/BodyDefinition.ts';
+import { LabelDefinition } from '../text/LabelDefinition.ts';
 import { BodyElementDefinition } from './BodyElementDefinition.ts';
 import { StructureElementAppearanceDefinition } from './appearance/structureElementAppearanceParser.ts';
-
 export declare class RepeatElementDefinition extends BodyElementDefinition<'repeat'> {
     static isCompatible(localName: string): boolean;
     readonly category = "structure";
@@ -15,5 +14,5 @@ export declare class RepeatElementDefinition extends BodyElementDefinition<'repe
     readonly noAddRemoveExpression: string | null;
     readonly children: BodyElementDefinitionArray;
     constructor(form: XFormDefinition, parent: BodyElementParentContext, element: Element);
-    toJSON(): Omit<this, "toJSON" | "form" | "parent" | "isTranslated" | "registerDependentExpression" | "dependencyExpressions">;
+    toJSON(): Omit<this, "parent" | "form" | "toJSON" | "isTranslated">;
 }

package/dist/{body → parse/body}/UnsupportedBodyElementDefinition.d.ts

@@ -1,7 +1,6 @@
 import { XFormDefinition } from '../XFormDefinition.ts';
 import { BodyElementParentContext } from './BodyDefinition.ts';
 import { BodyElementDefinition } from './BodyElementDefinition.ts';
-
 export declare class UnsupportedBodyElementDefinition extends BodyElementDefinition<'UNSUPPORTED'> {
     static isCompatible(): boolean;
     readonly category = "UNSUPPORTED";

package/dist/parse/body/appearance/inputAppearanceParser.d.ts

@@ -0,0 +1,3 @@
+import { TokenListParser, ParsedTokenList } from '../../../lib/TokenListParser.ts';
+export declare const inputAppearanceParser: TokenListParser<"multiline" | "numbers" | "url" | "thousands-sep" | "no-calendar" | "month-year" | "year" | "ethiopian" | "coptic" | "islamic" | "bikram-sambat" | "myanmar" | "persian" | "placement-map" | "maps" | "hidden-answer" | "annotate" | "draw" | "signature" | "new-front" | "new" | "front" | "printer" | "masked", "multiline" | "numbers" | "url" | "thousands-sep" | "no-calendar" | "month-year" | "year" | "ethiopian" | "coptic" | "islamic" | "bikram-sambat" | "myanmar" | "persian" | "placement-map" | "maps" | "hidden-answer" | "annotate" | "draw" | "signature" | "new-front" | "new" | "front" | "printer" | "masked">;
+export type InputAppearanceDefinition = ParsedTokenList<typeof inputAppearanceParser>;

package/dist/{body → parse/body}/appearance/selectAppearanceParser.d.ts

@@ -1,4 +1,3 @@
-import { TokenListParser, ParsedTokenList } from '../../lib/TokenListParser.ts';
-
+import { TokenListParser, ParsedTokenList } from '../../../lib/TokenListParser.ts';
 export declare const selectAppearanceParser: TokenListParser<"map" | "label" | "compact" | "horizontal" | "horizontal-compact" | "list-nolabel" | "minimal" | "columns" | "columns-1" | "columns-2" | "columns-3" | "columns-4" | "columns-5" | "columns-pack" | "autocomplete" | "likert" | "quick" | "quickcompact", "autocomplete">;
 export type SelectAppearanceDefinition = ParsedTokenList<typeof selectAppearanceParser>;

package/dist/{body → parse/body}/appearance/structureElementAppearanceParser.d.ts

@@ -1,4 +1,3 @@
-import { TokenListParser, ParsedTokenList } from '../../lib/TokenListParser.ts';
-
+import { TokenListParser, ParsedTokenList } from '../../../lib/TokenListParser.ts';
 export declare const structureElementAppearanceParser: TokenListParser<"field-list" | "table-list", "field-list" | "table-list">;
 export type StructureElementAppearanceDefinition = ParsedTokenList<typeof structureElementAppearanceParser>;

package/dist/parse/body/appearance/unknownAppearanceParser.d.ts

@@ -0,0 +1,3 @@
+import { TokenListParser, ParsedTokenList } from '../../../lib/TokenListParser.ts';
+export declare const unknownAppearanceParser: TokenListParser<string, string>;
+export type UnknownAppearanceDefinition = ParsedTokenList<typeof unknownAppearanceParser>;

package/dist/{body → parse/body}/control/ControlDefinition.d.ts

@@ -1,10 +1,9 @@
+import { ParsedTokenList } from '../../../lib/TokenListParser.ts';
+import { HintDefinition } from '../../text/HintDefinition.ts';
+import { LabelDefinition } from '../../text/LabelDefinition.ts';
 import { XFormDefinition } from '../../XFormDefinition.ts';
-import { ParsedTokenList } from '../../lib/TokenListParser.ts';
-import { HintDefinition } from '../../parse/text/HintDefinition.ts';
-import { LabelDefinition } from '../../parse/text/LabelDefinition.ts';
 import { BodyElementParentContext } from '../BodyDefinition.ts';
 import { BodyElementDefinition } from '../BodyElementDefinition.ts';
-
 type ControlType = 'input' | 'range' | 'rank' | 'select' | 'select1' | 'trigger' | 'upload';
 export declare abstract class ControlDefinition<Type extends ControlType> extends BodyElementDefinition<Type> {
     readonly category = "control";

package/dist/{body/control/InputDefinition.d.ts → parse/body/control/InputControlDefinition.d.ts}

@@ -1,9 +1,8 @@
 import { XFormDefinition } from '../../XFormDefinition.ts';
-import { BodyElementParentContext } from '../BodyDefinition.ts';
 import { InputAppearanceDefinition } from '../appearance/inputAppearanceParser.ts';
+import { BodyElementParentContext } from '../BodyDefinition.ts';
 import { ControlDefinition } from './ControlDefinition.ts';
-
-export declare class InputDefinition extends ControlDefinition<'input'> {
+export declare class InputControlDefinition extends ControlDefinition<'input'> {
     static isCompatible(localName: string): boolean;
     readonly type = "input";
     readonly appearances: InputAppearanceDefinition;

package/dist/parse/body/control/RangeControlDefinition.d.ts

@@ -0,0 +1,11 @@
+import { XFormDefinition } from '../../XFormDefinition.ts';
+import { UnknownAppearanceDefinition } from '../appearance/unknownAppearanceParser.ts';
+import { BodyElementParentContext } from '../BodyDefinition.ts';
+import { ControlDefinition } from './ControlDefinition.ts';
+export declare class RangeControlDefinition extends ControlDefinition<'range'> {
+    static isCompatible(localName: string): boolean;
+    readonly type = "range";
+    readonly appearances: UnknownAppearanceDefinition;
+    constructor(form: XFormDefinition, parent: BodyElementParentContext, element: Element);
+    toJSON(): object;
+}

package/dist/parse/body/control/RankControlDefinition.d.ts

@@ -0,0 +1,11 @@
+import { XFormDefinition } from '../../XFormDefinition.ts';
+import { UnknownAppearanceDefinition } from '../appearance/unknownAppearanceParser.ts';
+import { BodyElementParentContext } from '../BodyDefinition.ts';
+import { ControlDefinition } from './ControlDefinition.ts';
+export declare class RankControlDefinition extends ControlDefinition<'rank'> {
+    static isCompatible(localName: string, element: Element): boolean;
+    readonly type = "rank";
+    readonly appearances: UnknownAppearanceDefinition;
+    constructor(form: XFormDefinition, parent: BodyElementParentContext, element: Element);
+    toJSON(): object;
+}

package/dist/parse/body/control/TriggerControlDefinition.d.ts

@@ -0,0 +1,11 @@
+import { XFormDefinition } from '../../XFormDefinition.ts';
+import { UnknownAppearanceDefinition } from '../appearance/unknownAppearanceParser.ts';
+import { BodyElementParentContext } from '../BodyDefinition.ts';
+import { ControlDefinition } from './ControlDefinition.ts';
+export declare class TriggerControlDefinition extends ControlDefinition<'trigger'> {
+    static isCompatible(localName: string): boolean;
+    readonly type = "trigger";
+    readonly appearances: UnknownAppearanceDefinition;
+    constructor(form: XFormDefinition, parent: BodyElementParentContext, element: Element);
+    toJSON(): object;
+}

package/dist/parse/body/control/UploadControlDefinition.d.ts

@@ -0,0 +1,11 @@
+import { XFormDefinition } from '../../XFormDefinition.ts';
+import { UnknownAppearanceDefinition } from '../appearance/unknownAppearanceParser.ts';
+import { BodyElementParentContext } from '../BodyDefinition.ts';
+import { ControlDefinition } from './ControlDefinition.ts';
+export declare class UploadControlDefinition extends ControlDefinition<'upload'> {
+    static isCompatible(localName: string): boolean;
+    readonly type = "upload";
+    readonly appearances: UnknownAppearanceDefinition;
+    constructor(form: XFormDefinition, parent: BodyElementParentContext, element: Element);
+    toJSON(): object;
+}

package/dist/{body → parse/body}/control/select/ItemDefinition.d.ts

@@ -1,9 +1,8 @@
-import { ItemElement } from '../../../lib/dom/query.ts';
-import { ItemLabelDefinition } from '../../../parse/text/ItemLabelDefinition.ts';
+import { ItemElement } from '../../../../lib/dom/query.ts';
+import { ItemLabelDefinition } from '../../../text/ItemLabelDefinition.ts';
 import { XFormDefinition } from '../../../XFormDefinition.ts';
 import { BodyElementDefinition } from '../../BodyElementDefinition.ts';
 import { AnySelectDefinition } from './SelectDefinition.ts';
-
 export declare class ItemDefinition extends BodyElementDefinition<'item'> {
     readonly parent: AnySelectDefinition;
     readonly category = "support";

package/dist/{body → parse/body}/control/select/ItemsetDefinition.d.ts

@@ -1,11 +1,10 @@
+import { ItemsetElement } from '../../../../lib/dom/query.ts';
+import { ItemsetNodesetExpression } from '../../../expression/ItemsetNodesetExpression.ts';
+import { ItemsetValueExpression } from '../../../expression/ItemsetValueExpression.ts';
+import { ItemsetLabelDefinition } from '../../../text/ItemsetLabelDefinition.ts';
 import { XFormDefinition } from '../../../XFormDefinition.ts';
-import { ItemsetElement } from '../../../lib/dom/query.ts';
-import { ItemsetLabelDefinition } from '../../../parse/text/ItemsetLabelDefinition.ts';
 import { BodyElementDefinition } from '../../BodyElementDefinition.ts';
-import { ItemsetNodesetExpression } from './ItemsetNodesetExpression.ts';
-import { ItemsetValueExpression } from './ItemsetValueExpression.ts';
 import { AnySelectDefinition } from './SelectDefinition.ts';
-
 export declare class ItemsetDefinition extends BodyElementDefinition<'itemset'> {
     readonly parent: AnySelectDefinition;
     readonly category = "support";

package/dist/{body → parse/body}/control/select/ItemsetNodesetContext.d.ts

@@ -1,12 +1,9 @@
-import { DependencyContext } from '../../../expression/DependencyContext.ts';
-import { AnyDependentExpression } from '../../../expression/DependentExpression.ts';
+import { DependencyContext } from '../../../expression/abstract/DependencyContext.ts';
 import { ItemsetDefinition } from './ItemsetDefinition.ts';
-
 export declare class ItemsetNodesetContext extends DependencyContext {
     protected readonly itemset: ItemsetDefinition;
     readonly parentReference: null;
     readonly reference: string;
     constructor(itemset: ItemsetDefinition, nodesetExpression: string);
     set isTranslated(value: true);
-    registerDependentExpression(expression: AnyDependentExpression): void;
 }

package/dist/{body → parse/body}/control/select/SelectDefinition.d.ts

@@ -1,20 +1,11 @@
-import { CollectionValues } from '../../../../../common/types/collections/CollectionValues.ts';
-import { LocalNamedElement } from '../../../../../common/types/dom.ts';
+import { CollectionValues } from '../../../../../../common/types/collections/CollectionValues.ts';
+import { LocalNamedElement } from '../../../../../../common/types/dom.ts';
 import { XFormDefinition } from '../../../XFormDefinition.ts';
-import { AnyBodyElementDefinition, BodyElementParentContext } from '../../BodyDefinition.ts';
 import { SelectAppearanceDefinition } from '../../appearance/selectAppearanceParser.ts';
+import { AnyBodyElementDefinition, BodyElementParentContext } from '../../BodyDefinition.ts';
 import { ControlDefinition } from '../ControlDefinition.ts';
 import { ItemDefinition } from './ItemDefinition.ts';
 import { ItemsetDefinition } from './ItemsetDefinition.ts';
-
-/**
- * @todo We were previously a bit overzealous about introducing `<rank>` support
- * here. It'll likely still fit, but we should approach it with more intention.
- *
- * @todo `<trigger>` is *almost* reasonable to support here too. The main
- * hesitation is that its single, implicit "item" does not have a distinct
- * <label>, and presumably has different UX **and translation** considerations.
- */
 declare const selectLocalNames: Set<"select" | "select1">;
 export type SelectType = CollectionValues<typeof selectLocalNames>;
 export interface SelectElement extends LocalNamedElement<SelectType> {

package/dist/{body → parse/body}/group/BaseGroupDefinition.d.ts

@@ -1,9 +1,8 @@
+import { LabelDefinition } from '../../text/LabelDefinition.ts';
 import { XFormDefinition } from '../../XFormDefinition.ts';
-import { LabelDefinition } from '../../parse/text/LabelDefinition.ts';
+import { StructureElementAppearanceDefinition } from '../appearance/structureElementAppearanceParser.ts';
 import { BodyElementDefinitionArray, BodyElementParentContext } from '../BodyDefinition.ts';
 import { BodyElementDefinition } from '../BodyElementDefinition.ts';
-import { StructureElementAppearanceDefinition } from '../appearance/structureElementAppearanceParser.ts';
-
 /**
  * These type names are derived from **and expand upon** the language used in
  * the ODK XForms spec to describe various group usage. Whereas the spec
@@ -37,6 +36,5 @@ export declare abstract class BaseGroupDefinition<Type extends GroupType> extend
     readonly reference: string | null;
     readonly appearances: StructureElementAppearanceDefinition;
     readonly label: LabelDefinition | null;
-    constructor(form: XFormDefinition, parent: BodyElementParentContext, element: Element, children?: BodyElementDefinitionArray);
-    getChildren(element: Element): BodyElementDefinitionArray;
+    constructor(form: XFormDefinition, parent: BodyElementParentContext, element: Element);
 }

package/dist/{body → parse/body}/group/LogicalGroupDefinition.d.ts

@@ -1,5 +1,4 @@
 import { BaseGroupDefinition } from './BaseGroupDefinition.ts';
-
 export declare class LogicalGroupDefinition extends BaseGroupDefinition<'logical-group'> {
     static isCompatible(localName: string, element: Element): boolean;
     readonly type = "logical-group";

package/dist/{body → parse/body}/group/PresentationGroupDefinition.d.ts

@@ -1,8 +1,7 @@
+import { LabelDefinition } from '../../text/LabelDefinition.ts';
 import { XFormDefinition } from '../../XFormDefinition.ts';
-import { LabelDefinition } from '../../parse/text/LabelDefinition.ts';
 import { BodyElementParentContext } from '../BodyDefinition.ts';
 import { BaseGroupDefinition } from './BaseGroupDefinition.ts';
-
 export declare class PresentationGroupDefinition extends BaseGroupDefinition<'presentation-group'> {
     static isCompatible(localName: string, element: Element): boolean;
     readonly type = "presentation-group";

package/dist/{body → parse/body}/group/StructuralGroupDefinition.d.ts

@@ -1,5 +1,4 @@
 import { BaseGroupDefinition } from './BaseGroupDefinition.ts';
-
 export declare class StructuralGroupDefinition extends BaseGroupDefinition<'structural-group'> {
     static isCompatible(localName: string, element: Element): boolean;
     readonly type = "structural-group";

package/dist/{model/BindComputation.d.ts → parse/expression/BindComputationExpression.d.ts}

@@ -1,6 +1,5 @@
-import { DependentExpression } from '../expression/DependentExpression.ts';
-import { BindDefinition } from './BindDefinition.ts';
-
+import { BindDefinition } from '../model/BindDefinition.ts';
+import { DependentExpression } from './abstract/DependentExpression.ts';
 declare const defaultBindComputationExpressions: {
     readonly calculate: null;
     readonly constraint: "true()";
@@ -11,7 +10,7 @@ declare const defaultBindComputationExpressions: {
 };
 type DefaultBindComputationExpressions = typeof defaultBindComputationExpressions;
 export type BindComputationType = keyof DefaultBindComputationExpressions;
-type BindComputationFactoryResult<Type extends BindComputationType> = DefaultBindComputationExpressions[Type] extends null ? BindComputation<Type> | null : BindComputation<Type>;
+type BindComputationFactoryResult<Type extends BindComputationType> = DefaultBindComputationExpressions[Type] extends null ? BindComputationExpression<Type> | null : BindComputationExpression<Type>;
 declare const bindComputationResultTypes: {
     readonly calculate: "string";
     readonly constraint: "boolean";
@@ -22,9 +21,9 @@ declare const bindComputationResultTypes: {
 };
 type BindComputationResultTypes = typeof bindComputationResultTypes;
 export type BindComputationResultType<Computation extends BindComputationType> = BindComputationResultTypes[Computation];
-export declare class BindComputation<Computation extends BindComputationType> extends DependentExpression<BindComputationResultType<Computation>> {
+export declare class BindComputationExpression<Computation extends BindComputationType> extends DependentExpression<BindComputationResultType<Computation>> {
     readonly computation: Computation;
-    static forExpression<Type extends BindComputationType>(bind: BindDefinition, computation: Type): BindComputationFactoryResult<Type>;
+    static forComputation<Type extends BindComputationType>(bind: BindDefinition, computation: Type): BindComputationFactoryResult<Type>;
     readonly isDefaultExpression: boolean;
     protected constructor(bind: BindDefinition, computation: Computation, expression: string | null);
 }

package/dist/{body/control/select → parse/expression}/ItemsetNodesetExpression.d.ts

@@ -1,6 +1,5 @@
-import { DependentExpression } from '../../../expression/DependentExpression.ts';
-import { ItemsetDefinition } from './ItemsetDefinition.ts';
-
+import { ItemsetDefinition } from '../body/control/select/ItemsetDefinition.ts';
+import { DependentExpression } from './abstract/DependentExpression.ts';
 export declare class ItemsetNodesetExpression extends DependentExpression<'nodes'> {
     constructor(itemset: ItemsetDefinition, nodesetExpression: string);
 }

package/dist/{body/control/select → parse/expression}/ItemsetValueExpression.d.ts

@@ -1,6 +1,5 @@
-import { DependentExpression } from '../../../expression/DependentExpression.ts';
-import { ItemsetDefinition } from './ItemsetDefinition.ts';
-
+import { ItemsetDefinition } from '../body/control/select/ItemsetDefinition.ts';
+import { DependentExpression } from './abstract/DependentExpression.ts';
 export declare class ItemsetValueExpression extends DependentExpression<'string'> {
     readonly itemset: ItemsetDefinition;
     constructor(itemset: ItemsetDefinition, expression: string);

package/dist/parse/expression/RepeatCountControlExpression.d.ts

@@ -1,6 +1,5 @@
-import { RepeatElementDefinition } from '../../body/RepeatElementDefinition.ts';
-import { DependentExpression } from '../../expression/DependentExpression.ts';
-
+import { RepeatElementDefinition } from '../body/RepeatElementDefinition.ts';
+import { DependentExpression } from './abstract/DependentExpression.ts';
 /**
  * Represents either of these
  * {@link https://getodk.github.io/xforms-spec/#body-attributes | body attributes}:

package/dist/parse/expression/TextLiteralExpression.d.ts

@@ -0,0 +1,9 @@
+import { AnyTextRangeDefinition } from '../text/abstract/TextRangeDefinition.ts';
+import { TextChunkExpression } from './abstract/TextChunkExpression.ts';
+export type TextLiteralSourceNode = Attr | Text;
+export declare class TextLiteralExpression extends TextChunkExpression<'literal'> {
+    readonly stringValue: string;
+    static from(context: AnyTextRangeDefinition, stringValue: string): TextLiteralExpression;
+    readonly source = "literal";
+    private constructor();
+}

package/dist/parse/expression/TextOutputExpression.d.ts

@@ -0,0 +1,7 @@
+import { AnyTextRangeDefinition } from '../text/abstract/TextRangeDefinition.ts';
+import { TextChunkExpression } from './abstract/TextChunkExpression.ts';
+export declare class TextOutputExpression extends TextChunkExpression<'output'> {
+    static from(context: AnyTextRangeDefinition, element: Element): TextOutputExpression | null;
+    readonly source = "output";
+    private constructor();
+}

package/dist/parse/expression/TextReferenceExpression.d.ts

@@ -0,0 +1,7 @@
+import { AnyTextRangeDefinition } from '../text/abstract/TextRangeDefinition.ts';
+import { TextChunkExpression } from './abstract/TextChunkExpression.ts';
+export declare class TextReferenceExpression extends TextChunkExpression<'reference'> {
+    static from(context: AnyTextRangeDefinition, refExpression: string): TextReferenceExpression;
+    readonly source = "reference";
+    private constructor();
+}

package/dist/parse/expression/TextTranslationExpression.d.ts

@@ -0,0 +1,8 @@
+import { AnyTextRangeDefinition } from '../text/abstract/TextRangeDefinition.ts';
+import { TextChunkExpression } from './abstract/TextChunkExpression.ts';
+export declare class TextTranslationExpression extends TextChunkExpression<'translation'> {
+    static fromMessage(context: AnyTextRangeDefinition, maybeExpression: string): TextTranslationExpression | null;
+    static from(context: AnyTextRangeDefinition, maybeExpression: string): TextTranslationExpression | null;
+    readonly source = "translation";
+    private constructor();
+}

package/dist/parse/expression/abstract/DependencyContext.d.ts

@@ -0,0 +1,7 @@
+export declare abstract class DependencyContext {
+    abstract get parentReference(): string | null;
+    abstract get reference(): string | null;
+    get isTranslated(): boolean;
+    set isTranslated(value: true);
+    protected _isTranslated: boolean;
+}

package/dist/{expression → parse/expression/abstract}/DependentExpression.d.ts

@@ -1,7 +1,6 @@
-import { XFormsXPathEvaluator } from '@getodk/xpath';
-import { ConstantExpression, ConstantTruthyExpression } from '../parse/xpath/semantic-analysis.ts';
+import { EngineXPathEvaluator } from '../../../integration/xpath/EngineXPathEvaluator.ts';
+import { ConstantExpression, ConstantTruthyExpression } from '../../xpath/semantic-analysis.ts';
 import { DependencyContext } from './DependencyContext.ts';
-
 declare const evaluatorMethodsByResultType: {
     readonly boolean: "evaluateBoolean";
     readonly nodes: "evaluateNodes";
@@ -11,7 +10,7 @@ declare const evaluatorMethodsByResultType: {
 type EvaluatorMethodsByResultType = typeof evaluatorMethodsByResultType;
 export type DependentExpressionResultType = keyof EvaluatorMethodsByResultType;
 export type DependentExpressionEvaluatorMethod<Type extends DependentExpressionResultType> = EvaluatorMethodsByResultType[Type];
-export type DependentExpressionResult<Type extends DependentExpressionResultType> = ReturnType<XFormsXPathEvaluator[DependentExpressionEvaluatorMethod<Type>]>;
+export type DependentExpressionResult<Type extends DependentExpressionResultType> = ReturnType<EngineXPathEvaluator[DependentExpressionEvaluatorMethod<Type>]>;
 interface SemanticDependencyOptions {
     /**
      * @default false
@@ -31,10 +30,9 @@ export interface ConstantDependentExpression<Type extends DependentExpressionRes
 export interface ConstantTruthyDependentExpression extends ConstantDependentExpression<'boolean'> {
     readonly expression: ConstantTruthyExpression;
 }
-export declare class DependentExpression<Type extends DependentExpressionResultType> {
+export declare abstract class DependentExpression<Type extends DependentExpressionResultType> {
     readonly resultType: Type;
     readonly expression: string;
-    readonly dependencyReferences: ReadonlySet<string>;
     readonly isTranslated: boolean;
     readonly evaluatorMethod: DependentExpressionEvaluatorMethod<Type>;
     readonly constantExpression: ConstantExpression | null;