@getodk/xforms-engine 0.13.0 → 0.15.0

package/src/parse/model/{RootAttributeMap.ts → AttributeDefinitionMap.ts}

@@ -2,8 +2,8 @@ import { XMLNS_NAMESPACE_URI } from '@getodk/common/constants/xmlns.ts';
 import type { StaticAttribute } from '../../integration/xpath/static-dom/StaticAttribute.ts';
 import type { StaticElement } from '../../integration/xpath/static-dom/StaticElement.ts';
 import type { QualifiedName } from '../../lib/names/QualifiedName.ts';
-import { RootAttributeDefinition } from './RootAttributeDefinition.ts';
-import type { RootDefinition } from './RootDefinition.ts';
+import { AttributeDefinition } from './AttributeDefinition.ts';
+import type { ModelDefinition } from './ModelDefinition.ts';
 
 /**
  * @todo We should probably just distinguish these as separate `StaticNode`
@@ -14,12 +14,6 @@ const isNonNamespaceAttribute = (attribute: StaticAttribute) => {
 };
 
 /**
- * @todo This can be trivially expanded to a narrowly general case when we
- * prioritize work to
- * {@link https://github.com/getodk/web-forms/issues/285 | support attributes}
- * (as modeled form nodes on par with elements). It's been deferred here to
- * avoid expanding scope of an already fairly large yak shave.
- *
  * @todo There's a **much more expansive** general case just waiting for a good
  * opportuntity to prioritize it. E.g. a `NamedNodeMap<T>`, where T is any
  * generalized concept of a named node. This expansive generalization would have
@@ -29,17 +23,17 @@ const isNonNamespaceAttribute = (attribute: StaticAttribute) => {
  *
  * @see {@link QualifiedName} for more detail.
  */
