@exactjs/core 0.5.0

package/dist/component/errors.js

@@ -0,0 +1,126 @@
+import { ErrorContext, SuspensionContext } from './contexts.js';
+import { batch, unwrap } from '@exactjs/reactive/framework/runtime';
+import { reactiveObjects } from '@exactjs/reactive/framework/objects';
+import { componentLogMethod, componentLogScope, isErrorReport, logFrameworkEvent } from './log.js';
+import { createDefaultErrorView } from './error-view.js';
+let nextErrorId = 1;
+/** Creates the default reactive error context used by app and framework error boundaries. */
+export function createErrorContext(errors = []) {
+    return createErrorContextWithLimit(errors);
+}
+function createErrorContextWithLimit(errors, maxReports) {
+    const reactiveErrors = reactiveObjects(errors);
+    return {
+        errors: reactiveErrors,
+        report(error, options) {
+            const report = isErrorReport(error) ? error : createErrorReportFromOptions(error, options);
+            batch(() => {
+                reactiveErrors.push(report);
+                if (maxReports !== undefined && reactiveErrors.length > maxReports)
+                    reactiveErrors.splice(0, reactiveErrors.length - maxReports);
+            });
+            return report;
+        },
+        clear(error) {
+            const id = typeof error === 'string' ? error : error.id;
+            const index = reactiveErrors.findIndex((item) => item.id === id);
+            if (index >= 0)
+                reactiveErrors.splice(index, 1);
+        },
+        clearAll() {
+            reactiveErrors.splice(0, reactiveErrors.length);
+        }
+    };
+}
+/** Creates a structured error report for component or framework failures. */
+export function createErrorReport(error, source, component, phase) {
+    return {
+        id: `e${nextErrorId++}`,
+        error,
+        source,
+        component: component ? componentLogScope(component).component : undefined,
+        phase
+    };
+}
+function createErrorReportFromOptions(error, options = {}) {
+    return {
+        id: `e${nextErrorId++}`,
+        error,
+        source: options.source ?? 'component',
+        component: options.component,
+        phase: options.phase
+    };
+}
+/** Routes a component error to the nearest error context or installs the default fallback view. */
+export function handleComponentError(instance, event, errorOwner = instance) {
+    let cursor = instance;
+    while (cursor) {
+        if (cursor.contexts.has(ErrorContext.id)) {
+            const context = unwrap(cursor.contexts.get(ErrorContext.id));
+            if (context.boundary === errorOwner) {
+                cursor = cursor.parent;
+                continue;
+            }
+            context.report(event);
+            (context.boundary ?? cursor).invalidate?.();
+            return undefined;
+        }
+        cursor = cursor.parent;
+    }
+    const ambient = instance?.ambientContexts?.get(ErrorContext.id);
+    if (ambient) {
+        const context = unwrap(ambient);
+        if (context.boundary !== errorOwner) {
+            context.report(event);
+            if (instance)
+                componentLogMethod(instance, 'error')?.(() => [
+                    'root error context handled failure',
+                    event.error,
+                    { source: event.source, phase: event.phase, component: event.component }
+                ]);
+            return undefined;
+        }
+    }
+    const context = defaultErrorContext;
+    context.report(event);
+    const fallback = () => createDefaultErrorView(context.errors);
+    if (instance) {
+        instance.errorFallback = fallback;
+        instance.invalidate?.();
+        componentLogMethod(instance, 'error')?.(() => [
+            'root error context handled failure',
+            event.error,
+            {
+                source: event.source,
+                phase: event.phase,
+                component: event.component
+            }
+        ]);
+    }
+    else {
+        logFrameworkEvent('error', 'core', event.source, 'root error context handled failure', {
+            phase: event.phase,
+            component: event.component
+        });
+    }
+    return fallback;
+}
+/** Routes a thrown promise to the nearest async rendering boundary. */
+export function handleComponentSuspension(instance, promise) {
+    return registerComponentSuspension(instance, promise) !== false;
+}
+/** Registers a thrown promise and exposes renderer-owned cancellation when the boundary supports it. */
+export function registerComponentSuspension(instance, promise) {
+    let cursor = instance;
+    while (cursor) {
+        if (cursor.contexts.has(SuspensionContext.id)) {
+            const context = unwrap(cursor.contexts.get(SuspensionContext.id));
+            return context.suspend(promise) ?? true;
+        }
+        cursor = cursor.parent;
+    }
+    return false;
+}
+/** Provides the canonical default error context value. */
+export const defaultErrorContext = /* @__PURE__ */ createErrorContextWithLimit([], 100);
+//# sourceMappingURL=errors.js.map

