@vectoriox/iox-ui 4.35.0 → 4.37.0

package/fesm2022/vectoriox-iox-ui.mjs

@@ -971,6 +971,41 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.31", ngImpo
                 type: Input
             }] } });
 
+/**
+ * Phosphor's CSS needs TWO classes — a weight and a name (`.ph-thin.ph-house:before`). A class
+ * string carrying only the name matches nothing at all: no `font-family`, no glyph, so the element
+ * renders as an invisible, zero-glyph box.
+ *
+ * The icon picker used to emit exactly that (`ph-house`), so every icon chosen through it was blank
+ * on the canvas, in the picker grid and on the live site. Fixing the picker alone would leave every
+ * icon already saved broken, so the repair happens at RENDER time, here, and is shared by the
+ * builder's Icon component and the SSR engine's renderer.
+ *
+ * Everything that is not a weightless Phosphor class passes through untouched — Iconoir
+ * (`iconoir-home`), custom icon-set fonts, Font Awesome, and Phosphor strings that already carry a
+ * weight.
+ *
+ * See iox-ai-guidance `architecture/cms/custom-icon-fonts.md`.
+ */
+/** The weight classes Phosphor ships. `ph` is the regular weight. */
+const PHOSPHOR_WEIGHTS = new Set(['ph', 'ph-thin', 'ph-light', 'ph-regular', 'ph-bold', 'ph-fill', 'ph-duotone']);
+/** The weight assumed when a Phosphor class has none — the weight this platform uses everywhere. */
+const DEFAULT_PHOSPHOR_WEIGHT = 'ph-thin';
+function normalizeIconClass(iconClass) {
+    const raw = (iconClass ?? '').trim();
+    if (!raw)
+        return '';
+    const tokens = raw.split(/\s+/);
+    const hasWeight = tokens.some(token => PHOSPHOR_WEIGHTS.has(token));
+    if (hasWeight)
+        return tokens.join(' ');
+    // `ph-` prefixed but weightless — the broken shape. A token that is only `ph-` is not a name.
+    const hasPhosphorName = tokens.some(token => token.startsWith('ph-') && token.length > 3);
+    if (!hasPhosphorName)
+        return tokens.join(' ');
+    return [DEFAULT_PHOSPHOR_WEIGHT, ...tokens].join(' ');
+}
+
 /** Directive-host icon: the `<i>` IS the host — no wrapper. All styles on `.iox-node`. */
 class BuilderIconComponent {
     constructor() {
@@ -978,12 +1013,20 @@ class BuilderIconComponent {
         this.iconClass = 'ph-thin ph-star';
         this.nodeId = '';
     }
+    /**
+     * Repaired at render time: a Phosphor class saved without its weight (`ph-house`) matches no CSS
+     * rule and renders as an invisible box. The picker used to emit exactly that, so this keeps
+     * every already-saved icon working. Shared with the SSR engine — see `normalizeIconClass`.
+     */
+    get normalizedIconClass() {
+        return normalizeIconClass(this.iconClass);
+    }
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.31", ngImport: i0, type: BuilderIconComponent, deps: [], target: i0.ɵɵFactoryTarget.Component }); }
-    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "20.3.31", type: BuilderIconComponent, isStandalone: false, selector: "i[iox-icon]", inputs: { iconClass: "iconClass", nodeId: "nodeId" }, host: { properties: { "class": "iconClass + ' iox-node-' + nodeId" } }, ngImport: i0, template: '', isInline: true, styles: [":host{display:inline-flex;align-items:center;justify-content:center;line-height:0}\n"] }); }
+    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "20.3.31", type: BuilderIconComponent, isStandalone: false, selector: "i[iox-icon]", inputs: { iconClass: "iconClass", nodeId: "nodeId" }, host: { properties: { "class": "normalizedIconClass + ' iox-node-' + nodeId" } }, ngImport: i0, template: '', isInline: true, styles: [":host{display:inline-flex;align-items:center;justify-content:center;line-height:0}\n"] }); }
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.31", ngImport: i0, type: BuilderIconComponent, decorators: [{
             type: Component,
