@exactjs/core 0.5.0

package/dist/server/component/log.js

@@ -0,0 +1,195 @@
+import { peek, unwrap } from '@exactjs/reactive/framework/runtime';
+import { LoggerContext } from './contexts.js';
+import { componentDomainLogging } from './domain.js';
+import {} from '../logging.js';
+import { defaultConsoleLogger } from './default-logger.js';
+export { defaultConsoleLogger } from './default-logger.js';
+/** Emits a framework-scoped log event through the supplied or default logger. */
+export function logFrameworkEvent(level, packageName, category, message, data, logger = defaultConsoleLogger) {
+    const scope = {
+        source: 'framework',
+        packageName,
+        category
+    };
+    if (!isLogEnabled(logger, level, scope))
+        return;
+    emitLogEvent(logger, {
+        level,
+        message: evaluateLogValue(message),
+        data: data === undefined ? undefined : evaluateLogValue(data),
+        scope
+    });
+}
+/** Creates a component log. */
+export function createComponentLog(instance) {
+    return new ComponentLogFacade(instance);
+}
+/**
+ * Resolves an enabled component-log method without evaluating authored log arguments.
+ * The result is intentionally decided at call time so a running application can change
+ * logger contexts or enabled levels without rebuilding its artifact.
+ */
+export function componentLogMethod(instance, level) {
+    // Compiler-generated component bodies receive either a durable instance or a compiler-selected
+    // request-local server frame. Both deliberately expose only this logging ownership contract.
+    return prepareComponentLogMethod(instance, level);
+}
+class ComponentLogFacade {
+    instance;
+    scope;
+    constructor(instance) {
+        this.instance = instance;
+        this.scope = componentLogScope(instance);
+    }
+    trace(message, data) {
+        this.method('trace')?.(() => [message, data]);
+    }
+    debug(message, data) {
+        this.method('debug')?.(() => [message, data]);
+    }
+    info(message, data) {
+        this.method('info')?.(() => [message, data]);
+    }
+    warn(message, data) {
+        this.method('warn')?.(() => [message, data]);
+    }
+    error(message, errorOrData, data) {
+        this.method('error')?.(() => [message, errorOrData, data]);
+    }
+    /**
+     * Prepares one immediate invocation against the current logger and component scope.
+     * The cached scope keeps the disabled path allocation-free after component creation;
+     * mounted state is refreshed because the facade outlives activation transitions.
+     */
+    method(level) {
+        return prepareComponentLogMethod(this.instance, level, this.scope);
+    }
+}
+/** Prepares one shared compiled/runtime logging operation for a specific component instance. */
+function prepareComponentLogMethod(instance, level, cachedScope) {
+    const logger = resolveLogger(instance);
+    // The built-in logger's enablement is scope-independent. Avoid constructing a component scope
+    // for the overwhelmingly common disabled trace/debug checks on interaction and task hot paths.
+    if (logger === defaultConsoleLogger &&
+        !isLogEnabled(logger, level, defaultComponentEnablementScope))
+        return undefined;
+    const scope = cachedScope ?? componentLogScope(instance);
+    if (scope.component)
+        scope.component.mounted = instance.mounted;
+    if (logger !== defaultConsoleLogger && !isLogEnabled(logger, level, scope))
+        return undefined;
+    return (readArguments) => {
+        peek(() => {
+            const [message, errorOrData, data] = readArguments();
+            emitPreparedComponentLog(logger, scope, level, message, errorOrData, data);
+        });
+    };
+}
+const defaultComponentEnablementScope = Object.freeze({ source: 'component' });
+function emitPreparedComponentLog(logger, scope, level, message, errorOrData, data) {
+    const evaluatedMessage = evaluateLogValue(message);
+    let evaluatedError;
+    let evaluatedData;
+    if (level === 'error' && data !== undefined) {
+        evaluatedError = evaluateLogValue(errorOrData);
+        evaluatedData = evaluateLogValue(data);
+    }
+    else if (level === 'error' && errorOrData !== undefined) {
+        const value = evaluateLogValue(errorOrData);
+        if (isErrorLike(value)) {
+            evaluatedError = value;
+        }
+        else {
+            evaluatedData = value;
+        }
+    }
+    else if (errorOrData !== undefined) {
+        evaluatedData = evaluateLogValue(errorOrData);
+    }
+    emitLogEvent(logger, {
+        level,
+        message: evaluatedMessage,
+        error: evaluatedError,
+        data: evaluatedData,
+        scope
+    });
+}
+function isLogEnabled(logger, level, scope) {
+    try {
+        return !logger.isEnabled || logger.isEnabled(level, scope);
+    }
+    catch (error) {
+        reportLoggerFailure(error);
+        return false;
+    }
+}
+function emitLogEvent(logger, event) {
+    try {
+        logger.log(event);
+    }
+    catch (error) {
+        reportLoggerFailure(error);
+    }
+}
+function reportLoggerFailure(error) {
+    try {
+        defaultConsoleLogger.log({
+            level: 'error',
+            message: 'logger failed while handling eXact log event',
+            error,
+            scope: {
+                source: 'framework',
+                packageName: 'core',
+                category: 'logger'
+            }
+        });
+    }
+    catch {
+        // Logging failures must not become application failures.
+    }
+}
+function resolveLogger(instance) {
+    const shared = componentDomainLogging(instance.domain);
+    if (shared && !shared.componentOverride)
+        return shared.logger ?? defaultConsoleLogger;
+    let cursor = instance.parent;
+    while (cursor) {
+        if (cursor.contexts.has(LoggerContext.id)) {
+            return unwrap(cursor.contexts.get(LoggerContext.id));
+        }
+        cursor = cursor.parent;
+    }
+    if (instance.ambientContexts?.has(LoggerContext.id)) {
+        return unwrap(instance.ambientContexts.get(LoggerContext.id));
+    }
+    return defaultConsoleLogger;
+}
+/** Performs the component log scope domain operation. */
+export function componentLogScope(instance) {
+    return {
+        source: 'component',
+        component: {
+            id: instance.id,
+            name: instance.type.name || 'anonymous',
+            mounted: instance.mounted
+        }
+    };
+}
+function evaluateLogValue(value) {
+    return typeof value === 'function' ? value() : value;
+}
+function isErrorLike(value) {
+    return value instanceof Error;
+}
+/** Reports whether error report. */
+export function isErrorReport(value) {
+    return (!!value && typeof value === 'object' && 'id' in value && 'error' in value && 'source' in value);
+}
+/** Performs the format error domain operation. */
+export function formatError(error) {
+    if (error instanceof Error) {
+        return error.stack ?? error.message;
+    }
+    return String(error);
+}
+//# sourceMappingURL=log.js.map

