@docupace/ihub-config 1.1.26 → 1.1.27

package/dist/lib/named-array-merge.d.ts

@@ -0,0 +1,29 @@
+export type NamedObject = Record<string, unknown> & {
+    name: string;
+};
+export declare function isNamedObjectArray(value: unknown): value is NamedObject[];
+export declare function mergeMatchedFields<T extends Record<string, unknown>>(base: T, override: T, isSelfContained: (item: NamedObject) => boolean, stampCustom?: boolean): T;
+/**
+ * Folds `override` onto `base`, both arrays of named objects: matched-by-name pairs
+ * merge (recursively — see `mergeMatchedFields`), an override entry with no base match
+ * is kept when `isSelfContained` says it stands on its own and dropped otherwise, and
+ * any base entry the override never mentions is appended, unchanged, after the merged
+ * entries (in their original relative order). Final order is exactly the order
+ * produced above — override order first, then untouched base leftovers.
+ *
+ * `stampCustom`, when true, additionally marks every entry this call produces with
+ * `custom: boolean` — `true` for a self-contained override entry with no base
+ * counterpart (an insertion, stamped all the way through its own nested named-object
+ * arrays via `deepStampCustom`, since the whole subtree is equally new), `false` for a
+ * matched pair or an untouched base entry (present in the base config, whether or not
+ * this override touches its own attributes). This is Screen Designer's whole-object-patch
+ * equivalent of `Column.inherited`/`TableCriteria.inherited`, computed in one pass here
+ * rather than `ConfigService`'s separate `stampInherited` fold — that fold exists to
+ * answer "would this survive without *this identity's own scope tier*" across several
+ * cascaded layers, a question that doesn't arise for a single whole-object patch with no
+ * tiers: the one merge pass already knows, per item, whether a base counterpart exists.
+ * `false` (the default) leaves `Table.columns`/`filter.criteria` — the other caller of
+ * this function — completely unaffected.
+ */
+export declare function mergeNamedObjectArray(base: NamedObject[], override: NamedObject[], isSelfContained: (item: NamedObject) => boolean, stampCustom?: boolean): NamedObject[];
+//# sourceMappingURL=named-array-merge.d.ts.map

package/dist/lib/named-array-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"named-array-merge.d.ts","sourceRoot":"","sources":["../../src/lib/named-array-merge.ts"],"names":[],"mappings":"AA+BA,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,EAAE,CAUzE;AA+DD,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,EACX,eAAe,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,OAAO,EAC/C,WAAW,UAAQ,GAClB,CAAC,CAsBH;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,WAAW,EAAE,EACnB,QAAQ,EAAE,WAAW,EAAE,EACvB,eAAe,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,OAAO,EAC/C,WAAW,UAAQ,GAClB,WAAW,EAAE,CAuCf"}

package/dist/lib/named-array-merge.js

