@getodk/xforms-engine 0.16.0 → 0.17.0

package/dist/instance/Attribute.d.ts

@@ -1,33 +1,32 @@
 import { XPathNodeKindKey } from '@getodk/xpath';
 import { Accessor } from 'solid-js';
 import { AttributeNode } from '../client/AttributeNode.ts';
-import { ActiveLanguage, InstanceState, NullValidationState } from '../client/index.ts';
+import { InstanceState, NullValidationState } from '../client/index.ts';
 import { XFormsXPathAttribute } from '../integration/xpath/adapter/XFormsXPathNode.ts';
-import { EngineXPathEvaluator } from '../integration/xpath/EngineXPathEvaluator.ts';
 import { StaticAttribute } from '../integration/xpath/static-dom/StaticAttribute.ts';
 import { RuntimeInputValue, RuntimeValue } from '../lib/codecs/getSharedValueCodec.ts';
 import { RuntimeValueSetter, RuntimeValueState } from '../lib/codecs/ValueCodec.ts';
+import { AttributeState } from '../lib/reactivity/createAttributeState.ts';
 import { CurrentState } from '../lib/reactivity/node-state/createCurrentState.ts';
 import { EngineState } from '../lib/reactivity/node-state/createEngineState.ts';
 import { SharedNodeState } from '../lib/reactivity/node-state/createSharedNodeState.ts';
-import { ReactiveScope } from '../lib/reactivity/scope.ts';
 import { SimpleAtomicState } from '../lib/reactivity/types.ts';
 import { AttributeDefinition } from '../parse/model/AttributeDefinition.ts';
-import { AnyChildNode, AnyNode } from './hierarchy.ts';
+import { DescendantNode, DescendantNodeStateSpec } from './abstract/DescendantNode.ts';
+import { AnyNode } from './hierarchy.ts';
 import { AttributeContext } from './internal-api/AttributeContext.ts';
-import { InstanceConfig } from './internal-api/InstanceConfig.ts';
 import { DecodeInstanceValue } from './internal-api/InstanceValueContext.ts';
 import { ClientReactiveSerializableAttributeNode } from './internal-api/serialization/ClientReactiveSerializableAttributeNode.ts';
-import { PrimaryInstance } from './PrimaryInstance.ts';
 import { Root } from './Root.ts';
-export interface AttributeStateSpec {
+export interface AttributeStateSpec extends DescendantNodeStateSpec<string> {
+    readonly children: null;
+    readonly attributes: Accessor<Attribute[]>;
     readonly value: SimpleAtomicState<string>;
     readonly instanceValue: Accessor<string>;
     readonly relevant: Accessor<boolean>;
 }
-export declare class Attribute implements AttributeNode, ClientReactiveSerializableAttributeNode, AttributeContext, XFormsXPathAttribute {
+export declare class Attribute extends DescendantNode<AttributeDefinition, AttributeStateSpec, AnyNode, null> implements AttributeNode, ClientReactiveSerializableAttributeNode, AttributeContext, XFormsXPathAttribute {
     readonly owner: AnyNode;
-    readonly definition: AttributeDefinition;
     readonly instanceNode: StaticAttribute;
     readonly [XPathNodeKindKey] = "attribute";
     protected readonly state: SharedNodeState<AttributeStateSpec>;
@@ -43,22 +42,11 @@ export declare class Attribute implements AttributeNode, ClientReactiveSerializa
     protected readonly getInstanceValue: Accessor<string>;
     protected readonly valueState: RuntimeValueState<RuntimeValue<'string'>>;
     protected readonly setValueState: RuntimeValueSetter<RuntimeInputValue<'string'>>;
-    readonly evaluator: EngineXPathEvaluator;
-    readonly getActiveLanguage: Accessor<ActiveLanguage>;
-    readonly contextNode: AnyNode;
-    readonly scope: ReactiveScope;
-    readonly rootDocument: PrimaryInstance;
-    readonly instanceConfig: InstanceConfig;
-    readonly root: Root;
-    readonly isRelevant: Accessor<boolean>;
+    readonly attributeState: AttributeState;
     readonly isAttached: Accessor<boolean>;
-    readonly isReadonly: Accessor<boolean>;
-    readonly hasReadonlyAncestor: Accessor<boolean>;
-    readonly hasNonRelevantAncestor: Accessor<boolean>;
-    readonly contextReference: () => string;
+    readonly getXPathValue: () => string;
     constructor(owner: AnyNode, definition: AttributeDefinition, instanceNode: StaticAttribute);
     setValue(value: string): Root;
+    getAttributes(): readonly Attribute[];
     getChildren(): readonly [];
-    getXPathChildNodes(): readonly AnyChildNode[];
-    getXPathValue(): string;
 }

package/dist/instance/Group.d.ts

@@ -7,6 +7,7 @@ import { TextRange } from '../client/TextRange.ts';
 import { AncestorNodeValidationState } from '../client/validation.ts';
 import { XFormsXPathElement } from '../integration/xpath/adapter/XFormsXPathNode.ts';
 import { StaticElement } from '../integration/xpath/static-dom/StaticElement.ts';
+import { AttributeState } from '../lib/reactivity/createAttributeState.ts';
 import { MaterializedChildren } from '../lib/reactivity/materializeCurrentStateChildren.ts';
 import { CurrentState } from '../lib/reactivity/node-state/createCurrentState.ts';
 import { EngineState } from '../lib/reactivity/node-state/createEngineState.ts';
@@ -29,6 +30,7 @@ export declare class Group extends DescendantNode<GroupDefinition, GroupStateSpe
     readonly [XPathNodeKindKey] = "element";
     protected readonly state: SharedNodeState<GroupStateSpec>;
     protected engineState: EngineState<GroupStateSpec>;
+    readonly attributeState: AttributeState;
     readonly nodeType = "group";
     readonly appearances: GroupNodeAppearances;
     readonly nodeOptions: null;
@@ -37,5 +39,6 @@ export declare class Group extends DescendantNode<GroupDefinition, GroupStateSpe
     readonly instanceState: InstanceState;
     constructor(parent: GeneralParentNode, instanceNode: StaticElement | null, definition: GroupDefinition);
     getChildren(): readonly GeneralChildNode[];
+    getAttributes(): readonly Attribute[];
 }
 export {};

package/dist/instance/InputControl.d.ts

@@ -6,6 +6,7 @@ import { ValueType } from '../client/ValueType.ts';
 import { XFormsXPathElement } from '../integration/xpath/adapter/XFormsXPathNode.ts';
 import { StaticLeafElement } from '../integration/xpath/static-dom/StaticElement.ts';
 import { RuntimeInputValue, RuntimeValue } from '../lib/codecs/getSharedValueCodec.ts';
+import { AttributeState } from '../lib/reactivity/createAttributeState.ts';
 import { CurrentState } from '../lib/reactivity/node-state/createCurrentState.ts';
 import { EngineState } from '../lib/reactivity/node-state/createEngineState.ts';
 import { SharedNodeState } from '../lib/reactivity/node-state/createSharedNodeState.ts';
@@ -30,12 +31,14 @@ export declare class InputControl<V extends ValueType = ValueType> extends Value
     readonly [XPathNodeKindKey] = "element";
     protected readonly state: SharedNodeState<InputControlStateSpec<V>>;
     protected readonly engineState: EngineState<InputControlStateSpec<V>>;
+    readonly attributeState: AttributeState;
     readonly nodeType = "input";
     readonly appearances: InputNodeAppearances;
     readonly nodeOptions: InputNodeOptions<V>;
     readonly currentState: CurrentState<InputControlStateSpec<V>>;
     constructor(parent: GeneralParentNode, instanceNode: StaticLeafElement | null, definition: InputDefinition<V>);
     setValue(value: InputNodeInputValue<V>): Root;
+    getAttributes(): readonly Attribute[];
 }
 export type AnyInputControl = InputControl<'barcode'> | InputControl<'binary'> | InputControl<'boolean'> | InputControl<'date'> | InputControl<'dateTime'> | InputControl<'decimal'> | InputControl<'geopoint'> | InputControl<'geoshape'> | InputControl<'geotrace'> | InputControl<'int'> | InputControl<'intent'> | InputControl<'string'> | InputControl<'time'>;
 export {};

