@praxisjs/core 1.8.3 → 2.1.0

package/dist/component/internals.d.ts

@@ -0,0 +1,16 @@
+export declare const componentPropsType: unique symbol;
+export declare function initComponentInternals(instance: object, props: object): void;
+export declare function getComponentProps(instance: object): object;
+export declare function setComponentProps(instance: object, props: Record<string, unknown>): void;
+export declare function getComponentRawProp(instance: object, name: string): unknown;
+export declare function getComponentDefault(instance: object, name: string): unknown;
+export declare function setComponentDefault(instance: object, name: string, value: unknown): void;
+export declare function getComponentDefaults(instance: object): Record<string, unknown>;
+export declare function getComponentAnchor(instance: object): Comment | undefined;
+export declare function setComponentAnchor(instance: object, anchor: Comment | undefined): void;
+export declare function isComponentMounted(instance: object): boolean;
+export declare function setComponentMounted(instance: object, mounted: boolean): void;
+export declare function markStateDirty(instance: object): void;
+export declare function isStateDirty(instance: object): boolean;
+export declare function setStateDirty(instance: object, stateDirty: boolean): void;
+//# sourceMappingURL=internals.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"internals.d.ts","sourceRoot":"","sources":["../../src/component/internals.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,EAAE,OAAO,MAA4C,CAAC;AAoBrF,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,IAAI,CAON;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CAMN;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAET;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAET;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,IAAI,CAEN;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzB;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAExE;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,GAAG,SAAS,GAC1B,IAAI,CAEN;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,GACf,IAAI,CAEN;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAKrD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAItD;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,OAAO,GAClB,IAAI,CAKN"}

package/dist/component/internals.js

@@ -0,0 +1,70 @@
+export const componentPropsType = Symbol("praxis.componentPropsType");
+const componentInternals = new WeakMap();
+function getInternals(instance) {
+    const internals = componentInternals.get(instance);
+    if (!internals) {
+        throw new TypeError("Expected a PraxisJS component instance.");
+    }
+    return internals;
+}
+export function initComponentInternals(instance, props) {
+    componentInternals.set(instance, {
+        rawProps: { ...props },
+        mounted: false,
+        defaults: {},
+        stateDirty: false,
+    });
+}
+export function getComponentProps(instance) {
+    return getInternals(instance).rawProps;
+}
+export function setComponentProps(instance, props) {
+    const rawProps = getInternals(instance).rawProps;
+    Object.keys(rawProps).forEach((key) => {
+        Reflect.deleteProperty(rawProps, key);
+    });
+    Object.assign(rawProps, props);
+}
+export function getComponentRawProp(instance, name) {
+    return getInternals(instance).rawProps[name];
+}
+export function getComponentDefault(instance, name) {
+    return getInternals(instance).defaults[name];
+}
+export function setComponentDefault(instance, name, value) {
+    getInternals(instance).defaults[name] = value;
+}
+export function getComponentDefaults(instance) {
+    return getInternals(instance).defaults;
+}
+export function getComponentAnchor(instance) {
+    return getInternals(instance).anchor;
+}
+export function setComponentAnchor(instance, anchor) {
+    getInternals(instance).anchor = anchor;
+}
+export function isComponentMounted(instance) {
+    return getInternals(instance).mounted;
+}
+export function setComponentMounted(instance, mounted) {
+    getInternals(instance).mounted = mounted;
+}
+export function markStateDirty(instance) {
+    const internals = componentInternals.get(instance);
+    if (internals) {
+        internals.stateDirty = true;
+    }
+}
+export function isStateDirty(instance) {
+    const internals = componentInternals.get(instance);
+    if (internals)
+        return internals.stateDirty;
+    return false;
+}
+export function setStateDirty(instance, stateDirty) {
+    const internals = componentInternals.get(instance);
+    if (internals) {
+        internals.stateDirty = stateDirty;
+    }
+}
+//# sourceMappingURL=internals.js.map

