@praxisui/core 9.0.47 → 9.0.49

package/README.md

@@ -212,6 +212,14 @@ those descriptors only in its render projection, so the authored and persisted
 document keeps stable semantic keys. Plain strings remain untouched, and
 framework chrome continues to come from each library's i18n catalog.
 
+During generic document traversal, a record containing only `{ key }` remains
+structural. A descriptor must also carry `text` or `params` to be localized.
+This keeps contracts such as analytics mappings (`{ key: "status" }`) intact,
+even if a page catalog happens to use the same key. Typed component metadata
+may still resolve key-only `PraxisTextValue` values directly through
+`PraxisI18nService`; the UI Composition Plan compiler also materializes
+fallback `text` for page-owned key-only copy before persistence.
+
 ### Composition link delivery and failures
 
 Composition links execute in their persisted array order inside one synchronous

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-08-30T21:38:22.309Z",
+  "generatedAt": "2026-08-31T13:56:05.891Z",
   "packageName": "@praxisui/core",
-  "packageVersion": "9.0.47",
+  "packageVersion": "9.0.49",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 4,

package/fesm2022/praxisui-core.mjs

@@ -20509,7 +20509,8 @@ function resolvePraxisI18nDocument(document, options) {
         options.i18n.getFallbackLocale();
     const ancestors = new Set();
     const visit = (value) => {
-        if (isPraxisI18nMessageDescriptor(value)) {
+        if (isPraxisI18nMessageDescriptor(value) &&
+            isExplicitDocumentMessageDescriptor(value)) {
             return resolveDescriptor(value, locale, fallbackLocale, options);
         }
         if (Array.isArray(value)) {
@@ -20555,6 +20556,17 @@ function isPraxisI18nMessageDescriptor(value) {
         (typeof text === 'string' && !!text)) &&
         (params == null || isPlainRecord(params)));
 }
+/**
+ * Generic document traversal needs stronger evidence than the public
+ * descriptor guard. Key-only records are common structural contracts (for
+ * example analytics field mappings), so only descriptors with an explicit
+ * text fallback or interpolation params are localized. Typed consumers can
+ * continue to resolve key-only descriptors directly through PraxisI18nService.
+ */
+function isExplicitDocumentMessageDescriptor(descriptor) {
+    return (Object.prototype.hasOwnProperty.call(descriptor, 'text') ||
+        Object.prototype.hasOwnProperty.call(descriptor, 'params'));
+}
 function resolveDescriptor(descriptor, locale, fallbackLocale, options) {
     const key = descriptor.key?.trim();
     if (!key) {
@@ -38830,12 +38842,21 @@ class DynamicWidgetPageComponent {
         if (this.authoringCapabilities == null) {
             return widgets;
         }
-        const enableCustomization = this.isAuthoringCapabilityEnabled('childCustomization');
+        const authoredByKey = new Map((this.authoredPageDefinition?.widgets || []).map((widget) => [
+            widget.key,
+            widget,
+        ]));
         return widgets.map((widget) => {
             const metadata = this.componentMetadata?.get(widget.definition?.id || '');
-            if (!metadata?.inputs?.some((input) => input.name === 'enableCustomization') ||
-                widget.definition.inputs?.['enableCustomization'] ===
-                    enableCustomization) {
+            if (!metadata?.inputs?.some((input) => input.name === 'enableCustomization')) {
+                return widget;
+            }
+            const authoredEnableCustomization = authoredByKey.get(widget.key)?.definition.inputs?.['enableCustomization'] === true;
+            const enableCustomization = this.enableCustomization &&
+                this.isAuthoringCapabilityEnabled('childCustomization') &&
+                authoredEnableCustomization;
+            if (widget.definition.inputs?.['enableCustomization'] ===
+                enableCustomization) {
                 return widget;
             }
             return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/core",
-  "version": "9.0.47",
+  "version": "9.0.49",
   "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

@@ -14115,7 +14115,7 @@ interface WidgetPageAuthoringCapabilities {
     widgetInputs?: boolean;
     /** Allows removing widgets from the page. */
     widgetRemoval?: boolean;
-    /** Allows nested components to receive authoring-only customization inputs. */
+    /** Grants nested authoring only to widgets that explicitly opt in. */
     childCustomization?: boolean;
 }
 /** Fine-grained shell capabilities used by the canonical shell editor. */