@praxisjs/core 1.8.2 → 2.0.0

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @praxisjs/core
 
+## 2.0.0
+
+### Major Changes
+
+- 8ab6426: Move component runtime state out of public instances and behind internal helpers.
+
+  BREAKING CHANGE: `RootComponent`, `StatefulComponent`, and `ReactiveStore` no longer expose framework-only underscore internals or `StatefulComponent.props` as public instance API.
+
+  `RootComponent` and `StatefulComponent` no longer expose framework-only underscore fields such as `_rawProps`, `_mounted`, `_anchor`, `_setProps`, `_defaults`, or `_stateDirty`. The renderer, decorators, JSX types, and first-party CSS utilities now use helpers from `@praxisjs/core/internal` to access that state.
+
+  For app code, `StatefulComponent` props should continue to be modeled with `@Prop()` fields. `StatelessComponent<T>` keeps its public `props` getter.
+
+  This also clarifies the intended props API: `StatelessComponent.props` is public, while `StatefulComponent` subclasses should read parent-provided values through `@Prop()` fields instead of `props`.
+
+  `ReactiveStore` now uses a type-only reactive-host marker for `@State`/`@DeepState` compatibility and no longer creates `_stateDirty` on store instances.
+
+### Patch Changes
+
+- Updated dependencies [8ab6426]
+  - @praxisjs/shared@0.3.1
+
+## 1.8.3
+
+### Patch Changes
+
+- 7d87288: Document `props` as `StatelessComponent`'s intended public API, and as an internal implementation detail on `StatefulComponent` (use `@Prop()` fields instead). No behavior change — `RootComponent.props`, `StatefulComponent.props`, and `StatelessComponent.props` all still return `_rawProps` exactly as before; this only clarifies, via JSDoc, which class each usage pattern is meant for.
+
 ## 1.8.2
 
 ### Patch Changes

package/dist/__tests__/component.test.js

@@ -1,5 +1,6 @@
 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";
 class ConcreteRoot extends RootComponent {
@@ -13,41 +14,73 @@ 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).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);
+        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 = {};
+        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);
     });
 });
 class ConcreteStateless extends StatelessComponent {
@@ -56,19 +89,19 @@ class ConcreteStateless extends StatelessComponent {
     }
 }
 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).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).name).toBe("Bob");
     });
