@getodk/xforms-engine 0.2.0 → 0.4.0

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

@@ -1,7 +1,6 @@
-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;

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 { ParsedTokenList, TokenListParser } from '../../lib/TokenListParser.ts';
+import { XFormDefinition } from '../../parse/XFormDefinition.ts';
+import { DependencyContext } from '../expression/abstract/DependencyContext.ts';
 import { InputDefinition } from './control/InputDefinition.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 | InputDefinition | 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" | "isTranslated" | "toJSON" | "dependencyExpressions" | "registerDependentExpression" | "getBodyElement" | "getChildElementDefinitions">;
 }
 export {};

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

@@ -1,24 +1,25 @@
+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 { BodyElementParentContext } from './BodyDefinition.ts';
-import { HintDefinition } from './text/HintDefinition.ts';
-import { LabelDefinition } from './text/LabelDefinition.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;
-    readonly label: LabelDefinition | null;
+    readonly label: ItemLabelDefinition | LabelDefinition | null;
     readonly reference: string | null;
     readonly parentReference: string | null;
     protected constructor(form: XFormDefinition, parent: BodyElementParentContext, element: Element);

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

@@ -1,9 +1,8 @@
 import { XFormDefinition } from '../XFormDefinition.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';
-import { LabelDefinition } from './text/LabelDefinition.ts';
-
 export declare class RepeatElementDefinition extends BodyElementDefinition<'repeat'> {
     static isCompatible(localName: string): boolean;
     readonly category = "structure";
@@ -12,8 +11,8 @@ export declare class RepeatElementDefinition extends BodyElementDefinition<'repe
     readonly appearances: StructureElementAppearanceDefinition;
     readonly label: LabelDefinition | null;
     readonly countExpression: string | null;
-    readonly isFixedCount: boolean;
+    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" | "isTranslated" | "toJSON" | "dependencyExpressions" | "registerDependentExpression">;
 }

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/{body → parse/body}/appearance/inputAppearanceParser.d.ts

@@ -1,4 +1,3 @@
-import { TokenListParser, ParsedTokenList } from '../../lib/TokenListParser.ts';
-
+import { TokenListParser, ParsedTokenList } from '../../../lib/TokenListParser.ts';
 export declare const inputAppearanceParser: TokenListParser<"multiline" | "numbers" | "url" | "thousand-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" | "thousand-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 { BodyElementParentContext } from '../BodyDefinition.ts';
 import { BodyElementDefinition } from '../BodyElementDefinition.ts';
-import { HintDefinition } from '../text/HintDefinition.ts';
-import { LabelDefinition } from '../text/LabelDefinition.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 → parse/body}/control/InputDefinition.d.ts

@@ -1,8 +1,7 @@
 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'> {
     static isCompatible(localName: string): boolean;
     readonly type = "input";

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,14 +1,13 @@
-import { ItemElement } from '../../../lib/dom/query.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 { LabelDefinition } from '../../text/LabelDefinition.ts';
 import { AnySelectDefinition } from './SelectDefinition.ts';
-
 export declare class ItemDefinition extends BodyElementDefinition<'item'> {
     readonly parent: AnySelectDefinition;
     readonly category = "support";
     readonly type = "item";
-    readonly label: LabelDefinition | null;
+    readonly label: ItemLabelDefinition | null;
     readonly value: string;
     constructor(form: XFormDefinition, parent: AnySelectDefinition, element: ItemElement);
 }

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

@@ -1,17 +1,17 @@
-import { ItemsetElement } from '../../../lib/dom/query.ts';
+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 { BodyElementDefinition } from '../../BodyElementDefinition.ts';
-import { LabelDefinition } from '../../text/LabelDefinition.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";
     readonly type = "itemset";
     readonly reference: string;
-    readonly label: LabelDefinition | null;
+    readonly label: ItemsetLabelDefinition | null;
     readonly nodes: ItemsetNodesetExpression;
     readonly value: ItemsetValueExpression;
-    constructor(form: XFormDefinition, select: AnySelectDefinition, element: ItemsetElement);
+    constructor(form: XFormDefinition, parent: AnySelectDefinition, element: ItemsetElement);
 }

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

@@ -1,7 +1,6 @@
-import { DependencyContext } from '../../../expression/DependencyContext.ts';
-import { AnyDependentExpression } from '../../../expression/DependentExpression.ts';
+import { DependencyContext } from '../../../expression/abstract/DependencyContext.ts';
+import { AnyDependentExpression } from '../../../expression/abstract/DependentExpression.ts';
 import { ItemsetDefinition } from './ItemsetDefinition.ts';