-export class RootAttributeMap extends Map<QualifiedName, RootAttributeDefinition> {
-	static from(root: RootDefinition, instanceNode: StaticElement) {
+export class AttributeDefinitionMap extends Map<QualifiedName, AttributeDefinition> {
+	static from(model: ModelDefinition, instanceNode: StaticElement) {
 		const nonNamespaceAttributes = instanceNode.attributes.filter(isNonNamespaceAttribute);
 		const definitions = nonNamespaceAttributes.map((attribute) => {
-			return new RootAttributeDefinition(root, attribute);
+			const bind = model.binds.getOrCreateBindDefinition(attribute.nodeset);
+			return new AttributeDefinition(model.root, bind, attribute);
 		});
-
 		return new this(definitions);
 	}
 
-	private constructor(definitions: readonly RootAttributeDefinition[]) {
+	private constructor(definitions: readonly AttributeDefinition[]) {
 		super(
 			definitions.map((attribute) => {
 				return [attribute.qualifiedName, attribute];

package/src/parse/model/{SubtreeDefinition.ts → GroupDefinition.ts}

@@ -1,25 +1,27 @@
 import type { StaticElement } from '../../integration/xpath/static-dom/StaticElement.ts';
 import { NamespaceDeclarationMap } from '../../lib/names/NamespaceDeclarationMap.ts';
 import { QualifiedName } from '../../lib/names/QualifiedName.ts';
-import type {
-	AnyBodyElementDefinition,
-	AnyGroupElementDefinition,
-} from '../body/BodyDefinition.ts';
+import type { AnyBodyElementDefinition } from '../body/BodyDefinition.ts';
+import type { GroupElementDefinition } from '../body/GroupElementDefinition.ts';
+import { AttributeDefinitionMap } from './AttributeDefinitionMap.ts';
 import type { BindDefinition } from './BindDefinition.ts';
 import { DescendentNodeDefinition } from './DescendentNodeDefinition.ts';
+import type { ModelDefinition } from './ModelDefinition.ts';
 import type { ChildNodeDefinition, ParentNodeDefinition } from './NodeDefinition.ts';
 
-export class SubtreeDefinition extends DescendentNodeDefinition<
-	'subtree',
-	AnyGroupElementDefinition | null
+export class GroupDefinition extends DescendentNodeDefinition<
+	'group',
+	GroupElementDefinition | null
 > {
-	readonly type = 'subtree';
+	readonly type = 'group';
 
 	readonly namespaceDeclarations: NamespaceDeclarationMap;
 	readonly qualifiedName: QualifiedName;
 	readonly children: readonly ChildNodeDefinition[];
+	readonly attributes: AttributeDefinitionMap;
 
 	constructor(
+		model: ModelDefinition,
 		parent: ParentNodeDefinition,
 		bind: BindDefinition,
 		bodyElement: AnyBodyElementDefinition | null,
@@ -39,6 +41,8 @@ export class SubtreeDefinition extends DescendentNodeDefinition<
 		this.qualifiedName = template.qualifiedName;
 		this.namespaceDeclarations = new NamespaceDeclarationMap(this);
 		this.children = root.buildSubtree(this, template);
+
+		this.attributes = AttributeDefinitionMap.from(model, template);
 	}
 
 	toJSON() {

package/src/parse/model/LeafNodeDefinition.ts

@@ -20,6 +20,7 @@ export class LeafNodeDefinition<V extends ValueType = ValueType>
 	readonly namespaceDeclarations: NamespaceDeclarationMap;
 	readonly qualifiedName: QualifiedName;
 	readonly children = null;
+	readonly attributes = null;
 
 	constructor(
 		parent: ParentNodeDefinition,

package/src/parse/model/NodeDefinition.ts

@@ -1,3 +1,4 @@
+import type { StaticAttribute } from '../../integration/xpath/static-dom/StaticAttribute.ts';
 import type { StaticElement } from '../../integration/xpath/static-dom/StaticElement.ts';
 import type {
 	NamedSubtreeDefinition,
@@ -6,11 +7,13 @@ import type {
 import type { QualifiedName } from '../../lib/names/QualifiedName.ts';
 import type { AnyBodyElementDefinition } from '../body/BodyDefinition.ts';
 import type { RepeatElementDefinition } from '../body/RepeatElementDefinition.ts';
+import type { AttributeDefinition } from './AttributeDefinition.ts';
+import type { AttributeDefinitionMap } from './AttributeDefinitionMap.ts';
 import type { BindDefinition } from './BindDefinition.ts';
+import type { GroupDefinition } from './GroupDefinition.ts';
 import type { LeafNodeDefinition } from './LeafNodeDefinition.ts';
 import type { AnyRepeatDefinition } from './RepeatDefinition.ts';
 import type { RootDefinition } from './RootDefinition.ts';
-import type { SubtreeDefinition } from './SubtreeDefinition.ts';
 
 /**
  * Corresponds to a model instance root node, i.e.:
@@ -33,10 +36,9 @@ export type RepeatType = 'repeat';
 
 /**
  * Corresponds to a model instance subtree which **does not** correspond to a
- * <repeat> in the form definition. This will typically correspond to a <group>,
- * but this is not strictly necessary per spec (hence the distinct name).
+ * <repeat> in the form definition.
  */
-export type SubtreeNodeType = 'subtree';
+export type GroupNodeType = 'group';
 
 /**
  * Corresponds to a model instance leaf node, i.e. one of:
@@ -46,26 +48,29 @@ export type SubtreeNodeType = 'subtree';
  */
 export type LeafNodeType = 'leaf-node';
 
+export type AttributeNodeType = 'attribute';
+
 // prettier-ignore
 export type NodeDefinitionType =
 	// eslint-disable-next-line @typescript-eslint/sort-type-constituents
 	| RootNodeType
 	| RepeatType
-	| SubtreeNodeType
-	| LeafNodeType;
+	| GroupNodeType
+	| LeafNodeType
+	| AttributeNodeType;
 
 // prettier-ignore
 export type ParentNodeDefinition =
 	// eslint-disable-next-line @typescript-eslint/sort-type-constituents
 	| RootDefinition
 	| AnyRepeatDefinition
-	| SubtreeDefinition;
+	| GroupDefinition;
 
 // prettier-ignore
 export type ChildNodeDefinition =
 	| AnyRepeatDefinition
-	| LeafNodeDefinition
-	| SubtreeDefinition;
+	| GroupDefinition
+	| LeafNodeDefinition;
 
 export abstract class NodeDefinition<Type extends NodeDefinitionType>
 	implements NamedSubtreeDefinition
@@ -77,8 +82,9 @@ export abstract class NodeDefinition<Type extends NodeDefinitionType>
 	abstract readonly isTranslated: boolean;
 	abstract readonly root: RootDefinition;
 	abstract readonly parent: ParentNodeDefinition | null;
-	abstract readonly template: StaticElement;
+	abstract readonly template: StaticAttribute | StaticElement;
 	abstract readonly children: readonly ChildNodeDefinition[] | null;
+	abstract readonly attributes: AttributeDefinitionMap | null;
 
 	readonly nodeset: string;
 
@@ -92,5 +98,6 @@ export type AnyNodeDefinition =
 	// eslint-disable-next-line @typescript-eslint/sort-type-constituents
 	| RootDefinition
 	| AnyRepeatDefinition
-	| SubtreeDefinition
-	| LeafNodeDefinition;
+	| GroupDefinition
+	| LeafNodeDefinition
+	| AttributeDefinition;

package/src/parse/model/RepeatDefinition.ts

@@ -19,11 +19,13 @@ import type { NamespaceURL } from '../../lib/names/NamespaceURL.ts';
 import type { QualifiedName, QualifiedNameSource } from '../../lib/names/QualifiedName.ts';
 import type { RepeatElementDefinition } from '../body/RepeatElementDefinition.ts';
 import { RepeatCountControlExpression } from '../expression/RepeatCountControlExpression.ts';
+import { AttributeDefinitionMap } from './AttributeDefinitionMap.ts';
 import type { BindDefinition } from './BindDefinition.ts';
 import { DescendentNodeDefinition } from './DescendentNodeDefinition.ts';
+import type { GroupDefinition } from './GroupDefinition.ts';
+import type { ModelDefinition } from './ModelDefinition.ts';
 import type { ChildNodeDefinition, ParentNodeDefinition } from './NodeDefinition.ts';
 import type { RootDefinition } from './RootDefinition.ts';
-import type { SubtreeDefinition } from './SubtreeDefinition.ts';
 
 interface JavaRosaNamespaceURI extends NamespaceURL {
 	readonly href: JAVAROSA_NAMESPACE_URI;
@@ -284,7 +286,7 @@ export interface UncontrolledRepeatDefinition extends RepeatDefinition {
  * "repeat", as defined by a form, where those concepts include:
  *
  * - A {@link RepeatElementDefinition}—corresponding to a `<repeat>` {@link https://getodk.github.io/xforms-spec/#body-elements | body element}—which is associated with the nodeset referencing the "repeat template" and
- *   all "repeat instances" (see below points describing both concepts in more detail). The presence of such a body element determines whether to produce a repeat definition (rather than e.g. a {@link SubtreeDefinition}).
+ *   all "repeat instances" (see below points describing both concepts in more detail). The presence of such a body element determines whether to produce a repeat definition (rather than e.g. a {@link GroupDefinition}).
  *
  * - A "repeat template", defined by a form either
  *   explicitly,
@@ -313,18 +315,20 @@ export interface UncontrolledRepeatDefinition extends RepeatDefinition {
  */
 export class RepeatDefinition extends DescendentNodeDefinition<'repeat', RepeatElementDefinition> {
 	static from(
+		model: ModelDefinition,
 		parent: ParentNodeDefinition,
 		bind: BindDefinition,
 		bodyElement: RepeatElementDefinition,
 		instanceNodes: RepeatInstanceNodes
 	): AnyRepeatDefinition;
 	static from(
+		model: ModelDefinition,
 		parent: ParentNodeDefinition,
 		bind: BindDefinition,
 		bodyElement: RepeatElementDefinition,
 		instanceNodes: RepeatInstanceNodes
 	): RepeatDefinition {
-		return new this(parent, bind, bodyElement, instanceNodes);
+		return new this(model, parent, bind, bodyElement, instanceNodes);
 	}
 
 	readonly type = 'repeat';
@@ -333,8 +337,10 @@ export class RepeatDefinition extends DescendentNodeDefinition<'repeat', RepeatE
 	readonly template: StaticElement;
 	readonly namespaceDeclarations: NamespaceDeclarationMap;
 	readonly qualifiedName: QualifiedName;
+	readonly attributes: AttributeDefinitionMap;
 
 	private constructor(
+		model: ModelDefinition,
 		parent: ParentNodeDefinition,
 		bind: BindDefinition,
 		bodyElement: RepeatElementDefinition,
@@ -353,6 +359,7 @@ export class RepeatDefinition extends DescendentNodeDefinition<'repeat', RepeatE
 		this.children = root.buildSubtree(self, template);
 
 		const initialCount = this.omitTemplate(instanceNodes).length;
+		this.attributes = AttributeDefinitionMap.from(model, template);
 
 		this.count = RepeatCountControlExpression.from(bodyElement, initialCount);
 	}

package/src/parse/model/RootDefinition.ts

@@ -3,6 +3,8 @@ import { NamespaceDeclarationMap } from '../../lib/names/NamespaceDeclarationMap
 import { QualifiedName } from '../../lib/names/QualifiedName.ts';
 import type { BodyClassList } from '../body/BodyDefinition.ts';
 import type { XFormDefinition } from '../XFormDefinition.ts';
+import { AttributeDefinitionMap } from './AttributeDefinitionMap.ts';
+import { GroupDefinition } from './GroupDefinition.ts';
 import { LeafNodeDefinition } from './LeafNodeDefinition.ts';
 import type { ModelDefinition } from './ModelDefinition.ts';
 import type { ChildNodeDefinition, ParentNodeDefinition } from './NodeDefinition.ts';
@@ -10,9 +12,7 @@ import { NodeDefinition } from './NodeDefinition.ts';
 import { NoteNodeDefinition } from './NoteNodeDefinition.ts';
 import { RangeNodeDefinition } from './RangeNodeDefinition.ts';
 import { RepeatDefinition } from './RepeatDefinition.ts';
-import { RootAttributeMap } from './RootAttributeMap.ts';
 import type { SubmissionDefinition } from './SubmissionDefinition.ts';
-import { SubtreeDefinition } from './SubtreeDefinition.ts';
 
 export class RootDefinition extends NodeDefinition<'root'> {
 	readonly type = 'root';
@@ -22,7 +22,7 @@ export class RootDefinition extends NodeDefinition<'root'> {
 	readonly parent = null;
 	readonly template: StaticElement;
 	readonly namespaceDeclarations: NamespaceDeclarationMap;
-	readonly attributes: RootAttributeMap;
+	readonly attributes: AttributeDefinitionMap;
 	readonly children: readonly ChildNodeDefinition[];
 
 	readonly isTranslated = false;
@@ -51,7 +51,7 @@ export class RootDefinition extends NodeDefinition<'root'> {
 
 		this.qualifiedName = qualifiedName;
 		this.template = template;
-		this.attributes = RootAttributeMap.from(this, template);
+		this.attributes = AttributeDefinitionMap.from(model, template);
 		this.namespaceDeclarations = new NamespaceDeclarationMap(this);
 		this.children = this.buildSubtree(this, template);
 	}
@@ -87,7 +87,7 @@ export class RootDefinition extends NodeDefinition<'root'> {
 			const [firstChild, ...restChildren] = children;
 
 			if (bodyElement?.type === 'repeat') {
-				return RepeatDefinition.from(parent, bind, bodyElement, children);
+				return RepeatDefinition.from(model, parent, bind, bodyElement, children);
 			}
 
 			if (restChildren.length) {
@@ -107,7 +107,7 @@ export class RootDefinition extends NodeDefinition<'root'> {
 				);
 			}
 
-			return new SubtreeDefinition(parent, bind, bodyElement, element);
+			return new GroupDefinition(model, parent, bind, bodyElement, element);
 		});
 	}
 

package/src/parse/model/nodeDefinitionMap.ts

@@ -16,7 +16,7 @@ const collectDefinitions = (
 
 	result.set(nodeset, definition);
 
-	if (definition.type === 'leaf-node') {
+	if (definition.type === 'leaf-node' || definition.type === 'attribute') {
 		return result;
 	}
 

package/src/parse/text/LabelDefinition.ts

@@ -1,16 +1,15 @@
 import type { LocalNamedElement } from '@getodk/common/types/dom.ts';
 import { getLabelElement, getRepeatGroupLabelElement } from '../../lib/dom/query.ts';
 import type { XFormDefinition } from '../../parse/XFormDefinition.ts';
-import type { AnyGroupElementDefinition } from '../../parse/body/BodyDefinition.ts';
-import type { RepeatElementDefinition } from '../body/RepeatElementDefinition.ts';
 import type { AnyControlDefinition } from '../body/control/ControlDefinition.ts';
-import type { BaseGroupDefinition } from '../body/group/BaseGroupDefinition.ts';
+import type { GroupElementDefinition } from '../body/GroupElementDefinition.ts';
+import type { RepeatElementDefinition } from '../body/RepeatElementDefinition.ts';
 import { TextElementDefinition } from './abstract/TextElementDefinition.ts';
 
 // prettier-ignore
 export type LabelOwner =
 	| AnyControlDefinition
-	| AnyGroupElementDefinition
+	| GroupElementDefinition
 	| RepeatElementDefinition;
 
 interface LabelElement extends LocalNamedElement<'label'> {}
@@ -39,11 +38,7 @@ export class LabelDefinition extends TextElementDefinition<'label'> {
 		return new this(form, repeat, repeatGroupLabel);
 	}
 
-	static forGroup(
-		form: XFormDefinition,
-		// eslint-disable-next-line @typescript-eslint/no-explicit-any
-		group: BaseGroupDefinition<any>
-	): LabelDefinition | null {
+	static forGroup(form: XFormDefinition, group: GroupElementDefinition): LabelDefinition | null {
 		const labelElement = getLabelElement(group.element);
 
 		if (labelElement == null) {

package/dist/client/SubtreeNode.d.ts

@@ -1,56 +0,0 @@
-import { SubtreeDefinition as BaseSubtreeDefinition } from '../parse/model/SubtreeDefinition.ts';
-import { BaseNode, BaseNodeState } from './BaseNode.ts';
-import { RootNode } from './RootNode.ts';
-import { GeneralChildNode, GeneralParentNode } from './hierarchy.ts';
-import { AncestorNodeValidationState } from './validation.ts';
-export interface SubtreeNodeState extends BaseNodeState {
-    get label(): null;
-    get hint(): null;
-    get children(): readonly GeneralChildNode[];
-    get valueOptions(): null;
-    get value(): null;
-}
-export interface SubtreeDefinition extends BaseSubtreeDefinition {
-    readonly bodyElement: null;
-}
-/**
- * A non-root node which has children, but **no** corresponding XForms
- * `<group>`. A subtree node does not have any direct implications for
- * presentation to users, but its descendants may specify presentational details
- * in their own {@link BaseNode.definition | definition}s.
- *
- * @example
- *
- * A common `SubtreeNode` case will be a form's `<meta>` element:
- *
- * ```xml
- * <!-- /h:html/h:head/model -->
- * <instance>
- *   <data>
- *     <some-group>
- *       <some-field />
- *     </some-group>
- *     <!-- Note that `meta` does not have a corresponding group body element -->
- *     <!-- SubtreeNode(/data/meta): { ... -->
- *     <meta>
- *       <instanceID/>
- *     </meta>
- *     <!-- } -->
- *   </data>
- * </instance>
- * <!-- /h:html/h:body -->
- * <group ref="/data/some-group">
- *   <input ref="/data/some-group/some-field" />
- * </group>
- * ```
- */
-export interface SubtreeNode extends BaseNode {
-    readonly nodeType: 'subtree';
-    readonly appearances: null;
-    readonly nodeOptions: null;
-    readonly definition: SubtreeDefinition;
-    readonly root: RootNode;
-    readonly parent: GeneralParentNode;
-    readonly currentState: SubtreeNodeState;
-    readonly validationState: AncestorNodeValidationState;
-}

package/dist/error/TemplatedNodeAttributeSerializationError.d.ts

@@ -1,22 +0,0 @@
-/**
- * This error class is intended as a common point of reference for all of the
- * related interfaces and implementation where we've deferred two concerns:
- *
- * 1. Support for attributes on instance nodes (which may be bound in a form's
- *    model and/or may be expected to preserve model-defined defaults)
- * 2. Present lack of logic to treat a `jr:template` attribute as a special
- *    case: whereas in the general case we would expect to pass through a
- *    form/model-defined attribute, we expect to specifically **omit**
- *    `jr:template` from repeat instances derived from any of form's
- *    explicitly-defined repeat templates
- *
- * Addressing #1 is (now) a prerequisite to addressing #2, and it is also a
- * prerequisite for #2's unaddressed status to _become meaningfully observable
- * and problematic_.
- *
- * By introducing this error at a point where a change in #1's status is likely
- * to be implicated, we're also likely to be reminded to address #2 in tandem.
- */
-export declare class TemplatedNodeAttributeSerializationError extends Error {
-    constructor();
-}

package/dist/instance/Subtree.d.ts

@@ -1,38 +0,0 @@
-import { XPathNodeKindKey } from '@getodk/xpath';
-import { Accessor } from 'solid-js';
-import { FormNodeID } from '../client/identity.ts';
-import { InstanceState } from '../client/serialization/InstanceState.ts';
-import { SubtreeDefinition, SubtreeNode } from '../client/SubtreeNode.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 { MaterializedChildren } from '../lib/reactivity/materializeCurrentStateChildren.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 { DescendantNodeSharedStateSpec, DescendantNode } from './abstract/DescendantNode.ts';
-import { GeneralChildNode, GeneralParentNode } from './hierarchy.ts';
-import { EvaluationContext } from './internal-api/EvaluationContext.ts';
-import { ClientReactiveSerializableParentNode } from './internal-api/serialization/ClientReactiveSerializableParentNode.ts';
-interface SubtreeStateSpec extends DescendantNodeSharedStateSpec {
-    readonly label: null;
-    readonly hint: null;
-    readonly children: Accessor<readonly FormNodeID[]>;
-    readonly valueOptions: null;
-    readonly value: null;
-}
-export declare class Subtree extends DescendantNode<SubtreeDefinition, SubtreeStateSpec, GeneralParentNode, GeneralChildNode> implements SubtreeNode, XFormsXPathElement, EvaluationContext, ClientReactiveSerializableParentNode<GeneralChildNode> {
-    private readonly childrenState;
-    readonly [XPathNodeKindKey] = "element";
-    protected readonly state: SharedNodeState<SubtreeStateSpec>;
-    protected readonly engineState: EngineState<SubtreeStateSpec>;
-    readonly nodeType = "subtree";
-    readonly appearances: null;
-    readonly nodeOptions: null;
-    readonly currentState: MaterializedChildren<CurrentState<SubtreeStateSpec>, GeneralChildNode>;
-    readonly validationState: AncestorNodeValidationState;
-    readonly instanceState: InstanceState;
-    constructor(parent: GeneralParentNode, instanceNode: StaticElement | null, definition: SubtreeDefinition);
-    getChildren(): readonly GeneralChildNode[];
-}
-export {};

package/dist/instance/text/FormattedTextStub.d.ts

@@ -1 +0,0 @@
-export declare const FormattedTextStub: Record<PropertyKey, unknown>;

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

@@ -1,40 +0,0 @@
-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';
-/**
- * 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
- * language allows for a group to be described as more than one case, the intent
- * here is to establish exclusive naming which may or may not compound. As such:
- *
- * - `logical-group`, per spec language, is a group with a `ref`; its usage here
- *   differs from the spec language in that it _may_ have a `<label>` child but
- *   is not also treated as a `presentation-group` (which is only used for
- *   groups which do not have a `ref`)
- * - `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`
- * - `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
- *   do not apply
- *
- * A more succinct decision tree:
- *
- * - `<group ref="$ref">` -> `logical-group`, else
- * - `<group><label>` -> `presentation-group`, else
- * - `<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);
-}

package/dist/parse/body/group/LogicalGroupDefinition.d.ts

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

package/dist/parse/body/group/PresentationGroupDefinition.d.ts

@@ -1,11 +0,0 @@
-import { LabelDefinition } from '../../text/LabelDefinition.ts';
-import { XFormDefinition } from '../../XFormDefinition.ts';
-import { BodyElementParentContext } from '../BodyDefinition.ts';
-import { BaseGroupDefinition } from './BaseGroupDefinition.ts';
-export declare class PresentationGroupDefinition extends BaseGroupDefinition<'presentation-group'> {
-    static isCompatible(localName: string, element: Element): boolean;
-    readonly type = "presentation-group";
-    readonly label: LabelDefinition;
-    constructor(form: XFormDefinition, parent: BodyElementParentContext, element: Element);
-}
-export type PresentationGroupDefinitionClass = typeof PresentationGroupDefinition;

package/dist/parse/body/group/StructuralGroupDefinition.d.ts

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

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

@@ -1,21 +0,0 @@
-import { NamedNodeDefinition } from '../../lib/names/NamespaceDeclarationMap.ts';
-import { QualifiedName } from '../../lib/names/QualifiedName.ts';
-import { RootDefinition } from './RootDefinition.ts';
-interface RootAttributeSource {
-    readonly qualifiedName: QualifiedName;
-    readonly value: string;
-}
-/**
- * @todo This class is named and typed to emphasize its intentionally narrow
- * usage and purpose. It **intentionally** avoids addressing the much broader
- * set of concerns around modeling attributes in primary instance/submissions.
- */
-export declare class RootAttributeDefinition implements NamedNodeDefinition {
-    private readonly serializedXML;
-    readonly parent: RootDefinition;
-    readonly qualifiedName: QualifiedName;
-    readonly value: string;
-    constructor(root: RootDefinition, source: RootAttributeSource);
-    serializeAttributeXML(): string;
-}
-export {};

package/src/client/SubtreeNode.ts

@@ -1,61 +0,0 @@
-import type { SubtreeDefinition as BaseSubtreeDefinition } from '../parse/model/SubtreeDefinition.ts';
-import type { BaseNode, BaseNodeState } from './BaseNode.ts';
-import type { RootNode } from './RootNode.ts';
-import type { GeneralChildNode, GeneralParentNode } from './hierarchy.ts';
-import type { AncestorNodeValidationState } from './validation.ts';
-
-export interface SubtreeNodeState extends BaseNodeState {
-	get label(): null;
-	get hint(): null;
-	get children(): readonly GeneralChildNode[];
-	get valueOptions(): null;
-	get value(): null;
-}
-
-// TODO: obviously there is a naming inconsistency emerging here.
-export interface SubtreeDefinition extends BaseSubtreeDefinition {
-	readonly bodyElement: null;
-}
-
-/**
- * A non-root node which has children, but **no** corresponding XForms
- * `<group>`. A subtree node does not have any direct implications for
- * presentation to users, but its descendants may specify presentational details
- * in their own {@link BaseNode.definition | definition}s.
- *
- * @example
- *
- * A common `SubtreeNode` case will be a form's `<meta>` element:
- *
- * ```xml
- * <!-- /h:html/h:head/model -->
- * <instance>
- *   <data>
- *     <some-group>
- *       <some-field />
- *     </some-group>
- *     <!-- Note that `meta` does not have a corresponding group body element -->
- *     <!-- SubtreeNode(/data/meta): { ... -->
- *     <meta>
- *       <instanceID/>
- *     </meta>
- *     <!-- } -->
- *   </data>
- * </instance>
- * <!-- /h:html/h:body -->
- * <group ref="/data/some-group">
- *   <input ref="/data/some-group/some-field" />
- * </group>
- * ```
- */
-// TODO: directly test presentation of non-group subtree children/descendants
-export interface SubtreeNode extends BaseNode {
-	readonly nodeType: 'subtree';
-	readonly appearances: null;
-	readonly nodeOptions: null;
-	readonly definition: SubtreeDefinition;
-	readonly root: RootNode;
-	readonly parent: GeneralParentNode;
-	readonly currentState: SubtreeNodeState;
-	readonly validationState: AncestorNodeValidationState;
-}

package/src/error/TemplatedNodeAttributeSerializationError.ts

@@ -1,24 +0,0 @@
-/**
- * This error class is intended as a common point of reference for all of the
- * related interfaces and implementation where we've deferred two concerns:
- *
- * 1. Support for attributes on instance nodes (which may be bound in a form's
- *    model and/or may be expected to preserve model-defined defaults)
- * 2. Present lack of logic to treat a `jr:template` attribute as a special
- *    case: whereas in the general case we would expect to pass through a
- *    form/model-defined attribute, we expect to specifically **omit**
- *    `jr:template` from repeat instances derived from any of form's
- *    explicitly-defined repeat templates
- *
- * Addressing #1 is (now) a prerequisite to addressing #2, and it is also a
- * prerequisite for #2's unaddressed status to _become meaningfully observable
- * and problematic_.
- *
- * By introducing this error at a point where a change in #1's status is likely
- * to be implicated, we're also likely to be reminded to address #2 in tandem.
- */
-export class TemplatedNodeAttributeSerializationError extends Error {
-	constructor() {
-		super('Template attribute omission not implemented');
-	}
-}