@cohesivesystems/presentation-core 0.1.0-alpha.1

package/dist/presentation-collection-pagination.js

@@ -0,0 +1,275 @@
+import { findPresentationDataSource, } from './module.js';
+import { createDataSourcePaginationParameterPrefix, inferPresentationPaginationBinding, } from './presentation-pagination.js';
+import { createPresentationProjectionDiagnostic, } from './presentation-projection-diagnostics.js';
+import { createProjectedCollectionChromeRuntime, isProjectedCollectionPaginationEnabled, isProjectedCollectionPaginationFooterEnabled, resolveProjectedCollectionPaginationDataSourceId, } from './projected-collection-runtime.js';
+import { findPresentationQueryFormForResultDataSource } from './query-form-lowering.js';
+import { dataSourceKindLabels, dataSourceKinds, } from '@cohesivesystems/presentation-contracts';
+/**
+ * Fallback page size used when neither the data source nor a synchronized query
+ * form declares a default page size.
+ */
+export const defaultPresentationCollectionPageSize = 10;
+export function createPresentationCollectionPaginationBindings({ dataSourceIds, defaultPageSize = defaultPresentationCollectionPageSize, module, views, }) {
+    const fallbackPageSize = readPositiveInteger(defaultPageSize) ?? defaultPresentationCollectionPageSize;
+    return resolveCollectionPaginationDataSourceIds(dataSourceIds, views).flatMap((dataSourceId) => {
+        const dataSource = findPresentationDataSource(module, dataSourceId);
+        if (!dataSource || !isCollectionQueryDataSource(dataSource)) {
+            return [];
+        }
+        const binding = inferPresentationCollectionPaginationBinding(dataSource, module, fallbackPageSize);
+        return binding ? [binding] : [];
+    });
+}
+function resolveCollectionPaginationDataSourceIds(dataSourceIds, views) {
+    const collectionViews = views?.filter((view) => view.Collection) ?? [];
+    if (collectionViews.length === 0) {
+        return Array.from(new Set(dataSourceIds));
+    }
+    return Array.from(new Set(collectionViews.flatMap((view) => {
+        const collection = view.Collection;
+        if (!collection || !isProjectedCollectionPaginationEnabled(collection)) {
+            return [];
+        }
+        const dataSourceId = resolveProjectedCollectionPaginationDataSourceId(collection);
+        return dataSourceId ? [dataSourceId] : [];
+    })));
+}
+export function projectPresentationCollectionPaginationDiagnostics({ bindings, footerRendererBound = true, module, sourceId, views, }) {
+    const collectionPaginationViews = resolveEnabledCollectionPaginationViews(views);
+    if (collectionPaginationViews.length === 0) {
+        return bindings.map((binding) => {
+            const dataSource = findPresentationDataSource(module, binding.dataSourceId);
+            return createCollectionPaginationRuntimeDiagnostic({
+                binding,
+                dataSource,
+                sourceId,
+            });
+        });
+    }
+    return collectionPaginationViews.flatMap((view) => projectCollectionViewPaginationDiagnostics({
+        bindings,
+        footerRendererBound,
+        module,
+        sourceId,
+        view,
+    }));
+}
+function projectCollectionViewPaginationDiagnostics({ bindings, footerRendererBound, module, sourceId, view, }) {
+    const collection = view.Collection;
+    if (!collection || !isProjectedCollectionPaginationEnabled(collection)) {
+        return [];
+    }
+    const chrome = createProjectedCollectionChromeRuntime(collection);
+    const paginationSlot = chrome.paginationSlot;
+    const dataSourceId = resolveProjectedCollectionPaginationDataSourceId(collection);
+    const diagnostics = [];
+    if (!dataSourceId) {
+        diagnostics.push(createPresentationProjectionDiagnostic({
+            category: 'missing-definition',
+            details: {
+                collectionChromeSlotId: paginationSlot?.Id ?? null,
+                paginationPlacement: paginationSlot?.Placement ?? null,
+                viewId: view.Id,
+            },
+            id: `collection-pagination.${view.Id}.missing-slot-data-source`,
+            interpretation: {
+                status: 'unbound',
+                target: 'projected-collection-runtime.pagination',
+            },
+            message: `Collection view '${view.Name}' declares pagination chrome, ` +
+                'but the pagination slot does not declare a data source.',
+            severity: 'error',
+            source: sourceId,
+            subject: {
+                id: view.Id,
+                kind: 'view',
+                name: view.Name,
+            },
+            suggestedNextStep: 'Add the paginated collection data source id to the Collection.Chrome pagination slot.',
+        }));
+        return diagnostics;
+    }
+    const dataSource = findPresentationDataSource(module, dataSourceId);
+    const binding = bindings.find((candidate) => candidate.dataSourceId === dataSourceId);
+    if (!dataSource) {
+        diagnostics.push(createPresentationProjectionDiagnostic({
+            category: 'missing-definition',
+            details: {
+                collectionChromeSlotId: paginationSlot?.Id ?? null,
+                dataSourceId,
+                paginationPlacement: paginationSlot?.Placement ?? null,
+                viewId: view.Id,
+            },
+            id: `collection-pagination.${view.Id}.${dataSourceId}.missing-data-source`,
+            interpretation: {
+                status: 'unbound',
+                target: 'projected-collection-runtime.pagination',
+            },
+            message: `Collection view '${view.Name}' enables pagination through data source ` +
+                `'${dataSourceId}', but that data source is not present in the presentation module.`,
+            severity: 'error',
+            source: sourceId,
+            subject: {
+                id: view.Id,
+                kind: 'view',
+                name: view.Name,
+            },
+            suggestedNextStep: 'Declare the pagination data source in the presentation module or update the Collection.Chrome pagination slot.',
+        }));
+    }
+    else if (!binding) {
+        diagnostics.push(createPresentationProjectionDiagnostic({
+            category: 'missing-binding',
+            details: {
+                collectionChromeSlotId: paginationSlot?.Id ?? null,
+                dataSourceId,
+                dataSourceKind: dataSource.Kind,
+                paginationPlacement: paginationSlot?.Placement ?? null,
+                viewId: view.Id,
+            },
+            id: `collection-pagination.${view.Id}.${dataSourceId}.missing-runtime-binding`,
+            interpretation: {
+                status: 'unbound',
+                target: 'projected-collection-runtime.pagination.window',
+            },
+            message: `Collection view '${view.Name}' enables pagination for '${dataSource.Name}', ` +
+                'but no frontend pagination runtime binding was created for that data source.',
+            severity: 'warning',
+            source: sourceId,
+            subject: {
+                id: view.Id,
+                kind: 'view',
+                name: view.Name,
+            },
+            suggestedNextStep: 'Ensure the data source is a collection-query data source with declared or inferable pagination request and response bindings.',
+        }));
+    }
+    else {
+        diagnostics.push(createCollectionPaginationRuntimeDiagnostic({
+            binding,
+            dataSource,
+            paginationSlotId: paginationSlot?.Id ?? null,
+            sourceId,
+            view,
+        }));
+    }
+    if (isProjectedCollectionPaginationFooterEnabled(collection) && !footerRendererBound) {
+        diagnostics.push(createPresentationProjectionDiagnostic({
+            category: 'missing-binding',
+            details: {
+                collectionChromeSlotId: paginationSlot?.Id ?? null,
+                dataSourceId,
+                paginationPlacement: paginationSlot?.Placement ?? null,
+                viewId: view.Id,
+            },
+            id: `collection-pagination.${view.Id}.missing-footer-renderer`,
+            interpretation: {
+                status: 'unbound',
+                target: 'collection-pagination-footer-chrome',
+            },
+            message: `Collection view '${view.Name}' requests footer pagination chrome, ` +
+                'but no collection footer renderer is bound.',
+            severity: 'warning',
+            source: sourceId,
+            subject: {
+                id: view.Id,
+                kind: 'view',
+                name: view.Name,
+            },
+            suggestedNextStep: 'Bind a collection footer renderer that projects collectionRuntime.pagination.window, or change the collection pagination placement.',
+        }));
+    }
+    return diagnostics;
+}
+function createCollectionPaginationRuntimeDiagnostic({ binding, dataSource, paginationSlotId = null, sourceId, view, }) {
+    return createPresentationProjectionDiagnostic({
+        category: 'local-interpretation',
+        details: {
+            collectionChromeSlotId: paginationSlotId,
+            dataSourceId: binding.dataSourceId,
+            defaultPageSize: binding.defaultPageSize,
+            paginationKind: binding.kind,
+            urlEnabled: binding.url.enabled,
+            urlParameterPrefix: binding.url.parameterPrefix,
+            viewId: view?.Id ?? null,
+        },
+        id: view
+            ? `collection-pagination.${view.Id}.${binding.dataSourceId}.runtime-interpretation`
+            : `collection-pagination.${binding.dataSourceId}.runtime-interpretation`,
+        interpretation: {
+            status: 'locally-interpreted',
+            target: 'projected-collection-runtime.pagination.window',
+        },
+        message: `Collection pagination for '${dataSource?.Name ?? binding.dataSourceId}' ` +
+            `is interpreted through Collection.Chrome by ProjectedCollectionRuntime as ${binding.kind} windowing.`,
+        severity: 'info',
+        source: sourceId,
+        subject: view
+            ? {
+                id: view.Id,
+                kind: 'view',
+                name: view.Name,
+            }
+            : {
+                id: binding.dataSourceId,
+                kind: 'data-source',
+                name: dataSource?.Name,
+            },
+        suggestedNextStep: 'Extend collection IR with page-size controls, column selection, and row selection chips as the grid component system grows.',
+    });
+}
+function resolveEnabledCollectionPaginationViews(views) {
+    return (views ?? []).filter((view) => isProjectedCollectionPaginationEnabled(view.Collection));
+}
+function isCollectionQueryDataSource(dataSource) {
+    return matchesDataSourceKind(dataSource.Kind, dataSourceKinds.collectionQuery, 'collectionQuery');
+}
+function matchesDataSourceKind(value, numericValue, camelLabel) {
+    const pascalLabel = dataSourceKindLabels[numericValue];
+    return (value === numericValue ||
+        String(value) === String(numericValue) ||
+        String(value) === pascalLabel ||
+        String(value) === camelLabel);
+}
+function inferPresentationCollectionPaginationBinding(dataSource, module, fallbackPageSize) {
+    const urlPolicy = resolveCollectionPaginationUrlPolicy(dataSource, module);
+    return inferPresentationPaginationBinding({
+        dataSource,
+        defaultPageSize: resolveCollectionPageSize(dataSource, module, fallbackPageSize),
+        parameterPrefix: urlPolicy.parameterPrefix,
+        useUrl: urlPolicy.enabled,
+    });
+}
+function resolveCollectionPageSize(dataSource, module, fallbackPageSize) {
+    const queryFormDefaultLimit = findPresentationQueryFormForResultDataSource(module, dataSource.Id)?.Target.Result.DefaultLimit;
+    return readPositiveInteger(queryFormDefaultLimit) ?? fallbackPageSize;
+}
+function resolveCollectionPaginationUrlPolicy(dataSource, module) {
+    const dataSourceUrlPolicy = dataSource.Query?.Pagination?.Url;
+    if (dataSourceUrlPolicy) {
+        return {
+            enabled: dataSourceUrlPolicy.IsEnabled,
+            parameterPrefix: dataSourceUrlPolicy.ParameterPrefix ??
+                createDataSourcePaginationParameterPrefix(dataSource.Id),
+        };
+    }
+    const queryForm = findPresentationQueryFormForResultDataSource(module, dataSource.Id);
+    const queryFormUrlPolicy = queryForm?.Target.State.Url;
+    if (queryFormUrlPolicy?.IsEnabled && queryFormUrlPolicy.IncludePagination) {
+        return {
+            enabled: true,
+            parameterPrefix: queryFormUrlPolicy.ParameterPrefix ??
+                createDataSourcePaginationParameterPrefix(dataSource.Id),
+        };
+    }
+    return {
+        enabled: false,
+        parameterPrefix: createDataSourcePaginationParameterPrefix(dataSource.Id),
+    };
+}
+function readPositiveInteger(value) {
+    return typeof value === 'number' && Number.isInteger(value) && value > 0
+        ? value
+        : null;
+}
+//# sourceMappingURL=presentation-collection-pagination.js.map

