@exactjs/core 0.5.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-handlers.js","sourceRoot":"","sources":["../../src/component/lifecycle-handlers.ts"],"names":[],"mappings":"AAYA,MAAM,aAAa,GAAG,IAAI,OAAO,EAAgD,CAAC;AAClF,MAAM,sBAAsB,GAAgC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAC9E,MAAM,mBAAmB,GAAkC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE7E,SAAS,YAAY,CAAC,QAA8B;IACnD,IAAI,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,KAAK,GAAG,EAAE,CAAC;QACX,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,iCAAiC,CAChD,QAA8B,EAC9B,KAAqB;IAErB,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACrC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,iCAAiC,CAChD,QAA8B,EAC9B,KAAqB,EACrB,OAAyB;IAEzB,iCAAiC,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAClE,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,8BAA8B,CAC7C,QAA8B,EAC9B,OAA2B;IAE3B,8BAA8B,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACxD,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,0BAA0B,CACzC,QAA8B,EAC9B,KAAqB;IAErB,OAAO,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,sBAAsB,CAAC;AACvE,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,8BAA8B,CAC7C,QAA8B;IAE9B,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACrC,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,uBAAuB,CACtC,QAA8B;IAE9B,OAAO,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,mBAAmB,CAAC;AACnE,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,+BAA+B,CAAC,QAA8B;IAC7E,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC"}

package/dist/component/list-capability-integration.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=list-capability-integration.d.ts.map

package/dist/component/list-capability-integration.d.ts.map

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

package/dist/component/list-capability-integration.js

@@ -0,0 +1,33 @@
+import { createComponentListController } from './list-controller.js';
+import { registerComponentListCapability } from './list-capability.js';
+const controllers = new WeakMap();
+function controller(owner) {
+    let value = controllers.get(owner);
+    if (!value) {
+        value = createComponentListController(owner.scope);
+        controllers.set(owner, value);
+    }
+    return value;
+}
+registerComponentListCapability(Object.freeze({
+    map(owner, collection, key, render, id, provenance, keyIdentity) {
+        return controller(owner).map(collection, key, render, id, provenance, keyIdentity);
+    },
+    mapDirect(owner, collection, key, render, id, provenance, keyIdentity) {
+        return controller(owner).map(collection, key, render, id, provenance, keyIdentity, true);
+    },
+    begin(owner) {
+        controllers.get(owner)?.beginRender();
+    },
+    end(owner) {
+        controllers.get(owner)?.endRender();
+    },
+    dispose(owner) {
+        const value = controllers.get(owner);
+        if (!value)
+            return;
+        controllers.delete(owner);
+        value.dispose();
+    }
+}));
+//# sourceMappingURL=list-capability-integration.js.map

package/dist/component/list-capability-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-capability-integration.js","sourceRoot":"","sources":["../../src/component/list-capability-integration.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAC;AAEvE,MAAM,WAAW,GAAG,IAAI,OAAO,EAA4D,CAAC;AAE5F,SAAS,UAAU,CAAC,KAAa;IAChC,IAAI,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,KAAK,GAAG,6BAA6B,CAAE,KAA8B,CAAC,KAAK,CAAC,CAAC;QAC7E,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED,+BAA+B,CAC9B,MAAM,CAAC,MAAM,CAAC;IACb,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,WAAW;QAC9D,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IACpF,CAAC;IACD,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,WAAW;QACpE,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,GAAG,CAC3B,UAAU,EACV,GAAG,EACH,MAAM,EACN,EAAE,EACF,UAAU,EACV,WAAW,EACX,IAAI,CACgC,CAAC;IACvC,CAAC;IACD,KAAK,CAAC,KAAK;QACV,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACvC,CAAC;IACD,GAAG,CAAC,KAAK;QACR,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IACrC,CAAC;IACD,OAAO,CAAC,KAAK;QACZ,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1B,KAAK,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;CACD,CAAC,CACF,CAAC"}

package/dist/component/list-capability.d.ts

