@primafuture/contrib-kit-react 1.0.0

package/dist/extension-outlet.js

@@ -0,0 +1,229 @@
+import * as react from "react";
+import * as outletErrorPipeline from "./internal/outlet-error-pipeline.js";
+import * as outletInput from "./internal/outlet-input.js";
+import * as outletMembership from "./internal/outlet-membership.js";
+import * as outletMembershipBoundary from "./internal/outlet-membership-boundary.js";
+import * as outletProjection from "./internal/outlet-projection.js";
+import * as reactAdapterDiagnostics from "./react-adapter-diagnostics.js";
+import * as resolvedContributions from "./resolved-contributions.js";
+/** Vytvoří čistý outlet reporter state pro novou render generation. */
+function createGlobalReporterState(generationToken) {
+    return {
+        cause: undefined,
+        escalationCause: undefined,
+        hasFailure: false,
+        hasEscalation: false,
+        generationToken,
+    };
+}
+/** Volá host renderer s undefined receiverem uvnitř jeho reporter boundary. */
+function OutletGlobalRenderer(props) {
+    const rendered = outletInput.callCapturedOutletCallback(props.render, props.state);
+    return react.createElement(react.Fragment, null, rendered);
+}
+/**
+ * Outlet-level class boundary reportující custom renderer chybu bez contribution policy.
+ */
+class OutletGlobalReporterBoundary extends react.Component {
+    /** State začíná bez failure v exact projection generation. */
+    state = createGlobalReporterState(this.props.generationToken);
+    /** Zachytí host renderer cause bez sink side effectu. */
+    static getDerivedStateFromError(cause) {
+        return { cause, hasFailure: true, hasEscalation: false };
+    }
+    /** Resetuje reporter dříve, než renderuje novou projection generation. */
+    static getDerivedStateFromProps(props, state) {
+        return props.generationToken === state.generationToken
+            ? null
+            : createGlobalReporterState(props.generationToken);
+    }
+    /** Reportuje committed failure právě jednou a připraví exact escalation. */
+    componentDidCatch(cause, info) {
+        if (!this.state.hasFailure || !this.props.isCurrent()) {
+            return;
+        }
+        const point = reactAdapterDiagnostics.createPointMetadata(this.props.point);
+        const reactComponentStack = outletErrorPipeline.normalizeReactComponentStack(info.componentStack);
+        const outletId = this.props.outletLease?.isCurrent() === true
+            ? this.props.outletLease.id
+            : undefined;
+        const event = reactAdapterDiagnostics.createReactAdapterErrorEvent({
+            code: "REACT_RENDER_FAILED",
+            cause,
+            phase: "customRender",
+            ...(outletId === undefined ? {} : { outletId }),
+            ...(point === undefined ? {} : { point }),
+            ...(reactComponentStack === undefined ? {} : { reactComponentStack }),
+        });
+        reactAdapterDiagnostics.reportReactAdapterDiagnostic(reactAdapterDiagnostics.createErrorDiagnostic(event), this.props.configuration);
+        if (this.props.isCurrent()) {
+            this.setState({ escalationCause: cause, hasEscalation: true });
+        }
+    }
+    /** Failed commit nejprve zobrazí null, další render vyhodí exact cause hostu. */
+    render() {
+        if (this.state.hasEscalation) {
+            throw this.state.escalationCause;
+        }
+        return this.state.hasFailure ? null : this.props.children;
+    }
+}
+/** Reportuje secondary callback failure bez změny primary resolve outcome. */
+function reportResolveCallbackFailure(attempt, cause) {
+    if (!attempt.binding.isCurrent()) {
+        return;
+    }
+    const point = reactAdapterDiagnostics.createPointMetadata(attempt.input.point);
+    const event = reactAdapterDiagnostics.createReactAdapterErrorEvent({
+        code: "REACT_CALLBACK_FAILED",
+        cause,
+        phase: "callback",
+        ...(point === undefined ? {} : { point }),
+    });
+    reactAdapterDiagnostics.reportReactAdapterDiagnostic(reactAdapterDiagnostics.createErrorDiagnostic(event), attempt.input.configuration);
+}
+/** Pohltí sync, Promise i hostile thenable výsledek resolve callbacku. */
+function consumeResolveCallbackResult(result, attempt) {
+    let reported = false;
+    /** Přeloží nejvýše jednu current rejection na secondary diagnostiku. */
+    function reportFailure(cause) {
+        if (reported) {
+            return;
+        }
+        reported = true;
+        reportResolveCallbackFailure(attempt, cause);
+    }
+    try {
+        void Promise.resolve(result).catch(reportFailure);
+    }
+    catch (cause) {
+        reportFailure(cause);
+    }
+}
+/** Renderuje outlet-level empty nebo resolve-error callback pod reporter boundary. */
+function renderGlobalProjection(binding, render, state, generationToken) {
+    if (render === undefined) {
+        return null;
+    }
+    const children = react.createElement(OutletGlobalRenderer, { render, state });
+    const outletLease = binding.outletLease;
+    /** Ověří query i případnou committed outlet lease bez jejího vytvoření. */
+    function isCurrent() {
+        return binding.isCurrent()
+            && (outletLease === undefined || outletLease.isCurrent());
+    }
+    return react.createElement(OutletGlobalReporterBoundary, {
+        children,
+        configuration: binding.input.configuration,
+        generationToken,
+        isCurrent,
+        outletLease,
+        point: binding.input.point,
+    });
+}
+/**
+ * Class host publikuje jeden celý membership proposal místo render-time ref mutací.
+ */
+class OutletCommittedHost extends react.Component {
+    /** První snapshot vzniká čistě z initial props bez commit-owned resource. */
+    state = {
+        snapshot: outletMembership.reconcileOutletMemberships(undefined, this.props.binding.rawRegistry, this.props.projection),
+        retainedLease: undefined,
+    };
+    /** Odvodí celý nový immutable proposal před jediným React state publish. */
+    static getDerivedStateFromProps(props, state) {
+        const outletLease = props.binding.outletLease;
+        return {
+            snapshot: outletMembership.reconcileOutletMemberships(state.snapshot, props.binding.rawRegistry, props.projection),
+            retainedLease: outletLease?.isCurrent() === true
+                ? Object.freeze({
+                    lease: outletLease,
+                    rawRegistry: props.binding.rawRegistry,
+                })
+                : state.retainedLease,
+        };
+    }
+    /** Renderuje placement-free global stav nebo ordered membership Fragment. */
+    render() {
+        const binding = this.props.binding;
+        const snapshot = this.state.snapshot;
+        if (snapshot.projection.kind === "resolveFailed") {
+            return renderGlobalProjection(binding, binding.input.renderResolveError, snapshot.projection.renderState, snapshot.projection);
+        }
+        const outletLease = binding.outletLease;
+        const retainsActivitySubtree = snapshot.rawRegistry === binding.rawRegistry
+            && this.state.retainedLease?.rawRegistry === binding.rawRegistry
+            && this.state.retainedLease.lease === outletLease;
+        // Inaktivní lease při Activity reveal smí držet pouze subtree stejné registry.
+        // Registry switch zůstává null bariérou a resetuje membership state; callback
+        // a resource autoritu v retained větvi nadále střeží current-lease gate boundary.
+        if ((outletLease === undefined && !binding.serverSnapshot)
+            || (outletLease !== undefined
+                && !outletLease.isCurrent()
+                && !retainsActivitySubtree)) {
+            return null;
+        }
+        if (snapshot.projection.kind === "empty") {
+            return renderGlobalProjection(binding, binding.input.renderEmpty, snapshot.projection.renderState, snapshot.projection);
+        }
+        const generation = binding.generation;
+        if (generation === undefined) {
+            return null;
+        }
+        return react.createElement(react.Fragment, null, ...snapshot.memberships.map(
+        /** Vytvoří samostatnou keyed package boundary v exact Core pořadí. */
+        function renderMembership(membership) {
+            return react.createElement(outletMembershipBoundary.OutletMembershipBoundary, {
+                key: membership.seed.registrationId,
+                input: binding.input,
+                membership,
+                outletLease,
+                rawRegistry: binding.rawRegistry,
+                scope: binding.scope,
+                scopeGeneration: generation,
+            });
+        }));
+    }
+}
+/**
+ * Renderuje exact Core resolved kolekci jako headless React Fragment.
+ *
+ * @public
+ */
+export function ExtensionOutlet(props) {
+    const [reportedResolveAttempts] = react.useState(
+    /** Vytvoří outlet-local Strict dedup ledger bez global historie. */
+    function createResolveAttemptLedger() {
+        return new WeakSet();
+    });
+    /** Doručí resolve callback z engine effectu až po committed sink diagnostice. */
+    function reportCommittedResolveError(binding) {
+        const current = Object.freeze({
+            binding,
+            input: binding.input,
+        });
+        if (current.input.onError === undefined
+            || current.binding.attempt.state.status !== "failed"
+            || !current.binding.isCurrent()
+            || reportedResolveAttempts.has(current.binding.attempt.token)) {
+            return;
+        }
+        reportedResolveAttempts.add(current.binding.attempt.token);
+        const emission = Object.freeze({
+            kind: "resolve",
+            error: current.binding.attempt.state.error,
+            refresh: current.binding.result.refresh,
+        });
+        try {
+            const result = outletInput.callCapturedOutletCallback(current.input.onError, emission);
+            consumeResolveCallbackResult(result, current);
+        }
+        catch (cause) {
+            reportResolveCallbackFailure(current, cause);
+        }
+    }
+    const binding = resolvedContributions.useResolvedContributionsForOutlet(props, reportCommittedResolveError);
+    const projection = outletProjection.projectOutletSnapshot(binding.input.point, binding.input.context, binding.result, binding.checkpoint);
+    return react.createElement(OutletCommittedHost, { binding, projection });
+}
+//# sourceMappingURL=extension-outlet.js.map