package/dist/presentation-collection-pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-collection-pagination.js","sourceRoot":"","sources":["../src/presentation-collection-pagination.ts"],"names":[],"mappings":"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"}

package/dist/presentation-content-diagnostics.d.ts

@@ -0,0 +1,17 @@
+import type { PresentationContentDefinition } from './module.js';
+import type { PresentationProjectionDiagnostic, PresentationProjectionDiagnosticSubject } from './presentation-projection-diagnostics.js';
+export interface ProjectPresentationContentDiagnosticsOptions {
+    readonly content: PresentationContentDefinition | null | undefined;
+    readonly contentFallbackDescription?: string;
+    readonly descriptionFallbackDescription?: string;
+    readonly details?: Readonly<Record<string, unknown>>;
+    readonly diagnosticIdPrefix: string;
+    readonly requireDescription?: boolean;
+    readonly requireTitle?: boolean;
+    readonly source: string;
+    readonly subject: PresentationProjectionDiagnosticSubject;
+    readonly surfaceLabel: string;
+    readonly titleFallbackDescription?: string;
+}
+export declare function projectPresentationContentDiagnostics({ content, contentFallbackDescription, descriptionFallbackDescription, details, diagnosticIdPrefix, requireDescription, requireTitle, source, subject, surfaceLabel, titleFallbackDescription, }: ProjectPresentationContentDiagnosticsOptions): readonly PresentationProjectionDiagnostic[];
+//# sourceMappingURL=presentation-content-diagnostics.d.ts.map