@@ -0,0 +1,17 @@
+import type { ReactiveValue } from '@exactjs/reactive/framework/runtime';
+import type { Child } from './contracts.js';
+/** Runtime bridge for optional compiler-owned keyed list controllers. */
+export type ComponentListCapability = Readonly<{
+    map<T>(owner: object, collection: Iterable<T> | ReactiveValue<Iterable<T>>, key: (item: T) => string | number, render: (item: T) => Child, id?: string, provenance?: Iterable<T>, keyIdentity?: string): Child;
+    mapDirect<T>(owner: object, collection: Iterable<T> | ReactiveValue<Iterable<T>>, key: (item: T) => string | number, render: (item: T) => Child, id: string, provenance?: Iterable<T>, keyIdentity?: string): Child[];
+    begin(owner: object): void;
+    end(owner: object): void;
+    dispose(owner: object): void;
+}>;
+/** Installs keyed-list support when the compiled artifact contains component list ownership. */
+export declare function registerComponentListCapability(next: ComponentListCapability): void;
+/** Returns the reachable list implementation or fails when compiler capability emission is stale. */
+export declare function componentListCapability(): ComponentListCapability;
+/** Returns keyed-list support only when this artifact registered it. */
+export declare function optionalComponentListCapability(): ComponentListCapability | undefined;
+//# sourceMappingURL=list-capability.d.ts.map

package/dist/component/list-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-capability.d.ts","sourceRoot":"","sources":["../../src/component/list-capability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,yEAAyE;AACzE,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC;IAC9C,GAAG,CAAC,CAAC,EACJ,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EACpD,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,EACjC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,KAAK,EAC1B,EAAE,CAAC,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EACxB,WAAW,CAAC,EAAE,MAAM,GAClB,KAAK,CAAC;IACT,SAAS,CAAC,CAAC,EACV,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EACpD,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,EACjC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,KAAK,EAC1B,EAAE,EAAE,MAAM,EACV,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EACxB,WAAW,CAAC,EAAE,MAAM,GAClB,KAAK,EAAE,CAAC;IACX,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAC,CAAC;AAIH,gGAAgG;AAChG,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,uBAAuB,GAAG,IAAI,CAInF;AAED,qGAAqG;AACrG,wBAAgB,uBAAuB,IAAI,uBAAuB,CAMjE;AAED,wEAAwE;AACxE,wBAAgB,+BAA+B,IAAI,uBAAuB,GAAG,SAAS,CAErF"}

package/dist/component/list-capability.js

@@ -0,0 +1,18 @@
+let capability;
+/** Installs keyed-list support when the compiled artifact contains component list ownership. */
+export function registerComponentListCapability(next) {
+    if (capability && capability !== next)
+        throw new Error('Conflicting eXact component list capability integration');
+    capability = next;
+}
+/** Returns the reachable list implementation or fails when compiler capability emission is stale. */
+export function componentListCapability() {
+    if (!capability)
+        throw new Error('Component lists require the compiler-selected @exactjs/core/runtime/lists capability');
+    return capability;
+}
+/** Returns keyed-list support only when this artifact registered it. */
+export function optionalComponentListCapability() {
+    return capability;
+}
+//# sourceMappingURL=list-capability.js.map

package/dist/component/list-capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-capability.js","sourceRoot":"","sources":["../../src/component/list-capability.ts"],"names":[],"mappings":"AA4BA,IAAI,UAA+C,CAAC;AAEpD,gGAAgG;AAChG,MAAM,UAAU,+BAA+B,CAAC,IAA6B;IAC5E,IAAI,UAAU,IAAI,UAAU,KAAK,IAAI;QACpC,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC5E,UAAU,GAAG,IAAI,CAAC;AACnB,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,uBAAuB;IACtC,IAAI,CAAC,UAAU;QACd,MAAM,IAAI,KAAK,CACd,sFAAsF,CACtF,CAAC;IACH,OAAO,UAAU,CAAC;AACnB,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,+BAA+B;IAC9C,OAAO,UAAU,CAAC;AACnB,CAAC"}

package/dist/component/list-controller.d.ts

@@ -0,0 +1,10 @@
+import { type EffectScope, type ReactiveValue } from '@exactjs/reactive/framework/runtime';
+import type { Child } from './contracts.js';
+/** Owns keyed-list registrations and compiler-operation caches retained by one component instance. */
+export declare function createComponentListController(ownerScope: EffectScope): {
+    beginRender(): void;
+    endRender(): void;
+    dispose(): void;
+    map<T>(collection: Iterable<T> | ReactiveValue<Iterable<T>>, key: (item: T) => string | number, render: (item: T) => Child, id?: string, provenance?: Iterable<T>, keyIdentity?: string, direct?: boolean): Child | Child[];
+};
+//# sourceMappingURL=list-controller.d.ts.map