-    it("_setProps removes old keys", () => {
+    it("setComponentProps removes old keys", () => {
         const c = new ConcreteStateless({ name: "Alice" });
-        c._setProps({});
-        expect(c._rawProps.name).toBeUndefined();
+        setComponentProps(c, {});
+        expect(getComponentProps(c).name).toBeUndefined();
     });
     it("accepts and exposes children via props.children", () => {
         const c = new ConcreteStateless({ name: "x", children: "hello" });

package/dist/__tests__/component.test.js.map

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

package/dist/component/base.d.ts

@@ -1,26 +1,7 @@
+import { componentPropsType } from "./internals";
 export declare 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;
-    /**
-     * Becomes `true` after `onMount` fires.
-     * @internal
-     */
-    _mounted: boolean;
-    /**
-     * End comment anchor set by the runtime; used by decorators to locate the parent element.
-     * @internal
-     */
-    _anchor?: Comment;
+    readonly [componentPropsType]: T;
     constructor(props?: T);
-    /**
-     * Replaces the current props with a new set; called by the renderer on every parent re-render.
-     * @internal
-     */
-    _setProps(props: Record<string, unknown>): void;
-    get props(): T;
     onBeforeMount?(): void;
     onMount?(): void;
     onUnmount?(): void;

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

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/component/base.ts"],"names":[],"mappings":"AAAA,8BAAsB,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAC1E;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAW;IAEhC;;;OAGG;IACH,QAAQ,UAAS;IAEjB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEN,KAAK,GAAE,CAAW;IAI9B;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAOxC,IAAI,KAAK,IAAI,CAAC,CAEb;IAED,aAAa,CAAC,IAAI,IAAI;IACtB,OAAO,CAAC,IAAI,IAAI;IAChB,SAAS,CAAC,IAAI,IAAI;IAElB,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,IAAI,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IAE/D,QAAQ,CAAC,MAAM,IAAI,IAAI,GAAG,IAAI,EAAE,GAAG,IAAI;CACxC"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/component/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAA0B,MAAM,aAAa,CAAC;AAEzE,8BAAsB,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAC1E,SAAiB,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;gBAE7B,KAAK,GAAE,CAAW;IAI9B,aAAa,CAAC,IAAI,IAAI;IACtB,OAAO,CAAC,IAAI,IAAI;IAChB,SAAS,CAAC,IAAI,IAAI;IAElB,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,IAAI,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IAE/D,QAAQ,CAAC,MAAM,IAAI,IAAI,GAAG,IAAI,EAAE,GAAG,IAAI;CACxC"}

package/dist/component/base.js

@@ -1,29 +1,7 @@
+import { initComponentInternals } from "./internals";
 export class RootComponent {
     constructor(props = {}) {
-        /**
-         * Props passed by the parent — filled by the renderer when instantiating/updating.
-         * @internal
-         */
-        this._rawProps = {};
-        /**
-         * Becomes `true` after `onMount` fires.
-         * @internal
-         */
-        this._mounted = false;
-        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) {
-        Object.keys(this._rawProps).forEach((k) => {
-            Reflect.deleteProperty(this._rawProps, k);
-        });
-        Object.assign(this._rawProps, props);
-    }
-    get props() {
-        return this._rawProps;
+        initComponentInternals(this, props);
     }
 }
 //# sourceMappingURL=base.js.map

package/dist/component/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/component/base.ts"],"names":[],"mappings":"AAAA,MAAM,OAAgB,aAAa;IAmBjC,YAAY,QAAW,EAAO;QAlB9B;;;WAGG;QACM,cAAS,GAAM,EAAO,CAAC;QAEhC;;;WAGG;QACH,aAAQ,GAAG,KAAK,CAAC;QASf,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,KAA8B;QACtC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YACxC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CASF"}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/component/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAEzE,MAAM,OAAgB,aAAa;IAGjC,YAAY,QAAW,EAAO;QAC5B,sBAAsB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;CASF"}

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":"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"}

package/dist/component/stateful.d.ts

@@ -1,14 +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;
 }
 //# 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;CAErB"}
+{"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,17 +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;
-    }
 }
 //# 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;IAEtB,CAAC;CAAA"}
