@vectoriox/iox-ui 5.42.0 → 5.44.0

package/fesm2022/vectoriox-iox-ui-data-core.mjs

@@ -0,0 +1,491 @@
+/**
+ * Shared data-source resolving pattern — the SINGLE source of truth for how an IoxDataSource
+ * becomes a backend fetch, consumed by BOTH the page builder (iox-cms-client bindings panel) and
+ * the SSR client engine (iox-client-engine DataSourceResolverService). There must be no second
+ * copy of this decision logic; only the transport differs between the two:
+ *
+ *   builder → authenticated org-scoped controllers (admin session):
+ *              single by id → GET admin.../resources/:type/:id   (ContentService.getContentById)
+ *              collection    → GET admin.../resources/:type        (ContentService.getContent)
+ *   engine  → @Public() controllers (no auth, isPublished filter applied server-side):
+ *              single by id → GET api/:type/:id                    (UserResourcesController)
+ *              collection    → GET api/:type?filters                (UserResourcesController)
+ *
+ * The DECISION (by-id vs collection, which id, which filters, how to pick the single result) is
+ * identical for both — that's what this module owns. Each app maps the returned {@link DataSourcePlan}
+ * onto its own transport. A single item is ALWAYS fetched by its id as a path segment — never a
+ * `?_id=` query — to match the builder's getContentById.
+ */
+/** The order a query source returns its rows in (CC2, board 4 "Sort" — the data source popover). */
+var DataSourceSortDir;
+(function (DataSourceSortDir) {
+    DataSourceSortDir["Asc"] = "asc";
+    DataSourceSortDir["Desc"] = "desc";
+})(DataSourceSortDir || (DataSourceSortDir = {}));
+/** The query parameter carrying the order: `sort=order` ascending, `sort=-order` descending. A CONTROL like
+ *  `limit`, not a field filter — the public controllers split it out (iox-cms `query-controls.ts`). */
+const SORT_PARAM = 'sort';
+const SORT_FIELD = /^[A-Za-z_][A-Za-z0-9_]*(\.[A-Za-z_][A-Za-z0-9_]*)*$/;
+/** `sort`'s wire value, or null when the source sets no (valid) order. */
+function sortParamValue(sort) {
+    const field = sort?.field?.trim();
+    if (!field || !SORT_FIELD.test(field))
+        return null;
+    return sort?.dir === DataSourceSortDir.Desc ? `-${field}` : field;
+}
+/**
+ * Match a page route template against an actual path and extract named params.
+ *   matchRouteParams('/project/:projectId', 'project/68abc') → { projectId: '68abc' }
+ * Both sides are normalised (leading slash stripped) and split on '/'; values are URL-decoded.
+ */
+function matchRouteParams(template, actual) {
+    const t = (template ?? '').replace(/^\/+/, '').split('/');
+    const a = (actual ?? '').replace(/^\/+/, '').split('/');
+    const params = {};
+    for (let i = 0; i < t.length; i++) {
+        const seg = t[i];
+        if (seg && seg.startsWith(':'))
+            params[seg.slice(1)] = decodeURIComponent(a[i] ?? '');
+    }
+    return params;
+}
+/**
+ * Build the query filter for a data-source request from its filterByRouteParam / filterByQueryParams
+ * config. `field` is filtered by the route-param value (falling back to `defaultId`); query filters
+ * map each `field` to a query-param value (falling back to `defaultValue`), and a filter with NO
+ * `queryParam` is a constant on `defaultValue`. Empty values are omitted so the source isn't
+ * accidentally filtered to nothing.
+ */
+function buildDataSourceFilter(req, routeParams = {}, queryParams = {}) {
+    const params = {};
+    const byRoute = req?.filterByRouteParam;
+    if (byRoute?.field && byRoute?.routeParam) {
+        const value = routeParams[byRoute.routeParam] ?? byRoute.defaultId;
+        if (value !== undefined && value !== null && value !== '')
+            params[byRoute.field] = value;
+    }
+    for (const q of req?.filterByQueryParams ?? []) {
+        if (!q?.field)
+            continue;
+        // No queryParam → a CONSTANT filter: defaultValue is the value, in the builder preview and
+        // on the live site alike. With a queryParam the URL wins and defaultValue is the fallback.
+        const value = q.queryParam ? (queryParams[q.queryParam] ?? q.defaultValue) : q.defaultValue;
+        if (value !== undefined && value !== null && value !== '')
+            params[q.field] = value;
+    }
+    return params;
+}
+/**
+ * Mirrors the builder's getContentById decision. When a SINGLE source is filtered by the item id
+ * (`_id`) via a route param, the item is fetched by PATH (`.../:type/:id`), not a `?_id=` query.
+ * Returns that id (route-param value, else `defaultId`), or `null` when the source isn't a
+ * single-by-id fetch — in which case the caller uses the collection endpoint + filters. The
+ * path-based form only applies to the id field; a single source filtered by any other field still
+ * goes through the collection endpoint.
+ */
+function resolveSingleItemId(req, routeParams = {}) {
+    const byRoute = req?.filterByRouteParam;
+    if (!byRoute?.routeParam)
+        return null;
+    if (byRoute.field && byRoute.field !== '_id')
+        return null;
+    const value = routeParams[byRoute.routeParam] ?? byRoute.defaultId;
+    return value !== undefined && value !== null && value !== '' ? String(value) : null;
+}
+/**
+ * Resolve an IoxDataSource into a transport-agnostic {@link DataSourcePlan}. This is the shared
+ * decision both the builder and the SSR engine run; each then executes the plan with its own
+ * HTTP layer. Single sources with a route-param id resolve to a `by-id` (path) fetch — exactly like
+ * the builder's getContentById.
+ */
+function planDataSource(ds, routeParams = {}, queryParams = {}) {
+    const mode = ds?.mode === 'single' ? 'single' : 'list';
+    switch (ds?.type) {
+        case 'cms':
+        case 'shop': {
+            const domain = ds.type;
+            const req = domain === 'cms' ? ds.request?.cms : ds.request?.shop;
+            const resource = req?.contentType;
+            if (!resource)
+                return { kind: 'none' };
+            const id = mode === 'single' ? resolveSingleItemId(req, routeParams) : null;
+            if (id)
+                return { kind: 'by-id', domain, resource, id, mode };
+            const filter = buildDataSourceFilter(req, routeParams, queryParams);
+            const plan = { kind: 'collection', domain, resource, filter, mode };
+            if (req?.limit)
+                plan.limit = req.limit;
+            const sort = sortParamValue(req?.sort);
+            if (sort)
+                plan.sort = sort;
+            return plan;
+        }
+        case 'external-api': {
+            const endpoint = ds.request?.endpoint;
+            return endpoint ? { kind: 'external', endpoint, mode } : { kind: 'none' };
+        }
+        case 'static':
+            return { kind: 'static', data: ds.request?.data ?? null, mode };
+        case 'derived': {
+            const d = ds.request?.derived;
+            return d?.from ? { kind: 'derived', from: d.from, path: d.path ?? '', mode } : { kind: 'none' };
+        }
+        case 'variable':
+            // A VARIABLE is a page-local resource whose value is WRITTEN at runtime by an interaction
+            // (setContext), never fetched. It resolves to nothing here on purpose: the page renders
+            // its empty state until something writes it. `request.variable.itemsFrom` only names the
+            // source whose items it holds, so the bind picker can suggest fields.
+            return { kind: 'none' };
+        default:
+            return { kind: 'none' };
+    }
+}
+/**
+ * The aliases on a page that are VARIABLES — runtime-written resources, not fetched data.
+ *
+ * Shared so the builder and the SSR engine agree on which aliases start empty and are filled by
+ * interactions. See element-context-state-plan.md.
+ */
+function variableAliases(dataSources) {
+    const out = new Set();
+    for (const ds of dataSources ?? []) {
+        if (ds?.type === 'variable' && ds.alias)
+            out.add(ds.alias);
+    }
+    return out;
+}
+/** The source alias whose items a variable holds, if it declares one (for field suggestions). */
+function variableItemsFrom(dataSources, alias) {
+    for (const ds of dataSources ?? []) {
+        if (ds?.type === 'variable' && ds.alias === alias)
+            return ds.request?.variable?.itemsFrom || undefined;
+    }
+    return undefined;
+}
+/**
+ * Normalise a collection response into the shape a source expects: unwraps `{items}`/`{data}`
+ * envelopes, then returns the first item for a `single` source or the whole array for a `list`.
+ * A `by-id` response is already the item, so callers pass it through unchanged.
+ */
+function normalizeCollectionResult(mode, data) {
+    const items = Array.isArray(data) ? data : (data?.items ?? data?.data ?? []);
+    return mode === 'single' ? (items[0] ?? null) : items;
+}
+/** Navigate a dot/bracket path into an object, e.g. `gallery`, `details.images`, `variants[0].skus`.
+ *  Returns undefined if any segment is missing. Kept minimal + self-contained so it is shareable by
+ *  both the builder and the SSR engine (the two have divergent local `resolvePath` copies). */
+function getByPath(obj, path) {
+    if (obj == null || !path)
+        return obj;
+    // Turn `a[0].b` into ['a','0','b'].
+    const segments = path.replace(/\[(\w+)\]/g, '.$1').split('.').filter(Boolean);
+    let cur = obj;
+    for (const seg of segments) {
+        if (cur == null)
+            return undefined;
+        cur = cur[seg];
+    }
+    return cur;
+}
+/**
+ * The array a Repeater (or a repeating Slider) iterates over — the SHARED decision so the builder
+ * canvas and the SSR engine agree (see data-source-resolving.md).
+ * - No `sourcePath`: the resolved source IS the list. An array passes through; a lone object degrades
+ *   to a single-row list (back-compat with the old `fetchItems`); null/undefined → `[]`.
+ * - With `sourcePath`: the source resolved to a SINGLE resource (e.g. a product); dive into the
+ *   nested array property (e.g. `gallery`). Non-array / missing → `[]`.
+ */
+/**
+ * Fill in `derived` aliases in an already-resolved map. Given the data sources and a map of resolved
+ * NON-derived values (by alias), compute each `type:'derived'` alias as `getByPath(parent, path)` in
+ * dependency order (chains resolved by iterating until stable). Mutates + returns the map. Used by the
+ * SSR engine after it resolves the root sources; the builder resolves derived lazily per alias.
+ */
+function resolveDerivedInto(dataSources, resolved) {
+    const derived = (dataSources ?? []).filter(d => d?.type === 'derived' && !!d.alias);
+    let changed = true, guard = 0;
+    while (changed && guard++ < 25) {
+        changed = false;
+        for (const d of derived) {
+            if (d.alias in resolved)
+                continue;
+            const from = d.request?.derived?.from;
+            if (from && from in resolved) {
+                resolved[d.alias] = getByPath(resolved[from], d.request.derived.path ?? '');
+                changed = true;
+            }
+        }
+    }
+    return resolved;
+}
+function resolveRepeaterItems(resolved, sourcePath) {
+    if (sourcePath) {
+        const nested = getByPath(resolved, sourcePath);
+        return Array.isArray(nested) ? nested : [];
+    }
+    if (Array.isArray(resolved))
+        return resolved;
+    return resolved == null ? [] : [resolved];
+}
+// ── Referenced data sources (shared: builder-save + SSR resolve) ─────────────────────────────────
+// Which data-source aliases a node tree uses, so a consumer resolves ONLY what a page/global needs
+// (not the whole org library). Used by cms-client (persist globals' sources) and the SSR engine
+// (resolve the referenced subset per page). See org-data-sources-plan.md.
+/** Aliases referenced anywhere in a node tree: a repeater/slider `source` (a `bindings` entry with
+ *  `prop === 'source'`, or `props.source` for the slider) plus every binding's `source`. */
+function collectReferencedAliases(nodes, acc = new Set()) {
+    for (const n of nodes ?? []) {
+        for (const b of n?.bindings ?? []) {
+            if (b?.source)
+                acc.add(b.source);
+        }
+        if (n?.props?.source)
+            acc.add(n.props.source);
+        if (n?.children?.length)
+            collectReferencedAliases(n.children, acc);
+    }
+    return acc;
+}
+/** The subset of `all` whose `alias` is referenced by `nodes` (shallow — direct references only). */
+function referencedDataSources(nodes, all) {
+    const aliases = collectReferencedAliases(nodes);
+    return (all ?? []).filter(ds => aliases.has(ds?.alias));
+}
+/** Like `referencedDataSources`, but also pulls in a referenced source's DEPENDENCIES (transitively),
+ *  none of which the layout names directly:
+ *   - a `derived` alias needs its `request.derived.from` parent;
+ *   - a `relative` (route-context) alias needs its `request.relative.subjectFrom` (the current item)
+ *     and `request.relative.from` (the collection it navigates).
+ *  Use this when RESOLVING (the engine) so derived views and siblings/related don't resolve to nothing. */
+function referencedDataSourcesDeep(nodes, all) {
+    const byAlias = new Map((all ?? []).map(d => [d?.alias, d]));
+    const wanted = collectReferencedAliases(nodes);
+    const queue = [...wanted];
+    const enqueue = (alias) => {
+        if (alias && !wanted.has(alias)) {
+            wanted.add(alias);
+            queue.push(alias);
+        }
+    };
+    while (queue.length) {
+        const ds = byAlias.get(queue.pop());
+        enqueue(ds?.request?.derived?.from);
+        enqueue(ds?.request?.relative?.subjectFrom);
+        enqueue(ds?.request?.relative?.from);
+    }
+    return (all ?? []).filter(d => wanted.has(d?.alias));
+}
+/**
+ * Turn a resolved {@link DataSourcePlan} into the concrete public HTTP request (url + params) — the
+ * SINGLE place that decides the URL shape, shared by the builder binding preview and the SSR engine
+ * so both hit the SAME public endpoints (no admin, no duplication). Returns `null` for `static` /
+ * `none` plans (no HTTP call). A single item is a PATH segment (`/:resource/:id`), never `?_id=`.
+ */
+function dataSourcePlanToRequest(plan, endpoints) {
+    const baseFor = (domain) => (domain === 'shop' ? endpoints.shopBase : endpoints.cmsBase);
+    switch (plan.kind) {
+        case 'by-id':
+            return { url: `${baseFor(plan.domain)}${plan.resource}/${encodeURIComponent(plan.id)}`, params: {} };
+        case 'collection': {
+            const params = { ...plan.filter };
+            if (plan.limit)
+                params['limit'] = plan.limit;
+            if (plan.sort)
+                params[SORT_PARAM] = plan.sort;
+            return { url: `${baseFor(plan.domain)}${plan.resource}`, params };
+        }
+        case 'external':
+            return { url: plan.endpoint, params: {} };
+        default:
+            return null;
+    }
+}
+
+/**
+ * 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
+ * the SSR client engine (iox-client-engine). Companion to `data-source-resolver.ts`.
+ *
+ * These are the pure, transport-agnostic pieces behind the Route binding scope
+ * (`$route` / `$current` / `$siblings` / `$related`). Resolution is a DEPENDENT SECOND PASS: the
+ * consumer resolves `$current` first (the existing single by-id fetch via `planDataSource`), then
+ * calls these to derive the relative values — there is NO new `DataSourcePlan` kind (`$related` still
+ * feeds a normal `collection` plan built from {@link buildRelatedFilter}). See
+ * `architecture/builder/relative-data-sources-plan.md`.
+ *
+ * There must be no second copy of this decision logic; only the transport (which HTTP layer fetches
+ * the ordered collection / related list) differs between the two consumers.
+ */
+/** Aliases in the Route scope are platform-owned and start with this prefix; a USER alias may never
+ *  start with it, which keeps the Route scope structurally collision-proof with Local/Global. Used to
+ *  validate new/renamed aliases and to render the reserved (read-only) item state in the bind picker. */
+const RESERVED_ALIAS_PREFIX = '$';
+/** True for a platform-owned Route-scope alias (`$route`, `$current`, `$siblings`, `$related`, …). */
+function isReservedAlias(alias) {
+    return typeof alias === 'string' && alias.startsWith(RESERVED_ALIAS_PREFIX);
+}
+const EMPTY_SIBLINGS = { prev: null, next: null, index: -1, count: 0, isFirst: false, isLast: false };
+/** Generic, deterministic comparator: numbers numerically, Dates by time, everything else by
+ *  locale-aware string compare (ISO date strings sort correctly this way). Nullish sorts first. */
+function compareValues(a, b) {
+    if (a == null && b == null)
+        return 0;
+    if (a == null)
+        return -1;
+    if (b == null)
+        return 1;
+    if (typeof a === 'number' && typeof b === 'number')
+        return a - b;
+    const da = a instanceof Date ? a.getTime() : NaN;
+    const db = b instanceof Date ? b.getTime() : NaN;
+    if (!isNaN(da) && !isNaN(db))
+        return da - db;
+    return String(a).localeCompare(String(b));
+}
+/**
+ * Locate the current item within an ordered set and return its neighbours + position. Pure: the input
+ * list is never mutated (sorting works on a shallow copy). `currentId` is compared to each item's
+ * `idField` via string equality (route-param values are strings). When the current id isn't found,
+ * `index` is `-1` and `prev`/`next` are `null` (but `count` still reflects the set size).
+ */
+function resolveSiblings(items, currentId, options = {}) {
+    const list = Array.isArray(items) ? items.slice() : [];
+    const count = list.length;
+    if (count === 0)
+        return { ...EMPTY_SIBLINGS };
+    const idField = options.idField ?? '_id';
+    if (options.sortBy) {
+        const dir = options.sortDir === 'desc' ? -1 : 1;
+        list.sort((a, b) => dir * compareValues(getByPath(a, options.sortBy), getByPath(b, options.sortBy)));
+    }
+    const cid = currentId == null ? null : String(currentId);
+    const index = cid == null ? -1 : list.findIndex(it => String(getByPath(it, idField)) === cid);
+    if (index === -1)
+        return { prev: null, next: null, index: -1, count, isFirst: false, isLast: false };
+    const canWrap = !!options.wrap && count > 1;
+    const prev = index > 0 ? list[index - 1] : (canWrap ? list[count - 1] : null);
+    const next = index < count - 1 ? list[index + 1] : (canWrap ? list[0] : null);
+    return { prev, next, index, count, isFirst: index === 0, isLast: index === count - 1 };
+}
+/** A value usable as an equality filter param: a non-empty scalar. Objects/arrays/nullish are skipped
+ *  so a related query isn't built from an unresolved rel object (surfaced as a config issue in the UI
+ *  rather than silently matching everything). Multi-value match is a v2 concern. */
+function isScalarFilterValue(v) {
+    if (v == null)
+        return false;
+    if (typeof v === 'string')
+        return v !== '';
+    if (typeof v === 'number')
+        return Number.isFinite(v);
+    return typeof v === 'boolean';
+}
+/**
+ * Build the collection filter for `$related` from the resolved current item: an equality match on
+ * each `matchField`'s value (e.g. same `category`). Feeds a normal `collection` plan — no new plan
+ * kind. Fields whose value is not a scalar (or is empty) are omitted, matching
+ * `buildDataSourceFilter`'s "don't over-filter" rule. Exclude-self is applied to the RESULT via
+ * {@link excludeSelf} (the public query controllers are equality-only, so it can't be a `$ne` param).
+ */
+function buildRelatedFilter(current, options) {
+    const fields = Array.isArray(options.matchFields) ? options.matchFields : [options.matchFields];
+    const filter = {};
+    for (const field of fields) {
+        if (!field)
+            continue;
+        const value = getByPath(current, field);
+        if (isScalarFilterValue(value))
+            filter[field] = value;
+    }
+    return filter;
+}
+/**
+ * Drop the current item from a list by `idField` (default `_id`). Used to exclude self from a
+ * `$related` result after fetch. A nullish/empty `currentId` leaves the list unchanged.
+ */
+function excludeSelf(items, currentId, idField = '_id') {
+    if (!Array.isArray(items))
+        return [];
+    if (currentId == null || currentId === '')
+        return items;
+    const cid = String(currentId);
+    return items.filter(it => String(getByPath(it, idField)) !== cid);
+}
+/** Resolve kinds in a fixed order so a `siblings`/`related` source may reference `$current` (or any
+ *  earlier relative alias) via `subjectFrom` and still see it resolved. */
+const KIND_ORDER = { route: 0, current: 1, siblings: 2, related: 3 };
+/** Does an item satisfy every field in an equality predicate map (string-compared)? */
+function matchesFilter(item, filter) {
+    return Object.keys(filter).every(k => String(getByPath(item, k)) === String(filter[k]));
+}
+/**
+ * Compute ONE relative source's value from its already-resolved {@link RelativeInputs} — the SHARED
+ * kind→computation decision, so the batch pass ({@link resolveRelativeInto}) and the builder's async
+ * per-alias resolver produce identical results with no forked switch. `route` → the route params;
+ * `current` → the subject; `siblings` → {@link resolveSiblings} over the collection; `related` → the
+ * collection filtered by {@link buildRelatedFilter}'s predicate (+ {@link excludeSelf}).
+ */
+function computeRelative(spec, inputs) {
+    const idField = spec.idField ?? '_id';
+    switch (spec.kind) {
+        case 'route':
+            return inputs.routeParams ?? {};
+        case 'current':
+            return inputs.subject ?? null;
+        case 'siblings': {
+            const siblings = resolveSiblings(inputs.collection, getByPath(inputs.subject, idField), {
+                idField, sortBy: spec.sortBy, sortDir: spec.sortDir, wrap: spec.wrap,
+            });
+            // `pick` resolves the source directly to that neighbour item (named-source shape,
+            // e.g. `nextProject`); without it the caller binds a sub-path of the whole object.
+            return spec.pick ? siblings[spec.pick] : siblings;
+        }
+        case 'related': {
+            const filter = buildRelatedFilter(inputs.subject, { matchFields: spec.matchFields ?? [] });
+            const pool = Array.isArray(inputs.collection) ? inputs.collection : [];
+            const items = pool.filter(it => matchesFilter(it, filter));
+            return spec.excludeSelf !== false ? excludeSelf(items, getByPath(inputs.subject, idField), idField) : items;
+        }
+        default:
+            return null;
+    }
+}
+/**
+ * Compute every `type:'relative'` source into `resolved` (keyed by alias), IN PLACE. Pure w.r.t. HTTP
+ * — it only reads already-resolved roots + the route params, so both consumers run it identically as
+ * a second pass. Delegates each source to {@link computeRelative}. `current`'s subject is `from`;
+ * `siblings`/`related` take `collection` = `from` and `subject` = `subjectFrom ?? from`. Mutates and
+ * returns `resolved`.
+ */
+function resolveRelativeInto(dataSources, resolved, routeParams = {}) {
+    const relatives = (dataSources ?? [])
+        .filter(d => d?.type === 'relative' && !!d.alias && !!d.request?.relative)
+        .sort((a, b) => KIND_ORDER[a.request.relative.kind] - KIND_ORDER[b.request.relative.kind]);
+    for (const d of relatives) {
+        const spec = d.request.relative;
+        const subjectAlias = spec.kind === 'current' ? spec.from : (spec.subjectFrom ?? spec.from);
+        resolved[d.alias] = computeRelative(spec, {
+            subject: subjectAlias ? resolved[subjectAlias] : undefined,
+            collection: spec.from ? resolved[spec.from] : undefined,
+            routeParams,
+        });
+    }
+    return resolved;
+}
+
+/**
+ * @vectoriox/iox-ui/data-core — the shared, FRAMEWORK-FREE data-source core (data-source-resolving.md): the ONE
+ * decision of how a data source becomes a fetch (`planDataSource`), the route-param matcher, the derived /
+ * relative (`$siblings`, `$related`) resolvers, the repeater item reader, and which sources a node tree
+ * references (`referencedDataSourcesDeep`). The builder and the SSR engine resolve with it; iox-cms reads it
+ * under plain Node (W2's Undo: is a data source still in use). Pure: no transport, no Angular. The main
+ * entry re-exports it by package path, so `@vectoriox/iox-ui` keeps working.
+ * ⚠️ Consumers wire the usual trio — ng-package raw-ts assets, jest moduleNameMapper, tsconfig paths —
+ * or `nest start` dies with ERR_REQUIRE_ESM while jest and build both pass.
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { DataSourceSortDir, RESERVED_ALIAS_PREFIX, SORT_PARAM, buildDataSourceFilter, buildRelatedFilter, collectReferencedAliases, computeRelative, dataSourcePlanToRequest, excludeSelf, getByPath, isReservedAlias, matchRouteParams, normalizeCollectionResult, planDataSource, referencedDataSources, referencedDataSourcesDeep, resolveDerivedInto, resolveRelativeInto, resolveRepeaterItems, resolveSiblings, resolveSingleItemId, sortParamValue, variableAliases, variableItemsFrom };
+//# sourceMappingURL=vectoriox-iox-ui-data-core.mjs.map

package/fesm2022/vectoriox-iox-ui-data-core.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"vectoriox-iox-ui-data-core.mjs","sources":["../../../projects/iox-ui/src/data-core/data-source-resolver.ts","../../../projects/iox-ui/src/data-core/relative-sources.ts","../../../projects/iox-ui/src/data-core/public-api.ts","../../../projects/iox-ui/src/data-core/vectoriox-iox-ui-data-core.ts"],"sourcesContent":["/**\n * Shared data-source resolving pattern — the SINGLE source of truth for how an IoxDataSource\n * becomes a backend fetch, consumed by BOTH the page builder (iox-cms-client bindings panel) and\n * the SSR client engine (iox-client-engine DataSourceResolverService). There must be no second\n * copy of this decision logic; only the transport differs between the two:\n *\n *   builder → authenticated org-scoped controllers (admin session):\n *              single by id → GET admin.../resources/:type/:id   (ContentService.getContentById)\n *              collection    → GET admin.../resources/:type        (ContentService.getContent)\n *   engine  → @Public() controllers (no auth, isPublished filter applied server-side):\n *              single by id → GET api/:type/:id                    (UserResourcesController)\n *              collection    → GET api/:type?filters                (UserResourcesController)\n *\n * The DECISION (by-id vs collection, which id, which filters, how to pick the single result) is\n * identical for both — that's what this module owns. Each app maps the returned {@link DataSourcePlan}\n * onto its own transport. A single item is ALWAYS fetched by its id as a path segment — never a\n * `?_id=` query — to match the builder's getContentById.\n */\n\nexport type DataSourceMode = 'single' | 'list';\nexport type DataSourceDomain = 'cms' | 'shop';\n\nexport interface DataSourceRouteFilter {\n    field?: string;\n    routeParam?: string;\n    defaultId?: string;\n}\n\nexport interface DataSourceQueryFilter {\n    field?: string;\n    /** URL query param the value is read from. OMIT for a CONSTANT filter — then `defaultValue`\n     *  alone is the value, so `isReviewShow=true` filters identically in preview and on the site. */\n    queryParam?: string;\n    /** Value used when the query param is absent — i.e. always, for a constant filter, and in the\n     *  builder preview, where there are no live query params. NOT preview-only: it is the runtime\n     *  fallback too. An empty default with no query-param value means the filter is DROPPED. */\n    defaultValue?: string;\n}\n\n/** The order a query source returns its rows in (CC2, board 4 \"Sort\" — the data source popover). */\nexport enum DataSourceSortDir {\n    Asc = 'asc',\n    Desc = 'desc',\n}\n\nexport interface DataSourceSort {\n    /** A field of the content type (a dot path into a nested object is allowed). */\n    field?: string;\n    dir?: DataSourceSortDir | `${DataSourceSortDir}`;\n}\n\n/** The query parameter carrying the order: `sort=order` ascending, `sort=-order` descending. A CONTROL like\n *  `limit`, not a field filter — the public controllers split it out (iox-cms `query-controls.ts`). */\nexport const SORT_PARAM = 'sort';\nconst SORT_FIELD = /^[A-Za-z_][A-Za-z0-9_]*(\\.[A-Za-z_][A-Za-z0-9_]*)*$/;\n\n/** `sort`'s wire value, or null when the source sets no (valid) order. */\nexport function sortParamValue(sort: DataSourceSort | null | undefined): string | null {\n    const field = sort?.field?.trim();\n    if (!field || !SORT_FIELD.test(field)) return null;\n    return sort?.dir === DataSourceSortDir.Desc ? `-${field}` : field;\n}\n\nexport interface DataSourceRequestSpec {\n    contentType?: string;\n    limit?: number;\n    /** A query source's order (CC2). Absent = the backend's natural order, as before. */\n    sort?: DataSourceSort;\n    filterByRouteParam?: DataSourceRouteFilter;\n    filterByQueryParams?: DataSourceQueryFilter[];\n}\n\n/** Structural (duck-typed) view of an IoxDataSource — kept free of the editor model so both libs\n *  can depend on it without pulling in iox-builder. */\nexport interface DataSourceSpec {\n    alias?: string;\n    type?: string; // 'cms' | 'shop' | 'external-api' | 'static'\n    mode?: DataSourceMode;\n    request?: {\n        cms?: DataSourceRequestSpec;\n        shop?: DataSourceRequestSpec;\n        endpoint?: string;\n        data?: any;\n        /** `derived` alias: a VIEW into another variable — resolve `from` then getByPath(value, path)\n         *  (e.g. galleryImages = product.gallery). See repeater-binding-ux-plan.md. */\n        derived?: { from: string; path: string };\n    };\n}\n\nexport type DataSourcePlan =\n    | { kind: 'by-id'; domain: DataSourceDomain; resource: string; id: string; mode: DataSourceMode }\n    | { kind: 'collection'; domain: DataSourceDomain; resource: string; filter: Record<string, any>; limit?: number; sort?: string; mode: DataSourceMode }\n    | { kind: 'external'; endpoint: string; mode: DataSourceMode }\n    | { kind: 'static'; data: any; mode: DataSourceMode }\n    | { kind: 'derived'; from: string; path: string; mode: DataSourceMode }\n    | { kind: 'none' };\n\n/**\n * Match a page route template against an actual path and extract named params.\n *   matchRouteParams('/project/:projectId', 'project/68abc') → { projectId: '68abc' }\n * Both sides are normalised (leading slash stripped) and split on '/'; values are URL-decoded.\n */\nexport function matchRouteParams(template: string | undefined, actual: string | undefined): Record<string, string> {\n    const t = (template ?? '').replace(/^\\/+/, '').split('/');\n    const a = (actual ?? '').replace(/^\\/+/, '').split('/');\n    const params: Record<string, string> = {};\n    for (let i = 0; i < t.length; i++) {\n        const seg = t[i];\n        if (seg && seg.startsWith(':')) params[seg.slice(1)] = decodeURIComponent(a[i] ?? '');\n    }\n    return params;\n}\n\n/**\n * Build the query filter for a data-source request from its filterByRouteParam / filterByQueryParams\n * config. `field` is filtered by the route-param value (falling back to `defaultId`); query filters\n * map each `field` to a query-param value (falling back to `defaultValue`), and a filter with NO\n * `queryParam` is a constant on `defaultValue`. Empty values are omitted so the source isn't\n * accidentally filtered to nothing.\n */\nexport function buildDataSourceFilter(\n    req: DataSourceRequestSpec | undefined,\n    routeParams: Record<string, any> = {},\n    queryParams: Record<string, any> = {},\n): Record<string, any> {\n    const params: Record<string, any> = {};\n    const byRoute = req?.filterByRouteParam;\n    if (byRoute?.field && byRoute?.routeParam) {\n        const value = routeParams[byRoute.routeParam] ?? byRoute.defaultId;\n        if (value !== undefined && value !== null && value !== '') params[byRoute.field] = value;\n    }\n    for (const q of req?.filterByQueryParams ?? []) {\n        if (!q?.field) continue;\n        // No queryParam → a CONSTANT filter: defaultValue is the value, in the builder preview and\n        // on the live site alike. With a queryParam the URL wins and defaultValue is the fallback.\n        const value = q.queryParam ? (queryParams[q.queryParam] ?? q.defaultValue) : q.defaultValue;\n        if (value !== undefined && value !== null && value !== '') params[q.field] = value;\n    }\n    return params;\n}\n\n/**\n * Mirrors the builder's getContentById decision. When a SINGLE source is filtered by the item id\n * (`_id`) via a route param, the item is fetched by PATH (`.../:type/:id`), not a `?_id=` query.\n * Returns that id (route-param value, else `defaultId`), or `null` when the source isn't a\n * single-by-id fetch — in which case the caller uses the collection endpoint + filters. The\n * path-based form only applies to the id field; a single source filtered by any other field still\n * goes through the collection endpoint.\n */\nexport function resolveSingleItemId(req: DataSourceRequestSpec | undefined, routeParams: Record<string, any> = {}): string | null {\n    const byRoute = req?.filterByRouteParam;\n    if (!byRoute?.routeParam) return null;\n    if (byRoute.field && byRoute.field !== '_id') return null;\n    const value = routeParams[byRoute.routeParam] ?? byRoute.defaultId;\n    return value !== undefined && value !== null && value !== '' ? String(value) : null;\n}\n\n/**\n * Resolve an IoxDataSource into a transport-agnostic {@link DataSourcePlan}. This is the shared\n * decision both the builder and the SSR engine run; each then executes the plan with its own\n * HTTP layer. Single sources with a route-param id resolve to a `by-id` (path) fetch — exactly like\n * the builder's getContentById.\n */\nexport function planDataSource(\n    ds: DataSourceSpec | undefined,\n    routeParams: Record<string, any> = {},\n    queryParams: Record<string, any> = {},\n): DataSourcePlan {\n    const mode: DataSourceMode = ds?.mode === 'single' ? 'single' : 'list';\n    switch (ds?.type) {\n        case 'cms':\n        case 'shop': {\n            const domain = ds.type as DataSourceDomain;\n            const req = domain === 'cms' ? ds.request?.cms : ds.request?.shop;\n            const resource = req?.contentType;\n            if (!resource) return { kind: 'none' };\n            const id = mode === 'single' ? resolveSingleItemId(req, routeParams) : null;\n            if (id) return { kind: 'by-id', domain, resource, id, mode };\n            const filter = buildDataSourceFilter(req, routeParams, queryParams);\n            const plan: DataSourcePlan = { kind: 'collection', domain, resource, filter, mode };\n            if (req?.limit) (plan as any).limit = req.limit;\n            const sort = sortParamValue(req?.sort);\n            if (sort) (plan as any).sort = sort;\n            return plan;\n        }\n        case 'external-api': {\n            const endpoint = ds.request?.endpoint;\n            return endpoint ? { kind: 'external', endpoint, mode } : { kind: 'none' };\n        }\n        case 'static':\n            return { kind: 'static', data: ds.request?.data ?? null, mode };\n        case 'derived': {\n            const d = ds.request?.derived;\n            return d?.from ? { kind: 'derived', from: d.from, path: d.path ?? '', mode } : { kind: 'none' };\n        }\n        case 'variable':\n            // A VARIABLE is a page-local resource whose value is WRITTEN at runtime by an interaction\n            // (setContext), never fetched. It resolves to nothing here on purpose: the page renders\n            // its empty state until something writes it. `request.variable.itemsFrom` only names the\n            // source whose items it holds, so the bind picker can suggest fields.\n            return { kind: 'none' };\n        default:\n            return { kind: 'none' };\n    }\n}\n\n/**\n * The aliases on a page that are VARIABLES — runtime-written resources, not fetched data.\n *\n * Shared so the builder and the SSR engine agree on which aliases start empty and are filled by\n * interactions. See element-context-state-plan.md.\n */\nexport function variableAliases(dataSources: readonly { alias?: string; type?: string }[] | undefined): Set<string> {\n    const out = new Set<string>();\n    for (const ds of dataSources ?? []) {\n        if (ds?.type === 'variable' && ds.alias) out.add(ds.alias);\n    }\n    return out;\n}\n\n/** The source alias whose items a variable holds, if it declares one (for field suggestions). */\nexport function variableItemsFrom(\n    dataSources: readonly { alias?: string; type?: string; request?: any }[] | undefined,\n    alias: string,\n): string | undefined {\n    for (const ds of dataSources ?? []) {\n        if (ds?.type === 'variable' && ds.alias === alias) return ds.request?.variable?.itemsFrom || undefined;\n    }\n    return undefined;\n}\n\n/**\n * Normalise a collection response into the shape a source expects: unwraps `{items}`/`{data}`\n * envelopes, then returns the first item for a `single` source or the whole array for a `list`.\n * A `by-id` response is already the item, so callers pass it through unchanged.\n */\nexport function normalizeCollectionResult(mode: DataSourceMode, data: any): any {\n    const items = Array.isArray(data) ? data : (data?.items ?? data?.data ?? []);\n    return mode === 'single' ? (items[0] ?? null) : items;\n}\n\n/** Navigate a dot/bracket path into an object, e.g. `gallery`, `details.images`, `variants[0].skus`.\n *  Returns undefined if any segment is missing. Kept minimal + self-contained so it is shareable by\n *  both the builder and the SSR engine (the two have divergent local `resolvePath` copies). */\nexport function getByPath(obj: any, path: string): any {\n    if (obj == null || !path) return obj;\n    // Turn `a[0].b` into ['a','0','b'].\n    const segments = path.replace(/\\[(\\w+)\\]/g, '.$1').split('.').filter(Boolean);\n    let cur = obj;\n    for (const seg of segments) {\n        if (cur == null) return undefined;\n        cur = cur[seg];\n    }\n    return cur;\n}\n\n/**\n * The array a Repeater (or a repeating Slider) iterates over — the SHARED decision so the builder\n * canvas and the SSR engine agree (see data-source-resolving.md).\n * - No `sourcePath`: the resolved source IS the list. An array passes through; a lone object degrades\n *   to a single-row list (back-compat with the old `fetchItems`); null/undefined → `[]`.\n * - With `sourcePath`: the source resolved to a SINGLE resource (e.g. a product); dive into the\n *   nested array property (e.g. `gallery`). Non-array / missing → `[]`.\n */\n/**\n * Fill in `derived` aliases in an already-resolved map. Given the data sources and a map of resolved\n * NON-derived values (by alias), compute each `type:'derived'` alias as `getByPath(parent, path)` in\n * dependency order (chains resolved by iterating until stable). Mutates + returns the map. Used by the\n * SSR engine after it resolves the root sources; the builder resolves derived lazily per alias.\n */\nexport function resolveDerivedInto(dataSources: DataSourceSpec[], resolved: Record<string, any>): Record<string, any> {\n    const derived = (dataSources ?? []).filter(d => d?.type === 'derived' && !!d.alias);\n    let changed = true, guard = 0;\n    while (changed && guard++ < 25) {\n        changed = false;\n        for (const d of derived) {\n            if (d.alias! in resolved) continue;\n            const from = d.request?.derived?.from;\n            if (from && from in resolved) {\n                resolved[d.alias!] = getByPath(resolved[from], d.request!.derived!.path ?? '');\n                changed = true;\n            }\n        }\n    }\n    return resolved;\n}\n\nexport function resolveRepeaterItems(resolved: any, sourcePath?: string | null): any[] {\n    if (sourcePath) {\n        const nested = getByPath(resolved, sourcePath);\n        return Array.isArray(nested) ? nested : [];\n    }\n    if (Array.isArray(resolved)) return resolved;\n    return resolved == null ? [] : [resolved];\n}\n\n// ── Referenced data sources (shared: builder-save + SSR resolve) ─────────────────────────────────\n// Which data-source aliases a node tree uses, so a consumer resolves ONLY what a page/global needs\n// (not the whole org library). Used by cms-client (persist globals' sources) and the SSR engine\n// (resolve the referenced subset per page). See org-data-sources-plan.md.\n\n/** Aliases referenced anywhere in a node tree: a repeater/slider `source` (a `bindings` entry with\n *  `prop === 'source'`, or `props.source` for the slider) plus every binding's `source`. */\nexport function collectReferencedAliases(nodes: any[], acc: Set<string> = new Set<string>()): Set<string> {\n    for (const n of nodes ?? []) {\n        for (const b of n?.bindings ?? []) { if (b?.source) acc.add(b.source); }\n        if (n?.props?.source) acc.add(n.props.source);\n        if (n?.children?.length) collectReferencedAliases(n.children, acc);\n    }\n    return acc;\n}\n\n/** The subset of `all` whose `alias` is referenced by `nodes` (shallow — direct references only). */\nexport function referencedDataSources(nodes: any[], all: any[]): any[] {\n    const aliases = collectReferencedAliases(nodes);\n    return (all ?? []).filter(ds => aliases.has(ds?.alias));\n}\n\n/** Like `referencedDataSources`, but also pulls in a referenced source's DEPENDENCIES (transitively),\n *  none of which the layout names directly:\n *   - a `derived` alias needs its `request.derived.from` parent;\n *   - a `relative` (route-context) alias needs its `request.relative.subjectFrom` (the current item)\n *     and `request.relative.from` (the collection it navigates).\n *  Use this when RESOLVING (the engine) so derived views and siblings/related don't resolve to nothing. */\nexport function referencedDataSourcesDeep(nodes: any[], all: any[]): any[] {\n    const byAlias = new Map((all ?? []).map(d => [d?.alias, d]));\n    const wanted = collectReferencedAliases(nodes);\n    const queue = [...wanted];\n    const enqueue = (alias?: string) => {\n        if (alias && !wanted.has(alias)) { wanted.add(alias); queue.push(alias); }\n    };\n    while (queue.length) {\n        const ds: any = byAlias.get(queue.pop() as string);\n        enqueue(ds?.request?.derived?.from);\n        enqueue(ds?.request?.relative?.subjectFrom);\n        enqueue(ds?.request?.relative?.from);\n    }\n    return (all ?? []).filter(d => wanted.has(d?.alias));\n}\n\n/** Base URLs for the PUBLIC content controllers. Both must end with `/`. The builder and the SSR\n *  engine pass their own host (they proxy `/api` differently) but MUST target the public\n *  (`@Public()`) controllers, never the authed admin ones — data resolving is storefront data. */\nexport interface DataSourceEndpoints {\n    /** cms resources, e.g. `${HOST}` (engine, HOST ends `/api/`) or `${HOST}api/` (builder). */\n    cmsBase: string;\n    /** shop resources, e.g. `${HOST}shop/` (engine) or `${HOST}api/shop/` (builder). */\n    shopBase: string;\n}\n\nexport interface DataSourceRequest {\n    url: string;\n    params: Record<string, any>;\n}\n\n/**\n * Turn a resolved {@link DataSourcePlan} into the concrete public HTTP request (url + params) — the\n * SINGLE place that decides the URL shape, shared by the builder binding preview and the SSR engine\n * so both hit the SAME public endpoints (no admin, no duplication). Returns `null` for `static` /\n * `none` plans (no HTTP call). A single item is a PATH segment (`/:resource/:id`), never `?_id=`.\n */\nexport function dataSourcePlanToRequest(plan: DataSourcePlan, endpoints: DataSourceEndpoints): DataSourceRequest | null {\n    const baseFor = (domain: DataSourceDomain) => (domain === 'shop' ? endpoints.shopBase : endpoints.cmsBase);\n    switch (plan.kind) {\n        case 'by-id':\n            return { url: `${baseFor(plan.domain)}${plan.resource}/${encodeURIComponent(plan.id)}`, params: {} };\n        case 'collection': {\n            const params: Record<string, any> = { ...plan.filter };\n            if (plan.limit) params['limit'] = plan.limit;\n            if (plan.sort) params[SORT_PARAM] = plan.sort;\n            return { url: `${baseFor(plan.domain)}${plan.resource}`, params };\n        }\n        case 'external':\n            return { url: plan.endpoint, params: {} };\n        default:\n            return null;\n    }\n}\n","/**\n * Shared RELATIVE (route-context) data resolving — the SINGLE source of truth for how a detail page\n * derives values FROM its current route item, consumed by BOTH the page builder (iox-cms-client) and\n * the SSR client engine (iox-client-engine). Companion to `data-source-resolver.ts`.\n *\n * These are the pure, transport-agnostic pieces behind the Route binding scope\n * (`$route` / `$current` / `$siblings` / `$related`). Resolution is a DEPENDENT SECOND PASS: the\n * consumer resolves `$current` first (the existing single by-id fetch via `planDataSource`), then\n * calls these to derive the relative values — there is NO new `DataSourcePlan` kind (`$related` still\n * feeds a normal `collection` plan built from {@link buildRelatedFilter}). See\n * `architecture/builder/relative-data-sources-plan.md`.\n *\n * There must be no second copy of this decision logic; only the transport (which HTTP layer fetches\n * the ordered collection / related list) differs between the two consumers.\n */\n\nimport { getByPath } from './data-source-resolver';\n\n/** Aliases in the Route scope are platform-owned and start with this prefix; a USER alias may never\n *  start with it, which keeps the Route scope structurally collision-proof with Local/Global. Used to\n *  validate new/renamed aliases and to render the reserved (read-only) item state in the bind picker. */\nexport const RESERVED_ALIAS_PREFIX = '$';\n\n/** True for a platform-owned Route-scope alias (`$route`, `$current`, `$siblings`, `$related`, …). */\nexport function isReservedAlias(alias: string | null | undefined): boolean {\n    return typeof alias === 'string' && alias.startsWith(RESERVED_ALIAS_PREFIX);\n}\n\n/** The `$siblings` value: the current item's neighbours within an ordered set. */\nexport interface SiblingsResult<T = any> {\n    /** The item before the current one (`null` at the start, unless `wrap`). */\n    prev: T | null;\n    /** The item after the current one (`null` at the end, unless `wrap`). */\n    next: T | null;\n    /** Zero-based position of the current item in the ordered set; `-1` when not found. */\n    index: number;\n    /** Total items in the set. */\n    count: number;\n    /** `true` when the current item is the first in the set. */\n    isFirst: boolean;\n    /** `true` when the current item is the last in the set. */\n    isLast: boolean;\n}\n\nexport interface ResolveSiblingsOptions {\n    /** Field identifying the current item within the list. Default `_id`. */\n    idField?: string;\n    /** Dot/bracket path to sort by BEFORE locating neighbours (e.g. `order`, `date`). Omit to use the\n     *  list's existing order. The same item neighbours differently per ordering, so this is the one\n     *  choice `$siblings` requires. */\n    sortBy?: string;\n    /** Sort direction when `sortBy` is set. Default `asc`. */\n    sortDir?: 'asc' | 'desc';\n    /** Wrap around the ends (`last.next` → first, `first.prev` → last). Only applies when `count > 1`.\n     *  Default `false`. */\n    wrap?: boolean;\n}\n\nconst EMPTY_SIBLINGS: SiblingsResult = { prev: null, next: null, index: -1, count: 0, isFirst: false, isLast: false };\n\n/** Generic, deterministic comparator: numbers numerically, Dates by time, everything else by\n *  locale-aware string compare (ISO date strings sort correctly this way). Nullish sorts first. */\nfunction compareValues(a: any, b: any): number {\n    if (a == null && b == null) return 0;\n    if (a == null) return -1;\n    if (b == null) return 1;\n    if (typeof a === 'number' && typeof b === 'number') return a - b;\n    const da = a instanceof Date ? a.getTime() : NaN;\n    const db = b instanceof Date ? b.getTime() : NaN;\n    if (!isNaN(da) && !isNaN(db)) return da - db;\n    return String(a).localeCompare(String(b));\n}\n\n/**\n * Locate the current item within an ordered set and return its neighbours + position. Pure: the input\n * list is never mutated (sorting works on a shallow copy). `currentId` is compared to each item's\n * `idField` via string equality (route-param values are strings). When the current id isn't found,\n * `index` is `-1` and `prev`/`next` are `null` (but `count` still reflects the set size).\n */\nexport function resolveSiblings<T = any>(\n    items: T[] | null | undefined,\n    currentId: string | number | null | undefined,\n    options: ResolveSiblingsOptions = {},\n): SiblingsResult<T> {\n    const list = Array.isArray(items) ? items.slice() : [];\n    const count = list.length;\n    if (count === 0) return { ...EMPTY_SIBLINGS };\n\n    const idField = options.idField ?? '_id';\n    if (options.sortBy) {\n        const dir = options.sortDir === 'desc' ? -1 : 1;\n        list.sort((a, b) => dir * compareValues(getByPath(a, options.sortBy!), getByPath(b, options.sortBy!)));\n    }\n\n    const cid = currentId == null ? null : String(currentId);\n    const index = cid == null ? -1 : list.findIndex(it => String(getByPath(it, idField)) === cid);\n    if (index === -1) return { prev: null, next: null, index: -1, count, isFirst: false, isLast: false };\n\n    const canWrap = !!options.wrap && count > 1;\n    const prev = index > 0 ? list[index - 1] : (canWrap ? list[count - 1] : null);\n    const next = index < count - 1 ? list[index + 1] : (canWrap ? list[0] : null);\n    return { prev, next, index, count, isFirst: index === 0, isLast: index === count - 1 };\n}\n\nexport interface BuildRelatedFilterOptions {\n    /** Field(s) on the current item whose value(s) the related items must match (e.g. `category`,\n     *  or `['category', 'brand']`). Each contributes an equality filter on that field. */\n    matchFields: string | string[];\n}\n\n/** A value usable as an equality filter param: a non-empty scalar. Objects/arrays/nullish are skipped\n *  so a related query isn't built from an unresolved rel object (surfaced as a config issue in the UI\n *  rather than silently matching everything). Multi-value match is a v2 concern. */\nfunction isScalarFilterValue(v: any): boolean {\n    if (v == null) return false;\n    if (typeof v === 'string') return v !== '';\n    if (typeof v === 'number') return Number.isFinite(v);\n    return typeof v === 'boolean';\n}\n\n/**\n * Build the collection filter for `$related` from the resolved current item: an equality match on\n * each `matchField`'s value (e.g. same `category`). Feeds a normal `collection` plan — no new plan\n * kind. Fields whose value is not a scalar (or is empty) are omitted, matching\n * `buildDataSourceFilter`'s \"don't over-filter\" rule. Exclude-self is applied to the RESULT via\n * {@link excludeSelf} (the public query controllers are equality-only, so it can't be a `$ne` param).\n */\nexport function buildRelatedFilter(current: any, options: BuildRelatedFilterOptions): Record<string, any> {\n    const fields = Array.isArray(options.matchFields) ? options.matchFields : [options.matchFields];\n    const filter: Record<string, any> = {};\n    for (const field of fields) {\n        if (!field) continue;\n        const value = getByPath(current, field);\n        if (isScalarFilterValue(value)) filter[field] = value;\n    }\n    return filter;\n}\n\n/**\n * Drop the current item from a list by `idField` (default `_id`). Used to exclude self from a\n * `$related` result after fetch. A nullish/empty `currentId` leaves the list unchanged.\n */\nexport function excludeSelf<T = any>(items: T[] | null | undefined, currentId: string | number | null | undefined, idField = '_id'): T[] {\n    if (!Array.isArray(items)) return [];\n    if (currentId == null || currentId === '') return items;\n    const cid = String(currentId);\n    return items.filter(it => String(getByPath(it, idField)) !== cid);\n}\n\n/** The resolved Route-scope context bound values read from (`$route.projectId`, `$current.title`,\n *  `$siblings.next`, `$related`). Assembled by each consumer during its dependent second pass. */\nexport interface RouteContext {\n    /** Route path params for the current URL (from `matchRouteParams`). */\n    $route: Record<string, string>;\n    /** The resolved current item (the page's single by-id source). */\n    $current: any;\n    /** Neighbours of the current item within a chosen ordered set. */\n    $siblings?: SiblingsResult;\n    /** Items related to the current one (same-attribute), excluding self. */\n    $related?: any[];\n}\n\n// ── Relative source declaration + the shared second-pass resolver ────────────────────────────────\n// A relative source is declared like a `derived` one (`type:'relative'`), and resolved AFTER the\n// root/derived sources by a PURE pass over the resolved map — mirroring `resolveDerivedInto`, so the\n// SSR engine and the builder canvas agree with no forked logic. `planDataSource` returns `none` for\n// it (not fetched); each consumer excludes `relative` from its fetched roots and runs this pass.\n\nexport type RelativeSourceKind = 'route' | 'current' | 'siblings' | 'related';\n\nexport interface RelativeSourceSpec {\n    kind: RelativeSourceKind;\n    /** The source alias this derives from: for `current` the subject single-source; for\n     *  `siblings`/`related` the COLLECTION alias to locate within / search. Unused for `route`. */\n    from?: string;\n    /** `siblings`/`related`: the SUBJECT source alias (the current item) whose id / field values drive\n     *  the computation. Defaults to `from` when omitted. May reference `$current`. */\n    subjectFrom?: string;\n    /** Field identifying an item. Default `_id`. */\n    idField?: string;\n    /** `siblings`: sort the set before locating neighbours. */\n    sortBy?: string;\n    sortDir?: 'asc' | 'desc';\n    wrap?: boolean;\n    /** `siblings`: resolve to a SINGLE neighbour ITEM (`next`/`prev`) instead of the whole\n     *  `{prev,next,index,count,…}` object — so a source can be named e.g. `nextProject` and bound\n     *  directly (`nextProject.route`). Omit for the whole-object shape. */\n    pick?: 'next' | 'prev';\n    /** `related`: field(s) on the subject the results must match. */\n    matchFields?: string | string[];\n    /** `related`: drop the subject from its own results. Default `true`. */\n    excludeSelf?: boolean;\n}\n\n/** Duck-typed view of a data source carrying an optional relative descriptor (avoids a hard dep on\n *  the full editor model / a circular type import). */\ninterface RelativeCapableSource {\n    alias?: string;\n    type?: string;\n    request?: { relative?: RelativeSourceSpec };\n}\n\n/** The already-resolved inputs a single relative source computes from. Assembled by each consumer:\n *  the batch pass reads them from the resolved map; the builder resolves them async per alias. */\nexport interface RelativeInputs {\n    /** The subject item (the current resource) — for `current`/`siblings`/`related`. */\n    subject?: any;\n    /** The collection to locate within / search — for `siblings`/`related`. */\n    collection?: any;\n    /** Route path params — for `route`. */\n    routeParams?: Record<string, any>;\n}\n\n/** Resolve kinds in a fixed order so a `siblings`/`related` source may reference `$current` (or any\n *  earlier relative alias) via `subjectFrom` and still see it resolved. */\nconst KIND_ORDER: Record<RelativeSourceKind, number> = { route: 0, current: 1, siblings: 2, related: 3 };\n\n/** Does an item satisfy every field in an equality predicate map (string-compared)? */\nfunction matchesFilter(item: any, filter: Record<string, any>): boolean {\n    return Object.keys(filter).every(k => String(getByPath(item, k)) === String(filter[k]));\n}\n\n/**\n * Compute ONE relative source's value from its already-resolved {@link RelativeInputs} — the SHARED\n * kind→computation decision, so the batch pass ({@link resolveRelativeInto}) and the builder's async\n * per-alias resolver produce identical results with no forked switch. `route` → the route params;\n * `current` → the subject; `siblings` → {@link resolveSiblings} over the collection; `related` → the\n * collection filtered by {@link buildRelatedFilter}'s predicate (+ {@link excludeSelf}).\n */\nexport function computeRelative(spec: RelativeSourceSpec, inputs: RelativeInputs): any {\n    const idField = spec.idField ?? '_id';\n    switch (spec.kind) {\n        case 'route':\n            return inputs.routeParams ?? {};\n        case 'current':\n            return inputs.subject ?? null;\n        case 'siblings': {\n            const siblings = resolveSiblings(inputs.collection, getByPath(inputs.subject, idField), {\n                idField, sortBy: spec.sortBy, sortDir: spec.sortDir, wrap: spec.wrap,\n            });\n            // `pick` resolves the source directly to that neighbour item (named-source shape,\n            // e.g. `nextProject`); without it the caller binds a sub-path of the whole object.\n            return spec.pick ? siblings[spec.pick] : siblings;\n        }\n        case 'related': {\n            const filter = buildRelatedFilter(inputs.subject, { matchFields: spec.matchFields ?? [] });\n            const pool = Array.isArray(inputs.collection) ? inputs.collection : [];\n            const items = pool.filter(it => matchesFilter(it, filter));\n            return spec.excludeSelf !== false ? excludeSelf(items, getByPath(inputs.subject, idField), idField) : items;\n        }\n        default:\n            return null;\n    }\n}\n\n/**\n * Compute every `type:'relative'` source into `resolved` (keyed by alias), IN PLACE. Pure w.r.t. HTTP\n * — it only reads already-resolved roots + the route params, so both consumers run it identically as\n * a second pass. Delegates each source to {@link computeRelative}. `current`'s subject is `from`;\n * `siblings`/`related` take `collection` = `from` and `subject` = `subjectFrom ?? from`. Mutates and\n * returns `resolved`.\n */\nexport function resolveRelativeInto(\n    dataSources: RelativeCapableSource[],\n    resolved: Record<string, any>,\n    routeParams: Record<string, any> = {},\n): Record<string, any> {\n    const relatives = (dataSources ?? [])\n        .filter(d => d?.type === 'relative' && !!d.alias && !!d.request?.relative)\n        .sort((a, b) => KIND_ORDER[a.request!.relative!.kind] - KIND_ORDER[b.request!.relative!.kind]);\n\n    for (const d of relatives) {\n        const spec = d.request!.relative!;\n        const subjectAlias = spec.kind === 'current' ? spec.from : (spec.subjectFrom ?? spec.from);\n        resolved[d.alias!] = computeRelative(spec, {\n            subject: subjectAlias ? resolved[subjectAlias] : undefined,\n            collection: spec.from ? resolved[spec.from] : undefined,\n            routeParams,\n        });\n    }\n    return resolved;\n}\n","/**\n * @vectoriox/iox-ui/data-core — the shared, FRAMEWORK-FREE data-source core (data-source-resolving.md): the ONE\n * decision of how a data source becomes a fetch (`planDataSource`), the route-param matcher, the derived /\n * relative (`$siblings`, `$related`) resolvers, the repeater item reader, and which sources a node tree\n * references (`referencedDataSourcesDeep`). The builder and the SSR engine resolve with it; iox-cms reads it\n * under plain Node (W2's Undo: is a data source still in use). Pure: no transport, no Angular. The main\n * entry re-exports it by package path, so `@vectoriox/iox-ui` keeps working.\n * ⚠️ Consumers wire the usual trio — ng-package raw-ts assets, jest moduleNameMapper, tsconfig paths —\n * or `nest start` dies with ERR_REQUIRE_ESM while jest and build both pass.\n */\nexport * from './data-source-resolver';\nexport * from './relative-sources';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}