package/dist/instance/ModelValue.d.ts

@@ -4,9 +4,11 @@ import { ValueType } from '../client/ValueType.ts';
 import { XFormsXPathElement } from '../integration/xpath/adapter/XFormsXPathNode.ts';
 import { StaticLeafElement } from '../integration/xpath/static-dom/StaticElement.ts';
 import { RuntimeInputValue, RuntimeValue } from '../lib/codecs/getSharedValueCodec.ts';
+import { AttributeState } from '../lib/reactivity/createAttributeState.ts';
 import { CurrentState } from '../lib/reactivity/node-state/createCurrentState.ts';
 import { EngineState } from '../lib/reactivity/node-state/createEngineState.ts';
 import { SharedNodeState } from '../lib/reactivity/node-state/createSharedNodeState.ts';
+import { Attribute } from './Attribute.ts';
 import { ValueNode, ValueNodeStateSpec } from './abstract/ValueNode.ts';
 import { GeneralParentNode } from './hierarchy.ts';
 import { EvaluationContext } from './internal-api/EvaluationContext.ts';
@@ -22,11 +24,13 @@ export declare class ModelValue<V extends ValueType = ValueType> extends ValueNo
     readonly [XPathNodeKindKey] = "element";
     protected readonly state: SharedNodeState<ModelValueStateSpec<V>>;
     protected readonly engineState: EngineState<ModelValueStateSpec<V>>;
+    readonly attributeState: AttributeState;
     readonly nodeType = "model-value";
     readonly appearances: null;
     readonly nodeOptions: null;
     readonly currentState: CurrentState<ModelValueStateSpec<V>>;
     constructor(parent: GeneralParentNode, instanceNode: StaticLeafElement | null, definition: ModelValueDefinition<V>);
+    getAttributes(): readonly Attribute[];
 }
 export type AnyModelValue = ModelValue<'barcode'> | ModelValue<'binary'> | ModelValue<'boolean'> | ModelValue<'date'> | ModelValue<'dateTime'> | ModelValue<'decimal'> | ModelValue<'geopoint'> | ModelValue<'geoshape'> | ModelValue<'geotrace'> | ModelValue<'int'> | ModelValue<'intent'> | ModelValue<'string'> | ModelValue<'time'>;
 export {};

package/dist/instance/Note.d.ts

@@ -6,12 +6,14 @@ import { ValueType } from '../client/ValueType.ts';
 import { XFormsXPathElement } from '../integration/xpath/adapter/XFormsXPathNode.ts';
 import { StaticLeafElement } from '../integration/xpath/static-dom/StaticElement.ts';
 import { NoteInputValue, NoteRuntimeValue } from '../lib/codecs/NoteCodec.ts';
