@cohesivesystems/presentation-core 0.1.0-alpha.1

package/dist/projected-collection-action-runtime-diagnostics.js

@@ -0,0 +1,168 @@
+import { findPresentationAction, } from './module.js';
+import { createPresentationProjectionDiagnostic, } from './presentation-projection-diagnostics.js';
+import { getPresentationViewProjectedActions, } from './presentation-semantics.js';
+/**
+ * Reports whether projected collection row/selection actions are actually
+ * interpreted by the frontend action runtime registry.
+ */
+export function projectProjectedCollectionActionRuntimeDiagnostics({ actionRuntimes, collectionRuntime, module, projectActionIconDiagnostics, view, }) {
+    if (!view) {
+        return [];
+    }
+    const diagnostics = [];
+    diagnostics.push(...projectMissingCatalogActionDiagnostics({ module, view }));
+    if (projectActionIconDiagnostics) {
+        diagnostics.push(...projectActionIconDiagnostics({
+            actionPlacements: getPresentationViewProjectedActions(view)
+                .filter((actionRef) => actionRef.contextKind === 'collection-row' ||
+                actionRef.contextKind === 'collection-selection')
+                .map((actionRef) => actionRef.placement),
+            module,
+            source: `projected-collection-action-icons:${view.Id}`,
+            surfaceId: view.Id,
+            surfaceName: view.Name,
+        }));
+    }
+    const firstRow = collectionRuntime.data[0] ?? null;
+    for (const rowAction of collectionRuntime.actions.rowActions) {
+        diagnostics.push(...projectResolvedActionRuntimeDiagnostics({
+            action: rowAction.action,
+            actionRefSource: rowAction.actionRef.source,
+            context: firstRow
+                ? collectionRuntime.actions.createRowActionContext(rowAction, firstRow)
+                : null,
+            contextKind: 'collection-row',
+            runtime: actionRuntimes[rowAction.action.Id],
+            slotId: rowAction.slotId ?? null,
+            view,
+        }));
+    }
+    for (const selectionAction of collectionRuntime.actions.selectionActions) {
+        const selectedItem = collectionRuntime.actions.resolveSelectionActionItems({
+            selectionActions: [selectionAction],
+        })[0];
+        diagnostics.push(...projectResolvedActionRuntimeDiagnostics({
+            action: selectionAction.action,
+            actionRefSource: selectionAction.actionRef.source,
+            context: selectedItem?.actionContext ?? null,
+            contextKind: 'collection-selection',
+            runtime: actionRuntimes[selectionAction.action.Id],
+            slotId: selectionAction.slotId ?? null,
+            view,
+        }));
+    }
+    return diagnostics;
+}
+function projectMissingCatalogActionDiagnostics({ module, view, }) {
+    return getPresentationViewProjectedActions(view).flatMap((actionRef) => {
+        if (actionRef.contextKind !== 'collection-row' &&
+            actionRef.contextKind !== 'collection-selection') {
+            return [];
+        }
+        if (findPresentationAction(module, actionRef.actionId)) {
+            return [];
+        }
+        return [
+            createDiagnostic({
+                actionId: actionRef.actionId,
+                actionName: null,
+                actionRefSource: actionRef.source,
+                contextKind: actionRef.contextKind,
+                message: `Collection ${formatContextKind(actionRef.contextKind)} action ` +
+                    `'${actionRef.actionId}' on '${view.Name}' is projected but is not present in the action catalog.`,
+                reason: `missing-action.${actionRef.source}`,
+                severity: 'error',
+                slotId: actionRef.slotId ?? null,
+                status: 'unbound',
+                target: 'action-catalog',
+                view,
+            }),
+        ];
+    });
+}
+function projectResolvedActionRuntimeDiagnostics({ action, actionRefSource, context, contextKind, runtime, slotId, view, }) {
+    const diagnostics = [];
+    if (!runtime?.execute) {
+        diagnostics.push(createDiagnostic({
+            action,
+            actionRefSource,
+            contextKind,
+            message: `Collection ${formatContextKind(contextKind)} action '${action.Name}' ` +
+                `on '${view.Name}' has no projected frontend action runtime binding.`,
+            reason: `missing-runtime.${actionRefSource}`,
+            severity: 'warning',
+            slotId,
+            status: 'unbound',
+            target: 'collection-action-runtime-registry',
+            view,
+        }));
+        return diagnostics;
+    }
+    if (runtime.isHidden || runtime.isDisabled) {
+        diagnostics.push(createDiagnostic({
+            action,
+            actionRefSource,
+            contextKind,
+            message: `Collection ${formatContextKind(contextKind)} action '${action.Name}' ` +
+                `on '${view.Name}' has a runtime binding, but it is disabled or hidden.`,
+            reason: `disabled-runtime.${actionRefSource}`,
+            severity: 'info',
+            slotId,
+            status: 'bound',
+            target: 'collection-action-runtime-registry',
+            view,
+        }));
+    }
+    if (context && runtime.canExecute && !runtime.canExecute(context)) {
+        diagnostics.push(createDiagnostic({
+            action,
+            actionRefSource,
+            contextKind,
+            message: `Collection ${formatContextKind(contextKind)} action '${action.Name}' ` +
+                `on '${view.Name}' has a runtime binding, but it cannot execute for the current context.`,
+            reason: `disabled-runtime.${actionRefSource}`,
+            severity: 'info',
+            slotId,
+            status: 'bound',
+            target: 'collection-action-runtime-registry',
+            view,
+        }));
+    }
+    return diagnostics;
+}
+function createDiagnostic({ action, actionId, actionName, actionRefSource, category = 'missing-binding', contextKind, message, reason, severity, slotId, status, target, view, }) {
+    const resolvedActionId = action?.Id ?? actionId ?? 'unknown-action';
+    return createPresentationProjectionDiagnostic({
+        category,
+        details: {
+            actionId: resolvedActionId,
+            actionKind: action?.Kind ?? null,
+            actionRefSource,
+            actionScope: action?.Scope ?? null,
+            bindingKind: action?.Binding.Kind ?? null,
+            contextKind,
+            slotId,
+            viewId: view.Id,
+        },
+        id: `collection-action-runtime.${view.Id}.${resolvedActionId}.${reason}`,
+        interpretation: {
+            status,
+            target,
+        },
+        message,
+        severity,
+        source: 'projected-collection-action-runtime',
+        subject: {
+            id: resolvedActionId,
+            kind: 'action',
+            name: action?.Name ?? actionName ?? null,
+        },
+        suggestedNextStep: status === 'unbound'
+            ? 'Add a generic collection action runtime binding for this projected action.'
+            : undefined,
+    });
+}
+function formatContextKind(contextKind) {
+    return contextKind === 'collection-row' ? 'row' : 'selection';
+}
+//# sourceMappingURL=projected-collection-action-runtime-diagnostics.js.map