package/dist/component/errors.js.map

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

package/dist/component/input-observation.d.ts

@@ -0,0 +1,12 @@
+import { type EffectScope } from '@exactjs/reactive/framework/runtime';
+import type { ExactCompiledComponentInputUpdateContract } from '../component-definition-contracts.js';
+/**
+ * Observes a retained parent expression for a compact input plan. Finalized primitive inputs keep
+ * the allocation-free receive path. The component scope owns observation through replacements and
+ * disposal; the first read arms dependencies without replaying setup over resumed state.
+ */
+export declare function observeRetainedComponentInput(instance: Readonly<{
+    state: object;
+    props: object;
+}>, plan: ExactCompiledComponentInputUpdateContract, binding: readonly [slot: number, dirtyLow: number, dirtyHigh: number], scope: EffectScope): boolean;
+//# sourceMappingURL=input-observation.d.ts.map

package/dist/component/input-observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-observation.d.ts","sourceRoot":"","sources":["../../src/component/input-observation.ts"],"names":[],"mappings":"AAAA,OAAO,EAON,KAAK,WAAW,EAChB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,yCAAyC,EAAE,MAAM,sCAAsC,CAAC;AAEtG;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC5C,QAAQ,EAAE,QAAQ,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EACpD,IAAI,EAAE,yCAAyC,EAC/C,OAAO,EAAE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EACrE,KAAK,EAAE,WAAW,GAChB,OAAO,CAeT"}

package/dist/component/input-observation.js

@@ -0,0 +1,23 @@
+import { isReactiveValue, peek, readIndexedReactiveSlot, readIndexedReactiveSource, watch, withEffectScope } from '@exactjs/reactive/framework/runtime';
+/**
+ * Observes a retained parent expression for a compact input plan. Finalized primitive inputs keep
+ * the allocation-free receive path. The component scope owns observation through replacements and
+ * disposal; the first read arms dependencies without replaying setup over resumed state.
+ */
+export function observeRetainedComponentInput(instance, plan, binding, scope) {
+    const source = readIndexedReactiveSource(instance.props, binding[0]);
+    if (!source.present || !isReactiveValue(source.value))
+        return false;
+    let initialized = false;
+    let previous;
+    withEffectScope(scope, () => watch(() => {
+        const value = readIndexedReactiveSlot(instance.props, binding[0]);
+        const changed = initialized && !Object.is(previous, value);
+        previous = value;
+        initialized = true;
+        if (changed)
+            peek(() => plan.apply(instance, binding[1], binding[2]));
+    }));
+    return true;
+}
+//# sourceMappingURL=input-observation.js.map

package/dist/component/input-observation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-observation.js","sourceRoot":"","sources":["../../src/component/input-observation.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,eAAe,EACf,IAAI,EACJ,uBAAuB,EACvB,yBAAyB,EACzB,KAAK,EACL,eAAe,EAEf,MAAM,qCAAqC,CAAC;AAG7C;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAC5C,QAAoD,EACpD,IAA+C,EAC/C,OAAqE,EACrE,KAAkB;IAElB,MAAM,MAAM,GAAG,yBAAyB,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACpE,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,QAAiB,CAAC;IACtB,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,CAC3B,KAAK,CAAC,GAAG,EAAE;QACV,MAAM,KAAK,GAAG,uBAAuB,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,WAAW,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC3D,QAAQ,GAAG,KAAK,CAAC;QACjB,WAAW,GAAG,IAAI,CAAC;QACnB,IAAI,OAAO;YAAE,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC,CAAC,CACF,CAAC;IACF,OAAO,IAAI,CAAC;AACb,CAAC"}

