[docs] Add Merger page, replace deprecated methods

Author: x0k

.changeset/eleven-experts-bathe.md

@@ -0,0 +1,5 @@
+---
+"docs": patch
+---
+
+Add `Merger` page, replace deprecated methods

apps/docs/src/content/docs/advanced/form-base.mdx

@@ -34,9 +34,10 @@ You should calculate initial value by yourself.
 
 ```svelte
 <script lang="ts">
-  import { FormBase, getDefaultFormState } from "@sjsf/form";
+  import { FormBase } from "@sjsf/form";
   import { translation } from "@sjsf/form/translations/en";
   import { theme } from "@sjsf/form/basic-theme";
+  import { getDefaultFormState } from '@sjsf/form/get-default-form-state';
 
   import { schema, uiSchema, initialData } from "./schema";
   import { validator } from "./validator";

apps/docs/src/content/docs/advanced/state-transformation.mdx

@@ -25,26 +25,28 @@ It will be replaced with `@sjsf/form/omit-extra-data` import in the major releas
 
 ```svelte
 <script lang="ts">
-  import { Form } from "@sjsf/form";
+  import { Form, DefaultMerger } from "@sjsf/form";
   import { translation } from "@sjsf/form/translations/en";
   import { theme } from "@sjsf/form/basic-theme";
-  import { omitExtraData } from "@sjsf/form/legacy-omit-extra-data";
+  import { omitExtraData2 } from "@sjsf/form/legacy-omit-extra-data";
 
   import { schema, uiSchema, initialData } from "./schema";
   import { validator } from "./validator";
   import { transform } from "./transform";
 
+  const merger = new DefaultMerger(validator, schema);
   let value = $state();
 </script>
 
 <Form
   bind:value
   {...theme}
+  {merger}
   {schema}
   {uiSchema}
   {validator}
   {translation}
-  getSnapshot={() => omitExtraData(validator, schema, $state.snapshot(value))}
+  getSnapshot={() => omitExtraData2(validator, merger, schema, $state.snapshot(value))}
   onSubmit={(value) => {
     console.log("transformed", value);
   }}

apps/docs/src/content/docs/api-reference/handlers.mdx

@@ -1,7 +1,7 @@
 ---
 title: Handlers
 sidebar:
-  order: 9
+  order: 10
 ---
 
 ```typescript

apps/docs/src/content/docs/api-reference/icons.mdx

@@ -1,7 +1,7 @@
 ---
 title: Icons
 sidebar:
-  order: 11
+  order: 12
 ---
 
 ```typescript

apps/docs/src/content/docs/api-reference/inputs-validation-mode.mdx

@@ -1,7 +1,7 @@
 ---
 title: Inputs validation mode
 sidebar:
-  order: 10
+  order: 11
 ---
 
 ```typescript

apps/docs/src/content/docs/api-reference/merger.mdx

@@ -0,0 +1,21 @@
+---
+title: Merger
+sidebar:
+  order: 8
+---
+
+```typescript
+export interface Merger {
+  /**
+   * Merges schema and its `allOf` schemas into a single schema
+   */
+  mergeAllOf(schema: Schema): Schema;
+  /**
+   * Merges defaults of `schema` into `formData`
+   */
+  mergeFormDataAndSchemaDefaults(
+    formData: SchemaValue | undefined,
+    schema: Schema
+  ): SchemaValue | undefined;
+}
+```

apps/docs/src/content/docs/api-reference/translation.mdx

@@ -1,7 +1,7 @@
 ---
 title: Translation
 sidebar:
-  order: 8
+  order: 9
 ---
 
 ## Labels list