package/dist/extension-outlet.js.map

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

package/dist/extension-registry-provider.d.ts

@@ -0,0 +1,26 @@
+import * as contribKitCore from "@primafuture/contrib-kit-core";
+import * as react from "react";
+/**
+ * Props tree-local React adapter scope bez převzetí Core ownershipu.
+ *
+ * @public
+ */
+export interface ExtensionRegistryProviderProps {
+    /** React subtree, kterému provider zpřístupní registry a konfiguraci. */
+    readonly children?: react.ReactNode;
+    /** Inherited contribution policy; null obnoví package default. */
+    readonly errorPolicy?: import("./react-adapter-diagnostics.js").ReactErrorPolicy | null | undefined;
+    /** Pure projekce host contextu použitelná pouze v diagnostice. */
+    readonly projectContext?: ((context: unknown) => unknown) | null | undefined;
+    /** Hostem vlastněná Core registry; provider ji nikdy nedisposuje. */
+    readonly registry: contribKitCore.ExtensionRegistry;
+    /** Inherited command-free sink; null obnoví console fallback. */
+    readonly sink?: import("./react-adapter-diagnostics.js").ReactAdapterSink | null | undefined;
+}
+/**
+ * Poskytne tree-local registry a adapter konfiguraci bez DOM wrapperu nebo Core dispose.
+ *
+ * @public
+ */
+export declare function ExtensionRegistryProvider(props: ExtensionRegistryProviderProps): react.ReactElement;
+//# sourceMappingURL=extension-registry-provider.d.ts.map