package/dist/server/component/log.js.map

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

package/dist/server/component/logical-owner.d.ts

@@ -0,0 +1,4 @@
+import type { AnyComponentInstance, ComponentContextValues, ComponentDomain } from './contracts.js';
+/** Creates one framework-owned logical context frame without constructing a component artifact. */
+export declare function createFrameworkLogicalOwner(parent: AnyComponentInstance | undefined, ambientContexts: ComponentContextValues | undefined, domain: ComponentDomain, configure?: (owner: AnyComponentInstance) => void): AnyComponentInstance;
+//# sourceMappingURL=logical-owner.d.ts.map

package/dist/server/component/logical-owner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logical-owner.d.ts","sourceRoot":"","sources":["../../../src/component/logical-owner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EAEf,MAAM,gBAAgB,CAAC;AA2DxB,mGAAmG;AACnG,wBAAgB,2BAA2B,CAC1C,MAAM,EAAE,oBAAoB,GAAG,SAAS,EACxC,eAAe,EAAE,sBAAsB,GAAG,SAAS,EACnD,MAAM,EAAE,eAAe,EACvB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,GAC/C,oBAAoB,CAItB"}

package/dist/server/component/logical-owner.js

@@ -0,0 +1,50 @@
+import { CompactComponentInstance } from './compact-instance.js';
+const logicalOwnerType = function ExactLogicalOwner() {
+    return () => null;
+};
+const unsupportedAttachment = () => {
+    throw new TypeError('A framework logical owner has no render attachment');
+};
+const logicalOwnerContract = Object.freeze({
+    version: 1,
+    placement: 'client',
+    role: 'client',
+    implementations: [],
+    continuations: [],
+    executors: [],
+    boundaries: [],
+    execution: { version: 1, ports: [], transitions: [], reactive: [] },
+    artifact: Object.freeze({
+        version: 1,
+        id: '@exactjs/core:logical-owner',
+        target: 'client',
+        abi: 0,
+        instantiate: logicalOwnerType,
+        construct: unsupportedAttachment,
+        attach: unsupportedAttachment,
+        receive() { },
+        dispose(instance, reason) {
+            instance.unmount(String(reason ?? 'logical owner disposed'));
+        },
+        state: [],
+        props: [],
+        tasks: [],
+        reactive: [],
+        render: 'returned-function',
+        capabilities: []
+    })
+});
+/** Durable context and lifecycle owner with no component topology or target attachment ABI. */
+class FrameworkLogicalOwner extends CompactComponentInstance {
+    constructor(parent, ambientContexts, domain) {
+        super(logicalOwnerType, {}, parent, ambientContexts, domain, logicalOwnerContract);
+        this.initializeComponent(() => () => null);
+    }
+}
+/** Creates one framework-owned logical context frame without constructing a component artifact. */
+export function createFrameworkLogicalOwner(parent, ambientContexts, domain, configure) {
+    const owner = new FrameworkLogicalOwner(parent, ambientContexts, domain);
+    configure?.(owner);
+    return owner;
+}
+//# sourceMappingURL=logical-owner.js.map

