@primafuture/contrib-kit-react 1.0.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026 PrimaFuture.cz s.r.o.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,294 @@
+# @primafuture/contrib-kit-react
+
+Typed React contribution components and synchronous resolved Core views for Contrib
+Kit. The package provides typed point helpers, a scoped registry provider,
+`useResolvedContributions()`, and a headless `ExtensionOutlet` with logical placement,
+isolated error boundaries, policy, retry, and commit-only managed-lazy loading.
+
+Install the framework-neutral Core and React peers together:
+
+```sh
+pnpm add @primafuture/contrib-kit-core @primafuture/contrib-kit-react react react-dom
+```
+
+```ts
+import {
+  defineReactContributionComponent,
+  defineReactExtensionPoint,
+  defineReactLazyContribution,
+  ExtensionOutlet,
+  ExtensionRegistryProvider,
+  useResolvedContributions,
+} from "@primafuture/contrib-kit-react";
+import { createExtensionRegistry } from "@primafuture/contrib-kit-core";
+
+interface PanelContext {
+  readonly locale: string;
+}
+
+interface PanelData {
+  readonly title: string;
+}
+
+const Panel = defineReactContributionComponent(
+  function Panel(props: {
+    readonly context: PanelContext;
+    readonly contribution: {
+      readonly contributionId: string;
+      readonly data: PanelData;
+    };
+    readonly placement: {
+      readonly index: number;
+      readonly count: number;
+      readonly isFirst: boolean;
+      readonly isLast: boolean;
+    };
+  }) {
+    return `${props.context.locale}: ${props.contribution.data.title}`;
+  },
+);
+
+const panels = defineReactExtensionPoint<PanelContext, PanelData>()({
+  pointId: "example.panels",
+  contractVersion: 1,
+  cardinality: "many",
+});
+
+const lazyPanel = defineReactLazyContribution({
+  async load() {
+    return Panel;
+  },
+});
+
+const registry = createExtensionRegistry();
+registry.rootScope.registerPoint(panels);
+const registration = registry.registerContribution(panels, {
+	contributionId: "example.panel",
+	expectedContractVersion: 1,
+	implementation: lazyPanel,
+  data: { title: "Overview" },
+});
+
+await registration.whenActive();
+
+function PanelList() {
+  const { state, refresh } = useResolvedContributions({
+    point: panels,
+    context: { locale: "en" },
+  });
+
+  if (state.status === "failed") {
+    return <button onClick={refresh}>Retry resolution</button>;
+  }
+
+  return (
+    <ul>
+      {state.contributions.map((contribution) => (
+        <li key={contribution.registrationId}>{contribution.data.title}</li>
+      ))}
+    </ul>
+  );
+}
+
+const app = (
+  <ExtensionRegistryProvider registry={registry}>
+    <PanelList />
+    <ExtensionOutlet
+      point={panels}
+      context={{ locale: "en" }}
+      renderLoading={({ contribution }) => (
+        <span>Loading {contribution.data.title}…</span>
+      )}
+      renderContributionError={({ error, retry }) => (
+        <button onClick={retry}>{error.code}</button>
+      )}
+    />
+  </ExtensionRegistryProvider>
+);
+
+await registry.dispose();
+```
+
+The provider owns only React adapter subscriptions; the host still owns and disposes
+the Core registry and contribution handles. `useResolvedContributions()` returns a
+frozen synchronous view, classifies empty results as `noRegistrations` or
+`excludedByPolicy`, and exposes a local `refresh()` that never commits Core state.
+`ExtensionOutlet` uses no mandatory DOM wrapper, derives frozen placement from the
+final Core order, preserves retained membership state across reorder, and confines each
+contribution behind its own policy-controlled boundary. The `lazyPanel`
+descriptor starts its loader only after a committed client passive effect. One retry
+generation owns at most one loader attempt and `AbortController`; fulfillment renders
+with the latest logical placement, while loader failures use the same contribution
+policy and retry pipeline as render failures. Lifecycle loss always removes UI and
+callback authority before dispatching an idempotent abort. A later loader settlement
+cannot change the UI; while its original outlet and scope epoch are still current, it
+may emit one safe `lateLazyResult` diagnostic without the value or rejection cause.
+A current rejection named `AbortError` remains a normal `REACT_LAZY_LOAD_FAILED`
+outcome. The host still owns any data fetching or module-loader strategy used inside
+`load()`.
+
+In React 19, placing a provider subtree inside `<Activity>` closes adapter-owned
+subscriptions and pending lazy work while hidden without discarding React membership
+state. Reveal catches up Core changes before the first visible view, preserves ready
+components and failed presentation, and restarts only a still-pending lazy attempt
+with a new abort signal. React 18 keeps the same Strict Mode lifecycle without an
+Activity-specific API requirement.
+
+## Server rendering
+
+Traditional `renderToString()` uses the same public provider and outlet. Create one
+mutable Core registry per request, register the shared immutable point contracts,
+await every contribution that the response requires, and dispose the registry in the
+request cleanup path:
+
+```tsx
+import { renderToString } from "react-dom/server";
+
+async function renderRequest(locale: string): Promise<string> {
+  const identifierPrefix = "request-a-";
+  const requestRegistry = createExtensionRegistry();
+  requestRegistry.rootScope.registerPoint(panels);
+  const requestPanel = requestRegistry.registerContribution(panels, {
+    contributionId: "request.panel",
+    expectedContractVersion: 1,
+    implementation: lazyPanel,
+    data: { title: "Overview" },
+  });
+
+  try {
+    await requestPanel.whenActive();
+    return renderToString(
+      <ExtensionRegistryProvider registry={requestRegistry}>
+        <ExtensionOutlet
+          point={panels}
+          context={{ locale }}
+          renderLoading={({ contribution, placement }) => (
+            <span data-position={`${placement.index}/${placement.count}`}>
+              Loading {contribution.data.title}…
+            </span>
+          )}
+        />
+      </ExtensionRegistryProvider>,
+      { identifierPrefix },
+    );
+  } finally {
+    await requestRegistry.dispose();
+  }
+}
+```
+
+Server rendering synchronously reads the already committed Core view. Eager
+contributions render normally; managed-lazy contributions render their deterministic
+loading state without starting the loader or creating an `AbortController`. No
+adapter subscriber, effect lease, sink callback, or error policy runs on the server.
+Descendant render failures pass through to the host's server error handling.
+
+## Hydration
+
+Before `hydrateRoot()`, reconstruct the same committed logical view in a new
+client-owned Core registry. Point and contribution IDs, contract versions, data,
+context, order, selection result, eager/lazy kind, and render props must match the
+server response. Runtime registration IDs do not need to match and must not be
+serialized into HTML or bootstrap data.
+
+```tsx
+import { hydrateRoot } from "react-dom/client";
+
+const clientRegistry = createExtensionRegistry();
+clientRegistry.rootScope.registerPoint(panels);
+const clientPanel = clientRegistry.registerContribution(panels, {
+  contributionId: "request.panel",
+  expectedContractVersion: 1,
+  implementation: lazyPanel,
+  data: { title: "Overview" },
+});
+
+await clientPanel.whenActive();
+
+const clientRoot = hydrateRoot(
+  document.querySelector("#app")!,
+  <ExtensionRegistryProvider registry={clientRegistry}>
+    <ExtensionOutlet
+      point={panels}
+      context={{ locale: "en" }}
+      renderLoading={({ contribution, placement }) => (
+        <span data-position={`${placement.index}/${placement.count}`}>
+          Loading {contribution.data.title}…
+        </span>
+      )}
+    />
+  </ExtensionRegistryProvider>,
+  { identifierPrefix: "request-a-" },
+);
+
+async function disposeClient(): Promise<void> {
+  clientRoot.unmount();
+  await clientRegistry.dispose();
+}
+```
+
+The `identifierPrefix` must exactly match the corresponding server
+`renderToString()` call; simultaneous roots need distinct prefixes. The first
+hydration render uses the same logical snapshot and loading placement as the server.
+A managed-lazy loader starts only after the client tree commits. If setup or hydration
+fails before the host transfers ownership to its normal lifecycle, attempt React root
+unmount first and Core registry disposal second, preserving the primary error and all
+cleanup failures.
+
+## Fast Refresh and Core HMR
+
+React component refresh and Core point refresh are two independent development
+lifecycles. Keep a component-only React Refresh boundary separate from point
+definition and registration orchestration. A valid component-only edit can preserve
+eligible local React state without committing Core state, re-registering the
+contribution, or changing its activation identity.
+
+For a point definition edit, pass the real bundler hot context and a stable `hotKey`
+through `defineReactExtensionPoint()`:
+
+```tsx
+export const panels = defineReactExtensionPoint<PanelContext, PanelData>()({
+  pointId: "app.panels",
+  contractVersion: 1,
+  cardinality: "many",
+  filter(panel, context) {
+    return panel.data.area === context.area;
+  },
+}, {
+  hot: import.meta.hot,
+  hotKey: "app.panels",
+});
+
+import.meta.hot?.accept();
+```
+
+A compatible Core refresh keeps the canonical point and active registration IDs,
+emits `pointDefinitionRefreshed`, and lets exact React consumers resolve the new
+filter, ordering, or selection result atomically. An incompatible point contract is
+rejected by Core with `INCOMPATIBLE_HOT_UPDATE` and delegates to the host invalidation
+path without publishing a partial adapter view.
+
+React Refresh state preservation remains a development-time best effort. Changing a
+module's non-component exports can invalidate its refresh boundary and legitimately
+produce a full reload or importer invalidation. Changing a managed-lazy loader or its
+descriptor is likewise not an adapter Fast Refresh contract: use an explicit Core
+contribution replacement or re-registration when the loader identity must change.
+
+## Workspace examples
+
+- The readable [React SPA](../../examples/react-spa) combines the provider, resolved
+  hook, headless outlet, Core ordering and selection, logical placement, isolated
+  failures, retry, managed lazy loading, Activity hide/reveal, and component-only
+  Fast Refresh.
+- The [React SSR and hydration example](../../examples/react-ssr) demonstrates
+  request-local registries, activation readiness, `renderToString()`, matching
+  `hydrateRoot()` ownership, post-commit lazy loading, and root-before-registry
+  cleanup.
+
+These applications provide readable development evidence. The exact-version
+documentation and isolated compatibility fixtures cover the package and release
+boundaries independently.
+
+## License
+
+ISC