+import { AttributeState } from '../lib/reactivity/createAttributeState.ts';
 import { CurrentState } from '../lib/reactivity/node-state/createCurrentState.ts';
 import { EngineState } from '../lib/reactivity/node-state/createEngineState.ts';
 import { SharedNodeState } from '../lib/reactivity/node-state/createSharedNodeState.ts';
 import { ComputedNoteText } from '../lib/reactivity/text/createNoteText.ts';
 import { NoteNodeDefinition } from '../parse/model/NoteNodeDefinition.ts';
 import { ValueNode, ValueNodeStateSpec } from './abstract/ValueNode.ts';
+import { Attribute } from './Attribute.ts';
 import { GeneralParentNode } from './hierarchy.ts';
 import { EvaluationContext } from './internal-api/EvaluationContext.ts';
 import { ClientReactiveSerializableValueNode } from './internal-api/serialization/ClientReactiveSerializableValueNode.ts';
@@ -27,11 +29,13 @@ export declare class Note<V extends ValueType = ValueType> extends ValueNode<V,
     readonly [XPathNodeKindKey] = "element";
     protected readonly state: SharedNodeState<NoteStateSpec<V>>;
     protected readonly engineState: EngineState<NoteStateSpec<V>>;
+    readonly attributeState: AttributeState;
     readonly nodeType = "note";
     readonly appearances: NoteNodeAppearances;
     readonly nodeOptions: null;
     readonly currentState: CurrentState<NoteStateSpec<V>>;
     constructor(parent: GeneralParentNode, instanceNode: StaticLeafElement | null, definition: NoteNodeDefinition<V>);
+    getAttributes(): readonly Attribute[];
 }
 export type AnyNote = Note<'barcode'> | Note<'binary'> | Note<'boolean'> | Note<'date'> | Note<'dateTime'> | Note<'decimal'> | Note<'geopoint'> | Note<'geoshape'> | Note<'geotrace'> | Note<'int'> | Note<'intent'> | Note<'string'> | Note<'time'>;
 export {};

package/dist/instance/PrimaryInstance.d.ts

@@ -10,6 +10,7 @@ import { AncestorNodeValidationState } from '../client/validation.ts';
 import { XFormsXPathDocument } from '../integration/xpath/adapter/XFormsXPathNode.ts';
 import { EngineXPathEvaluator } from '../integration/xpath/EngineXPathEvaluator.ts';
 import { StaticDocument } from '../integration/xpath/static-dom/StaticDocument.ts';
+import { AttributeState } from '../lib/reactivity/createAttributeState.ts';
 import { MaterializedChildren } from '../lib/reactivity/materializeCurrentStateChildren.ts';
 import { CurrentState } from '../lib/reactivity/node-state/createCurrentState.ts';
 import { EngineState } from '../lib/reactivity/node-state/createEngineState.ts';
@@ -44,12 +45,13 @@ interface PrimaryInstanceStateSpec {
 }
 interface PrimaryInstanceStateInputByMode {
     readonly create: null;
+    readonly reset: null;
     readonly edit: InitialInstanceState;
     readonly restore: InitialInstanceState;
 }
 export type PrimaryInstanceInitialState<Mode extends FormInstanceInitializationMode> = PrimaryInstanceStateInputByMode[Mode];
 export interface BasePrimaryInstanceOptions {
-    readonly scope: ReactiveScope;
+    scope: ReactiveScope;
     readonly model: ModelDefinition;
     readonly secondaryInstances: SecondaryInstancesDefinition;
 }
@@ -66,12 +68,14 @@ export declare class PrimaryInstance<Mode extends FormInstanceInitializationMode
     readonly attachments: InstanceAttachmentsState;
     protected readonly state: SharedNodeState<PrimaryInstanceStateSpec>;
     protected readonly engineState: EngineState<PrimaryInstanceStateSpec>;
+    readonly attributeState: AttributeState;
     readonly instanceNode: StaticDocument;
     readonly getChildren: Accessor<readonly Root[]>;
     readonly hasReadonlyAncestor: () => boolean;
     readonly isReadonly: () => boolean;
     readonly hasNonRelevantAncestor: () => boolean;
     readonly isRelevant: () => boolean;
+    private geolocationProvider;
     private readonly setActiveLanguage;
     readonly [XPathNodeKindKey] = "document";
     readonly nodeType = "primary-instance";
@@ -88,6 +92,7 @@ export declare class PrimaryInstance<Mode extends FormInstanceInitializationMode
     readonly evaluator: EngineXPathEvaluator;
     readonly contextNode: this;
     constructor(options: PrimaryInstanceOptions<Mode>);
+    getAttributes(): readonly Attribute[];
     /**
      * @todo Note that this method's signature is intentionally derived from
      * {@link RootNode.setLanguage}, but its return type differs! The design
@@ -109,5 +114,6 @@ export declare class PrimaryInstance<Mode extends FormInstanceInitializationMode
      */
     setLanguage(language: FormLanguage): FormLanguage;
     prepareInstancePayload<PayloadType extends InstancePayloadType = 'monolithic'>(options?: InstancePayloadOptions<PayloadType>): Promise<InstancePayload<PayloadType>>;
+    getBackgroundGeopoint(): Promise<string>;
 }
 export {};

package/dist/instance/RangeControl.d.ts

@@ -4,10 +4,12 @@ import { RangeInputValue, RangeNode, RangeNodeAppearances, RangeValue } from '..
 import { TextRange } from '../client/TextRange.ts';
 import { XFormsXPathElement } from '../integration/xpath/adapter/XFormsXPathNode.ts';
 import { StaticLeafElement } from '../integration/xpath/static-dom/StaticElement.ts';