package/dist/server/component/logical-owner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logical-owner.js","sourceRoot":"","sources":["../../../src/component/logical-owner.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,MAAM,gBAAgB,GAGlB,SAAS,iBAAiB;IAC7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,GAAG,EAAE;IAClC,MAAM,IAAI,SAAS,CAAC,oDAAoD,CAAC,CAAC;AAC3E,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,CAAC;IACV,SAAS,EAAE,QAAQ;IACnB,IAAI,EAAE,QAAQ;IACd,eAAe,EAAE,EAAE;IACnB,aAAa,EAAE,EAAE;IACjB,SAAS,EAAE,EAAE;IACb,UAAU,EAAE,EAAE;IACd,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;IACnE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;QACvB,OAAO,EAAE,CAAC;QACV,EAAE,EAAE,6BAA6B;QACjC,MAAM,EAAE,QAAQ;QAChB,GAAG,EAAE,CAAC;QACN,WAAW,EAAE,gBAAgB;QAC7B,SAAS,EAAE,qBAAqB;QAChC,MAAM,EAAE,qBAAqB;QAC7B,OAAO,KAAI,CAAC;QACZ,OAAO,CAAC,QAA8B,EAAE,MAAe;YACtD,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,wBAAwB,CAAC,CAAC,CAAC;QAC9D,CAAC;QACD,KAAK,EAAE,EAAE;QACT,KAAK,EAAE,EAAE;QACT,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,mBAAmB;QAC3B,YAAY,EAAE,EAAE;KAChB,CAAC;CACF,CAAgD,CAAC;AAElD,+FAA+F;AAC/F,MAAM,qBAAsB,SAAQ,wBAGnC;IACA,YACC,MAAwC,EACxC,eAAmD,EACnD,MAAuB;QAEvB,KAAK,CAAC,gBAAgB,EAAE,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,oBAAoB,CAAC,CAAC;QACnF,IAAI,CAAC,mBAAmB,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;CACD;AAED,mGAAmG;AACnG,MAAM,UAAU,2BAA2B,CAC1C,MAAwC,EACxC,eAAmD,EACnD,MAAuB,EACvB,SAAiD;IAEjD,MAAM,KAAK,GAAG,IAAI,qBAAqB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;IACzE,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC;IACnB,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/server/component/ownership.d.ts