package/dist/component/inspection-source.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Attaches compiler-owned source identity to a runtime callback without exposing the callback.
+ *
+ * This helper is emitted only by inspection-instrumented builds. The WeakMap does not alter the
+ * callback, invoke user code, or retain a callback after its owning registration is collected.
+ */
+export declare function markExactInspectionSource<Callback extends CallableFunction>(sourceEntityId: string, callback: Callback): Callback;
+/** Reads compiler-owned source identity while a component resource is registered. */
+export declare function readExactInspectionSource(callback: CallableFunction): string | undefined;
+//# sourceMappingURL=inspection-source.d.ts.map

package/dist/component/inspection-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspection-source.d.ts","sourceRoot":"","sources":["../../src/component/inspection-source.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,SAAS,gBAAgB,EAC1E,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,QAAQ,GAChB,QAAQ,CAGV;AAED,qFAAqF;AACrF,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAExF"}

package/dist/component/inspection-source.js

@@ -0,0 +1,17 @@
+const exactInspectionSources = new WeakMap();
+/**
+ * Attaches compiler-owned source identity to a runtime callback without exposing the callback.
+ *
+ * This helper is emitted only by inspection-instrumented builds. The WeakMap does not alter the
+ * callback, invoke user code, or retain a callback after its owning registration is collected.
+ */
+export function markExactInspectionSource(sourceEntityId, callback) {
+    if (sourceEntityId)
+        exactInspectionSources.set(callback, sourceEntityId);
+    return callback;
+}
+/** Reads compiler-owned source identity while a component resource is registered. */
+export function readExactInspectionSource(callback) {
+    return exactInspectionSources.get(callback);
+}
+//# sourceMappingURL=inspection-source.js.map

package/dist/component/inspection-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspection-source.js","sourceRoot":"","sources":["../../src/component/inspection-source.ts"],"names":[],"mappings":"AAAA,MAAM,sBAAsB,GAAG,IAAI,OAAO,EAA4B,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CACxC,cAAsB,EACtB,QAAkB;IAElB,IAAI,cAAc;QAAE,sBAAsB,CAAC,GAAG,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IACzE,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,yBAAyB,CAAC,QAA0B;IACnE,OAAO,sBAAsB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC7C,CAAC"}

package/dist/component/inspection.d.ts

@@ -0,0 +1,60 @@
+import { previewExactValue, type ExactContextPreview, type ExactInspectedRuntimeComponent, type ExactInspectionRuntimeId, type ExactRuntimeInspectionEventKind, type ExactRuntimeInspectionSink, type ExactValueRedactor } from '@exactjs/devtools-protocol';
+import type { AnyComponentInstance } from './contracts.js';
+/** Runtime fields fixed for one build and component-domain owner. */
+export type ExactRuntimeInspectionOwnerOptions = Readonly<{
+    buildKey: string;
+    executionRoot: string;
+    binding?: string;
+    side?: 'client' | 'server';
+    redact?: ExactValueRedactor;
+    /** Maximum task executions retained while an inspection session is attached. */
+    maxTaskExecutions?: number;
+}>;
+/** Input published by runtime packages before the owner adds sequence/session identity. */
+export type ExactRuntimeInspectionEventInput = Readonly<{
+    kind: ExactRuntimeInspectionEventKind;
+    component: AnyComponentInstance;
+    sourceEntityId?: string;
+    operationId?: string;
+    generation?: number;
+    requestId?: string;
+    interactionId?: string;
+    path?: string;
+    reason?: string;
+    attributes?: Readonly<Record<string, string | number | boolean | null>>;
+}>;
+/**
+ * Explicit, attachable owner for one instrumented component domain.
+ *
+ * It retains no history before attachment. Detaching drops the sink immediately and does not
+ * affect component scheduling, ownership, lifecycle, or error propagation.
+ */
+export interface ExactRuntimeInspectionOwner {
+    readonly buildKey: string;
+    readonly executionRoot: string;
+    readonly binding?: string;
+    readonly side: 'client' | 'server';
+    readonly attached: boolean;
+    attach(sessionId: string, sink: ExactRuntimeInspectionSink): void;
+    detach(sessionId?: string): void;
+    publish(input: ExactRuntimeInspectionEventInput): void;
+    identity(component: AnyComponentInstance, details?: Readonly<{
+        sourceEntityId?: string;
+        operationId?: string;
+        generation?: number;
+    }>): ExactInspectionRuntimeId | undefined;
+    preview(value: unknown, path?: readonly string[]): ReturnType<typeof previewExactValue>;
+}
+/** Creates a domain-scoped observation owner without installing process-global state. */
+export declare function createExactRuntimeInspectionOwner(options: ExactRuntimeInspectionOwnerOptions): ExactRuntimeInspectionOwner;
+/** Projects one component without exposing callbacks, controllers, scopes, or raw instances. */
+export declare function inspectExactRuntimeComponent(component: AnyComponentInstance, options?: Readonly<{
+    status?: ExactInspectedRuntimeComponent['status'];
+    parent?: ExactInspectionRuntimeId;
+    contexts?: readonly ExactContextPreview[];
+    ownedElements?: number;
+    activity?: ExactInspectedRuntimeComponent['activity'];
+    suspense?: ExactInspectedRuntimeComponent['suspense'];
+    targetContributions?: ExactInspectedRuntimeComponent['targetContributions'];
+}>): ExactInspectedRuntimeComponent | undefined;
+//# sourceMappingURL=inspection.d.ts.map

