@docupace/ihub-config 1.1.25 → 1.1.26-sync.0

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

@@ -27,4 +27,11 @@ type PanelRow implements IPanelRow {
     title: String
     titleVariant: String
     visibilityCondition: String
+    """
+    Screen Designer: true when this group exists only via the screen layout patch — no
+    counterpart in the raw base config — vs. `false`/absent for a real group (whether or
+    not the patch also overrides some of its properties). See `Tab.custom` for the full
+    reasoning; stamped the same way, one level down the tree.
+    """
+    custom: Boolean
 }

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

@@ -1,6 +1,14 @@
 
 type PageQuery {
-    getPageConfig(path: String, context: JSON): Page
+    """
+    impersonateRoleId / impersonateGeneral: preview this page's config as
+    someone else would see it — either a specific role (impersonateRoleId)
+    or the site default with no role/personal override at all
+    (impersonateGeneral) — restricted to admins by the host's identity
+    resolution (see docupace-graphql-server's resolveCurrentIdentity), which
+    throws for a non-admin caller.
+    """
+    getPageConfig(path: String, context: JSON, impersonateRoleId: ID, impersonateGeneral: Boolean): Page
     getAIConfig(path: String, context: JSON): JSON
 }
 

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,19 @@ interface ITable  {
     expandable: Expandable
     totals: [TotalsItem!]
     config: JSON
+    configPath: String
+    configurableAttributes: [ConfigurableAttribute!]
+    """Admin-defined columns not present in this table's own base `columns`, available to add via the Configure Columns dialog. Site/tenant-scoped catalog — see `$.predefinedColumns` under `configurableAttributes`."""
+    predefinedColumns: [Column!]
+    """Admin-defined filter criteria not present in this table's own base `filter.criteria`, available to add via the Configure Filters dialog. Site/tenant-scoped catalog — see `$.predefinedFilters` under `configurableAttributes`."""
+    predefinedFilters: [TableCriteria!]
+}
+
+"""One overridable sub-element of a config object identified by `configPath` — see the parent's own `configPath` field for how the two combine (`${configPath}#${configSubPath}`)."""
+type ConfigurableAttribute {
+  name: String!         # e.g. "columns", "filter" — matches the field name on the parent type
+  configPath: String!   # copy of the parent object's own configPath, for convenience
+  configSubPath: String! # JSONPath relative to the parent object, e.g. "$.columns"
 }
 
 type TotalsItem {
@@ -91,6 +104,8 @@ enum TablePinnedPosition {
 
 type Toolbar {
   columns: ToolbarColumns
+  configureColumns: ToolbarColumns
+  configureFilters: ToolbarColumns
 }
 
 type ToolbarColumns {
@@ -157,6 +172,11 @@ type TableCriteria {
     selectOptions: ISelectOptions
     min: Float
     max: Float
+    visible: Boolean
+    """Set when this criterion was added by `$ref`-referencing a predefined/base criterion (e.g. `"#$.predefinedFilters[?(@.name=='status')]"`) rather than being copied inline — see the config-path override merge in `config-service.ts`. Clients that re-save this criterion unchanged should keep sending the same `$ref` (as this value) rather than flattening it into a full copy."""
+    ref: String
+    """True when this criterion would still show up — present by name *and* not hidden — without the current scope's own override, i.e. from a broader layer (a role/site override, or the table's own base template `filter.criteria`). Drives two things in the Configure Filters editor. Hide-vs-delete: "remove" must hide (`visible: false`) an inherited criterion, since deleting it from the override would just have it reappear from the broader layer on the next read, while a non-inherited one can be deleted outright. And pin-on-add: re-adding a *non*-inherited criterion must write an explicit `visible: true`, or the broader layer's `visible: false` is inherited per-attribute by the name-keyed merge and the criterion stays invisible however it's re-added. Computed fresh on every read in `config-service.ts`'s `applyConfigPathOverride` against the layers below the identity's own scope tier (`ConfigurationOverrideResult.inheritedSubPaths`), never persisted."""
+    inherited: Boolean
 }
 
 enum TableFilterVariant {
@@ -170,12 +190,18 @@ type Column {
     visible: Boolean
     paths: [String!]
     expression: String
+    """Which predefined formatter (if any) generated `expression` — e.g. `"commaList"`, `"custom"` — see `EXPRESSION_FORMATTERS`/`CUSTOM_FORMATTER_ID` in docupace-ui-main's `expressionGeneration.ts`. Absent for the raw/no-formatting default, which stores neither this nor `expression` at all. Without this field, a column's `expression` round-trips but the formatter that produced it doesn't, so the Configure Columns editor can't tell "built from a known formatter" apart from "hand-authored custom script" on reload and always falls back to showing the latter."""
+    formatterName: String
     component: String
     sortable: Boolean
     flex: Float
     pinned: TablePinnedPosition
     config: JSON
     filter: ColumnFilter
+    """Set when this column was added by `$ref`-referencing a predefined/base column (e.g. `"#$.predefinedColumns[?(@.name=='email')]"`) rather than being copied inline — see the config-path override merge in `config-service.ts`. Clients that re-save this column unchanged should keep sending the same `$ref` (as this value) rather than flattening it into a full copy."""
+    ref: String
+    """True when this column would still show up — present by name *and* not hidden — without the current scope's own override, i.e. from a broader layer (a role/site override, or the table's own base template `columns`). Drives hide-vs-delete and pin-on-add in the Configure Columns editor — see `TableCriteria.inherited`'s doc comment for the full reasoning, identical here."""
+    inherited: Boolean
 }
 
 type ColumnFilter {

package/dist/model/graphs/config/ui-components.graphql

@@ -8,4 +8,5 @@ type TextElement implements IRowElement & IElement {
     valueExpression: String
     variant: String
     visibilityCondition: String
+    custom: Boolean
 }

package/dist/providers/index.d.ts

@@ -1,4 +1,8 @@
 import { ConfigProviders } from './base-config.js';
+import type { WholePatchMergers } from './whole-patch.js';
 export declare const builtInProviders: ConfigProviders;
+export declare const builtInWholePatchMergers: WholePatchMergers;
 export type { ConfigProviders } from './base-config.js';
+export type { WholePatchMerger, WholePatchMergers } from './whole-patch.js';
+export { SCREEN_LAYOUT_PATCH_CONTENT_TYPE } from './screen-layout-patch.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGnD,eAAO,MAAM,gBAAgB,EAAE,eAE9B,CAAC;AAEF,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAMnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,eAAO,MAAM,gBAAgB,EAAE,eAE9B,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,iBAEtC,CAAC;AAEF,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,gCAAgC,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/providers/index.js

@@ -1,5 +1,10 @@
 import { DashboardPageConfigProvider } from './dashboard-page-config.js';
+import { ScreenLayoutPatchMerger, SCREEN_LAYOUT_PATCH_CONTENT_TYPE, } from './screen-layout-patch.js';
 export const builtInProviders = {
     DashboardPage: DashboardPageConfigProvider,
 };
+export const builtInWholePatchMergers = {
+    [SCREEN_LAYOUT_PATCH_CONTENT_TYPE]: new ScreenLayoutPatchMerger(),
+};
+export { SCREEN_LAYOUT_PATCH_CONTENT_TYPE } from './screen-layout-patch.js';
 //# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAEzE,MAAM,CAAC,MAAM,gBAAgB,GAAoB;IAC/C,aAAa,EAAE,2BAA2B;CAC3C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EACL,uBAAuB,EACvB,gCAAgC,GACjC,MAAM,0BAA0B,CAAC;AAGlC,MAAM,CAAC,MAAM,gBAAgB,GAAoB;IAC/C,aAAa,EAAE,2BAA2B;CAC3C,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAsB;IACzD,CAAC,gCAAgC,CAAC,EAAE,IAAI,uBAAuB,EAAE;CAClE,CAAC;AAIF,OAAO,EAAE,gCAAgC,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/providers/screen-layout-patch.d.ts

@@ -0,0 +1,6 @@
+import type { WholePatchMerger } from './whole-patch.js';
+export declare const SCREEN_LAYOUT_PATCH_CONTENT_TYPE = "application/x-screen-layout-patch+json";
+export declare class ScreenLayoutPatchMerger implements WholePatchMerger {
+    merge(processedObj: any, patch: any): any;
+}
+//# sourceMappingURL=screen-layout-patch.d.ts.map

package/dist/providers/screen-layout-patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-layout-patch.d.ts","sourceRoot":"","sources":["../../src/providers/screen-layout-patch.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAKzD,eAAO,MAAM,gCAAgC,2CACH,CAAC;AAW3C,qBAAa,uBAAwB,YAAW,gBAAgB;IAC9D,KAAK,CAAC,YAAY,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,GAAG,GAAG;CA4D1C"}

package/dist/providers/screen-layout-patch.js

@@ -0,0 +1,57 @@
+import { mergeMatchedFields, } from '../lib/named-array-merge.js';
+// `Configuration.value` is typed CLOB, but the underlying attribute is JSON — for a
+// JSON-shaped value like a screen layout patch, it can come back already parsed as an
+// object rather than as the JSON string it was saved as.
+export const SCREEN_LAYOUT_PATCH_CONTENT_TYPE = 'application/x-screen-layout-patch+json';
+// A Screen Designer override entry counts as "self-contained" when it carries a
+// `__typename` — every full tab/row/element node the client builds for a brand-new,
+// not-yet-in-the-base-config entry always does (see `AddElementDialog.buildDefaultNode`
+// and the client's new-tab/new-row construction), while a thin `{ name, ...diffs }`
+// reference to an existing base node never does.
+function isSelfContainedScreenLayoutNode(item) {
+    return typeof item.__typename === 'string' && item.__typename.length > 0;
+}
+export class ScreenLayoutPatchMerger {
+    merge(processedObj, patch) {
+        // A screen layout patch is always tabs-shaped (`{ tabs: [...] }`), but the config
+        // path it's saved against doesn't have to resolve to a bare `TabbedPage` — a modal
+        // config like `modals/select-account-holder` resolves to an `AnyPage` that wraps
+        // the real `TabbedPage` via `tabbedPages[0]` (a `$ref`, in that case). Detect that
+        // shape and merge onto the nested TabbedPage instead, so the patch lands on
+        // `tabbedPages[0].tabs` rather than a same-named `tabs` field bolted onto the
+        // AnyPage root (which `mergeMatchedFields` would otherwise do silently, since
+        // `tabbedPages` itself doesn't qualify as a named-object array to recurse into —
+        // `TabbedPage` has no `name` field).
+        if (!processedObj?.tabs && Array.isArray(processedObj?.tabbedPages)) {
+            const [tabbedPage, ...restTabbedPages] = processedObj.tabbedPages;
+            return {
+                ...processedObj,
+                tabbedPages: [
+                    mergeMatchedFields(tabbedPage, patch, isSelfContainedScreenLayoutNode, true),
+                    ...restTabbedPages,
+                ],
+            };
+        }
+        // A `WizardPage` (e.g. `contacts/add-new-contact`) has no `tabs`/`tabbedPages` of
+        // its own — its `TabbedPage`(s) live nested one level down, at `steps[].page`. A
+        // wizard can carry more than one `TabbedPage` step (add-new-contact has both
+        // `enterContactInformation` and `reviewContactInformation`, mutually exclusive by
+        // `visibilityCondition` but $ref-ing the identical tabs) — apply the same patch to
+        // every step whose `page.tabs` exists, so whichever step is actually visible at
+        // runtime reflects the edit, and leave every other step (ComponentPage, etc.)
+        // untouched.
+        if (!processedObj?.tabbedPages && Array.isArray(processedObj?.steps)) {
+            return {
+                ...processedObj,
+                steps: processedObj.steps.map((step) => step?.page?.tabs
+                    ? {
+                        ...step,
+                        page: mergeMatchedFields(step.page, patch, isSelfContainedScreenLayoutNode, true),
+                    }
+                    : step),
+            };
+        }
+        return mergeMatchedFields(processedObj, patch, isSelfContainedScreenLayoutNode, true);
+    }
+}
+//# sourceMappingURL=screen-layout-patch.js.map

package/dist/providers/screen-layout-patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-layout-patch.js","sourceRoot":"","sources":["../../src/providers/screen-layout-patch.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,GAEnB,MAAM,6BAA6B,CAAC;AAGrC,oFAAoF;AACpF,sFAAsF;AACtF,yDAAyD;AACzD,MAAM,CAAC,MAAM,gCAAgC,GAC3C,wCAAwC,CAAC;AAE3C,gFAAgF;AAChF,oFAAoF;AACpF,wFAAwF;AACxF,oFAAoF;AACpF,iDAAiD;AACjD,SAAS,+BAA+B,CAAC,IAAiB;IACxD,OAAO,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,OAAO,uBAAuB;IAClC,KAAK,CAAC,YAAiB,EAAE,KAAU;QACjC,kFAAkF;QAClF,mFAAmF;QACnF,iFAAiF;QACjF,mFAAmF;QACnF,4EAA4E;QAC5E,8EAA8E;QAC9E,8EAA8E;QAC9E,iFAAiF;QACjF,qCAAqC;QACrC,IAAI,CAAC,YAAY,EAAE,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,WAAW,CAAC,EAAE,CAAC;YACpE,MAAM,CAAC,UAAU,EAAE,GAAG,eAAe,CAAC,GAAG,YAAY,CAAC,WAAW,CAAC;YAClE,OAAO;gBACL,GAAG,YAAY;gBACf,WAAW,EAAE;oBACX,kBAAkB,CAChB,UAAU,EACV,KAAK,EACL,+BAA+B,EAC/B,IAAI,CACL;oBACD,GAAG,eAAe;iBACnB;aACF,CAAC;QACJ,CAAC;QAED,kFAAkF;QAClF,iFAAiF;QACjF,6EAA6E;QAC7E,kFAAkF;QAClF,mFAAmF;QACnF,gFAAgF;QAChF,8EAA8E;QAC9E,aAAa;QACb,IAAI,CAAC,YAAY,EAAE,WAAW,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC;YACrE,OAAO;gBACL,GAAG,YAAY;gBACf,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE,CAC1C,IAAI,EAAE,IAAI,EAAE,IAAI;oBACd,CAAC,CAAC;wBACE,GAAG,IAAI;wBACP,IAAI,EAAE,kBAAkB,CACtB,IAAI,CAAC,IAAI,EACT,KAAK,EACL,+BAA+B,EAC/B,IAAI,CACL;qBACF;oBACH,CAAC,CAAC,IAAI,CACT;aACF,CAAC;QACJ,CAAC;QAED,OAAO,kBAAkB,CACvB,YAAY,EACZ,KAAK,EACL,+BAA+B,EAC/B,IAAI,CACL,CAAC;IACJ,CAAC;CACF"}

package/dist/providers/whole-patch.d.ts

@@ -0,0 +1,6 @@
+export interface WholePatchMerger {
+    /** Merges a parsed whole-patch document onto the fully processed config. */
+    merge(processedObj: any, patch: any): any;
+}
+export type WholePatchMergers = Record<string, WholePatchMerger>;
+//# sourceMappingURL=whole-patch.d.ts.map

package/dist/providers/whole-patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whole-patch.d.ts","sourceRoot":"","sources":["../../src/providers/whole-patch.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,KAAK,CAAC,YAAY,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,GAAG,GAAG,CAAC;CAC3C;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC"}

package/dist/providers/whole-patch.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=whole-patch.js.map

package/dist/providers/whole-patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whole-patch.js","sourceRoot":"","sources":["../../src/providers/whole-patch.ts"],"names":[],"mappings":""}

package/dist/types/graphql.d.ts

@@ -174,8 +174,9 @@ export type Breadcrumb = {
     __typename?: 'Breadcrumb';
     isLabelExpression?: Maybe<Scalars['Boolean']['output']>;
     isPathExpression?: Maybe<Scalars['Boolean']['output']>;
-    label: Scalars['String']['output'];
+    label?: Maybe<Scalars['String']['output']>;
     path?: Maybe<Scalars['String']['output']>;
+    valuePaths?: Maybe<Array<Scalars['String']['output']>>;
 };
 export type Card = ICard & IElement & IRowElement & {
     __typename?: 'Card';
@@ -1974,8 +1975,9 @@ export type BooleanFieldRuleResolvers<ContextType = any, ParentType extends Reso
 export type BreadcrumbResolvers<ContextType = any, ParentType extends ResolversParentTypes['Breadcrumb'] = ResolversParentTypes['Breadcrumb']> = {
     isLabelExpression?: Resolver<Maybe<ResolversTypes['Boolean']>, ParentType, ContextType>;
     isPathExpression?: Resolver<Maybe<ResolversTypes['Boolean']>, ParentType, ContextType>;
-    label?: Resolver<ResolversTypes['String'], ParentType, ContextType>;
+    label?: Resolver<Maybe<ResolversTypes['String']>, ParentType, ContextType>;
     path?: Resolver<Maybe<ResolversTypes['String']>, ParentType, ContextType>;
+    valuePaths?: Resolver<Maybe<Array<ResolversTypes['String']>>, ParentType, ContextType>;
     __isTypeOf?: IsTypeOfResolverFn<ParentType, ContextType>;
 };
 export type CardResolvers<ContextType = any, ParentType extends ResolversParentTypes['Card'] = ResolversParentTypes['Card']> = {