+import { AttributeState } from '../lib/reactivity/createAttributeState.ts';
 import { CurrentState } from '../lib/reactivity/node-state/createCurrentState.ts';
 import { EngineState } from '../lib/reactivity/node-state/createEngineState.ts';
 import { SharedNodeState } from '../lib/reactivity/node-state/createSharedNodeState.ts';
 import { AnyRangeNodeDefinition, RangeNodeDefinition, RangeValueType } from '../parse/model/RangeNodeDefinition.ts';
+import { Attribute } from './Attribute.ts';
 import { Root } from './Root.ts';
 import { ValueNode, ValueNodeStateSpec } from './abstract/ValueNode.ts';
 import { GeneralParentNode } from './hierarchy.ts';
@@ -24,12 +26,14 @@ export declare class RangeControl<V extends RangeValueType = RangeValueType> ext
     readonly [XPathNodeKindKey] = "element";
     protected readonly state: SharedNodeState<RangeControlStateSpec<V>>;
     protected readonly engineState: EngineState<RangeControlStateSpec<V>>;
+    readonly attributeState: AttributeState;
     readonly nodeType = "range";
     readonly appearances: RangeNodeAppearances;
     readonly nodeOptions: null;
     readonly currentState: CurrentState<RangeControlStateSpec<V>>;
     constructor(parent: GeneralParentNode, instanceNode: StaticLeafElement | null, definition: RangeNodeDefinition<V>);
     setValue(value: RangeInputValue<V>): Root;
+    getAttributes(): readonly Attribute[];
 }
 export type AnyRangeControl = RangeControl<'decimal'> | RangeControl<'int'>;
 export {};

package/dist/instance/RankControl.d.ts

@@ -1,14 +1,16 @@
-import { XPathChoiceNode, XPathNodeKindKey } from '@getodk/xpath';
+import { XPathNodeKindKey, XPathChoiceNode } from '@getodk/xpath';
 import { Accessor } from 'solid-js';
 import { RankDefinition, RankNode, RankValueOptions } from '../client/RankNode.ts';
 import { TextRange } from '../client/TextRange.ts';
 import { ValueType } from '../client/ValueType.ts';
 import { XFormsXPathElement } from '../integration/xpath/adapter/XFormsXPathNode.ts';
 import { StaticLeafElement } from '../integration/xpath/static-dom/StaticElement.ts';
+import { AttributeState } from '../lib/reactivity/createAttributeState.ts';
 import { CurrentState } from '../lib/reactivity/node-state/createCurrentState.ts';
 import { EngineState } from '../lib/reactivity/node-state/createEngineState.ts';
 import { SharedNodeState } from '../lib/reactivity/node-state/createSharedNodeState.ts';
 import { UnknownAppearanceDefinition } from '../parse/body/appearance/unknownAppearanceParser.ts';
+import { Attribute } from './Attribute.ts';
 import { Root } from './Root.ts';
 import { ValueNodeStateSpec, ValueNode } from './abstract/ValueNode.ts';
 import { GeneralParentNode } from './hierarchy.ts';
@@ -30,11 +32,13 @@ export declare class RankControl extends ValueNode<'string', RankDefinition<'str
     readonly [XPathNodeKindKey] = "element";
     protected readonly state: SharedNodeState<RankControlStateSpec>;
     protected readonly engineState: EngineState<RankControlStateSpec>;
+    readonly attributeState: AttributeState;
     readonly nodeType = "rank";
     readonly appearances: UnknownAppearanceDefinition;
     readonly nodeOptions: null;
     readonly currentState: CurrentState<RankControlStateSpec>;
     private constructor();
+    getAttributes(): readonly Attribute[];
     getValueLabel(value: string): TextRange<'item-label'> | null;
     setValues(valuesInOrder: readonly string[]): Root;
     getChoiceName(value: string): string | null;

package/dist/instance/Root.d.ts

@@ -8,6 +8,7 @@ import { InstancePayloadOptions, InstancePayloadType } from '../client/serializa
 import { InstanceState } from '../client/serialization/InstanceState.ts';
 import { AncestorNodeValidationState } from '../client/validation.ts';
 import { XFormsXPathElement } from '../integration/xpath/adapter/XFormsXPathNode.ts';
+import { AttributeState } from '../lib/reactivity/createAttributeState.ts';
 import { MaterializedChildren } from '../lib/reactivity/materializeCurrentStateChildren.ts';
 import { CurrentState } from '../lib/reactivity/node-state/createCurrentState.ts';
 import { EngineState } from '../lib/reactivity/node-state/createEngineState.ts';
@@ -39,6 +40,7 @@ export declare class Root extends DescendantNode<RootDefinition, RootStateSpec,
     readonly [XPathNodeKindKey] = "element";
     protected readonly state: SharedNodeState<RootStateSpec>;
     protected readonly engineState: EngineState<RootStateSpec>;
+    readonly attributeState: AttributeState;
     readonly hasReadonlyAncestor: () => boolean;
     readonly isSelfReadonly: () => boolean;
     readonly isReadonly: () => boolean;
@@ -56,6 +58,7 @@ export declare class Root extends DescendantNode<RootDefinition, RootStateSpec,
     readonly languages: FormLanguages;
     constructor(parent: PrimaryInstance);
     getChildren(): readonly GeneralChildNode[];
+    getAttributes(): readonly Attribute[];
     setLanguage(language: FormLanguage): Root;
     prepareInstancePayload<PayloadType extends InstancePayloadType = 'monolithic'>(options?: InstancePayloadOptions<PayloadType>): Promise<InstancePayload<PayloadType>>;
 }

package/dist/instance/SelectControl.d.ts

