wip

Mr-Leshiy · Mr-Leshiy · commit d0cffbd4e84a · 2025-09-04T21:13:38.000+04:00
diff --git a/docs/src/architecture/08_concepts/signed_doc/docs/brand_parameters.md b/docs/src/architecture/08_concepts/signed_doc/docs/brand_parameters.md
@@ -53,7 +53,7 @@ This section will be included and updated in future iterations.
 ## [COSE Header Parameters][RFC9052-HeaderParameters]
 
 * [content type](../spec.md#content-type) = `application/json`
-* [content-encoding](../spec.md#content-encoding) = `br`
+* [content-encoding](../spec.md#content-encoding) = `[br]`
 
 ## Metadata
 
diff --git a/docs/src/architecture/08_concepts/signed_doc/docs/brand_parameters_form_template.md b/docs/src/architecture/08_concepts/signed_doc/docs/brand_parameters_form_template.md
@@ -58,7 +58,7 @@ This section will be included and updated in future iterations.
 ## [COSE Header Parameters][RFC9052-HeaderParameters]
 
 * [content type](../spec.md#content-type) = `application/schema+json`
-* [content-encoding](../spec.md#content-encoding) = `br`
+* [content-encoding](../spec.md#content-encoding) = `[br]`
 
 ## Metadata
 
diff --git a/docs/src/architecture/08_concepts/signed_doc/docs/campaign_parameters.md b/docs/src/architecture/08_concepts/signed_doc/docs/campaign_parameters.md
@@ -54,7 +54,7 @@ This section will be included and updated in future iterations.
 ## [COSE Header Parameters][RFC9052-HeaderParameters]
 
 * [content type](../spec.md#content-type) = `application/json`
-* [content-encoding](../spec.md#content-encoding) = `br`
+* [content-encoding](../spec.md#content-encoding) = `[br]`
 
 ## Metadata
 
diff --git a/docs/src/architecture/08_concepts/signed_doc/docs/campaign_parameters_form_template.md b/docs/src/architecture/08_concepts/signed_doc/docs/campaign_parameters_form_template.md
@@ -58,7 +58,7 @@ This section will be included and updated in future iterations.
 ## [COSE Header Parameters][RFC9052-HeaderParameters]
 
 * [content type](../spec.md#content-type) = `application/schema+json`
-* [content-encoding](../spec.md#content-encoding) = `br`
+* [content-encoding](../spec.md#content-encoding) = `[br]`
 
 ## Metadata
 
diff --git a/docs/src/architecture/08_concepts/signed_doc/docs/category_parameters.md b/docs/src/architecture/08_concepts/signed_doc/docs/category_parameters.md
@@ -54,7 +54,7 @@ This section will be included and updated in future iterations.
 ## [COSE Header Parameters][RFC9052-HeaderParameters]
 
 * [content type](../spec.md#content-type) = `application/json`
-* [content-encoding](../spec.md#content-encoding) = `br`
+* [content-encoding](../spec.md#content-encoding) = `[br]`
 
 ## Metadata
 
diff --git a/docs/src/architecture/08_concepts/signed_doc/docs/category_parameters_form_template.md b/docs/src/architecture/08_concepts/signed_doc/docs/category_parameters_form_template.md
@@ -58,7 +58,7 @@ This section will be included and updated in future iterations.
 ## [COSE Header Parameters][RFC9052-HeaderParameters]
 
 * [content type](../spec.md#content-type) = `application/schema+json`
-* [content-encoding](../spec.md#content-encoding) = `br`
+* [content-encoding](../spec.md#content-encoding) = `[br]`
 
 ## Metadata
 
diff --git a/docs/src/architecture/08_concepts/signed_doc/docs/comment_moderation_action.md b/docs/src/architecture/08_concepts/signed_doc/docs/comment_moderation_action.md
@@ -39,7 +39,7 @@ This section will be included and updated in future iterations.
 ## [COSE Header Parameters][RFC9052-HeaderParameters]
 
 * [content type](../spec.md#content-type) = `application/json`
-* [content-encoding](../spec.md#content-encoding) = `br`
+* [content-encoding](../spec.md#content-encoding) = `[br]`
 
 ## Metadata
 
diff --git a/docs/src/architecture/08_concepts/signed_doc/docs/contest_parameters.md b/docs/src/architecture/08_concepts/signed_doc/docs/contest_parameters.md
@@ -54,7 +54,7 @@ This section will be included and updated in future iterations.
 ## [COSE Header Parameters][RFC9052-HeaderParameters]
 
 * [content type](../spec.md#content-type) = `application/json`
-* [content-encoding](../spec.md#content-encoding) = `br`
+* [content-encoding](../spec.md#content-encoding) = `[br]`
 
 ## Metadata
 
diff --git a/docs/src/architecture/08_concepts/signed_doc/docs/contest_parameters_form_template.md b/docs/src/architecture/08_concepts/signed_doc/docs/contest_parameters_form_template.md
@@ -58,7 +58,7 @@ This section will be included and updated in future iterations.
 ## [COSE Header Parameters][RFC9052-HeaderParameters]
 
 * [content type](../spec.md#content-type) = `application/schema+json`
-* [content-encoding](../spec.md#content-encoding) = `br`
+* [content-encoding](../spec.md#content-encoding) = `[br]`
 
 ## Metadata
 
diff --git a/docs/src/architecture/08_concepts/signed_doc/docs/presentation_template.md b/docs/src/architecture/08_concepts/signed_doc/docs/presentation_template.md
@@ -56,7 +56,7 @@ This section will be included and updated in future iterations.
 ## [COSE Header Parameters][RFC9052-HeaderParameters]
 
 * [content type](../spec.md#content-type) = `application/schema+json`
-* [content-encoding](../spec.md#content-encoding) = `br`
+* [content-encoding](../spec.md#content-encoding) = `[br]`
 
 ## Metadata
 
diff --git a/docs/src/architecture/08_concepts/signed_doc/docs/proposal.md b/docs/src/architecture/08_concepts/signed_doc/docs/proposal.md
@@ -62,7 +62,7 @@ Before accepting a new proposal to be published, the backend will ensure:
 ## [COSE Header Parameters][RFC9052-HeaderParameters]
 
 * [content type](../spec.md#content-type) = `application/json`
-* [content-encoding](../spec.md#content-encoding) = `br`
+* [content-encoding](../spec.md#content-encoding) = `[br]`
 
 ## Metadata
 
diff --git a/docs/src/architecture/08_concepts/signed_doc/docs/proposal_comment.md b/docs/src/architecture/08_concepts/signed_doc/docs/proposal_comment.md
@@ -46,7 +46,7 @@ and the integrity of the [`ref`](../metadata.md#ref) and [`reply`](../metadata.m
 ## [COSE Header Parameters][RFC9052-HeaderParameters]
 
 * [content type](../spec.md#content-type) = `application/json`
-* [content-encoding](../spec.md#content-encoding) = `br`
+* [content-encoding](../spec.md#content-encoding) = `[br]`
 
 ## Metadata
 
diff --git a/docs/src/architecture/08_concepts/signed_doc/docs/proposal_comment_form_template.md b/docs/src/architecture/08_concepts/signed_doc/docs/proposal_comment_form_template.md
@@ -58,7 +58,7 @@ This section will be included and updated in future iterations.
 ## [COSE Header Parameters][RFC9052-HeaderParameters]
 
 * [content type](../spec.md#content-type) = `application/schema+json`
-* [content-encoding](../spec.md#content-encoding) = `br`
+* [content-encoding](../spec.md#content-encoding) = `[br]`
 
 ## Metadata
 
diff --git a/docs/src/architecture/08_concepts/signed_doc/docs/proposal_form_template.md b/docs/src/architecture/08_concepts/signed_doc/docs/proposal_form_template.md
@@ -58,7 +58,7 @@ This section will be included and updated in future iterations.
 ## [COSE Header Parameters][RFC9052-HeaderParameters]
 
 * [content type](../spec.md#content-type) = `application/schema+json`
-* [content-encoding](../spec.md#content-encoding) = `br`
+* [content-encoding](../spec.md#content-encoding) = `[br]`
 
 ## Metadata
 
diff --git a/docs/src/architecture/08_concepts/signed_doc/docs/proposal_moderation_action.md b/docs/src/architecture/08_concepts/signed_doc/docs/proposal_moderation_action.md
@@ -39,7 +39,7 @@ This section will be included and updated in future iterations.
 ## [COSE Header Parameters][RFC9052-HeaderParameters]
 
 * [content type](../spec.md#content-type) = `application/json`
-* [content-encoding](../spec.md#content-encoding) = `br`
+* [content-encoding](../spec.md#content-encoding) = `[br]`
 
 ## Metadata
 
diff --git a/docs/src/architecture/08_concepts/signed_doc/docs/proposal_submission_action.md b/docs/src/architecture/08_concepts/signed_doc/docs/proposal_submission_action.md
@@ -70,7 +70,7 @@ is not considered `final` and will not be considered in the category it was bein
 ## [COSE Header Parameters][RFC9052-HeaderParameters]
 
 * [content type](../spec.md#content-type) = `application/json`
-* [content-encoding](../spec.md#content-encoding) = `br`
+* [content-encoding](../spec.md#content-encoding) = `[br]`
 
 ## Metadata
 
diff --git a/docs/src/architecture/08_concepts/signed_doc/docs/rep_nomination.md b/docs/src/architecture/08_concepts/signed_doc/docs/rep_nomination.md
@@ -88,7 +88,7 @@ to re-delegate to affirm the delegates latest nomination.
 ## [COSE Header Parameters][RFC9052-HeaderParameters]
 
 * [content type](../spec.md#content-type) = `application/json`
-* [content-encoding](../spec.md#content-encoding) = `br`
+* [content-encoding](../spec.md#content-encoding) = `[br]`
 
 ## Metadata
 
diff --git a/docs/src/architecture/08_concepts/signed_doc/docs/rep_nomination_form_template.md b/docs/src/architecture/08_concepts/signed_doc/docs/rep_nomination_form_template.md
@@ -58,7 +58,7 @@ This section will be included and updated in future iterations.
 ## [COSE Header Parameters][RFC9052-HeaderParameters]
 
 * [content type](../spec.md#content-type) = `application/schema+json`
-* [content-encoding](../spec.md#content-encoding) = `br`
+* [content-encoding](../spec.md#content-encoding) = `[br]`
 
 ## Metadata
 
diff --git a/docs/src/architecture/08_concepts/signed_doc/docs/rep_profile.md b/docs/src/architecture/08_concepts/signed_doc/docs/rep_profile.md
@@ -43,7 +43,7 @@ The payload of a profile is controlled by its template.
 ## [COSE Header Parameters][RFC9052-HeaderParameters]
 
 * [content type](../spec.md#content-type) = `application/json`
-* [content-encoding](../spec.md#content-encoding) = `br`
+* [content-encoding](../spec.md#content-encoding) = `[br]`
 
 ## Metadata
 
diff --git a/docs/src/architecture/08_concepts/signed_doc/docs/rep_profile_form_template.md b/docs/src/architecture/08_concepts/signed_doc/docs/rep_profile_form_template.md
@@ -58,7 +58,7 @@ This section will be included and updated in future iterations.
 ## [COSE Header Parameters][RFC9052-HeaderParameters]
 
 * [content type](../spec.md#content-type) = `application/schema+json`
-* [content-encoding](../spec.md#content-encoding) = `br`
+* [content-encoding](../spec.md#content-encoding) = `[br]`
 
 ## Metadata
 
diff --git a/docs/src/architecture/08_concepts/signed_doc/spec.md b/docs/src/architecture/08_concepts/signed_doc/spec.md
@@ -404,6 +404,14 @@ Supported HTTP Encodings of the Payload
     <td class="gt_row gt_left">HTTP Content Encoding</td>
     <td class="gt_row gt_left">Encoding, if any, of the payload.</td>
   </tr>
+  <tr class="gt_group_heading_row">
+    <th class="gt_group_heading" colspan="3">Supported Values</th>
+  </tr>
+  <tr>
+    <th class="gt_row gt_left gt_stub"></th>
+    <td class="gt_row gt_left gt_striped"><a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Encoding#br">br</a></td>
+    <td class="gt_row gt_left gt_striped"><a href="https://www.rfc-editor.org/rfc/rfc7932">BROTLI</a> Compression</td>
+  </tr>
 </tbody>
 
 
diff --git a/specs/definitions/media_types/encoding.cue b/specs/definitions/media_types/encoding.cue
@@ -16,4 +16,3 @@ encodingTypes: br: description: "BROTLI Compression"
 allContentEncoding: list.Sort([
 	for k, _ in encodingTypes {k},
 ], list.Ascending)
-#allContentEncodingConstraint: or(allContentEncoding)
diff --git a/specs/definitions/signed_docs/cose_headers.cue b/specs/definitions/signed_docs/cose_headers.cue
@@ -60,7 +60,7 @@ cose: headerFormats: #metadataFormats & {
 		}
 
 		if format == "HTTP Content Encoding" {
-			value: media_types.#allContentEncodingConstraint
+			value: media_types.allContentEncoding
 		}
 	}
 }
diff --git a/specs/definitions/signed_docs/docs/contest_delegation.cue b/specs/definitions/signed_docs/docs/contest_delegation.cue
@@ -73,7 +73,7 @@ docs: "Contest Delegation": {
 			  There is no payload.
 			"""
 
-		required: "excluded"
+		nil: true
 	}
 
 	signers: roles: user: [
diff --git a/specs/definitions/signed_docs/payload.cue b/specs/definitions/signed_docs/payload.cue
@@ -18,11 +18,11 @@ import (
 _payload: {
 	// Description of the payload
 	description: string
-	// Is the Payload empty?
-	required: _ | *"yes"
+	// Is the Payload nil?
+	nil: bool | *false
 
-	// Only have these when the payload isn't empty.
-	if required != "excluded" {
+	// Only have these when the payload isn't nil.
+	if !nil {
 		// Optional fixed schema for the payload.
 		// A URI or inline JSON Schema that the payload must validate against.
 		schema?: _
diff --git a/specs/definitions/signed_docs/signed_doc.cue b/specs/definitions/signed_docs/signed_doc.cue
@@ -39,7 +39,7 @@ import (
 
 	notes: [...string] | *[]
 
-	if payload.required == "excluded" {
+	if payload.nil {
 		headers: "content type": required:     "excluded"
 		headers: "content-encoding": required: "excluded"
 	}
diff --git a/specs/generators/packages/spec/src/spec/payload.py b/specs/generators/packages/spec/src/spec/payload.py
@@ -10,8 +10,6 @@
 import rich
 from pydantic import BaseModel, ConfigDict, Field, HttpUrl
 
-from spec.optional import OptionalField
-
 DRAFT7_SCHEMA = "https://json-schema.org/draft-07/schema"
 DRAFT202012_SCHEMA = "https://json-schema.org/draft/2020-12/schema"
 
@@ -58,7 +56,7 @@ class Payload(BaseModel):
     """Payload Deserialized Specification."""
 
     description: str
-    required: OptionalField
+    nil: bool
     doc_schema: HttpUrl | dict[str, Any] | None = Field(default=None, alias="schema")
     examples: list[PayloadExample] = Field(default_factory=PayloadExample.default)
 
diff --git a/specs/generators/src/docs/docs_page_md.py b/specs/generators/src/docs/docs_page_md.py
@@ -5,7 +5,6 @@
 
 from pydantic import HttpUrl
 
-from spec.optional import OptionalField
 from spec.payload import DRAFT7_SCHEMA, DRAFT202012_SCHEMA
 from spec.signed_doc import SignedDoc
 
@@ -71,7 +70,7 @@ def document_payload(self) -> str:
 
         docs = self._doc.payload.description + "\n"
 
-        if self._doc.payload.required == OptionalField.excluded:
+        if self._doc.payload.nil:
             if self._doc.payload.doc_schema is None:
                 docs += """
 This document has no payload.
diff --git a/specs/signed_doc.json b/specs/signed_doc.json