package/dist/component/list-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-controller.d.ts","sourceRoot":"","sources":["../../src/component/list-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAWN,KAAK,WAAW,EAEhB,KAAK,aAAa,EAElB,MAAM,qCAAqC,CAAC;AAI7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAI5C,sGAAsG;AACtG,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,WAAW;mBAuCpD,IAAI;iBAIN,IAAI;eAQN,IAAI;QAMX,CAAC,cACQ,QAAQ,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAC/C,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,UACzB,CAAC,IAAI,EAAE,CAAC,KAAK,KAAK,OACrB,MAAM,eACE,QAAQ,CAAC,CAAC,CAAC,gBACV,MAAM,qBAElB,KAAK,GAAG,KAAK,EAAE;EAyFnB"}

package/dist/component/list-controller.js

@@ -0,0 +1,143 @@
+import { isReactiveValue, collectionRef, createEffectScope, currentEffectScope, effectScopeParent, peek, registerEffectScopeCleanup, registerReactiveListKey, unwrap, withEffectScope } from '@exactjs/reactive/framework/runtime';
+import { createCompiledKeyedChildReceipt } from '../component-abi/keyed-child-receipt.js';
+import { createCompiledChildRangeReceipt } from './reactive-expressions.js';
+/** Owns keyed-list registrations and compiler-operation caches retained by one component instance. */
+export function createComponentListController(ownerScope) {
+    const caches = new Map();
+    const registrations = new Map();
+    const activeSlots = new Set();
+    const directSlots = new Set();
+    const scopePrefixes = new WeakMap();
+    let mapCallIndex = 0;
+    let itemScopeGeneration = 0;
+    const scopedSlot = (slot) => {
+        const prefix = currentScopePrefix();
+        return prefix === undefined ? slot : `${prefix}${encodeSlot(slot)}`;
+    };
+    const currentScopePrefix = () => {
+        for (let scope = currentEffectScope(); scope; scope = effectScopeParent(scope)) {
+            const prefix = scopePrefixes.get(scope);
+            if (prefix !== undefined)
+                return prefix;
+        }
+        return undefined;
+    };
+    const releaseNestedSlots = (prefix) => {
+        for (const [slot, registration] of registrations) {
+            if (!slot.startsWith(prefix))
+                continue;
+            registration.stop();
+            registrations.delete(slot);
+            caches.delete(slot);
+            directSlots.delete(slot);
+            activeSlots.delete(slot);
+        }
+    };
+    return {
+        beginRender() {
+            mapCallIndex = 0;
+            activeSlots.clear();
+        },
+        endRender() {
+            for (const [slot, registration] of registrations) {
+                if (activeSlots.has(slot) || directSlots.has(slot))
+                    continue;
+                registration.stop();
+                registrations.delete(slot);
+                caches.delete(slot);
+            }
+        },
+        dispose() {
+            for (const registration of registrations.values())
+                registration.stop();
+            registrations.clear();
+            caches.clear();
+            directSlots.clear();
+        },
+        map(collection, key, render, id, provenance, keyIdentity, direct = false) {
+            const source = peek(() => collectionRef(collection));
+            const current = isReactiveValue(collection) && source
+                ? peek(() => source.get())
+                : collection;
+            const authoredId = id ?? `map:${mapCallIndex++}`;
+            const cacheId = scopedSlot(authoredId);
+            activeSlots.add(cacheId);
+            if (direct)
+                directSlots.add(cacheId);
+            const registrationCollection = unwrap(provenance ?? current);
+            const registrationIdentity = keyIdentity ?? Function.prototype.toString.call(key);
+            const registered = registrations.get(cacheId);
+            if (!registered ||
+                registered.collection !== registrationCollection ||
+                registered.identity !== registrationIdentity) {
+                registered?.stop();
+                const stop = registerReactiveListKey(provenance ?? current, key, id ?? 'an unlabelled this.map() call', keyIdentity);
+                registrations.set(cacheId, {
+                    collection: registrationCollection,
+                    identity: registrationIdentity,
+                    stop
+                });
+            }
+            const previous = caches.get(cacheId);
+            // A compiler id identifies one stable authored map site. Its render closure is
+            // recreated when an enclosing reactive expression runs, but cached item operations
+            // already contain their own live readers and must retain identity.
+            const cache = id !== undefined || previous?.render === render ? previous?.cache : undefined;
+            const activeCache = cache ?? new Map();
+            if (!previous || previous.render !== render)
+                caches.set(cacheId, { render, cache: activeCache });
+            const materialize = () => {
+                const values = source
+                    ? source.get()
+                    : isReactiveValue(collection)
+                        ? collection.get()
+                        : collection;
+                const activeKeys = new Set();
+                const result = [];
+                for (const item of values) {
+                    const itemKey = String(key(item));
+                    if (activeKeys.has(itemKey))
+                        throw new Error(`Duplicate key "${itemKey}" in ${id ?? 'an unlabelled this.map() call'}`);
+                    activeKeys.add(itemKey);
+                    let cached = activeCache.get(itemKey);
+                    if (!cached || !Object.is(unwrap(cached.item), unwrap(item))) {
+                        const scope = createEffectScope(ownerScope);
+                        const itemScope = `${cacheId}${encodeSlot(itemKey)}${itemScopeGeneration++}:`;
+                        scopePrefixes.set(scope, itemScope);
+                        registerEffectScopeCleanup(scope, () => releaseNestedSlots(itemScope));
+                        let operation;
+                        try {
+                            operation = withEffectScope(scope, () => render(item));
+                        }
+                        catch (error) {
+                            scope.stop();
+                            throw error;
+                        }
+                        cached = {
+                            item,
+                            operation,
+                            keyed: createCompiledKeyedChildReceipt(operation, itemKey, scope),
+                            scope
+                        };
+                        activeCache.set(itemKey, cached);
+                        registerEffectScopeCleanup(scope, () => {
+                            if (activeCache.get(itemKey)?.scope === scope)
+                                activeCache.delete(itemKey);
+                        });
+                    }
+                    result.push(cached.keyed);
+                }
+                for (const cachedKey of activeCache.keys())
+                    if (!activeKeys.has(cachedKey))
+                        activeCache.delete(cachedKey);
+                return result;
+            };
+            return direct ? materialize() : createCompiledChildRangeReceipt(materialize, id);
+        }
+    };
+}
+/** Encodes one authored list identity without allowing nested key collisions. */
+function encodeSlot(value) {
+    return `${value.length}:${value}/`;
+}
+//# sourceMappingURL=list-controller.js.map