-            args: [{ selector: 'i[iox-icon]', template: '', host: { '[class]': "iconClass + ' iox-node-' + nodeId" }, standalone: false, styles: [":host{display:inline-flex;align-items:center;justify-content:center;line-height:0}\n"] }]
+            args: [{ selector: 'i[iox-icon]', template: '', host: { '[class]': "normalizedIconClass + ' iox-node-' + nodeId" }, standalone: false, styles: [":host{display:inline-flex;align-items:center;justify-content:center;line-height:0}\n"] }]
         }], propDecorators: { iconClass: [{
                 type: Input
             }], nodeId: [{
@@ -5562,7 +5605,7 @@ const SEO_CHANGE_FREQ_OPTIONS = [
  * Empty branches are dropped rather than left as `{}`, so `if (seo.og)` is a meaningful test.
  */
 function normalizeSeoDoc(raw) {
-    const src = asRecord(raw);
+    const src = asRecord$1(raw);
     if (!src)
         return {};
     const og = compact({
@@ -5597,7 +5640,7 @@ function normalizeSeoDoc(raw) {
 }
 /** Read `src[branch][leaf]` without assuming the branch exists or is an object. */
 function pick(src, branch, leaf) {
-    const nested = asRecord(src[branch]);
+    const nested = asRecord$1(src[branch]);
     return nested ? nested[leaf] : undefined;
 }
 /**
@@ -5608,7 +5651,7 @@ function pick(src, branch, leaf) {
  * `undefined` here and `resolveSeo` fills it in from the lower rungs.
  */
 function seoString(value) {
-    const wrapper = asRecord(value);
+    const wrapper = asRecord$1(value);
     const raw = wrapper ? wrapper['override'] : value;
     if (typeof raw === 'number')
         return String(raw);
@@ -5653,10 +5696,10 @@ function structured(value) {
     }
     if (Array.isArray(value))
         return value.length ? value : undefined;
-    const record = asRecord(value);
+    const record = asRecord$1(value);
     return record && Object.keys(record).length ? record : undefined;
 }
-function asRecord(value) {
+function asRecord$1(value) {
     return value !== null && typeof value === 'object' && !Array.isArray(value)
         ? value
         : undefined;
@@ -5890,14 +5933,14 @@ function resolveSeo(seo, ctx = {}) {
     let derived;
     const content = () => (derived ??= deriveSeoFromContent(ctx.tree, ctx.resolvedData));
     for (const field of SEO_BINDABLE_FIELDS) {
-        if (readField(out, field) !== undefined)
+        if (readField$1(out, field) !== undefined)
             continue; // an override won
-        const stored = fieldValue(raw, field);
+        const stored = fieldValue$1(raw, field);
         // Rung 2 — the binding.
         if (stored?.binding) {
             const value = resolveSeoBinding(stored.binding, ctx.resolvedData);
             if (value !== undefined) {
-                writeField(out, field, value);
+                writeField$1(out, field, value);
                 continue;
             }
         }
@@ -5907,7 +5950,7 @@ function resolveSeo(seo, ctx = {}) {
         const source = SEO_AUTO_SOURCES.find(entry => entry.field === field)?.source;
         const auto = source ? autoValue(source, content, ctx) : undefined;
         if (auto !== undefined)
-            writeField(out, field, auto);
+            writeField$1(out, field, auto);
     }
     // One last pass so a resolved value gets the same trimming and empty-branch dropping as a stored
     // one — `if (seo.og)` must keep meaning something.
@@ -6024,20 +6067,20 @@ function truncate(value, max) {
     return (lastSpace > max * 0.6 ? cut.slice(0, lastSpace) : cut).trimEnd() + '…';
 }
 // ── dotted-path access over the document, so the field table stays data and not a switch ───────────
-function fieldValue(raw, field) {
-    const value = readField(raw, field);
+function fieldValue$1(raw, field) {
+    const value = readField$1(raw, field);
     if (value === null || typeof value !== 'object' || Array.isArray(value))
         return undefined;
     return value;
 }
-function readField(doc, field) {
+function readField$1(doc, field) {
     const [branch, leaf] = field.split('.');
     if (!leaf)
         return doc[branch];
     const nested = doc[branch];
     return nested && typeof nested === 'object' ? nested[leaf] : undefined;
 }
-function writeField(doc, field, value) {
+function writeField$1(doc, field, value) {
     const [branch, leaf] = field.split('.');
     if (!leaf) {
         doc[branch] = value;
@@ -6048,6 +6091,137 @@ function writeField(doc, field, value) {
     doc[branch] = nested;
 }
 
+const MAX_LENGTHS = {
+    title: SEO_TITLE_MAX,
+    description: SEO_DESCRIPTION_MAX,
+    'og.description': SEO_DESCRIPTION_MAX,
+    'twitter.description': SEO_DESCRIPTION_MAX,
+};
+/**
+ * Describe every bindable field for the authoring panel.
+ *
+ * ⚠️ `resolved` is deliberately EMPTY for a bound field on the builder side. The canvas has no
+ * page-level resolved data — each component fetches its own — so a bound value genuinely is not
+ * knowable here. Showing the binding expression and saying so is honest; inventing a preview from
+ * design-time props is how a placeholder ends up looking like real content.
+ */
+function describeSeoFields(seo, ctx = {}) {
+    const raw = asRecord(seo) ?? {};
+    const resolvedDoc = resolveSeo(seo, ctx);
+    return SEO_BINDABLE_FIELDS.map(field => {
+        const stored = fieldValue(raw, field);
+        const override = seoString(readField(raw, field)) ?? '';
+        const binding = stored?.binding;
+        const resolved = seoString(readField(resolvedDoc, field)) ?? '';
+        let source;
+        if (override)
+            source = 'manual';
+        else if (binding)
+            source = 'bound';
+        else if (resolved)
+            source = 'auto';
+        else
+            source = 'empty';
+        return {
+            field,
+            override,
+            binding,
+            // A bound field's value comes from data this side cannot see.
+            resolved: source === 'bound' ? '' : resolved,
+            source,
+            maxLength: MAX_LENGTHS[field],
+        };
+    });
+}
+/** Set a field's typed value. An empty string CLEARS the override so the lower rungs take over. */
+function setSeoOverride(seo, field, value) {
+    const next = clone(seo);
+    const text = value?.trim() ?? '';
+    const existing = fieldValue(next, field);
+    if (!text) {
+        // Nothing else on the field → drop it entirely, so the document stays free of `{}` husks.
+        if (!existing?.binding && existing?.auto !== false)
+            writeField(next, field, undefined);
+        else
+            writeField(next, field, stripUndefined({ binding: existing?.binding, auto: existing?.auto }));
+        return next;
+    }
+    writeField(next, field, stripUndefined({ override: text, binding: existing?.binding, auto: existing?.auto }));
+    return next;
+}
+/** Attach or replace a field's binding. `undefined` removes it. */
+function setSeoBinding(seo, field, binding) {
+    const next = clone(seo);
+    const existing = fieldValue(next, field);
+    const value = stripUndefined({ override: existing?.override, binding, auto: existing?.auto });
+    writeField(next, field, Object.keys(value).length ? value : undefined);
+    return next;
+}
+/** Turn the automatic rung on or off for a field. Off leaves the field genuinely empty. */
+function setSeoAuto(seo, field, enabled) {
+    const next = clone(seo);
+    const existing = fieldValue(next, field);
+    const value = stripUndefined({
+        override: existing?.override,
+        binding: existing?.binding,
+        auto: enabled ? undefined : false,
+    });
+    writeField(next, field, Object.keys(value).length ? value : undefined);
+    return next;
+}
+/** Drop everything an author set on a field — back to the automatic rung. */
+function resetSeoField(seo, field) {
+    const next = clone(seo);
+    writeField(next, field, undefined);
+    return next;
+}
+// ── shared dotted-path plumbing ───────────────────────────────────────────────────────────────
+function clone(seo) {
+    return JSON.parse(JSON.stringify(asRecord(seo) ?? {}));
+}
+function asRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function stripUndefined(value) {
+    const out = {};
+    for (const [key, entry] of Object.entries(value))
+        if (entry !== undefined)
+            out[key] = entry;
+    return out;
+}
+function fieldValue(doc, field) {
+    const value = readField(doc, field);
+    return asRecord(value);
+}
+function readField(doc, field) {
+    const [branch, leaf] = field.split('.');
+    if (!leaf)
+        return doc[branch];
+    const nested = asRecord(doc[branch]);
+    return nested ? nested[leaf] : undefined;
+}
+function writeField(doc, field, value) {
+    const [branch, leaf] = field.split('.');
+    if (!leaf) {
+        if (value === undefined)
+            delete doc[branch];
+        else
+            doc[branch] = value;
+        return;
+    }
+    const nested = (asRecord(doc[branch]) ?? {});
+    if (value === undefined)
+        delete nested[leaf];
+    else
+        nested[leaf] = value;
+    if (Object.keys(nested).length)
+        doc[branch] = nested;
+    else
+        delete doc[branch];
+}
+
 /**
  * Element context state — shared types.
  *
@@ -6735,5 +6909,5 @@ function effectiveTransitionId(anim) {
  * Generated bundle index. Do not edit.
  */
 
-export { AOSService, AnalyticsService, BREAKPOINTS, Breakpoint, BreakpointQueryKind, BuilderButtonComponent, BuilderDividerComponent, BuilderHeadingComponent, BuilderIconComponent, BuilderImageComponent, BuilderLinkComponent, BuilderSpacerComponent, ButtonBlockComponent, CMSClientInfraModule, CONTEXT_ACTION_TYPES, CardComponent, ClientGalleryComponent, ClientListComponent, ClientListItemComponent, ClientRepeaterComponent, ClientSliderContainerComponent, ClientSliderSlideComponent, ComponentInstanceRegistryService, ConsentService, ContainerComponent, ContentService, ContextStore, DEFAULT_GALLERY_SCHEDULER, DEFAULT_PAGE_TRANSITION, DEFAULT_PAGE_TRANSITION_DURATION, DEFAULT_PAGE_TRANSITION_EASING, DEFAULT_PAGE_TRANSITION_PERSPECTIVE, DEFAULT_WIDTH_BY_TYPE, DeclarationContext, ENVIRONMENT, FormRenderState, FormRuntimeService, GALLERY_EFFECTS, GALLERY_EFFECT_DESCRIPTORS, GalleryLoop, IOX_BUILDER_EVENTS, IOX_FORM_MESSAGES, IOX_FORM_NAVIGATOR, IOX_FORM_TRANSPORT, IS_PREVIEW, IoxAnimateContainer, IoxAosDirective, IoxAosModule, IoxBuilderComponentsModule, IoxComponentRegistryService, IoxFieldComponent, IoxFormComponent, IoxFormErrorComponent, IoxFormSuccessComponent, IoxPageComponent, IoxPageModule, IoxSubmitButtonComponent, IoxUiModule, LinkedContainerComponent, PAGE_TRANSITION_CATEGORIES, PAGE_TRANSITION_PRESETS, PIPE_DESCRIPTORS, PIPE_REGISTRY, PageScrollProvider, PrivacyModalComponent, PrivacyModalService, PrivacyModelEvent, RESERVED_ALIAS_PREFIX, SUPPRESSED_STYLE_PROPS_BY_TYPE, SWIPER_RESPONSIVE_TRAITS, SectionComponent, TRANSITION_FEELS, TextBlockComponent, VIRTUAL_TRAIT_GROUPS, VIRTUAL_TRAIT_KEYS, ViewPositionDirective, ViewPositionModule, WebSettingsService, activeActions, applyBindingPipes, applyFeel, breakpointDef, breakpointForWidth, breakpointQueryFor, buildDataSourceFilter, buildRelatedFilter, buildSwiperBreakpoints, buildTargetedStateSelector, buildTransitionTimeline, cascadeChain, clearInputOverride, clearOverride, collectContextSlotKeys, collectReferencedAliases, compileDeclarations, composeVirtualTraits, computeRelative, contextActionEffect, contextSlotKeys, countOverrides, dataSourcePlanToRequest, declaredInputNames, defaultMessageResolver, deriveSeoFromContent, effectiveTransitionId, excludeSelf, feelFor, getByPath, initialSlotValues, isActionEnabled, isContextAction, isInputOverriddenAt, isOverriddenAt, isReservedAlias, isValidSlotKey, legacyEnterToTransition, matchRouteParams, mediaQueryFor, mergeSwiperBreakpoints, nearestCommonAncestorId, nodeCssId, nodeUsesContext, normalizeCollectionResult, normalizeGalleryImage, parentBreakpoint, parseUrlList, planDataSource, planResponsiveRules, referencedDataSources, referencedDataSourcesDeep, renderDefaultDeclarations, resolveBoundValue, resolveContextValue, resolveDerivedInto, resolveGalleryEffect, resolveGalleryUrls, resolveInputChain, resolveInputs, resolvePageTransition, resolvePath, resolveRelativeInto, resolveRepeaterItems, resolveSeo, resolveSiblings, resolveSingleItemId, resolveStateStyles, resolveStyleProps, resolveValueChain, rewriteViewportUnits, safeSetInput, setInputOverride, setOverride, stateNamesIn, stripSuppressedProps, styleKeyToKebab, variableAliases, variableItemsFrom, withContextSlots, wrapInBreakpointQuery, wrapInMediaQuery };
+export { AOSService, AnalyticsService, BREAKPOINTS, Breakpoint, BreakpointQueryKind, BuilderButtonComponent, BuilderDividerComponent, BuilderHeadingComponent, BuilderIconComponent, BuilderImageComponent, BuilderLinkComponent, BuilderSpacerComponent, ButtonBlockComponent, CMSClientInfraModule, CONTEXT_ACTION_TYPES, CardComponent, ClientGalleryComponent, ClientListComponent, ClientListItemComponent, ClientRepeaterComponent, ClientSliderContainerComponent, ClientSliderSlideComponent, ComponentInstanceRegistryService, ConsentService, ContainerComponent, ContentService, ContextStore, DEFAULT_GALLERY_SCHEDULER, DEFAULT_PAGE_TRANSITION, DEFAULT_PAGE_TRANSITION_DURATION, DEFAULT_PAGE_TRANSITION_EASING, DEFAULT_PAGE_TRANSITION_PERSPECTIVE, DEFAULT_PHOSPHOR_WEIGHT, DEFAULT_WIDTH_BY_TYPE, DeclarationContext, ENVIRONMENT, FormRenderState, FormRuntimeService, GALLERY_EFFECTS, GALLERY_EFFECT_DESCRIPTORS, GalleryLoop, IOX_BUILDER_EVENTS, IOX_FORM_MESSAGES, IOX_FORM_NAVIGATOR, IOX_FORM_TRANSPORT, IS_PREVIEW, IoxAnimateContainer, IoxAosDirective, IoxAosModule, IoxBuilderComponentsModule, IoxComponentRegistryService, IoxFieldComponent, IoxFormComponent, IoxFormErrorComponent, IoxFormSuccessComponent, IoxPageComponent, IoxPageModule, IoxSubmitButtonComponent, IoxUiModule, LinkedContainerComponent, PAGE_TRANSITION_CATEGORIES, PAGE_TRANSITION_PRESETS, PIPE_DESCRIPTORS, PIPE_REGISTRY, PageScrollProvider, PrivacyModalComponent, PrivacyModalService, PrivacyModelEvent, RESERVED_ALIAS_PREFIX, SUPPRESSED_STYLE_PROPS_BY_TYPE, SWIPER_RESPONSIVE_TRAITS, SectionComponent, TRANSITION_FEELS, TextBlockComponent, VIRTUAL_TRAIT_GROUPS, VIRTUAL_TRAIT_KEYS, ViewPositionDirective, ViewPositionModule, WebSettingsService, activeActions, applyBindingPipes, applyFeel, breakpointDef, breakpointForWidth, breakpointQueryFor, buildDataSourceFilter, buildRelatedFilter, buildSwiperBreakpoints, buildTargetedStateSelector, buildTransitionTimeline, cascadeChain, clearInputOverride, clearOverride, collectContextSlotKeys, collectReferencedAliases, compileDeclarations, composeVirtualTraits, computeRelative, contextActionEffect, contextSlotKeys, countOverrides, dataSourcePlanToRequest, declaredInputNames, defaultMessageResolver, deriveSeoFromContent, describeSeoFields, effectiveTransitionId, excludeSelf, feelFor, getByPath, initialSlotValues, isActionEnabled, isContextAction, isInputOverriddenAt, isOverriddenAt, isReservedAlias, isValidSlotKey, legacyEnterToTransition, matchRouteParams, mediaQueryFor, mergeSwiperBreakpoints, nearestCommonAncestorId, nodeCssId, nodeUsesContext, normalizeCollectionResult, normalizeGalleryImage, normalizeIconClass, parentBreakpoint, parseUrlList, planDataSource, planResponsiveRules, referencedDataSources, referencedDataSourcesDeep, renderDefaultDeclarations, resetSeoField, resolveBoundValue, resolveContextValue, resolveDerivedInto, resolveGalleryEffect, resolveGalleryUrls, resolveInputChain, resolveInputs, resolvePageTransition, resolvePath, resolveRelativeInto, resolveRepeaterItems, resolveSeo, resolveSiblings, resolveSingleItemId, resolveStateStyles, resolveStyleProps, resolveValueChain, rewriteViewportUnits, safeSetInput, setInputOverride, setOverride, setSeoAuto, setSeoBinding, setSeoOverride, stateNamesIn, stripSuppressedProps, styleKeyToKebab, variableAliases, variableItemsFrom, withContextSlots, wrapInBreakpointQuery, wrapInMediaQuery };
 //# sourceMappingURL=vectoriox-iox-ui.mjs.map