@@ -0,0 +1,4 @@
+import type { AnyComponentInstance } from './contracts.js';
+/** Transfers a live component to a new logical parent during renderer-owned root replacement. */
+export declare function reparentComponentInstance(instance: AnyComponentInstance, parent?: AnyComponentInstance): void;
+//# sourceMappingURL=ownership.d.ts.map

package/dist/server/component/ownership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownership.d.ts","sourceRoot":"","sources":["../../../src/component/ownership.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,iGAAiG;AACjG,wBAAgB,yBAAyB,CACxC,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,CAAC,EAAE,oBAAoB,GAC3B,IAAI,CAKN"}

package/dist/server/component/ownership.js

@@ -0,0 +1,9 @@
+/** Transfers a live component to a new logical parent during renderer-owned root replacement. */
+export function reparentComponentInstance(instance, parent) {
+    for (let cursor = parent; cursor; cursor = cursor.parent) {
+        if (cursor === instance)
+            throw new Error('Cannot create a component parent cycle');
+    }
+    instance.parent = parent;
+}
+//# sourceMappingURL=ownership.js.map

package/dist/server/component/ownership.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownership.js","sourceRoot":"","sources":["../../../src/component/ownership.ts"],"names":[],"mappings":"AAEA,iGAAiG;AACjG,MAAM,UAAU,yBAAyB,CACxC,QAA8B,EAC9B,MAA6B;IAE7B,KAAK,IAAI,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAC1D,IAAI,MAAM,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACpF,CAAC;IACD,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC;AAC1B,CAAC"}

package/dist/server/component/performance-trace.d.ts

@@ -0,0 +1,21 @@
+import type { AnyComponentInstance } from './contracts.js';
+/** Scalar attributes retained by a component performance trace. */
+export type ComponentTraceAttributes = Readonly<Record<string, string | number | boolean | null>>;
+/** Defers diagnostic attribute construction until a trace mark is emitted. */
+export type LazyComponentTraceAttributes = ComponentTraceAttributes | (() => ComponentTraceAttributes);
+/** Correlates allocation-on-demand timing marks for one component-owned operation. */
+export type ComponentTraceSpan = Readonly<{
+    operation: string;
+    operationId: string;
+    startedAt: number;
+}>;
+/** Enabled-only constructor for one component performance span. */
+export type ComponentTraceStarter = (operation: string, operationId: string, attributes?: ComponentTraceAttributes) => ComponentTraceSpan;
+/**
+ * Begins a component performance span only when trace logging is currently enabled.
+ * Disabled tracing performs no timestamp read and allocates no span or log arguments.
+ */
+export declare function componentTraceStarter(instance: AnyComponentInstance): ComponentTraceStarter | undefined;
+/** Emits one runtime-rechecked timing mark for an enabled component trace span. */
+export declare function markComponentTrace(instance: AnyComponentInstance, span: ComponentTraceSpan | undefined, phase: string, attributes?: LazyComponentTraceAttributes): void;
+//# sourceMappingURL=performance-trace.d.ts.map

package/dist/server/component/performance-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance-trace.d.ts","sourceRoot":"","sources":["../../../src/component/performance-trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAG3D,mEAAmE;AACnE,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;AAElG,8EAA8E;AAC9E,MAAM,MAAM,4BAA4B,GACrC,wBAAwB,GACxB,CAAC,MAAM,wBAAwB,CAAC,CAAC;AAEpC,sFAAsF;AACtF,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC;AAEH,mEAAmE;AACnE,MAAM,MAAM,qBAAqB,GAAG,CACnC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,wBAAwB,KACjC,kBAAkB,CAAC;AAExB;;;GAGG;AACH,wBAAgB,qBAAqB,CACpC,QAAQ,EAAE,oBAAoB,GAC5B,qBAAqB,GAAG,SAAS,CAiBnC;AAED,mFAAmF;AACnF,wBAAgB,kBAAkB,CACjC,QAAQ,EAAE,oBAAoB,EAC9B,IAAI,EAAE,kBAAkB,GAAG,SAAS,EACpC,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,4BAA4B,GACvC,IAAI,CAiBN"}

