@exactjs/core 0.5.0

package/dist/component/render.js

@@ -0,0 +1,81 @@
+import { watch, withEffectScope } from '@exactjs/reactive/framework/runtime';
+import { isPromiseLike } from './async-value.js';
+import { observeLifecyclePromise } from './async.js';
+import { createErrorReport, handleComponentError, handleComponentSuspension } from './errors.js';
+import { normalizeRenderResult } from '../render-children.js';
+import { componentDomainInspection, withComponentDomain } from './domain.js';
+import { componentRenderHandlers } from './lifecycle-handlers.js';
+import { compiledComponentLifecycleABI, compiledComponentRangeOutputABI, compiledComponentRenderABI } from './compiled-abi.js';
+/** Renders once for a compiler-owned program or retains the general watched fallback. */
+export function renderInstance(instance, onInvalidate) {
+    return normalizeRenderResult(executePreparedComponentOutput(instance, onInvalidate));
+}
+/** Executes one durable instance while preserving compiler-owned server output. */
+export function renderInstanceOutput(instance, onInvalidate) {
+    return executePreparedComponentOutput(instance, onInvalidate);
+}
+/** Executes already-constructed component output for a target ABI owner. */
+export function executePreparedComponentOutput(instance, onInvalidate) {
+    let output = null;
+    const start = performanceNow();
+    const observedInvalidate = () => {
+        componentDomainInspection(instance.domain)?.publish({
+            kind: 'render.invalidate',
+            component: instance
+        });
+        onInvalidate();
+    };
+    instance.invalidate = observedInvalidate;
+    instance.renderStop?.();
+    const render = () => {
+        try {
+            instance.beginRender();
+            const render = instance.errorFallback ?? instance.renderFunction;
+            output = withEffectScope(instance.scope, () => withComponentDomain(instance.domain, render));
+        }
+        catch (error) {
+            if (isPromiseLike(error) && handleComponentSuspension(instance, error)) {
+                output = null;
+                return;
+            }
+            const fallback = handleComponentError(instance, createErrorReport(error, 'render', instance));
+            if (!fallback) {
+                output = null;
+                return;
+            }
+            instance.errorFallback = fallback;
+            output = withEffectScope(instance.scope, () => withComponentDomain(instance.domain, fallback));
+        }
+        finally {
+            instance.endRender();
+        }
+    };
+    if (instance.runtimeABI & compiledComponentRangeOutputABI) {
+        instance.renderStop = watch(render, observedInvalidate, { scope: instance.scope });
+    }
+    else if (instance.runtimeABI & compiledComponentRenderABI) {
+        render();
+    }
+    else {
+        instance.renderStop = watch(render, observedInvalidate, { scope: instance.scope });
+    }
+    const duration = performanceNow() - start;
+    const handlers = instance.runtimeABI & compiledComponentLifecycleABI ? componentRenderHandlers(instance) : [];
+    for (const handler of handlers) {
+        try {
+            const result = handler({ duration });
+            if (isPromiseLike(result))
+                observeLifecyclePromise(instance, Promise.resolve(result), 'render');
+        }
+        catch (error) {
+            handleComponentError(instance, createErrorReport(error, 'lifecycle', instance, 'render'));
+        }
+    }
+    return output;
+}
+function performanceNow() {
+    return typeof globalThis.performance?.now === 'function'
+        ? globalThis.performance.now()
+        : Date.now();
+}
+//# sourceMappingURL=render.js.map

package/dist/component/render.js.map

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

package/dist/component/resource-ownership.d.ts

@@ -0,0 +1,5 @@
+/** Disposes one component-owned resource through its supported explicit lifetime protocol. */
+export declare function disposeComponentResource(resource: Disposable | AsyncDisposable | {
+    dispose(): unknown;
+}): unknown;
+//# sourceMappingURL=resource-ownership.d.ts.map

package/dist/component/resource-ownership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-ownership.d.ts","sourceRoot":"","sources":["../../src/component/resource-ownership.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,wBAAgB,wBAAwB,CACvC,QAAQ,EAAE,UAAU,GAAG,eAAe,GAAG;IAAE,OAAO,IAAI,OAAO,CAAA;CAAE,GAC7D,OAAO,CAIT"}

package/dist/component/resource-ownership.js

@@ -0,0 +1,9 @@
+/** Disposes one component-owned resource through its supported explicit lifetime protocol. */
+export function disposeComponentResource(resource) {
+    if ('dispose' in resource)
+        return resource.dispose();
+    if (Symbol.dispose in resource)
+        return resource[Symbol.dispose]();
+    return resource[Symbol.asyncDispose]();
+}
+//# sourceMappingURL=resource-ownership.js.map

