@blac/core 2.0.21 → 2.0.22

package/dist/core/meta.d.ts

@@ -1,25 +1,35 @@
 /**
  * `$blac` meta namespace for `StateContainer`.
  *
- * Getters/methods here close over the *real* container instance captured at
- * `createMeta` time rather than reading a `this`-receiver. `buildTrackedProxy`
- * no longer uses a `this`-Proxy (getters run with `this` = the real instance),
- * so ES `#private` is safe here now; the closure style is kept because it also
- * keeps this own, frozen property independent of the proxy entirely.
+ * `BlacMeta` and `BlacHydration` are classes whose accessors live on the
+ * prototype and read the container through one `#private` back-reference, so
+ * a container allocates a single small object here instead of a literal with
+ * seven closures. Members are therefore not own-enumerable: `Object.keys` and
+ * `JSON.stringify` see an empty object. Read the fields by name.
  */
 import type { HydrationStatus } from './StateContainer';
 import type { StateContainerConstructor } from '../types/utilities';
+/**
+ * Non-enumerable brand carried on every `$blac` object. Used by the clobber
+ * guard in `StateContainer` to detect a subclass class-field shadowing the
+ * base's own `$blac` property, and by the meta tests. Intentionally NOT
+ * re-exported from the package barrel.
+ */
+export declare const META_BRAND: unique symbol;
 /**
  * Hydration sub-surface of {@link BlacMeta}. Exposes the container's
  * hydration state machine — the `begin`/`apply`/`finish`/`fail`/`wait`
  * methods and the `status`/`error`/`isHydrated`/`changedWhileHydrating`
  * getters — namespaced under `$blac`.
  */
-export interface BlacHydration<S extends object> {
-    readonly status: HydrationStatus;
-    readonly error: Error | undefined;
-    readonly isHydrated: boolean;
-    readonly changedWhileHydrating: boolean;
+export declare class BlacHydration<S extends object> {
+    #private;
+    /** @internal */
+    constructor(container: object);
+    get status(): HydrationStatus;
+    get error(): Error | undefined;
+    get isHydrated(): boolean;
+    get changedWhileHydrating(): boolean;
     begin(): void;
     apply(next: S): boolean;
     finish(): void;
@@ -32,36 +42,19 @@ export interface BlacHydration<S extends object> {
  * `createdAt`, `disposed`, `dependencies`, and the hydration methods) under one
  * namespace, keeping the generic names free for userland blocs.
  *
- * The object is allocated once per container, frozen, branded, and exposes
- * live getters that read the container's current `_`-private fields — values
- * are never snapshotted.
+ * Allocated once per container and frozen. Every accessor reads the
+ * container's current `_`-private fields live — values are never snapshotted.
  */
-export interface BlacMeta<S extends object = any> {
-    readonly name: string;
-    readonly id: string;
-    readonly debug: boolean;
-    readonly createdAt: number;
-    readonly disposed: boolean;
-    readonly dependencies: ReadonlyMap<StateContainerConstructor, string>;
-    readonly hydration: BlacHydration<S>;
+export declare class BlacMeta<S extends object = any> {
+    #private;
+    /** @internal Called from the `StateContainer` field initializer. */
+    constructor(container: object);
+    get name(): string;
+    get id(): string;
+    get debug(): boolean;
+    get createdAt(): number;
+    get disposed(): boolean;
+    get dependencies(): ReadonlyMap<StateContainerConstructor, string>;
+    /** Built on first access; identity-stable afterwards. */
+    get hydration(): BlacHydration<S>;
 }
-/**
- * Non-enumerable brand carried on every `$blac` object produced by
- * {@link createMeta}. Used by the clobber guard in `StateContainer` to detect
- * a subclass class-field shadowing the base's own `$blac` property, and by the
- * meta tests. Intentionally NOT re-exported from the package barrel.
- */
-export declare const META_BRAND: unique symbol;
-/**
- * Build the frozen, branded `$blac` meta object for a container.
- *
- * Called from a `StateContainer` field initializer (`$blac = createMeta(this)`).
- * Only the back-reference is captured at this point; every getter/method reads
- * the container's `_`-private fields lazily on access, so field-initializer
- * ordering relative to those private fields is irrelevant.
- *
- * The getters close over `container` (the real instance), never over a
- * `this`-receiver — this is what keeps `$blac` reads safe through
- * `buildTrackedProxy`.
- */
-export declare function createMeta<S extends object>(container: object): BlacMeta<S>;