@vectoriox/iox-ui 4.16.2 → 4.17.0

package/fesm2022/vectoriox-iox-ui.mjs

@@ -2845,6 +2845,83 @@ function composeVirtualTraits(raw, base = raw) {
     return result;
 }
 
+/**
+ * tree-relations — framework-agnostic helpers for reasoning about a rendered node
+ * tree's structural relationships. Lives in @vectoriox/iox-ui because BOTH renderers
+ * depend on iox-ui (the engine does NOT depend on iox-builder), so the same logic
+ * drives the builder canvas AND the SSR site — no fork.
+ * See iox-ai-guidance `architecture/builder/targeted-hover-state-plan.md`.
+ */
+/** The css id a node contributes to selectors: its clone `styleId`, else its own `id`. */
+function nodeCssId(node) {
+    return node.styleId ?? node.id;
+}
+/**
+ * Path of css ids from the root down to (and including) the node whose css id === `cssId`.
+ * Returns `null` when no node matches. First match wins (depth-first, pre-order).
+ */
+function pathToCssId(nodes, cssId) {
+    for (const node of nodes) {
+        const ownId = nodeCssId(node);
+        if (ownId === cssId)
+            return [ownId];
+        if (node.children?.length) {
+            const childPath = pathToCssId(node.children, cssId);
+            if (childPath)
+                return ownId ? [ownId, ...childPath] : childPath;
+        }
+    }
+    return null;
+}
+/**
+ * The css id of the NEAREST COMMON ANCESTOR of two nodes (identified by their css ids),
+ * used to scope a `:has()` targeted-state selector so it stays repetition-safe.
+ *
+ * The result may equal `styledCssId` (the trigger sits INSIDE the styled node) or
+ * `triggerCssId` (the styled node sits inside the trigger) — both are valid scopes;
+ * `buildTargetedStateSelector` picks the right selector shape for each. Returns
+ * `undefined` only when a valid scope can't exist: an id is blank, the two ids are the
+ * same node, or they share no ancestor in `root`. Callers MUST skip emitting the rule
+ * when this is `undefined` — never emit an unscoped (page-global) `:has()`, which would
+ * break under repetition.
+ */
+function nearestCommonAncestorId(root, styledCssId, triggerCssId) {
+    if (!styledCssId || !triggerCssId || styledCssId === triggerCssId)
+        return undefined;
+    const styledPath = pathToCssId(root, styledCssId);
+    const triggerPath = pathToCssId(root, triggerCssId);
+    if (!styledPath || !triggerPath)
+        return undefined;
+    // Walk both paths together; the last shared prefix element is the common ancestor.
+    let common;
+    const shorter = Math.min(styledPath.length, triggerPath.length);
+    for (let i = 0; i < shorter; i++) {
+        if (styledPath[i] !== triggerPath[i])
+            break;
+        common = styledPath[i];
+    }
+    return common;
+}
+/**
+ * Build the selector BODY (no leading `.`, matching the builder's `compile()` convention)
+ * for a targeted state, given the resolved scope. Three topologies, one shared rule:
+ *
+ *   - trigger INSIDE styled  (scope === styled):  `iox-node-{styled}:has(.iox-node-{trigger}:{base})`
+ *   - styled INSIDE trigger  (scope === trigger): `iox-node-{trigger}:{base} .iox-node-{styled}`
+ *   - separate subtrees      (scope is above both): `iox-node-{scope}:has(.iox-node-{trigger}:{base}) .iox-node-{styled}`
+ *
+ * `scopeCssId` MUST be a value returned by `nearestCommonAncestorId` for the same pair.
+ */
+function buildTargetedStateSelector(scopeCssId, triggerCssId, styledCssId, base) {
+    if (scopeCssId === styledCssId) {
+        return `iox-node-${styledCssId}:has(.iox-node-${triggerCssId}:${base})`;
+    }
+    if (scopeCssId === triggerCssId) {
+        return `iox-node-${triggerCssId}:${base} .iox-node-${styledCssId}`;
+    }
+    return `iox-node-${scopeCssId}:has(.iox-node-${triggerCssId}:${base}) .iox-node-${styledCssId}`;
+}
+
 /**
  * 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
@@ -3550,5 +3627,5 @@ function effectiveTransitionId(anim) {
  * Generated bundle index. Do not edit.
  */
 