-
 export declare class ItemsetNodesetContext extends DependencyContext {
     protected readonly itemset: ItemsetDefinition;
     readonly parentReference: null;

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 { StructureElementAppearanceDefinition } from '../appearance/structureElementAppearanceParser.ts';
 import { BodyElementDefinitionArray, BodyElementParentContext } from '../BodyDefinition.ts';
 import { BodyElementDefinition } from '../BodyElementDefinition.ts';
-import { StructureElementAppearanceDefinition } from '../appearance/structureElementAppearanceParser.ts';
-import { LabelDefinition } from '../text/LabelDefinition.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 { BodyElementParentContext } from '../BodyDefinition.ts';
-import { LabelDefinition } from '../text/LabelDefinition.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

@@ -0,0 +1,18 @@
+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}:
+ *
+ * - `jr:count`
+ * - `jr:noAddRemove`
+ *
+ * In both cases, the downstream effect is that the engine is responsible for
+ * controlling the count of a repeat range's instances. Representing both cases
+ * should simplify client usage, as well as implementation of the internal
+ * representation of {@link RepeatRangeControlledNode}.
+ */
+export declare class RepeatCountControlExpression extends DependentExpression<'number'> {
+    static from(bodyElement: RepeatElementDefinition, initialCount: number): RepeatCountControlExpression | null;
+    private constructor();
+}

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/{expression → parse/expression/abstract}/DependencyContext.d.ts

@@ -1,5 +1,4 @@
 import { AnyDependentExpression } from './DependentExpression.ts';