package/dist/server/component/performance-trace.js

@@ -0,0 +1,45 @@
+import { componentLogMethod } from './log.js';
+/**
+ * Begins a component performance span only when trace logging is currently enabled.
+ * Disabled tracing performs no timestamp read and allocates no span or log arguments.
+ */
+export function componentTraceStarter(instance) {
+    const trace = componentLogMethod(instance, 'trace');
+    if (!trace)
+        return undefined;
+    return (operation, operationId, attributes) => {
+        const span = Object.freeze({ operation, operationId, startedAt: traceTimestamp() });
+        trace(() => [
+            `performance ${operation} started`,
+            {
+                operation,
+                operationId,
+                phase: 'started',
+                elapsedMs: 0,
+                ...(attributes ? { attributes } : {})
+            }
+        ]);
+        return span;
+    };
+}
+/** Emits one runtime-rechecked timing mark for an enabled component trace span. */
+export function markComponentTrace(instance, span, phase, attributes) {
+    if (!span)
+        return;
+    componentLogMethod(instance, 'trace')?.(() => [
+        `performance ${span.operation} ${phase}`,
+        {
+            operation: span.operation,
+            operationId: span.operationId,
+            phase,
+            elapsedMs: traceTimestamp() - span.startedAt,
+            ...(attributes
+                ? { attributes: typeof attributes === 'function' ? attributes() : attributes }
+                : {})
+        }
+    ]);
+}
+function traceTimestamp() {
+    return globalThis.performance?.now() ?? Date.now();
+}
+//# sourceMappingURL=performance-trace.js.map

package/dist/server/component/performance-trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance-trace.js","sourceRoot":"","sources":["../../../src/component/performance-trace.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAwB9C;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACpC,QAA8B;IAE9B,MAAM,KAAK,GAAG,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,OAAO,CAAC,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE;QAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;QACpF,KAAK,CAAC,GAAG,EAAE,CAAC;YACX,eAAe,SAAS,UAAU;YAClC;gBACC,SAAS;gBACT,WAAW;gBACX,KAAK,EAAE,SAAS;gBAChB,SAAS,EAAE,CAAC;gBACZ,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACrC;SACD,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACb,CAAC,CAAC;AACH,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,kBAAkB,CACjC,QAA8B,EAC9B,IAAoC,EACpC,KAAa,EACb,UAAyC;IAEzC,IAAI,CAAC,IAAI;QAAE,OAAO;IAClB,kBAAkB,CACjB,QAAQ,EACR,OAAO,CACP,EAAE,CAAC,GAAG,EAAE,CAAC;QACT,eAAe,IAAI,CAAC,SAAS,IAAI,KAAK,EAAE;QACxC;YACC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,KAAK;YACL,SAAS,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC,SAAS;YAC5C,GAAG,CAAC,UAAU;gBACb,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE;gBAC9E,CAAC,CAAC,EAAE,CAAC;SACN;KACD,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,cAAc;IACtB,OAAO,UAAU,CAAC,WAAW,EAAE,GAAG,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;AACpD,CAAC"}

package/dist/server/component/plugins.d.ts

@@ -0,0 +1,3 @@
+/** Provides the canonical default contexts value. */
+export declare const defaultContexts: Map<symbol, unknown>;
+//# sourceMappingURL=plugins.d.ts.map

package/dist/server/component/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../../src/component/plugins.ts"],"names":[],"mappings":"AAMA,qDAAqD;AACrD,eAAO,MAAM,eAAe,sBAG1B,CAAC"}

package/dist/server/component/plugins.js

@@ -0,0 +1,9 @@
+import { ErrorContext, LoggerContext } from './contexts.js';
+import { defaultErrorContext } from './errors.js';
+import { defaultConsoleLogger } from './default-logger.js';
+/** Provides the canonical default contexts value. */
+export const defaultContexts = new Map([
+    [LoggerContext.id, defaultConsoleLogger],
+    [ErrorContext.id, defaultErrorContext]
+]);
+//# sourceMappingURL=plugins.js.map