package/dist/extension-registry-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-registry-provider.d.ts","sourceRoot":"","sources":["../src/extension-registry-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,cAAc,MAAM,+BAA+B,CAAC;AAChE,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAS/B;;;;GAIG;AACH,MAAM,WAAW,8BAA8B;IAC9C,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACpC,kEAAkE;IAClE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,gCAAgC,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC;IACpG,kEAAkE;IAClE,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IAC7E,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC,iBAAiB,CAAC;IACpD,iEAAiE;IACjE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,gCAAgC,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC;CAC7F;AA6FD;;;;GAIG;AACH,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,8BAA8B,GACnC,KAAK,CAAC,YAAY,CAoDpB"}

package/dist/extension-registry-provider.js

@@ -0,0 +1,82 @@
+import * as contribKitCore from "@primafuture/contrib-kit-core";
+import * as react from "react";
+import * as adapterConfiguration from "./internal/adapter-configuration.js";
+import * as adapterContext from "./internal/adapter-context.js";
+import * as adapterRegistryProtocol from "./internal/adapter-registry-protocol.js";
+import * as adapterScope from "./internal/adapter-scope.js";
+import * as publicInputCapture from "./internal/public-input-capture.js";
+import * as reactAdapterError from "./react-adapter-error.js";
+/**
+ * Vytvoří nový resource-free scope pouze jako lokální React state.
+ */
+function createProviderScope() {
+    return new adapterScope.AdapterScopeRuntime();
+}
+/**
+ * Zachytí všechna známá provider pole v normativním pořadí bez partial Contextu.
+ */
+function captureProviderRender(props, parent, scope, checkpoint) {
+    const source = publicInputCapture.requireInputObject(props, "props");
+    const registryValue = publicInputCapture.readInputProperty(source, "registry", "props.registry", checkpoint);
+    const sinkValue = publicInputCapture.readInputProperty(source, "sink", "props.sink", checkpoint);
+    const errorPolicyValue = publicInputCapture.readInputProperty(source, "errorPolicy", "props.errorPolicy", checkpoint);
+    const projectContextValue = publicInputCapture.readInputProperty(source, "projectContext", "props.projectContext", checkpoint);
+    const children = publicInputCapture.readInputProperty(source, "children", "props.children", checkpoint);
+    const protocol = adapterRegistryProtocol.captureAdapterRegistryProtocol(registryValue, checkpoint);
+    const patch = adapterConfiguration.captureAdapterConfigurationPatch(sinkValue, errorPolicyValue, projectContextValue, checkpoint);
+    const configuration = adapterConfiguration.resolveAdapterScopeConfiguration(parent?.generation.configuration, patch);
+    checkpoint();
+    const generation = adapterScope.createAdapterScopeGeneration(protocol, configuration);
+    return Object.freeze({
+        ok: true,
+        children,
+        contextValue: adapterContext.createAdapterContextValue(scope, generation),
+    });
+}
+/**
+ * Poskytne tree-local registry a adapter konfiguraci bez DOM wrapperu nebo Core dispose.
+ *
+ * @public
+ */
+export function ExtensionRegistryProvider(props) {
+    const parent = adapterContext.useAdapterContext();
+    const [scope] = react.useState(createProviderScope);
+    const renderSerial = react.useRef(0);
+    renderSerial.current += 1;
+    const currentRenderSerial = renderSerial.current;
+    /** Ověří, že reentrantní host seam nezneplatnil právě probíhající capture. */
+    function checkpointProviderRender() {
+        if (renderSerial.current !== currentRenderSerial) {
+            throw new reactAdapterError.ReactAdapterError("REACT_ADAPTER_DISPOSED", "The provider render attempt is no longer current.", { details: { field: "provider.render", phase: "lifecycle" } });
+        }
+    }
+    let captured;
+    try {
+        captured = captureProviderRender(props, parent, scope, checkpointProviderRender);
+    }
+    catch (error) {
+        captured = Object.freeze({ ok: false, error });
+    }
+    const generation = captured.ok ? captured.contextValue.generation : undefined;
+    react.useEffect(
+    /** Committed provider lifecycle vlastní pouze adapter scope owner lease. */
+    function acquireProviderScope() {
+        if (generation === undefined || renderSerial.current !== currentRenderSerial) {
+            return undefined;
+        }
+        return scope.acquireOwner(generation);
+    }, [
+        scope,
+        generation?.defaultProtocol.rawRegistry,
+        generation?.defaultProtocol.registryId,
+        generation?.configuration.sink?.receiver,
+        generation?.configuration.sink?.report,
+        generation?.configuration.errorPolicy,
+        generation?.configuration.projectContext,
+    ]);
+    if (!captured.ok) {
+        throw captured.error;
+    }
+    return adapterContext.createAdapterContextProvider(captured.contextValue, captured.children);
+}
+//# sourceMappingURL=extension-registry-provider.js.map

