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

package/dist/config-extension.d.ts

@@ -1,10 +1,16 @@
 import { ExtensionConfig } from '@docupace/ihub-core/types';
 import { ConfigStoreParams } from './config-service.js';
 import type { ConfigInjectorResolvers } from './injector-resolvers/config-injector.js';
-import type { ConfigProviders } from './providers/index.js';
+import type { ConfigProviders, WholePatchMergers } from './providers/index.js';
 import type { ConfigResolversConfig } from './resolvers/index.js';
 export interface ConfigurationOverride {
-    value: string;
+    /**
+     * Schema-typed CLOB, but the underlying Core attribute is JSON — for a
+     * JSON-shaped override (e.g. a screen layout patch), this comes back
+     * already parsed as an object rather than as its original JSON string.
+     * Consumers that need to `JSON.parse` this must handle both shapes.
+     */
+    value: string | Record<string, any>;
     contentType?: string | null;
 }
 export interface ConfigurationOverrideResult {
@@ -63,6 +69,13 @@ export interface ConfigurationOverrideProvider {
 export interface ConfigExtensionOptions {
     configInjectorResolvers?: ConfigInjectorResolvers;
     providers?: ConfigProviders;
+    /**
+     * Mergers for whole-object patch overrides, keyed by the `contentType` that marks a
+     * `whole` override as that kind of patch rather than a full-file replacement (see
+     * `WholePatchMerger`). Defaults to `builtInWholePatchMergers` (currently just the
+     * Screen Designer layout patch) merged with anything passed here.
+     */
+    wholePatchMergers?: WholePatchMergers;
     resolvers?: ConfigResolversConfig;
     configStores?: ConfigStoreParams[];
     configurationOverrideProvider?: ConfigurationOverrideProvider;

package/dist/config-extension.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-extension.d.ts","sourceRoot":"","sources":["../src/config-extension.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAwB,MAAM,qBAAqB,CAAC;AAE9E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAEvF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAGlE,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,iEAAiE;IACjE,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACpC;;;;;;;;;;OAUG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;IAC3C;;;;;;;;;;;;;;;OAeG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;CACtD;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,uEAAuE;IACvE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAC/B;qCACiC;IACjC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,6BAA6B;IAC5C;;;;OAIG;IACH,OAAO,CACL,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,GAAG,GACX,OAAO,CAAC,2BAA2B,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,sBAAsB;IACrC,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAClD,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACnC,6BAA6B,CAAC,EAAE,6BAA6B,CAAC;CAC/D;AA+BD,eAAO,MAAM,kBAAkB,GAC7B,UAAS,sBAA2B,KACnC,OAAO,CAAC,eAAe,CA4BzB,CAAC"}
+{"version":3,"file":"config-extension.d.ts","sourceRoot":"","sources":["../src/config-extension.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAwB,MAAM,qBAAqB,CAAC;AAE9E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAEvF,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAGlE,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,iEAAiE;IACjE,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACpC;;;;;;;;;;OAUG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;IAC3C;;;;;;;;;;;;;;;OAeG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;CACtD;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,uEAAuE;IACvE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAC/B;qCACiC;IACjC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,6BAA6B;IAC5C;;;;OAIG;IACH,OAAO,CACL,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,GAAG,GACX,OAAO,CAAC,2BAA2B,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,sBAAsB;IACrC,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAClD,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACnC,6BAA6B,CAAC,EAAE,6BAA6B,CAAC;CAC/D;AA+BD,eAAO,MAAM,kBAAkB,GAC7B,UAAS,sBAA2B,KACnC,OAAO,CAAC,eAAe,CA4BzB,CAAC"}

package/dist/config-extension.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-extension.js","sourceRoot":"","sources":["../src/config-extension.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAqB,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAGrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AA0ErD,MAAM,qBAAqB,GAAG,CAAC,YAAiC,EAAE,EAAE;IAClE,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACxC,GAAG,EAAE,WAAW,CAAC,GAAG;QACpB,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,QAAQ,EAAE,WAAW,CAAC,QAAQ;QAC9B,SAAS,EAAE,WAAW,CAAC,SAAS;QAChC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC;QACvD,UAAU,EAAE,WAAW,CAAC,UAAU;QAClC,YAAY,EAAE,WAAW,CAAC,YAAY;KACvC,CAAC,CAAC,CAAC;AACN,CAAC,CAAC;AAEF,MAAM,sBAAsB,GAAG,KAAK,EAAE,YAAiC,EAAE,EAAE;IACzE,GAAG,CAAC,IAAI,CAAC;QACP,YAAY,EAAE,qBAAqB,CAAC,YAAY,CAAC;KAClD,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,oBAAoB,CAAC;QACzC,KAAK,EAAE,SAAS;QAChB,YAAY;QACZ,uBAAuB,EAAE,SAAS;QAClC,SAAS,EAAE,SAAS;QACpB,SAAS,EAAE,SAAS;QACpB,6BAA6B,EAAE,SAAS;KACzC,CAAC,CAAC;IAEH,MAAM,aAAa,CAAC,IAAI,EAAE,CAAC;AAC7B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EACrC,UAAkC,EAAE,EACV,EAAE;IAC5B,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,eAAe,EAAE,CAAC;IAE/D,MAAM,sBAAsB,CAAC,YAAY,CAAC,CAAC;IAE3C,MAAM,gBAAgB,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CACxD,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAC7C,CAAC;IAEF,MAAM,WAAW,GAAG,uBAAuB,CAAC;QAC1C,uBAAuB,EAAE,OAAO,CAAC,uBAAuB;QACxD,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,YAAY;QACZ,6BAA6B,EAAE,OAAO,CAAC,6BAA6B;KACrE,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,CAAC,mBAAmB,EAAE,EAAE,GAAG,gBAAgB,CAAC;QACxD,OAAO,EAAE;YACP;gBACE,WAAW;aACZ;SACF;QACD,KAAK,EAAE,EAAE;QACT,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"config-extension.js","sourceRoot":"","sources":["../src/config-extension.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAqB,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAGrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAuFrD,MAAM,qBAAqB,GAAG,CAAC,YAAiC,EAAE,EAAE;IAClE,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACxC,GAAG,EAAE,WAAW,CAAC,GAAG;QACpB,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,QAAQ,EAAE,WAAW,CAAC,QAAQ;QAC9B,SAAS,EAAE,WAAW,CAAC,SAAS;QAChC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC;QACvD,UAAU,EAAE,WAAW,CAAC,UAAU;QAClC,YAAY,EAAE,WAAW,CAAC,YAAY;KACvC,CAAC,CAAC,CAAC;AACN,CAAC,CAAC;AAEF,MAAM,sBAAsB,GAAG,KAAK,EAAE,YAAiC,EAAE,EAAE;IACzE,GAAG,CAAC,IAAI,CAAC;QACP,YAAY,EAAE,qBAAqB,CAAC,YAAY,CAAC;KAClD,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,oBAAoB,CAAC;QACzC,KAAK,EAAE,SAAS;QAChB,YAAY;QACZ,uBAAuB,EAAE,SAAS;QAClC,SAAS,EAAE,SAAS;QACpB,SAAS,EAAE,SAAS;QACpB,6BAA6B,EAAE,SAAS;KACzC,CAAC,CAAC;IAEH,MAAM,aAAa,CAAC,IAAI,EAAE,CAAC;AAC7B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EACrC,UAAkC,EAAE,EACV,EAAE;IAC5B,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,eAAe,EAAE,CAAC;IAE/D,MAAM,sBAAsB,CAAC,YAAY,CAAC,CAAC;IAE3C,MAAM,gBAAgB,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CACxD,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAC7C,CAAC;IAEF,MAAM,WAAW,GAAG,uBAAuB,CAAC;QAC1C,uBAAuB,EAAE,OAAO,CAAC,uBAAuB;QACxD,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,YAAY;QACZ,6BAA6B,EAAE,OAAO,CAAC,6BAA6B;KACrE,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,CAAC,mBAAmB,EAAE,EAAE,GAAG,gBAAgB,CAAC;QACxD,OAAO,EAAE;YACP;gBACE,WAAW;aACZ;SACF;QACD,KAAK,EAAE,EAAE;QACT,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC,CAAC"}

package/dist/config-service.d.ts

@@ -1,5 +1,15 @@
-import type { ConfigExtensionOptions, SubPathOverrideLayers } from './config-extension.js';
+import type { ConfigExtensionOptions, ConfigurationOverride, SubPathOverrideLayers } from './config-extension.js';
 import { Model } from '@docupace/ihub-core';
+export interface ScopedConfigLookup {
+    /** A domain 51 Role's name (not its id — see the comment above
+     * `sanitizeRoleNameSegment`). Falls back to the global path when unset or
+     * when no role-scoped file exists yet. */
+    roleName?: string;
+    /** A JSONPath sub-path (e.g. `$.columns`) — resolves to the sibling file
+     * convention instead of the base config path. */
+    subPath?: string;
+}
+export declare function buildScopedConfigPath(configPath: string, { roleName, subPath }?: ScopedConfigLookup): string;
 export interface ConfigStore {
     supportsRefresh(): boolean;
     hasConfig(path: string): Promise<boolean>;
@@ -22,6 +32,7 @@ export interface DefaultConfigServiceParams {
     configStores: ConfigStoreParams[];
     configInjectorResolvers: ConfigExtensionOptions['configInjectorResolvers'];
     providers: ConfigExtensionOptions['providers'];
+    wholePatchMergers?: ConfigExtensionOptions['wholePatchMergers'];
     resolvers: ConfigExtensionOptions['resolvers'];
     configurationOverrideProvider: ConfigExtensionOptions['configurationOverrideProvider'];
 }
@@ -40,6 +51,9 @@ export declare class ConfigFileStore implements ConfigStore {
     hasConfig(configPath: string): Promise<boolean>;
     listConfigs(configPath: string): Promise<string[]>;
     updateConfig(configPath: string, config: any): Promise<void>;
+    hasScopedConfig(configPath: string, lookup?: ScopedConfigLookup): Promise<boolean>;
+    getScopedConfig(configPath: string, lookup?: ScopedConfigLookup): Promise<any | undefined>;
+    updateScopedConfig(configPath: string, config: any, lookup?: ScopedConfigLookup): Promise<void>;
     init(): Promise<void>;
     refresh(): Promise<void>;
 }
@@ -48,6 +62,7 @@ declare class ConfigService {
     private readonly model?;
     private readonly configInjectorResolvers;
     private readonly providers;
+    private readonly wholePatchMergers;
     private readonly resolvers;
     private readonly configurationOverrideProvider;
     constructor(model: Model | undefined, configStores: ConfigStore[], extensionOptions?: ConfigExtensionOptions);
@@ -79,10 +94,12 @@ declare class ConfigService {
     getConfigFromStore(configPath: string, context?: any): Promise<{
         config: any;
         subPathOverrides: SubPathOverrideLayers | null;
+        whole: ConfigurationOverride | null;
     }>;
     hasConfig(configPath: string): Promise<boolean>;
     getConfig(configPath: string, context: any, values?: any, processProviders?: boolean): Promise<any>;
     getDirectConfig(configPath: string, context: any, values?: any, processProviders?: boolean): Promise<any>;
+    private applyWholePatchIfPresent;
     listDirectConfigs(configPath: string): Promise<any[]>;
     updateConfig(configPath: string, config: any, context: any): Promise<any>;
     private normalizePathForMatching;
@@ -108,6 +125,6 @@ declare class ConfigService {
     getPageConfig(pagePath: string, context: any, processConfig?: boolean, rulesContext?: any): Promise<any>;
     init(): Promise<void[]>;
 }
-export declare const defaultConfigService: ({ model, configStores, configInjectorResolvers, providers, resolvers, configurationOverrideProvider, }: DefaultConfigServiceParams) => ConfigService;
+export declare const defaultConfigService: ({ model, configStores, configInjectorResolvers, providers, wholePatchMergers, resolvers, configurationOverrideProvider, }: DefaultConfigServiceParams) => ConfigService;
 export default ConfigService;
 //# sourceMappingURL=config-service.d.ts.map

package/dist/config-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-service.d.ts","sourceRoot":"","sources":["../src/config-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config-service.d.ts","sourceRoot":"","sources":["../src/config-service.ts"],"names":[],"mappings":"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"}

package/dist/config-service.js

@@ -7,19 +7,14 @@ import { fileExists } from './lib/file-system.js';
 import replaceDotsOutsideExpressions from './lib/replace-dots-outside-expressions.js';
 import { createHash } from 'node:crypto';
 import { injectConfigValue, } from './injector-resolvers/config-injector.js';
-import { builtInProviders } from './providers/index.js';
+import { builtInProviders, builtInWholePatchMergers, } from './providers/index.js';
 import { deepMergeResolvers, } from './resolvers/index.js';
 import { dump, load } from 'js-yaml';
 import { buildQuery } from '@docupace/ihub-core/query';
+import { isNamedObjectArray, mergeNamedObjectArray, } from './lib/named-array-merge.js';
 import jp from 'jsonpath';
 const FULL_OBJECT_EXPRESSION_PATTERN = /^\${(.*?)}$/;
 const INLINE_OBJECT_EXPRESSION_PATTERN = /\${(.*?)}/g;
-function isNamedObjectArray(value) {
-    return (Array.isArray(value) &&
-        value.every((item) => item !== null &&
-            typeof item === 'object' &&
-            typeof item.name === 'string'));
-}
 // An override element counts as "self-contained" when it carries enough of
 // its own definition to render on its own — a real attribute path (or paths)
 // or a computed expression — as opposed to a thin `{ name, visible }`-style
@@ -36,58 +31,20 @@ function isSelfContainedOverrideElement(item) {
         (typeof item.expression === 'string' && item.expression.length > 0));
 }
 /**
- * Merge semantics for a config sub-path override against the value already
- * at that JSONPath. Generic — used for any typename/sub-path the
- * configPath/subPath mechanism resolves, not just `Table.columns`.
- *
- * 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 it's self-contained (has its own path(s)/expression — e.g. a
- *   hand-authored column), or silently dropped when it's a thin reference
- *   whose target (e.g. a predefined column) no longer exists — this never
- *   throws; the stale reference just doesn't round-trip into the next save.
- *
- * Any other shape (scalars, plain objects, arrays without a `name` key) is
- * returned untouched, so the caller's plain whole-value replace applies
- * exactly as it did before this merge existed.
+ * Merge semantics for a config sub-path override against the value already at that
+ * JSONPath. Generic — used for any typename/sub-path the configPath/subPath mechanism
+ * resolves, not just `Table.columns` — a thin wrapper over the shared
+ * `mergeNamedObjectArray` (see `named-array-merge.ts` for the full algorithm), fixed to
+ * this call site's own definition of "self-contained" (`isSelfContainedOverrideElement`).
+ * Any other shape (scalars, plain objects, arrays without a `name` key) is returned
+ * untouched, so the caller's plain whole-value replace applies exactly as it did before
+ * this merge existed.
  */
 function mergeSubPathOverrideValue(base, override) {
     if (!isNamedObjectArray(override) || !isNamedObjectArray(base)) {
         return override;
     }
-    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) {
-            merged.push({ ...baseItem, ...overrideItem });
-        }
-        else if (isSelfContainedOverrideElement(overrideItem)) {
-            merged.push(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, ...untouchedBaseItems];
+    return mergeNamedObjectArray(base, override, isSelfContainedOverrideElement);
 }
 // Marks each element of a fully-folded named-object array with whether it
 // would still show up — present *and* not hidden — without the layer stored
@@ -303,6 +260,46 @@ function applySubPathOverrides(config, subPathPatch) {
     }
     return result;
 }
+// Domain 735 rows scoped to a Role sync under a `roles/<roleName>/**` tree
+// that mirrors the existing `global/**` tree, instead of a filename suffix —
+// keeps the sibling sub-path convention below identical regardless of scope.
+// Keyed by the role's name rather than its id so the path is human-readable
+// in the site repo; callers are responsible for keeping writes (Config
+// Sync) and reads (`configuration-override-service.ts`'s `resolve()`)
+// pointed at the same role name — renaming a role orphans its previously
+// synced file, and two roles sharing a name would collide on this path.
+function sanitizeSubPathSegment(subPath) {
+    return subPath.replace(/[^A-Za-z0-9_.$()[\]'@=<> -]/g, '_');
+}
+// Role names are admin-entered free text (unlike a role id) — strip
+// anything that isn't safe as a single flat directory segment (notably
+// `/`, which would otherwise nest into subdirectories).
+function sanitizeRoleNameSegment(roleName) {
+    return roleName.replace(/[^A-Za-z0-9_.-]/g, '_');
+}
+// The sub-path sibling-file convention: a JSONPath override (e.g. `$.columns`)
+// on `dataTypes/IContact/tabs/employmentTab/fields` lives at
+// `dataTypes/IContact/tabs/employmentTab/fields.$.columns`, next to the base
+// config it patches, rather than inside it.
+function siblingConfigPath(basePath, subPath) {
+    const dir = path.dirname(basePath);
+    const siblingName = `${path.basename(basePath)}.${sanitizeSubPathSegment(subPath)}`;
+    return dir === '.' ? siblingName : path.join(dir, siblingName);
+}
+// Builds the repo-relative path a (configPath, roleName?, subPath?) tuple
+// resolves to under a `ConfigFileStore`'s root — `global/<configPath>` (or
+// its `roles/<roleName>/<configPath>` sibling), with the sub-path suffix
+// applied first when present. Exported as a pure function so callers that
+// only need the path (e.g. computing a sync target path for a diff) don't
+// need a `ConfigFileStore` instance to do the math.
+export function buildScopedConfigPath(configPath, { roleName, subPath } = {}) {
+    const effectivePath = subPath
+        ? siblingConfigPath(configPath, subPath)
+        : configPath;
+    return roleName
+        ? path.join('roles', sanitizeRoleNameSegment(roleName), effectivePath)
+        : path.join('global', effectivePath);
+}
 export class ConfigFileStore {
     localPath;
     remotePath;
@@ -399,8 +396,43 @@ export class ConfigFileStore {
         const fullPath = path.join(this.localPath, configPath);
         const finalPath = await this.getFinalPath(fullPath);
         const yamlOutput = dump(config);
+        // A role-scoped (`roles/<roleName>/...`) or sub-path sibling file may be
+        // the first file ever written under its directory — unlike the
+        // pre-existing `global/**` tree, that directory isn't guaranteed to
+        // exist yet.
+        await fsPromises.mkdir(path.dirname(finalPath), { recursive: true });
         await fsPromises.writeFile(finalPath, yamlOutput, 'utf8');
     }
+    // Role-aware, sub-path-aware lookup on top of this store's plain
+    // `hasConfig`/`getConfig`/`updateConfig` — resolves a role-scoped file
+    // first when `roleName` is given, falling back to the global path when no
+    // role-scoped file exists yet (mirrors domain 735's GENERAL→ROLE cascade).
+    async hasScopedConfig(configPath, lookup = {}) {
+        if (lookup.roleName) {
+            const rolePath = buildScopedConfigPath(configPath, lookup);
+            if (await this.hasConfig(rolePath)) {
+                return true;
+            }
+        }
+        return this.hasConfig(buildScopedConfigPath(configPath, { subPath: lookup.subPath }));
+    }
+    async getScopedConfig(configPath, lookup = {}) {
+        if (lookup.roleName) {
+            const rolePath = buildScopedConfigPath(configPath, lookup);
+            if (await this.hasConfig(rolePath)) {
+                return this.getConfig(rolePath);
+            }
+        }
+        const globalPath = buildScopedConfigPath(configPath, {
+            subPath: lookup.subPath,
+        });
+        return (await this.hasConfig(globalPath))
+            ? this.getConfig(globalPath)
+            : undefined;
+    }
+    async updateScopedConfig(configPath, config, lookup = {}) {
+        await this.updateConfig(buildScopedConfigPath(configPath, lookup), config);
+    }
     async init() {
         if (this.remotePath) {
             try {
@@ -444,6 +476,7 @@ class ConfigService {
     model;
     configInjectorResolvers;
     providers;
+    wholePatchMergers;
     resolvers;
     configurationOverrideProvider;
     constructor(model, configStores, extensionOptions = {}) {
@@ -455,6 +488,9 @@ class ConfigService {
         this.providers = extensionOptions.providers
             ? { ...builtInProviders, ...extensionOptions.providers }
             : { ...builtInProviders };
+        this.wholePatchMergers = extensionOptions.wholePatchMergers
+            ? { ...builtInWholePatchMergers, ...extensionOptions.wholePatchMergers }
+            : { ...builtInWholePatchMergers };
         this.resolvers = extensionOptions.resolvers
             ? { ...extensionOptions.resolvers }
             : {};
@@ -857,10 +893,14 @@ class ConfigService {
         }
         const override = await this.configurationOverrideProvider?.resolve(refConfigPath, context);
         if (override?.whole?.contentType) {
+            // A real-MIME-type asset override (image/svg+xml, etc.) is always base64 text, never the
+            // JSON-shaped value the CLOB/JSON attribute mismatch affects — see the screen-layout-patch
+            // branch below for that case.
+            const data = override.whole.value;
             return {
-                data: override.whole.value,
+                data,
                 mimeType: override.whole.contentType,
-                hash: createHash('sha256').update(override.whole.value).digest('hex'),
+                hash: createHash('sha256').update(data).digest('hex'),
             };
         }
         let standardStore;
@@ -918,20 +958,24 @@ class ConfigService {
     // configPath together, in one provider round trip, instead of fetching
     // them separately at different points of the processing pipeline. The
     // sub-path overrides are handed back alongside the config so callers can
-    // thread them into processConfig rather than re-resolving them later.
+    // thread them into processConfig rather than re-resolving them later; the
+    // whole override is handed back too so a screen-layout-patch (a whole
+    // override distinguished by its contentType) can be applied later in the
+    // pipeline without a second resolve() call.
     async getConfigFromStore(configPath, context) {
         const override = await this.configurationOverrideProvider?.resolve(configPath, context);
         const subPathOverrides = override
             ? toSubPathOverrideLayers(override)
             : null;
-        if (override?.whole && !override.whole.contentType) {
-            return { config: load(override.whole.value), subPathOverrides };
+        const whole = override?.whole ?? null;
+        if (whole && !whole.contentType) {
+            return { config: load(whole.value), subPathOverrides, whole };
         }
         const exceptions = [];
         for (const [index, configStore] of this.configStores.entries()) {
             try {
                 const config = await configStore.getConfig(configPath);
-                return { config, subPathOverrides };
+                return { config, subPathOverrides, whole };
             }
             catch (e) {
                 exceptions.push(e);
@@ -940,7 +984,7 @@ class ConfigService {
                 }
             }
         }
-        return { config: undefined, subPathOverrides };
+        return { config: undefined, subPathOverrides, whole };
     }
     async hasConfig(configPath) {
         return (await Promise.all(this.configStores.map((configStore) => configStore.hasConfig(configPath)))).some(Boolean);
@@ -950,10 +994,40 @@ class ConfigService {
         return this.getDirectConfig(globalPath, context, values, processProviders);
     }
     async getDirectConfig(configPath, context, values, processProviders) {
-        const { config: obj, subPathOverrides } = await this.getConfigFromStore(configPath, context);
+        const { config: obj, subPathOverrides, whole, } = await this.getConfigFromStore(configPath, context);
         const fullObj = await this.processObject(configPath, obj, context, values);
         const processedObj = await this.processConfig(fullObj, context, processProviders, subPathOverrides);
-        return processedObj;
+        // A whole-object patch override needs the fully $ref/rules-resolved config to merge
+        // onto (its own document is name-keyed against that resolved shape), so it's applied
+        // last — after the whole-file-replacement branch in getConfigFromStore (which this is
+        // mutually exclusive with; that branch short-circuits before $ref resolution) and
+        // after processConfig, not folded into either.
+        return this.applyWholePatchIfPresent(processedObj, whole);
+    }
+    // Shared by getDirectConfig and getPageConfig — both resolve a fully $ref/rules-processed
+    // config that a whole-object patch override (if any exists for this path) needs to merge
+    // onto, so both need this as their final step. `whole` is the same whole-override already
+    // resolved once by getConfigFromStore — no second resolve() call needed.
+    //
+    // This has no knowledge of what any particular contentType's patch document looks like —
+    // it only knows how to look up a WholePatchMerger by contentType and delegate to it. A
+    // `whole` override with no contentType is a full-file replacement, already substituted in
+    // by getConfigFromStore, so there's nothing left to merge here; a contentType with no
+    // registered merger is left untouched rather than guessed at.
+    applyWholePatchIfPresent(processedObj, whole) {
+        const merger = whole?.contentType
+            ? this.wholePatchMergers[whole.contentType]
+            : undefined;
+        if (!merger) {
+            return processedObj;
+        }
+        // `Configuration.value` is typed CLOB, but the underlying attribute is JSON — for a
+        // JSON-shaped value like a whole patch, it can come back already parsed as an object
+        // rather than as the JSON string it was saved as. Handle both shapes.
+        const patch = whole.value && typeof whole.value === 'object'
+            ? whole.value
+            : JSON.parse(whole.value);
+        return merger.merge(processedObj, patch);
     }
     async listDirectConfigs(configPath) {
         const configs = await Promise.all(this.configStores.map((configStore) => configStore.listConfigs(configPath)));
@@ -1303,20 +1377,26 @@ class ConfigService {
     }
     async getPageConfig(pagePath, context, processConfig, rulesContext) {
         const globalPath = path.join('global', 'pages', pagePath);
-        const { config: obj, subPathOverrides } = await this.getConfigFromStore(globalPath, context);
+        const { config: obj, subPathOverrides, whole, } = await this.getConfigFromStore(globalPath, context);
         const fullObj = await this.processObject(globalPath, obj, context, null);
         const matchingRuleGroups = await this.getRuleGroups(rulesContext, context);
         const configToProcess = this.applyFieldRuleOverrides(fullObj, matchingRuleGroups);
-        return await this.processConfig(configToProcess, context, processConfig, subPathOverrides);
+        const processedObj = await this.processConfig(configToProcess, context, processConfig, subPathOverrides);
+        // Keyed by globalPath — the same `global/pages/<pagePath>` path a whole-patch save
+        // (e.g. the Screen Designer's, see toPageConfigOverridePath in docupace-ui-main) writes
+        // under, so a patch saved against a route like `contacts/{id}/details` is found here
+        // too, not just in getDirectConfig.
+        return this.applyWholePatchIfPresent(processedObj, whole);
     }
     async init() {
         return Promise.all(this.configStores.map((configStore) => configStore.init()));
     }
 }
-export const defaultConfigService = ({ model, configStores, configInjectorResolvers, providers, resolvers, configurationOverrideProvider, }) => {
+export const defaultConfigService = ({ model, configStores, configInjectorResolvers, providers, wholePatchMergers, resolvers, configurationOverrideProvider, }) => {
     const extensionOptions = {
         configInjectorResolvers,
         providers,
+        wholePatchMergers,
         resolvers,
         configurationOverrideProvider,
     };