@@ -1,14 +1,16 @@
-import { XPathChoiceNode, XPathNodeKindKey } from '@getodk/xpath';
+import { XPathNodeKindKey, XPathChoiceNode } from '@getodk/xpath';
 import { Accessor } from 'solid-js';
 import { SelectDefinition, SelectItem, SelectNode, SelectNodeAppearances, SelectValueOptions } from '../client/SelectNode.ts';
 import { TextRange } from '../client/TextRange.ts';
 import { ValueType } from '../client/ValueType.ts';
 import { XFormsXPathElement } from '../integration/xpath/adapter/XFormsXPathNode.ts';
 import { StaticLeafElement } from '../integration/xpath/static-dom/StaticElement.ts';
+import { AttributeState } from '../lib/reactivity/createAttributeState.ts';
 import { CurrentState } from '../lib/reactivity/node-state/createCurrentState.ts';
 import { EngineState } from '../lib/reactivity/node-state/createEngineState.ts';
 import { SharedNodeState } from '../lib/reactivity/node-state/createSharedNodeState.ts';
 import { SelectType } from '../parse/body/control/SelectControlDefinition.ts';
+import { Attribute } from './Attribute.ts';
 import { Root } from './Root.ts';
 import { ValueNodeStateSpec, ValueNode } from './abstract/ValueNode.ts';
 import { GeneralParentNode } from './hierarchy.ts';
@@ -31,6 +33,7 @@ export declare class SelectControl extends ValueNode<'string', SelectDefinition<
     readonly [XPathNodeKindKey] = "element";
     protected readonly state: SharedNodeState<SelectControlStateSpec>;
     protected readonly engineState: EngineState<SelectControlStateSpec>;
+    readonly attributeState: AttributeState;
     readonly nodeType = "select";
     readonly selectType: SelectType;
     readonly appearances: SelectNodeAppearances;
@@ -65,5 +68,6 @@ export declare class SelectControl extends ValueNode<'string', SelectDefinition<
     selectValue(value: string | null): Root;
     selectValues(values: readonly string[]): Root;
     getChoiceName(value: string): string | null;
+    getAttributes(): readonly Attribute[];
 }
 export {};

package/dist/instance/TriggerControl.d.ts

@@ -5,10 +5,12 @@ import { TriggerNode, TriggerNodeDefinition } from '../client/TriggerNode.ts';
 import { XFormsXPathElement } from '../integration/xpath/adapter/XFormsXPathNode.ts';
 import { StaticLeafElement } from '../integration/xpath/static-dom/StaticElement.ts';
 import { TriggerInputValue, TriggerRuntimeValue } from '../lib/codecs/TriggerCodec.ts';
+import { AttributeState } from '../lib/reactivity/createAttributeState.ts';
 import { CurrentState } from '../lib/reactivity/node-state/createCurrentState.ts';
 import { EngineState } from '../lib/reactivity/node-state/createEngineState.ts';
 import { SharedNodeState } from '../lib/reactivity/node-state/createSharedNodeState.ts';
 import { UnknownAppearanceDefinition } from '../parse/body/appearance/unknownAppearanceParser.ts';
+import { Attribute } from './Attribute.ts';
 import { Root } from './Root.ts';
 import { ValueNode, ValueNodeStateSpec } from './abstract/ValueNode.ts';
 import { GeneralParentNode } from './hierarchy.ts';
@@ -25,11 +27,13 @@ export declare class TriggerControl extends ValueNode<'string', TriggerNodeDefin
     readonly [XPathNodeKindKey] = "element";
     protected readonly state: SharedNodeState<TriggerControlStateSpec>;
     protected readonly engineState: EngineState<TriggerControlStateSpec>;
+    readonly attributeState: AttributeState;
     readonly nodeType = "trigger";
     readonly appearances: UnknownAppearanceDefinition;
     readonly nodeOptions: null;
     readonly currentState: CurrentState<TriggerControlStateSpec>;
     private constructor();
+    getAttributes(): readonly Attribute[];
     setValue(value: TriggerInputValue): Root;
 }
 export {};

package/dist/instance/UploadControl.d.ts

@@ -7,6 +7,7 @@ import { InstanceAttachmentFileName, InstanceState } from '../client/index.ts';
 import { AnyViolation, LeafNodeValidationState } from '../client/validation.ts';
 import { XFormsXPathElement } from '../integration/xpath/adapter/XFormsXPathNode.ts';
 import { StaticLeafElement } from '../integration/xpath/static-dom/StaticElement.ts';
+import { AttributeState } from '../lib/reactivity/createAttributeState.ts';
 import { CurrentState } from '../lib/reactivity/node-state/createCurrentState.ts';
 import { EngineState } from '../lib/reactivity/node-state/createEngineState.ts';
 import { SharedNodeState } from '../lib/reactivity/node-state/createSharedNodeState.ts';
@@ -43,6 +44,7 @@ export declare class UploadControl extends DescendantNode<UploadDefinition<'bina
     readonly getXPathValue: () => InstanceAttachmentFileName;
     protected readonly state: SharedNodeState<UploadControlStateSpec>;
     protected readonly engineState: EngineState<UploadControlStateSpec>;
+    readonly attributeState: AttributeState;
     readonly decodeInstanceValue: DecodeInstanceValue;
     readonly nodeType = "upload";
     readonly valueType = "binary";
@@ -55,6 +57,7 @@ export declare class UploadControl extends DescendantNode<UploadDefinition<'bina
     getViolation(): AnyViolation | null;
     isBlank(): boolean;
     getChildren(): readonly [];