package/dist/extension-registry-provider.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Public React adapter contracts for typed components, managed-lazy descriptors,
+ * and authentic Core extension points.
+ *
+ * @packageDocumentation
+ */
+export { defineReactContributionComponent } from "./contribution-component.js";
+export { ExtensionOutlet } from "./extension-outlet.js";
+export { ExtensionRegistryProvider } from "./extension-registry-provider.js";
+export { ReactAdapterError } from "./react-adapter-error.js";
+export { defineReactExtensionPoint } from "./react-extension-point.js";
+export { defineReactLazyContribution } from "./react-lazy-contribution.js";
+export { useResolvedContributions } from "./resolved-contributions.js";
+export type { ExtensionContributionProps, ExtensionContributionView, ReactContributionComponent, ResolvedContributionPlacement, } from "./contribution-component.js";
+export type { ExtensionContributionErrorRenderState, ExtensionContributionLoadingRenderState, ExtensionContributionReadyRenderState, ExtensionContributionRenderStateBase, ExtensionEmptyRenderState, ExtensionOutletErrorEmission, ExtensionOutletProps, ExtensionOutletRetryEvent, ExtensionResolveErrorRenderState, } from "./extension-outlet.js";
+export type { ExtensionRegistryProviderProps, } from "./extension-registry-provider.js";
+export type { ReactAdapterDiagnosticEvent, ReactAdapterErrorEvent, ReactAdapterSink, ReactErrorAction, ReactErrorPolicy, ReadonlyContributionMetadata, ReadonlyPointMetadata, } from "./react-adapter-diagnostics.js";
+export type { ReactAdapterErrorCode, ReactAdapterErrorPhase, } from "./react-adapter-error.js";
+export type { AnyReactExtensionPoint, ReactExtensionPoint, ReactExtensionPointDefinition, } from "./react-extension-point.js";
+export type { ReactContributionImplementation, ReactLazyContribution, ReactLazyContributionInput, ReactLazyContributionLoadInput, } from "./react-lazy-contribution.js";
+export type { ExtensionOutletEmptyReason, ResolvedContributionsState, UseResolvedContributionsOptions, UseResolvedContributionsResult, } from "./resolved-contributions.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gCAAgC,EAAE,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,YAAY,EACX,0BAA0B,EAC1B,yBAAyB,EACzB,0BAA0B,EAC1B,6BAA6B,GAC7B,MAAM,6BAA6B,CAAC;AAErC,YAAY,EACX,qCAAqC,EACrC,uCAAuC,EACvC,qCAAqC,EACrC,oCAAoC,EACpC,yBAAyB,EACzB,4BAA4B,EAC5B,oBAAoB,EACpB,yBAAyB,EACzB,gCAAgC,GAChC,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACX,8BAA8B,GAC9B,MAAM,kCAAkC,CAAC;AAE1C,YAAY,EACX,2BAA2B,EAC3B,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,4BAA4B,EAC5B,qBAAqB,GACrB,MAAM,gCAAgC,CAAC;AAExC,YAAY,EACX,qBAAqB,EACrB,sBAAsB,GACtB,MAAM,0BAA0B,CAAC;AAElC,YAAY,EACX,sBAAsB,EACtB,mBAAmB,EACnB,6BAA6B,GAC7B,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EACX,+BAA+B,EAC/B,qBAAqB,EACrB,0BAA0B,EAC1B,8BAA8B,GAC9B,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EACX,0BAA0B,EAC1B,0BAA0B,EAC1B,+BAA+B,EAC/B,8BAA8B,GAC9B,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * Public React adapter contracts for typed components, managed-lazy descriptors,
+ * and authentic Core extension points.
+ *
+ * @packageDocumentation
+ */
+export { defineReactContributionComponent } from "./contribution-component.js";
+export { ExtensionOutlet } from "./extension-outlet.js";
+export { ExtensionRegistryProvider } from "./extension-registry-provider.js";
+export { ReactAdapterError } from "./react-adapter-error.js";
+export { defineReactExtensionPoint } from "./react-extension-point.js";
+export { defineReactLazyContribution } from "./react-lazy-contribution.js";
+export { useResolvedContributions } from "./resolved-contributions.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gCAAgC,EAAE,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/internal/adapter-configuration.d.ts