package/dist/component/inspection.d.ts.map

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

package/dist/component/inspection.js

@@ -0,0 +1,178 @@
+import { EXACT_DEVTOOLS_PROTOCOL_VERSION, previewExactValue } from '@exactjs/devtools-protocol';
+import { exactComponentIdentity, isExactComponent } from '../component-contracts.js';
+import { activateTaskFrameInspection, inspectTaskFrameSnapshotsForHost } from '../tasks/frame-inspection.js';
+import { componentDomainInspection } from './domain.js';
+import { inspectRetainedTaskExecutions, registerTaskInspectionHistory, releaseTaskInspectionHistory, TaskInspectionHistory } from './task-inspection-history.js';
+/** Creates a domain-scoped observation owner without installing process-global state. */
+export function createExactRuntimeInspectionOwner(options) {
+    // Task-frame projection is intentionally installed here, rather than at module evaluation, so
+    // an inspection-free artifact can tree-shake snapshot/history code from its execution hot path.
+    activateTaskFrameInspection();
+    let sessionId;
+    let sink;
+    let sequence = 0;
+    let taskHistory;
+    const owner = {
+        buildKey: options.buildKey,
+        executionRoot: options.executionRoot,
+        binding: options.binding,
+        side: options.side ?? 'client',
+        get attached() {
+            return !!sink;
+        },
+        attach(nextSessionId, nextSink) {
+            if (!nextSessionId)
+                throw new TypeError('Inspection session ID must not be empty');
+            taskHistory?.clear();
+            taskHistory = new TaskInspectionHistory(options.maxTaskExecutions);
+            registerTaskInspectionHistory(owner, taskHistory);
+            sessionId = nextSessionId;
+            sink = nextSink;
+            sequence = 0;
+        },
+        detach(expectedSessionId) {
+            if (expectedSessionId && expectedSessionId !== sessionId)
+                return;
+            sessionId = undefined;
+            sink = undefined;
+            sequence = 0;
+            taskHistory?.clear();
+            taskHistory = undefined;
+            releaseTaskInspectionHistory(owner);
+        },
+        publish(input) {
+            if (!sessionId || !sink)
+                return;
+            const id = owner.identity(input.component, input);
+            if (!id)
+                return;
+            const current = ++sequence;
+            try {
+                sink.publish(Object.freeze({
+                    protocol: EXACT_DEVTOOLS_PROTOCOL_VERSION,
+                    cursor: current.toString(36),
+                    sequence: current,
+                    timestamp: monotonicTimestamp(),
+                    wallTime: Date.now(),
+                    kind: input.kind,
+                    id,
+                    ...(input.requestId ? { requestId: input.requestId } : {}),
+                    ...(input.interactionId ? { interactionId: input.interactionId } : {}),
+                    ...(input.path ? { path: input.path } : {}),
+                    ...(input.reason ? { reason: input.reason } : {}),
+                    ...(input.attributes ? { attributes: Object.freeze({ ...input.attributes }) } : {})
+                }));
+            }
+            catch {
+                // Inspection is observational and cannot participate in application errors.
+            }
+            if (input.kind === 'component.unmount')
+                taskHistory?.deleteComponent(input.component);
+        },
+        identity(component, details = {}) {
+            if (!sessionId)
+                return undefined;
+            const authoredTypeName = component.type.name || 'anonymous-component';
+            return Object.freeze({
+                sessionId,
+                side: owner.side,
+                ...(owner.binding ? { binding: owner.binding } : {}),
+                buildKey: owner.buildKey,
+                executionRoot: owner.executionRoot,
+                componentTypeId: isExactComponent(component.type)
+                    ? exactComponentIdentity(component.type)
+                    : authoredTypeName,
+                instanceId: component.id,
+                ...(details.sourceEntityId ? { sourceEntityId: details.sourceEntityId } : {}),
+                ...(details.operationId ? { operationId: details.operationId } : {}),
+                ...(details.generation === undefined ? {} : { generation: details.generation })
+            });
+        },
+        preview(value, path = []) {
+            return previewExactValue(value, { redact: options.redact, path });
+        }
+    };
+    return Object.freeze(owner);
+}
+/** Projects one component without exposing callbacks, controllers, scopes, or raw instances. */
+export function inspectExactRuntimeComponent(component, options = {}) {
+    const owner = componentDomainInspection(component.domain);
+    const id = owner?.identity(component);
+    if (!owner || !id)
+        return undefined;
+    return Object.freeze({
+        id,
+        ...(options.parent ? { parent: options.parent } : {}),
+        name: component.type.name || 'Anonymous',
+        status: options.status ?? (component.mounted ? 'mounted' : 'constructing'),
+        props: owner.preview(component.props, ['props']),
+        state: owner.preview(component.state, ['state']),
+        contexts: Object.freeze([...(options.contexts ?? inspectContexts(component, owner))]),
+        tasks: mergeTaskSnapshots(inspectRetainedTaskExecutions(owner, component), inspectTaskFrameSnapshotsForHost(component, owner)),
+        ...(options.activity ? { activity: options.activity } : {}),
+        ...(options.suspense ? { suspense: options.suspense } : {}),
+        ...(options.targetContributions?.length
+            ? { targetContributions: Object.freeze([...options.targetContributions]) }
+            : {}),
+        ownedElements: options.ownedElements ?? 0
+    });
+}
+function mergeTaskSnapshots(history, active) {
+    if (!active.length)
+        return history;
+    const activeKeys = new Set(active.map(taskSnapshotKey));
+    return Object.freeze([
+        ...active,
+        ...history.filter((task) => !activeKeys.has(taskSnapshotKey(task)))
+    ]);
+}
+function taskSnapshotKey(task) {
+    return `${task.id.sourceEntityId ?? ''}\u0000${task.generation}`;
+}
+function inspectContexts(component, owner) {
+    const contexts = [];
+    for (const token of component.contextTokens.values()) {
+        if (token.keep === 'secret') {
+            contexts.push(Object.freeze({
+                name: token.description,
+                scope: token.scope,
+                availability: 'secret',
+                secretName: token.description
+            }));
+            continue;
+        }
+        if (token.keep === 'server') {
+            contexts.push(Object.freeze({
+                name: token.description,
+                scope: token.scope,
+                availability: 'resource',
+                type: 'server-resource'
+            }));
+            continue;
+        }
+        const value = resolveInspectedContext(component, token.id);
+        contexts.push(Object.freeze({
+            name: token.description,
+            scope: token.scope,
+            availability: value.found ? 'value' : 'unavailable',
+            ...(value.found
+                ? { value: owner.preview(value.value, ['context', token.description]) }
+                : {})
+        }));
+    }
+    return contexts;
+}
+function resolveInspectedContext(component, token) {
+    if (component.contexts.has(token))
+        return Object.freeze({ found: true, value: component.contexts.get(token) });
+    for (let cursor = component.parent; cursor; cursor = cursor.parent)
+        if (cursor.contexts.has(token))
+            return Object.freeze({ found: true, value: cursor.contexts.get(token) });
+    if (component.ambientContexts?.has(token))
+        return Object.freeze({ found: true, value: component.ambientContexts.get(token) });
+    return Object.freeze({ found: false });
+}
+function monotonicTimestamp() {
+    return globalThis.performance?.now() ?? Date.now();
+}
+//# sourceMappingURL=inspection.js.map