package/dist/presentation-content-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-content-diagnostics.d.ts","sourceRoot":"","sources":["../src/presentation-content-diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC9B,MAAM,UAAU,CAAA;AACjB,OAAO,KAAK,EACV,gCAAgC,EAChC,uCAAuC,EACxC,MAAM,uCAAuC,CAAA;AAE9C,MAAM,WAAW,4CAA4C;IAC3D,QAAQ,CAAC,OAAO,EAAE,6BAA6B,GAAG,IAAI,GAAG,SAAS,CAAA;IAClE,QAAQ,CAAC,0BAA0B,CAAC,EAAE,MAAM,CAAA;IAC5C,QAAQ,CAAC,8BAA8B,CAAC,EAAE,MAAM,CAAA;IAChD,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACpD,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,uCAAuC,CAAA;IACzD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAA;CAC3C;AAED,wBAAgB,qCAAqC,CAAC,EACpD,OAAO,EACP,0BAA0B,EAC1B,8BAA8B,EAC9B,OAAO,EACP,kBAAkB,EAClB,kBAA0B,EAC1B,YAAoB,EACpB,MAAM,EACN,OAAO,EACP,YAAY,EACZ,wBAAwB,GACzB,EAAE,4CAA4C,GAAG,SAAS,gCAAgC,EAAE,CAoD5F"}