@@ -0,0 +1,54 @@
+/** Read-once zachycený diagnostický sink včetně původního receiveru. */
+export interface CapturedReactAdapterSink {
+    /** Původní strukturální receiver host callbacku. */
+    readonly receiver: object;
+    /** Stabilní reference jediného známého sink callbacku. */
+    readonly report: (event: unknown) => unknown;
+}
+/** Interní error-policy callback před materializací veřejného event typu. */
+export type CapturedReactErrorPolicy = (error: unknown) => unknown;
+/** Interní context projector před materializací veřejného event typu. */
+export type CapturedReactContextProjector = (context: unknown) => unknown;
+/** Efektivní immutable konfigurace jednoho adapter scope generation. */
+export interface AdapterScopeConfiguration {
+    /** Custom sink nebo absence znamenající package fallback. */
+    readonly sink: CapturedReactAdapterSink | undefined;
+    /** Custom contribution error policy nebo package default. */
+    readonly errorPolicy: CapturedReactErrorPolicy | undefined;
+    /** Optional bezpečná projekce host contextu do diagnostiky. */
+    readonly projectContext: CapturedReactContextProjector | undefined;
+}
+/** Tri-state patch zachovávající inheritance a explicitní null clear. */
+export interface CapturedAdapterConfigurationPatch {
+    /** `undefined` dědí, `null` ruší custom sink. */
+    readonly sink: CapturedReactAdapterSink | null | undefined;
+    /** `undefined` dědí, `null` obnovuje package policy. */
+    readonly errorPolicy: CapturedReactErrorPolicy | null | undefined;
+    /** `undefined` dědí, `null` projector vypíná. */
+    readonly projectContext: CapturedReactContextProjector | null | undefined;
+}
+/** Lifecycle checkpoint spuštěný po každém nested public Getu. */
+export type AdapterConfigurationCheckpoint = () => void;
+/** Prázdná package konfigurace bez custom host callbacku. */
+export declare const EMPTY_ADAPTER_SCOPE_CONFIGURATION: AdapterScopeConfiguration;
+/**
+ * Zvaliduje již read-once zachycené hodnoty bez dalšího čtení parent options.
+ */
+export declare function captureAdapterConfigurationPatch(sinkValue: unknown, errorPolicyValue: unknown, projectContextValue: unknown, checkpoint: AdapterConfigurationCheckpoint): CapturedAdapterConfigurationPatch;
+/**
+ * Vyřeší každou config osu samostatně nad nearest provider konfigurací.
+ */
+export declare function resolveAdapterScopeConfiguration(parent: AdapterScopeConfiguration | undefined, patch: CapturedAdapterConfigurationPatch): AdapterScopeConfiguration;
+/**
+ * Porovná dvě efektivní konfigurace pouze přes zachycené capability reference.
+ */
+export declare function isSameAdapterScopeConfiguration(left: AdapterScopeConfiguration, right: AdapterScopeConfiguration): boolean;
+/**
+ * Vybere explicitní registry bez silent fallbacku nebo nearest provider default.
+ */
+export declare function resolveAdapterRegistryInput(explicitRegistry: unknown, inheritedRegistry: unknown | undefined): unknown;
+/**
+ * Zavolá zachycený sink s původním receiverem; výsledek vlastní vyšší pipeline.
+ */
+export declare function callCapturedReactAdapterSink(sink: CapturedReactAdapterSink, event: unknown): unknown;
+//# sourceMappingURL=adapter-configuration.d.ts.map