package/dist/component/resource-ownership.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-ownership.js","sourceRoot":"","sources":["../../src/component/resource-ownership.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,MAAM,UAAU,wBAAwB,CACvC,QAA+D;IAE/D,IAAI,SAAS,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC,OAAO,EAAE,CAAC;IACrD,IAAI,MAAM,CAAC,OAAO,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;IAClE,OAAO,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;AACxC,CAAC"}

package/dist/component/resumption.d.ts

@@ -0,0 +1,5 @@
+import type { Reactive } from '@exactjs/reactive/framework/runtime';
+import type { ComponentResumptionSource } from './contracts.js';
+/** Applies compiler-selected SSR state paths without replacing client-local setup state. */
+export declare function applyComponentResumption(state: Reactive<Record<string, unknown>>, resumption: ComponentResumptionSource): void;
+//# sourceMappingURL=resumption.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resumption.d.ts","sourceRoot":"","sources":["../../src/component/resumption.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAIhE,4FAA4F;AAC5F,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxC,UAAU,EAAE,yBAAyB,GACnC,IAAI,CAaN"}

package/dist/component/resumption.js

@@ -0,0 +1,42 @@
+/** Applies compiler-selected SSR state paths without replacing client-local setup state. */
+export function applyComponentResumption(state, resumption) {
+    const values = 'componentId' in resumption ? resumption.values : (resumption[1] ?? []);
+    if (Array.isArray(values)) {
+        for (const [field, value] of values) {
+            if (typeof field !== 'string')
+                throw new Error(`eXact indexed resumption was not prepared for ${'componentId' in resumption ? resumption.componentId : resumption[0]}`);
+            writePath(state, field, value);
+        }
+        return;
+    }
+    for (const [path, value] of Object.entries(values))
+        writePath(state, path, value);
+}
+/** Materializes one validated dotted state path into the live reactive state object. */
+function writePath(target, path, value) {
+    const segments = path.split('.');
+    if (!segments.length || !segments.every(safeSegment)) {
+        throw new Error(`Malformed eXact component resumption state path ${path}`);
+    }
+    let cursor = target;
+    for (const segment of segments.slice(0, -1)) {
+        const current = cursor[segment];
+        if (current && typeof current === 'object' && !Array.isArray(current)) {
+            cursor = current;
+        }
+        else {
+            const created = {};
+            cursor[segment] = created;
+            cursor = created;
+        }
+    }
+    cursor[segments.at(-1)] = value;
+}
+/** Rejects prototype-bearing path segments before touching reactive state. */
+function safeSegment(segment) {
+    return (segment.length > 0 &&
+        segment !== '__proto__' &&
+        segment !== 'prototype' &&
+        segment !== 'constructor');
+}
+//# sourceMappingURL=resumption.js.map

