Merge branch 'main' of github.com:gregsdennis/json-everything-docs

gregsdennis · gregsdennis · commit 5cafb6fe7686 · 2024-07-08T09:44:21.000+12:00
diff --git a/_docs/api/JsonPatch.Net/title.md b/_docs/api/JsonPatch.Net/title.md
@@ -4,5 +4,5 @@ bookmark: JsonPatch.Net
 permalink: /api/JsonPatch.Net/:title/
 folder: true
 order: "10.09"
-version: "3.1.0"
+version: "3.1.1"
 ---
diff --git a/_docs/api/JsonPath.Net/NodeListBuilder.md b/_docs/api/JsonPath.Net/NodeListBuilder.md
@@ -0,0 +1,33 @@
+---
+layout: "page"
+title: "NodeListBuilder Class"
+bookmark: "NodeListBuilder"
+permalink: "/api/JsonPath.Net/:title/"
+order: "10.08.018"
+---
+**Namespace:** Json.Path
+
+**Inheritance:**
+`NodeListBuilder`
+ 🡒 
+`object`
+
+Allows collection expression initialization.
+
+## Methods
+
+### Create(ReadOnlySpan\<Node\> values)
+
+Allows collection expression initialization.
+
+#### Declaration
+
+```c#
+public static NodeList Create(ReadOnlySpan<Node> values)
+```
+
+
+#### Returns
+
+
+
diff --git a/_docs/api/JsonPath.Net/NodelistFunctionDefinition.md b/_docs/api/JsonPath.Net/NodelistFunctionDefinition.md
@@ -3,7 +3,7 @@ layout: "page"
 title: "NodelistFunctionDefinition Class"
 bookmark: "NodelistFunctionDefinition"
 permalink: "/api/JsonPath.Net/:title/"
-order: "10.08.018"
+order: "10.08.019"
 ---
 **Namespace:** Json.Path
 
diff --git a/_docs/api/JsonPath.Net/PathEvaluationOptions.md b/_docs/api/JsonPath.Net/PathEvaluationOptions.md
@@ -3,7 +3,7 @@ layout: "page"
 title: "PathEvaluationOptions Class"
 bookmark: "PathEvaluationOptions"
 permalink: "/api/JsonPath.Net/:title/"
-order: "10.08.019"
+order: "10.08.020"
 ---
 **Namespace:** Json.Path
 
diff --git a/_docs/api/JsonPath.Net/PathParseException.md b/_docs/api/JsonPath.Net/PathParseException.md
@@ -3,7 +3,7 @@ layout: "page"
 title: "PathParseException Class"
 bookmark: "PathParseException"
 permalink: "/api/JsonPath.Net/:title/"
-order: "10.08.020"
+order: "10.08.021"
 ---
 **Namespace:** Json.Path
 
diff --git a/_docs/api/JsonPath.Net/PathParsingOptions.md b/_docs/api/JsonPath.Net/PathParsingOptions.md
@@ -3,7 +3,7 @@ layout: "page"
 title: "PathParsingOptions Class"
 bookmark: "PathParsingOptions"
 permalink: "/api/JsonPath.Net/:title/"
-order: "10.08.021"
+order: "10.08.022"
 ---
 **Namespace:** Json.Path
 
diff --git a/_docs/api/JsonPath.Net/PathResult.md b/_docs/api/JsonPath.Net/PathResult.md
@@ -3,7 +3,7 @@ layout: "page"
 title: "PathResult Class"
 bookmark: "PathResult"
 permalink: "/api/JsonPath.Net/:title/"
-order: "10.08.022"
+order: "10.08.023"
 ---
 **Namespace:** Json.Path
 
diff --git a/_docs/api/JsonPath.Net/PathScope.md b/_docs/api/JsonPath.Net/PathScope.md
@@ -3,7 +3,7 @@ layout: "page"
 title: "PathScope Enum"
 bookmark: "PathScope"
 permalink: "/api/JsonPath.Net/:title/"
-order: "10.08.023"
+order: "10.08.024"
 ---
 # PathScope Enum
 
diff --git a/_docs/api/JsonPath.Net/PathSegment.md b/_docs/api/JsonPath.Net/PathSegment.md
@@ -3,7 +3,7 @@ layout: "page"
 title: "PathSegment Class"
 bookmark: "PathSegment"
 permalink: "/api/JsonPath.Net/:title/"
-order: "10.08.024"
+order: "10.08.025"
 ---
 **Namespace:** Json.Path
 
