@vectoriox/iox-ui 4.36.0 → 4.38.0

package/fesm2022/vectoriox-iox-ui.mjs

@@ -5605,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({
@@ -5640,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;
 }
 /**
@@ -5651,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);
@@ -5696,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;
@@ -5933,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;
             }
         }
@@ -5950,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.
@@ -6067,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;
@@ -6091,6 +6091,154 @@ 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;
+}
+/**
+ * Set a field that is NOT part of the ladder — `robots`, `twitter.card`, `structuredData`,
+ * `sitemap.*`. These are pick-lists, switches and blobs: they have no override/binding/auto, so they
+ * are stored as plain values, exactly as the normalizer reads them.
+ *
+ * `undefined`, `null` and `''` remove the field, so an unset pick-list leaves no husk behind.
+ */
+function setSeoValue(seo, field, value) {
+    const next = clone(seo);
+    const empty = value === undefined || value === null || (typeof value === 'string' && !value.trim());
+    writeField(next, field, empty ? undefined : value);
+    return next;
+}
+/** Read any field's plain stored value — the counterpart of `setSeoValue`. */
+function getSeoValue(seo, field) {
+    return readField(asRecord(seo) ?? {}, field);
+}
+/** 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.
  *
@@ -6778,5 +6926,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_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, 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, 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, getSeoValue, 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, setSeoValue, stateNamesIn, stripSuppressedProps, styleKeyToKebab, variableAliases, variableItemsFrom, withContextSlots, wrapInBreakpointQuery, wrapInMediaQuery };
 //# sourceMappingURL=vectoriox-iox-ui.mjs.map