@@ -0,0 +1,158 @@
+// Generic merge semantics for a config-path override against the base value it
+// overrides. Originally built only for `Table.columns`/`filter.criteria` (flat arrays),
+// generalized here so a nested tree of named-object arrays (e.g. Screen Designer's
+// tabs → rows → elements) resolves through the exact same algorithm — see
+// `ConfigService`'s `mergeSubPathOverrideValue` (subPath overrides) and
+// `WholePatchMerger` implementations such as `ScreenLayoutPatchMerger` (whole-object
+// patch overrides), the current callers of `mergeMatchedFields`/`mergeNamedObjectArray`
+// respectively.
+//
+// When both the current value and the override value are arrays of objects each
+// carrying a string `name`, override elements are merged onto their base counterpart by
+// name (override wins per-attribute, everything else inherited) instead of the override
+// replacing the array wholesale. This is what makes a saved override non-destructive:
+// - Reordering falls out of the override array's own element order.
+// - "Hiding" an element is an attribute override (e.g. `visible: false`) on an element
+//   that's still present, not a deletion.
+// - A base element the override never mentions is appended unchanged, so a base
+//   element added later still surfaces for someone with an existing override, instead
+//   of being permanently absent from their frozen array.
+// - An override element naming something not found in the base is kept as-is when the
+//   caller's `isSelfContained` predicate says it carries enough of its own definition
+//   to stand alone (e.g. a hand-authored column, or a brand-new Screen Designer node),
+//   or silently dropped when it's a thin reference whose target no longer exists — this
+//   never throws; the stale reference just doesn't round-trip into the next save.
+//
+// A matched pair is merged field-by-field, recursing into any nested named-object array
+// or plain-object wrapper found on both sides (see `mergeMatchedFields`) — needed for a
+// nested tree like Screen Designer's `Tab.page.panel.rows`/`PanelRow.elements`, and a
+// no-op for a flat shape like `Column`/`TableCriteria`, which have no such nested field
+// to recurse into.
+export function isNamedObjectArray(value) {
+    return (Array.isArray(value) &&
+        value.every((item) => item !== null &&
+            typeof item === 'object' &&
+            typeof item.name === 'string'));
+}
+function isPlainObject(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+// Recursively stamps `custom` onto `item` and every named-object-array descendant it
+// carries (e.g. a freshly-inserted row's own freshly-inserted elements) — used only for
+// a self-contained override item with no base counterpart at all, where the whole
+// subtree is equally new and none of it can be found by a further name lookup. Plain
+// object wrappers (e.g. `Tab.page`) are walked through but never stamped themselves —
+// only actual named-object-array entries (tabs/rows/elements) carry `custom`.
+function deepStampCustom(item, custom) {
+    const stamped = { ...item, custom };
+    for (const key of Object.keys(item)) {
+        const value = item[key];
+        if (isNamedObjectArray(value)) {
+            stamped[key] = value.map((child) => deepStampCustom(child, custom));
+        }
+        else if (isPlainObject(value)) {
+            stamped[key] = deepStampCustomInPlainObject(value, custom);
+        }
+    }
+    return stamped;
+}
+function deepStampCustomInPlainObject(obj, custom) {
+    const result = { ...obj };
+    for (const key of Object.keys(obj)) {
+        const value = obj[key];
+        if (isNamedObjectArray(value)) {
+            result[key] = value.map((child) => deepStampCustom(child, custom));
+        }
+        else if (isPlainObject(value)) {
+            result[key] = deepStampCustomInPlainObject(value, custom);
+        }
+    }
+    return result;
+}
+// Merges a matched base/override pair field-by-field: override wins per-attribute
+// (the base spread first, then the override spread over it), except that a field
+// present as a named-object array or plain object on *both* sides recurses instead of
+// the override's value flatly overwriting the base's whole subtree — otherwise a
+// row's `elements` (or a tab's `page`) would be silently replaced/truncated by
+// whatever the override happens to carry for that field, rather than merged the same
+// name-keyed way as the top level.
+//
+// Exported (not just used internally by mergeNamedObjectArray) so a whole-object patch
+// override — one that doesn't come pre-split by JSONPath the way subPath overrides do —
+// can be folded onto a fully resolved config the same generic way, field by field,
+// instead of a caller having to know which top-level field(s) the patch touches. See
+// `WholePatchMerger` in `providers/whole-patch.ts`.
+//
+// `stampCustom` (off by default, so the existing `Table.columns`/`filter.criteria`
+// sub-path merge is unaffected) tells `mergeNamedObjectArray` to also stamp each
+// named-object-array entry it produces with `custom: boolean` — see that function's own
+// doc comment for what it means and why it's computed here rather than the multi-tier
+// way `ConfigService`'s own `inherited` is (`stampInherited`).
+export function mergeMatchedFields(base, override, isSelfContained, stampCustom = false) {
+    const merged = { ...base, ...override };
+    for (const key of Object.keys(override)) {
+        const baseValue = base[key];
+        const overrideValue = override[key];
+        if (isNamedObjectArray(baseValue) && isNamedObjectArray(overrideValue)) {
+            merged[key] = mergeNamedObjectArray(baseValue, overrideValue, isSelfContained, stampCustom);
+        }
+        else if (isPlainObject(baseValue) && isPlainObject(overrideValue)) {
+            merged[key] = mergeMatchedFields(baseValue, overrideValue, isSelfContained, stampCustom);
+        }
+    }
+    return merged;
+}
+/**
+ * Folds `override` onto `base`, both arrays of named objects: matched-by-name pairs
+ * merge (recursively — see `mergeMatchedFields`), an override entry with no base match
+ * is kept when `isSelfContained` says it stands on its own and dropped otherwise, and
+ * any base entry the override never mentions is appended, unchanged, after the merged
+ * entries (in their original relative order). Final order is exactly the order
+ * produced above — override order first, then untouched base leftovers.
+ *
+ * `stampCustom`, when true, additionally marks every entry this call produces with
+ * `custom: boolean` — `true` for a self-contained override entry with no base
+ * counterpart (an insertion, stamped all the way through its own nested named-object
+ * arrays via `deepStampCustom`, since the whole subtree is equally new), `false` for a
+ * matched pair or an untouched base entry (present in the base config, whether or not
+ * this override touches its own attributes). This is Screen Designer's whole-object-patch
+ * equivalent of `Column.inherited`/`TableCriteria.inherited`, computed in one pass here
+ * rather than `ConfigService`'s separate `stampInherited` fold — that fold exists to
+ * answer "would this survive without *this identity's own scope tier*" across several
+ * cascaded layers, a question that doesn't arise for a single whole-object patch with no
+ * tiers: the one merge pass already knows, per item, whether a base counterpart exists.
+ * `false` (the default) leaves `Table.columns`/`filter.criteria` — the other caller of
+ * this function — completely unaffected.
+ */
+export function mergeNamedObjectArray(base, override, isSelfContained, stampCustom = false) {
+    const baseByName = new Map(base.map((item) => [item.name, item]));
+    const merged = [];
+    const seenNames = new Set();
+    for (const overrideItem of override) {
+        // Guard against a corrupted/hand-edited override array carrying two elements with
+        // the same name — only the first is kept, so the merged result never has
+        // duplicate names.
+        if (seenNames.has(overrideItem.name)) {
+            continue;
+        }
+        seenNames.add(overrideItem.name);
+        const baseItem = baseByName.get(overrideItem.name);
+        if (baseItem) {
+            const mergedItem = mergeMatchedFields(baseItem, overrideItem, isSelfContained, stampCustom);
+            merged.push(stampCustom ? { ...mergedItem, custom: false } : mergedItem);
+        }
+        else if (isSelfContained(overrideItem)) {
+            merged.push(stampCustom ? deepStampCustom(overrideItem, true) : overrideItem);
+        }
+        // else: a thin reference to a name that no longer resolves — drop it.
+    }
+    const mergedNames = new Set(merged.map((item) => item.name));
+    const untouchedBaseItems = base.filter((item) => !mergedNames.has(item.name));
+    return [
+        ...merged,
+        ...(stampCustom
+            ? untouchedBaseItems.map((item) => ({ ...item, custom: false }))
+            : untouchedBaseItems),
+    ];
+}
+//# sourceMappingURL=named-array-merge.js.map

package/dist/lib/named-array-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"named-array-merge.js","sourceRoot":"","sources":["../../src/lib/named-array-merge.ts"],"names":[],"mappings":"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"}