package/dist/component/resumption.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resumption.js","sourceRoot":"","sources":["../../src/component/resumption.ts"],"names":[],"mappings":"AAKA,4FAA4F;AAC5F,MAAM,UAAU,wBAAwB,CACvC,KAAwC,EACxC,UAAqC;IAErC,MAAM,MAAM,GAAG,aAAa,IAAI,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACvF,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAsD,EAAE,CAAC;YACrF,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAC5B,MAAM,IAAI,KAAK,CACd,iDAAiD,aAAa,IAAI,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CACvH,CAAC;YACH,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;QACD,OAAO;IACR,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AACnF,CAAC;AAED,wFAAwF;AACxF,SAAS,SAAS,CAAC,MAA+B,EAAE,IAAY,EAAE,KAAc;IAC/E,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,mDAAmD,IAAI,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,MAAM,GAAG,MAAM,CAAC;IACpB,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACvE,MAAM,GAAG,OAAkC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACP,MAAM,OAAO,GAA4B,EAAE,CAAC;YAC5C,MAAM,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;YAC1B,MAAM,GAAG,OAAO,CAAC;QAClB,CAAC;IACF,CAAC;IACD,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,GAAG,KAAK,CAAC;AAClC,CAAC;AAED,8EAA8E;AAC9E,SAAS,WAAW,CAAC,OAAe;IACnC,OAAO,CACN,OAAO,CAAC,MAAM,GAAG,CAAC;QAClB,OAAO,KAAK,WAAW;QACvB,OAAO,KAAK,WAAW;QACvB,OAAO,KAAK,aAAa,CACzB,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,20 @@
+import type { AnyComponentInstance, RefBinding, RootBinding, RootLifecycle, RootIntroduction, RootRelease, StructuralReleaseReason } from './contracts.js';
+/** Returns the stable reactive intrinsic-root lifecycle for a component. */
+export declare function componentRootLifecycle<T extends object>(instance: AnyComponentInstance): RootLifecycle<T>;
+/** Selects one stable element ref as the component's explicit intrinsic root. */
+export declare function bindComponentRoot<T extends object>(instance: AnyComponentInstance, binding: RefBinding<T>): RootBinding<T>;
+/** Publishes the current renderer-discovered intrinsic root for a component. */
+export declare function publishComponentRoot(instance: AnyComponentInstance, discovered: object | undefined, presented?: boolean, introduction?: RootIntroduction): void;
+/** Publishes whether a retained component root belongs to the presented logical range. */
+export declare function publishComponentRootPresentation(instance: AnyComponentInstance, presented: boolean): void;
+/** Reports whether authored component work observes this root lifecycle. */
+export declare function componentRootReleaseObserved(instance: AnyComponentInstance): boolean;
+/** Publishes structural loss of the current root generation without discarding its target. */
+export declare function publishComponentRootRelease(instance: AnyComponentInstance, reason: StructuralReleaseReason): RootRelease<object> | undefined;
+/** Restores an exactly retained root generation after its structural release is reversed. */
+export declare function reverseComponentRootRelease(instance: AnyComponentInstance, generation: number): boolean;
+/** Clears a settled release when it still belongs to the specified root generation. */
+export declare function settleComponentRootRelease(instance: AnyComponentInstance, generation: number): void;
+/** Discards root lifecycle state after final component disposal. */
+export declare function disposeComponentRoot(instance: AnyComponentInstance): void;
+//# sourceMappingURL=root-lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"root-lifecycle.d.ts","sourceRoot":"","sources":["../../src/component/root-lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,oBAAoB,EACpB,UAAU,EACV,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,uBAAuB,EACvB,MAAM,gBAAgB,CAAC;AAmBxB,4EAA4E;AAC5E,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,EACtD,QAAQ,EAAE,oBAAoB,GAC5B,aAAa,CAAC,CAAC,CAAC,CAGlB;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EACjD,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GACpB,WAAW,CAAC,CAAC,CAAC,CAkBhB;AAED,gFAAgF;AAChF,wBAAgB,oBAAoB,CACnC,QAAQ,EAAE,oBAAoB,EAC9B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,SAAS,UAAO,EAChB,YAAY,GAAE,gBAA2B,GACvC,IAAI,CAUN;AAED,0FAA0F;AAC1F,wBAAgB,gCAAgC,CAC/C,QAAQ,EAAE,oBAAoB,EAC9B,SAAS,EAAE,OAAO,GAChB,IAAI,CAGN;AAED,4EAA4E;AAC5E,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAEpF;AAED,8FAA8F;AAC9F,wBAAgB,2BAA2B,CAC1C,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,uBAAuB,GAC7B,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAcjC;AAED,6FAA6F;AAC7F,wBAAgB,2BAA2B,CAC1C,QAAQ,EAAE,oBAAoB,EAC9B,UAAU,EAAE,MAAM,GAChB,OAAO,CAQT;AAED,uFAAuF;AACvF,wBAAgB,0BAA0B,CACzC,QAAQ,EAAE,oBAAoB,EAC9B,UAAU,EAAE,MAAM,GAChB,IAAI,CAGN;AAED,oEAAoE;AACpE,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CASzE"}

package/dist/component/root-lifecycle.js

