@vectoriox/iox-ui 4.39.0 → 4.41.0

package/fesm2022/vectoriox-iox-ui.mjs

@@ -5162,6 +5162,88 @@ function buildTargetedStateSelector(scopeCssId, triggerCssId, styledCssId, base)
     return `iox-node-${scopeCssId}:has(.iox-node-${triggerCssId}:${base}) .iox-node-${styledCssId}`;
 }
 
+/**
+ * parts — the failure design (forms-and-inputs-plan.md Part 2, board 7). A compound component
+ * like Field is not one styleable surface: its label, control, help text, error message and
+ * required mark are each their own descendant, addressed by a stable class the component itself
+ * renders (`IoxFieldComponent`'s `iox-field__label`/`__control`/`__help`/`__error`/`__required`).
+ *
+ * Lives in @vectoriox/iox-ui because BOTH renderers depend on iox-ui (the engine does not depend
+ * on iox-builder) — same reason `buildTargetedStateSelector` lives here. No new compiler: this
+ * builds a selector STRING, then the existing `compile()`/`compileDeclarations()` path renders it
+ * exactly like any other rule.
+ */
+/**
+ * The selector BODY (no leading `.`, matching the builder's `compile()` convention) for a node,
+ * optionally scoped to one of its parts, optionally further scoped to a validation state.
+ *
+ *   buildPartSelector('abc')                          -> 'iox-node-abc'
+ *   buildPartSelector('abc', 'iox-field__error')       -> 'iox-node-abc .iox-field__error'
+ *   buildPartSelector('abc', undefined, 'iox-invalid') -> 'iox-node-abc.iox-invalid'
+ *   buildPartSelector('abc', 'iox-field__error', 'iox-invalid')
+ *       -> 'iox-node-abc.iox-invalid .iox-field__error'
+ *
+ * The validation class always attaches to the NODE itself (that's where `IoxFieldComponent` sets
+ * `.iox-invalid`/`.iox-valid`), never to the part — a part has no host class of its own to hang a
+ * compound selector off.
+ */
+function buildPartSelector(nodeId, partClass, validationClass) {
+    const base = validationClass ? `iox-node-${nodeId}.${validationClass}` : `iox-node-${nodeId}`;
+    return partClass ? `${base} .${partClass}` : base;
+}
+
+/**
+ * page-style — the ONE compiler that turns a page's style settings into CSS.
+ *
+ * A page's background / typography is authored once (builder Page panel) and has to render
+ * in BOTH renderers: the builder canvas frame and the SSR engine's `<body>`. Before this
+ * existed the engine applied it with hand-written `body.style.x = …` assignments buried in
+ * the FONT LOADER, and the builder applied nothing at all — so every background an author
+ * set was invisible until the site was published. See
+ * iox-ai-guidance `architecture/builder/render-parity.md`.
+ *
+ * Pure and transport-agnostic on purpose: it returns CSS declarations and nothing else.
+ * Each consumer applies them its own way (engine → `document.body`, builder → the canvas
+ * viewport element). Kebab-case keys so the result works with both `el.style.setProperty`
+ * and Angular's `[ngStyle]`.
+ */
+/** Background fallback when a gradient/image type is selected but its value is empty. */
+const EMPTY_BACKGROUND = '#fff';
+/**
+ * Compile page style settings into CSS declarations.
+ *
+ * Only keys the author actually set are emitted, so a consumer's own default (the builder's
+ * white canvas, the engine's stylesheet) shows through untouched when a page says nothing.
+ *
+ * `backgroundType` selects which background field wins — it is derived from the author's
+ * colour/image choice rather than picked directly (see the builder's page-background.util).
+ */
+function compilePageStyle(style) {
+    if (!style)
+        return {};
+    const css = {};
+    if (style.fontFamily)
+        css['font-family'] = style.fontFamily;
+    if (style.textColor)
+        css['color'] = style.textColor;
+    switch (style.backgroundType) {
+        case 'gradient':
+            css['background'] = style.backgroundGradient || EMPTY_BACKGROUND;
+            break;
+        case 'image':
+            css['background'] = style.backgroundImage
+                ? `url(${style.backgroundImage}) center/cover no-repeat`
+                : EMPTY_BACKGROUND;
+            break;
+        default:
+            // 'solid' and legacy pages with no type at all.
+            if (style.backgroundColor)
+                css['background-color'] = style.backgroundColor;
+            break;
+    }
+    return css;
+}
+
 /**
  * Shared RELATIVE (route-context) data resolving — the SINGLE source of truth for how a detail page
  * derives values FROM its current route item, consumed by BOTH the page builder (iox-cms-client) and
@@ -6947,5 +7029,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, 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 };
+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, buildPartSelector, buildRelatedFilter, buildSwiperBreakpoints, buildTargetedStateSelector, buildTransitionTimeline, cascadeChain, clearInputOverride, clearOverride, collectContextSlotKeys, collectReferencedAliases, compileDeclarations, compilePageStyle, 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