package/dist/contribution-component.d.ts

@@ -0,0 +1,82 @@
+import type * as react from "react";
+/**
+ * Privátní compile-time identita, která brání záměně komponent s odlišným kontraktem.
+ */
+declare const reactContributionComponentBrand: unique symbol;
+/**
+ * Immutable public view of one contribution passed to a rendering component.
+ *
+ * @public
+ */
+export interface ExtensionContributionView<Data> {
+    /** Stable identifier of the specific contribution within the registry. */
+    readonly contributionId: string;
+    /** Optional owner identifier when the contribution declares one publicly. */
+    readonly contributorId?: string;
+    /** Opaque data projection defined by the specific extension point. */
+    readonly data: Data;
+    /** Optional human-readable label without adapter runtime identity. */
+    readonly label?: string;
+    /** Optional local name that the host can use for readable identification. */
+    readonly localName?: string;
+}
+/**
+ * Outlet-local logical placement within the final resolved contribution order.
+ *
+ * @public
+ */
+export interface ResolvedContributionPlacement {
+    /** Zero-based position within the final resolved collection. */
+    readonly index: number;
+    /** Total number of memberships in the final resolved collection. */
+    readonly count: number;
+    /** True only for the first membership in a non-empty collection. */
+    readonly isFirst: boolean;
+    /** True only for the last membership in a non-empty collection. */
+    readonly isLast: boolean;
+}
+/**
+ * The only required props passed by an outlet to a contribution component.
+ *
+ * @public
+ */
+export interface ExtensionContributionProps<Context, Data> {
+    /** Context captured for the current resolution and render attempt. */
+    readonly context: Context;
+    /** Immutable public view of the contribution currently being rendered. */
+    readonly contribution: ExtensionContributionView<Data>;
+    /** Outlet-local logical placement in the final resolved order. */
+    readonly placement: ResolvedContributionPlacement;
+}
+/**
+ * React component verified for the exact contribution context/data contract.
+ *
+ * A private brand keeps both types invariant and prevents assigning an
+ * unverified raw component without {@link defineReactContributionComponent}.
+ *
+ * @public
+ */
+export type ReactContributionComponent<Context, Data> = (react.ComponentType<any> | react.ExoticComponent<any>) & {
+    /** Compile-time identity; no property is added to the component at runtime. */
+    readonly [reactContributionComponentBrand]: {
+        /** Invariant anchor for rendering context. */
+        readonly context: (value: Context) => Context;
+        /** Invariant anchor for contribution data. */
+        readonly data: (value: Data) => Data;
+    };
+};
+/**
+ * Verifies a React component props contract and returns its original runtime reference.
+ *
+ * The component must require `context`, `contribution`, and `placement`, cannot
+ * require any additional prop, and may declare additional optional props.
+ *
+ * @public
+ */
+export declare function defineReactContributionComponent<const Component extends react.ComponentType<any> | react.ExoticComponent<any>, Props = Component extends react.ComponentType<infer ComponentProps> ? ComponentProps : Component extends react.ExoticComponent<infer ExoticProps> ? ExoticProps : never, Context = Props extends {
+    readonly context: infer ComponentContext;
+} ? ComponentContext : never, Data = Props extends {
+    readonly contribution: ExtensionContributionView<infer ComponentData>;
+} ? ComponentData : never>(component: Component & (Props extends ExtensionContributionProps<Context, Data> ? ExtensionContributionProps<Context, Data> extends Props ? unknown : never : never)): Component & ReactContributionComponent<Context, Data>;
+export {};
+//# sourceMappingURL=contribution-component.d.ts.map

