@cohesivesystems/presentation-react 0.1.0-alpha.1

package/dist/projected-document-workspace-projection-renderer-diagnostics.js

@@ -0,0 +1,207 @@
+import { resolveDocumentWorkspaceProjectionCapability, resolveDocumentWorkspaceProjectionRenderer, } from './document-workspace-runtime.js';
+import { createPresentationEnumDiscriminator, matchesPresentationEnum, } from '@cohesivesystems/presentation-core';
+import { coordinationActionKinds, coordinationTriggerKinds, } from '@cohesivesystems/presentation-contracts';
+/**
+ * Reports projection renderer coverage for the document views exposed by the
+ * active workspace runtime. The same semantic resolver used for rendering is
+ * used here so the developer toolbar reports stale component bindings and
+ * unhandled IR projection semantics as actionable frontend TODOs.
+ */
+export function projectDocumentWorkspaceProjectionRendererDiagnostics({ componentSet, module, projectionRenderers, runtime, sourceId = 'document-workspace-projection-renderers', }) {
+    return [
+        ...runtime.projectionViewIds.flatMap((viewId) => projectProjectionRendererDiagnostics({
+            componentSet,
+            module,
+            projectionRenderers,
+            runtime,
+            sourceId,
+            viewId,
+        })),
+        ...projectProjectionCoordinationDiagnostics({
+            componentSet,
+            module,
+            projectionRenderers,
+            runtime,
+            sourceId,
+        }),
+    ];
+}
+function projectProjectionRendererDiagnostics({ componentSet, module, projectionRenderers, runtime, sourceId, viewId, }) {
+    const resolution = resolveDocumentWorkspaceProjectionRenderer({
+        componentSet,
+        module,
+        registry: projectionRenderers,
+        runtime,
+        viewId,
+    });
+    const projection = resolution.projection;
+    if (!projection) {
+        return [
+            {
+                details: { viewId },
+                id: `document-projection.${viewId}.missing-projection`,
+                message: `Document workspace view '${viewId}' does not resolve to a declared ` +
+                    'document projection.',
+                severity: 'warning',
+                source: sourceId ?? 'document-workspace-projection-renderers',
+                subject: {
+                    id: viewId,
+                    kind: 'document-projection-view',
+                },
+            },
+        ];
+    }
+    const diagnostics = [];
+    if (!resolution.renderer) {
+        diagnostics.push({
+            details: createProjectionRendererDiagnosticDetails(resolution, viewId),
+            id: `document-projection.${projection.Id}.missing-renderer`,
+            message: `Document projection '${projection.Name}' has no frontend renderer binding.`,
+            severity: 'warning',
+            source: sourceId ?? 'document-workspace-projection-renderers',
+            subject: {
+                id: projection.Id,
+                kind: 'document-projection',
+                name: projection.Name,
+            },
+        });
+    }
+    if (resolution.renderer && isCompatibilityRendererSource(resolution.resolutionSource)) {
+        diagnostics.push({
+            details: createProjectionRendererDiagnosticDetails(resolution, viewId),
+            id: `document-projection.${projection.Id}.semantic-renderer-fallback`,
+            category: resolution.componentRole ? 'unbound' : 'missing-binding',
+            interpretation: {
+                status: resolution.componentRole ? 'unbound' : 'locally-interpreted',
+                target: 'document-projection-component-role',
+            },
+            message: resolution.componentRole
+                ? `Document projection '${projection.Name}' declares component role ` +
+                    `'${resolution.componentRole}', but rendering fell back to ` +
+                    `'${resolution.resolutionSource}'.`
+                : `Document projection '${projection.Name}' rendered through ` +
+                    `'${resolution.resolutionSource}' because it has no ProjectionRenderer ` +
+                    'target component role binding.',
+            severity: 'warning',
+            source: sourceId ?? 'document-workspace-projection-renderers',
+            suggestedNextStep: resolution.componentRole
+                ? `Bind frontend component role '${resolution.componentRole}' in the document projection component pack.`
+                : 'Declare a ProjectionRenderer target binding with ComponentRole for this projection and bind that role in the frontend component pack.',
+            subject: {
+                id: projection.Id,
+                kind: 'document-projection',
+                name: projection.Name,
+            },
+        });
+    }
+    if (resolution.renderer &&
+        resolution.componentKey &&
+        resolution.resolutionSource === 'component-key') {
+        diagnostics.push({
+            category: 'escape-hatch',
+            details: createProjectionRendererDiagnosticDetails(resolution, viewId),
+            id: `document-projection.${projection.Id}.component-key-escape-hatch`,
+            interpretation: {
+                status: 'escape-hatch',
+                target: 'document-projection-component-key',
+            },
+            message: `Document projection '${projection.Name}' rendered through concrete ` +
+                `component key '${resolution.componentKey}' as an escape hatch.`,
+            severity: 'warning',
+            source: sourceId ?? 'document-workspace-projection-renderers',
+            suggestedNextStep: 'Prefer ComponentRole for document projections and keep ComponentKey only for adapter-specific overrides.',
+            subject: {
+                id: projection.Id,
+                kind: 'document-projection',
+                name: projection.Name,
+            },
+        });
+    }
+    if (resolution.rendererKey) {
+        diagnostics.push({
+            category: 'escape-hatch',
+            details: createProjectionRendererDiagnosticDetails(resolution, viewId),
+            id: `document-projection.${projection.Id}.legacy-renderer-key`,
+            interpretation: {
+                status: 'escape-hatch',
+                target: 'document-projection-component-role',
+            },
+            message: `Document projection '${projection.Name}' declares renderer key ` +
+                `'${resolution.rendererKey}'. Document projection dispatch now uses ` +
+                'ProjectionRenderer target component roles and semantic projection interpretation.',
+            severity: 'warning',
+            source: sourceId ?? 'document-workspace-projection-renderers',
+            suggestedNextStep: 'Replace the renderer key with a ProjectionRenderer target binding that declares ComponentRole.',
+            subject: {
+                id: projection.Id,
+                kind: 'document-projection',
+                name: projection.Name,
+            },
+        });
+    }
+    return diagnostics;
+}
+function isCompatibilityRendererSource(source) {
+    return source === 'projection-kind' ||
+        source === 'semantic-reference-kind' ||
+        source === 'subject-kind';
+}
+function projectProjectionCoordinationDiagnostics({ componentSet, module, projectionRenderers, runtime, sourceId = 'document-workspace-projection-renderers', }) {
+    const revealTargetProjectionIds = new Set(runtime.documentProfile.Coordination
+        .filter((coordination) => matchesPresentationEnum(coordination.Trigger.Kind, selectionChangedTriggerKind) &&
+        matchesPresentationEnum(coordination.Action.Kind, revealSemanticSelectionActionKind))
+        .flatMap((coordination) => coordination.Action.TargetProjectionIds));
+    return [...revealTargetProjectionIds].flatMap((projectionId) => {
+        const projection = runtime.projections.find((candidate) => candidate.Id === projectionId);
+        if (!projection) {
+            return [];
+        }
+        const hasRevealCapability = resolveDocumentWorkspaceProjectionCapability({
+            capability: 'revealSemanticSelection',
+            componentSet,
+            module,
+            projection,
+            registry: projectionRenderers,
+        });
+        if (hasRevealCapability) {
+            return [];
+        }
+        return [
+            {
+                details: {
+                    coordinationActionKind: 'RevealSemanticSelection',
+                    projectionKind: projection.Kind,
+                    semanticReferenceKind: projection.Coordinates?.SemanticReferenceKind ?? null,
+                    subjectKind: projection.Subject.Kind,
+                    viewId: projection.ViewId,
+                },
+                id: `document-projection.${projection.Id}.missing-reveal-semantic-selection`,
+                message: `Document projection '${projection.Name}' is targeted by semantic ` +
+                    'selection reveal coordination, but this frontend adapter has not ' +
+                    'declared a reveal interpretation for it.',
+                severity: 'warning',
+                source: sourceId,
+                subject: {
+                    id: projection.Id,
+                    kind: 'document-projection',
+                    name: projection.Name,
+                },
+            },
+        ];
+    });
+}
+function createProjectionRendererDiagnosticDetails(resolution, viewId) {
+    return {
+        componentKey: resolution.componentKey,
+        componentRole: resolution.componentRole,
+        projectionKind: resolution.projection?.Kind ?? null,
+        rendererKey: resolution.rendererKey,
+        resolutionSource: resolution.resolutionSource,
+        semanticReferenceKind: resolution.projection?.Coordinates?.SemanticReferenceKind ?? null,
+        subjectKind: resolution.projection?.Subject.Kind ?? null,
+        viewId,
+    };
+}
+const selectionChangedTriggerKind = createPresentationEnumDiscriminator(coordinationTriggerKinds, 'selectionChanged', 'SelectionChanged');
+const revealSemanticSelectionActionKind = createPresentationEnumDiscriminator(coordinationActionKinds, 'revealSemanticSelection', 'RevealSemanticSelection');
+//# sourceMappingURL=projected-document-workspace-projection-renderer-diagnostics.js.map