@@ -0,0 +1,141 @@
+import { reactiveObjects } from '@exactjs/reactive/framework/objects';
+const componentRoots = new WeakMap();
+const augmentedBindings = new WeakMap();
+/** Returns the stable reactive intrinsic-root lifecycle for a component. */
+export function componentRootLifecycle(instance) {
+    const record = rootRecord(instance);
+    return observeRoot(record);
+}
+/** Selects one stable element ref as the component's explicit intrinsic root. */
+export function bindComponentRoot(instance, binding) {
+    if (binding.owner !== instance)
+        throw new Error('A component root binding must be owned by the component selecting it');
+    const record = rootRecord(instance);
+    const lifecycle = observeRoot(record);
+    if (record.explicit && record.explicit !== binding)
+        throw new Error('A component may select only one explicit root binding');
+    record.explicit = binding;
+    const existing = augmentedBindings.get(binding);
+    if (existing)
+        return existing;
+    const augmented = Object.defineProperties(binding, {
+        generation: { enumerable: true, get: () => lifecycle.generation },
+        introduction: { enumerable: true, get: () => lifecycle.introduction },
+        presented: { enumerable: true, get: () => lifecycle.presented },
+        release: { enumerable: true, get: () => lifecycle.release }
+    });
+    augmentedBindings.set(binding, augmented);
+    return augmented;
+}
+/** Publishes the current renderer-discovered intrinsic root for a component. */
+export function publishComponentRoot(instance, discovered, presented = true, introduction = 'update') {
+    const record = rootRecord(instance);
+    const selected = record.explicit?.current ?? discovered;
+    if (record.state.current !== selected) {
+        record.state.current = selected;
+        record.state.generation++;
+        record.state.introduction = selected ? introduction : undefined;
+        record.state.release = undefined;
+    }
+    record.state.presented = selected !== undefined && presented;
+}
+/** Publishes whether a retained component root belongs to the presented logical range. */
+export function publishComponentRootPresentation(instance, presented) {
+    const record = componentRoots.get(instance);
+    if (record)
+        record.state.presented = record.state.current !== undefined && presented;
+}
+/** Reports whether authored component work observes this root lifecycle. */
+export function componentRootReleaseObserved(instance) {
+    return componentRoots.get(instance)?.lifecycle !== undefined;
+}
+/** Publishes structural loss of the current root generation without discarding its target. */
+export function publishComponentRootRelease(instance, reason) {
+    const record = componentRoots.get(instance);
+    const target = record?.state.current;
+    if (!record?.lifecycle || !target)
+        return undefined;
+    const release = Object.freeze({
+        target,
+        generation: record.state.generation,
+        reason,
+        presented: record.state.presented
+    });
+    record.state.release = release;
+    record.state.current = undefined;
+    record.state.presented = false;
+    return release;
+}
+/** Restores an exactly retained root generation after its structural release is reversed. */
+export function reverseComponentRootRelease(instance, generation) {
+    const record = componentRoots.get(instance);
+    const release = record?.state.release;
+    if (!record || !release || release.generation !== generation)
+        return false;
+    record.state.current = release.target;
+    record.state.presented = release.presented;
+    record.state.release = undefined;
+    return true;
+}
+/** Clears a settled release when it still belongs to the specified root generation. */
+export function settleComponentRootRelease(instance, generation) {
+    const record = componentRoots.get(instance);
+    if (record?.state.release?.generation === generation)
+        record.state.release = undefined;
+}
+/** Discards root lifecycle state after final component disposal. */
+export function disposeComponentRoot(instance) {
+    const record = componentRoots.get(instance);
+    if (record) {
+        record.state.current = undefined;
+        record.state.introduction = undefined;
+        record.state.presented = false;
+        record.state.release = undefined;
+    }
+    componentRoots.delete(instance);
+}
+/** Retains root history on first publication, deferring reactive machinery until observation. */
+function rootRecord(instance) {
+    const existing = componentRoots.get(instance);
+    if (existing)
+        return existing;
+    const record = {
+        lifecycle: undefined,
+        state: {
+            current: undefined,
+            generation: 0,
+            introduction: undefined,
+            presented: false,
+            release: undefined
+        }
+    };
+    componentRoots.set(instance, record);
+    return record;
+}
+/** Promotes retained root history to reactive state only when an author observes the lifecycle. */
+function observeRoot(record) {
+    if (record.lifecycle)
+        return record.lifecycle;
+    // Preserve earlier renderer publications so a late observer sees the current generation.
+    const state = (record.state = reactiveObjects(record.state, {
+        passthroughKeys: ['current', 'release']
+    }));
+    return (record.lifecycle = Object.freeze({
+        get current() {
+            return state.current;
+        },
+        get generation() {
+            return state.generation;
+        },
+        get introduction() {
+            return state.introduction;
+        },
+        get presented() {
+            return state.presented;
+        },
+        get release() {
+            return state.release;
+        }
+    }));
+}
+//# sourceMappingURL=root-lifecycle.js.map

package/dist/component/root-lifecycle.js.map

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

