Update docs

Author: multum

CHANGELOG.md

@@ -1,11 +1,20 @@
+## 3.5.0
+
+#### Enhancement
+
+- add new **interpolation syntax** for using variables in schemas
+
+#### Internal
+
+- improve test :gem:
+
 ## 3.4.0
 
 #### Enhancement
 
 - significantly improve **identity column** update. You can now increase the minimum value and decrease the maximum value
 - add reset `search_path` to `public` value for more accurate reading of database metadata
 
-
 #### Bug Fix
 
 - add removal of **serial sequence** before setting `column.identity` property. Fix [#96](https://github.com/multum/pg-differ/issues/96)

docs/import.md

@@ -22,7 +22,7 @@ Regular expression to filter folder files
 - Default: `/\${([\s\S]+?)}/g`
 - Required: `false`
 
-The 'interpolate' delimiter
+[Deprecated] The 'interpolate' delimiter
 
 ### locals
 
@@ -31,3 +31,31 @@ The 'interpolate' delimiter
 - Required: `false`
 
 An object to import into the `*.json` files as locals
+
+```javascript
+// index.js
+differ.import({
+  path: 'objects/role.schema.json',
+  locals: {
+    schema: 'public',
+    sequenceOptions: { min: 1000, start: 1000 },
+  },
+});
+```
+
+```json5
+// objects/role.schema.json
+{
+  type: 'table',
+  properties: {
+    name: '${schema}.role', // using a variable as part of a string
+    columns: {
+      id: {
+        type: 'int',
+        identity: { $: 'sequenceOptions' }, // using a variable as JSON data
+      },
+      // ...
+    },
+  },
+}
+```