+{"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,6 +4,8 @@ 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. */
+    get props(): StatelessComponentType<T>;
 }
 export {};
 //# sourceMappingURL=stateless.d.ts.map

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;CACjD"}
+{"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,4 +1,9 @@
 import { RootComponent } from "./base";
+import { getComponentProps } from "./internals";
 export class StatelessComponent extends RootComponent {
+    /** Public props API for presentational components. */
+    get props() {
+        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;CACjD"}
+{"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,7 @@
 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 { componentPropsType, getComponentAnchor, getComponentDefault, getComponentDefaults, getComponentProps, getComponentRawProp, isComponentMounted, isStateDirty, markStateDirty, setComponentAnchor, setComponentDefault, setComponentMounted, setComponentProps, setStateDirty, } from "./component/internals";
 export { resource, createResource, type ResourceStatus, type Resource, type ResourceOptions, } from "./async/resource";
 export { invalidateResource, _clearCache } from "./async/resource-cache";
 //# 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,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/internal.js

@@ -1,6 +1,7 @@
 export { debounced, until, when, history, } from "./reactive";
 export { signal, persistedSignal, syncedSignal, peek, computed, writableComputed, batch, effect, untrack, } from "./signal";
 export { RootComponent } from "./component";
+export { componentPropsType, getComponentAnchor, getComponentDefault, getComponentDefaults, getComponentProps, getComponentRawProp, isComponentMounted, isStateDirty, markStateDirty, setComponentAnchor, setComponentDefault, setComponentMounted, setComponentProps, setStateDirty, } from "./component/internals";
 export { resource, createResource, } from "./async/resource";
 export { invalidateResource, _clearCache } from "./async/resource-cache";
 //# 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,GAIf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisjs/core",
-  "version": "1.8.2",
+  "version": "2.0.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -18,7 +18,7 @@
     "typescript": "^5.9.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/component/base.ts

@@ -1,39 +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);
-  }
-
-  get props(): T {
-    return this._rawProps;
+    initComponentInternals(this, props);
   }
 
   onBeforeMount?(): void;

package/src/component/internals.ts

@@ -0,0 +1,119 @@
+export const componentPropsType: unique symbol = Symbol("praxis.componentPropsType");
+
+interface ComponentInternals<T extends object> {
+  rawProps: T;
+  mounted: boolean;
+  anchor?: Comment;
+  defaults: Record<string, unknown>;
+  stateDirty: boolean;
+}
+
+const componentInternals = new WeakMap<object, ComponentInternals<object>>();
+
+function getInternals(instance: object): ComponentInternals<object> {
+  const internals = componentInternals.get(instance);
+  if (!internals) {
+    throw new TypeError("Expected a PraxisJS component instance.");
+  }
+  return internals;
+}
+
+export function initComponentInternals(
+  instance: object,
+  props: object,
+): void {
+  componentInternals.set(instance, {
+    rawProps: { ...props },
+    mounted: false,
+    defaults: {},
+    stateDirty: false,
+  });
+}
+
+export function getComponentProps(instance: object): object {
+  return getInternals(instance).rawProps;
+}
+
+export function setComponentProps(
+  instance: object,
+  props: Record<string, unknown>,
+): void {
+  const rawProps = getInternals(instance).rawProps as Record<string, unknown>;
+  Object.keys(rawProps).forEach((key) => {
+    Reflect.deleteProperty(rawProps, key);
+  });
+  Object.assign(rawProps, props);
+}
+
+export function getComponentRawProp(
+  instance: object,
+  name: string,
+): unknown {
+  return (getInternals(instance).rawProps as Record<string, unknown>)[name];
+}
+
+export function getComponentDefault(
+  instance: object,
+  name: string,
+): unknown {
+  return getInternals(instance).defaults[name];
+}
+
+export function setComponentDefault(
+  instance: object,
+  name: string,
+  value: unknown,
+): void {
+  getInternals(instance).defaults[name] = value;
+}
+
+export function getComponentDefaults(
+  instance: object,
+): Record<string, unknown> {
+  return getInternals(instance).defaults;
+}
+
+export function getComponentAnchor(instance: object): Comment | undefined {
+  return getInternals(instance).anchor;
+}
+
+export function setComponentAnchor(
+  instance: object,
+  anchor: Comment | undefined,
+): void {
+  getInternals(instance).anchor = anchor;
+}
+
+export function isComponentMounted(instance: object): boolean {
+  return getInternals(instance).mounted;
+}
+
+export function setComponentMounted(
+  instance: object,
+  mounted: boolean,
+): void {
+  getInternals(instance).mounted = mounted;
+}
+
+export function markStateDirty(instance: object): void {
+  const internals = componentInternals.get(instance);
+  if (internals) {
+    internals.stateDirty = true;
+  }
+}
+
+export function isStateDirty(instance: object): boolean {
+  const internals = componentInternals.get(instance);
+  if (internals) return internals.stateDirty;
+  return false;
+}
+
+export function setStateDirty(
+  instance: object,
+  stateDirty: boolean,
+): void {
+  const internals = componentInternals.get(instance);
+  if (internals) {
+    internals.stateDirty = stateDirty;
+  }
+}

package/src/component/stateful.ts

@@ -2,17 +2,4 @@ import { RootComponent } from "./base";
 
 export 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 = false;
-
-}
+> {}

package/src/component/stateless.ts

@@ -1,10 +1,15 @@
 import type { Children } from "@praxisjs/shared";
 
 import { RootComponent } from "./base";
+import { getComponentProps } from "./internals";
 
 type StatelessComponentType<T> = T & { children?: Children };
 
 export abstract class StatelessComponent<
   T extends object = Record<never, never>,
 > extends RootComponent<StatelessComponentType<T>> {
+  /** Public props API for presentational components. */
+  get props(): StatelessComponentType<T> {
+    return getComponentProps(this) as StatelessComponentType<T>;
+  }
 }

package/src/internal.ts

@@ -19,6 +19,22 @@ export {
   type SyncedSignal,
 } from "./signal";
 export { RootComponent } from "./component";
+export {
+  componentPropsType,
+  getComponentAnchor,
+  getComponentDefault,
+  getComponentDefaults,
+  getComponentProps,
+  getComponentRawProp,
+  isComponentMounted,
+  isStateDirty,
+  markStateDirty,
+  setComponentAnchor,
+  setComponentDefault,
+  setComponentMounted,
+  setComponentProps,
+  setStateDirty,
+} from "./component/internals";
 export {
   resource,
   createResource,