package/dist/projected-document-workspace-projection-renderer-diagnostics.js.map

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

package/dist/projected-document-workspace-runtime-binding-diagnostics.d.ts

@@ -0,0 +1,19 @@
+import type { PresentationModuleDefinition } from '@cohesivesystems/presentation-core';
+import { type PresentationProjectionDiagnostic } from '@cohesivesystems/presentation-core';
+import type { DocumentWorkspaceRuntimeSnapshot } from './document-workspace-runtime.js';
+export interface ProjectDocumentWorkspaceRuntimeBindingDiagnosticsOptions {
+    readonly componentSet?: string | null;
+    readonly module: PresentationModuleDefinition | null;
+    readonly runtime: DocumentWorkspaceRuntimeSnapshot;
+    readonly sourceId?: string;
+    readonly supportedComponentRoles?: readonly string[];
+}
+/**
+ * Reports whether the backend WorkspaceRuntime target binding is projected as
+ * a semantic component role that this frontend document workspace host
+ * interprets. The host still mounts the runtime locally, but this diagnostic
+ * keeps the target binding honest and prevents concrete ComponentKey bindings
+ * from quietly lingering.
+ */
+export declare function projectDocumentWorkspaceRuntimeBindingDiagnostics({ componentSet, module, runtime, sourceId, supportedComponentRoles, }: ProjectDocumentWorkspaceRuntimeBindingDiagnosticsOptions): readonly PresentationProjectionDiagnostic[];
+//# sourceMappingURL=projected-document-workspace-runtime-binding-diagnostics.d.ts.map

