@primafuture/contrib-kit-react 1.0.0

package/dist/react-adapter-diagnostics.js

@@ -0,0 +1,257 @@
+import * as contribKitCore from "@primafuture/contrib-kit-core";
+import * as adapterConfiguration from "./internal/adapter-configuration.js";
+import * as reactAdapterError from "./react-adapter-error.js";
+/** Přesné Core kódy, které smí adapter zveřejnit jako bezpečný string. */
+const coreErrorCodes = new Set([
+    "INVALID_ARGUMENT",
+    "INVALID_POINT_ID",
+    "INVALID_CONTRIBUTION_ID",
+    "INVALID_CONTRACT_VERSION",
+    "INVALID_CARDINALITY",
+    "INVALID_POLICY",
+    "FORGED_EXTENSION_POINT",
+    "FOREIGN_CORE_RUNTIME_POINT",
+    "POINT_ALREADY_REGISTERED",
+    "POINT_ID_COLLISION",
+    "POINT_NOT_REGISTERED",
+    "POINT_CLOSING",
+    "POINT_CLOSED",
+    "POINT_CONTRACT_VERSION_MISMATCH",
+    "REGISTRY_DISPOSING",
+    "REGISTRY_DISPOSED",
+    "OWNER_SCOPE_DISPOSING",
+    "OWNER_SCOPE_DISPOSED",
+    "CONTRIBUTION_ID_COLLISION",
+    "POINT_CARDINALITY_EXCEEDED",
+    "CONTRIBUTION_DATA_INVALID",
+    "CONTRIBUTION_IMPLEMENTATION_INVALID",
+    "CONTEXT_INVALID",
+    "REGISTRATION_CANCELLED",
+    "REGISTRATION_PREPARE_FAILED",
+    "REGISTRATION_PREPARE_TIMEOUT",
+    "REPLACEMENT_TARGET_NOT_FOUND",
+    "REPLACEMENT_TARGET_STALE",
+    "ORDERING_POLICY_FAILED",
+    "ORDERING_RESULT_INVALID",
+    "FILTER_POLICY_FAILED",
+    "SELECTION_POLICY_FAILED",
+    "SELECTION_RESULT_INVALID",
+    "CLEANUP_FAILED",
+    "CLEANUP_TIMEOUT",
+    "HOT_KEY_COLLISION",
+    "INCOMPATIBLE_HOT_UPDATE",
+]);
+/** Stabilní seznam adapter fází přijímaných z vlastní bezpečné chyby. */
+const reactAdapterErrorPhases = new Set([
+    "configuration",
+    "resolve",
+    "load",
+    "render",
+    "customRender",
+    "fallback",
+    "policy",
+    "projection",
+    "callback",
+    "lifecycle",
+]);
+/**
+ * Přečte bezpečný Core code i z cizí fyzické Core runtime bez úniku accessor chyby.
+ */
+export function readCoreErrorCode(cause) {
+    if (cause instanceof contribKitCore.ContribKitError) {
+        return cause.code;
+    }
+    if (typeof cause !== "object" || cause === null) {
+        return undefined;
+    }
+    try {
+        const code = Reflect.get(cause, "code", cause);
+        return typeof code === "string" && coreErrorCodes.has(code)
+            ? code
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Odvodí závazný React code z adapter chyby nebo bezpečné Core klasifikace.
+ */
+export function resolveReactErrorCode(cause, coreCode) {
+    if (cause instanceof reactAdapterError.ReactAdapterError) {
+        return cause.code;
+    }
+    if (coreCode === "POINT_NOT_REGISTERED"
+        || coreCode === "POINT_CLOSING"
+        || coreCode === "POINT_CLOSED") {
+        return "REACT_POINT_UNAVAILABLE";
+    }
+    if (coreCode === "REGISTRY_DISPOSING" || coreCode === "REGISTRY_DISPOSED") {
+        return "REACT_REGISTRY_UNAVAILABLE";
+    }
+    return "REACT_RESOLVE_FAILED";
+}
+/**
+ * Zachová bezpečnou adapter phase, ostatní query failures zařadí do resolve.
+ */
+export function resolveReactErrorPhase(cause) {
+    if (cause instanceof reactAdapterError.ReactAdapterError) {
+        const phase = cause.details.phase;
+        if (typeof phase === "string"
+            && reactAdapterErrorPhases.has(phase)) {
+            return phase;
+        }
+    }
+    return "resolve";
+}
+/**
+ * Projektuje pouze známá scalar point metadata a při getter failure raději nic.
+ */
+export function createPointMetadata(point) {
+    if (point === undefined) {
+        return undefined;
+    }
+    try {
+        const pointId = point.pointId;
+        const contractVersion = point.contractVersion;
+        const cardinality = point.cardinality;
+        const ownerId = point.ownerId;
+        const localName = point.localName;
+        const label = point.label;
+        if (typeof pointId !== "string"
+            || pointId.length === 0
+            || typeof contractVersion !== "number"
+            || !Number.isSafeInteger(contractVersion)
+            || contractVersion < 1
+            || (cardinality !== "single" && cardinality !== "many")
+            || (ownerId !== undefined && typeof ownerId !== "string")
+            || (localName !== undefined && typeof localName !== "string")
+            || (label !== undefined && typeof label !== "string")) {
+            return undefined;
+        }
+        return Object.freeze({
+            pointId,
+            contractVersion,
+            cardinality,
+            ...(ownerId === undefined ? {} : { ownerId }),
+            ...(localName === undefined ? {} : { localName }),
+            ...(label === undefined ? {} : { label }),
+        });
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Projektuje contribution metadata bez jediného čtení dat nebo implementation.
+ */
+export function createContributionMetadata(contribution) {
+    if (contribution === undefined) {
+        return undefined;
+    }
+    try {
+        const registrationId = contribution.registrationId;
+        const contributionId = contribution.contributionId;
+        const contributorId = contribution.contributorId;
+        const localName = contribution.localName;
+        const label = contribution.label;
+        return Object.freeze({
+            registrationId,
+            contributionId,
+            ...(contributorId === undefined ? {} : { contributorId }),
+            ...(localName === undefined ? {} : { localName }),
+            ...(label === undefined ? {} : { label }),
+        });
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Vytvoří shallow-frozen veřejný event bez raw contextu nebo registry capability.
+ */
+export function createReactAdapterErrorEvent(input) {
+    return Object.freeze({
+        code: input.code,
+        phase: input.phase,
+        cause: input.cause,
+        ...(input.boundaryId === undefined ? {} : { boundaryId: input.boundaryId }),
+        ...(input.contribution === undefined ? {} : { contribution: input.contribution }),
+        ...(input.coreCode === undefined ? {} : { coreCode: input.coreCode }),
+        ...(input.outletId === undefined ? {} : { outletId: input.outletId }),
+        ...(input.point === undefined ? {} : { point: input.point }),
+        ...(input.reactComponentStack === undefined
+            ? {}
+            : { reactComponentStack: input.reactComponentStack }),
+        ...(input.retryGeneration === undefined
+            ? {}
+            : { retryGeneration: input.retryGeneration }),
+        ...(input.hasContextProjection === true
+            ? { contextProjection: input.contextProjection }
+            : {}),
+    });
+}
+/**
+ * Zabalí veřejnou chybu do frozen diagnostic union větve.
+ */
+export function createErrorDiagnostic(error) {
+    return Object.freeze({ kind: "error", error });
+}
+/**
+ * Vytvoří frozen late-result event bez raw settlement hodnoty, cause nebo contextu.
+ */
+export function createLateLazyResultDiagnostic(input) {
+    return Object.freeze({
+        kind: "lateLazyResult",
+        boundaryId: input.boundaryId,
+        contribution: input.contribution,
+        outcome: input.outcome,
+        outletId: input.outletId,
+        ...(input.point === undefined ? {} : { point: input.point }),
+        retryGeneration: input.retryGeneration,
+    });
+}
+/**
+ * Pohltí Promise, cizí thenable i jejich pozdní rejection bez diagnostické rekurze.
+ */
+export function normalizeSinkResult(result) {
+    try {
+        /** Sink rejection nemá business ani další diagnostickou autoritu. */
+        function ignoreSinkRejection() {
+            // Best-effort sink záměrně končí bez dalšího eventu.
+        }
+        void Promise.resolve(result).catch(ignoreSinkRejection);
+    }
+    catch {
+        // Throwing then getter nesmí opustit diagnostickou hranici.
+    }
+}
+/**
+ * Doručí command-free diagnostiku custom sinku nebo bezpečnému console fallbacku.
+ */
+export function reportReactAdapterDiagnostic(event, configuration, development = true) {
+    if (configuration.sink !== undefined) {
+        try {
+            normalizeSinkResult(adapterConfiguration.callCapturedReactAdapterSink(configuration.sink, event));
+        }
+        catch {
+            // Sync sink throw nesmí změnit committed React stav.
+        }
+        return;
+    }
+    if (event.kind !== "error" && !development) {
+        return;
+    }
+    try {
+        const consoleReceiver = globalThis.console;
+        const method = event.kind === "error" ? "error" : "warn";
+        const report = Reflect.get(consoleReceiver, method, consoleReceiver);
+        if (typeof report === "function") {
+            normalizeSinkResult(Reflect.apply(report, consoleReceiver, [event]));
+        }
+    }
+    catch {
+        // Chybějící nebo rozbitý console fallback je bezpečný no-op.
+    }
+}
+//# sourceMappingURL=react-adapter-diagnostics.js.map

package/dist/react-adapter-diagnostics.js.map

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

package/dist/react-adapter-error.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Stable public code for expected React adapter errors.
+ *
+ * @public
+ */
+export type ReactAdapterErrorCode = "REACT_INVALID_ARGUMENT" | "REACT_REGISTRY_NOT_PROVIDED" | "REACT_REGISTRY_INVALID" | "REACT_REGISTRY_UNAVAILABLE" | "REACT_ADAPTER_DISPOSED" | "REACT_POINT_IMPLEMENTATION_INVALID" | "REACT_POINT_UNAVAILABLE" | "REACT_RESOLVE_FAILED" | "REACT_LAZY_LOAD_FAILED" | "REACT_RENDER_FAILED" | "REACT_ERROR_POLICY_FAILED" | "REACT_CONTEXT_PROJECTION_FAILED" | "REACT_CALLBACK_FAILED";
+/**
+ * Stable phase in which the React adapter captured an error.
+ *
+ * @public
+ */
+export type ReactAdapterErrorPhase = "configuration" | "resolve" | "load" | "render" | "customRender" | "fallback" | "policy" | "projection" | "callback" | "lifecycle";
+/**
+ * Stable public React adapter error with safe immutable details.
+ *
+ * @public
+ */
+export declare class ReactAdapterError extends Error {
+    /** Machine-readable classification of the adapter error. */
+    readonly code: ReactAdapterErrorCode;
+    /** Shallow-frozen safe metadata without raw contribution values. */
+    readonly details: Readonly<Record<string, unknown>>;
+    /** Original throwable preserved when wrapping a foreign error. */
+    readonly cause?: unknown;
+    /**
+     * Creates a public error with a stable code and its own copy of details.
+     */
+    constructor(code: ReactAdapterErrorCode, message: string, options?: {
+        /** Original throwable that caused the stable wrapper. */
+        readonly cause?: unknown;
+        /** Safe scalar metadata for the specific failure phase. */
+        readonly details?: Readonly<Record<string, unknown>>;
+    });
+}
+//# sourceMappingURL=react-adapter-error.d.ts.map

package/dist/react-adapter-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-adapter-error.d.ts","sourceRoot":"","sources":["../src/react-adapter-error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAC9B,wBAAwB,GACxB,6BAA6B,GAC7B,wBAAwB,GACxB,4BAA4B,GAC5B,wBAAwB,GACxB,oCAAoC,GACpC,yBAAyB,GACzB,sBAAsB,GACtB,wBAAwB,GACxB,qBAAqB,GACrB,2BAA2B,GAC3B,iCAAiC,GACjC,uBAAuB,CAAC;AAE3B;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAC/B,eAAe,GACf,SAAS,GACT,MAAM,GACN,QAAQ,GACR,cAAc,GACd,UAAU,GACV,QAAQ,GACR,YAAY,GACZ,UAAU,GACV,WAAW,CAAC;AAWf;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC3C,4DAA4D;IAC5D,SAAgB,IAAI,EAAE,qBAAqB,CAAC;IAE5C,oEAAoE;IACpE,SAAgB,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAE3D,kEAAkE;IAClE,SAAyB,KAAK,CAAC,EAAE,OAAO,CAAC;IAEzC;;OAEG;IACH,YACC,IAAI,EAAE,qBAAqB,EAC3B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACT,yDAAyD;QACzD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QACzB,2DAA2D;QAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;KACrD,EAcD;CACD"}

package/dist/react-adapter-error.js

@@ -0,0 +1,37 @@
+/**
+ * Vytvoří vlastní shallow-frozen kopii bezpečných detailů chyby.
+ */
+function copyErrorDetails(details) {
+    return Object.freeze(details === undefined ? {} : { ...details });
+}
+/**
+ * Stable public React adapter error with safe immutable details.
+ *
+ * @public
+ */
+export class ReactAdapterError extends Error {
+    /** Machine-readable classification of the adapter error. */
+    code;
+    /** Shallow-frozen safe metadata without raw contribution values. */
+    details;
+    /** Original throwable preserved when wrapping a foreign error. */
+    cause;
+    /**
+     * Creates a public error with a stable code and its own copy of details.
+     */
+    constructor(code, message, options) {
+        super(message);
+        this.name = "ReactAdapterError";
+        this.code = code;
+        this.details = copyErrorDetails(options?.details);
+        if (options !== undefined && Object.hasOwn(options, "cause")) {
+            Object.defineProperty(this, "cause", {
+                configurable: true,
+                enumerable: false,
+                value: options.cause,
+                writable: false,
+            });
+        }
+    }
+}
+//# sourceMappingURL=react-adapter-error.js.map

package/dist/react-adapter-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-adapter-error.js","sourceRoot":"","sources":["../src/react-adapter-error.ts"],"names":[],"mappings":"AAqCA;;GAEG;AACH,SAAS,gBAAgB,CACxB,OAAsD;IAEtD,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AACnE,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC3C,4DAA4D;IAC5C,IAAI,CAAwB;IAE5C,oEAAoE;IACpD,OAAO,CAAoC;IAE3D,kEAAkE;IACzC,KAAK,CAAW;IAEzC;;OAEG;IACH,YACC,IAA2B,EAC3B,OAAe,EACf,OAKC;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAClD,IAAI,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;YAC9D,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE;gBACpC,YAAY,EAAE,IAAI;gBAClB,UAAU,EAAE,KAAK;gBACjB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,QAAQ,EAAE,KAAK;aACf,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;CACD"}

package/dist/react-extension-point.d.ts

@@ -0,0 +1,26 @@
+import * as contribKitCore from "@primafuture/contrib-kit-core";
+/**
+ * React-specific extension point with an eager or managed-lazy implementation axis.
+ *
+ * @public
+ */
+export type ReactExtensionPoint<Context, Data, PointId extends string = string, ContractVersion extends number = number> = contribKitCore.ExtensionPoint<Context, Data, import("./react-lazy-contribution.js").ReactContributionImplementation<Context, Data>, PointId, ContractVersion>;
+/**
+ * Any React extension point accepted by generic adapter APIs.
+ *
+ * @public
+ */
+export type AnyReactExtensionPoint = ReactExtensionPoint<any, any, any, any>;
+/**
+ * Core point definition specialized for React contribution implementations.
+ *
+ * @public
+ */
+export type ReactExtensionPointDefinition<Context, Data, PointId extends string, ContractVersion extends number> = contribKitCore.ExtensionPointDefinition<Context, Data, import("./react-lazy-contribution.js").ReactContributionImplementation<Context, Data>, PointId, ContractVersion>;
+/**
+ * Creates an authentic Core point with a built-in React implementation validator.
+ *
+ * @public
+ */
+export declare function defineReactExtensionPoint<Context, Data>(): <const PointId extends string, const ContractVersion extends number>(definition: ReactExtensionPointDefinition<Context, Data, PointId, ContractVersion>, options?: contribKitCore.ExtensionPointFactoryOptions) => ReactExtensionPoint<Context, Data, PointId, ContractVersion>;
+//# sourceMappingURL=react-extension-point.d.ts.map

package/dist/react-extension-point.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-extension-point.d.ts","sourceRoot":"","sources":["../src/react-extension-point.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,cAAc,MAAM,+BAA+B,CAAC;AA2GhE;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,CAC9B,OAAO,EACP,IAAI,EACJ,OAAO,SAAS,MAAM,GAAG,MAAM,EAC/B,eAAe,SAAS,MAAM,GAAG,MAAM,IACpC,cAAc,CAAC,cAAc,CAChC,OAAO,EACP,IAAI,EACJ,OAAO,8BAA8B,EAAE,+BAA+B,CAAC,OAAO,EAAE,IAAI,CAAC,EACrF,OAAO,EACP,eAAe,CACf,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAE7E;;;;GAIG;AACH,MAAM,MAAM,6BAA6B,CACxC,OAAO,EACP,IAAI,EACJ,OAAO,SAAS,MAAM,EACtB,eAAe,SAAS,MAAM,IAC3B,cAAc,CAAC,wBAAwB,CAC1C,OAAO,EACP,IAAI,EACJ,OAAO,8BAA8B,EAAE,+BAA+B,CAAC,OAAO,EAAE,IAAI,CAAC,EACrF,OAAO,EACP,eAAe,CACf,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,IAAI,KAAK,CAC3D,KAAK,CAAC,OAAO,SAAS,MAAM,EAC5B,KAAK,CAAC,eAAe,SAAS,MAAM,EAEpC,UAAU,EAAE,6BAA6B,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,CAAC,EAClF,OAAO,CAAC,EAAE,cAAc,CAAC,4BAA4B,KACjD,mBAAmB,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,CAAC,CAmBhE"}

package/dist/react-extension-point.js

@@ -0,0 +1,100 @@
+import * as contribKitCore from "@primafuture/contrib-kit-core";
+import * as implementationClassifier from "./internal/implementation-classifier.js";
+/** Immutable prázdný issues seznam vestavěného negativního výsledku. */
+const emptyValidationIssues = Object.freeze([]);
+/** Sdílený platný výsledek vestavěného classifier validátoru. */
+const validImplementationResult = Object.freeze({ valid: true });
+/** Sdílený negativní výsledek bez raw implementation hodnoty. */
+const invalidImplementationResult = Object.freeze({
+    valid: false,
+    issues: emptyValidationIssues,
+});
+/**
+ * Spustí vestavěnou React implementation klasifikaci bez obalení accessor chyby.
+ */
+function validateReactImplementation(value) {
+    return implementationClassifier.classifyReactContributionImplementation(value).kind === "invalid"
+        ? invalidImplementationResult
+        : validImplementationResult;
+}
+/**
+ * Rozpozná hodnotu, kterou lze transparentně obalit Proxy bez předčasného čtení.
+ */
+function isProxyTarget(value) {
+    return (typeof value === "object" && value !== null) || typeof value === "function";
+}
+/**
+ * Vytvoří validator facade, jehož jediný `validate` Get zachytí host callback.
+ */
+function createImplementationValidatorFacade(value) {
+    if (value === undefined) {
+        return Object.freeze({ validate: validateReactImplementation });
+    }
+    if (!isProxyTarget(value)) {
+        return value;
+    }
+    return new Proxy(Object.create(null), {
+        get(_target, property) {
+            const captured = Reflect.get(value, property, value);
+            if (property !== "validate") {
+                return captured;
+            }
+            if (captured === undefined) {
+                return validateReactImplementation;
+            }
+            if (typeof captured !== "function") {
+                return captured;
+            }
+            const hostValidate = captured;
+            return (implementation) => {
+                const builtIn = validateReactImplementation(implementation);
+                return builtIn.valid ? hostValidate(implementation) : builtIn;
+            };
+        },
+    });
+}
+/**
+ * Doplní pouze implementation validator a ostatní nested fields transparentně předá.
+ */
+function createValidatorsFacade(value) {
+    if (value === undefined) {
+        return Object.freeze({
+            implementation: Object.freeze({ validate: validateReactImplementation }),
+        });
+    }
+    if (!isProxyTarget(value)) {
+        return value;
+    }
+    return new Proxy(Object.create(null), {
+        get(_target, property) {
+            const captured = Reflect.get(value, property, value);
+            return property === "implementation"
+                ? createImplementationValidatorFacade(captured)
+                : captured;
+        },
+    });
+}
+/**
+ * Vytvoří transparentní definition facade; samotný read-once capture vlastní Core.
+ */
+function createDefinitionFacade(value) {
+    if (!isProxyTarget(value)) {
+        return value;
+    }
+    return new Proxy(Object.create(null), {
+        get(_target, property) {
+            const captured = Reflect.get(value, property, value);
+            return property === "validators" ? createValidatorsFacade(captured) : captured;
+        },
+    });
+}
+/**
+ * Creates an authentic Core point with a built-in React implementation validator.
+ *
+ * @public
+ */
+export function defineReactExtensionPoint() {
+    const defineCorePoint = contribKitCore.defineExtensionPoint();
+    return (definition, options) => defineCorePoint(createDefinitionFacade(definition), options);
+}
+//# sourceMappingURL=react-extension-point.js.map

package/dist/react-extension-point.js.map

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

package/dist/react-lazy-contribution.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Input for one managed-lazy loader attempt.
+ *
+ * @public
+ */
+export interface ReactLazyContributionLoadInput {
+    /** Abort signal owned by the specific render boundary generation. */
+    readonly signal: import("@primafuture/contrib-kit-core").ContributionAbortSignal;
+}
+/**
+ * Public input for the managed-lazy contribution convenience factory.
+ *
+ * @public
+ */
+export interface ReactLazyContributionInput<Context, Data> {
+    /** Loads a React contribution component for one boundary-owned attempt. */
+    readonly load: (input: ReactLazyContributionLoadInput) => Promise<import("./contribution-component.js").ReactContributionComponent<Context, Data>>;
+}
+/**
+ * Structural managed-lazy descriptor recognizable across two adapter runtimes.
+ *
+ * @public
+ */
+export interface ReactLazyContribution<Context, Data> extends ReactLazyContributionInput<Context, Data> {
+    /** Reserved literal that distinguishes the descriptor from an eager React component. */
+    readonly kind: "contrib-kit-react-lazy";
+}
+/**
+ * Implementation axis of a React extension point.
+ *
+ * @public
+ */
+export type ReactContributionImplementation<Context, Data> = import("./contribution-component.js").ReactContributionComponent<Context, Data> | ReactLazyContribution<Context, Data>;
+/**
+ * Captures the loader exactly once and creates a shallow-frozen structural descriptor.
+ *
+ * @public
+ */
+export declare function defineReactLazyContribution<Context, Data>(input: ReactLazyContributionInput<Context, Data>): ReactLazyContribution<Context, Data>;
+//# sourceMappingURL=react-lazy-contribution.d.ts.map

package/dist/react-lazy-contribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-lazy-contribution.d.ts","sourceRoot":"","sources":["../src/react-lazy-contribution.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,8BAA8B;IAC9C,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,OAAO,+BAA+B,EAAE,uBAAuB,CAAC;CACjF;AAED;;;;GAIG;AACH,MAAM,WAAW,0BAA0B,CAAC,OAAO,EAAE,IAAI;IACxD,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,CACd,KAAK,EAAE,8BAA8B,KACjC,OAAO,CAAC,OAAO,6BAA6B,EAAE,0BAA0B,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;CAC9F;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB,CAAC,OAAO,EAAE,IAAI,CACnD,SAAQ,0BAA0B,CAAC,OAAO,EAAE,IAAI,CAAC;IACjD,wFAAwF;IACxF,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;CACxC;AAED;;;;GAIG;AACH,MAAM,MAAM,+BAA+B,CAAC,OAAO,EAAE,IAAI,IACtD,OAAO,6BAA6B,EAAE,0BAA0B,CAAC,OAAO,EAAE,IAAI,CAAC,GAC/E,qBAAqB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAExC;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,IAAI,EACxD,KAAK,EAAE,0BAA0B,CAAC,OAAO,EAAE,IAAI,CAAC,GAC9C,qBAAqB,CAAC,OAAO,EAAE,IAAI,CAAC,CActC"}

package/dist/react-lazy-contribution.js

@@ -0,0 +1,18 @@
+import * as publicInputCapture from "./internal/public-input-capture.js";
+/**
+ * Captures the loader exactly once and creates a shallow-frozen structural descriptor.
+ *
+ * @public
+ */
+export function defineReactLazyContribution(input) {
+    const source = publicInputCapture.requireInputObject(input, "input");
+    const load = publicInputCapture.readInputProperty(source, "load", "input.load");
+    if (typeof load !== "function") {
+        return publicInputCapture.throwInvalidCapturedArgument("input.load", "input.load must be callable.");
+    }
+    return Object.freeze({
+        kind: "contrib-kit-react-lazy",
+        load: load,
+    });
+}
+//# sourceMappingURL=react-lazy-contribution.js.map

package/dist/react-lazy-contribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-lazy-contribution.js","sourceRoot":"","sources":["../src/react-lazy-contribution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,kBAAkB,MAAM,oCAAoC,CAAC;AA4CzE;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAC1C,KAAgD;IAEhD,MAAM,MAAM,GAAG,kBAAkB,CAAC,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACrE,MAAM,IAAI,GAAG,kBAAkB,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;IAChF,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;QAChC,OAAO,kBAAkB,CAAC,4BAA4B,CACrD,YAAY,EACZ,8BAA8B,CAC9B,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC;QACpB,IAAI,EAAE,wBAAiC;QACvC,IAAI,EAAE,IAAyD;KAC/D,CAAC,CAAC;AACJ,CAAC"}

package/dist/resolved-contributions.d.ts

@@ -0,0 +1,90 @@
+import * as contribKitCore from "@primafuture/contrib-kit-core";
+import * as adapterScope from "./internal/adapter-scope.js";
+import * as outletCommitLease from "./internal/outlet-commit-lease.js";
+import * as outletInput from "./internal/outlet-input.js";
+import * as resolvedContributionsQuery from "./internal/resolved-contributions-query.js";
+import type * as reactExtensionPoint from "./react-extension-point.js";
+/** Empty klasifikace úspěšného resolved view. @public */
+export type ExtensionOutletEmptyReason = "noRegistrations" | "excludedByPolicy";
+/**
+ * Frozen synchronní výsledek jednoho render-time Core query.
+ *
+ * @public
+ */
+export type ResolvedContributionsState<Point extends import("./react-extension-point.js").AnyReactExtensionPoint> = {
+    /** Rozlišuje úspěšný resolved view od failure. */
+    readonly status: "resolved";
+    /** Frozen normalized contributions v přesném Core pořadí. */
+    readonly contributions: readonly contribKitCore.RegisteredContribution<Point>[];
+    /** Důvod prázdného výsledku nebo null pro neprázdnou kolekci. */
+    readonly emptyReason: ExtensionOutletEmptyReason | null;
+} | {
+    /** Rozlišuje resolve failure od úspěšného empty view. */
+    readonly status: "failed";
+    /** Sdílená frozen prázdná tuple bez stale příspěvků. */
+    readonly contributions: readonly [];
+    /** Frozen bezpečný error event připravený pro UI i sink. */
+    readonly error: import("./react-adapter-diagnostics.js").ReactAdapterErrorEvent;
+};
+/**
+ * Read-once vstup synchronního resolved hooku.
+ *
+ * @public
+ */
+export interface UseResolvedContributionsOptions<Point extends import("./react-extension-point.js").AnyReactExtensionPoint> {
+    /** Point-specific context předaný Core resolution pipeline. */
+    readonly context: contribKitCore.ExtensionPointContext<Point>;
+    /** 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;
+    /** Lokální diagnostic sink; null obnoví bezpečný package fallback. */
+    readonly sink?: import("./react-adapter-diagnostics.js").ReactAdapterSink | null | undefined;
+}
+/**
+ * Frozen návrat synchronního resolved hooku.
+ *
+ * @public
+ */
+export interface UseResolvedContributionsResult<Point extends import("./react-extension-point.js").AnyReactExtensionPoint> {
+    /** Aktuální frozen resolved nebo failed stav. */
+    readonly state: ResolvedContributionsState<Point>;
+    /** Stabilní lokální invalidace bez Core commitu. */
+    refresh(): void;
+}
+/** Interní binding, který outletu zpřístupní přesně stejnou query a scope autoritu. */
+export interface OutletResolvedContributionsBinding<Point extends reactExtensionPoint.AnyReactExtensionPoint> {
+    /** Read-once outlet input použitý query i rendererem. */
+    readonly input: outletInput.CapturedOutletInput<Point>;
+    /** Public frozen resolved výsledek stejného render attemptu. */
+    readonly result: UseResolvedContributionsResult<Point>;
+    /** Opaque query attempt pro committed callback deduplikaci. */
+    readonly attempt: resolvedContributionsQuery.ResolvedQueryAttempt<Point>;
+    /** Scope-local owner bridge, diagnostik a commit leases. */
+    readonly scope: adapterScope.AdapterScopeRuntime;
+    /** Active generation nutná pro membership commit lease. */
+    readonly generation: adapterScope.AdapterScopeGeneration | undefined;
+    /** Exact raw registry reference tvořící první osu membership identity. */
+    readonly rawRegistry: object;
+    /** Ověří, že render attempt je právě committed a commandově current. */
+    readonly isCurrent: () => boolean;
+    /** Render-time authority checkpoint pro atomickou outlet projection. */
+    readonly checkpoint: () => void;
+    /** Commit-owned outlet identita, dostupná až po autoritativním mountu. */
+    readonly outletLease: outletCommitLease.OutletCommitLease | undefined;
+    /** True při serveru a prvním hydration renderu nad společným sentinel snapshotem. */
+    readonly serverSnapshot: boolean;
+}
+/**
+ * Synchronně promítne public Core katalog do React render state.
+ *
+ * @public
+ */
+export declare function useResolvedContributions<Point extends import("./react-extension-point.js").AnyReactExtensionPoint>(options: UseResolvedContributionsOptions<Point>): UseResolvedContributionsResult<Point>;
+/**
+ * Interně promítne outlet props stejným subscriberem, query a committed autoritou.
+ */
+export declare function useResolvedContributionsForOutlet<Point extends reactExtensionPoint.AnyReactExtensionPoint>(props: object, commitObserver?: (binding: OutletResolvedContributionsBinding<Point>) => void): OutletResolvedContributionsBinding<Point>;
+//# sourceMappingURL=resolved-contributions.d.ts.map