package/dist/component/inspection.js.map

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

package/dist/component/instance-construction.d.ts

@@ -0,0 +1,8 @@
+import type { ExactExecutableComponentContract } from '../component-contracts.js';
+import type { PreparedComponentExecution } from '../tasks/component-execution-plan.js';
+import type { AnyComponentInstance, AnyComponentFunction, ComponentContextValues, ComponentDomain } from './contracts.js';
+/** Compiler-linked constructor signature shared by every component storage lane. */
+export type CompiledComponentInstanceConstructor = (this: Readonly<{
+    instantiate: AnyComponentFunction;
+}>, parent: AnyComponentInstance | undefined, rawProps: Record<string, unknown>, ambientContexts: ComponentContextValues | undefined, domain: ComponentDomain, execution: PreparedComponentExecution | undefined, contract: ExactExecutableComponentContract) => AnyComponentInstance;
+//# sourceMappingURL=instance-construction.d.ts.map

package/dist/component/instance-construction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-construction.d.ts","sourceRoot":"","sources":["../../src/component/instance-construction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,KAAK,EACX,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,MAAM,gBAAgB,CAAC;AAExB,oFAAoF;AACpF,MAAM,MAAM,oCAAoC,GAAG,CAClD,IAAI,EAAE,QAAQ,CAAC;IAAE,WAAW,EAAE,oBAAoB,CAAA;CAAE,CAAC,EACrD,MAAM,EAAE,oBAAoB,GAAG,SAAS,EACxC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,eAAe,EAAE,sBAAsB,GAAG,SAAS,EACnD,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,0BAA0B,GAAG,SAAS,EACjD,QAAQ,EAAE,gCAAgC,KACtC,oBAAoB,CAAC"}