package/dist/contribution-component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribution-component.d.ts","sourceRoot":"","sources":["../src/contribution-component.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC;;GAEG;AACH,OAAO,CAAC,MAAM,+BAA+B,EAAE,OAAO,MAAM,CAAC;AAE7D;;;;GAIG;AACH,MAAM,WAAW,yBAAyB,CAAC,IAAI;IAC9C,0EAA0E;IAC1E,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC,6EAA6E;IAC7E,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEhC,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAEpB,sEAAsE;IACtE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAExB,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC7C,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,0BAA0B,CAAC,OAAO,EAAE,IAAI;IACxD,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,0EAA0E;IAC1E,QAAQ,CAAC,YAAY,EAAE,yBAAyB,CAAC,IAAI,CAAC,CAAC;IAEvD,kEAAkE;IAClE,QAAQ,CAAC,SAAS,EAAE,6BAA6B,CAAC;CAClD;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,0BAA0B,CAAC,OAAO,EAAE,IAAI,IACnD,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,GAAG;IACzD,+EAA+E;IAC/E,QAAQ,CAAC,CAAC,+BAA+B,CAAC,EAAE;QAC3C,8CAA8C;QAC9C,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;QAE9C,8CAA8C;QAC9C,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,IAAI,KAAK,IAAI,CAAC;KACrC,CAAC;CACF,CAAC;AAEH;;;;;;;GAOG;AACH,wBAAgB,gCAAgC,CAC/C,KAAK,CAAC,SAAS,SAAS,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,EAC7E,KAAK,GAAG,SAAS,SAAS,KAAK,CAAC,aAAa,CAAC,MAAM,cAAc,CAAC,GAChE,cAAc,GACd,SAAS,SAAS,KAAK,CAAC,eAAe,CAAC,MAAM,WAAW,CAAC,GACzD,WAAW,GACX,KAAK,EACT,OAAO,GAAG,KAAK,SAAS;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,gBAAgB,CAAA;CAAE,GACjE,gBAAgB,GAChB,KAAK,EACR,IAAI,GAAG,KAAK,SAAS;IACpB,QAAQ,CAAC,YAAY,EAAE,yBAAyB,CAAC,MAAM,aAAa,CAAC,CAAC;CACtE,GACE,aAAa,GACb,KAAK,EAER,SAAS,EAAE,SAAS,GAAG,CACtB,KAAK,SAAS,0BAA0B,CAAC,OAAO,EAAE,IAAI,CAAC,GACpD,0BAA0B,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,KAAK,GACtD,OAAO,GACP,KAAK,GACN,KAAK,CACR,GACC,SAAS,GAAG,0BAA0B,CAAC,OAAO,EAAE,IAAI,CAAC,CAEvD"}