package/dist/server/component/plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../../../src/component/plugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,qDAAqD;AACrD,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAkB;IACvD,CAAC,aAAa,CAAC,EAAE,EAAE,oBAAoB,CAAC;IACxC,CAAC,YAAY,CAAC,EAAE,EAAE,mBAAmB,CAAC;CACtC,CAAC,CAAC"}

package/dist/server/component/reactive-expression.d.ts

@@ -0,0 +1,4 @@
+import { type ReactiveValue } from '@exactjs/reactive/framework/runtime';
+/** Creates the reactive value exposed by the component `reactive` convenience method. */
+export declare function createComponentReactive<T>(input: TemplateStringsArray | (() => T) | T, values: readonly unknown[]): ReactiveValue<string> | ReactiveValue<T>;
+//# sourceMappingURL=reactive-expression.d.ts.map

package/dist/server/component/reactive-expression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactive-expression.d.ts","sourceRoot":"","sources":["../../../src/component/reactive-expression.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAG3F,yFAAyF;AACzF,wBAAgB,uBAAuB,CAAC,CAAC,EACxC,KAAK,EAAE,oBAAoB,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,EAC3C,MAAM,EAAE,SAAS,OAAO,EAAE,GACxB,aAAa,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAW1C"}

package/dist/server/component/reactive-expression.js

@@ -0,0 +1,19 @@
+import { computed, unwrap } from '@exactjs/reactive/framework/runtime';
+import { isTemplateStringsArray } from './construction.js';
+/** Creates the reactive value exposed by the component `reactive` convenience method. */
+export function createComponentReactive(input, values) {
+    if (typeof input === 'function')
+        return computed(input);
+    if (!isTemplateStringsArray(input))
+        return computed(() => input);
+    return computed(() => {
+        let result = '';
+        for (let index = 0; index < input.length; index++) {
+            result += input[index];
+            if (index < values.length)
+                result += String(unwrap(values[index]) ?? '');
+        }
+        return result;
+    });
+}
+//# sourceMappingURL=reactive-expression.js.map

package/dist/server/component/reactive-expression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactive-expression.js","sourceRoot":"","sources":["../../../src/component/reactive-expression.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAsB,MAAM,qCAAqC,CAAC;AAC3F,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,yFAAyF;AACzF,MAAM,UAAU,uBAAuB,CACtC,KAA2C,EAC3C,MAA0B;IAE1B,IAAI,OAAO,KAAK,KAAK,UAAU;QAAE,OAAO,QAAQ,CAAC,KAAgB,CAAC,CAAC;IACnE,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;IACjE,OAAO,QAAQ,CAAC,GAAG,EAAE;QACpB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;YACvB,IAAI,KAAK,GAAG,MAAM,CAAC,MAAM;gBAAE,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,MAAM,CAAC;IACf,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/server/component/reactive-expressions.d.ts

@@ -0,0 +1,11 @@
+import { type ReactiveValue } from '@exactjs/reactive/framework/runtime';
+import type { RenderResult } from './contracts.js';
+import { type ExactChildRangeReceipt } from '../component-abi/child-range-receipt.js';
+export { createCompiledChildRangeReceipt } from '../component-abi/compiled-child-range.js';
+/** Creates a reactive expression wrapper for compiler-generated expression boundaries. */
+export declare function createExpression<T>(compute: () => T): ReactiveValue<T>;
+/** Reuses a forwarded reactive value or observes a plain computed result. */
+export declare function createForwardedExpression<T>(compute: () => T): T | ReactiveValue<T>;
+/** Creates a focused reactive child-range operation. */
+export declare function createDynamicChild(compute: () => RenderResult, markerId?: string, mayReplaceSubtree?: boolean): ExactChildRangeReceipt;
+//# sourceMappingURL=reactive-expressions.d.ts.map