+    getAttributes(): readonly Attribute[];
     setValue(value: InstanceAttachmentRuntimeValue): Root;
 }
 export {};

package/dist/instance/abstract/DescendantNode.d.ts

@@ -6,9 +6,10 @@ import { InstanceNodeType } from '../../client/node-types.ts';
 import { PrimaryInstanceXPathChildNode } from '../../integration/xpath/adapter/kind.ts';
 import { XFormsXPathPrimaryInstanceDescendantNode, XFormsXPathPrimaryInstanceDescendantNodeKind } from '../../integration/xpath/adapter/XFormsXPathNode.ts';
 import { EngineXPathEvaluator } from '../../integration/xpath/EngineXPathEvaluator.ts';
+import { StaticAttribute } from '../../integration/xpath/static-dom/StaticAttribute.ts';
 import { StaticElement } from '../../integration/xpath/static-dom/StaticElement.ts';
 import { AnyNodeDefinition } from '../../parse/model/NodeDefinition.ts';
-import { AnyChildNode, AnyParentNode } from '../hierarchy.ts';
+import { AnyChildNode, AnyNode } from '../hierarchy.ts';
 import { EvaluationContext } from '../internal-api/EvaluationContext.ts';
 import { Root } from '../Root.ts';
 import { InstanceNodeStateSpec, InstanceNode } from './InstanceNode.ts';
