@praxisui/core 9.0.57 → 9.0.58

package/README.md

@@ -167,6 +167,28 @@ Component-owned config editors, AI authoring manifests, and runtime profiles are
 
 The validator performs no rendering, dispatch, HTTP call or persistence. Pass the same `ComponentMetadataRegistry` that the target host uses for dynamic materialization. Registry presence is the materializability evidence supported by the current contract; component packages remain responsible for publishing and testing their own metadata providers.
 
+## Remote Configuration Persistence
+
+`providePraxisGlobalConfigBootstrap` is the official host entry point for
+`ApiConfigStorage`. Set `scope` explicitly whenever ownership is a product
+decision instead of a lookup preference:
+
+```ts
+providePraxisGlobalConfigBootstrap({
+  remote: { apiPath: "/api" },
+  scope: "tenant",
+  headersFactory: () => enterpriseRuntimeContext.headers(),
+  errorPolicy: "fail",
+});
+```
+
+Use `scope: "tenant"` for a shared governed document such as an application
+page composition, and `scope: "user"` for personal preferences. Omitting the
+option deliberately preserves the `praxis-config-starter` resolution rule:
+requests carrying `X-User-ID` resolve user config first, while tenant config is
+the fallback for reads. Scope selects persistence ownership; it never replaces
+server-side identity resolution or write authorization.
+
 ## Dynamic Page Runtime
 
 `DynamicWidgetPageComponent` renders `WidgetPageDefinition` documents.

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-09-01T14:12:48.929Z",
+  "generatedAt": "2026-09-03T03:04:37.933Z",
   "packageName": "@praxisui/core",
-  "packageVersion": "9.0.57",
+  "packageVersion": "9.0.58",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 4,

package/fesm2022/praxisui-core.mjs

@@ -16296,6 +16296,7 @@ class ResourceActionOpenAdapterService {
         if (options.initialValue) {
             payload.widget.inputs['initialValue'] = this.clone(options.initialValue);
         }
+        this.applyInteractionPresentation(payload, action);
         if (action.scope === 'ITEM') {
             if (options.resourceId != null) {
                 payload.widget.inputs['resourceId'] = options.resourceId;
@@ -16313,6 +16314,43 @@ class ResourceActionOpenAdapterService {
         this.applyExecutionInputs(payload, action, options);
         return payload;
     }
+    applyInteractionPresentation(payload, action) {
+        const requiresFormConfirmation = action.execution?.interaction.mode === 'FORM'
+            && action.execution.interaction.confirmationRequired;
+        const confirmationMessage = requiresFormConfirmation
+            ? String(action.description ?? '').trim() || String(action.title ?? '').trim()
+            : '';
+        if (requiresFormConfirmation && !confirmationMessage) {
+            throw new Error(`ResourceActionOpenAdapterService requires description or title for confirmed FORM action "${action.id}".`);
+        }
+        const successMessage = String(action.successMessage ?? '').trim();
+        if (!confirmationMessage && !successMessage) {
+            return;
+        }
+        const inputs = payload.widget.inputs;
+        const currentConfig = this.clone(inputs['config'] ?? {});
+        const currentMessages = this.clone(currentConfig['messages'] ?? {});
+        if (confirmationMessage) {
+            currentMessages['confirmations'] = {
+                ...(currentMessages['confirmations'] ?? {}),
+                submit: confirmationMessage,
+            };
+        }
+        if (successMessage) {
+            const customActions = {
+                ...(currentMessages['customActions'] ?? {}),
+            };
+            customActions['submit'] = {
+                ...(customActions['submit'] ?? {}),
+                success: successMessage,
+            };
+            currentMessages['customActions'] = customActions;
+        }
+        inputs['config'] = {
+            ...currentConfig,
+            messages: currentMessages,
+        };
+    }
     resolveDynamicFormPreset() {
         const preset = SURFACE_OPEN_PRESETS.find((candidate) => candidate.id === 'praxis-dynamic-form');
         if (!preset) {
@@ -19802,6 +19840,7 @@ function providePraxisGlobalConfigBootstrap(options) {
     const baseUrl = resolveBaseUrl(normalized.remote);
     const apiOptions = {
         ...(baseUrl ? { baseUrl } : {}),
+        ...(normalized.scope ? { scope: normalized.scope } : {}),
         headersFactory,
         defaultHeaders: normalized.includeDefaultHeaders ? undefined : {},
         errorPolicy: normalized.errorPolicy,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/core",
-  "version": "9.0.57",
+  "version": "9.0.58",
   "description": "Core library for Praxis UI Workspace: types, tokens, services and utilities shared across @praxisui/* packages.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",

package/types/praxisui-core.d.ts

@@ -6191,8 +6191,13 @@ declare const CONFIG_STORAGE: InjectionToken<ConfigStorage>;
  */
 interface ApiConfigStorageOptions {
     baseUrl?: string;
-    /** Optional ui_user_config scope query param, e.g. "user" for user-owned configs. */
-    scope?: string;
+    /**
+     * Explicit ui_user_config ownership.
+     *
+     * Omit only when the host deliberately wants the backend resolution rule
+     * (user first when X-User-ID is present, then tenant on reads).
+     */
+    scope?: 'user' | 'tenant';
     /** Factory to supply headers (tenant/user/env/updatedBy) per request. */
     headersFactory?: () => Record<string, string | undefined>;
     /** Default headers applied when the headersFactory omits them. */
@@ -10863,6 +10868,7 @@ interface ResourceActionOpenAdapterOptions {
 declare class ResourceActionOpenAdapterService {
     private readonly discovery;
     toPayload(action: ResourceActionCatalogItem, options: ResourceActionOpenAdapterOptions): SurfaceOpenPayload;
+    private applyInteractionPresentation;
     private resolveDynamicFormPreset;
     private buildStableInstanceId;
     private applyExecutionInputs;
@@ -11867,6 +11873,13 @@ interface PraxisGlobalConfigBootstrapOptions {
         baseUrl?: string;
         apiPath?: string;
     };
+    /**
+     * Explicit ownership for every config key handled by this bootstrap.
+     * Use `tenant` for shared governed configuration and `user` for personal
+     * preferences. When omitted, praxis-config-starter applies its canonical
+     * header-based resolution rule.
+     */
+    scope?: 'user' | 'tenant';
     headers?: Record<string, string>;
     headersFactory?: () => Record<string, string>;
     includeDefaultHeaders?: boolean;