package/dist/mappers/config-mapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-mapper.d.ts","sourceRoot":"","sources":["../../src/mappers/config-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAGrE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,MAAM,MAAM,iBAAiB,GAAG,KAAK,KAAK,EAAE,KAAK,KAAK,cAAc,CAAC;AAErE,wBAAgB,uBAAuB,CACrC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,iBAAiB,CAiBnB"}
+{"version":3,"file":"config-mapper.d.ts","sourceRoot":"","sources":["../../src/mappers/config-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAGrE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,MAAM,MAAM,iBAAiB,GAAG,KAAK,KAAK,EAAE,KAAK,KAAK,cAAc,CAAC;AAErE,wBAAgB,uBAAuB,CACrC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,iBAAiB,CAkBnB"}

package/dist/mappers/config-mapper.js

@@ -12,6 +12,7 @@ export function createConfigMapperClass(options) {
                 configStores: options?.configStores ?? getConfigStores(),
                 configInjectorResolvers: options?.configInjectorResolvers,
                 providers: options?.providers,
+                wholePatchMergers: options?.wholePatchMergers,
                 resolvers: options?.resolvers,
                 configurationOverrideProvider: options?.configurationOverrideProvider,
             });

package/dist/mappers/config-mapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-mapper.js","sourceRoot":"","sources":["../../src/mappers/config-mapper.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAI7D,MAAM,UAAU,uBAAuB,CACrC,OAAgC;IAEhC,OAAO,MAAM,YAAa,SAAQ,cAAc;QAC9C,YAAY,KAAY;YACtB,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACzB,CAAC;QAED,IAAI;YACF,oBAAoB,CAAC;gBACnB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,YAAY,EAAE,OAAO,EAAE,YAAY,IAAI,eAAe,EAAE;gBACxD,uBAAuB,EAAE,OAAO,EAAE,uBAAuB;gBACzD,SAAS,EAAE,OAAO,EAAE,SAAS;gBAC7B,SAAS,EAAE,OAAO,EAAE,SAAS;gBAC7B,6BAA6B,EAAE,OAAO,EAAE,6BAA6B;aACtE,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"config-mapper.js","sourceRoot":"","sources":["../../src/mappers/config-mapper.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAI7D,MAAM,UAAU,uBAAuB,CACrC,OAAgC;IAEhC,OAAO,MAAM,YAAa,SAAQ,cAAc;QAC9C,YAAY,KAAY;YACtB,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACzB,CAAC;QAED,IAAI;YACF,oBAAoB,CAAC;gBACnB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,YAAY,EAAE,OAAO,EAAE,YAAY,IAAI,eAAe,EAAE;gBACxD,uBAAuB,EAAE,OAAO,EAAE,uBAAuB;gBACzD,SAAS,EAAE,OAAO,EAAE,SAAS;gBAC7B,iBAAiB,EAAE,OAAO,EAAE,iBAAiB;gBAC7C,SAAS,EAAE,OAAO,EAAE,SAAS;gBAC7B,6BAA6B,EAAE,OAAO,EAAE,6BAA6B;aACtE,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -64,12 +64,14 @@ type InputField implements IField & IRowElement & IElement {
   maxRows: Int
   minRows: Int
     # End of text area configuration
+  custom: Boolean
 }
 
 type CustomValidator implements  IRowElement & IElement {
   validationRule: String
   errorMessage: String
   paths: [String!]!
+  custom: Boolean
 }
 
 union Fields = InputField | PhoneField | DateField | DateRangeField | SelectField | ToggleField | BooleanField | TextElement
