@vectoriox/iox-builder 2.3.3 → 2.4.0

package/fesm2022/vectoriox-iox-builder.mjs

@@ -17,10 +17,10 @@ import { SelectModule } from 'primeng/select';
 import { TooltipModule } from 'primeng/tooltip';
 import { DialogModule } from 'primeng/dialog';
 import * as i16 from '@vectoriox/iox-ui';
-import { ComponentInstanceRegistryService, DEFAULT_WIDTH_BY_TYPE, compileDeclarations, composeVirtualTraits, IS_PREVIEW, planDataSource, dataSourcePlanToRequest, normalizeCollectionResult, resolveRepeaterItems, getByPath, IoxPageModule } from '@vectoriox/iox-ui';
+import { ComponentInstanceRegistryService, DEFAULT_WIDTH_BY_TYPE, compileDeclarations, composeVirtualTraits, IS_PREVIEW, planDataSource, dataSourcePlanToRequest, normalizeCollectionResult, resolveRepeaterItems, getByPath, computeRelative, IoxPageModule } from '@vectoriox/iox-ui';
 export { ComponentInstanceRegistryService, VIRTUAL_TRAIT_KEYS, composeVirtualTraits } from '@vectoriox/iox-ui';
 import Lenis from 'lenis';
-import { Subject, BehaviorSubject, of } from 'rxjs';
+import { Subject, BehaviorSubject, of, forkJoin } from 'rxjs';
 import interact from 'interactjs';
 import Moveable from 'moveable';
 import Selecto from 'selecto';
@@ -1897,6 +1897,10 @@ var DataSourceType;
     /** A VIEW into another variable: `{ from: <alias>, path }` (e.g. galleryImages = product.gallery).
      *  Resolves to the value one (or more) level(s) into a parent variable — page-scoped. */
     DataSourceType["Derived"] = "derived";