package/dist/server/component/reactive-expressions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactive-expressions.d.ts","sourceRoot":"","sources":["../../../src/component/reactive-expressions.ts"],"names":[],"mappings":"AAAA,OAAO,EAIN,KAAK,aAAa,EAClB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAEN,KAAK,sBAAsB,EAC3B,MAAM,yCAAyC,CAAC;AAEjD,OAAO,EAAE,+BAA+B,EAAE,MAAM,0CAA0C,CAAC;AAE3F,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,oBAEnD;AAED,6EAA6E;AAC7E,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAGnF;AAED,wDAAwD;AACxD,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,MAAM,YAAY,EAC3B,QAAQ,CAAC,EAAE,MAAM,EACjB,iBAAiB,UAAO,GACtB,sBAAsB,CAExB"}

package/dist/server/component/reactive-expressions.js

@@ -0,0 +1,17 @@
+import { computed, isReactiveValue, peek } from '@exactjs/reactive/framework/runtime';
+import { createChildRangeReceipt } from '../component-abi/child-range-receipt.js';
+export { createCompiledChildRangeReceipt } from '../component-abi/compiled-child-range.js';
+/** Creates a reactive expression wrapper for compiler-generated expression boundaries. */
+export function createExpression(compute) {
+    return computed(compute);
+}
+/** Reuses a forwarded reactive value or observes a plain computed result. */
+export function createForwardedExpression(compute) {
+    const value = peek(compute);
+    return isReactiveValue(value) ? value : computed(compute);
+}
+/** Creates a focused reactive child-range operation. */
+export function createDynamicChild(compute, markerId, mayReplaceSubtree = true) {
+    return createChildRangeReceipt(computed(compute), markerId, mayReplaceSubtree);
+}
+//# sourceMappingURL=reactive-expressions.js.map

package/dist/server/component/reactive-expressions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactive-expressions.js","sourceRoot":"","sources":["../../../src/component/reactive-expressions.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,QAAQ,EACR,eAAe,EACf,IAAI,EAEJ,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EACN,uBAAuB,EAEvB,MAAM,yCAAyC,CAAC;AAEjD,OAAO,EAAE,+BAA+B,EAAE,MAAM,0CAA0C,CAAC;AAE3F,0FAA0F;AAC1F,MAAM,UAAU,gBAAgB,CAAI,OAAgB;IACnD,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC1B,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,yBAAyB,CAAI,OAAgB;IAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC3D,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,kBAAkB,CACjC,OAA2B,EAC3B,QAAiB,EACjB,iBAAiB,GAAG,IAAI;IAExB,OAAO,uBAAuB,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;AAChF,CAAC"}

package/dist/server/component/reactive-value.d.ts

@@ -0,0 +1,8 @@
+import { type Reactive, type ReactiveOptions } from '@exactjs/reactive/framework/runtime';
+type GeneralReactiveFactory = (value: object, options?: ReactiveOptions) => Reactive<object>;
+/** Registers opaque reactive context values for collection-capable compiled modules. */
+export declare function registerGeneralReactiveFactory(factory: GeneralReactiveFactory): void;
+/** Preserves reactive objects while wrapping primitive context values in refs. */
+export declare function reactiveValue<T>(value: T): Reactive<T>;
+export {};
+//# sourceMappingURL=reactive-value.d.ts.map

package/dist/server/component/reactive-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactive-value.d.ts","sourceRoot":"","sources":["../../../src/component/reactive-value.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,MAAM,qCAAqC,CAAC;AAG7C,KAAK,sBAAsB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,KAAK,QAAQ,CAAC,MAAM,CAAC,CAAC;AAG7F,wFAAwF;AACxF,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAIpF;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAKtD"}

package/dist/server/component/reactive-value.js

@@ -0,0 +1,18 @@
+import { ref as reactiveRef } from '@exactjs/reactive/framework/runtime';
+import { reactiveObjects } from '@exactjs/reactive/framework/objects';
+let generalReactiveFactory;
+/** Registers opaque reactive context values for collection-capable compiled modules. */
+export function registerGeneralReactiveFactory(factory) {
+    if (generalReactiveFactory && generalReactiveFactory !== factory)
+        throw new Error('Conflicting eXact general-reactive capability integration');
+    generalReactiveFactory = factory;
+}
+/** Preserves reactive objects while wrapping primitive context values in refs. */
+export function reactiveValue(value) {
+    if (reactiveRef(value))
+        return value;
+    if (value && typeof value === 'object')
+        return (generalReactiveFactory ?? reactiveObjects)(value);
+    return value;
+}
+//# sourceMappingURL=reactive-value.js.map