package/dist/component/instance-construction.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=instance-construction.js.map

package/dist/component/instance-construction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-construction.js","sourceRoot":"","sources":["../../src/component/instance-construction.ts"],"names":[],"mappings":""}

package/dist/component/instance-identity.d.ts

@@ -0,0 +1,3 @@
+/** Allocates the process-local diagnostic identity shared by every client instance storage lane. */
+export declare function allocateComponentInstanceId(): string;
+//# sourceMappingURL=instance-identity.d.ts.map

package/dist/component/instance-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-identity.d.ts","sourceRoot":"","sources":["../../src/component/instance-identity.ts"],"names":[],"mappings":"AAEA,oGAAoG;AACpG,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD"}

package/dist/component/instance-identity.js

@@ -0,0 +1,6 @@
+let nextComponentId = 1;
+/** Allocates the process-local diagnostic identity shared by every client instance storage lane. */
+export function allocateComponentInstanceId() {
+    return `c${nextComponentId++}`;
+}
+//# sourceMappingURL=instance-identity.js.map

package/dist/component/instance-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-identity.js","sourceRoot":"","sources":["../../src/component/instance-identity.ts"],"names":[],"mappings":"AAAA,IAAI,eAAe,GAAG,CAAC,CAAC;AAExB,oGAAoG;AACpG,MAAM,UAAU,2BAA2B;IAC1C,OAAO,IAAI,eAAe,EAAE,EAAE,CAAC;AAChC,CAAC"}

package/dist/component/interaction-contracts.d.ts

@@ -0,0 +1,13 @@
+/** Compiler-recognized brand for callbacks that begin framework interaction scopes. */
+export declare const interactionHandler: unique symbol;
+/** Marks a callback position as an interaction source without changing ordinary call semantics. */
+export type InteractionHandler<Args extends readonly unknown[]> = InteractionCallable<Args> & {
+    readonly [interactionHandler]?: true;
+};
+/**
+ * Expands common callback arities explicitly because the native checker contextualizes a generic
+ * rest tuple as one tuple parameter.
+ */
+type InteractionCallable<Args extends readonly unknown[]> = Args extends readonly [] ? () => unknown : Args extends readonly [infer First] ? (first: First) => unknown : Args extends readonly [infer First, infer Second] ? (first: First, second: Second) => unknown : Args extends readonly [infer First, infer Second, infer Third] ? (first: First, second: Second, third: Third) => unknown : Args extends readonly [infer First, infer Second, infer Third, infer Fourth] ? (first: First, second: Second, third: Third, fourth: Fourth) => unknown : (...args: Args) => unknown;
+export {};
+//# sourceMappingURL=interaction-contracts.d.ts.map