package/dist/presentation-content-diagnostics.js

@@ -0,0 +1,61 @@
+export function projectPresentationContentDiagnostics({ content, contentFallbackDescription, descriptionFallbackDescription, details, diagnosticIdPrefix, requireDescription = false, requireTitle = false, source, subject, surfaceLabel, titleFallbackDescription, }) {
+    if (!content) {
+        return [
+            createPresentationContentDiagnostic({
+                details,
+                diagnosticIdPrefix,
+                fallbackDescription: contentFallbackDescription ??
+                    titleFallbackDescription ??
+                    descriptionFallbackDescription ??
+                    'local fallback content',
+                reason: 'missing-content',
+                source,
+                subject,
+                surfaceLabel,
+                surfacePart: 'content',
+            }),
+        ];
+    }
+    const diagnostics = [];
+    if (requireTitle && !content.Title) {
+        diagnostics.push(createPresentationContentDiagnostic({
+            details,
+            diagnosticIdPrefix,
+            fallbackDescription: titleFallbackDescription ?? 'local title fallback content',
+            reason: 'missing-content-title',
+            source,
+            subject,
+            surfaceLabel,
+            surfacePart: 'title content',
+        }));
+    }
+    if (requireDescription && !content.Description && !content.DescriptionTemplate) {
+        diagnostics.push(createPresentationContentDiagnostic({
+            details,
+            diagnosticIdPrefix,
+            fallbackDescription: descriptionFallbackDescription ?? 'local description fallback content',
+            reason: 'missing-content-description',
+            source,
+            subject,
+            surfaceLabel,
+            surfacePart: 'description content',
+        }));
+    }
+    return diagnostics;
+}
+function createPresentationContentDiagnostic({ details, diagnosticIdPrefix, fallbackDescription, reason, source, subject, surfaceLabel, surfacePart, }) {
+    return {
+        category: 'incomplete-projection',
+        details,
+        id: `${diagnosticIdPrefix}.${reason}`,
+        interpretation: {
+            status: 'locally-interpreted',
+            target: 'react',
+        },
+        message: `${surfaceLabel} does not declare ${surfacePart}; the frontend will use ${fallbackDescription}.`,
+        severity: 'warning',
+        source,
+        subject,
+    };
+}
+//# sourceMappingURL=presentation-content-diagnostics.js.map

