@getodk/xforms-engine 0.1.1 → 0.2.0

package/dist/body/BodyDefinition.d.ts

@@ -1,27 +1,26 @@
 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 { AnySelectDefinition } from './control/select/SelectDefinition.ts';
 import { LogicalGroupDefinition } from './group/LogicalGroupDefinition.ts';
 import { PresentationGroupDefinition } from './group/PresentationGroupDefinition.ts';
-import { RepeatGroupDefinition } from './group/RepeatGroupDefinition.ts';
 import { StructuralGroupDefinition } from './group/StructuralGroupDefinition.ts';
 
 export interface BodyElementParentContext {
     readonly reference: string | null;
     readonly element: Element;
 }
-type SupportedBodyElementDefinition = RepeatGroupDefinition | LogicalGroupDefinition | PresentationGroupDefinition | StructuralGroupDefinition | InputDefinition | AnySelectDefinition;
+export type ControlElementDefinition = AnySelectDefinition | InputDefinition;
+type SupportedBodyElementDefinition = RepeatElementDefinition | LogicalGroupDefinition | PresentationGroupDefinition | StructuralGroupDefinition | ControlElementDefinition;
 export type AnyBodyElementDefinition = SupportedBodyElementDefinition | UnsupportedBodyElementDefinition;
 export type BodyElementDefinitionArray = readonly AnyBodyElementDefinition[];
 export type AnyBodyElementType = AnyBodyElementDefinition['type'];
 export type AnyGroupElementDefinition = Extract<AnyBodyElementDefinition, {
     readonly type: `${string}-group`;
 }>;
-export type NonRepeatGroupElementDefinition = Exclude<AnyGroupElementDefinition, {
-    readonly type: 'repeat-group';
-}>;
 export declare const groupElementDefinition: (element: AnyBodyElementDefinition) => AnyGroupElementDefinition | null;
 export type AnyControlElementDefinition = Extract<AnyBodyElementDefinition, {
     readonly category: 'control';
@@ -37,17 +36,35 @@ declare class BodyElementMap extends Map<BodyElementReference, AnyBodyElementDef
         [k: string]: AnyBodyElementDefinition;
     };
 }
+declare const bodyClassParser: TokenListParser<"pages", "pages">;
+export type BodyClassList = ParsedTokenList<typeof bodyClassParser>;
 export declare class BodyDefinition extends DependencyContext {
     protected readonly form: XFormDefinition;
     static getChildElementDefinitions(form: XFormDefinition, parent: BodyElementParentContext, parentElement: Element, children?: readonly Element[]): readonly AnyBodyElementDefinition[];
     readonly element: Element;
+    /**
+     * @todo this class is already an oddity in that it's **like** an element
+     * definition, but it isn't one itself. Adding this property here emphasizes
+     * that awkwardness. It also extends the applicable scope where instances of
+     * this class are accessed. While it's still ephemeral, it's anticipated that
+     * this extension might cause some disomfort. If so, the most plausible
+     * alternative is an additional refactor to:
+     *
+     * 1. Introduce a `BodyElementDefinition` sublass for `<h:body>`.
+     * 2. Disambiguate the respective names of those, in some reasonable way.
+     * 3. Add a layer of indirection between this class and that new body element
+     *    definition's class.
+     * 4. At that point, we may as well prioritize the little bit of grunt work to
+     *    pass the `BodyDefinition` instance by reference rather than assigning it
+     *    to anything.
+     */
+    readonly classes: BodyClassList;
     readonly elements: readonly AnyBodyElementDefinition[];
     protected readonly elementsByReference: BodyElementMap;
     readonly parentReference: null;
     readonly reference: string;
     constructor(form: XFormDefinition);
     getBodyElement(reference: string): AnyBodyElementDefinition | null;
-    getRepeatGroup(reference: string): RepeatGroupDefinition | null;
-    toJSON(): Omit<this, "toJSON" | "form" | "isTranslated" | "registerDependentExpression" | "dependencyExpressions" | "getBodyElement" | "getRepeatGroup">;
+    toJSON(): Omit<this, "toJSON" | "form" | "isTranslated" | "registerDependentExpression" | "dependencyExpressions" | "getBodyElement">;
 }
 export {};

package/dist/body/RepeatElementDefinition.d.ts