package/dist/projected-document-workspace-runtime-binding-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projected-document-workspace-runtime-binding-diagnostics.d.ts","sourceRoot":"","sources":["../src/projected-document-workspace-runtime-binding-diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAC7B,MAAM,oCAAoC,CAAA;AAC3C,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,oCAAoC,CAAA;AAK3C,OAAO,KAAK,EACV,gCAAgC,EACjC,MAAM,8BAA8B,CAAA;AASrC,MAAM,WAAW,wDAAwD;IACvE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,QAAQ,CAAC,MAAM,EAAE,4BAA4B,GAAG,IAAI,CAAA;IACpD,QAAQ,CAAC,OAAO,EAAE,gCAAgC,CAAA;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,uBAAuB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACrD;AAMD;;;;;;GAMG;AACH,wBAAgB,iDAAiD,CAAC,EAChE,YAAY,EACZ,MAAM,EACN,OAAO,EACP,QAA+C,EAC/C,uBAAuE,GACxE,EAAE,wDAAwD,GAAG,SAAS,gCAAgC,EAAE,CA8GxG"}

package/dist/projected-document-workspace-runtime-binding-diagnostics.js

@@ -0,0 +1,124 @@
+import { createPresentationProjectionDiagnostic, } from '@cohesivesystems/presentation-core';
+import { createPresentationEnumDiscriminator, findPresentationComponentBinding, } from '@cohesivesystems/presentation-core';
+import { workspaceRuntimeComponentRoles, } from '@cohesivesystems/presentation-contracts';
+import { presentationBindingKinds, presentationTargetKinds, } from '@cohesivesystems/presentation-contracts';
+const defaultSupportedDocumentWorkspaceRuntimeRoles = [
+    workspaceRuntimeComponentRoles.documentWorkspace,
+];
+/**
+ * Reports whether the backend WorkspaceRuntime target binding is projected as
+ * a semantic component role that this frontend document workspace host
+ * interprets. The host still mounts the runtime locally, but this diagnostic
+ * keeps the target binding honest and prevents concrete ComponentKey bindings
+ * from quietly lingering.
+ */
+export function projectDocumentWorkspaceRuntimeBindingDiagnostics({ componentSet, module, runtime, sourceId = 'document-workspace-runtime-binding', supportedComponentRoles = defaultSupportedDocumentWorkspaceRuntimeRoles, }) {
+    if (!module) {
+        return [];
+    }
+    const binding = findPresentationComponentBinding(module, {
+        bindingKind: createPresentationEnumDiscriminator(presentationBindingKinds, 'workspaceRuntime', 'WorkspaceRuntime'),
+        componentSet,
+        id: runtime.workspace.Id,
+        targetKind: createPresentationEnumDiscriminator(presentationTargetKinds, 'react', 'React'),
+    });
+    const componentKey = binding?.ComponentKey ?? null;
+    const componentRole = binding?.ComponentRole ?? null;
+    const supportedRoleSet = new Set(supportedComponentRoles);
+    const diagnostics = [];
+    if (!binding) {
+        diagnostics.push(createWorkspaceRuntimeDiagnostic({
+            category: 'missing-binding',
+            componentKey,
+            componentRole,
+            idSuffix: 'missing-binding',
+            message: `Document workspace '${runtime.workspace.Id}' has no WorkspaceRuntime ` +
+                'target binding for the active frontend target.',
+            severity: 'warning',
+            sourceId,
+            status: 'unbound',
+            suggestedNextStep: 'Declare a WorkspaceRuntime target binding with ComponentRole for this document workspace.',
+            runtime,
+        }));
+        return diagnostics;
+    }
+    if (componentKey) {
+        diagnostics.push(createWorkspaceRuntimeDiagnostic({
+            category: 'escape-hatch',
+            componentKey,
+            componentRole,
+            idSuffix: 'component-key-escape-hatch',
+            message: `Document workspace '${runtime.workspace.Id}' declares concrete ` +
+                `workspace runtime component key '${componentKey}'.`,
+            severity: 'warning',
+            sourceId,
+            status: 'escape-hatch',
+            suggestedNextStep: 'Use WorkspaceRuntime ComponentRole for document workspace runtimes and reserve ComponentKey for adapter-specific overrides.',
+            runtime,
+        }));
+    }
+    if (!componentRole) {
+        diagnostics.push(createWorkspaceRuntimeDiagnostic({
+            category: 'missing-binding',
+            componentKey,
+            componentRole,
+            idSuffix: 'missing-component-role',
+            message: `Document workspace '${runtime.workspace.Id}' WorkspaceRuntime binding ` +
+                'does not declare a component role.',
+            severity: 'warning',
+            sourceId,
+            status: 'unbound',
+            suggestedNextStep: `Set ComponentRole to '${workspaceRuntimeComponentRoles.documentWorkspace}'.`,
+            runtime,
+        }));
+        return diagnostics;
+    }
+    const isSupportedRole = supportedRoleSet.has(componentRole);
+    diagnostics.push(createWorkspaceRuntimeDiagnostic({
+        category: isSupportedRole ? 'local-interpretation' : 'missing-binding',
+        componentKey,
+        componentRole,
+        idSuffix: 'component-role-coverage',
+        message: isSupportedRole
+            ? `Document workspace '${runtime.workspace.Id}' WorkspaceRuntime role ` +
+                `'${componentRole}' is interpreted by the local document workspace host.`
+            : `Document workspace '${runtime.workspace.Id}' WorkspaceRuntime role ` +
+                `'${componentRole}' is not interpreted by the local document workspace host.`,
+        severity: isSupportedRole ? 'info' : 'warning',
+        sourceId,
+        status: isSupportedRole ? 'locally-interpreted' : 'unbound',
+        suggestedNextStep: isSupportedRole
+            ? undefined
+            : 'Bind this WorkspaceRuntime component role in the frontend document workspace host adapter.',
+        runtime,
+    }));
+    return diagnostics;
+}
+function createWorkspaceRuntimeDiagnostic({ category, componentKey, componentRole, idSuffix, message, runtime, severity, sourceId, status, suggestedNextStep, }) {
+    return createPresentationProjectionDiagnostic({
+        category,
+        details: {
+            componentKey,
+            componentRole,
+            documentProfileId: runtime.documentProfile.Id,
+            pageViewId: runtime.pageView.Id,
+            workspaceId: runtime.workspace.Id,
+            workspaceViewId: runtime.workspaceView.Id,
+        },
+        id: `document-workspace-runtime.${runtime.workspace.Id}.${idSuffix}`,
+        interpretation: {
+            status,
+            target: 'workspace-runtime-component-role',
+        },
+        message,
+        severity,
+        source: sourceId,
+        subject: {
+            id: runtime.workspace.Id,
+            kind: 'document-workspace-runtime',
+            name: runtime.workspace.Name,
+        },
+        suggestedNextStep,
+    });
+}
+//# sourceMappingURL=projected-document-workspace-runtime-binding-diagnostics.js.map

