@signaltree/ng-forms 9.2.1 → 9.3.0

package/README.md

@@ -25,7 +25,30 @@ SignalTree provides a layered forms architecture:
 
 **Key insight**: `form()` is self-sufficient. `formBridge()` adds Angular-specific capabilities.
 
-## Quick Start (Recommended Pattern)
+## Quick Start
+
+### Standalone signal-form pattern
+
+```typescript
+import { signalTree, form } from '@signaltree/core';
+import { email } from '@signaltree/ng-forms';
+
+const tree = signalTree({
+  login: form({
+    initial: { email: '', password: '' },
+    validators: { email: email() },
+  }),
+});
+
+tree.$.login.$.email.set('user@test.com');
+tree.$.login.valid();
+tree.$.login.validate();
+```
+
+This is the smallest working setup. It uses only `form()` and keeps everything
+in signal land.
+
+### Angular bridge pattern (recommended when you need `FormGroup` interop)
 
 ```typescript
 import { signalTree, form } from '@signaltree/core';
@@ -72,6 +95,9 @@ class CheckoutComponent {
 }
 ```
 
+This example is intentionally wider in scope than the standalone one because it
+adds Angular `FormGroup` interop via `formBridge()`.
+
 ## When to Use Each Layer
 
 ### form() alone (no ng-forms needed)

package/dist/signals/bridge.js

@@ -0,0 +1,33 @@
+import { validateStandardSchema, form } from '@angular/forms/signals';
+import { toWritableSignal } from '@signaltree/core';
+
+function applySignalTreeSchemas(fieldRoot, tree, rootPath = '') {
+  const bound = tree.schemas.boundPaths();
+  const prefix = rootPath ? rootPath + '.' : '';
+  for (const fullPath of bound) {
+    if (rootPath && !fullPath.startsWith(prefix) && fullPath !== rootPath) {
+      continue;
+    }
+    const subPath = rootPath ? fullPath.slice(prefix.length) : fullPath;
+    if (!subPath) continue;
+    const schema = tree.schemas.schemaFor(fullPath);
+    if (!schema) continue;
+    const segments = subPath.split('.');
+    let cursor = fieldRoot;
+    for (const seg of segments) {
+      if (cursor === null || cursor === undefined) break;
+      if (typeof cursor !== 'object' && typeof cursor !== 'function') break;
+      cursor = cursor[seg];
+    }
+    if (cursor === null || cursor === undefined) continue;
+    validateStandardSchema(cursor, schema);
+  }
+}
+function signalFormBridge(tree, rootPath, subtree) {
+  const writable = toWritableSignal(subtree);
+  return form(writable, fieldRoot => {
+    applySignalTreeSchemas(fieldRoot, tree, rootPath);
+  });
+}
+
+export { applySignalTreeSchemas, signalFormBridge };

package/dist/signals/index.js

@@ -0,0 +1 @@
+export { applySignalTreeSchemas, signalFormBridge } from './bridge.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaltree/ng-forms",
-  "version": "9.2.1",
+  "version": "9.3.0",
   "description": "Angular forms as reactive JSON. Seamless SignalTree integration with FormTree creation, validators, and form state tracking.",
   "license": "MIT",
   "type": "module",
@@ -15,20 +15,35 @@
       "default": "./dist/index.js"
     },
     "./audit": {
-      "types": "./src/audit/index.d.ts",
-      "import": "./dist/audit/index.js",
-      "default": "./dist/audit/index.js"
+      "types": "./src/audit/audit.d.ts",
+      "import": "./dist/audit/audit.js",
+      "default": "./dist/audit/audit.js"
+    },
+    "./signals": {
+      "types": "./src/signals/index.d.ts",
+      "import": "./dist/signals/index.js",
+      "default": "./dist/signals/index.js"
     }
   },
   "peerDependencies": {
-    "@angular/core": "^20.0.0 || ^21.0.0",
-    "@angular/forms": "^20.0.0 || ^21.0.0",
+    "@angular/core": "^20.0.0 || ^21.0.0 || ^22.0.0",
+    "@angular/forms": "^20.0.0 || ^21.0.0 || ^22.0.0",
     "@signaltree/core": "workspace:*",
+    "@signaltree/schema": "workspace:*",
+    "@standard-schema/spec": "^1.0.0",
     "rxjs": "^7.0.0"
   },
-  "peerDependenciesMeta": {},
+  "peerDependenciesMeta": {
+    "@signaltree/schema": {
+      "optional": true
+    },
+    "@standard-schema/spec": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@signaltree/core": "workspace:*",
+    "@signaltree/schema": "workspace:*",
     "@signaltree/shared": "workspace:*",
     "jest-preset-angular": "^15.0.3"
   },

package/src/angular-22-shims.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Ambient type shim for Angular 22 Signal Forms.
+ *
+ * The bridge in this directory imports from `@angular/forms/signals`, which
+ * is a subpath that only exists in `@angular/forms@22.0.0+`. TypeScript's
+ * classic node resolution does not follow `exports` fields in package.json,
+ * so we declare a minimal ambient module here. At the user's install site
+ * (assuming they have `@angular/forms@22+` installed), this shim is shadowed
+ * by the real types.
+ *
+ * The shim deliberately uses permissive types so the bridge compiles without
+ * coupling to internal Signal Forms type machinery (which is still evolving
+ * in 22.x RCs). The bridge is type-safe at its API surface; internals are
+ * navigated via runtime property access.
+ *
+ * @internal
+ */
+declare module '@angular/forms/signals' {
+  import type { WritableSignal } from '@angular/core';
+  import type { StandardSchemaV1 } from '@standard-schema/spec';
+
+  /** Re-shape of Angular 22's `form()` factory (subset). */
+  export function form<TModel>(
+    model: WritableSignal<TModel>,
+    schemaFn?: (fieldRoot: unknown) => void,
+  ): unknown;
+
+  /** Re-shape of Angular 22's `validateStandardSchema()`. */
+  export function validateStandardSchema(
+    path: unknown,
+    schema: StandardSchemaV1<unknown> | unknown,
+  ): void;
+
+  /** Re-shape of Angular 22's `applyEach()` for arrays. */
+  export function applyEach(
+    path: unknown,
+    schema: unknown,
+  ): void;
+}

package/src/signals/bridge.d.ts

@@ -0,0 +1,4 @@
+import { type ISignalTree } from '@signaltree/core';
+import type { SchemaMethods } from '@signaltree/schema';
+export declare function applySignalTreeSchemas(fieldRoot: unknown, tree: ISignalTree<unknown> & SchemaMethods, rootPath?: string): void;
+export declare function signalFormBridge<TModel>(tree: ISignalTree<unknown> & SchemaMethods, rootPath: string, subtree: unknown): unknown;

package/src/signals/index.d.ts

@@ -0,0 +1 @@
+export { signalFormBridge, applySignalTreeSchemas } from './bridge';

package/dist/audit/index.js

@@ -1 +0,0 @@
-export { createAuditCallback, createAuditTracker } from './audit.js';