@@ -0,0 +1,19 @@
+import { XFormDefinition } from '../XFormDefinition.ts';
+import { BodyElementDefinitionArray, BodyElementParentContext } from './BodyDefinition.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";
+    readonly type = "repeat";
+    readonly reference: string;
+    readonly appearances: StructureElementAppearanceDefinition;
+    readonly label: LabelDefinition | null;
+    readonly countExpression: string | null;
+    readonly isFixedCount: boolean;
+    readonly children: BodyElementDefinitionArray;
+    constructor(form: XFormDefinition, parent: BodyElementParentContext, element: Element);
+    toJSON(): Omit<this, "toJSON" | "form" | "parent" | "isTranslated" | "registerDependentExpression" | "dependencyExpressions">;
+}

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

@@ -0,0 +1,4 @@
+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/appearance/selectAppearanceParser.d.ts

@@ -0,0 +1,4 @@
+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/appearance/structureElementAppearanceParser.d.ts

@@ -0,0 +1,4 @@
+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/body/control/ControlDefinition.d.ts

@@ -1,4 +1,5 @@
 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';
@@ -11,6 +12,7 @@ export declare abstract class ControlDefinition<Type extends ControlType> extend
     readonly reference: string;
     readonly label: LabelDefinition | null;
     readonly hint: HintDefinition | null;
+    abstract readonly appearances: ParsedTokenList<any>;
     constructor(form: XFormDefinition, parent: BodyElementParentContext, element: Element);
 }
 export type AnyControlDefinition = ControlDefinition<any>;

package/dist/body/control/InputDefinition.d.ts

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

package/dist/body/control/select/SelectDefinition.d.ts

@@ -2,11 +2,20 @@ import { CollectionValues } from '../../../../../common/types/collections/Collec
 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 { ControlDefinition } from '../ControlDefinition.ts';
 import { ItemDefinition } from './ItemDefinition.ts';
 import { ItemsetDefinition } from './ItemsetDefinition.ts';
 
-declare const selectLocalNames: Set<"select" | "rank" | "select1">;
+/**
+ * @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> {
 }
@@ -15,6 +24,7 @@ export declare class SelectDefinition<Type extends SelectType> extends ControlDe
     static isSelect(element: AnyBodyElementDefinition): element is AnySelectDefinition;
     readonly type: Type;
     readonly element: SelectElement;
+    readonly appearances: SelectAppearanceDefinition;
     readonly itemset: ItemsetDefinition | null;
     readonly items: readonly ItemDefinition[];
     constructor(form: XFormDefinition, parent: BodyElementParentContext, element: Element);

package/dist/body/group/BaseGroupDefinition.d.ts

@@ -1,6 +1,7 @@
 import { XFormDefinition } from '../../XFormDefinition.ts';
 import { BodyElementDefinitionArray, BodyElementParentContext } from '../BodyDefinition.ts';
 import { BodyElementDefinition } from '../BodyElementDefinition.ts';
+import { StructureElementAppearanceDefinition } from '../appearance/structureElementAppearanceParser.ts';
 import { LabelDefinition } from '../text/LabelDefinition.ts';
 
 /**
@@ -16,10 +17,6 @@ import { LabelDefinition } from '../text/LabelDefinition.ts';
  * - `presentation-group` is a group with a `<label>` child; its usage here
  *   differs from the spec language in that `presentation-group` does **not**
  *   have a `ref`
- * - `repeat-group` is not mentioned by the spec; it is an extension of
- *   `logical-group`, wherein its `ref` is the same as its immediate `<repeat>`
- *   child's `nodeset` (usage of each attribute is normalized during
- *   initialization, in {@link XFormDOM})
  * - `structural-group` is any `<group>` element which does not satisfy any of
  *   the other usage scenarios; this isn't exactly the terminology used, but is
  *   the most closely fitting name for the concept where the other sceanarios
@@ -27,21 +24,19 @@ import { LabelDefinition } from '../text/LabelDefinition.ts';
  *
  * A more succinct decision tree:
  *
- * - `<group ref="$ref"><repeat nodeset="$ref">` -> `repeat-group`, else
  * - `<group ref="$ref">` -> `logical-group`, else
  * - `<group><label>` -> `presentation-group`, else
  * - `<group>` -> `structural-group`
  */
-export type GroupType = 'logical-group' | 'presentation-group' | 'repeat-group' | 'structural-group';
+export type GroupType = 'logical-group' | 'presentation-group' | 'structural-group';
 export declare abstract class BaseGroupDefinition<Type extends GroupType> extends BodyElementDefinition<Type> {
     private static groupTypes;
     protected static getGroupType(localName: string, element: Element): GroupType | null;
     readonly category = "structure";
     readonly children: BodyElementDefinitionArray;
     readonly reference: string | null;
+    readonly appearances: StructureElementAppearanceDefinition;
     readonly label: LabelDefinition | null;
     constructor(form: XFormDefinition, parent: BodyElementParentContext, element: Element, children?: BodyElementDefinitionArray);
     getChildren(element: Element): BodyElementDefinitionArray;
 }