package/dist/presentation-content-diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-content-diagnostics.js","sourceRoot":"","sources":["../src/presentation-content-diagnostics.ts"],"names":[],"mappings":"AAsBA,MAAM,UAAU,qCAAqC,CAAC,EACpD,OAAO,EACP,0BAA0B,EAC1B,8BAA8B,EAC9B,OAAO,EACP,kBAAkB,EAClB,kBAAkB,GAAG,KAAK,EAC1B,YAAY,GAAG,KAAK,EACpB,MAAM,EACN,OAAO,EACP,YAAY,EACZ,wBAAwB,GACqB;IAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,mCAAmC,CAAC;gBAClC,OAAO;gBACP,kBAAkB;gBAClB,mBAAmB,EACjB,0BAA0B;oBAC1B,wBAAwB;oBACxB,8BAA8B;oBAC9B,wBAAwB;gBAC1B,MAAM,EAAE,iBAAiB;gBACzB,MAAM;gBACN,OAAO;gBACP,YAAY;gBACZ,WAAW,EAAE,SAAS;aACvB,CAAC;SACH,CAAA;IACH,CAAC;IAED,MAAM,WAAW,GAAuC,EAAE,CAAA;IAC1D,IAAI,YAAY,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACnC,WAAW,CAAC,IAAI,CACd,mCAAmC,CAAC;YAClC,OAAO;YACP,kBAAkB;YAClB,mBAAmB,EAAE,wBAAwB,IAAI,8BAA8B;YAC/E,MAAM,EAAE,uBAAuB;YAC/B,MAAM;YACN,OAAO;YACP,YAAY;YACZ,WAAW,EAAE,eAAe;SAC7B,CAAC,CACH,CAAA;IACH,CAAC;IAED,IAAI,kBAAkB,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC;QAC/E,WAAW,CAAC,IAAI,CACd,mCAAmC,CAAC;YAClC,OAAO;YACP,kBAAkB;YAClB,mBAAmB,EAAE,8BAA8B,IAAI,oCAAoC;YAC3F,MAAM,EAAE,6BAA6B;YACrC,MAAM;YACN,OAAO;YACP,YAAY;YACZ,WAAW,EAAE,qBAAqB;SACnC,CAAC,CACH,CAAA;IACH,CAAC;IAED,OAAO,WAAW,CAAA;AACpB,CAAC;AAED,SAAS,mCAAmC,CAAC,EAC3C,OAAO,EACP,kBAAkB,EAClB,mBAAmB,EACnB,MAAM,EACN,MAAM,EACN,OAAO,EACP,YAAY,EACZ,WAAW,GAUZ;IACC,OAAO;QACL,QAAQ,EAAE,uBAAuB;QACjC,OAAO;QACP,EAAE,EAAE,GAAG,kBAAkB,IAAI,MAAM,EAAE;QACrC,cAAc,EAAE;YACd,MAAM,EAAE,qBAAqB;YAC7B,MAAM,EAAE,OAAO;SAChB;QACD,OAAO,EAAE,GAAG,YAAY,qBAAqB,WAAW,2BAA2B,mBAAmB,GAAG;QACzG,QAAQ,EAAE,SAAS;QACnB,MAAM;QACN,OAAO;KACR,CAAA;AACH,CAAC"}

package/dist/presentation-content-resolution.d.ts

@@ -0,0 +1,9 @@
+import type { PresentationContentDefinition } from './module.js';
+export interface ProjectedPresentationContent {
+    readonly description: string | null;
+    readonly subtitle: string | null;
+    readonly title: string | null;
+}
+export declare function resolvePresentationContent(content: PresentationContentDefinition | null | undefined, data: unknown): ProjectedPresentationContent;
+export declare function resolveNonBlankPresentationText(value: string | null | undefined): string | null;
+//# sourceMappingURL=presentation-content-resolution.d.ts.map

package/dist/presentation-content-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-content-resolution.d.ts","sourceRoot":"","sources":["../src/presentation-content-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC9B,MAAM,UAAU,CAAA;AAOjB,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,6BAA6B,GAAG,IAAI,GAAG,SAAS,EACzD,IAAI,EAAE,OAAO,GACZ,4BAA4B,CAM9B;AAmBD,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,iBAE/E"}

package/dist/presentation-content-resolution.js

@@ -0,0 +1,19 @@
+import { formatPresentationValue, resolvePresentationTemplate, resolvePresentationValue, } from './presentation-value-resolution.js';
+export function resolvePresentationContent(content, data) {
+    return {
+        description: resolvePresentationContentDescription(content, data),
+        subtitle: resolvePresentationContentText(content?.Subtitle, data),
+        title: resolvePresentationContentText(content?.Title, data),
+    };
+}
+function resolvePresentationContentDescription(content, data) {
+    return (resolvePresentationContentText(content?.Description, data) ??
+        resolveNonBlankPresentationText(resolvePresentationTemplate(content?.DescriptionTemplate, data)));
+}
+function resolvePresentationContentText(value, data) {
+    return resolveNonBlankPresentationText(formatPresentationValue(resolvePresentationValue(value, data)));
+}
+export function resolveNonBlankPresentationText(value) {
+    return value && value.trim().length > 0 ? value : null;
+}
+//# sourceMappingURL=presentation-content-resolution.js.map

package/dist/presentation-content-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-content-resolution.js","sourceRoot":"","sources":["../src/presentation-content-resolution.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,iCAAiC,CAAA;AAQxC,MAAM,UAAU,0BAA0B,CACxC,OAAyD,EACzD,IAAa;IAEb,OAAO;QACL,WAAW,EAAE,qCAAqC,CAAC,OAAO,EAAE,IAAI,CAAC;QACjE,QAAQ,EAAE,8BAA8B,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC;QACjE,KAAK,EAAE,8BAA8B,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC;KAC5D,CAAA;AACH,CAAC;AAED,SAAS,qCAAqC,CAC5C,OAAyD,EACzD,IAAa;IAEb,OAAO,CACL,8BAA8B,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC;QAC1D,+BAA+B,CAAC,2BAA2B,CAAC,OAAO,EAAE,mBAAmB,EAAE,IAAI,CAAC,CAAC,CACjG,CAAA;AACH,CAAC;AAED,SAAS,8BAA8B,CACrC,KAA6C,EAC7C,IAAa;IAEb,OAAO,+BAA+B,CAAC,uBAAuB,CAAC,wBAAwB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;AACxG,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,KAAgC;IAC9E,OAAO,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAA;AACxD,CAAC"}