package/dist/component/interaction-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-contracts.d.ts","sourceRoot":"","sources":["../../src/component/interaction-contracts.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,eAAO,MAAM,kBAAkB,EAAE,OAAO,MAA4C,CAAC;AAErF,mGAAmG;AACnG,MAAM,MAAM,kBAAkB,CAAC,IAAI,SAAS,SAAS,OAAO,EAAE,IAAI,mBAAmB,CAAC,IAAI,CAAC,GAAG;IAC7F,QAAQ,CAAC,CAAC,kBAAkB,CAAC,CAAC,EAAE,IAAI,CAAC;CACrC,CAAC;AAEF;;;GAGG;AACH,KAAK,mBAAmB,CAAC,IAAI,SAAS,SAAS,OAAO,EAAE,IAAI,IAAI,SAAS,SAAS,EAAE,GACjF,MAAM,OAAO,GACb,IAAI,SAAS,SAAS,CAAC,MAAM,KAAK,CAAC,GAClC,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,GACzB,IAAI,SAAS,SAAS,CAAC,MAAM,KAAK,EAAE,MAAM,MAAM,CAAC,GAChD,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,GACzC,IAAI,SAAS,SAAS,CAAC,MAAM,KAAK,EAAE,MAAM,MAAM,EAAE,MAAM,KAAK,CAAC,GAC7D,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,OAAO,GACvD,IAAI,SAAS,SAAS,CAAC,MAAM,KAAK,EAAE,MAAM,MAAM,EAAE,MAAM,KAAK,EAAE,MAAM,MAAM,CAAC,GAC3E,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,GACvE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC"}

package/dist/component/interaction-contracts.js

@@ -0,0 +1,3 @@
+/** Compiler-recognized brand for callbacks that begin framework interaction scopes. */
+export const interactionHandler = Symbol('exact.interaction-handler');
+//# sourceMappingURL=interaction-contracts.js.map

package/dist/component/interaction-contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-contracts.js","sourceRoot":"","sources":["../../src/component/interaction-contracts.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,MAAM,CAAC,MAAM,kBAAkB,GAAkB,MAAM,CAAC,2BAA2B,CAAC,CAAC"}

package/dist/component/lifecycle-handlers.d.ts

@@ -0,0 +1,25 @@
+import type { AnyComponentInstance, LifecycleHandler, RenderEventHandler } from './contracts.js';
+type LifecycleRegistrations = {
+    mount?: LifecycleHandler[];
+    activate?: LifecycleHandler[];
+    deactivate?: LifecycleHandler[];
+    unmount?: LifecycleHandler[];
+    render?: RenderEventHandler[];
+};
+type LifecyclePhase = Exclude<keyof LifecycleRegistrations, 'render'>;
+/** Returns a mutable lifecycle phase list for internal compatibility and authored registration. */
+export declare function mutableComponentLifecycleHandlers(instance: AnyComponentInstance, phase: LifecyclePhase): LifecycleHandler[];
+/** Registers one lifecycle callback through the renderer/compiler kernel contract. */
+export declare function registerComponentLifecycleHandler(instance: AnyComponentInstance, phase: LifecyclePhase, handler: LifecycleHandler): void;
+/** Registers one compiler-lowered render callback without exposing a prototype method. */
+export declare function registerComponentRenderHandler(instance: AnyComponentInstance, handler: RenderEventHandler): void;
+/** Reads a lifecycle phase without allocating storage for components that do not use it. */
+export declare function componentLifecycleHandlers(instance: AnyComponentInstance, phase: LifecyclePhase): readonly LifecycleHandler[];
+/** Returns a mutable render-listener list for internal compatibility and authored registration. */
+export declare function mutableComponentRenderHandlers(instance: AnyComponentInstance): RenderEventHandler[];
+/** Reads render listeners without allocating storage for components that do not observe renders. */
+export declare function componentRenderHandlers(instance: AnyComponentInstance): readonly RenderEventHandler[];
+/** Releases handler arrays after component teardown, including when inspection retains the shell. */
+export declare function clearComponentLifecycleHandlers(instance: AnyComponentInstance): void;
+export {};
+//# sourceMappingURL=lifecycle-handlers.d.ts.map