@@ -31,9 +32,9 @@ interface DescendantNodeOptions {
  * beginning to form in {@link DescendantNodeInitOptions} (not to be confused
  * with the current module-local {@link DescendantNodeOptions}).
  */
-export declare abstract class DescendantNode<Definition extends DescendantNodeDefinition, Spec extends DescendantNodeStateSpec<any>, Parent extends AnyParentNode, Child extends AnyChildNode | null = null> extends InstanceNode<Definition, Spec, Parent, Child> implements BaseNode, XFormsXPathPrimaryInstanceDescendantNode, EvaluationContext {
+export declare abstract class DescendantNode<Definition extends DescendantNodeDefinition, Spec extends DescendantNodeStateSpec<any>, Parent extends AnyNode, Child extends AnyChildNode | null = null> extends InstanceNode<Definition, Spec, Parent, Child> implements BaseNode, XFormsXPathPrimaryInstanceDescendantNode, EvaluationContext {
     readonly parent: Parent;
-    readonly instanceNode: StaticElement | null;
+    readonly instanceNode: StaticAttribute | StaticElement | null;
     readonly definition: Definition;
     /**
      * Partial implementation of {@link isAttached}, used to check whether `this`
@@ -65,7 +66,7 @@ export declare abstract class DescendantNode<Definition extends DescendantNodeDe
     readonly evaluator: EngineXPathEvaluator;
     readonly contextNode: PrimaryInstanceXPathChildNode;
     readonly getActiveLanguage: Accessor<ActiveLanguage>;
-    constructor(parent: Parent, instanceNode: StaticElement | null, definition: Definition, options?: DescendantNodeOptions);
+    constructor(parent: Parent, instanceNode: StaticAttribute | StaticElement | null, definition: Definition, options?: DescendantNodeOptions);
     /**
      * @package
      *

package/dist/instance/abstract/InstanceNode.d.ts

@@ -22,7 +22,7 @@ import { AnyNodeDefinition } from '../../parse/model/NodeDefinition.ts';
 import { Attribute } from '../Attribute.ts';
 import { PrimaryInstance } from '../PrimaryInstance.ts';
 import { Root } from '../Root.ts';
-import { AnyChildNode, AnyParentNode } from '../hierarchy.ts';
+import { AnyChildNode, AnyNode } from '../hierarchy.ts';
 import { EvaluationContext } from '../internal-api/EvaluationContext.ts';
 import { InstanceConfig } from '../internal-api/InstanceConfig.ts';
 export type EngineInstanceNodeType = ClientInstanceNodeType | 'primary-instance';
@@ -51,7 +51,7 @@ export type InstanceNodeCurrentState<Spec extends InstanceNodeStateSpec<any>, Ch
     readonly children: [Child] extends [AnyChildNode] ? readonly Child[] : null;
 };
 interface ComputableReferenceNode {
-    readonly parent: AnyParentNode | null;
+    readonly parent: AnyNode | null;
     readonly definition: AnyNodeDefinition;
 }
 type ComputeInstanceNodeReference = <This extends ComputableReferenceNode>(this: This, parent: This['parent'], definition: This['definition']) => string;
@@ -59,7 +59,7 @@ export interface InstanceNodeOptions {
     readonly computeReference?: () => string;
     readonly scope?: ReactiveScope;
 }
-export declare abstract class InstanceNode<Definition extends AnyNodeDefinition, Spec extends InstanceNodeStateSpec<any>, Parent extends AnyParentNode | null, Child extends AnyChildNode | null = null> implements BaseEngineNode, XFormsXPathPrimaryInstanceNode, EvaluationContext {
+export declare abstract class InstanceNode<Definition extends AnyNodeDefinition, Spec extends InstanceNodeStateSpec<any>, Parent extends AnyNode | null, Child extends AnyChildNode | null = null> implements BaseEngineNode, XFormsXPathPrimaryInstanceNode, EvaluationContext {
     readonly instanceConfig: InstanceConfig;
     readonly parent: Parent;
     readonly instanceNode: StaticAttribute | StaticDocument | StaticElement | null;
@@ -130,5 +130,6 @@ export declare abstract class InstanceNode<Definition extends AnyNodeDefinition,
      */
     getXPathChildNodes(): readonly AnyChildNode[];
     getXPathValue(): string;
+    abstract getAttributes(): readonly Attribute[];
 }
 export {};

package/dist/instance/hierarchy.d.ts

@@ -1,3 +1,4 @@
+import { Attribute } from './Attribute.ts';
 import { Group } from './Group.ts';
 import { AnyInputControl } from './InputControl.ts';
 import { AnyModelValue } from './ModelValue.ts';
@@ -13,7 +14,7 @@ import { SelectControl } from './SelectControl.ts';
 import { TriggerControl } from './TriggerControl.ts';
 import { UploadControl } from './UploadControl.ts';
 export type RepeatRange = RepeatRangeControlled | RepeatRangeUncontrolled;
-export type AnyNode = PrimaryInstance | Root | Group | RepeatRange | RepeatInstance | AnyNote | AnyModelValue | AnyInputControl | AnyRangeControl | RankControl | SelectControl | TriggerControl | UploadControl;
+export type AnyNode = PrimaryInstance | Root | Group | RepeatRange | RepeatInstance | Attribute | AnyNote | AnyModelValue | AnyInputControl | AnyRangeControl | RankControl | SelectControl | TriggerControl | UploadControl;
 export type AnyParentNode = PrimaryInstance | Root | Group | RepeatRange | RepeatInstance;
 export type GeneralParentNode = Root | Group | RepeatInstance;
 export type AnyChildNode = Root | Group | RepeatRange | RepeatInstance | AnyModelValue | AnyNote | AnyInputControl | AnyRangeControl | RankControl | SelectControl | TriggerControl | UploadControl;

package/dist/instance/internal-api/AttributeContext.d.ts

@@ -10,6 +10,7 @@ import { InstanceConfig } from './InstanceConfig.ts';
 export interface InstanceAttributeContextDocument {
     readonly initializationMode: FormInstanceInitializationMode;
     readonly isAttached: Accessor<boolean>;
+    getBackgroundGeopoint: Accessor<Promise<string>>;
 }
 export type DecodeInstanceValue = (value: string) => string;
 interface InstanceAttributeContextDefinitionBind {

package/dist/instance/internal-api/InstanceConfig.d.ts

@@ -1,5 +1,5 @@
 import { InstanceAttachmentFileNameFactory } from '../../client/attachments/InstanceAttachmentsConfig.ts';
-import { PreloadProperties } from '../../client/form/FormInstanceConfig.ts';
+import { GeolocationProvider, PreloadProperties } from '../../client/form/FormInstanceConfig.ts';
 import { OpaqueReactiveObjectFactory } from '../../client/OpaqueReactiveObjectFactory.ts';
 export interface InstanceConfig {
     /**
@@ -8,4 +8,5 @@ export interface InstanceConfig {
     readonly clientStateFactory: OpaqueReactiveObjectFactory;
     readonly computeAttachmentName: InstanceAttachmentFileNameFactory;
     readonly preloadProperties: PreloadProperties;
+    readonly geolocationProvider: GeolocationProvider | undefined;
 }

package/dist/instance/internal-api/InstanceValueContext.d.ts

@@ -10,6 +10,7 @@ import { InstanceConfig } from './InstanceConfig.ts';
 export interface InstanceValueContextDocument {
     readonly initializationMode: FormInstanceInitializationMode;
     readonly isAttached: Accessor<boolean>;
+    getBackgroundGeopoint: Accessor<Promise<string>>;
 }
 export type DecodeInstanceValue = (value: string) => string;
 interface InstanceValueContextDefinitionBind {

package/dist/instance/markdown/MarkdownNode.d.ts

@@ -1,9 +1,13 @@
-import { AnchorMarkdownNode, ChildMarkdownNode as ClientChildMarkdownNode, HtmlMarkdownNode as ClientHtmlMarkdownNode, ParentMarkdownNode as ClientParentMarkdownNode, StyledMarkdownNode as ClientStyledMarkdownNode, ElementName, MarkdownNode, MarkdownProperty } from '../../client';
-declare abstract class ParentMarkdownNode implements ClientParentMarkdownNode {
-    readonly children: MarkdownNode[];
+import { AnchorMarkdownNode, ChildMarkdownNode as ClientChildMarkdownNode, HtmlMarkdownNode as ClientHtmlMarkdownNode, MarkdownNode as ClientMarkdownNode, ParentMarkdownNode as ClientParentMarkdownNode, StyledMarkdownNode as ClientStyledMarkdownNode, ElementName, MarkdownProperty } from '../../client';
+declare abstract class MarkdownNode {
+    readonly id: string;
+    constructor();
+}
+declare abstract class ParentMarkdownNode extends MarkdownNode implements ClientParentMarkdownNode {
+    readonly children: ClientMarkdownNode[];
     readonly role = "parent";
     abstract elementName: ElementName;
-    constructor(children: MarkdownNode[]);
+    constructor(children: ClientMarkdownNode[]);
 }
 export declare class Heading1 extends ParentMarkdownNode {
     readonly elementName = "h1";
@@ -44,14 +48,15 @@ export declare class ListItem extends ParentMarkdownNode {
 export declare class Anchor extends ParentMarkdownNode implements AnchorMarkdownNode {
     readonly elementName = "a";
     readonly url: string;
-    constructor(children: MarkdownNode[], url: string);
+    constructor(children: ClientMarkdownNode[], url: string);
 }
 declare abstract class StyledMarkdownNode implements ClientParentMarkdownNode {
-    readonly children: MarkdownNode[];
+    readonly id: string;
+    readonly children: ClientMarkdownNode[];
     readonly role = "parent";
     abstract elementName: ElementName;
     readonly properties: MarkdownProperty | undefined;
-    constructor(children: MarkdownNode[], properties: MarkdownProperty | undefined);
+    constructor(children: ClientMarkdownNode[], properties: MarkdownProperty | undefined);
 }
 export declare class Paragraph extends StyledMarkdownNode implements ClientStyledMarkdownNode {
     readonly elementName = "p";
@@ -62,12 +67,12 @@ export declare class Span extends StyledMarkdownNode implements ClientStyledMark
 export declare class Div extends StyledMarkdownNode implements ClientStyledMarkdownNode {
     readonly elementName = "div";
 }
-export declare class ChildMarkdownNode implements ClientChildMarkdownNode {
+export declare class ChildMarkdownNode extends MarkdownNode implements ClientChildMarkdownNode {
     readonly role = "child";
     readonly value: string;
     constructor(value: string);
 }
-export declare class Html implements ClientHtmlMarkdownNode {
+export declare class Html extends MarkdownNode implements ClientHtmlMarkdownNode {
     readonly role = "html";
     readonly unsafeHtml: string;
     constructor(unsafeHtml: string);

package/dist/instance/repeat/RepeatInstance.d.ts

@@ -30,6 +30,7 @@ interface RepeatInstanceOptions {
 export declare class RepeatInstance extends DescendantNode<AnyRepeatDefinition, RepeatInstanceStateSpec, RepeatRange, GeneralChildNode> implements RepeatInstanceNode, XFormsXPathElement, EvaluationContext, ClientReactiveSerializableTemplatedNode {
     readonly parent: RepeatRange;
     private readonly childrenState;
+    private readonly attributeState;
     private readonly currentIndex;
     readonly [XPathNodeKindKey] = "element";
     protected readonly state: SharedNodeState<RepeatInstanceStateSpec>;
@@ -66,5 +67,6 @@ export declare class RepeatInstance extends DescendantNode<AnyRepeatDefinition,
     readonly instanceState: InstanceState;
     constructor(parent: RepeatRange, instanceNode: StaticElement | null, options: RepeatInstanceOptions);
     getChildren(): readonly GeneralChildNode[];
+    getAttributes(): readonly Attribute[];
 }
 export {};

package/dist/integration/xpath/adapter/XFormsXPathNode.d.ts

@@ -64,7 +64,7 @@ export type XFormsXPathPrimaryInstanceNodeKind = XPathDocumentKind | XFormsXPath
 export interface XFormsXPathPrimaryInstanceNode extends XFormsXPathNode {
     readonly [XPathNodeKindKey]: XFormsXPathPrimaryInstanceNodeKind;
 }
-export type XFormsXPathPrimaryInstanceDescendantNodeKind = XFormsXPathNodeRangeKind | XPathElementKind | XPathTextKind;
+export type XFormsXPathPrimaryInstanceDescendantNodeKind = XFormsXPathNodeRangeKind | XPathAttributeKind | XPathElementKind | XPathTextKind;
 export interface XFormsXPathPrimaryInstanceDescendantNode extends XFormsXPathNode {
     readonly [XPathNodeKindKey]: XFormsXPathPrimaryInstanceDescendantNodeKind;
 }

package/dist/integration/xpath/adapter/kind.d.ts

@@ -1,19 +1,21 @@
 import { XPathNodeKind } from '@getodk/xpath';
+import { Attribute } from '../../../instance/Attribute.ts';
 import { AnyChildNode, AnyNode, AnyParentNode } from '../../../instance/hierarchy.ts';
 import { PrimaryInstance } from '../../../instance/PrimaryInstance.ts';
 import { StaticAttribute } from '../static-dom/StaticAttribute.ts';
 import { StaticDocument } from '../static-dom/StaticDocument.ts';
 import { StaticElement } from '../static-dom/StaticElement.ts';
 import { StaticText } from '../static-dom/StaticText.ts';
-import { XFormsXPathComment, XFormsXPathDocument, XFormsXPathElement, XFormsXPathPrimaryInstanceNode } from './XFormsXPathNode.ts';
+import { XFormsXPathAttribute, XFormsXPathComment, XFormsXPathDocument, XFormsXPathElement, XFormsXPathPrimaryInstanceNode } from './XFormsXPathNode.ts';
 export type PrimaryInstanceXPathNode = Extract<AnyNode, XFormsXPathPrimaryInstanceNode>;
 export type PrimaryInstanceXPathElement = Extract<AnyChildNode, XFormsXPathElement>;
+export type PrimaryInstanceXPathAttribute = Extract<Attribute, XFormsXPathAttribute>;
 export type PrimaryInstanceXPathComment = Extract<AnyChildNode, XFormsXPathComment>;
-export type PrimaryInstanceXPathChildNode = PrimaryInstanceXPathElement | PrimaryInstanceXPathComment;
+export type PrimaryInstanceXPathChildNode = PrimaryInstanceXPathElement | PrimaryInstanceXPathAttribute | PrimaryInstanceXPathComment;
 export type EngineXPathDocument = PrimaryInstance | StaticDocument;
 export type EngineXPathElement = PrimaryInstanceXPathElement | StaticElement;
 export type EngineXPathComment = PrimaryInstanceXPathComment;
-export type EngineXPathAttribute = StaticAttribute;
+export type EngineXPathAttribute = PrimaryInstanceXPathAttribute | StaticAttribute;
 export type EngineXPathText = StaticText;
 export type XFormsXPathChildNode = EngineXPathElement | EngineXPathText | EngineXPathComment;
 type XPathAdapterParentNode = XFormsXPathDocument | XFormsXPathElement;