package/dist/contribution-component.js

@@ -0,0 +1,12 @@
+/**
+ * Verifies a React component props contract and returns its original runtime reference.
+ *
+ * The component must require `context`, `contribution`, and `placement`, cannot
+ * require any additional prop, and may declare additional optional props.
+ *
+ * @public
+ */
+export function defineReactContributionComponent(component) {
+    return component;
+}
+//# sourceMappingURL=contribution-component.js.map

package/dist/contribution-component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribution-component.js","sourceRoot":"","sources":["../src/contribution-component.ts"],"names":[],"mappings":"AAoFA;;;;;;;GAOG;AACH,MAAM,UAAU,gCAAgC,CAgB/C,SAMC;IAED,OAAO,SAA6E,CAAC;AACtF,CAAC"}

package/dist/extension-outlet.d.ts

@@ -0,0 +1,155 @@
+import type * as contribKitCore from "@primafuture/contrib-kit-core";
+import * as react from "react";
+/**
+ * Společný frozen render state jedné logical outlet membership.
+ *
+ * @public
+ */
+export interface ExtensionContributionRenderStateBase<Point extends import("./react-extension-point.js").AnyReactExtensionPoint> {
+    /** Context exact outlet resolution snapshotu. */
+    readonly context: contribKitCore.ExtensionPointContext<Point>;
+    /** Bezpečný public contribution view bez registration identity. */
+    readonly contribution: import("./contribution-component.js").ExtensionContributionView<contribKitCore.ExtensionPointData<Point>>;
+    /** Outlet-local logická pozice ve finálním Core pořadí. */
+    readonly placement: import("./contribution-component.js").ResolvedContributionPlacement;
+    /** Exact canonical React extension point. */
+    readonly point: Point;
+}
+/**
+ * Frozen render state eager nebo již načtené contribution.
+ *
+ * @public
+ */
+export interface ExtensionContributionReadyRenderState<Point extends import("./react-extension-point.js").AnyReactExtensionPoint> extends ExtensionContributionRenderStateBase<Point> {
+    /** Exact ověřená React contribution component reference. */
+    readonly component: import("./contribution-component.js").ReactContributionComponent<contribKitCore.ExtensionPointContext<Point>, contribKitCore.ExtensionPointData<Point>>;
+    /** Frozen default-render props sdílející tutéž placement referenci. */
+    readonly componentProps: import("./contribution-component.js").ExtensionContributionProps<contribKitCore.ExtensionPointContext<Point>, contribKitCore.ExtensionPointData<Point>>;
+}
+/**
+ * Frozen render state dosud nenačtené managed-lazy membership.
+ *
+ * @public
+ */
+export interface ExtensionContributionLoadingRenderState<Point extends import("./react-extension-point.js").AnyReactExtensionPoint> extends ExtensionContributionRenderStateBase<Point> {
+}
+/**
+ * Frozen render state izolované contribution chyby.
+ *
+ * @public
+ */
+export interface ExtensionContributionErrorRenderState<Point extends import("./react-extension-point.js").AnyReactExtensionPoint> extends ExtensionContributionRenderStateBase<Point> {
+    /** Tentýž frozen primary event použitý sinkem a policy. */
+    readonly error: import("./react-adapter-diagnostics.js").ReactAdapterErrorEvent;
+    /** Generation-bound recovery command dané membership. */
+    retry(): void;
+}
+/**
+ * Placement-free frozen stav úspěšného prázdného outletu.
+ *
+ * @public
+ */
+export interface ExtensionEmptyRenderState<Point extends import("./react-extension-point.js").AnyReactExtensionPoint> {
+    /** Context úspěšného empty resolution snapshotu. */
+    readonly context: contribKitCore.ExtensionPointContext<Point>;
+    /** Exact canonical point. */
+    readonly point: Point;
+    /** Rozlišení prázdného katalogu od policy-excluded výsledku. */
+    readonly reason: import("./resolved-contributions.js").ExtensionOutletEmptyReason;
+}
+/**
+ * Placement-free frozen stav neúspěšného outlet resolution.
+ *
+ * @public
+ */
+export interface ExtensionResolveErrorRenderState<Point extends import("./react-extension-point.js").AnyReactExtensionPoint> {
+    /** Context neúspěšného query attemptu. */
+    readonly context: contribKitCore.ExtensionPointContext<Point>;
+    /** Frozen primary resolve event. */
+    readonly error: import("./react-adapter-diagnostics.js").ReactAdapterErrorEvent;
+    /** Exact canonical point. */
+    readonly point: Point;
+    /** Stabilní outlet-local invalidace bez Core commitu. */
+    refresh(): void;
+}
+/**
+ * Frozen discriminovaná recovery capability doručená outlet `onError` callbacku.
+ *
+ * @public
+ */
+export type ExtensionOutletErrorEmission = {
+    /** Rozlišuje per-membership chybu. */
+    readonly kind: "contribution";
+    /** Frozen primary contribution event. */
+    readonly error: import("./react-adapter-diagnostics.js").ReactAdapterErrorEvent;
+    /** Generation-bound membership retry. */
+    retry(): void;
+} | {
+    /** Rozlišuje celý failed resolve attempt. */
+    readonly kind: "resolve";
+    /** Frozen primary resolve event. */
+    readonly error: import("./react-adapter-diagnostics.js").ReactAdapterErrorEvent;
+    /** Stabilní outlet-local refresh command. */
+    refresh(): void;
+};
+/**
+ * Frozen evidence jednoho committed accepted membership retry.
+ *
+ * @public
+ */
+export interface ExtensionOutletRetryEvent {
+    /** Opaque scope-local boundary identita. */
+    readonly boundaryId: string;
+    /** Veřejná contribution identita bez business dat. */
+    readonly contributionId: string;
+    /** Opaque scope-local outlet identita. */
+    readonly outletId: string;
+    /** Veřejná point identita. */
+    readonly pointId: string;
+    /** Opaque exact Core activation identita. */
+    readonly registrationId: string;
+    /** Nově committed monotonická retry generation. */
+    readonly retryGeneration: number;
+}
+/**
+ * Read-once props headless outletu inferované z exact React pointu.
+ *
+ * @public
+ */
+export interface ExtensionOutletProps<Point extends import("./react-extension-point.js").AnyReactExtensionPoint> {
+    /** Context předaný Core resolution pipeline a contribution props. */
+    readonly context: contribKitCore.ExtensionPointContext<Point>;
+    /** Lokální contribution policy; null obnoví package default. */
+    readonly errorPolicy?: import("./react-adapter-diagnostics.js").ReactErrorPolicy | null | undefined;
+    /** False eskaluje contribution failure bez policy izolace. */
+    readonly isolateErrors?: boolean | undefined;
+    /** Committed error callback s omezenou retry nebo refresh capability. */
+    readonly onError?: ((event: ExtensionOutletErrorEmission) => void) | undefined;
+    /** Callback až po commitu accepted retry generation. */
+    readonly onRetry?: ((event: ExtensionOutletRetryEvent) => void) | undefined;
+    /** Exact canonical React extension point. */
+    readonly point: Point;
+    /** Lokální pure context projector; null zruší inherited projector. */
+    readonly projectContext?: ((context: contribKitCore.ExtensionPointContext<Point>) => unknown) | null | undefined;
+    /** Explicitní registry s předností před nearest providerem. */
+    readonly registry?: contribKitCore.ExtensionRegistry | undefined;
+    /** Optional headless renderer ready membershipu. */
+    readonly renderContribution?: ((state: ExtensionContributionReadyRenderState<Point>) => react.ReactNode) | undefined;
+    /** Optional fallback renderer izolované contribution chyby. */
+    readonly renderContributionError?: ((state: ExtensionContributionErrorRenderState<Point>) => react.ReactNode) | undefined;
+    /** Optional renderer úspěšného prázdného výsledku. */
+    readonly renderEmpty?: ((state: ExtensionEmptyRenderState<Point>) => react.ReactNode) | undefined;
+    /** Optional renderer managed-lazy loading membershipu. */
+    readonly renderLoading?: ((state: ExtensionContributionLoadingRenderState<Point>) => react.ReactNode) | undefined;
+    /** Optional renderer celého resolve failure. */
+    readonly renderResolveError?: ((state: ExtensionResolveErrorRenderState<Point>) => react.ReactNode) | undefined;
+    /** Lokální diagnostic sink; null obnoví bezpečný package fallback. */
+    readonly sink?: import("./react-adapter-diagnostics.js").ReactAdapterSink | null | undefined;
+}
+/**
+ * Renderuje exact Core resolved kolekci jako headless React Fragment.
+ *
+ * @public
+ */
+export declare function ExtensionOutlet<Point extends import("./react-extension-point.js").AnyReactExtensionPoint>(props: ExtensionOutletProps<Point>): react.ReactElement | null;
+//# sourceMappingURL=extension-outlet.d.ts.map

package/dist/extension-outlet.d.ts.map

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