package/dist/component/runtime-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, ComponentContextValues, ComponentFunction, ComponentInstance } from './contracts.js';
+/** Creates a native instance through mandatory artifact-owned construction wiring. */
+export declare function createComponentInstance<State extends object, Props extends Record<string, unknown>>(type: ComponentFunction<State, Props>, rawProps: Props, parent?: AnyComponentInstance, ambientContexts?: ComponentContextValues | undefined, domain?: import("./contracts.js").ComponentDomainIdentity, contract?: ExactExecutableComponentContract): ComponentInstance<State>;
+/** Creates an instance using a previously validated and indexed compiler execution plan. */
+export declare function createPreparedComponentInstance<State extends object, Props extends Record<string, unknown>>(type: ComponentFunction<State, Props>, rawProps: Props, execution: PreparedComponentExecution | undefined, parent?: AnyComponentInstance, ambientContexts?: ComponentContextValues | undefined, domain?: import("./contracts.js").ComponentDomainIdentity): ComponentInstance<State>;
+//# sourceMappingURL=runtime-construction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-construction.d.ts","sourceRoot":"","sources":["../../src/component/runtime-construction.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,gCAAgC,EAErC,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,KAAK,EACX,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,MAAM,gBAAgB,CAAC;AAGxB,sFAAsF;AACtF,wBAAgB,uBAAuB,CACtC,KAAK,SAAS,MAAM,EACpB,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAErC,IAAI,EAAE,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,EACrC,QAAQ,EAAE,KAAK,EACf,MAAM,CAAC,EAAE,oBAAoB,EAC7B,eAAe,GAAE,sBAAsB,GAAG,SAAmC,EAC7E,MAAM,mDAAwC,EAC9C,QAAQ,GAAE,gCAAqF,GAC7F,iBAAiB,CAAC,KAAK,CAAC,CAS1B;AAED,4FAA4F;AAC5F,wBAAgB,+BAA+B,CAC9C,KAAK,SAAS,MAAM,EACpB,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAErC,IAAI,EAAE,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,EACrC,QAAQ,EAAE,KAAK,EACf,SAAS,EAAE,0BAA0B,GAAG,SAAS,EACjD,MAAM,CAAC,EAAE,oBAAoB,EAC7B,eAAe,GAAE,sBAAsB,GAAG,SAAmC,EAC7E,MAAM,mDAAwC,GAC5C,iBAAiB,CAAC,KAAK,CAAC,CAU1B"}

package/dist/component/runtime-construction.js

@@ -0,0 +1,12 @@
+import { readPreparedExactExecutableComponentContract } from '../component-contracts.js';
+import { pageComponentDomain } from './domain.js';
+/** Creates a native instance through mandatory artifact-owned construction wiring. */
+export function createComponentInstance(type, rawProps, parent, ambientContexts = parent?.ambientContexts, domain = parent?.domain ?? pageComponentDomain, contract = readPreparedExactExecutableComponentContract(type)) {
+    return contract.artifact.construct(parent, rawProps, ambientContexts, domain, undefined, contract);
+}
+/** Creates an instance using a previously validated and indexed compiler execution plan. */
+export function createPreparedComponentInstance(type, rawProps, execution, parent, ambientContexts = parent?.ambientContexts, domain = parent?.domain ?? pageComponentDomain) {
+    const contract = readPreparedExactExecutableComponentContract(type);
+    return contract.artifact.construct(parent, rawProps, ambientContexts, domain, execution, contract);
+}
+//# sourceMappingURL=runtime-construction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-construction.js","sourceRoot":"","sources":["../../src/component/runtime-construction.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,4CAA4C,EAC5C,MAAM,2BAA2B,CAAC;AAQnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,sFAAsF;AACtF,MAAM,UAAU,uBAAuB,CAItC,IAAqC,EACrC,QAAe,EACf,MAA6B,EAC7B,kBAAsD,MAAM,EAAE,eAAe,EAC7E,MAAM,GAAG,MAAM,EAAE,MAAM,IAAI,mBAAmB,EAC9C,WAA6C,4CAA4C,CAAC,IAAI,CAAC;IAE/F,OAAO,QAAQ,CAAC,QAAQ,CAAC,SAAS,CACjC,MAAM,EACN,QAAQ,EACR,eAAe,EACf,MAAM,EACN,SAAS,EACT,QAAQ,CACoB,CAAC;AAC/B,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,+BAA+B,CAI9C,IAAqC,EACrC,QAAe,EACf,SAAiD,EACjD,MAA6B,EAC7B,kBAAsD,MAAM,EAAE,eAAe,EAC7E,MAAM,GAAG,MAAM,EAAE,MAAM,IAAI,mBAAmB;IAE9C,MAAM,QAAQ,GAAG,4CAA4C,CAAC,IAAI,CAAC,CAAC;IACpE,OAAO,QAAQ,CAAC,QAAQ,CAAC,SAAS,CACjC,MAAM,EACN,QAAQ,EACR,eAAe,EACf,MAAM,EACN,SAAS,EACT,QAAQ,CACoB,CAAC;AAC/B,CAAC"}