diff --git a/_docs/api/JsonPath.Net/SearchFunction.md b/_docs/api/JsonPath.Net/SearchFunction.md
@@ -3,7 +3,7 @@ layout: "page"
 title: "SearchFunction Class"
 bookmark: "SearchFunction"
 permalink: "/api/JsonPath.Net/:title/"
-order: "10.08.025"
+order: "10.08.026"
 ---
 **Namespace:** Json.Path
 
diff --git a/_docs/api/JsonPath.Net/SliceSelector.md b/_docs/api/JsonPath.Net/SliceSelector.md
@@ -3,7 +3,7 @@ layout: "page"
 title: "SliceSelector Class"
 bookmark: "SliceSelector"
 permalink: "/api/JsonPath.Net/:title/"
-order: "10.08.026"
+order: "10.08.027"
 ---
 **Namespace:** Json.Path
 
diff --git a/_docs/api/JsonPath.Net/ValueFunction.md b/_docs/api/JsonPath.Net/ValueFunction.md
@@ -3,7 +3,7 @@ layout: "page"
 title: "ValueFunction Class"
 bookmark: "ValueFunction"
 permalink: "/api/JsonPath.Net/:title/"
-order: "10.08.027"
+order: "10.08.028"
 ---
 **Namespace:** Json.Path
 
diff --git a/_docs/api/JsonPath.Net/ValueFunctionDefinition.md b/_docs/api/JsonPath.Net/ValueFunctionDefinition.md
@@ -3,7 +3,7 @@ layout: "page"
 title: "ValueFunctionDefinition Class"
 bookmark: "ValueFunctionDefinition"
 permalink: "/api/JsonPath.Net/:title/"
-order: "10.08.028"
+order: "10.08.029"
 ---
 **Namespace:** Json.Path
 
diff --git a/_docs/api/JsonPath.Net/WildcardSelector.md b/_docs/api/JsonPath.Net/WildcardSelector.md
@@ -3,7 +3,7 @@ layout: "page"
 title: "WildcardSelector Class"
 bookmark: "WildcardSelector"
 permalink: "/api/JsonPath.Net/:title/"
-order: "10.08.029"
+order: "10.08.030"
 ---
 **Namespace:** Json.Path
 
diff --git a/_docs/api/JsonPath.Net/title.md b/_docs/api/JsonPath.Net/title.md
@@ -4,5 +4,5 @@ bookmark: JsonPath.Net
 permalink: /api/JsonPath.Net/:title/
 folder: true
 order: "10.08"
-version: "1.1.1"
+version: "1.1.2"
 ---
diff --git a/_docs/api/JsonPointer.Net/title.md b/_docs/api/JsonPointer.Net/title.md
@@ -4,5 +4,5 @@ bookmark: JsonPointer.Net
 permalink: /api/JsonPointer.Net/:title/
 folder: true
 order: "10.10"
-version: "5.0.0"
+version: "5.0.2"
 ---
diff --git a/_docs/api/JsonSchema.Net.Generation.DataAnnotations/AllowedValuesAttributeHandler.md b/_docs/api/JsonSchema.Net.Generation.DataAnnotations/AllowedValuesAttributeHandler.md
@@ -17,34 +17,16 @@ order: "10.06.000"
 - IAttributeHandler\<AllowedValuesAttribute\>
 - IAttributeHandler
 
-Adds an `enum` keyword for the indicated values.
-
-## Remarks
-
-For NativeAOT scenarios, only primitive JSON types are supported.
 
 ## Methods
 
 ### AddConstraints(SchemaGenerationContextBase context, Attribute attribute)
 
-Processes the type and any attributes (present on the context), and adds
-intents to the context.
 
 #### Declaration
 
 ```c#
 public void AddConstraints(SchemaGenerationContextBase context, Attribute attribute)
 ```
 
-| Parameter | Type | Description |
-|---|---|---|
-| context | SchemaGenerationContextBase | The generation context. |
-| attribute | Attribute | The attribute. |
-
-
-#### Remarks
-
-A common pattern is to implement **Json.Schema.Generation.IAttributeHandler** on the
-attribute itself.  In this case, the <paramref name="attribute" /> parameter
-will be the same instance as the handler and can likely be ignored.
 
diff --git a/_docs/api/JsonSchema.Net.Generation.DataAnnotations/Base64StringAttributeAttributeHandler.md b/_docs/api/JsonSchema.Net.Generation.DataAnnotations/Base64StringAttributeAttributeHandler.md
@@ -19,24 +19,4 @@ order: "10.06.001"
 - IAttributeHandler\<Base64StringAttribute\>
 - IAttributeHandler
 