-export { AOSService, AnalyticsService, BuilderButtonComponent, BuilderDividerComponent, BuilderHeadingComponent, BuilderIconComponent, BuilderImageComponent, BuilderLinkComponent, BuilderSpacerComponent, ButtonBlockComponent, CMSClientInfraModule, CardComponent, ClientGalleryComponent, ClientListComponent, ClientListItemComponent, ClientRepeaterComponent, ClientSliderContainerComponent, ClientSliderSlideComponent, ComponentInstanceRegistryService, ConsentService, ContainerComponent, ContentService, DEFAULT_GALLERY_SCHEDULER, DEFAULT_PAGE_TRANSITION, DEFAULT_PAGE_TRANSITION_DURATION, DEFAULT_PAGE_TRANSITION_EASING, DEFAULT_PAGE_TRANSITION_PERSPECTIVE, DEFAULT_WIDTH_BY_TYPE, ENVIRONMENT, GALLERY_EFFECTS, GALLERY_EFFECT_DESCRIPTORS, GalleryLoop, IOX_BUILDER_EVENTS, IS_PREVIEW, IoxAnimateContainer, IoxAosDirective, IoxAosModule, IoxBuilderComponentsModule, IoxComponentRegistryService, IoxPageComponent, IoxPageModule, IoxUiModule, LinkedContainerComponent, PAGE_TRANSITION_CATEGORIES, PAGE_TRANSITION_PRESETS, PIPE_DESCRIPTORS, PIPE_REGISTRY, PageScrollProvider, PrivacyModalComponent, PrivacyModalService, PrivacyModelEvent, RESERVED_ALIAS_PREFIX, SUPPRESSED_STYLE_PROPS_BY_TYPE, SectionComponent, TRANSITION_FEELS, TextBlockComponent, VIRTUAL_TRAIT_KEYS, ViewPositionDirective, ViewPositionModule, WebSettingsService, applyBindingPipes, applyFeel, buildDataSourceFilter, buildRelatedFilter, buildTransitionTimeline, collectReferencedAliases, compileDeclarations, composeVirtualTraits, computeRelative, dataSourcePlanToRequest, effectiveTransitionId, excludeSelf, feelFor, getByPath, isReservedAlias, legacyEnterToTransition, matchRouteParams, normalizeCollectionResult, parseUrlList, planDataSource, referencedDataSources, referencedDataSourcesDeep, renderDefaultDeclarations, resolveDerivedInto, resolveGalleryEffect, resolveGalleryUrls, resolvePageTransition, resolveRelativeInto, resolveRepeaterItems, resolveSiblings, resolveSingleItemId, rewriteViewportUnits, stripSuppressedProps, styleKeyToKebab };
+export { AOSService, AnalyticsService, BuilderButtonComponent, BuilderDividerComponent, BuilderHeadingComponent, BuilderIconComponent, BuilderImageComponent, BuilderLinkComponent, BuilderSpacerComponent, ButtonBlockComponent, CMSClientInfraModule, CardComponent, ClientGalleryComponent, ClientListComponent, ClientListItemComponent, ClientRepeaterComponent, ClientSliderContainerComponent, ClientSliderSlideComponent, ComponentInstanceRegistryService, ConsentService, ContainerComponent, ContentService, DEFAULT_GALLERY_SCHEDULER, DEFAULT_PAGE_TRANSITION, DEFAULT_PAGE_TRANSITION_DURATION, DEFAULT_PAGE_TRANSITION_EASING, DEFAULT_PAGE_TRANSITION_PERSPECTIVE, DEFAULT_WIDTH_BY_TYPE, ENVIRONMENT, GALLERY_EFFECTS, GALLERY_EFFECT_DESCRIPTORS, GalleryLoop, IOX_BUILDER_EVENTS, IS_PREVIEW, IoxAnimateContainer, IoxAosDirective, IoxAosModule, IoxBuilderComponentsModule, IoxComponentRegistryService, IoxPageComponent, IoxPageModule, IoxUiModule, LinkedContainerComponent, PAGE_TRANSITION_CATEGORIES, PAGE_TRANSITION_PRESETS, PIPE_DESCRIPTORS, PIPE_REGISTRY, PageScrollProvider, PrivacyModalComponent, PrivacyModalService, PrivacyModelEvent, RESERVED_ALIAS_PREFIX, SUPPRESSED_STYLE_PROPS_BY_TYPE, SectionComponent, TRANSITION_FEELS, TextBlockComponent, VIRTUAL_TRAIT_KEYS, ViewPositionDirective, ViewPositionModule, WebSettingsService, applyBindingPipes, applyFeel, buildDataSourceFilter, buildRelatedFilter, buildTargetedStateSelector, buildTransitionTimeline, collectReferencedAliases, compileDeclarations, composeVirtualTraits, computeRelative, dataSourcePlanToRequest, effectiveTransitionId, excludeSelf, feelFor, getByPath, isReservedAlias, legacyEnterToTransition, matchRouteParams, nearestCommonAncestorId, nodeCssId, normalizeCollectionResult, parseUrlList, planDataSource, referencedDataSources, referencedDataSourcesDeep, renderDefaultDeclarations, resolveDerivedInto, resolveGalleryEffect, resolveGalleryUrls, resolvePageTransition, resolveRelativeInto, resolveRepeaterItems, resolveSiblings, resolveSingleItemId, rewriteViewportUnits, stripSuppressedProps, styleKeyToKebab };
 //# sourceMappingURL=vectoriox-iox-ui.mjs.map