package/dist/component/lifecycle-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-handlers.d.ts","sourceRoot":"","sources":["../../src/component/lifecycle-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEjG,KAAK,sBAAsB,GAAG;IAC7B,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC9B,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAChC,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,MAAM,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC9B,CAAC;AAEF,KAAK,cAAc,GAAG,OAAO,CAAC,MAAM,sBAAsB,EAAE,QAAQ,CAAC,CAAC;AAetE,mGAAmG;AACnG,wBAAgB,iCAAiC,CAChD,QAAQ,EAAE,oBAAoB,EAC9B,KAAK,EAAE,cAAc,GACnB,gBAAgB,EAAE,CAGpB;AAED,sFAAsF;AACtF,wBAAgB,iCAAiC,CAChD,QAAQ,EAAE,oBAAoB,EAC9B,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,gBAAgB,GACvB,IAAI,CAEN;AAED,0FAA0F;AAC1F,wBAAgB,8BAA8B,CAC7C,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,EAAE,kBAAkB,GACzB,IAAI,CAEN;AAED,4FAA4F;AAC5F,wBAAgB,0BAA0B,CACzC,QAAQ,EAAE,oBAAoB,EAC9B,KAAK,EAAE,cAAc,GACnB,SAAS,gBAAgB,EAAE,CAE7B;AAED,mGAAmG;AACnG,wBAAgB,8BAA8B,CAC7C,QAAQ,EAAE,oBAAoB,GAC5B,kBAAkB,EAAE,CAGtB;AAED,oGAAoG;AACpG,wBAAgB,uBAAuB,CACtC,QAAQ,EAAE,oBAAoB,GAC5B,SAAS,kBAAkB,EAAE,CAE/B;AAED,qGAAqG;AACrG,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAEpF"}

package/dist/component/lifecycle-handlers.js

@@ -0,0 +1,42 @@
+const registrations = new WeakMap();
+const emptyLifecycleHandlers = Object.freeze([]);
+const emptyRenderHandlers = Object.freeze([]);
+function registration(instance) {
+    let value = registrations.get(instance);
+    if (!value) {
+        value = {};
+        registrations.set(instance, value);
+    }
+    return value;
+}
+/** Returns a mutable lifecycle phase list for internal compatibility and authored registration. */
+export function mutableComponentLifecycleHandlers(instance, phase) {
+    const value = registration(instance);
+    return (value[phase] ??= []);
+}
+/** Registers one lifecycle callback through the renderer/compiler kernel contract. */
+export function registerComponentLifecycleHandler(instance, phase, handler) {
+    mutableComponentLifecycleHandlers(instance, phase).push(handler);
+}
+/** Registers one compiler-lowered render callback without exposing a prototype method. */
+export function registerComponentRenderHandler(instance, handler) {
+    mutableComponentRenderHandlers(instance).push(handler);
+}
+/** Reads a lifecycle phase without allocating storage for components that do not use it. */
+export function componentLifecycleHandlers(instance, phase) {
+    return registrations.get(instance)?.[phase] ?? emptyLifecycleHandlers;
+}
+/** Returns a mutable render-listener list for internal compatibility and authored registration. */
+export function mutableComponentRenderHandlers(instance) {
+    const value = registration(instance);
+    return (value.render ??= []);
+}
+/** Reads render listeners without allocating storage for components that do not observe renders. */
+export function componentRenderHandlers(instance) {
+    return registrations.get(instance)?.render ?? emptyRenderHandlers;
+}
+/** Releases handler arrays after component teardown, including when inspection retains the shell. */
+export function clearComponentLifecycleHandlers(instance) {
+    registrations.delete(instance);
+}
+//# sourceMappingURL=lifecycle-handlers.js.map