package/dist/server/component/reactive-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactive-value.js","sourceRoot":"","sources":["../../../src/component/reactive-value.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,GAAG,IAAI,WAAW,EAGlB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAGtE,IAAI,sBAA0D,CAAC;AAE/D,wFAAwF;AACxF,MAAM,UAAU,8BAA8B,CAAC,OAA+B;IAC7E,IAAI,sBAAsB,IAAI,sBAAsB,KAAK,OAAO;QAC/D,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC9E,sBAAsB,GAAG,OAAO,CAAC;AAClC,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,aAAa,CAAI,KAAQ;IACxC,IAAI,WAAW,CAAC,KAAK,CAAC;QAAE,OAAO,KAAoB,CAAC;IACpD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QACrC,OAAO,CAAC,sBAAsB,IAAI,eAAe,CAAC,CAAC,KAAe,CAAgB,CAAC;IACpF,OAAO,KAAoB,CAAC;AAC7B,CAAC"}

package/dist/server/component/readiness.d.ts

@@ -0,0 +1,35 @@
+import type { AnyComponentInstance, ReadinessContextValue } from './contracts.js';
+/** Coordinates blocking work for one current boundary candidate. */
+export type ReadinessCoordinator = {
+    readonly context: ReadinessContextValue;
+    readonly generation: number;
+    readonly pending: number;
+    beginGeneration(): number;
+    whenReady(): Promise<{
+        readonly generation: number;
+        readonly retry: boolean;
+    }>;
+    commitGeneration(): void;
+    dispose(): void;
+};
+/** Controls how a readiness coordinator publishes settled candidate work. */
+export type ReadinessCoordinatorOptions = {
+    /**
+     * Publishes each settled registration immediately.
+     *
+     * Async SSR uses this mode because its candidate state is isolated and must settle before HTML
+     * is emitted. Connected DOM boundaries leave this disabled and publish the whole generation
+     * atomically during commit.
+     */
+    readonly commitSettled?: boolean;
+};
+/**
+ * Creates a generation-fenced readiness coordinator.
+ *
+ * Registrations observe settlement but never own or cancel the underlying task. Beginning a new
+ * generation invalidates prior tokens, preventing stale promise settlement from revealing it.
+ */
+export declare function createReadinessCoordinator(onPendingChange: (pending: number, generation: number, retry: boolean) => void, options?: ReadinessCoordinatorOptions): ReadinessCoordinator;
+/** Resolves the nearest readiness context inherited by a component instance. */
+export declare function componentReadinessContext(instance: AnyComponentInstance | undefined): ReadinessContextValue | undefined;
+//# sourceMappingURL=readiness.d.ts.map

package/dist/server/component/readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.d.ts","sourceRoot":"","sources":["../../../src/component/readiness.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,oBAAoB,EAEpB,qBAAqB,EAErB,MAAM,gBAAgB,CAAC;AAExB,oEAAoE;AACpE,MAAM,MAAM,oBAAoB,GAAG;IAClC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,eAAe,IAAI,MAAM,CAAC;IAC1B,SAAS,IAAI,OAAO,CAAC;QAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC/E,gBAAgB,IAAI,IAAI,CAAC;IACzB,OAAO,IAAI,IAAI,CAAC;CAChB,CAAC;AAEF,6EAA6E;AAC7E,MAAM,MAAM,2BAA2B,GAAG;IACzC;;;;;;OAMG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACzC,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,EAC9E,OAAO,GAAE,2BAAgC,GACvC,oBAAoB,CAsGtB;AAED,gFAAgF;AAChF,wBAAgB,yBAAyB,CACxC,QAAQ,EAAE,oBAAoB,GAAG,SAAS,GACxC,qBAAqB,GAAG,SAAS,CAMnC"}