package/dist/presentation-data-source-binding-model.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Frontend realization strategies for semantic presentation data sources.
+ * These are projection/runtime binding kinds, not backend IR data-source kinds.
+ */
+export declare const presentationDataSourceBindingKinds: {
+    /**
+     * Realizes a data source through TanStack Query so React owns fetch lifecycle,
+     * caching, pending/error state, and refetch behavior.
+     */
+    readonly tanstackQuery: "tanstack-query";
+    /**
+     * Realizes a data source from already-available local/runtime data without
+     * invoking a query adapter.
+     */
+    readonly localValue: "local-value";
+};
+/**
+ * Declares whether a presentation data source can resolve in the current
+ * authorization context.
+ */
+export type PresentationDataSourceAuthorizationRequirement = {
+    readonly kind: 'none';
+} | {
+    readonly blockedLabel?: string;
+    readonly isAuthorized: boolean;
+    readonly kind: 'required';
+};
+/**
+ * Small constructors for keeping data source authorization declarations explicit
+ * at the binding site.
+ */
+export declare const presentationDataSourceAuthorization: {
+    none: () => PresentationDataSourceAuthorizationRequirement;
+    required: ({ blockedLabel, isAuthorized, }: {
+        readonly blockedLabel?: string;
+        readonly isAuthorized: boolean;
+    }) => PresentationDataSourceAuthorizationRequirement;
+};
+/**
+ * Declarative binding from a semantic presentation data source id to a concrete
+ * frontend source. Query bindings currently use TanStack Query.
+ */
+export type PresentationDataSourceBinding = PresentationLocalValueDataSourceBinding | PresentationTanStackQueryDataSourceBinding;
+export interface PresentationDataSourceBindingBase {
+    readonly authorization: PresentationDataSourceAuthorizationRequirement;
+    readonly blockedLabel?: string;
+    readonly dataSourceId: string;
+    readonly emptyMessage?: string;
+    readonly pendingLabel?: string;
+}
+export interface PresentationLocalValueDataSourceBinding extends PresentationDataSourceBindingBase {
+    readonly data: unknown;
+    readonly error?: unknown;
+    readonly isFetching?: boolean;
+    readonly isPending?: boolean;
+    readonly kind: typeof presentationDataSourceBindingKinds.localValue;
+    readonly refetch?: () => Promise<unknown> | unknown;
+}
+export interface PresentationTanStackQueryDataSourceBinding extends PresentationDataSourceBindingBase {
+    readonly enabled?: boolean;
+    readonly fallbackData?: unknown;
+    readonly kind: typeof presentationDataSourceBindingKinds.tanstackQuery;
+    readonly queryFn: () => Promise<unknown>;
+    readonly queryKey: readonly unknown[];
+    readonly refetchInterval?: number | false;
+    readonly retry?: boolean | number;
+    readonly staleTime?: number;
+}
+export type PresentationLocalValueDataSourceBindingInput = Omit<PresentationLocalValueDataSourceBinding, 'kind'>;
+export type PresentationTanStackQueryDataSourceBindingInput = Omit<PresentationTanStackQueryDataSourceBinding, 'kind'>;
+export declare const presentationDataSourceBindings: {
+    localValue: (binding: PresentationLocalValueDataSourceBindingInput) => PresentationLocalValueDataSourceBinding;
+    tanstackQuery: (binding: PresentationTanStackQueryDataSourceBindingInput) => PresentationTanStackQueryDataSourceBinding;
+};
+export interface DataSourceAuthorizationState {
+    readonly blockedLabel?: string;
+    readonly isBlocked: boolean;
+}
+export declare function resolveDataSourceAuthorization(binding: PresentationDataSourceBindingBase): DataSourceAuthorizationState;
+export declare function isTanStackQueryBinding(binding: PresentationDataSourceBinding): binding is PresentationTanStackQueryDataSourceBinding;
+//# sourceMappingURL=presentation-data-source-binding-model.d.ts.map