package/dist/component/list-controller.js.map

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

package/dist/component/localization-capability.d.ts

@@ -0,0 +1,13 @@
+import type { IntlFacade } from '../localization/contracts.js';
+import type { AnyComponentInstance } from './contracts.js';
+/** Minimal component ownership needed to resolve an inherited localization policy. */
+export type ComponentLocalizationOwner = Pick<AnyComponentInstance, 'hasContext' | 'getContext'>;
+/** Capability-local bridge installed only when component localization is reachable. */
+export type ComponentLocalizationCapability = Readonly<{
+    create(owner: ComponentLocalizationOwner): IntlFacade;
+}>;
+/** Installs component-local Intl facade construction for the current core runtime instance. */
+export declare function registerComponentLocalizationCapability(capability: ComponentLocalizationCapability): void;
+/** Returns the localization integration when this artifact includes component Intl support. */
+export declare function componentLocalizationCapability(): ComponentLocalizationCapability | undefined;
+//# sourceMappingURL=localization-capability.d.ts.map

package/dist/component/localization-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localization-capability.d.ts","sourceRoot":"","sources":["../../src/component/localization-capability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,sFAAsF;AACtF,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAAC,oBAAoB,EAAE,YAAY,GAAG,YAAY,CAAC,CAAC;AAEjG,uFAAuF;AACvF,MAAM,MAAM,+BAA+B,GAAG,QAAQ,CAAC;IACtD,MAAM,CAAC,KAAK,EAAE,0BAA0B,GAAG,UAAU,CAAC;CACtD,CAAC,CAAC;AAIH,+FAA+F;AAC/F,wBAAgB,uCAAuC,CACtD,UAAU,EAAE,+BAA+B,GACzC,IAAI,CAIN;AAED,+FAA+F;AAC/F,wBAAgB,+BAA+B,IAAI,+BAA+B,GAAG,SAAS,CAE7F"}

package/dist/component/localization-capability.js