+    /** A ROUTE-CONTEXT value derived from the current route item — `$route`/`$current`/`$siblings`/
+     *  `$related`. Not fetched: computed by the shared `computeRelative` from other resolved sources.
+     *  See relative-data-sources-plan.md. */
+    DataSourceType["Relative"] = "relative";
 })(DataSourceType || (DataSourceType = {}));
 /**
  * Maps each action type to its logical inverse for auto-populating toggle
@@ -2395,6 +2399,39 @@ function arraySchemaFields(properties) {
     }
     return out;
 }
+/**
+ * Describe the ITEM shape of an array PROPERTY, straight from the schema — the authoritative source
+ * (a resolved sample may be missing, or ambiguous). Given a resource's schema `properties` and the
+ * dot-path to an array field (e.g. `gallery` or `info.items`):
+ *   - **object item** → its primitive leaf fields (flattened): `[{label:'url',value:'url'}, …]`.
+ *   - **primitive item** (`string[]`/`number[]`) → `isPrimitive:true` (caller offers "(the item value)").
+ *   - **can't tell** (many-relation whose items are related docs, or path not found) → both empty, so
+ *     the caller falls back to a resolved sample.
+ * JSON-schema arrays store the item schema under `.items`; embedded objects under `.properties`.
+ */
+function arrayItemSchemaFields(properties, arrayPath) {
+    const parts = (arrayPath ?? '').split('.').filter(Boolean);
+    let field = undefined;
+    let cursor = properties ?? {};
+    for (const part of parts) {
+        field = cursor?.[part];
+        if (!field)
+            return { fields: [], isPrimitive: false };
+        cursor = field.properties ?? field.items?.properties ?? {};
+    }
+    if (!field)
+        return { fields: [], isPrimitive: false };
+    const itemProps = field.items?.properties ?? (field.type === 'embedded' ? field.properties : undefined);
+    if (itemProps && Object.keys(itemProps).length) {
+        return { fields: flattenSchemaFields(itemProps), isPrimitive: false };
+    }
+    // Many-relation: items are related documents — needs the related schema, so let the caller sample.
+    const relType = (field.rel?.type ?? '').toString().toLowerCase();
+    if (field.type === 'rel' || relType.includes('many'))
+        return { fields: [], isPrimitive: false };
+    // Otherwise a primitive-item array (string[]/number[]/…): the item is bound as its own value.
+    return { fields: [], isPrimitive: true };
+}
 
 /**
  * StyleRegistryService — manages a single <style> tag for the builder canvas.
@@ -5714,8 +5751,14 @@ class BuilderDataSourceService {
     }
     /**
      * Resolve a data source BY ALIAS, following `derived` aliases (a VIEW into another variable:
-     * resolve the parent, then getByPath). `findByAlias` is injected so this module stays registry-free
-     * (the caller passes its own page-scoped registry). Recurses for chained derived aliases.
+     * resolve the parent, then getByPath) and `relative` aliases (route-context — `$current`/
+     * `$siblings`/`$related`). `findByAlias` is injected so this module stays registry-free (the caller
+     * passes its own page-scoped registry). Recurses for chained aliases.
+     *
+     * The builder is design time: `relative` sources resolve their dependency aliases (subject +
+     * collection) — a single source falls back to its `defaultId`, a list to the whole collection —
+     * then run the SHARED `computeRelative`, so the canvas shows the SAME neighbours the SSR engine
+     * bakes into the live page. `$route` has no live params at design time → `{}`.
      */
     fetchByAlias(alias, findByAlias) {
         const ds = findByAlias(alias);
@@ -5727,6 +5770,19 @@ class BuilderDataSourceService {
                 return of(null);
             return this.fetchByAlias(d.from, findByAlias).pipe(map(parent => getByPath(parent, d.path ?? '')));
         }
+        if (ds.type === 'relative') {
+            const spec = ds.request?.relative;
+            if (!spec)
+                return of(null);
+            if (spec.kind === 'route')
+                return of({});
+            const subjectAlias = spec.kind === 'current' ? spec.from : (spec.subjectFrom ?? spec.from);
+            const needsCollection = spec.kind === 'siblings' || spec.kind === 'related';
+            return forkJoin({
+                subject: subjectAlias ? this.fetchByAlias(subjectAlias, findByAlias) : of(undefined),
+                collection: needsCollection && spec.from ? this.fetchByAlias(spec.from, findByAlias) : of(undefined),
+            }).pipe(map(({ subject, collection }) => computeRelative(spec, { subject, collection, routeParams: {} })));
+        }
         return this.fetch(ds);
     }
     /** Repeater items for an alias (follows derived aliases + applies an optional sourcePath). */