package/dist/projected-document-workspace-runtime-binding-diagnostics.js.map

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

package/dist/projected-navigation-provider.d.ts

@@ -0,0 +1,16 @@
+import { type Context, type PropsWithChildren } from 'react';
+import { type NavigationDefinitionProjection, type PresentationNavigationRuntime } from '@cohesivesystems/presentation-core';
+export interface ProjectedNavigationContextValue<TNavigation extends NavigationDefinitionProjection = NavigationDefinitionProjection> extends PresentationNavigationRuntime {
+    readonly navigation: TNavigation | null;
+}
+export interface ProjectedNavigationProviderProps<TNavigation extends NavigationDefinitionProjection> extends PropsWithChildren {
+    readonly context?: Context<ProjectedNavigationContextValue<TNavigation>>;
+    readonly navigation: TNavigation | null;
+}
+/**
+ * Generic React binding for semantic navigation definitions. App-specific
+ * navigation contexts can be layered on top, but href creation and route
+ * execution stay owned by the presentation projection runtime.
+ */
+export declare function ProjectedNavigationProvider<TNavigation extends NavigationDefinitionProjection>({ children, context, navigation, }: ProjectedNavigationProviderProps<TNavigation>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=projected-navigation-provider.d.ts.map

package/dist/projected-navigation-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projected-navigation-provider.d.ts","sourceRoot":"","sources":["../src/projected-navigation-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAGlF,OAAO,EAEL,KAAK,8BAA8B,EACnC,KAAK,6BAA6B,EACnC,MAAM,oCAAoC,CAAA;AAK3C,MAAM,WAAW,+BAA+B,CAAC,WAAW,SAAS,8BAA8B,GAAG,8BAA8B,CAAE,SAAQ,6BAA6B;IACzK,QAAQ,CAAC,UAAU,EAAE,WAAW,GAAG,IAAI,CAAA;CACxC;AAED,MAAM,WAAW,gCAAgC,CAC/C,WAAW,SAAS,8BAA8B,CAClD,SAAQ,iBAAiB;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,+BAA+B,CAAC,WAAW,CAAC,CAAC,CAAA;IACxE,QAAQ,CAAC,UAAU,EAAE,WAAW,GAAG,IAAI,CAAA;CACxC;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,SAAS,8BAA8B,EAClD,EACA,QAAQ,EACR,OAAO,EACP,UAAU,GACX,EAAE,gCAAgC,CAAC,WAAW,CAAC,2CAwD/C"}

package/dist/projected-navigation-provider.js

@@ -0,0 +1,51 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useMemo } from 'react';
+import { useNavigate, useResolvedPath } from 'react-router';
+import { createNavigationHref, } from '@cohesivesystems/presentation-core';
+import { PresentationNavigationRuntimeContext, } from './navigation-runtime-context.js';
+/**
+ * Generic React binding for semantic navigation definitions. App-specific
+ * navigation contexts can be layered on top, but href creation and route
+ * execution stay owned by the presentation projection runtime.
+ */
+export function ProjectedNavigationProvider({ children, context, navigation, }) {
+    const navigate = useNavigate();
+    const rootPath = useResolvedPath('/');
+    const createHref = useCallback((routeId, parameters) => navigation ? createNavigationHref(navigation, routeId, parameters) : null, [navigation]);
+    const navigateHref = useCallback((href) => {
+        if (href.length > 0) {
+            void navigate(toRootRelativeHref(href, rootPath.pathname), {
+                flushSync: true,
+                relative: 'path',
+            });
+        }
+    }, [navigate, rootPath.pathname]);
+    const navigateRoute = useCallback((routeId, parameters) => {
+        const href = createHref(routeId, parameters);
+        if (href) {
+            navigateHref(href);
+        }
+    }, [createHref, navigateHref]);
+    const runtime = useMemo(() => ({
+        createHref,
+        navigateHref,
+        navigateRoute,
+    }), [createHref, navigateHref, navigateRoute]);
+    const contextValue = useMemo(() => ({
+        ...runtime,
+        navigation,
+    }), [navigation, runtime]);
+    const ApplicationNavigationContext = context;
+    return (_jsx(PresentationNavigationRuntimeContext.Provider, { value: runtime, children: ApplicationNavigationContext ? (_jsx(ApplicationNavigationContext.Provider, { value: contextValue, children: children })) : (children) }));
+}
+function toRootRelativeHref(href, rootPathname) {
+    if (/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(href) || href.startsWith('//')) {
+        return href;
+    }
+    if (href.startsWith('/')) {
+        return href;
+    }
+    const root = rootPathname === '/' ? '' : rootPathname.replace(/\/+$/g, '');
+    return `${root}/${href.replace(/^\/+/g, '')}`;
+}
+//# sourceMappingURL=projected-navigation-provider.js.map

