Skip to content

Start here

Review Queue

Review proposals against captured sources, record decisions, and retain their history.

Review proposals against captured sources, record decisions, and retain their history.

Add it to an app

  1. Open the app builder and find Review Queue in the component palette.
  2. Insert it into the intended region or container.
  3. Set its properties in the inspector. Use a literal for a fixed value or a binding for a value supplied by the app.
  4. Connect its events where the app should respond to a user gesture.
  5. Preview with representative data and save after resolving validation problems.

The type name in the builder’s code view is review_queue.

Settings

SettingAccepted valueRequiredDefaultWhat it controls
Submit button label (createLabel)stringNoNot specified—
Selected supporting language (evidenceSelection)object or nullNoNot specifiedSupports expression bindings. A source review ID, exact revision and citation list selected by an App. Unavailable evidence remains a review issue.
Review plugin (extension)stringNoNot specifiedThe enabled review extension that defines the operation.
Editable proposal fields (fields)list of objectNoNot specified—
label (fields[].label)stringYesNot specified—
path (fields[].path)stringYesNot specified—
type (fields[].type)"text" / "boolean" / "date"NoNot specifiedExpected value type. Values must meet this type before they are usable as typed data.
Generation workflow source (generationSourceId)stringNoNot specified—
Proposal kind (kind)stringNo"document-change"The listed default is inserted when adding a new component.
Proposed values (proposal)object or nullNoNot specifiedSupports expression bindings.
Source document keys (sourceKeys)list of stringNoNot specifiedSupports expression bindings.
Document role choices (sourceRoles)list of objectNoNot specifiedRequire an explicit role for each captured document before generation. Passed to the admitted review plugin as options.source_roles keyed by immutable content hash; role validation belongs to the plugin.
label (sourceRoles[].label)stringYesNot specified—
maxCount (sourceRoles[].maxCount)integer; minimum 0NoNot specifiedMaximum captured documents assigned this role before generation.
minCount (sourceRoles[].minCount)integer; minimum 0NoNot specifiedMinimum captured documents assigned this role before generation.
value (sourceRoles[].value)stringYesNot specified—
Title (title)stringNo"Review queue"The listed default is inserted when adding a new component.

Values available to bindings

ValueTypeInitial valueMeaning
generationobject or nullnullLast loaded saved generation receipt; retained across proposal selection, cleared when its source changes or a new generation starts.
projectionobject or nullnullLatest reviewed state.
reviewobject or nullnullThe exact loaded review revision and payload; cleared while another review loads.
reviewIdstring or nullnullThe opened review.
revisioninteger or nullnullThe loaded revision.
statusstring or nullnullThe loaded decision state.

Refer to these values through components.<component-id>.<value> in a binding. Use the identifier assigned to this instance of Review Queue, not the component type name.

Events

  • onChange — A review operation has committed.

  • onContextChange — The selected review or dated projection context changed. Clear dependent App selections.

Connect only the actions the app needs. An event can fetch results, run an enabled data source, set state, update another component, show a notification, or navigate where supported.

Keyboard and accessible labels

Accessible label source: Named by title.

Example: Review proposed terms

SettingExample value
fields[{"label":"Threshold","path":"term.threshold"}]

If it is empty or unavailable

Check the source binding, the selected item, and the app’s access. A hosted document, table, review, or storage component needs the corresponding app capability; an offline preview cannot supply live private data. A source running with no results is different from an invalid binding. Inspect the app’s workflow and data source before changing the presentation.