@@ -0,0 +1,12 @@
+let localizationCapability;
+/** Installs component-local Intl facade construction for the current core runtime instance. */
+export function registerComponentLocalizationCapability(capability) {
+    if (localizationCapability && localizationCapability !== capability)
+        throw new Error('Conflicting eXact component localization capability integration');
+    localizationCapability = capability;
+}
+/** Returns the localization integration when this artifact includes component Intl support. */
+export function componentLocalizationCapability() {
+    return localizationCapability;
+}
+//# sourceMappingURL=localization-capability.js.map

package/dist/component/localization-capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localization-capability.js","sourceRoot":"","sources":["../../src/component/localization-capability.ts"],"names":[],"mappings":"AAWA,IAAI,sBAAmE,CAAC;AAExE,+FAA+F;AAC/F,MAAM,UAAU,uCAAuC,CACtD,UAA2C;IAE3C,IAAI,sBAAsB,IAAI,sBAAsB,KAAK,UAAU;QAClE,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACpF,sBAAsB,GAAG,UAAU,CAAC;AACrC,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,+BAA+B;IAC9C,OAAO,sBAAsB,CAAC;AAC/B,CAAC"}

package/dist/component/log.d.ts

@@ -0,0 +1,40 @@
+import type { AnyComponent, AnyComponentFunction, AnyComponentInstance, ComponentContextValues, ComponentDomain, ErrorReport } from './contracts.js';
+import { type ComponentLog, type LazyLogValue, type Logger, type LogLevel, type LogScope } from '../logging.js';
+export { defaultConsoleLogger } from './default-logger.js';
+/** Emits a framework-scoped log event through the supplied or default logger. */
+export declare function logFrameworkEvent(level: LogLevel, packageName: string, category: string, message: LazyLogValue<string>, data?: LazyLogValue<unknown>, logger?: Logger): void;
+/** Creates a component log. */
+export declare function createComponentLog(instance: AnyComponentInstance): ComponentLog;
+/**
+ * Represents an enabled component-log invocation prepared for an immediate call.
+ * Compiler output uses the optional presence of this function to defer authored
+ * argument evaluation until after the logger's runtime level check. The supplied
+ * reader runs exactly once inside a reactive `peek()` boundary.
+ */
+export type ComponentLogMethod = (readArguments: () => readonly [
+    message: LazyLogValue<string>,
+    errorOrData?: LazyLogValue<unknown>,
+    data?: LazyLogValue<unknown>
+]) => void;
+/** Minimum durable or request-local ownership needed by compiler-lowered component logging. */
+export type ComponentLogOwner = Readonly<{
+    domain: ComponentDomain;
+    parent?: AnyComponentInstance;
+    ambientContexts?: ComponentContextValues;
+    id: string;
+    type: AnyComponentFunction;
+    mounted: boolean;
+}>;
+/**
+ * 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 declare function componentLogMethod(instance: AnyComponent | ComponentLogOwner, level: LogLevel): ComponentLogMethod | undefined;
+/** Performs the component log scope domain operation. */
+export declare function componentLogScope(instance: ComponentLogOwner): LogScope;
+/** Reports whether error report. */
+export declare function isErrorReport(value: unknown): value is ErrorReport;
+/** Performs the format error domain operation. */
+export declare function formatError(error: unknown): string;
+//# sourceMappingURL=log.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/component/log.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,WAAW,EACX,MAAM,gBAAgB,CAAC;AAKxB,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,YAAY,EAEjB,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,iFAAiF;AACjF,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,QAAQ,EACf,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC,EAC7B,IAAI,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,EAC5B,MAAM,GAAE,MAA6B,GACnC,IAAI,CAaN;AAED,+BAA+B;AAC/B,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,YAAY,CAE/E;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAChC,aAAa,EAAE,MAAM,SAAS;IAC7B,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC;IACnC,IAAI,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC;CAC5B,KACG,IAAI,CAAC;AAEV,+FAA+F;AAC/F,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACxC,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,eAAe,CAAC,EAAE,sBAAsB,CAAC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,oBAAoB,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;CACjB,CAAC,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,kBAAkB,CACjC,QAAQ,EAAE,YAAY,GAAG,iBAAiB,EAC1C,KAAK,EAAE,QAAQ,GACb,kBAAkB,GAAG,SAAS,CAIhC;AA4JD,yDAAyD;AACzD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,QAAQ,CASvE;AAUD,oCAAoC;AACpC,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAIlE;AAED,kDAAkD;AAClD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKlD"}

package/dist/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/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/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/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/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/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/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/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"}