@@ -8143,5 +8199,5 @@ class BuilderSpacerComponentConfig extends ComponentConfig {
  * Generated bundle index. Do not edit.
  */
 
-export { ACTION_TYPE_OPTIONS, BackgroundGroupStyleConfig, BorderGroupStyleConfig, BuilderButtonBlockComponent, BuilderButtonComponentConfig, BuilderClipboardService, BuilderComponent, BuilderContainerComponent, BuilderContainerComponentConfig, BuilderDataSourceService, BuilderDividerComponentConfig, BuilderHeadingComponentConfig, BuilderHistoryService, BuilderIconComponentConfig, BuilderImageComponentConfig, BuilderLinkComponentConfig, BuilderLinkedContainerComponent, BuilderLinkedContainerConfig, BuilderListComponentConfig, BuilderListItemComponentConfig, BuilderMode, BuilderRepeaterComponent, BuilderSpacerComponentConfig, ButtonBlockComponentConfig, CardComponentConfig, ComponentConfig, ComponentRegistryService, DEVICE_OPTIONS, DataSourceRegistryService, DataSourceType, DeviceMode, DimensionsGroupStyleConfig, DragEngineService, EASING_OPTIONS, EffectsGroupStyleConfig, GroupStyleConfig, INTERACTION_STATES, INVERSE_ACTION, IOX_DATA_SOURCE_ENDPOINTS, IOX_FONT_MANAGER, InteractionEngineService, InteractionPresetRegistryService, InteractionsPanelComponent, IoxBuilderModule, IoxDraggableDirective, IoxDropzoneDirective, LayerTreeComponent, LayoutGroupStyleConfig, ListGroupStyleConfig, NodeAction, OverlayComponent, OverlayService, PanelChildComponent, PanelComponent, PanelEventService, PanelEventTypes, PanelTypes, PositionGroupStyleConfig, PresetRegistryService, RELATIONAL_STATES, RELATIONAL_STATE_BASE, ROUTE_ANIMATION_OPTIONS, RenderDirective, RepeaterComponentConfig, SCREEN_WIDTH_OPTIONS, STRUCTURAL_STATES, SUPPORTED_STATES, SectionComponent, SectionComponentConfig, SizeGroupStyleConfig, SliderContainerComponent, SliderContainerConfig, SliderSlideComponent, SliderSlideConfig, SpacingGroupStyleConfig, StyleCategory, StyleRegistryService, TraitConfig as StyleTraitConfig, SymbolRegistryService, TRIGGER_OPTIONS, TextBlockComponentConfig, ToolbarAction, ToolbarComponent, TraitConfig, TraitInputType, TypographyGroupStyleConfig, UNITS_ALL, UNITS_DEG, UNITS_FIXED, UNITS_NO_VW, ViewportService, ZOOM_OPTIONS, arraySchemaFields, buildFullStyleTraits, buildPresetStyleTraits, defaultPageSettings, flattenSchemaFields, generateNodeId, resolveTraitControllerType, resolveTraitOptions };
+export { ACTION_TYPE_OPTIONS, BackgroundGroupStyleConfig, BorderGroupStyleConfig, BuilderButtonBlockComponent, BuilderButtonComponentConfig, BuilderClipboardService, BuilderComponent, BuilderContainerComponent, BuilderContainerComponentConfig, BuilderDataSourceService, BuilderDividerComponentConfig, BuilderHeadingComponentConfig, BuilderHistoryService, BuilderIconComponentConfig, BuilderImageComponentConfig, BuilderLinkComponentConfig, BuilderLinkedContainerComponent, BuilderLinkedContainerConfig, BuilderListComponentConfig, BuilderListItemComponentConfig, BuilderMode, BuilderRepeaterComponent, BuilderSpacerComponentConfig, ButtonBlockComponentConfig, CardComponentConfig, ComponentConfig, ComponentRegistryService, DEVICE_OPTIONS, DataSourceRegistryService, DataSourceType, DeviceMode, DimensionsGroupStyleConfig, DragEngineService, EASING_OPTIONS, EffectsGroupStyleConfig, GroupStyleConfig, INTERACTION_STATES, INVERSE_ACTION, IOX_DATA_SOURCE_ENDPOINTS, IOX_FONT_MANAGER, InteractionEngineService, InteractionPresetRegistryService, InteractionsPanelComponent, IoxBuilderModule, IoxDraggableDirective, IoxDropzoneDirective, LayerTreeComponent, LayoutGroupStyleConfig, ListGroupStyleConfig, NodeAction, OverlayComponent, OverlayService, PanelChildComponent, PanelComponent, PanelEventService, PanelEventTypes, PanelTypes, PositionGroupStyleConfig, PresetRegistryService, RELATIONAL_STATES, RELATIONAL_STATE_BASE, ROUTE_ANIMATION_OPTIONS, RenderDirective, RepeaterComponentConfig, SCREEN_WIDTH_OPTIONS, STRUCTURAL_STATES, SUPPORTED_STATES, SectionComponent, SectionComponentConfig, SizeGroupStyleConfig, SliderContainerComponent, SliderContainerConfig, SliderSlideComponent, SliderSlideConfig, SpacingGroupStyleConfig, StyleCategory, StyleRegistryService, TraitConfig as StyleTraitConfig, SymbolRegistryService, TRIGGER_OPTIONS, TextBlockComponentConfig, ToolbarAction, ToolbarComponent, TraitConfig, TraitInputType, TypographyGroupStyleConfig, UNITS_ALL, UNITS_DEG, UNITS_FIXED, UNITS_NO_VW, ViewportService, ZOOM_OPTIONS, arrayItemSchemaFields, arraySchemaFields, buildFullStyleTraits, buildPresetStyleTraits, defaultPageSettings, flattenSchemaFields, generateNodeId, resolveTraitControllerType, resolveTraitOptions };
 //# sourceMappingURL=vectoriox-iox-builder.mjs.map