package/dist/internal/adapter-configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-configuration.d.ts","sourceRoot":"","sources":["../../src/internal/adapter-configuration.ts"],"names":[],"mappings":"AAGA,wEAAwE;AACxE,MAAM,WAAW,wBAAwB;IACxC,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CAC7C;AAED,6EAA6E;AAC7E,MAAM,MAAM,wBAAwB,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;AAEnE,yEAAyE;AACzE,MAAM,MAAM,6BAA6B,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;AAE1E,wEAAwE;AACxE,MAAM,WAAW,yBAAyB;IACzC,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,wBAAwB,GAAG,SAAS,CAAC;IACpD,6DAA6D;IAC7D,QAAQ,CAAC,WAAW,EAAE,wBAAwB,GAAG,SAAS,CAAC;IAC3D,+DAA+D;IAC/D,QAAQ,CAAC,cAAc,EAAE,6BAA6B,GAAG,SAAS,CAAC;CACnE;AAED,yEAAyE;AACzE,MAAM,WAAW,iCAAiC;IACjD,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,wBAAwB,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3D,wDAAwD;IACxD,QAAQ,CAAC,WAAW,EAAE,wBAAwB,GAAG,IAAI,GAAG,SAAS,CAAC;IAClE,iDAAiD;IACjD,QAAQ,CAAC,cAAc,EAAE,6BAA6B,GAAG,IAAI,GAAG,SAAS,CAAC;CAC1E;AAED,kEAAkE;AAClE,MAAM,MAAM,8BAA8B,GAAG,MAAM,IAAI,CAAC;AAExD,6DAA6D;AAC7D,eAAO,MAAM,iCAAiC,EAAE,yBAI9C,CAAC;AAqDH;;GAEG;AACH,wBAAgB,gCAAgC,CAC/C,SAAS,EAAE,OAAO,EAClB,gBAAgB,EAAE,OAAO,EACzB,mBAAmB,EAAE,OAAO,EAC5B,UAAU,EAAE,8BAA8B,GACxC,iCAAiC,CAYnC;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC/C,MAAM,EAAE,yBAAyB,GAAG,SAAS,EAC7C,KAAK,EAAE,iCAAiC,GACtC,yBAAyB,CAU3B;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC9C,IAAI,EAAE,yBAAyB,EAC/B,KAAK,EAAE,yBAAyB,GAC9B,OAAO,CAKT;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAC1C,gBAAgB,EAAE,OAAO,EACzB,iBAAiB,EAAE,OAAO,GAAG,SAAS,GACpC,OAAO,CAaT;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC3C,IAAI,EAAE,wBAAwB,EAC9B,KAAK,EAAE,OAAO,GACZ,OAAO,CAET"}