-
 export declare abstract class DependencyContext {
     abstract get parentReference(): string | null;
     abstract get reference(): string | null;

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

@@ -1,9 +1,10 @@
 import { XFormsXPathEvaluator } from '@getodk/xpath';
+import { ConstantExpression, ConstantTruthyExpression } from '../../xpath/semantic-analysis.ts';
 import { DependencyContext } from './DependencyContext.ts';
-
 declare const evaluatorMethodsByResultType: {
     readonly boolean: "evaluateBoolean";
     readonly nodes: "evaluateNodes";
+    readonly number: "evaluateNumber";
     readonly string: "evaluateString";
 };
 type EvaluatorMethodsByResultType = typeof evaluatorMethodsByResultType;
@@ -11,10 +12,6 @@ export type DependentExpressionResultType = keyof EvaluatorMethodsByResultType;
 export type DependentExpressionEvaluatorMethod<Type extends DependentExpressionResultType> = EvaluatorMethodsByResultType[Type];
 export type DependentExpressionResult<Type extends DependentExpressionResultType> = ReturnType<XFormsXPathEvaluator[DependentExpressionEvaluatorMethod<Type>]>;
 interface SemanticDependencyOptions {
-    /**
-     * @default false
-     */
-    readonly parentContext?: boolean | undefined;
     /**
      * @default false
      */
@@ -25,19 +22,25 @@ interface DependentExpressionOptions {
      * @default false
      */
     readonly ignoreContextReference?: boolean;
-    /**
-     * @default true
-     */
-    readonly ignoreNullExpressions?: boolean;
     readonly semanticDependencies?: SemanticDependencyOptions;
 }
-export declare class DependentExpression<Type extends DependentExpressionResultType> {
+export interface ConstantDependentExpression<Type extends DependentExpressionResultType> extends DependentExpression<Type> {
+    readonly expression: ConstantExpression;
+}
+export interface ConstantTruthyDependentExpression extends ConstantDependentExpression<'boolean'> {
+    readonly expression: ConstantTruthyExpression;
+}
+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;
+    readonly constantTruthyExpression: ConstantTruthyExpression | null;
     constructor(context: DependencyContext, resultType: Type, expression: string, options?: DependentExpressionOptions);
+    isConstantExpression(): this is ConstantDependentExpression<Type>;
+    isConstantTruthyExpression(): this is ConstantTruthyDependentExpression;
     toString(): string | null;
 }
 export type AnyDependentExpression = DependentExpression<any>;

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

@@ -0,0 +1,17 @@
+import { TextChunkSource } from '../../../client/TextRange.ts';
+import { AnyTextRangeDefinition } from '../../text/abstract/TextRangeDefinition.ts';
+import { TextLiteralExpression } from '../TextLiteralExpression.ts';
+import { TextOutputExpression } from '../TextOutputExpression.ts';
+import { TextReferenceExpression } from '../TextReferenceExpression.ts';
+import { TextTranslationExpression } from '../TextTranslationExpression.ts';
+import { DependentExpression } from './DependentExpression.ts';
+interface TextChunkExpressionOptions {
+    readonly isTranslated?: true;
+}
+export declare abstract class TextChunkExpression<Source extends TextChunkSource> extends DependentExpression<'string'> {
+    abstract readonly source: Source;
+    readonly stringValue?: string;
+    constructor(context: AnyTextRangeDefinition, expression: string, options?: TextChunkExpressionOptions);
+}
+export type AnyTextChunkExpression = TextLiteralExpression | TextOutputExpression | TextReferenceExpression | TextTranslationExpression;
+export {};

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

@@ -0,0 +1,39 @@
+import { DependencyContext } from '../expression/abstract/DependencyContext.ts';
+import { BindComputationExpression } from '../expression/BindComputationExpression.ts';
+import { MessageDefinition } from '../text/MessageDefinition.ts';
+import { XFormDataType } from '../XFormDataType.ts';
+import { XFormDefinition } from '../XFormDefinition.ts';
+import { BindElement } from './BindElement.ts';
+import { ModelDefinition } from './ModelDefinition.ts';
+export declare class BindDefinition extends DependencyContext {
+    readonly form: XFormDefinition;
+    protected readonly model: ModelDefinition;
+    readonly nodeset: string;
+    readonly bindElement: BindElement;
+    readonly bindType: string | null;
+    readonly dataType: XFormDataType;
+    readonly parentNodeset: string | null;
+    readonly calculate: BindComputationExpression<'calculate'> | null;
+    readonly readonly: BindComputationExpression<'readonly'>;
+    readonly relevant: BindComputationExpression<'relevant'>;
+    readonly required: BindComputationExpression<'required'>;
+    /**
+     * Diverges from
+     * {@link https://github.com/getodk/javarosa/blob/059321160e6f8dbb3e81d9add61d68dd35b13cc8/dag.md | JavaRosa's},
+     * which excludes `constraint` expressions. We compute `constraint`
+     * dependencies like the other <bind> computation expressions, but explicitly
+     * ignore self-references (this is currently handled by
+     * {@link BindComputationExpression}, via its {@link DependentExpression}
+     * super class).
+     */
+    readonly constraint: BindComputationExpression<'constraint'>;
+    readonly constraintMsg: MessageDefinition<'constraintMsg'> | null;
+    readonly requiredMsg: MessageDefinition<'requiredMsg'> | null;
+    readonly saveIncomplete: BindComputationExpression<'saveIncomplete'>;
+    protected _parentBind: BindDefinition | null | undefined;
+    get parentBind(): BindDefinition | null;
+    get reference(): string;
+    get parentReference(): string | null;
+    constructor(form: XFormDefinition, model: ModelDefinition, nodeset: string, bindElement: BindElement);
+    toJSON(): Omit<this, "reference" | "form" | "isTranslated" | "parentReference" | "toJSON" | "dependencyExpressions" | "registerDependentExpression" | "model" | "bindElement" | "parentBind">;
+}

package/dist/{model → parse/model}/BindElement.d.ts

@@ -3,4 +3,5 @@ export interface BindElement {
     readonly localName: 'bind';
     getAttribute(name: 'nodeset'): BindNodeset;
     getAttribute(name: string): string | null;
+    getAttributeNS(namespaceURI: string | null, localName: string): string | null;
 }

package/dist/{model → parse/model}/DescendentNodeDefinition.d.ts

@@ -2,7 +2,6 @@ import { AnyBodyElementDefinition } from '../body/BodyDefinition.ts';
 import { BindDefinition } from './BindDefinition.ts';
 import { ModelNode, NodeChildren, NodeDefaultValue, NodeDefinition, NodeDefinitionType, NodeInstances, NodeParent } from './NodeDefinition.ts';
 import { RootDefinition } from './RootDefinition.ts';
-
 export type DescendentNodeType = Exclude<NodeDefinitionType, 'root'>;
 type DescendentNodeBodyElement = AnyBodyElementDefinition;
 export declare abstract class DescendentNodeDefinition<Type extends DescendentNodeType, BodyElement extends DescendentNodeBodyElement | null = DescendentNodeBodyElement | null> implements NodeDefinition<Type> {