-export declare const repeatGroup: <T extends BaseGroupDefinition<any>>(groupDefinition: T) => Extract<T, BaseGroupDefinition<'repeat-group'>> | null;
-export declare const nonRepeatGroup: <T extends BaseGroupDefinition<any>>(groupDefinition: T) => Exclude<T, BaseGroupDefinition<'repeat-group'>> | null;

package/dist/body/text/LabelDefinition.d.ts

@@ -3,6 +3,7 @@ import { AnyControlDefinition } from '../control/ControlDefinition.ts';
 import { ItemDefinition } from '../control/select/ItemDefinition.ts';
 import { ItemsetDefinition } from '../control/select/ItemsetDefinition.ts';
 import { BaseGroupDefinition } from '../group/BaseGroupDefinition.ts';
+import { RepeatElementDefinition } from '../RepeatElementDefinition.ts';
 import { TextElement, TextElementOwner, TextElementDefinition } from './TextElementDefinition.ts';
 
 export interface LabelElement extends TextElement {
@@ -12,6 +13,7 @@ type StaticLabelContext = Exclude<TextElementOwner, ItemsetDefinition>;
 export declare class LabelDefinition extends TextElementDefinition<'label'> {
     protected static staticDefinition(form: XFormDefinition, definition: StaticLabelContext): LabelDefinition | null;
     static forControl(form: XFormDefinition, control: AnyControlDefinition): LabelDefinition | null;
+    static forRepeatGroup(form: XFormDefinition, repeat: RepeatElementDefinition): LabelDefinition | null;
     static forGroup(form: XFormDefinition, group: BaseGroupDefinition<any>): LabelDefinition | null;
     static forItem(form: XFormDefinition, item: ItemDefinition): LabelDefinition | null;
     static forItemset(form: XFormDefinition, itemset: ItemsetDefinition): LabelDefinition | null;

package/dist/body/text/TextElementDefinition.d.ts

@@ -2,10 +2,10 @@ import { XFormDefinition } from '../../XFormDefinition.ts';
 import { AnyDependentExpression } from '../../expression/DependentExpression.ts';
 import { AnyGroupElementDefinition } from '../BodyDefinition.ts';
 import { BodyElementDefinition } from '../BodyElementDefinition.ts';
-import { InputDefinition } from '../control/InputDefinition.ts';
+import { RepeatElementDefinition } from '../RepeatElementDefinition.ts';
+import { AnyControlDefinition } from '../control/ControlDefinition.ts';
 import { ItemDefinition } from '../control/select/ItemDefinition.ts';
 import { ItemsetDefinition } from '../control/select/ItemsetDefinition.ts';
-import { AnySelectDefinition } from '../control/select/SelectDefinition.ts';
 import { TextElementOutputPart } from './TextElementOutputPart.ts';
 import { TextElementReferencePart } from './TextElementReferencePart.ts';
 import { TextElementStaticPart } from './TextElementStaticPart.ts';
@@ -14,7 +14,7 @@ export type TextElementType = 'hint' | 'label';
 export interface TextElement extends Element {
     readonly localName: TextElementType;
 }
-export type TextElementOwner = AnyGroupElementDefinition | AnySelectDefinition | InputDefinition | ItemDefinition | ItemsetDefinition;
+export type TextElementOwner = AnyControlDefinition | AnyGroupElementDefinition | ItemDefinition | ItemsetDefinition | RepeatElementDefinition;
 export type TextElementChild = TextElementOutputPart | TextElementStaticPart;
 export declare abstract class TextElementDefinition<Type extends TextElementType> extends BodyElementDefinition<Type> {
     readonly owner: TextElementOwner;

package/dist/client/BaseNode.d.ts

@@ -1,6 +1,7 @@
 import { AnyNodeDefinition } from '../model/NodeDefinition.ts';
-import { InstanceNodeType } from './node-types.js';
+import { NodeAppearances } from './NodeAppearances.ts';
 import { TextRange } from './TextRange.ts';
+import { InstanceNodeType } from './node-types.ts';
 
 export interface BaseNodeState {
     /**
@@ -108,6 +109,10 @@ export interface BaseNode {
      * the lifetime of an active session filling a form.
      */
     readonly nodeId: FormNodeID;
+    /**
+     * @see {@link TokenListParser} for details.
+     */
+    readonly appearances: NodeAppearances<any> | null;
     /**
      * Each node has a definition which specifies aspects of the node defined in
      * the form. These aspects include (but are not limited to) the node's data

package/dist/client/GroupNode.d.ts

@@ -1,6 +1,7 @@
-import { NonRepeatGroupElementDefinition } from '../body/BodyDefinition.ts';
+import { AnyGroupElementDefinition } from '../body/BodyDefinition.ts';
 import { SubtreeDefinition } from '../model/SubtreeDefinition.ts';
 import { BaseNode, BaseNodeState } from './BaseNode.ts';
+import { NodeAppearances } from './NodeAppearances.ts';
 import { RootNode } from './RootNode.ts';
 import { GeneralChildNode, GeneralParentNode } from './hierarchy.ts';
 
@@ -11,13 +12,15 @@ export interface GroupNodeState extends BaseNodeState {
     get value(): null;
 }
 export interface GroupDefinition extends SubtreeDefinition {
-    readonly bodyElement: NonRepeatGroupElementDefinition;
+    readonly bodyElement: AnyGroupElementDefinition;
 }
+export type GroupNodeAppearances = NodeAppearances<GroupDefinition>;
 /**
  * A node corresponding to an XForms `<group>`.
  */
 export interface GroupNode extends BaseNode {
     readonly nodeType: 'group';
+    readonly appearances: GroupNodeAppearances;
     readonly definition: GroupDefinition;
     readonly root: RootNode;
     readonly parent: GeneralParentNode;

package/dist/client/NodeAppearances.d.ts

@@ -0,0 +1,15 @@
+import { ParsedTokenList } from '../lib/TokenListParser.ts';
+import { NodeDefinition } from '../model/NodeDefinition.ts';
+
+/**
+ * - Provides a means to distinguish between internal and client-facing names
+ *   for the same {@link ParsedTokenList} types.
+ *
+ * - Anticipates some iteration on both parsed ("definition") types and
+ *   client-facing node types, which may not happen in tandem.
+ */
+export type NodeAppearances<Definition extends NodeDefinition<any>> = Definition extends {
+    readonly bodyElement: {
+        readonly appearances: infer Appearances extends ParsedTokenList<any>;
+    };
+} ? Appearances : null;

package/dist/client/RepeatInstanceNode.d.ts

@@ -1,6 +1,7 @@
 import { RepeatInstanceDefinition } from '../model/RepeatInstanceDefinition.ts';
 import { RepeatTemplateDefinition } from '../model/RepeatTemplateDefinition.ts';
 import { BaseNode, BaseNodeState } from './BaseNode.ts';
+import { NodeAppearances } from './NodeAppearances.ts';
 import { RepeatRangeNode } from './RepeatRangeNode.ts';
 import { RootNode } from './RootNode.ts';
 import { GeneralChildNode } from './hierarchy.ts';
@@ -12,8 +13,10 @@ export interface RepeatInstanceNodeState extends BaseNodeState {
     get value(): null;
 }
 export type RepeatDefinition = RepeatInstanceDefinition | RepeatTemplateDefinition;
+export type RepeatInstanceNodeAppearances = NodeAppearances<RepeatDefinition>;
 export interface RepeatInstanceNode extends BaseNode {
     readonly nodeType: 'repeat-instance';
+    readonly appearances: RepeatInstanceNodeAppearances;
     readonly definition: RepeatDefinition;
     readonly root: RootNode;
     /**

package/dist/client/RepeatRangeNode.d.ts

@@ -1,5 +1,6 @@
-import { RepeatSequenceDefinition } from '../model/RepeatSequenceDefinition.ts';
+import { RepeatRangeDefinition } from '../model/RepeatRangeDefinition.ts';
 import { BaseNode, BaseNodeState } from './BaseNode.ts';
+import { NodeAppearances } from './NodeAppearances.ts';
 import { RepeatInstanceNode } from './RepeatInstanceNode.ts';
 import { RootNode } from './RootNode.ts';
 import { TextRange } from './TextRange.ts';
@@ -20,6 +21,7 @@ export interface RepeatRangeNodeState extends BaseNodeState {
     get valueOptions(): null;
     get value(): null;
 }
+export type RepeatRangeNodeAppearances = NodeAppearances<RepeatRangeDefinition>;
 /**
  * Represents a contiguous set of zero or more {@link RepeatInstanceNode}s
  * (accessed by its
@@ -86,7 +88,8 @@ export interface RepeatRangeNodeState extends BaseNodeState {
  */
 export interface RepeatRangeNode extends BaseNode {
     readonly nodeType: 'repeat-range';
-    readonly definition: RepeatSequenceDefinition;
+    readonly appearances: RepeatRangeNodeAppearances;
+    readonly definition: RepeatRangeDefinition;
     readonly root: RootNode;
     readonly parent: GeneralParentNode;
     readonly currentState: RepeatRangeNodeState;

package/dist/client/RootNode.d.ts

@@ -1,3 +1,4 @@
+import { BodyClassList } from '../body/BodyDefinition.ts';
 import { RootDefinition } from '../model/RootDefinition.ts';
 import { BaseNode, BaseNodeState } from './BaseNode.ts';
 import { ActiveLanguage, FormLanguage, FormLanguages } from './FormLanguage.ts';
@@ -19,6 +20,24 @@ export interface RootNodeState extends BaseNodeState {
 }
 export interface RootNode extends BaseNode {
     readonly nodeType: 'root';
+    /**
+     * @todo this along with {@link classes} is... awkward.
+     */
+    readonly appearances: null;
+    /**
+     * @todo This is another odd deviation in {@link RootNode}. Unlike
+     * {@link languages}, it doesn't feel particularly **essential**. While it
+     * would deviate from XForms spec terminology, it seems like it _might be
+     * reasonable_ to instead convey `<h:body class="...">` as
+     * {@link RootNode.appearances} in the client interface. They do have slightly
+     * different spec semantics (i.e. a body class can be anything, to trigger
+     * styling in a form UI). But the **most likely anticipated** use case in Web
+     * Forms would be the "pages" class, and perhaps "theme-grid". The former is
+     * definitely conceptually similar to a XForms `appearance` (albeit
+     * form-global, which is not a spec concept). The latter does as well, and we
+     * already anticipate applying that concept in non-form-global ways.
+     */
+    readonly classes: BodyClassList;
     readonly definition: RootDefinition;
     readonly root: RootNode;
     readonly parent: null;

package/dist/client/SelectNode.d.ts

@@ -1,6 +1,7 @@
 import { AnySelectDefinition } from '../body/control/select/SelectDefinition.ts';
 import { ValueNodeDefinition } from '../model/ValueNodeDefinition.ts';
 import { BaseNode, BaseNodeState } from './BaseNode.ts';
+import { NodeAppearances } from './NodeAppearances.ts';
 import { RootNode } from './RootNode.ts';
 import { TextRange } from './TextRange.ts';
 import { GeneralParentNode } from './hierarchy.ts';
@@ -32,8 +33,10 @@ export interface SelectNodeState extends BaseNodeState {
 export interface SelectDefinition extends ValueNodeDefinition {
     readonly bodyElement: AnySelectDefinition;
 }
+export type SelectNodeAppearances = NodeAppearances<SelectDefinition>;
 export interface SelectNode extends BaseNode {
     readonly nodeType: 'select';
+    readonly appearances: SelectNodeAppearances;
     readonly definition: SelectDefinition;
     readonly root: RootNode;
     readonly parent: GeneralParentNode;

package/dist/client/StringNode.d.ts

@@ -1,6 +1,7 @@
 import { InputDefinition } from '../body/control/InputDefinition.ts';
 import { ValueNodeDefinition } from '../model/ValueNodeDefinition.ts';
 import { BaseNode, BaseNodeState } from './BaseNode.ts';
+import { NodeAppearances } from './NodeAppearances.ts';
 import { RootNode } from './RootNode.ts';
 import { GeneralParentNode } from './hierarchy.ts';
 
@@ -18,6 +19,7 @@ export interface StringNodeState extends BaseNodeState {
 export interface StringDefinition extends ValueNodeDefinition {
     readonly bodyElement: InputDefinition | null;
 }
+export type StringNodeAppearances = NodeAppearances<StringDefinition>;
 /**
  * A node which can be assigned a string/text value. A string node **MAY**
  * correspond to form field defined as an XForms `<input>`, which a user-facing
@@ -27,6 +29,7 @@ export interface StringDefinition extends ValueNodeDefinition {
  */
 export interface StringNode extends BaseNode {
     readonly nodeType: 'string';
+    readonly appearances: StringNodeAppearances;
     readonly definition: StringDefinition;
     readonly root: RootNode;
     readonly parent: GeneralParentNode;

package/dist/client/SubtreeNode.d.ts

@@ -46,6 +46,7 @@ export interface SubtreeDefinition extends BaseSubtreeDefinition {
  */
 export interface SubtreeNode extends BaseNode {
     readonly nodeType: 'subtree';
+    readonly appearances: null;
     readonly definition: SubtreeDefinition;
     readonly root: RootNode;
     readonly parent: GeneralParentNode;