package/dist/internal/adapter-configuration.js

@@ -0,0 +1,89 @@
+import * as publicInputCapture from "./public-input-capture.js";
+import * as reactAdapterError from "../react-adapter-error.js";
+/** Prázdná package konfigurace bez custom host callbacku. */
+export const EMPTY_ADAPTER_SCOPE_CONFIGURATION = Object.freeze({
+    sink: undefined,
+    errorPolicy: undefined,
+    projectContext: undefined,
+});
+/**
+ * Zachytí optional sink a jeho jediný známý callback se správným receiverem.
+ */
+function captureSink(value, checkpoint) {
+    if (value === undefined || value === null) {
+        return value;
+    }
+    const receiver = publicInputCapture.requireInputObject(value, "options.sink");
+    const report = publicInputCapture.readInputProperty(receiver, "report", "options.sink.report", checkpoint);
+    if (typeof report !== "function") {
+        return publicInputCapture.throwInvalidCapturedArgument("options.sink.report", "options.sink.report must be callable.");
+    }
+    return Object.freeze({
+        receiver,
+        report: report,
+    });
+}
+/**
+ * Ověří optional callable configuration bez čtení dalších public polí.
+ */
+function captureOptionalCallback(value, field) {
+    if (value === undefined || value === null) {
+        return value;
+    }
+    if (typeof value !== "function") {
+        return publicInputCapture.throwInvalidCapturedArgument(`options.${field}`, `options.${field} must be callable.`);
+    }
+    return value;
+}
+/**
+ * Zvaliduje již read-once zachycené hodnoty bez dalšího čtení parent options.
+ */
+export function captureAdapterConfigurationPatch(sinkValue, errorPolicyValue, projectContextValue, checkpoint) {
+    return Object.freeze({
+        sink: captureSink(sinkValue, checkpoint),
+        errorPolicy: captureOptionalCallback(errorPolicyValue, "errorPolicy"),
+        projectContext: captureOptionalCallback(projectContextValue, "projectContext"),
+    });
+}
+/**
+ * Vyřeší každou config osu samostatně nad nearest provider konfigurací.
+ */
+export function resolveAdapterScopeConfiguration(parent, patch) {
+    return Object.freeze({
+        sink: patch.sink === undefined ? parent?.sink : patch.sink ?? undefined,
+        errorPolicy: patch.errorPolicy === undefined
+            ? parent?.errorPolicy
+            : patch.errorPolicy ?? undefined,
+        projectContext: patch.projectContext === undefined
+            ? parent?.projectContext
+            : patch.projectContext ?? undefined,
+    });
+}
+/**
+ * Porovná dvě efektivní konfigurace pouze přes zachycené capability reference.
+ */
+export function isSameAdapterScopeConfiguration(left, right) {
+    return left.sink?.receiver === right.sink?.receiver
+        && left.sink?.report === right.sink?.report
+        && left.errorPolicy === right.errorPolicy
+        && left.projectContext === right.projectContext;
+}
+/**
+ * Vybere explicitní registry bez silent fallbacku nebo nearest provider default.
+ */
+export function resolveAdapterRegistryInput(explicitRegistry, inheritedRegistry) {
+    if (explicitRegistry !== undefined) {
+        return explicitRegistry;
+    }
+    if (inheritedRegistry !== undefined) {
+        return inheritedRegistry;
+    }
+    throw new reactAdapterError.ReactAdapterError("REACT_REGISTRY_NOT_PROVIDED", "No extension registry was provided.", { details: { field: "options.registry", phase: "configuration" } });
+}
+/**
+ * Zavolá zachycený sink s původním receiverem; výsledek vlastní vyšší pipeline.
+ */
+export function callCapturedReactAdapterSink(sink, event) {
+    return Reflect.apply(sink.report, sink.receiver, [event]);
+}
+//# sourceMappingURL=adapter-configuration.js.map