package/dist/presentation-data-source-binding-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-data-source-binding-model.d.ts","sourceRoot":"","sources":["../src/presentation-data-source-binding-model.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,kCAAkC;IAC7C;;;OAGG;;IAEH;;;OAGG;;CAEK,CAAA;AAEV;;;GAGG;AACH,MAAM,MAAM,8CAA8C,GACtD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IACE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAC1B,CAAA;AAEL;;;GAGG;AACH,eAAO,MAAM,mCAAmC;gBACpC,8CAA8C;gDAIrD;QACD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;QAC9B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;KAC/B,KAAG,8CAA8C;CAKnD,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GACrC,uCAAuC,GACvC,0CAA0C,CAAA;AAE9C,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,aAAa,EAAE,8CAA8C,CAAA;IACtE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED,MAAM,WAAW,uCACf,SAAQ,iCAAiC;IACzC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,IAAI,EAAE,OAAO,kCAAkC,CAAC,UAAU,CAAA;IACnE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA;CACpD;AAED,MAAM,WAAW,0CACf,SAAQ,iCAAiC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;IAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,kCAAkC,CAAC,aAAa,CAAA;IACtE,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;IACrC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,MAAM,4CAA4C,GAAG,IAAI,CAC7D,uCAAuC,EACvC,MAAM,CACP,CAAA;AAED,MAAM,MAAM,+CAA+C,GAAG,IAAI,CAChE,0CAA0C,EAC1C,MAAM,CACP,CAAA;AAED,eAAO,MAAM,8BAA8B;0BAE9B,4CAA4C,KACpD,uCAAuC;6BAK/B,+CAA+C,KACvD,0CAA0C;CAI9C,CAAA;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,iCAAiC,GACzC,4BAA4B,CAe9B;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,6BAA6B,GACrC,OAAO,IAAI,0CAA0C,CAEvD"}

package/dist/presentation-data-source-binding-model.js

@@ -0,0 +1,56 @@
+/**
+ * Frontend realization strategies for semantic presentation data sources.
+ * These are projection/runtime binding kinds, not backend IR data-source kinds.
+ */
+export const presentationDataSourceBindingKinds = {
+    /**
+     * Realizes a data source through TanStack Query so React owns fetch lifecycle,
+     * caching, pending/error state, and refetch behavior.
+     */
+    tanstackQuery: 'tanstack-query',
+    /**
+     * Realizes a data source from already-available local/runtime data without
+     * invoking a query adapter.
+     */
+    localValue: 'local-value',
+};
+/**
+ * Small constructors for keeping data source authorization declarations explicit
+ * at the binding site.
+ */
+export const presentationDataSourceAuthorization = {
+    none: () => ({ kind: 'none' }),
+    required: ({ blockedLabel, isAuthorized, }) => ({
+        blockedLabel,
+        isAuthorized,
+        kind: 'required',
+    }),
+};
+export const presentationDataSourceBindings = {
+    localValue: (binding) => ({
+        ...binding,
+        kind: presentationDataSourceBindingKinds.localValue,
+    }),
+    tanstackQuery: (binding) => ({
+        ...binding,
+        kind: presentationDataSourceBindingKinds.tanstackQuery,
+    }),
+};
+export function resolveDataSourceAuthorization(binding) {
+    if (binding.authorization.kind === 'required' && !binding.authorization.isAuthorized) {
+        return {
+            blockedLabel: binding.authorization.blockedLabel ?? binding.blockedLabel,
+            isBlocked: true,
+        };
+    }
+    return {
+        blockedLabel: binding.authorization.kind === 'required'
+            ? binding.authorization.blockedLabel ?? binding.blockedLabel
+            : binding.blockedLabel,
+        isBlocked: false,
+    };
+}
+export function isTanStackQueryBinding(binding) {
+    return binding.kind === presentationDataSourceBindingKinds.tanstackQuery;
+}
+//# sourceMappingURL=presentation-data-source-binding-model.js.map

package/dist/presentation-data-source-binding-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-data-source-binding-model.js","sourceRoot":"","sources":["../src/presentation-data-source-binding-model.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG;IAChD;;;OAGG;IACH,aAAa,EAAE,gBAAgB;IAC/B;;;OAGG;IACH,UAAU,EAAE,aAAa;CACjB,CAAA;AAcV;;;GAGG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG;IACjD,IAAI,EAAE,GAAmD,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC9E,QAAQ,EAAE,CAAC,EACT,YAAY,EACZ,YAAY,GAIb,EAAkD,EAAE,CAAC,CAAC;QACrD,YAAY;QACZ,YAAY;QACZ,IAAI,EAAE,UAAU;KACjB,CAAC;CACH,CAAA;AAkDD,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,UAAU,EAAE,CACV,OAAqD,EACZ,EAAE,CAAC,CAAC;QAC7C,GAAG,OAAO;QACV,IAAI,EAAE,kCAAkC,CAAC,UAAU;KACpD,CAAC;IACF,aAAa,EAAE,CACb,OAAwD,EACZ,EAAE,CAAC,CAAC;QAChD,GAAG,OAAO;QACV,IAAI,EAAE,kCAAkC,CAAC,aAAa;KACvD,CAAC;CACH,CAAA;AAOD,MAAM,UAAU,8BAA8B,CAC5C,OAA0C;IAE1C,IAAI,OAAO,CAAC,aAAa,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,YAAY,EAAE,CAAC;QACrF,OAAO;YACL,YAAY,EAAE,OAAO,CAAC,aAAa,CAAC,YAAY,IAAI,OAAO,CAAC,YAAY;YACxE,SAAS,EAAE,IAAI;SAChB,CAAA;IACH,CAAC;IAED,OAAO;QACL,YAAY,EACV,OAAO,CAAC,aAAa,CAAC,IAAI,KAAK,UAAU;YACvC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,YAAY,IAAI,OAAO,CAAC,YAAY;YAC5D,CAAC,CAAC,OAAO,CAAC,YAAY;QAC1B,SAAS,EAAE,KAAK;KACjB,CAAA;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,OAAsC;IAEtC,OAAO,OAAO,CAAC,IAAI,KAAK,kCAAkC,CAAC,aAAa,CAAA;AAC1E,CAAC"}