package/dist/component/runtime-surface-contexts.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime-surface-contexts.d.ts.map

package/dist/component/runtime-surface-contexts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-surface-contexts.d.ts","sourceRoot":"","sources":["../../src/component/runtime-surface-contexts.ts"],"names":[],"mappings":""}

package/dist/component/runtime-surface-contexts.js

@@ -0,0 +1,26 @@
+import { componentContextCapability } from './context-capability.js';
+import { registerComponentRuntimeSurface } from './runtime-surface-registration.js';
+function hasContext(token) {
+    this.contextTokens.set(token.id, token);
+    const capability = componentContextCapability();
+    capability.publish(this, token, 'read');
+    return capability.has(this, this.ambientContexts, token);
+}
+function getContext(token) {
+    this.contextTokens.set(token.id, token);
+    const capability = componentContextCapability();
+    capability.publish(this, token, 'read');
+    return capability.get(this, this.ambientContexts, token);
+}
+function setContext(token, value) {
+    this.contextTokens.set(token.id, token);
+    const capability = componentContextCapability();
+    capability.set(this, token, value);
+    capability.publish(this, token, 'write');
+}
+registerComponentRuntimeSurface({
+    hasContext: { configurable: true, writable: true, value: hasContext },
+    getContext: { configurable: true, writable: true, value: getContext },
+    setContext: { configurable: true, writable: true, value: setContext }
+});
+//# sourceMappingURL=runtime-surface-contexts.js.map

package/dist/component/runtime-surface-contexts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-surface-contexts.js","sourceRoot":"","sources":["../../src/component/runtime-surface-contexts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAErE,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AAEpF,SAAS,UAAU,CAA6B,KAA4B;IAC3E,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,0BAA0B,EAAE,CAAC;IAChD,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,UAAU,CAAgC,KAAsB;IACxE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,0BAA0B,EAAE,CAAC;IAChD,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,UAAU,CAAgC,KAAsB,EAAE,KAAQ;IAClF,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,0BAA0B,EAAE,CAAC;IAChD,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,+BAA+B,CAAC;IAC/B,UAAU,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE;IACrE,UAAU,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE;IACrE,UAAU,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE;CACrE,CAAC,CAAC"}

package/dist/component/runtime-surface-lifecycle.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime-surface-lifecycle.d.ts.map

package/dist/component/runtime-surface-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-surface-lifecycle.d.ts","sourceRoot":"","sources":["../../src/component/runtime-surface-lifecycle.ts"],"names":[],"mappings":""}

package/dist/component/runtime-surface-lifecycle.js

@@ -0,0 +1,61 @@
+import { mutableComponentLifecycleHandlers, mutableComponentRenderHandlers, registerComponentLifecycleHandler } from './lifecycle-handlers.js';
+import { disposeComponentResource } from './resource-ownership.js';
+import { registerComponentRuntimeSurface } from './runtime-surface-registration.js';
+function onMount(handler) {
+    registerComponentLifecycleHandler(this, 'mount', handler);
+}
+function onActivate(handler) {
+    registerComponentLifecycleHandler(this, 'activate', handler);
+}
+function onDeactivate(handler) {
+    registerComponentLifecycleHandler(this, 'deactivate', handler);
+}
+function onUnmount(handler) {
+    registerComponentLifecycleHandler(this, 'unmount', handler);
+}
+function onRender(handler) {
+    mutableComponentRenderHandlers(this).push(handler);
+}
+function own(resource) {
+    this.onUnmount(() => disposeComponentResource(resource));
+    return resource;
+}
+registerComponentRuntimeSurface({
+    mountHandlers: {
+        configurable: true,
+        get() {
+            return mutableComponentLifecycleHandlers(this, 'mount');
+        }
+    },
+    activateHandlers: {
+        configurable: true,
+        get() {
+            return mutableComponentLifecycleHandlers(this, 'activate');
+        }
+    },
+    deactivateHandlers: {
+        configurable: true,
+        get() {
+            return mutableComponentLifecycleHandlers(this, 'deactivate');
+        }
+    },
+    unmountHandlers: {
+        configurable: true,
+        get() {
+            return mutableComponentLifecycleHandlers(this, 'unmount');
+        }
+    },
+    renderHandlers: {
+        configurable: true,
+        get() {
+            return mutableComponentRenderHandlers(this);
+        }
+    },
+    onMount: { configurable: true, writable: true, value: onMount },
+    onActivate: { configurable: true, writable: true, value: onActivate },
+    onDeactivate: { configurable: true, writable: true, value: onDeactivate },
+    onUnmount: { configurable: true, writable: true, value: onUnmount },
+    onRender: { configurable: true, writable: true, value: onRender },
+    own: { configurable: true, writable: true, value: own }
+});
+//# sourceMappingURL=runtime-surface-lifecycle.js.map