@@ -93,6 +95,7 @@ type RepeaterField implements IRowElement & IElement {
   validateUnique: Boolean
   duplicateMessage: String
   itemValidation: ItemValidation
+  custom: Boolean
 }
 
 type ControlGroup implements IRowElement & IElement {
@@ -101,6 +104,7 @@ type ControlGroup implements IRowElement & IElement {
   skipId: Boolean
   controlOptions: ISelectOptions!
   fields: [Fields!]!
+  custom: Boolean
 }
 
 # Renders the currently-linked records of a multi-valued reference attribute
@@ -131,6 +135,7 @@ type ReferenceTable implements IField & IRowElement & IElement {
   confirmDelete: Boolean
   maxRows: Int
   rowMenuItems: [MenuItem!]
+  custom: Boolean
 }
 
 type PhoneField implements IField & IRowElement & IElement {
@@ -149,6 +154,7 @@ type PhoneField implements IField & IRowElement & IElement {
   visibilityCondition: String
   disabledCondition: String
   validation: GenericFieldValidation
+  custom: Boolean
 }
 
 type DateField implements IField & IRowElement & IElement {
@@ -168,6 +174,7 @@ type DateField implements IField & IRowElement & IElement {
   minDate: String # e.q. "now" or "2025-03-20"
   maxDate: String # e.q. "now" or "2025-03-20"
   validation: GenericFieldValidation
+  custom: Boolean
 }
 
 type DateRangeField implements IDateRangeField & IRowElement & IElement {
@@ -187,6 +194,7 @@ type DateRangeField implements IDateRangeField & IRowElement & IElement {
   visibilityCondition: String
   disabledCondition: String
   validation: GenericFieldValidation
+  custom: Boolean
 }
 
 type SelectField implements IField & IRowElement & IElement {
@@ -212,6 +220,7 @@ type SelectField implements IField & IRowElement & IElement {
   helperText: String
   autoSelectSingleOption: Boolean
   validation: GenericFieldValidation
+  custom: Boolean
 }
 
 type ToggleField implements IField & IRowElement & IElement {
@@ -234,6 +243,7 @@ type ToggleField implements IField & IRowElement & IElement {
   disabledCondition: String
   linkedFields: [String!]
   validation: GenericFieldValidation
+  custom: Boolean
 }
 
 type BooleanField implements IField & IRowElement & IElement {
@@ -252,6 +262,7 @@ type BooleanField implements IField & IRowElement & IElement {
   disabledCondition: String
   linkedFields: [String!]
   validation: GenericFieldValidation
+  custom: Boolean
 }
 
 type ChipSelectWithInputField implements IField & IRowElement & IElement {
@@ -277,6 +288,7 @@ type ChipSelectWithInputField implements IField & IRowElement & IElement {
   disabledCondition: String
   linkedFields: [String!]
   validation: ChipSelectValidation
+  custom: Boolean
 }
 
 type CustomField implements IField & IRowElement & IElement {
@@ -296,6 +308,7 @@ type CustomField implements IField & IRowElement & IElement {
   visibilityCondition: String
   disabledCondition: String
   validation: GenericFieldValidation
+  custom: Boolean
 }
 
 type StatusChipField implements IField & IRowElement & IElement {
@@ -305,6 +318,7 @@ type StatusChipField implements IField & IRowElement & IElement {
   name: String!
   path: String!
   validation: GenericFieldValidation
+  custom: Boolean
 }
 
 type CheckboxGroupValue {
@@ -325,6 +339,7 @@ type CheckboxGroup implements IRowElement & IElement {
   values: [CheckboxGroupValue!]!
   visibilityCondition: String
   disabledCondition: String
+  custom: Boolean
 }
 
 enum FieldValueType {

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/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/model/graphs/config/fields.graphql

@@ -64,12 +64,14 @@ type InputField implements IField & IRowElement & IElement {
   maxRows: Int
   minRows: Int
     # End of text area configuration
+  custom: Boolean
 }
 
 type CustomValidator implements  IRowElement & IElement {
   validationRule: String
   errorMessage: String
   paths: [String!]!
+  custom: Boolean
 }
 
 union Fields = InputField | PhoneField | DateField | DateRangeField | SelectField | ToggleField | BooleanField | TextElement
@@ -93,6 +95,7 @@ type RepeaterField implements IRowElement & IElement {
   validateUnique: Boolean
   duplicateMessage: String
   itemValidation: ItemValidation
+  custom: Boolean
 }
 
 type ControlGroup implements IRowElement & IElement {
@@ -101,6 +104,7 @@ type ControlGroup implements IRowElement & IElement {
   skipId: Boolean
   controlOptions: ISelectOptions!
   fields: [Fields!]!
+  custom: Boolean
 }
 
 # Renders the currently-linked records of a multi-valued reference attribute
@@ -131,6 +135,7 @@ type ReferenceTable implements IField & IRowElement & IElement {
   confirmDelete: Boolean
   maxRows: Int
   rowMenuItems: [MenuItem!]
+  custom: Boolean
 }
 
 type PhoneField implements IField & IRowElement & IElement {
@@ -149,6 +154,7 @@ type PhoneField implements IField & IRowElement & IElement {
   visibilityCondition: String
   disabledCondition: String
   validation: GenericFieldValidation
+  custom: Boolean
 }
 
 type DateField implements IField & IRowElement & IElement {
@@ -168,6 +174,7 @@ type DateField implements IField & IRowElement & IElement {
   minDate: String # e.q. "now" or "2025-03-20"
   maxDate: String # e.q. "now" or "2025-03-20"
   validation: GenericFieldValidation
+  custom: Boolean
 }
 
 type DateRangeField implements IDateRangeField & IRowElement & IElement {
@@ -187,6 +194,7 @@ type DateRangeField implements IDateRangeField & IRowElement & IElement {
   visibilityCondition: String
   disabledCondition: String
   validation: GenericFieldValidation
+  custom: Boolean
 }
 
 type SelectField implements IField & IRowElement & IElement {
@@ -212,6 +220,7 @@ type SelectField implements IField & IRowElement & IElement {
   helperText: String
   autoSelectSingleOption: Boolean
   validation: GenericFieldValidation
+  custom: Boolean
 }
 
 type ToggleField implements IField & IRowElement & IElement {
@@ -234,6 +243,7 @@ type ToggleField implements IField & IRowElement & IElement {
   disabledCondition: String
   linkedFields: [String!]
   validation: GenericFieldValidation
+  custom: Boolean
 }
 
 type BooleanField implements IField & IRowElement & IElement {
@@ -252,6 +262,7 @@ type BooleanField implements IField & IRowElement & IElement {
   disabledCondition: String
   linkedFields: [String!]
   validation: GenericFieldValidation
+  custom: Boolean
 }
 
 type ChipSelectWithInputField implements IField & IRowElement & IElement {
@@ -277,6 +288,7 @@ type ChipSelectWithInputField implements IField & IRowElement & IElement {
   disabledCondition: String
   linkedFields: [String!]
   validation: ChipSelectValidation
+  custom: Boolean
 }
 
 type CustomField implements IField & IRowElement & IElement {
@@ -296,6 +308,7 @@ type CustomField implements IField & IRowElement & IElement {
   visibilityCondition: String
   disabledCondition: String
   validation: GenericFieldValidation
+  custom: Boolean
 }
 
 type StatusChipField implements IField & IRowElement & IElement {
@@ -305,6 +318,7 @@ type StatusChipField implements IField & IRowElement & IElement {
   name: String!
   path: String!
   validation: GenericFieldValidation
+  custom: Boolean
 }
 
 type CheckboxGroupValue {
@@ -325,6 +339,7 @@ type CheckboxGroup implements IRowElement & IElement {
   values: [CheckboxGroupValue!]!
   visibilityCondition: String
   disabledCondition: String
+  custom: Boolean
 }
 
 enum FieldValueType {

package/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/model/graphs/config/ui-components.graphql

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docupace/ihub-config",
-  "version": "1.1.26",
+  "version": "1.1.27",
   "description": "Reusable config GraphQL extension and standalone server",
   "main": "./dist/index.js",
   "type": "module",