package/dist/projected-collection-action-runtime-diagnostics.js.map

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

package/dist/projected-collection-runtime.d.ts

@@ -0,0 +1,475 @@
+import type { ActionDefinition, CollectionChromeDefinition, CollectionChromeSlotDefinition, CollectionChromeSlotPlacement, CollectionColumnDefinition, CollectionRowActionDefinition, CollectionSelectionActionDefinition, CollectionSelectionMode, FieldPresentationDefinition, PresentationModuleDefinition, ViewDefinition } from './module.js';
+import type { CollectionChromeRuntime } from './collection-chrome-runtime.js';
+import { type PresentationViewProjectedActionRef } from './presentation-semantics.js';
+import type { CollectionSelectionStateEntry } from './collection-selection-state.js';
+import type { NavigationRouteParameters } from './navigation.js';
+import { type PresentationPaginationBinding, type PresentationPaginationRuntime, type PresentationPaginationState, type ResolvedPresentationPageInfo } from './presentation-pagination.js';
+import type { PresentationActionRuntimeRegistry } from './presentation-action-runtime-projection.js';
+/**
+ * Collection definition projected from a presentation view.
+ */
+export type ProjectedCollectionDefinition = NonNullable<ViewDefinition['Collection']>;
+type ProjectedCollectionRowActionDefinition = CollectionRowActionDefinition;
+type ProjectedCollectionSelectionActionDefinition = CollectionSelectionActionDefinition;
+type ProjectedCollectionModuleDefinition = Pick<PresentationModuleDefinition, 'Actions' | 'Fields' | 'Targets'>;
+/**
+ * Annotation name used on collection chrome definitions to describe how the
+ * chrome was projected.
+ */
+export declare const collectionChromeProjectionAnnotationName = "cohesive.presentation.collection-chrome.projection";
+/**
+ * Annotation name used on collection chrome slot definitions to describe how a
+ * specific slot was projected.
+ */
+export declare const collectionChromeSlotProjectionAnnotationName = "cohesive.presentation.collection-chrome.slot.projection";
+/**
+ * Projection-mode tokens emitted by compatibility and declared collection
+ * chrome projection paths.
+ */
+export declare const collectionChromeProjectionModes: {
+    readonly compatibilitySynthesized: "compatibility-synthesized";
+    readonly declared: "declared";
+    readonly mixed: "mixed";
+};
+/**
+ * Supported collection chrome projection modes.
+ */
+export type CollectionChromeProjectionMode = typeof collectionChromeProjectionModes[keyof typeof collectionChromeProjectionModes];
+/**
+ * Minimal action placement shape shared by row and selection action projections.
+ */
+export interface ProjectedActionPlacementLike {
+    /** Action identifier resolved against the containing presentation module. */
+    readonly ActionId: string;
+    /** Optional icon override projected onto the placement. */
+    readonly Icon?: string | null;
+    /** Optional label override projected onto the placement. */
+    readonly Label?: string | null;
+    /** Optional region or surface hint for placement-specific rendering. */
+    readonly Region?: string | null;
+}
+/**
+ * Row action resolved from a view action reference and module action
+ * definition.
+ */
+export interface ResolvedProjectedCollectionRowAction {
+    /** Concrete action definition invoked by the row action. */
+    readonly action: ActionDefinition;
+    /** View-level projected action reference that introduced the action. */
+    readonly actionRef: PresentationViewProjectedActionRef;
+    /** Collection row action placement metadata. */
+    readonly rowAction: CollectionRowActionDefinition;
+    /** Chrome slot that owns the action, when known. */
+    readonly slotId?: string | null;
+}
+/**
+ * Selection action resolved from a view action reference and module action
+ * definition.
+ */
+export interface ResolvedProjectedCollectionSelectionAction {
+    /** Concrete action definition invoked by the selection action. */
+    readonly action: ActionDefinition;
+    /** View-level projected action reference that introduced the action. */
+    readonly actionRef: PresentationViewProjectedActionRef;
+    /** Collection selection action placement metadata. */
+    readonly selectionAction: CollectionSelectionActionDefinition;
+    /** Chrome slot that owns the action, when known. */
+    readonly slotId?: string | null;
+}
+/**
+ * Render-ready row action item for a specific collection row.
+ */
+export interface ProjectedCollectionRowActionItem<TData extends object> {
+    /** Concrete action definition invoked by this item. */
+    readonly action: ActionDefinition;
+    /** Execution context bound to the row. */
+    readonly actionContext: ProjectedRowActionExecutionContext<TData>;
+    /** View-level projected action reference. */
+    readonly actionRef: PresentationViewProjectedActionRef;
+    /** Whether the action passes semantic predicates and host runtime checks. */
+    readonly isEnabled: boolean;
+    /** Row action placement metadata. */
+    readonly rowAction: CollectionRowActionDefinition;
+}
+/**
+ * Render-ready selection action item for the current collection selection.
+ */
+export interface ProjectedCollectionSelectionActionItem<TData extends object> {
+    /** Concrete action definition invoked by this item. */
+    readonly action: ActionDefinition;
+    /** Execution context bound to the current selection. */
+    readonly actionContext: ProjectedSelectionActionExecutionContext<TData>;
+    /** View-level projected action reference. */
+    readonly actionRef: PresentationViewProjectedActionRef;
+    /** Whether the action passes semantic predicates and host runtime checks. */
+    readonly isEnabled: boolean;
+    /** Selection action placement metadata. */
+    readonly selectionAction: CollectionSelectionActionDefinition;
+}
+/**
+ * Discriminator for action execution contexts created by the projected
+ * collection runtime.
+ */
+export type ProjectedCollectionActionContextKind = 'collection-row' | 'collection-selection';
+/**
+ * Union of row-scoped and selection-scoped collection action contexts.
+ */
+export type ProjectedCollectionActionExecutionContext<TData extends object> = ProjectedRowActionExecutionContext<TData> | ProjectedSelectionActionExecutionContext<TData>;
+/**
+ * Host action runtime registry keyed by action identifier.
+ */
+export type ProjectedCollectionActionRuntimeRegistry<TData extends object> = PresentationActionRuntimeRegistry<ProjectedCollectionActionExecutionContext<TData>, unknown>;
+/**
+ * Execution context for an action bound to a single collection row.
+ */
+export interface ProjectedRowActionExecutionContext<TData extends object> {
+    /** Concrete action definition to execute. */
+    readonly action: ActionDefinition;
+    /** View-level projected action reference. */
+    readonly actionRef: PresentationViewProjectedActionRef;
+    /** Context discriminator for runtime dispatch. */
+    readonly contextKind: 'collection-row';
+    /** Navigation href derived from the action route and bound parameters. */
+    readonly href: string | null;
+    /** Route or action parameters derived from the row. */
+    readonly parameters: NavigationRouteParameters;
+    /** Row that the action targets. */
+    readonly row: TData;
+    /** Row action placement metadata. */
+    readonly rowAction: CollectionRowActionDefinition;
+}
+/**
+ * Execution context for an action bound to the current collection selection.
+ */
+export interface ProjectedSelectionActionExecutionContext<TData extends object> {
+    /** Concrete action definition to execute. */
+    readonly action: ActionDefinition;
+    /** View-level projected action reference. */
+    readonly actionRef: PresentationViewProjectedActionRef;
+    /** Context discriminator for runtime dispatch. */
+    readonly contextKind: 'collection-selection';
+    /** Navigation href derived from the action route and bound parameters. */
+    readonly href: string | null;
+    /** Route or action parameters derived from selected rows. */
+    readonly parameters: NavigationRouteParameters;
+    /** Stable identities for the selected rows. */
+    readonly selectedRowIds: readonly string[];
+    /** Data objects for selected rows currently visible to the runtime. */
+    readonly selectedRows: readonly TData[];
+    /** Selection action placement metadata. */
+    readonly selectionAction: CollectionSelectionActionDefinition;
+}
+/**
+ * Action runtime projected from collection row and selection action semantics.
+ */
+export interface ProjectedCollectionActionRuntime<TData extends object> {
+    /** Row action invoked by row activation, such as row click, when configured. */
+    readonly activatedRowAction: ResolvedProjectedCollectionRowAction | null;
+    /** Checks whether a row or selection action can be invoked by host runtime. */
+    readonly canInvokeAction: (context: ProjectedCollectionActionExecutionContext<TData>, actionRuntimes?: ProjectedCollectionActionRuntimeRegistry<TData>) => boolean;
+    /** Checks whether a row action can be invoked by host runtime. */
+    readonly canInvokeRowAction: (context: ProjectedRowActionExecutionContext<TData>, actionRuntimes?: ProjectedCollectionActionRuntimeRegistry<TData>) => boolean;
+    /** Checks whether a selection action can be invoked by host runtime. */
+    readonly canInvokeSelectionAction: (context: ProjectedSelectionActionExecutionContext<TData>, actionRuntimes?: ProjectedCollectionActionRuntimeRegistry<TData>) => boolean;
+    /** Row actions intended for contextual surfaces such as menus. */
+    readonly contextRowActions: readonly ResolvedProjectedCollectionRowAction[];
+    /** Creates an execution context for a resolved row action and row. */
+    readonly createRowActionContext: (resolvedAction: ResolvedProjectedCollectionRowAction, row: TData) => ProjectedRowActionExecutionContext<TData>;
+    /** Invokes a row or selection action through the supplied host runtimes. */
+    readonly invokeAction: (context: ProjectedCollectionActionExecutionContext<TData>, actionRuntimes?: ProjectedCollectionActionRuntimeRegistry<TData>) => Promise<void>;
+    /** Invokes a row action through the supplied host runtimes. */
+    readonly invokeRowAction: (context: ProjectedRowActionExecutionContext<TData>, actionRuntimes?: ProjectedCollectionActionRuntimeRegistry<TData>) => Promise<void>;
+    /** Invokes a selection action through the supplied host runtimes. */
+    readonly invokeSelectionAction: (context: ProjectedSelectionActionExecutionContext<TData>, actionRuntimes?: ProjectedCollectionActionRuntimeRegistry<TData>) => Promise<void>;
+    /** Row actions intended for primary inline affordances. */
+    readonly primaryRowActions: readonly ResolvedProjectedCollectionRowAction[];
+    /** Resolves render-ready row action items for a specific row. */
+    readonly resolveRowActionItems: (row: TData, rowActions: readonly ResolvedProjectedCollectionRowAction[], options?: ProjectedCollectionRowActionItemOptions<TData>) => readonly ProjectedCollectionRowActionItem<TData>[];
+    /** Resolves render-ready selection action items for current selection. */
+    readonly resolveSelectionActionItems: (options?: ProjectedCollectionSelectionActionItemOptions<TData>) => readonly ProjectedCollectionSelectionActionItem<TData>[];
+    /** All resolved row actions declared for the collection view. */
+    readonly rowActions: readonly ResolvedProjectedCollectionRowAction[];
+    /** All resolved selection actions declared for the collection view. */
+    readonly selectionActions: readonly ResolvedProjectedCollectionSelectionAction[];
+}
+/**
+ * Options for resolving row action items.
+ */
+export interface ProjectedCollectionRowActionItemOptions<TData extends object> {
+    /** Optional host-level predicate layered after semantic visibility checks. */
+    readonly canExecuteAction?: (context: ProjectedCollectionActionExecutionContext<TData>) => boolean;
+}
+/**
+ * Options for resolving selection action items.
+ */
+export interface ProjectedCollectionSelectionActionItemOptions<TData extends object> {
+    /** Optional host-level predicate layered after semantic visibility checks. */
+    readonly canExecuteAction?: (context: ProjectedCollectionActionExecutionContext<TData>) => boolean;
+    /** Optional subset of selection actions to resolve. */
+    readonly selectionActions?: readonly ResolvedProjectedCollectionSelectionAction[];
+}
+/**
+ * Host callback used to navigate to an already-created href.
+ */
+export type ProjectedNavigateHref = (href: string) => void;
+/**
+ * Runtime representation of a projected collection column.
+ */
+export interface ProjectedCollectionColumnRuntime<TData extends object> {
+    /** Column declaration from the body chrome slot. */
+    readonly column: CollectionColumnDefinition;
+    /** Field definition resolved from the presentation module. */
+    readonly field: FieldPresentationDefinition;
+    /** Header label to render for the column. */
+    readonly header: string;
+    /** Stable column identifier. */
+    readonly id: string;
+    /** Reads this column's value from a row. */
+    readonly readValue: (row: TData) => unknown;
+    /** Object path used to read row values for the column. */
+    readonly valuePath: string;
+}
+/**
+ * Runtime collection chrome shape shared with the core chrome resolver.
+ */
+export type ProjectedCollectionChromeRuntime = CollectionChromeRuntime;
+/**
+ * Inputs used to bind collection pagination chrome to a concrete pagination
+ * runtime and data-source response.
+ */
+export interface ProjectedCollectionPaginationInput {
+    /** Whether the data source backing the collection is currently fetching. */
+    readonly isFetching?: boolean;
+    /** Reads a data source result by identifier for pagination metadata. */
+    readonly readDataSource?: (dataSourceId: string) => unknown;
+    /** Current response from the paged data source. */
+    readonly response?: unknown;
+    /** Host pagination runtime for changing page state. */
+    readonly runtime?: PresentationPaginationRuntime | null;
+    /** Explicit total count override when the response does not carry one. */
+    readonly totalCount?: number | null;
+}
+/**
+ * Runtime pagination state projected from collection chrome and host paging
+ * runtime.
+ */
+export interface ProjectedCollectionPaginationRuntime {
+    /** Data source identifier named by the pagination slot, when present. */
+    readonly dataSourceId: string | null;
+    /** Pagination slot definition, when pagination is declared. */
+    readonly definition: CollectionChromeSlotDefinition | null;
+    /** Whether the collection declares a pagination slot. */
+    readonly isEnabled: boolean;
+    /** Whether the backing data source is currently fetching. */
+    readonly isFetching: boolean;
+    /** Whether pagination should render in footer chrome. */
+    readonly isFooterEnabled: boolean;
+    /** Declared pagination slot placement. */
+    readonly placement: CollectionChromeSlotDefinition['Placement'] | null;
+    /** Pagination slot definition, when pagination is declared. */
+    readonly slot: CollectionChromeSlotDefinition | null;
+    /** Active paging window when a host runtime and page info are available. */
+    readonly window: ProjectedCollectionWindowRuntime | null;
+}
+/**
+ * Page navigation window exposed to collection chrome renderers.
+ */
+export interface ProjectedCollectionWindowRuntime {
+    /** Pagination binding that describes the paging strategy. */
+    readonly binding: PresentationPaginationBinding;
+    /** Whether a next page can be requested. */
+    readonly canGoNextPage: boolean;
+    /** Whether a previous page can be requested. */
+    readonly canGoPreviousPage: boolean;
+    /** Data source controlled by this pagination window. */
+    readonly dataSourceId: string;
+    /** Navigates to the first page. */
+    readonly goToFirstPage: () => void;
+    /** Navigates to the next page using the current response as cursor context. */
+    readonly goToNextPage: () => void;
+    /** Navigates to the previous page. */
+    readonly goToPreviousPage: () => void;
+    /** Zero-based page index. */
+    readonly pageIndex: number;
+    /** Resolved page metadata for labels and navigation state. */
+    readonly pageInfo: ResolvedPresentationPageInfo;
+    /** Current page size. */
+    readonly pageSize: number;
+    /** Mutable pagination state owned by the host runtime. */
+    readonly state: PresentationPaginationState;
+}
+/**
+ * Inputs required to project a collection runtime from view IR and concrete
+ * data.
+ */
+export interface ProjectedCollectionRuntimeOptions<TData extends object> {
+    /** Optional href factory for navigation actions. */
+    readonly createHref?: (routeId: string, parameters?: NavigationRouteParameters) => string | null;
+    /** Data rows currently visible in the collection. */
+    readonly data: readonly TData[];
+    /** Presentation module used to resolve fields and actions. */
+    readonly module?: ProjectedCollectionModuleDefinition | null;
+    /** Optional pagination bridge for collection pagination chrome. */
+    readonly pagination?: ProjectedCollectionPaginationInput | null;
+    /** Optional mutable selection state shared across projected runtimes. */
+    readonly selectionState?: CollectionSelectionStateEntry | null;
+    /** View definition containing the collection IR to project. */
+    readonly view?: ViewDefinition | null;
+}
+/**
+ * Runtime projection of a collection view over concrete row data.
+ *
+ * The runtime keeps backend-declared collection semantics as the source of
+ * truth for columns, chrome, actions, selection, detail, and pagination while
+ * exposing host-friendly functions for rendering and execution.
+ */
+export interface ProjectedCollectionRuntime<TData extends object> {
+    /** Projected row and selection action runtime. */
+    readonly actions: ProjectedCollectionActionRuntime<TData>;
+    /** Resolved collection chrome slots and slot shortcuts. */
+    readonly chrome: ProjectedCollectionChromeRuntime;
+    /** Visible body columns resolved against module fields. */
+    readonly columns: readonly ProjectedCollectionColumnRuntime<TData>[];
+    /** Collection definition from the view, when present. */
+    readonly collection: ProjectedCollectionDefinition | null;
+    /** Data rows currently visible in the collection. */
+    readonly data: readonly TData[];
+    /** Detail projection state derived from selection and detail chrome. */
+    readonly detail: ProjectedCollectionDetailRuntime<TData>;
+    /** Reads a stable row identity when the body slot declares one. */
+    readonly getRowId?: (row: TData, index: number) => string;
+    /** Pagination runtime projected from pagination chrome. */
+    readonly pagination: ProjectedCollectionPaginationRuntime;
+    /** Reads the best available row label for display and accessibility. */
+    readonly readRowLabel: (row: TData) => string | null;
+    /** Raw row action declarations resolved from the collection. */
+    readonly rowActions: readonly ProjectedCollectionRowActionDefinition[];
+    /** Selection runtime projected from collection selection semantics. */
+    readonly selection: ProjectedCollectionSelectionRuntime<TData>;
+    /** Raw selection action declarations resolved from the collection. */
+    readonly selectionActions: readonly ProjectedCollectionSelectionActionDefinition[];
+}
+/**
+ * Runtime selection state and operations for a projected collection.
+ */
+export interface ProjectedCollectionSelectionRuntime<TData extends object> {
+    /** Activates a row according to the collection selection mode. */
+    readonly activateRow: (row: TData, index: number) => void;
+    /** Whether row selection is enabled. */
+    readonly isEnabled: boolean;
+    /** Whether the selection mode supports multiple rows. */
+    readonly isMultiple: boolean;
+    /** Tests whether a row is currently selected, when row identity is available. */
+    readonly isRowSelected?: (row: TData, index: number) => boolean;
+    /** Declared collection selection mode. */
+    readonly mode: CollectionSelectionMode;
+    /** Removes selected row ids that are no longer visible when configured. */
+    readonly pruneToVisibleRows: () => void;
+    /** First selected visible row, used by single-row detail projections. */
+    readonly selectedRow: TData | null;
+    /** Set view of selected row identities for efficient membership checks. */
+    readonly selectedRowIdSet: ReadonlySet<string>;
+    /** Selected row identities from the active selection state. */
+    readonly selectedRowIds: readonly string[];
+    /** Selected rows that are currently visible in `data`. */
+    readonly selectedRows: readonly TData[];
+    /** Active mutable selection state, or `null` when selection is disabled. */
+    readonly state: CollectionSelectionStateEntry | null;
+}
+/**
+ * Runtime state for the detail surface associated with the selected row.
+ */
+export interface ProjectedCollectionDetailRuntime<TData extends object> {
+    /** Selected row data shown by the detail surface. */
+    readonly data: TData | null;
+    /** Message to show when no detail row is selected. */
+    readonly emptyMessage?: string | null;
+    /** Whether the detail slot has enough semantic information to render. */
+    readonly isRenderable: boolean;
+    /** Declared detail slot placement. */
+    readonly placement?: CollectionChromeSlotPlacement | null;
+    /** Detail surface title. */
+    readonly title?: string | null;
+    /** Detail view identifier projected for the selected row. */
+    readonly viewId: string | null;
+}
+/**
+ * Creates the host-facing runtime for a projected collection.
+ *
+ * @param options View IR, data, module metadata, selection state, pagination,
+ * and navigation hooks used to bind collection semantics to runtime behavior.
+ */
+export declare function createProjectedCollectionRuntime<TData extends object>({ createHref, data, module, pagination: paginationInput, selectionState, view, }: ProjectedCollectionRuntimeOptions<TData>): ProjectedCollectionRuntime<TData>;
+/**
+ * Creates the collection chrome runtime for a projected collection definition.
+ */
+export declare function createProjectedCollectionChromeRuntime(collection: ProjectedCollectionDefinition | null | undefined): ProjectedCollectionChromeRuntime;
+/**
+ * Resolves all collection chrome slots from a collection definition.
+ */
+export declare function resolveProjectedCollectionChromeSlots(collection: ProjectedCollectionDefinition | null | undefined): readonly CollectionChromeSlotDefinition[];
+/**
+ * Resolves the selection state identifier implied by collection chrome.
+ *
+ * Body state is preferred, followed by selection actions and detail state.
+ */
+export declare function resolveProjectedCollectionSelectionStateId(collection: ProjectedCollectionDefinition | null | undefined): string | null;
+/**
+ * Resolves the collection selection mode, defaulting to `none` when no body
+ * slot declares selection.
+ */
+export declare function resolveProjectedCollectionSelectionMode(collection: ProjectedCollectionDefinition | null | undefined): CollectionSelectionMode;
+/**
+ * Reads the projection mode annotation from collection chrome.
+ */
+export declare function readCollectionChromeProjectionMode(chrome: Pick<CollectionChromeDefinition, 'Annotations'> | null | undefined): CollectionChromeProjectionMode | null;
+/**
+ * Reads the projection mode annotation from a collection chrome slot.
+ */
+export declare function readCollectionChromeSlotProjectionMode(slot: Pick<CollectionChromeSlotDefinition, 'Annotations'> | null | undefined): CollectionChromeProjectionMode | null;
+/**
+ * Checks whether a collection chrome slot carries a specific projection mode.
+ */
+export declare function isCollectionChromeSlotProjectionMode(slot: Pick<CollectionChromeSlotDefinition, 'Annotations'> | null | undefined, mode: CollectionChromeProjectionMode): boolean;
+/**
+ * Resolves the first data source identifier attached to the collection
+ * pagination slot.
+ */
+export declare function resolveProjectedCollectionPaginationDataSourceId(collection: ProjectedCollectionDefinition | null | undefined): string | null;
+/**
+ * Checks whether collection pagination chrome is declared.
+ */
+export declare function isProjectedCollectionPaginationEnabled(collection: ProjectedCollectionDefinition | null | undefined): boolean;
+/**
+ * Checks whether collection pagination is declared for footer placement.
+ */
+export declare function isProjectedCollectionPaginationFooterEnabled(collection: ProjectedCollectionDefinition | null | undefined): boolean;
+/**
+ * Reads a projected collection value from a row.
+ *
+ * Exact object-path lookup is attempted first. If it is missing, the final path
+ * segment is used as a direct property fallback for flatter data shapes.
+ */
+export declare function readProjectedCollectionValue<TData extends object>(row: TData, fieldPath: string): unknown;
+/**
+ * Reads a stable row identity from a row, falling back to the visible row index
+ * when the declared identity path is missing.
+ */
+export declare function readProjectedCollectionRowIdentity<TData extends object>(row: TData, rowIdentityPath: string, index: number): string;
+/**
+ * Reads a display label for a row.
+ *
+ * The declared label path is preferred, followed by conventional `Name` and
+ * `Id` properties.
+ */
+export declare function readProjectedCollectionRowLabel<TData extends object>(row: TData, rowLabelPath: string | null | undefined): string | null;
+/**
+ * Checks whether a collection selection mode enables any row selection.
+ */
+export declare function isCollectionSelectionEnabled(mode: CollectionSelectionMode): boolean;
+/**
+ * Checks whether a collection selection mode allows multiple selected rows.
+ */
+export declare function isMultipleCollectionSelection(mode: CollectionSelectionMode): boolean;
+export {};
+//# sourceMappingURL=projected-collection-runtime.d.ts.map