NodeProjection

Properties

active

active: boolean

Whether JSON Schema evaluation says this node applies to the data as it stands. Nothing else: it is an assertion about the schema, not about what a form should show.

---

annotations

annotations: AnnotationSet

---

boundaries?

optional boundaries?: readonly ProjectionBoundary[]

---

boundaryTargets?

optional boundaryTargets?: readonly ProjectionBoundaryTarget[]

Individual withheld locations that may be explicitly revealed in the view.

---

children?

optional children?: ChildProjection[]

---

constraints

constraints: FieldConstraints

---

defaultConflict?

optional defaultConflict?: readonly string[]

Schema positions whose default declarations apply to this node for the instance as it stands, and disagree. Present exactly where AnnotationSet.default was omitted for that reason, and absent otherwise.

This is the per-instance half of what ambiguous-default reports. SchemaProjection.diagnostics describes the schema, so it carries only the disagreements that hold whatever the instance is: a location’s own declaration against those reached through allOf and $ref. A declaration carried by oneOf, anyOf, if/then/else or dependentSchemas competes only while its branch applies, so whether it disagrees is a state of the data and belongs here, beside active and provisional, which flap with the data for the same reason.

Every conflict appears here, conditional or not, so a consumer deciding what to do about a location reads one place. The diagnostic stays for the unconditional case because a contradiction that holds for every instance is worth reporting to whoever wrote the schema.

A provisionally selected branch’s declarations compete, though JSON Schema says the branch does not apply. The projection exposes that branch so the user can complete it and a policy may fill from it, so a disagreement has to be visible wherever the fill would happen. Applicability here is therefore exposure, matching active || provisional, rather than validity.

Order is not a contract; the set is.

---

defaultSources?

optional defaultSources?: readonly string[]

The schema positions that supplied annotations.default, when this node applies a position on a cycle.

---

enumValues?

optional enumValues?: EnumOption[]

---

format?

optional format?: string

---

itemAnnotations?

optional itemAnnotations?: AnnotationSet

Annotations of an array’s item template, for arrays only.

A row’s own node carries these once it exists, but a renderer needs them before that: an empty array still has an add control to name, and that is where naming it matters most. Optional, so an adapter that cannot supply them stays valid.

---

provisional?

optional provisional?: boolean

Whether the form exposes this node so the user can complete it, when active is false.

These are two facts rather than three states, and they are allowed to disagree because that disagreement is the point. A oneOf branch the data uniquely identifies but has not yet satisfied does not apply, so active is false, and hiding it would leave the user no way to supply the property that would make it apply. provisional says the projection has selected that branch for the user to finish.

Only meaningful while active is false, and absent means false, so an adapter that does not select provisionally keeps its current behaviour.

---

recursiveExpansion?

optional recursiveExpansion?: boolean

Reached only by expanding recursion past the data, so a policy must not write here (ADR-007).

---

type

type: JsonSchemaType

The shape a renderer should present, which is not an assertion about the instance’s JSON Schema type.

For a schema declaring type, the two coincide. For one that does not, an adapter may still derive a shape from the schema’s structural keywords, and doing so changes nothing about validation: { properties: {...} } projects as an object and continues to accept a string, because the object keywords are inapplicable to one.