@docupace/ihub-config 1.1.20-alpha.0 → 1.1.21-admin.0

package/dist/model/graphs/config/fields.graphql

@@ -11,6 +11,10 @@ interface IField {
   excludeFromQueryInput: Boolean
   visibilityCondition: String
   disabledCondition: String
+  """
+  Always include this field in the mutation input, even if it is hidden or has not been modified by the user.
+  """
+  skipDirtyCheck: Boolean
 }
 
 interface IDateRangeField {
@@ -28,8 +32,6 @@ interface IDateRangeField {
   excludeFromQueryInput: Boolean
   visibilityCondition: String
   disabledCondition: String
-  validation: GenericFieldValidation
-
 }
 
 type InputField implements IField & IRowElement & IElement {
@@ -54,7 +56,6 @@ type InputField implements IField & IRowElement & IElement {
   validation: InputValidation
   visibilityCondition: String
   disabledCondition: String
-  skipDirtyCheck: Boolean
   # Start of text area configuration, see https://mui.com/material-ui/react-text-field/#multiline
   multiline: Boolean  # optional if at least one other text area parameter is provided
   rows: Int
@@ -100,6 +101,36 @@ type ControlGroup implements IRowElement & IElement {
   fields: [Fields!]!
 }
 
+# Renders the currently-linked records of a multi-valued reference attribute
+# (`path`) as a table (`columns`, reusing Table's Column config), with a quick
+# typeahead (`search`, reusing Table's SimpleSearch/QuerySelectOptions config)
+# to find and add records of `dataType`, and a delete affordance per row.
+# `rowMenuItems` (reusing Table's MenuItem config) adds further per-row actions,
+# e.g. an `action: "details"` item with a `url` to navigate to that record's own
+# details page.
+type ReferenceTable implements IField & IRowElement & IElement {
+  cols: Int
+  defaultValue: String
+  disabledCondition: String
+  excludeFromQueryInput: Boolean
+  hidden: Boolean
+  label: String
+  name: String!
+  path: String!
+  readonly: Boolean
+  required: Boolean
+  requiredCondition: String
+  skipQuery: Boolean
+  visibilityCondition: String
+  dataType: String!
+  columns: [Column!]!
+  search: SimpleSearch
+  addLabel: String
+  confirmDelete: Boolean
+  maxRows: Int
+  rowMenuItems: [MenuItem!]
+}
+
 type PhoneField implements IField & IRowElement & IElement {
   cols: Int
   defaultValue: String
@@ -115,7 +146,7 @@ type PhoneField implements IField & IRowElement & IElement {
   excludeFromQueryInput: Boolean
   visibilityCondition: String
   disabledCondition: String
-  validation: GenericFieldValidation
+  validation: FieldValidation
 }
 
 type DateField implements IField & IRowElement & IElement {
@@ -134,7 +165,7 @@ type DateField implements IField & IRowElement & IElement {
   disabledCondition: String
   minDate: String # e.q. "now" or "2025-03-20"
   maxDate: String # e.q. "now" or "2025-03-20"
-  validation: GenericFieldValidation
+  validation: FieldValidation
 }
 
 type DateRangeField implements IDateRangeField & IRowElement & IElement {
@@ -153,7 +184,6 @@ type DateRangeField implements IDateRangeField & IRowElement & IElement {
   excludeFromQueryInput: Boolean
   visibilityCondition: String
   disabledCondition: String
-  validation: GenericFieldValidation
 }
 
 type SelectField implements IField & IRowElement & IElement {
@@ -178,7 +208,7 @@ type SelectField implements IField & IRowElement & IElement {
   excludeId: Boolean
   helperText: String
   autoSelectSingleOption: Boolean
-  validation: GenericFieldValidation
+  validation: FieldValidation
 }
 
 type ToggleField implements IField & IRowElement & IElement {
@@ -200,7 +230,7 @@ type ToggleField implements IField & IRowElement & IElement {
   visibilityCondition: String
   disabledCondition: String
   linkedFields: [String!]
-  validation: GenericFieldValidation
+  validation: FieldValidation
 }
 
 type BooleanField implements IField & IRowElement & IElement {
@@ -218,7 +248,7 @@ type BooleanField implements IField & IRowElement & IElement {
   visibilityCondition: String
   disabledCondition: String
   linkedFields: [String!]
-  validation: GenericFieldValidation
+  validation: FieldValidation
 }
 
 type ChipSelectWithInputField implements IField & IRowElement & IElement {
@@ -262,7 +292,7 @@ type CustomField implements IField & IRowElement & IElement {
   excludeFromQueryInput: Boolean
   visibilityCondition: String
   disabledCondition: String
-  validation: GenericFieldValidation
+  validation: FieldValidation
 }
 
 type StatusChipField implements IField & IRowElement & IElement {
@@ -271,7 +301,7 @@ type StatusChipField implements IField & IRowElement & IElement {
   label: String
   name: String!
   path: String!
-  validation: GenericFieldValidation
+  validation: FieldValidation
 }
 
 type CheckboxGroupValue {
@@ -299,19 +329,9 @@ enum FieldValueType {
   Float
 }
 
-type GenericFieldValidation {
-    custom : CustomFieldValidation
-}
-
-type CustomFieldValidation {
+type FieldValidation {
   expression: String
   message: String
-  """
-  Paths of other fields this expression reads. When one of these fields changes, this
-  field's validation is re-triggered so its error state stays in sync without requiring
-  the user to re-touch this field directly.
-  """
-  dependentPaths: [String!]
 }
 
 type StringValidationRule {
@@ -343,13 +363,11 @@ type InputValidation {
   format: [FormatValidationRule!]
   min: FloatValidationRule
   max: FloatValidationRule
-  custom: CustomFieldValidation
 }
 
 type ChipSelectValidation {
   compatibleWith: CompatibleWithRule
   uniqueInList: UniqueInListRule
-  custom : CustomFieldValidation
 }
 
 type CompatibleWithRule {

package/dist/model/graphs/config/menu.graphql

@@ -25,6 +25,12 @@ type MenuItem implements IMenuItem {
     visibilityCondition: String
     disabledCondition: String
     config: JSON
+    """
+    Child menu items. When present, this item acts as a collapsible group
+    header rather than a navigable leaf (consumers should treat a MenuItem
+    with `items` and no `url` as a group).
+    """
+    items: [MenuItem!]
 }
 
 type ActionButton implements IMenuItem {

package/dist/model/graphs/config/page.graphql

@@ -250,8 +250,15 @@ type Viewer {
 }
 
 type Breadcrumb {
-  label: String!
+  label: String
   path: String
   isLabelExpression: Boolean
   isPathExpression: Boolean
+  """
+  Dot-notation paths (e.g. "name", "folder.title") to try, in order, against
+  the already-fetched page record to compute the breadcrumb label. Used only
+  when `isLabelExpression` is not set. If none of the paths resolve to a
+  non-empty value, the client falls back to the record's `id`.
+  """
+  valuePaths: [String!]
 }

package/dist/model/graphs/config/rules.graphql

@@ -1,80 +1,104 @@
-
 type RuleGroup {
-    name: String
-    description: String
+  name: String
+  description: String
+
+  """Type to apply the role group to. For example IContact or BaseWorkItem"""
+  type: String
+  """Condition to define which rule groups will be applied. like for example custodian or registrationType"""
+  condition: String
+
+  """Priority defined when multiple rule groups are matched. Higher value wins."""
+  priority: Int
+  fieldRules: [IFieldRule!]!
+
+  """Custom validators that are not individual field rules (e.g. validation across multiple fields or collections)."""
+  validationRules: [ValidationRule!]
+}
+
+union ValidationRule = ArrayTotalRule
+
+type ArrayTotalRule {
+  name: String
+  message: String!
+
+  """Path to the collection whose elements should be validated."""
+  path: String!
+
+  """Field from each matching collection element to include in the sum."""
+  fieldToSum: String!
+
+  """Expected sum of the selected field values."""
+  expectedTotal: Int!
 
-    """Type to apply the role group to. For example IContact or BaseWorkItem"""
-    type: String
-    """Condition to define which rule groups will be applied. like for example custodian or registrationType"""
-    condition: String
+  """Optional condition used to select collection elements."""
+  filterCondition: String
 
-    """Priority defined when multiple rule groups are matched. Higher value wins."""
-    priority: Int
-    fieldRules: [IFieldRule!]!
+  """Determines whether empty data should be considered valid."""
+  emptyIsValid: Boolean
 }
 
 interface IFieldRule {
-    defaultValue: String
-    messageLabel: String
-    path: String!
-    readonly: Boolean
-    required: Boolean
-    requiredCondition: String
-    availabilityCondition: String # maps to visibilityCondition on UI
+  defaultValue: String
+  messageLabel: String
+  path: String!
+  readonly: Boolean
+  required: Boolean
+  requiredCondition: String
+  availabilityCondition: String # maps to visibilityCondition on UI
 }
 
 type ListFieldRule implements IFieldRule {
-    defaultValue: String
-    messageLabel: String
-    path: String!
-    readonly: Boolean
-    required: Boolean
-    requiredCondition: String
-    availabilityCondition: String # maps to visibilityCondition on UI
-    validationRules: [ValidationRule!]
-    validation: GenericFieldValidation
+  defaultValue: String
+  messageLabel: String
+  path: String!
+  readonly: Boolean
+  required: Boolean
+  requiredCondition: String
+  availabilityCondition: String # maps to visibilityCondition on UI
+  validationRules: [ListFieldValidationRule!]
+  validation: FieldValidation
 }
 
-type ValidationRule {
-    condition: String
-    errorMessage: String
+type ListFieldValidationRule {
+  condition: String
+  errorMessage: String
 }
 
 type StringFieldRule implements IFieldRule {
-    defaultValue: String
-    maxLength: Int
-    messageLabel: String
-    minLength: Int
-    path: String!
-    readonly: Boolean
-    required: Boolean
-    requiredCondition: String
-    type: FieldValueType
-    validation: InputValidation
-    availabilityCondition: String
+  defaultValue: String
+  maxLength: Int
+  messageLabel: String
+  minLength: Int
+  path: String!
+  readonly: Boolean
+  required: Boolean
+  requiredCondition: String
+  type: FieldValueType
+  validation: InputValidation
+  availabilityCondition: String
 }
 
 type BooleanFieldRule implements IFieldRule {
-    defaultValue: String
-    messageLabel: String
-    path: String!
-    readonly: Boolean
-    required: Boolean
-    requiredCondition: String
-    validation: InputValidation
-    availabilityCondition: String
+  defaultValue: String
+  messageLabel: String
+  path: String!
+  readonly: Boolean
+  required: Boolean
+  requiredCondition: String
+  validation: InputValidation
+  availabilityCondition: String
 }
 
 
 type DateFieldRule implements IFieldRule {
-    defaultValue: String
-    messageLabel: String
-    path: String!
-    readonly: Boolean
-    required: Boolean
-    requiredCondition: String
-    availabilityCondition: String # maps to visibilityCondition on UI
-    minDate: String # e.q. "now" or "2025-03-20"
-    maxDate: String # e.q. "now" or "2025-03-20"
-    validation: GenericFieldValidation
+  defaultValue: String
+  messageLabel: String
+  path: String!
+  readonly: Boolean
+  required: Boolean
+  requiredCondition: String
+  availabilityCondition: String # maps to visibilityCondition on UI
+  minDate: String # e.q. "now" or "2025-03-20"
+  maxDate: String # e.q. "now" or "2025-03-20"
+  validation: FieldValidation
 }

package/dist/model/graphs/config/selectOptions.graphql

@@ -9,6 +9,7 @@ type SelectOptionsFilter {
 type QuerySelectOptions implements ISelectOptions {
     type: String
     labelProp: String # defaults to "name" in ui
+    labelExpression: String # JS expression evaluated against each option (e.g. "`${option.name} (${option.internalId})`"); takes precedence over labelProp when set
     valueProp: String # defaults to "id" in ui
     queryName: String!
     variableDefinitions: JSON

package/dist/model/graphs/config/table.graphql

@@ -34,6 +34,7 @@ interface ITable  {
     expandable: Expandable
     totals: [TotalsItem!]
     config: JSON
+    globalName: String
 }
 
 type TotalsItem {
@@ -71,6 +72,8 @@ enum TablePinnedPosition {
 
 type Toolbar {
   columns: ToolbarColumns
+  configureColumns: ToolbarColumns
+  configureFilters: ToolbarColumns
 }
 
 type ToolbarColumns {