package/dist/component/internals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internals.js","sourceRoot":"","sources":["../../src/component/internals.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAkB,MAAM,CAAC,2BAA2B,CAAC,CAAC;AAUrF,MAAM,kBAAkB,GAAG,IAAI,OAAO,EAAsC,CAAC;AAE7E,SAAS,YAAY,CAAC,QAAgB;IACpC,MAAM,SAAS,GAAG,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,SAAS,CAAC,yCAAyC,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,QAAgB,EAChB,KAAa;IAEb,kBAAkB,CAAC,GAAG,CAAC,QAAQ,EAAE;QAC/B,QAAQ,EAAE,EAAE,GAAG,KAAK,EAAE;QACtB,OAAO,EAAE,KAAK;QACd,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,KAAK;KAClB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,QAAgB,EAChB,KAA8B;IAE9B,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,QAAmC,CAAC;IAC5E,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QACpC,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,IAAY;IAEZ,OAAQ,YAAY,CAAC,QAAQ,CAAC,CAAC,QAAoC,CAAC,IAAI,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,IAAY;IAEZ,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,IAAY,EACZ,KAAc;IAEd,YAAY,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,QAAgB;IAEhB,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,QAAgB,EAChB,MAA2B;IAE3B,YAAY,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,OAAgB;IAEhB,YAAY,CAAC,QAAQ,CAAC,CAAC,OAAO,GAAG,OAAO,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,MAAM,SAAS,GAAG,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,SAAS,EAAE,CAAC;QACd,SAAS,CAAC,UAAU,GAAG,IAAI,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,MAAM,SAAS,GAAG,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC,UAAU,CAAC;IAC3C,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,QAAgB,EAChB,UAAmB;IAEnB,MAAM,SAAS,GAAG,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,SAAS,EAAE,CAAC;QACd,SAAS,CAAC,UAAU,GAAG,UAAU,CAAC;IACpC,CAAC;AACH,CAAC"}

package/dist/component/stateful.d.ts

@@ -1,19 +1,4 @@
 import { RootComponent } from "./base";
 export declare abstract class StatefulComponent extends RootComponent<Record<string, unknown>> {
-    /**
-     * Default field values declared in the class, used to reset props on update.
-     * @internal
-     */
-    readonly _defaults: Record<string, unknown>;
-    /**
-     * Set to `true` by `@State` on any write; cleared by the renderer after each re-render.
-     * @internal
-     */
-    _stateDirty: boolean;
-    /**
-     * Raw props. Use `@Prop()` fields instead of reading this directly in user code.
-     * @internal
-     */
-    get props(): Record<string, unknown>;
 }
 //# sourceMappingURL=stateful.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"stateful.d.ts","sourceRoot":"","sources":["../../src/component/stateful.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,8BAAsB,iBAAkB,SAAQ,aAAa,CAC3D,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACxB;IACC;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;IAEjD;;;OAGG;IACH,WAAW,UAAS;IAEpB;;;OAGG;IACH,IAAa,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE5C;CACF"}