package/dist/component/runtime-surface-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-surface-lifecycle.js","sourceRoot":"","sources":["../../src/component/runtime-surface-lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,EACN,iCAAiC,EACjC,8BAA8B,EAC9B,iCAAiC,EACjC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AAEpF,SAAS,OAAO,CAA6B,OAAyB;IACrE,iCAAiC,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,UAAU,CAA6B,OAAyB;IACxE,iCAAiC,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,YAAY,CAA6B,OAAyB;IAC1E,iCAAiC,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,SAAS,CAA6B,OAAyB;IACvE,iCAAiC,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,QAAQ,CAA6B,OAA2B;IACxE,8BAA8B,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,GAAG,CAEX,QAAW;IAEX,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzD,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,+BAA+B,CAAC;IAC/B,aAAa,EAAE;QACd,YAAY,EAAE,IAAI;QAClB,GAAG;YACF,OAAO,iCAAiC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACzD,CAAC;KACD;IACD,gBAAgB,EAAE;QACjB,YAAY,EAAE,IAAI;QAClB,GAAG;YACF,OAAO,iCAAiC,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC5D,CAAC;KACD;IACD,kBAAkB,EAAE;QACnB,YAAY,EAAE,IAAI;QAClB,GAAG;YACF,OAAO,iCAAiC,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAC9D,CAAC;KACD;IACD,eAAe,EAAE;QAChB,YAAY,EAAE,IAAI;QAClB,GAAG;YACF,OAAO,iCAAiC,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC3D,CAAC;KACD;IACD,cAAc,EAAE;QACf,YAAY,EAAE,IAAI;QAClB,GAAG;YACF,OAAO,8BAA8B,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC;KACD;IACD,OAAO,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE;IAC/D,UAAU,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE;IACrE,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE;IACzE,SAAS,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE;IACnE,QAAQ,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE;IACjE,GAAG,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE;CACvD,CAAC,CAAC"}

package/dist/component/runtime-surface-lists.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime-surface-lists.d.ts.map

package/dist/component/runtime-surface-lists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-surface-lists.d.ts","sourceRoot":"","sources":["../../src/component/runtime-surface-lists.ts"],"names":[],"mappings":""}

package/dist/component/runtime-surface-lists.js

@@ -0,0 +1,9 @@
+import { componentListCapability } from './list-capability.js';
+import { registerComponentRuntimeSurface } from './runtime-surface-registration.js';
+function map(collection, key, render, id, provenance, keyIdentity) {
+    return componentListCapability().map(this, collection, key, render, id, provenance, keyIdentity);
+}
+registerComponentRuntimeSurface({
+    map: { configurable: true, writable: true, value: map }
+});
+//# sourceMappingURL=runtime-surface-lists.js.map

package/dist/component/runtime-surface-lists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-surface-lists.js","sourceRoot":"","sources":["../../src/component/runtime-surface-lists.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AAEpF,SAAS,GAAG,CAEX,UAAoD,EACpD,GAAiC,EACjC,MAA0B,EAC1B,EAAW,EACX,UAAwB,EACxB,WAAoB;IAEpB,OAAO,uBAAuB,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;AAClG,CAAC;AAED,+BAA+B,CAAC;IAC/B,GAAG,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE;CACvD,CAAC,CAAC"}

package/dist/component/runtime-surface-localization.d.ts

@@ -0,0 +1,5 @@
+import type { IntlFacade } from '../localization/contracts.js';
+import { type ComponentLocalizationOwner } from './localization-capability.js';
+/** Returns the stable localized Intl facade owned by one compiled component frame. */
+export declare function componentIntl(owner: ComponentLocalizationOwner): IntlFacade;
+//# sourceMappingURL=runtime-surface-localization.d.ts.map

package/dist/component/runtime-surface-localization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-surface-localization.d.ts","sourceRoot":"","sources":["../../src/component/runtime-surface-localization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAEN,KAAK,0BAA0B,EAC/B,MAAM,8BAA8B,CAAC;AAMtC,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,KAAK,EAAE,0BAA0B,GAAG,UAAU,CAW3E"}