-Adds a `format` keyword with `base64`.
-
-## Remarks
-
-By default, `format` is an annotation only.  No validation will occur unless configured to do so.
-
-The `base64` format is defined by the OpenAPI 3.1 specification.
-
-## Constructors
-
-### Base64StringAttributeAttributeHandler()
-
-Creates a new **Json.Schema.Generation.DataAnnotations.Base64StringAttributeAttributeHandler**.
-
-#### Declaration
-
-```c#
-public Base64StringAttributeAttributeHandler()
-```
-
 
diff --git a/_docs/api/JsonSchema.Net.Generation.DataAnnotations/DeniedValuesAttributeHandler.md b/_docs/api/JsonSchema.Net.Generation.DataAnnotations/DeniedValuesAttributeHandler.md
@@ -17,34 +17,16 @@ order: "10.06.003"
 - IAttributeHandler\<DeniedValuesAttribute\>
 - IAttributeHandler
 
-Adds a `not: {enum}` construct for the indicated values.
-
-## Remarks
-
-For NativeAOT scenarios, only primitive JSON types are supported.
 
 ## Methods
 
 ### AddConstraints(SchemaGenerationContextBase context, Attribute attribute)
 
-Processes the type and any attributes (present on the context), and adds
-intents to the context.
 
 #### Declaration
 
 ```c#
 public void AddConstraints(SchemaGenerationContextBase context, Attribute attribute)
 ```
 
-| Parameter | Type | Description |
-|---|---|---|
-| context | SchemaGenerationContextBase | The generation context. |
-| attribute | Attribute | The attribute. |
-
-
-#### Remarks
-
-A common pattern is to implement **Json.Schema.Generation.IAttributeHandler** on the
-attribute itself.  In this case, the <paramref name="attribute" /> parameter
-will be the same instance as the handler and can likely be ignored.
 
diff --git a/_docs/api/JsonSchema.Net.Generation.DataAnnotations/LengthAttributeHandler.md b/_docs/api/JsonSchema.Net.Generation.DataAnnotations/LengthAttributeHandler.md
@@ -17,34 +17,16 @@ order: "10.06.007"
 - IAttributeHandler\<LengthAttribute\>
 - IAttributeHandler
 
-Adds `minLength` and `maxLength` keywords.
-
-## Remarks
-
-`minLength` will be not be added if the value is less than or equal to zero.
 
 ## Methods
 
 ### AddConstraints(SchemaGenerationContextBase context, Attribute attribute)
 
-Processes the type and any attributes (present on the context), and adds
-intents to the context.
 
 #### Declaration
 
 ```c#
 public void AddConstraints(SchemaGenerationContextBase context, Attribute attribute)
 ```
 
-| Parameter | Type | Description |
-|---|---|---|
-| context | SchemaGenerationContextBase | The generation context. |
-| attribute | Attribute | The attribute. |
-
-
-#### Remarks
-
-A common pattern is to implement **Json.Schema.Generation.IAttributeHandler** on the
-attribute itself.  In this case, the <paramref name="attribute" /> parameter
-will be the same instance as the handler and can likely be ignored.
 
diff --git a/_docs/api/JsonSchema.Net/EvaluationOptions.md b/_docs/api/JsonSchema.Net/EvaluationOptions.md
@@ -19,6 +19,7 @@ Allows configuration of the evaluation process.
 | Name | Type | Summary |
 |---|---|---|
 | **AddAnnotationForUnknownKeywords** | bool | Outputs an annotation that lists any unknown keywords.  Can be useful for catching typos. |
+| **AllowReferencesIntoUnknownKeywords** | bool | Gets or sets whether `$ref` is permitted to navigate into unknown keywords where subschemas aren't expected.  Default is true. |
 | **Culture** | CultureInfo | Gets or sets the culture for error messages.  Overrides **Json.Schema.ErrorMessages.Culture**. |
 | **Default** | EvaluationOptions | The default settings. |
 | **EvaluateAs** | SpecVersion | Indicates which specification version to process as.  This will filter the keywords of a schema based on their support. |
diff --git a/_docs/api/JsonSchema.Net/SchemaRegistry.md b/_docs/api/JsonSchema.Net/SchemaRegistry.md
@@ -90,3 +90,24 @@ public void Register(Uri uri, IBaseDocument document)
 | document | IBaseDocument | The schema. |
 
 
