@molecule/app-angular 1.0.3 → 1.0.4

package/README.md

@@ -3,7 +3,7 @@ AUTO-GENERATED — DO NOT EDIT THIS FILE.
 Generated by `mlcl sync-docs` from the package's src/index.ts JSDoc + mlcl/registry.json.
 Edits here are overwritten on the next commit (molecule's pre-commit hook regenerates).
 To change this document, edit the module-level JSDoc in src/index.ts.
-Generated: 2026-10-21T17:02:30.648Z
+Generated: 2026-10-23T15:23:09.411Z
 -->
 
 # @molecule/app-angular
@@ -147,6 +147,15 @@ interface AuthClient<T = UserProfile, TRegister extends RegisterExtraShape<TRegi
      * Gets the current user.
      */
     getUser(): T | null;
+    /**
+     * Optional ownership marker for the current session. Compare values only within
+     * this client: replacing or ending a session changes it, including re-adopting
+     * the same token and user. Profile updates and same-session refreshes keep it.
+     * Consumers can use it to discard stale async work without treating editable
+     * user fields as an immutable account identifier. Providers without this
+     * capability require the consumer's own stable identity check.
+     */
+    getSessionRevision?(): number;
     /**
      * Updates the cached user object (state + persistent storage) without
      * hitting the network. Intended for local refreshes after a per-app
@@ -221,6 +230,9 @@ interface AuthClient<T = UserProfile, TRegister extends RegisterExtraShape<TRegi
     confirmPasswordReset(data: PasswordResetConfirm): Promise<void>;
     /**
      * Updates the current user's profile.
+     * Returns the saved response. If the session is explicitly replaced or ended
+     * while the request is pending, that response does not replace the current
+     * session's user or persisted cache.
      */
     updateProfile(data: Partial<T>): Promise<T>;
     /**
@@ -279,16 +291,6 @@ interface AuthClient<T = UserProfile, TRegister extends RegisterExtraShape<TRegi
      * Resolves IMMEDIATELY when no restore is in flight: before `initialize()` is ever
      * called, and after it has finished. A restore that failed resolves too (it settled the
      * question), so an HTTP client can await this before every request without risking one
-     * held forever. That is what makes the fetch-before-restore race impossible: a page that
-     * fetches viewer-dependent data on mount waits here instead of going out anonymously
-     * (see `setAuthGate` in `@molecule/app-http`).
-     *
-     * Optional: a provider that restores no session has nothing to wait for. Without it, an
-     * HTTP client bonded to that provider sends first-paint requests unauthenticated.
-     *
-     * A provider whose restore sends a request THROUGH the gated HTTP client must send that
-     * request with `skipAuthGate: true` (`RequestConfig` in `@molecule/app-http`): the gate
-     * waits on this promise, so holding the restore's own request makes the gate wait on
 // … truncated — the full declaration is in node_modules/@molecule/app-angular/dist
 ```
 
@@ -371,7 +373,13 @@ interface FormController<T extends Record<string, unknown> = Record<string, unkn
    */
   validate(): Promise<boolean>
   /**
-   * Resets the form to initial values.
+   * Resets the form and clears errors, touched fields and submission state.
+   *
+   * With no argument it restores the current baseline — the initial
+   * `defaultValues`, or the values a previous `reset(values)` established.
+   * Passing `values` merges them over the current baseline and makes the
+   * result the new baseline, so a form reset to freshly loaded or saved data
+   * reads clean (`isDirty === false`).
    */
   reset(values?: Partial<T>): void
   /**
@@ -403,7 +411,8 @@ Form creation options.
 ```typescript
 interface FormOptions<T extends Record<string, unknown>> {
   /**
-   * Default values.
+   * Default values, captured as the form's clean baseline when the controller
+   * is created. Mutating this object afterwards does not change the baseline.
    */
   defaultValues?: Partial<T>
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@molecule/app-angular",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Angular framework bindings for molecule.dev",
   "type": "module",
   "main": "dist/index.js",
@@ -40,14 +40,14 @@
     "rxjs": "^7.8.0"
   },
   "devDependencies": {
-    "@angular/compiler": "22.1.6",
-    "@angular/compiler-cli": "22.1.6",
-    "@angular/core": "22.1.6",
-    "@molecule/app-utilities": "1.0.4",
-    "@types/node": "26.1.2",
+    "@angular/compiler": "22.2.3",
+    "@angular/compiler-cli": "22.2.3",
+    "@angular/core": "22.2.3",
+    "@molecule/app-utilities": "1.0.5",
+    "@types/node": "26.6.5",
     "rxjs": "7.8.2",
     "typescript": "6.0.3",
-    "vitest": "4.1.11"
+    "vitest": "4.1.12"
   },
   "repository": {
     "type": "git",