package/dist/presentation-data-source-runtime.d.ts

@@ -0,0 +1,62 @@
+import type { DataSourceDefinition, ViewDefinition } from './module.js';
+import { type ProjectedActivityState } from './projected-activity-state-model.js';
+export { readObjectPath, readObjectProperty, } from './object-path.js';
+export interface PresentationDataSourceState<TData = unknown> {
+    readonly blockedLabel?: string;
+    readonly data?: TData;
+    readonly definition?: DataSourceDefinition | null;
+    readonly emptyMessage?: string;
+    readonly error?: unknown;
+    readonly isBlocked?: boolean;
+    readonly isFetching?: boolean;
+    readonly isPending?: boolean;
+    readonly pendingLabel?: string;
+    readonly refetch?: () => Promise<unknown> | unknown;
+}
+export type PresentationDataSourceStateMap = Readonly<Record<string, PresentationDataSourceState>>;
+/**
+ * Resolves presentation data sources from their semantic identifiers without
+ * flattening the state map into an ad hoc component data context.
+ */
+export interface PresentationDataSourceResolver {
+    /**
+     * Bound runtime state keyed by semantic presentation data source id.
+     */
+    readonly dataSources: PresentationDataSourceStateMap;
+    /**
+     * Reads the raw data payload for a data source.
+     */
+    readonly read: <TData = unknown>(dataSourceId: string) => TData | undefined;
+    /**
+     * Reads a nested value from a data source payload using a dot-separated field path.
+     */
+    readonly readPath: (dataSourceId: string, fieldPath?: string | null) => unknown;
+    /**
+     * Resolves the full runtime state for a data source, including activity and refetch metadata.
+     */
+    readonly resolve: <TData = unknown>(dataSourceId: string) => PresentationDataSourceState<TData> | undefined;
+    /**
+     * Resolves all data source states declared by a view subject and explicit data source ids.
+     */
+    readonly resolveViewDataSources: (view: Pick<ViewDefinition, 'Collection' | 'DataSourceIds' | 'Subject'>) => readonly PresentationDataSourceState[];
+    /**
+     * Resolves the primary data source state for a view, preferring the view subject source.
+     */
+    readonly resolveViewPrimary: <TData = unknown>(view: Pick<ViewDefinition, 'Collection' | 'DataSourceIds' | 'Subject'>) => PresentationDataSourceState<TData> | undefined;
+}
+/**
+ * Creates a stable semantic resolver over a bound presentation data source map.
+ */
+export declare function createPresentationDataSourceResolver(dataSources: PresentationDataSourceStateMap): PresentationDataSourceResolver;
+export declare function createPresentationViewActivityState({ blockedLabel, dataSourceResolver, pendingLabel, view, }: {
+    readonly blockedLabel?: string;
+    readonly dataSourceResolver: PresentationDataSourceResolver;
+    readonly pendingLabel?: string;
+    readonly view: ViewDefinition;
+}): ProjectedActivityState;
+export declare function isPresentationViewFetching(view: ViewDefinition, dataSourceResolver: PresentationDataSourceResolver): boolean;
+export declare function readPresentationDataSourceItems<TItem extends object = object>(state: PresentationDataSourceState | null | undefined): readonly TItem[];
+export declare function refreshPresentationDataSources(dataSourceResolver: PresentationDataSourceResolver, dataSourceIds: readonly string[]): Promise<undefined>;
+export declare function resolvePresentationViewDataSourceIds(view: Pick<ViewDefinition, 'Collection' | 'DataSourceIds' | 'Subject'>): string[];
+export declare function resolvePresentationViewPrimaryDataSourceId(view: Pick<ViewDefinition, 'Collection' | 'DataSourceIds' | 'Subject'>): string;
+//# sourceMappingURL=presentation-data-source-runtime.d.ts.map

package/dist/presentation-data-source-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-data-source-runtime.d.ts","sourceRoot":"","sources":["../src/presentation-data-source-runtime.ts"],"names":[],"mappings":"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"}