package/dist/internal/adapter-configuration.js.map

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

package/dist/internal/adapter-context.d.ts

@@ -0,0 +1,24 @@
+import * as react from "react";
+import * as adapterScope from "./adapter-scope.js";
+/**
+ * Immutable provider value oddělující stabilní scope od aktuální generation.
+ */
+export interface AdapterContextValue {
+    /** Stabilní tree-local vlastník bridge a lifecycle zdrojů. */
+    readonly scope: adapterScope.AdapterScopeRuntime;
+    /** Aktuální provider registry a inherited konfigurace. */
+    readonly generation: adapterScope.AdapterScopeGeneration;
+}
+/**
+ * Vytvoří frozen Context value pro jeden provider render.
+ */
+export declare function createAdapterContextValue(scope: adapterScope.AdapterScopeRuntime, generation: adapterScope.AdapterScopeGeneration): AdapterContextValue;
+/**
+ * Vrátí nearest provider hodnotu při zachování standardního React Hook pořadí.
+ */
+export declare function useAdapterContext(): AdapterContextValue | undefined;
+/**
+ * Vystaví interní Context provider bez přidání host DOM elementu.
+ */
+export declare function createAdapterContextProvider(value: AdapterContextValue, children: react.ReactNode): react.ReactElement;
+//# sourceMappingURL=adapter-context.d.ts.map

package/dist/internal/adapter-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-context.d.ts","sourceRoot":"","sources":["../../src/internal/adapter-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC,mBAAmB,CAAC;IACjD,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,sBAAsB,CAAC;CACzD;AAKD;;GAEG;AACH,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,YAAY,CAAC,mBAAmB,EACvC,UAAU,EAAE,YAAY,CAAC,sBAAsB,GAC7C,mBAAmB,CAErB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,mBAAmB,GAAG,SAAS,CAEnE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC3C,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,GACvB,KAAK,CAAC,YAAY,CAEpB"}

package/dist/internal/adapter-context.js

@@ -0,0 +1,23 @@
+import * as react from "react";
+import * as adapterScope from "./adapter-scope.js";
+/** Modulově lokální Context capability bez process-global registry mapy. */
+const adapterContext = react.createContext(undefined);
+/**
+ * Vytvoří frozen Context value pro jeden provider render.
+ */
+export function createAdapterContextValue(scope, generation) {
+    return Object.freeze({ scope, generation });
+}
+/**
+ * Vrátí nearest provider hodnotu při zachování standardního React Hook pořadí.
+ */
+export function useAdapterContext() {
+    return react.useContext(adapterContext);
+}
+/**
+ * Vystaví interní Context provider bez přidání host DOM elementu.
+ */
+export function createAdapterContextProvider(value, children) {
+    return react.createElement(adapterContext.Provider, { value }, children);
+}
+//# sourceMappingURL=adapter-context.js.map

package/dist/internal/adapter-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-context.js","sourceRoot":"","sources":["../../src/internal/adapter-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AAYnD,4EAA4E;AAC5E,MAAM,cAAc,GAAG,KAAK,CAAC,aAAa,CAAkC,SAAS,CAAC,CAAC;AAEvF;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACxC,KAAuC,EACvC,UAA+C;IAE/C,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAChC,OAAO,KAAK,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAC3C,KAA0B,EAC1B,QAAyB;IAEzB,OAAO,KAAK,CAAC,aAAa,CAAC,cAAc,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC1E,CAAC"}