+### RegisterNewSpecVersion(Uri metaSchemaUri, SpecVersion specVersion)
+
+Registers a new meta-schema URI and establishes a new recognized value for the
+**Json.Schema.SpecVersion** enumeration.
+
+#### Declaration
+
+```c#
+public static void RegisterNewSpecVersion(Uri metaSchemaUri, SpecVersion specVersion)
+```
+
+| Parameter | Type | Description |
+|---|---|---|
+| metaSchemaUri | Uri | The meta-schema URI. |
+| specVersion | SpecVersion | The value of the enum to associate with the meta-schema. |
+
+
+#### Remarks
+
+**WARNING** There be dragons here.  Use only if you know what you're doing.
+
diff --git a/_docs/api/JsonSchema.Net/title.md b/_docs/api/JsonSchema.Net/title.md
@@ -4,5 +4,5 @@ bookmark: JsonSchema.Net
 permalink: /api/JsonSchema.Net/:title/
 folder: true
 order: "10.01"
-version: "7.0.4"
+version: "7.1.2"
 ---
diff --git a/_docs/release-notes/rn-json-patch.md b/_docs/release-notes/rn-json-patch.md
@@ -4,6 +4,10 @@ title: JsonPatch.Net
 icon: fas fa-tag
 order: "09.09"
 ---
+# [3.1.1](https://github.com/gregsdennis/json-everything/pull/759) {#release-patch-3.1.1}
+
+Update to use _JsonPointer.Net_ v5.0.2.
+
 # [3.1.0](https://github.com/gregsdennis/json-everything/pull/719) {#release-patch-3.1.0}
 
 Updated to use _JsonPointer.Net_ v5.0.0, which contains breaking changes ([release notes](/rn-json-pointer/#release-pointer-5.0.0)).
diff --git a/_docs/release-notes/rn-json-path.md b/_docs/release-notes/rn-json-path.md
@@ -4,6 +4,11 @@ title: JsonPath.Net
 icon: fas fa-tag
 order: "09.08"
 ---
+# [1.1.2](https://github.com/gregsdennis/json-everything/pull/750) {#release-path-1.1.2}
+
+- Improved parsing to account for a few missed scenarios involving math operations.
+- Greatly improved `.ToString()` to render a re-parsable path.
+
 # [1.1.1](https://github.com/gregsdennis/json-everything/pull/750) {#release-path-1.1.1}
 
 [JSON Path Test Suite #83](https://github.com/jsonpath-standard/jsonpath-compliance-test-suite/pull/83) - Fixes some order of operations issues with parsing filter expressions with boolean operators.
diff --git a/_docs/release-notes/rn-json-pointer.md b/_docs/release-notes/rn-json-pointer.md
@@ -4,6 +4,14 @@ title: JsonPointer.Net
 icon: fas fa-tag
 order: "09.10"
 ---
+# [5.0.2](https://github.com/gregsdennis/json-everything/pull/759) {#release-pointer-5.0.2}
+
+Fixed a problem with `.ToString()` where pointers constructed using `JsonPointer.Create()` would not properly escape segments.
+
+# [5.0.1](https://github.com/gregsdennis/json-everything/pull/757) {#release-pointer-5.0.1}
+
+For some reason v5.0.0 was missing two methods: `.GetAncestor()` and `.GetLocal()`.  This is a republish to include those methods.
+
 # [5.0.0](https://github.com/gregsdennis/json-everything/pull/719) {#release-pointer-5.0.0}
 
 Complete overhaul of `JsonPointer` to reduce memory usage for consuming applications.
diff --git a/_docs/release-notes/rn-json-schema.md b/_docs/release-notes/rn-json-schema.md
@@ -4,6 +4,18 @@ title: JsonSchema.Net
 icon: fas fa-tag
 order: "09.01"
 ---
+# [7.1.2](https://github.com/gregsdennis/json-everything/pull/759) {#release-schema-7.1.2}
+
+Update to use _JsonPointer.Net_ v5.0.2.
+
+# [7.1.1](https://github.com/gregsdennis/json-everything/pull/755) {#release-schema-7.1.1}
+
+Added a backdoor to allow Graeae to support draft 4 schemas.
+
+# [7.1.0](https://github.com/gregsdennis/json-everything/pull/752) {#release-schema-7.1.0}
+
+Adds `EvaluationOptions.AllowReferencesIntoUnknownKeywords` to optionally disallow `$ref` navigation into unknown keywords.
+
 # [7.0.4](https://github.com/gregsdennis/json-everything/pull/746) {#release-schema-7.0.4}
 
 `minContains` and `maxContains` annotations were still being discovered by `contains` when validating as Draft 6/7 even though `minContains` and `maxContains` are Draft 2019-90+ keywords. 