package/dist/component/runtime-surface-localization.js

@@ -0,0 +1,22 @@
+import { componentLocalizationCapability } from './localization-capability.js';
+import { registerComponentRuntimeSurface } from './runtime-surface-registration.js';
+const facades = new WeakMap();
+/** Returns the stable localized Intl facade owned by one compiled component frame. */
+export function componentIntl(owner) {
+    let facade = facades.get(owner);
+    if (facade)
+        return facade;
+    const capability = componentLocalizationCapability();
+    if (!capability)
+        throw new Error('Component localization is unavailable because this artifact did not include the localization capability');
+    facade = capability.create(owner);
+    facades.set(owner, facade);
+    return facade;
+}
+function intl() {
+    return componentIntl(this);
+}
+registerComponentRuntimeSurface({
+    intl: { configurable: true, get: intl }
+});
+//# sourceMappingURL=runtime-surface-localization.js.map

package/dist/component/runtime-surface-localization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-surface-localization.js","sourceRoot":"","sources":["../../src/component/runtime-surface-localization.ts"],"names":[],"mappings":"AACA,OAAO,EACN,+BAA+B,EAE/B,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AAEpF,MAAM,OAAO,GAAG,IAAI,OAAO,EAA0C,CAAC;AAEtE,sFAAsF;AACtF,MAAM,UAAU,aAAa,CAAC,KAAiC;IAC9D,IAAI,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,UAAU,GAAG,+BAA+B,EAAE,CAAC;IACrD,IAAI,CAAC,UAAU;QACd,MAAM,IAAI,KAAK,CACd,yGAAyG,CACzG,CAAC;IACH,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC3B,OAAO,MAAM,CAAC;AACf,CAAC;AAED,SAAS,IAAI;IACZ,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,+BAA+B,CAAC;IAC/B,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE;CACvC,CAAC,CAAC"}

package/dist/component/runtime-surface-logging.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime-surface-logging.d.ts.map

package/dist/component/runtime-surface-logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-surface-logging.d.ts","sourceRoot":"","sources":["../../src/component/runtime-surface-logging.ts"],"names":[],"mappings":""}

package/dist/component/runtime-surface-logging.js

@@ -0,0 +1,15 @@
+import { createComponentLog } from './log.js';
+import { registerComponentRuntimeSurface } from './runtime-surface-registration.js';
+const logs = new WeakMap();
+function log() {
+    let value = logs.get(this);
+    if (!value) {
+        value = createComponentLog(this);
+        logs.set(this, value);
+    }
+    return value;
+}
+registerComponentRuntimeSurface({
+    log: { configurable: true, get: log }
+});
+//# sourceMappingURL=runtime-surface-logging.js.map

package/dist/component/runtime-surface-logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-surface-logging.js","sourceRoot":"","sources":["../../src/component/runtime-surface-logging.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AAEpF,MAAM,IAAI,GAAG,IAAI,OAAO,EAAsC,CAAC;AAE/D,SAAS,GAAG;IACX,IAAI,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED,+BAA+B,CAAC;IAC/B,GAAG,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE;CACrC,CAAC,CAAC"}

package/dist/component/runtime-surface-reactivity.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime-surface-reactivity.d.ts.map

package/dist/component/runtime-surface-reactivity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-surface-reactivity.d.ts","sourceRoot":"","sources":["../../src/component/runtime-surface-reactivity.ts"],"names":[],"mappings":""}

package/dist/component/runtime-surface-reactivity.js

@@ -0,0 +1,9 @@
+import { createComponentReactive } from './reactive-expression.js';
+import { registerComponentRuntimeSurface } from './runtime-surface-registration.js';
+function reactive(input, ...values) {
+    return createComponentReactive(input, values);
+}
+registerComponentRuntimeSurface({
+    reactive: { configurable: true, writable: true, value: reactive }
+});
+//# sourceMappingURL=runtime-surface-reactivity.js.map

package/dist/component/runtime-surface-reactivity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-surface-reactivity.js","sourceRoot":"","sources":["../../src/component/runtime-surface-reactivity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AAEpF,SAAS,QAAQ,CAChB,KAA2C,EAC3C,GAAG,MAAiB;IAEpB,OAAO,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED,+BAA+B,CAAC;IAC/B,QAAQ,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE;CACjE,CAAC,CAAC"}

package/dist/component/runtime-surface-refs.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime-surface-refs.d.ts.map