+{"version":3,"file":"stateful.d.ts","sourceRoot":"","sources":["../../src/component/stateful.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,8BAAsB,iBAAkB,SAAQ,aAAa,CAC3D,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACxB;CAAG"}

package/dist/component/stateful.js

@@ -1,24 +1,4 @@
 import { RootComponent } from "./base";
 export class StatefulComponent extends RootComponent {
-    constructor() {
-        super(...arguments);
-        /**
-         * Default field values declared in the class, used to reset props on update.
-         * @internal
-         */
-        this._defaults = {};
-        /**
-         * Set to `true` by `@State` on any write; cleared by the renderer after each re-render.
-         * @internal
-         */
-        this._stateDirty = false;
-    }
-    /**
-     * Raw props. Use `@Prop()` fields instead of reading this directly in user code.
-     * @internal
-     */
-    get props() {
-        return this._rawProps;
-    }
 }
 //# sourceMappingURL=stateful.js.map

package/dist/component/stateful.js.map

@@ -1 +1 @@
-{"version":3,"file":"stateful.js","sourceRoot":"","sources":["../../src/component/stateful.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,MAAM,OAAgB,iBAAkB,SAAQ,aAE/C;IAFD;;QAGE;;;WAGG;QACM,cAAS,GAA4B,EAAE,CAAC;QAEjD;;;WAGG;QACH,gBAAW,GAAG,KAAK,CAAC;IAStB,CAAC;IAPC;;;OAGG;IACH,IAAa,KAAK;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CACF"}
+{"version":3,"file":"stateful.js","sourceRoot":"","sources":["../../src/component/stateful.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,MAAM,OAAgB,iBAAkB,SAAQ,aAE/C;CAAG"}

package/dist/component/stateless.d.ts

@@ -4,7 +4,7 @@ type StatelessComponentType<T> = T & {
     children?: Children;
 };
 export declare abstract class StatelessComponent<T extends object = Record<never, never>> extends RootComponent<StatelessComponentType<T>> {
-    /** Public props API for presentational components — see `RootComponent.props`. */
+    /** Public props API for presentational components. */
     get props(): StatelessComponentType<T>;
 }
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"stateless.d.ts","sourceRoot":"","sources":["../../src/component/stateless.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,KAAK,sBAAsB,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAAE,CAAC;AAE7D,8BAAsB,kBAAkB,CACtC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CACvC,SAAQ,aAAa,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAChD,kFAAkF;IAClF,IAAa,KAAK,IAAI,sBAAsB,CAAC,CAAC,CAAC,CAE9C;CACF"}
+{"version":3,"file":"stateless.d.ts","sourceRoot":"","sources":["../../src/component/stateless.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAGvC,KAAK,sBAAsB,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAAE,CAAC;AAE7D,8BAAsB,kBAAkB,CACtC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CACvC,SAAQ,aAAa,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAChD,sDAAsD;IACtD,IAAI,KAAK,IAAI,sBAAsB,CAAC,CAAC,CAAC,CAErC;CACF"}

package/dist/component/stateless.js

@@ -1,8 +1,9 @@
 import { RootComponent } from "./base";
+import { getComponentProps } from "./internals";
 export class StatelessComponent extends RootComponent {
-    /** Public props API for presentational components — see `RootComponent.props`. */
+    /** Public props API for presentational components. */
     get props() {
-        return this._rawProps;
+        return getComponentProps(this);
     }
 }
 //# sourceMappingURL=stateless.js.map

package/dist/component/stateless.js.map

@@ -1 +1 @@
-{"version":3,"file":"stateless.js","sourceRoot":"","sources":["../../src/component/stateless.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAIvC,MAAM,OAAgB,kBAEpB,SAAQ,aAAwC;IAChD,kFAAkF;IAClF,IAAa,KAAK;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CACF"}
+{"version":3,"file":"stateless.js","sourceRoot":"","sources":["../../src/component/stateless.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAIhD,MAAM,OAAgB,kBAEpB,SAAQ,aAAwC;IAChD,sDAAsD;IACtD,IAAI,KAAK;QACP,OAAO,iBAAiB,CAAC,IAAI,CAA8B,CAAC;IAC9D,CAAC;CACF"}

package/dist/internal.d.ts

@@ -1,6 +1,8 @@
 export { debounced, until, when, history, type HistoryElement, } from "./reactive";
 export { signal, persistedSignal, syncedSignal, peek, computed, writableComputed, batch, effect, untrack, type PersistedSignalOptions, type SyncedSignal, } from "./signal";
 export { RootComponent } from "./component";
-export { resource, createResource, type ResourceStatus, type Resource, type ResourceOptions, } from "./async/resource";
-export { invalidateResource, _clearCache } from "./async/resource-cache";
+export { componentPropsType, getComponentAnchor, getComponentDefault, getComponentDefaults, getComponentProps, getComponentRawProp, isComponentMounted, isStateDirty, markStateDirty, setComponentAnchor, setComponentDefault, setComponentMounted, setComponentProps, setStateDirty, } from "./component/internals";
+export { resource, createResource, flushPendingResources, type ResourceStatus, type Resource, type ResourceOptions, } from "./async/resource";
+export { invalidateResource, trackPendingResource, _clearCache } from "./async/resource-cache";
+export { setServerRenderPass, isServerRenderPass } from "./async/server-mode";
 //# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,KAAK,EACL,IAAI,EACJ,OAAO,EACP,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,MAAM,EACN,eAAe,EACf,YAAY,EACZ,IAAI,EACJ,QAAQ,EACR,gBAAgB,EAChB,KAAK,EACL,MAAM,EACN,OAAO,EACP,KAAK,sBAAsB,EAC3B,KAAK,YAAY,GAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,QAAQ,EACR,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,KAAK,EACL,IAAI,EACJ,OAAO,EACP,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,MAAM,EACN,eAAe,EACf,YAAY,EACZ,IAAI,EACJ,QAAQ,EACR,gBAAgB,EAChB,KAAK,EACL,MAAM,EACN,OAAO,EACP,KAAK,sBAAsB,EAC3B,KAAK,YAAY,GAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,GACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,QAAQ,EACR,cAAc,EACd,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC/F,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/internal.js

@@ -1,6 +1,8 @@
 export { debounced, until, when, history, } from "./reactive";
 export { signal, persistedSignal, syncedSignal, peek, computed, writableComputed, batch, effect, untrack, } from "./signal";
 export { RootComponent } from "./component";
-export { resource, createResource, } from "./async/resource";
-export { invalidateResource, _clearCache } from "./async/resource-cache";
+export { componentPropsType, getComponentAnchor, getComponentDefault, getComponentDefaults, getComponentProps, getComponentRawProp, isComponentMounted, isStateDirty, markStateDirty, setComponentAnchor, setComponentDefault, setComponentMounted, setComponentProps, setStateDirty, } from "./component/internals";
+export { resource, createResource, flushPendingResources, } from "./async/resource";
+export { invalidateResource, trackPendingResource, _clearCache } from "./async/resource-cache";
+export { setServerRenderPass, isServerRenderPass } from "./async/server-mode";
 //# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,KAAK,EACL,IAAI,EACJ,OAAO,GAER,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,MAAM,EACN,eAAe,EACf,YAAY,EACZ,IAAI,EACJ,QAAQ,EACR,gBAAgB,EAChB,KAAK,EACL,MAAM,EACN,OAAO,GAGR,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,QAAQ,EACR,cAAc,GAIf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,KAAK,EACL,IAAI,EACJ,OAAO,GAER,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,MAAM,EACN,eAAe,EACf,YAAY,EACZ,IAAI,EACJ,QAAQ,EACR,gBAAgB,EAChB,KAAK,EACL,MAAM,EACN,OAAO,GAGR,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,GACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,QAAQ,EACR,cAAc,EACd,qBAAqB,GAItB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC/F,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisjs/core",
-  "version": "1.8.3",
+  "version": "2.1.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -15,10 +15,10 @@
     }
   },
   "devDependencies": {
-    "typescript": "^5.9.3"
+    "typescript": "^6.0.3"
   },
   "dependencies": {
-    "@praxisjs/shared": "0.3.0"
+    "@praxisjs/shared": "0.3.1"
   },
   "scripts": {
     "build": "tsc",

package/src/__tests__/component.test.ts

@@ -1,6 +1,21 @@
 import { describe, it, expect } from "vitest";
 
 import { RootComponent } from "../component/base";
+import {
+  getComponentAnchor,
+  getComponentDefault,
+  getComponentDefaults,
+  getComponentProps,
+  getComponentRawProp,
+  isComponentMounted,
+  isStateDirty,
+  markStateDirty,
+  setComponentAnchor,
+  setComponentDefault,
+  setComponentMounted,
+  setComponentProps,
+  setStateDirty,
+} from "../component/internals";
 import { StatefulComponent } from "../component/stateful";
 import { StatelessComponent } from "../component/stateless";
 
@@ -17,48 +32,90 @@ class ConcreteStateful extends StatefulComponent {
 }
 
 describe("RootComponent", () => {
-  it("stores props on _rawProps", () => {
+  it("stores props in component internals", () => {
     const c = new ConcreteRoot({ name: "Alice" });
-    expect(c._rawProps.name).toBe("Alice");
+    expect((getComponentProps(c) as { name: string }).name).toBe("Alice");
   });
 
-  it("exposes props via .props getter", () => {
-    const c = new ConcreteRoot({ name: "Bob" });
-    expect(c.props.name).toBe("Bob");
+  it("does not expose old underscore internals as own properties", () => {
+    const c = new ConcreteRoot({ name: "Alice" });
+    expect(Object.prototype.hasOwnProperty.call(c, "_rawProps")).toBe(false);
+    expect(Object.prototype.hasOwnProperty.call(c, "_mounted")).toBe(false);
+    expect(Object.prototype.hasOwnProperty.call(c, "_anchor")).toBe(false);
+    expect(Object.prototype.hasOwnProperty.call(c, "_setProps")).toBe(false);
   });
 
-  it("_mounted starts as false", () => {
+  it("mounted starts as false", () => {
     const c = new ConcreteRoot({ name: "" });
-    expect(c._mounted).toBe(false);
+    expect(isComponentMounted(c)).toBe(false);
   });
 
-  it("_anchor starts as undefined", () => {
+  it("anchor starts as undefined", () => {
     const c = new ConcreteRoot({ name: "" });
-    expect(c._anchor).toBeUndefined();
+    expect(getComponentAnchor(c)).toBeUndefined();
   });
 
   it("defaults to empty object when no props given", () => {
     const c = new ConcreteRoot();
-    expect(c._rawProps).toEqual({});
+    expect(getComponentProps(c)).toEqual({});
   });
 });
 
 describe("StatefulComponent", () => {
-  it("_defaults starts as empty object", () => {
+  it("defaults start as empty object", () => {
     const c = new ConcreteStateful();
-    expect(c._defaults).toEqual({});
+    expect(getComponentDefaults(c)).toEqual({});
   });
 
-  it("_stateDirty starts as false", () => {
+  it("stateDirty starts as false", () => {
     const c = new ConcreteStateful();
-    expect(c._stateDirty).toBe(false);
+    expect(isStateDirty(c)).toBe(false);
   });
 
-  it("_setProps replaces _rawProps contents", () => {
+  it("setComponentProps replaces raw props contents", () => {
     const c = new ConcreteStateful({ x: 1 });
-    c._setProps({ y: 2 });
-    expect(c._rawProps.x).toBeUndefined();
-    expect(c._rawProps.y).toBe(2);
+    setComponentProps(c, { y: 2 });
+    const props = getComponentProps(c) as Record<string, unknown>;
+    expect(props.x).toBeUndefined();
+    expect(props.y).toBe(2);
+  });
+
+  it("updates anchor, mounted, defaults, and dirty state through helpers", () => {
+    const c = new ConcreteStateful();
+    const anchor = {} as Comment;
+
+    setComponentAnchor(c, anchor);
+    setComponentMounted(c, true);
+    setComponentDefault(c, "label", "Save");
+    setStateDirty(c, true);
+
+    expect(getComponentAnchor(c)).toBe(anchor);
+    expect(isComponentMounted(c)).toBe(true);
+    expect(getComponentDefaults(c).label).toBe("Save");
+    expect(isStateDirty(c)).toBe(true);
+  });
+
+  it("reads raw props and defaults through single-value helpers", () => {
+    const c = new ConcreteStateful({ label: "From parent" });
+    setComponentDefault(c, "label", "Default");
+
+    expect(getComponentRawProp(c, "label")).toBe("From parent");
+    expect(getComponentDefault(c, "label")).toBe("Default");
+  });
+
+  it("throws when component internals are read from a non-component", () => {
+    expect(() => getComponentProps({})).toThrow(TypeError);
+    expect(() => getComponentProps({})).toThrow(
+      "Expected a PraxisJS component instance.",
+    );
+  });
+
+  it("ignores dirty-state writes on non-component hosts", () => {
+    const host = {};
+
+    expect(() => markStateDirty(host)).not.toThrow();
+    expect(() => setStateDirty(host, true)).not.toThrow();
+    expect(isStateDirty(host)).toBe(false);
   });
 });
 
@@ -69,21 +126,21 @@ class ConcreteStateless extends StatelessComponent<{ name: string }> {
 }
 
 describe("StatelessComponent", () => {
-  it("stores props on _rawProps", () => {
+  it("stores props in component internals", () => {
     const c = new ConcreteStateless({ name: "Alice" });
-    expect(c._rawProps.name).toBe("Alice");
+    expect((getComponentProps(c) as { name: string }).name).toBe("Alice");
   });
 
-  it("_setProps replaces _rawProps contents", () => {
+  it("setComponentProps replaces raw props contents", () => {
     const c = new ConcreteStateless({ name: "Alice" });
-    c._setProps({ name: "Bob" });
-    expect(c._rawProps.name).toBe("Bob");
+    setComponentProps(c, { name: "Bob" });
+    expect((getComponentProps(c) as { name: string }).name).toBe("Bob");
   });
 
-  it("_setProps removes old keys", () => {
+  it("setComponentProps removes old keys", () => {
     const c = new ConcreteStateless({ name: "Alice" });
-    c._setProps({});
-    expect((c._rawProps as Record<string, unknown>).name).toBeUndefined();
+    setComponentProps(c, {});
+    expect((getComponentProps(c) as Record<string, unknown>).name).toBeUndefined();
   });
 
   it("accepts and exposes children via props.children", () => {

package/src/__tests__/resource-server-pass.test.ts

@@ -0,0 +1,90 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+
+import { flushPendingResources, resource } from "../async/resource";
+import { _clearCache, getPendingResources } from "../async/resource-cache";
+import { setServerRenderPass, isServerRenderPass } from "../async/server-mode";
+
+describe("server render pass — flushPendingResources", () => {
+  beforeEach(() => { _clearCache(); });
+  afterEach(() => { setServerRenderPass(false); });
+
+  it("is a no-op when no server pass is active", async () => {
+    setServerRenderPass(false);
+    const r = resource(() => new Promise<string>(() => {}));
+    expect(getPendingResources().size).toBe(0);
+    await flushPendingResources();
+    // Untouched — resource() never settled and flush didn't wait for it.
+    expect(r.status()).toBe("pending");
+  });
+
+  it("resolves immediately when nothing is pending", async () => {
+    setServerRenderPass(true);
+    await expect(flushPendingResources()).resolves.toBeUndefined();
+  });
+
+  it("tracks isServerRenderPass() state via the setter", () => {
+    expect(isServerRenderPass()).toBe(false);
+    setServerRenderPass(true);
+    expect(isServerRenderPass()).toBe(true);
+  });
+
+  it("awaits an unkeyed resource() (e.g. @Collection) before returning", async () => {
+    setServerRenderPass(true);
+    const r = resource(() => new Promise<string>((res) => { setTimeout(() => { res("content"); }, 5); }));
+    await flushPendingResources();
+    expect(r.status()).toBe("success");
+    expect(r.data()).toBe("content");
+  });
+
+  it("awaits a keyed resource() too", async () => {
+    setServerRenderPass(true);
+    const r = resource(() => Promise.resolve("keyed-value"), { key: "ssg-key" });
+    await flushPendingResources();
+    expect(r.status()).toBe("success");
+    expect(r.data()).toBe("keyed-value");
+  });
+
+  it("awaits multiple concurrently pending resources", async () => {
+    setServerRenderPass(true);
+    const r1 = resource(() => new Promise<number>((res) => { setTimeout(() => { res(1); }, 5); }));
+    const r2 = resource(() => new Promise<number>((res) => { setTimeout(() => { res(2); }, 10); }));
+    await flushPendingResources();
+    expect(r1.data()).toBe(1);
+    expect(r2.data()).toBe(2);
+  });
+
+  it("fixed-point loop: awaits a resource created while an earlier one settles", async () => {
+    setServerRenderPass(true);
+    let second: ReturnType<typeof resource> | undefined;
+
+    // Simulates a component that, upon its first resource resolving, creates a
+    // second resource (e.g. a detail page fetching related content) — the new
+    // promise must still be picked up even though it didn't exist yet when
+    // flushPendingResources() started its first pass.
+    const first = resource(() => new Promise<string>((res) => {
+      setTimeout(() => {
+        res("first");
+        second = resource(() => new Promise<string>((res2) => { setTimeout(() => { res2("second"); }, 5); }));
+      }, 5);
+    }));
+
+    await flushPendingResources();
+    expect(first.status()).toBe("success");
+    expect(second?.status()).toBe("success");
+    expect(second?.data()).toBe("second");
+  });
+
+  it("does not leave stale entries after resources settle", async () => {
+    setServerRenderPass(true);
+    resource(() => Promise.resolve("done"));
+    await flushPendingResources();
+    expect(getPendingResources().size).toBe(0);
+  });
+
+  it("a rejected resource does not hang the flush", async () => {
+    setServerRenderPass(true);
+    const r = resource(() => Promise.reject(new Error("boom")));
+    await expect(flushPendingResources()).resolves.toBeUndefined();
+    expect(r.status()).toBe("error");
+  });
+});

package/src/async/resource-cache.ts

@@ -1,3 +1,5 @@
+import { isServerRenderPass } from "./server-mode";
+
 interface CacheEntry {
   data: unknown;
   timestamp: number;
@@ -6,6 +8,7 @@ interface CacheEntry {
 const _cache = new Map<string, CacheEntry>();
 const _inflight = new Map<string, Promise<unknown>>();
 const _registry = new Map<string, Set<() => void>>();
+const _pendingResources = new Set<Promise<unknown>>();
 
 export function getCacheEntry(key: string): CacheEntry | undefined {
   return _cache.get(key);
@@ -54,9 +57,26 @@ export function invalidateResource(key: string): void {
   _registry.get(key)?.forEach((fn) => { fn(); });
 }
 
+/**
+ * Registers `promise` as pending while a server render pass is active (no-op otherwise,
+ * so client-side resource() calls never pay this cost). Self-removes on settle.
+ */
+export function trackPendingResource(promise: Promise<unknown>): void {
+  if (!isServerRenderPass()) return;
+  _pendingResources.add(promise);
+  const cleanup = (): void => { _pendingResources.delete(promise); };
+  promise.then(cleanup, cleanup);
+}
+
+/** Snapshot of currently in-flight resource promises tracked during a server render pass. */
+export function getPendingResources(): ReadonlySet<Promise<unknown>> {
+  return _pendingResources;
+}
+
 /** Resets all cache state. Intended for use in tests only. */
 export function _clearCache(): void {
   _cache.clear();
   _inflight.clear();
   _registry.clear();
+  _pendingResources.clear();
 }

package/src/async/resource.ts

@@ -9,6 +9,8 @@ import {
   setInflight,
   registerResource,
   unregisterResource,
+  trackPendingResource,
+  getPendingResources,
 } from "./resource-cache";
 import { effect, untrack } from "../signal/effect";
 
@@ -58,6 +60,7 @@ export function resource<T>(
   let _runId = 0;
 
   function _execute(fn: Promise<T>): void {
+    trackPendingResource(fn);
     const currentRunId = ++_runId;
 
     function clearInflight(): void {
@@ -194,3 +197,17 @@ export function createResource<P, T>(
 ): Resource<T> {
   return resource(() => fetcher(param()), options);
 }
+
+/**
+ * Awaits every resource fetch tracked during a server render pass (see
+ * `setServerRenderPass`), including ones triggered by resources that themselves
+ * settle while waiting (fixed-point loop). No-op — resolves immediately — when
+ * nothing is pending or tracking isn't active.
+ */
+export async function flushPendingResources(): Promise<void> {
+  for (;;) {
+    const pending = Array.from(getPendingResources());
+    if (pending.length === 0) return;
+    await Promise.allSettled(pending);
+  }
+}

package/src/async/server-mode.ts

@@ -0,0 +1,16 @@
+let _serverRenderPass = false;
+
+/**
+ * Marks whether the current process is doing a build-time server/SSG render pass
+ * (as opposed to a normal browser render). Consumed by `resource-cache` (gates
+ * pending-promise tracking for `flushPendingResources`) and by `@praxisjs/runtime`'s
+ * `Portal`, which skips mounting entirely during a server pass so its content
+ * never gets baked into static HTML (it mounts normally once on the client).
+ */
+export function setServerRenderPass(active: boolean): void {
+  _serverRenderPass = active;
+}
+
+export function isServerRenderPass(): boolean {
+  return _serverRenderPass;
+}

package/src/component/base.ts

@@ -1,44 +1,10 @@
-export abstract class RootComponent<T extends object = Record<string, never>> {
-  /**
-   * Props passed by the parent — filled by the renderer when instantiating/updating.
-   * @internal
-   */
-  readonly _rawProps: T = {} as T;
-
-  /**
-   * Becomes `true` after `onMount` fires.
-   * @internal
-   */
-  _mounted = false;
+import { componentPropsType, initComponentInternals } from "./internals";
 
-  /**
-   * End comment anchor set by the runtime; used by decorators to locate the parent element.
-   * @internal
-   */
-  _anchor?: Comment;
+export abstract class RootComponent<T extends object = Record<string, never>> {
+  declare readonly [componentPropsType]: T;
 
   constructor(props: T = {} as T) {
-    Object.assign(this._rawProps, props);
-  }
-
-  /**
-   * Replaces the current props with a new set; called by the renderer on every parent re-render.
-   * @internal
-   */
-  _setProps(props: Record<string, unknown>) {
-    Object.keys(this._rawProps).forEach((k) => {
-      Reflect.deleteProperty(this._rawProps, k);
-    });
-    Object.assign(this._rawProps, props);
-  }
-
-  /**
-   * Raw props, typed. `StatelessComponent` re-exposes this as its public
-   * props API; on `StatefulComponent` it's internal — use `@Prop()` instead.
-   * @internal
-   */
-  get props(): T {
-    return this._rawProps;
+    initComponentInternals(this, props);
   }
 
   onBeforeMount?(): void;