package/dist/projected-navigation-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projected-navigation-provider.js","sourceRoot":"","sources":["../src/projected-navigation-provider.tsx"],"names":[],"mappings":"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"}

package/dist/projected-presentation-flow-host.d.ts

@@ -0,0 +1,16 @@
+import type { ReactNode } from 'react';
+import type { FlowDefinition, FlowStateDefinition, ViewDefinition } from '@cohesivesystems/presentation-core';
+import type { PresentationFlowInstance, PresentationFlowRuntimeSnapshot } from './presentation-flow-runtime.js';
+export interface ProjectedPresentationFlowHostProps {
+    readonly fallback?: ReactNode;
+    readonly renderView: (context: ProjectedPresentationFlowViewRenderContext) => ReactNode;
+    readonly runtime: PresentationFlowRuntimeSnapshot;
+}
+export interface ProjectedPresentationFlowViewRenderContext {
+    readonly flow: FlowDefinition;
+    readonly instance: PresentationFlowInstance;
+    readonly state: FlowStateDefinition;
+    readonly view: ViewDefinition;
+}
+export declare function ProjectedPresentationFlowHost({ fallback, renderView, runtime, }: ProjectedPresentationFlowHostProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=projected-presentation-flow-host.d.ts.map

package/dist/projected-presentation-flow-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projected-presentation-flow-host.d.ts","sourceRoot":"","sources":["../src/projected-presentation-flow-host.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,cAAc,EACf,MAAM,oCAAoC,CAAA;AAC3C,OAAO,KAAK,EACV,wBAAwB,EACxB,+BAA+B,EAChC,MAAM,6BAA6B,CAAA;AAEpC,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,0CAA0C,KAAK,SAAS,CAAA;IACvF,QAAQ,CAAC,OAAO,EAAE,+BAA+B,CAAA;CAClD;AAED,MAAM,WAAW,0CAA0C;IACzD,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;IAC7B,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAA;IAC3C,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAA;IACnC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;CAC9B;AAED,wBAAgB,6BAA6B,CAAC,EAC5C,QAAe,EACf,UAAU,EACV,OAAO,GACR,EAAE,kCAAkC,2CAgBpC"}

package/dist/projected-presentation-flow-host.js

@@ -0,0 +1,14 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+export function ProjectedPresentationFlowHost({ fallback = null, renderView, runtime, }) {
+    const { activeFlow, activeInstance, activeState, activeView } = runtime;
+    if (!activeFlow || !activeInstance || !activeState || !activeView) {
+        return _jsx(_Fragment, { children: fallback });
+    }
+    return (_jsx(_Fragment, { children: renderView({
+            flow: activeFlow,
+            instance: activeInstance,
+            state: activeState,
+            view: activeView,
+        }) }));
+}
+//# sourceMappingURL=projected-presentation-flow-host.js.map

package/dist/projected-presentation-flow-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projected-presentation-flow-host.js","sourceRoot":"","sources":["../src/projected-presentation-flow-host.tsx"],"names":[],"mappings":";AAyBA,MAAM,UAAU,6BAA6B,CAAC,EAC5C,QAAQ,GAAG,IAAI,EACf,UAAU,EACV,OAAO,GAC4B;IACnC,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,OAAO,CAAA;IACvE,IAAI,CAAC,UAAU,IAAI,CAAC,cAAc,IAAI,CAAC,WAAW,IAAI,CAAC,UAAU,EAAE,CAAC;QAClE,OAAO,4BAAG,QAAQ,GAAI,CAAA;IACxB,CAAC;IAED,OAAO,CACL,4BACG,UAAU,CAAC;YACV,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,cAAc;YACxB,KAAK,EAAE,WAAW;YAClB,IAAI,EAAE,UAAU;SACjB,CAAC,GACD,CACJ,CAAA;AACH,CAAC"}

package/dist/projected-query-form-state-adapter.d.ts

@@ -0,0 +1,12 @@
+import type { PresentationQueryFormStateAdapter } from './presentation-query-form-state.js';
+type ProjectedQueryFormValue = Record<string, unknown>;
+/**
+ * Creates the default frontend interpretation for an IR-declared query form.
+ *
+ * The adapter derives draft/applied state shape, normalization, and URL state
+ * from the query form's backing input-form fields. Targets can still override a
+ * query form by registering an adapter with the same query form id.
+ */
+export declare function createProjectedQueryFormStateAdapter(queryFormId: string): PresentationQueryFormStateAdapter<ProjectedQueryFormValue>;
+export {};
+//# sourceMappingURL=projected-query-form-state-adapter.d.ts.map

package/dist/projected-query-form-state-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projected-query-form-state-adapter.d.ts","sourceRoot":"","sources":["../src/projected-query-form-state-adapter.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,iCAAiC,EAElC,MAAM,iCAAiC,CAAA;AA2BxC,KAAK,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAItD;;;;;;GAMG;AACH,wBAAgB,oCAAoC,CAClD,WAAW,EAAE,MAAM,GAClB,iCAAiC,CAAC,uBAAuB,CAAC,CAwE5D"}