oapi-profile-builder 3.1.0__tar.gz → 3.2.0__tar.gz

{oapi_profile_builder-3.1.0/src/oapi_profile_builder.egg-info → oapi_profile_builder-3.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: oapi-profile-builder
-Version: 3.1.0
+Version: 3.2.0
 Summary: Authoritative tooling for creating OGC API Service Profiles (EDR, Features)
 Author-email: Shane Mill <shane.mill@noaa.gov>
 License: Apache License
@@ -41,11 +41,13 @@ Requires-Dist: pyyaml>=6.0
 Requires-Dist: requests>=2.31
 Provides-Extra: validate
 Requires-Dist: schemathesis>=3.0; extra == "validate"
+Provides-Extra: pdf
+Requires-Dist: pillow>=10.0; extra == "pdf"
 Dynamic: license-file
 
 # OGC API Service Profile Builder
 
-Generate OGC API - EDR Part 3 Service Profile artifacts from a YAML config — OpenAPI 3.1.0, AsyncAPI, AsciiDoc requirements, and conformance tests.
+Generate OGC API - EDR Part 3 Service Profile artifacts from a YAML config — OpenAPI 3.1.0, AsyncAPI, AsciiDoc requirements and conformance tests, and a publication-ready Metanorma PDF with optional custom (e.g. DGIWG) branding.
 
 [![PyPI](https://img.shields.io/pypi/v/oapi-profile-builder)](https://pypi.org/project/oapi-profile-builder/)
 [![License](https://img.shields.io/badge/license-Apache-blue)](LICENSE)
@@ -80,13 +82,16 @@ output/
 
 ## Example Profiles
 
-Three working examples are included:
+Six working examples are included:
 
 | File | What it shows |
 |---|---|
 | [`examples/minimal_profile.yaml`](examples/minimal_profile.yaml) | Smallest valid profile — one collection, one requirement |
 | [`examples/insitu_observations_profile.yaml`](examples/insitu_observations_profile.yaml) | Full meteorological profile — 8 parameters with QUDT units, CF standard names, metocean extensions, CRS listing, temporal extent, custom dimensions, `parameter_schema` |
+| [`examples/nws_connect_profile.yaml`](examples/nws_connect_profile.yaml) | PubSub profile — generates `asyncapi.yaml` alongside the OpenAPI |
 | [`examples/nwsviz_profile.yaml`](examples/nwsviz_profile.yaml) | Production profile — 13 collections, 3 OGC API Processes, PDF metadata |
+| [`examples/nwp_radar.yaml`](examples/nwp_radar.yaml) | **DGIWG-branded** profile — custom cover logo, DGIWG colours/footer/legal page, `default_output_format`, per-query CRS, vertical `positive`, DGIWG namespace |
+| [`examples/nwp_earth_observations_lightning_profile.yaml`](examples/nwp_earth_observations_lightning_profile.yaml) | DGIWG lightning profile — same branding, CF units |
 
 ---
 
@@ -115,6 +120,8 @@ Add `--pdf` to also compile an OGC-compliant PDF via the `metanorma/metanorma` D
 oapi-profile-builder generate --config my_profile.yaml --output ./output --pdf
 ```
 
+The PDF can be rebranded for another SDO (e.g. DGIWG) — custom cover logo, colours, legal page, footer, and identifier namespace — all from the profile config. See [Document generation and branding](#document-generation-and-branding).
+
 ### `validate`
 
 Validates the config without writing any files. Useful in CI before generating.
@@ -219,6 +226,29 @@ jobs:
 
 ---
 
+## Document generation and branding
+
+With `--pdf`, the builder compiles a Metanorma document (`document.adoc` + `sections/`, `requirements/`, `abstract_tests/`) into `document.pdf` using the official `metanorma/metanorma` Docker image. By default this is an OGC `draft-standard` document.
+
+Everything about the document — cover, title-page metadata, legal page, footer, colours, and even the requirement/conformance identifier namespace — is driven from the profile config, so the same tooling can produce a document branded for another SDO such as **DGIWG** with no OGC branding remaining.
+
+| What you want to change | Field | Mechanism |
+|---|---|---|
+| Cover logo + tagline (replaces the OGC cover) | `document_metadata.cover` | Generated cover image via `:coverpage-image:` full replacement |
+| Title, doc number, edition, dates, sub-title/status | `title`, `version`, `document_metadata.{doc_number, doc_type, doc_subtype, status, *_date}` | Metanorma document attributes |
+| PDF colours (titles, tables, cover, backgrounds) | `document_metadata.colors` | `:presentation-metadata-color-*:` |
+| Page-ii legal text (copyright / license / notice) | `document_metadata.boilerplate` | `:boilerplate-authority:` |
+| Footer organisation name | `document_metadata.copyright_holder` | `:copyright-holder:` |
+| Remove the OGC logo from the legal page | `document_metadata.suppress_flavor_logo` | targeted `:pdf-stylesheet-override:` |
+| Requirement / conformance identifier namespace | `spec_uri_base` | derives `req_uri` / `conf_uri` |
+| Submitter table, notice paragraph, normative refs | `document_metadata.{submitters, notice, normative_references}` | Metanorma attributes / sections |
+
+Custom branding requires Pillow for the cover image: `pip install 'oapi-profile-builder[pdf]'`. Field-by-field detail is in the [`document_metadata`](#document_metadata) reference below; [`examples/nwp_radar.yaml`](examples/nwp_radar.yaml) is a complete DGIWG-branded example.
+
+> The `suppress_flavor_logo` override reaches into the OGC Metanorma flavor's XSL (template `insertLogoPreface`) and is coupled to that flavor. Everything else uses documented Metanorma attributes. For long-term SDO adoption, a dedicated Metanorma "taste"/flavor is the most durable path.
+
+---
+
 ## Profile Config Reference
 
 A profile config is a YAML file. The full JSON Schema is at [`profile.schema.json`](profile.schema.json).
@@ -445,6 +475,61 @@ extent_requirements:
 
 At least one of `extent_crs` or `supported_crs` is required. The same applies to TRS and VRS — all are optional individually but at least one CRS constraint must be present.
 
+#### Vertical direction (`positive`)
+
+OGC API - EDR's vertical extent has no field for which way values increase. This is ambiguous for VRS like pressure levels, which different providers order top-to-bottom or bottom-to-top inconsistently (pressure increases as altitude *decreases*). Set `extent.vertical.positive` to `up` or `down` on a collection (following the CF Conventions `positive` attribute) to make the ordering explicit:
+
+```yaml
+collections:
+  - id: my_collection
+    extent:
+      spatial: { ... }
+      vertical:
+        interval:
+          - ["1000", "100"]   # hPa, surface to top of atmosphere
+        values: ["1000", "850", "700", "500", "300", "100"]
+        vrs: "http://www.opengis.net/def/crs/EPSG/0/5798"  # or similar pressure VRS
+        positive: down   # pressure increases downward, toward the surface
+```
+
+Set `extent_requirements.require_vertical_direction: true` to make `positive` mandatory on every collection with a vertical extent, so a profile can enforce one consistent convention rather than leaving it up to each collection author:
+
+```yaml
+extent_requirements:
+  minimum_bbox: [-180, -90, 180, 90]
+  extent_crs:
+    allowed: ["http://www.opengis.net/def/crs/OGC/1.3/CRS84"]
+  require_vertical_direction: true
+```
+
+---
+
+### `output_formats`
+
+Maps format names (referenced by `collections[].output_formats` and `data_queries.*.variables.output_formats`) to a media type and, optionally, a schema reference. The `schema_ref` flows into the generated OpenAPI response `content` for that format — use it to point a format at a specific schema (e.g. a DGIWG-published schema for GeoTIFF or CoverageJSON) instead of the tool's built-in default.
+
+```yaml
+output_formats:
+  - name: CoverageJSON
+    media_type: application/prs.coverage+json
+    schema_ref: https://schemas.opengis.net/covjson/1.0/coveragejson.json
+  - name: GeoJSON
+    media_type: application/geo+json
+    schema_ref: https://geojson.org/schema/FeatureCollection.json
+  - name: GeoTIFF
+    media_type: image/tiff; application=geotiff
+    # Omit schema_ref until a published schema exists for this format —
+    # the requirement/abstract test can still state the standard to conform to.
+```
+
+| Field | Required | Description |
+|---|---|---|
+| `name` | yes | Format name, referenced elsewhere as a string (e.g. `CoverageJSON`) |
+| `media_type` | yes | MIME type used as the OpenAPI response `content` key and the `f` parameter value |
+| `schema_ref` | no | URL to a JSON Schema (or other schema) for this format. When set, the generated response uses `{"$ref": schema_ref}`; when omitted, a generic/default schema is used |
+
+`schema_ref` is optional — if no schema exists yet for a format (as is currently the case for some binary formats like GeoTIFF), leave it unset and capture the required standard as a normative `requirements[]` entry instead. Add `schema_ref` later once a schema URL exists.
+
 ---
 
 ### `parameter_schema`
@@ -601,6 +686,55 @@ document_metadata:
 
 The cover-page sub-title (e.g. "Draft Standard — Implementation — Approved") is produced by Metanorma from the `doc_type`, `doc_subtype`, and `status` combination.
 
+#### Custom branding (logo + colors)
+
+Two `document_metadata` blocks let you rebrand the PDF (e.g. for DGIWG) without a custom Metanorma flavor:
+
+- **`colors`** — recolours the PDF via Metanorma's `:presentation-metadata-color-*:` attributes. Values are hex colours.
+- **`cover`** — replaces the built-in OGC cover page with a generated one: your logo plus the document's title, number, edition and date. Requires Pillow (`pip install 'oapi-profile-builder[pdf]'`). The builder renders `cover.png` into the output directory and points Metanorma at it via `:coverpage-image:` + `:presentation-metadata-full-coverpage-replacement:`.
+
+```yaml
+document_metadata:
+  doc_number: "DGIWG 134"
+  cover:
+    logo: assets/dgiwg_logo.png    # path relative to the working directory (or absolute)
+    tagline: Delivering Military Advantage through multi-national geospatial interoperability
+    background: "#FFFFFF"          # optional cover background (default white)
+    text_color: "#1F3864"          # optional cover text colour (default black)
+  colors:
+    text: "#000000"                # body text
+    cover_text: "#1F3864"          # cover text / section numbers / ToC
+    cover_lines: "#1F3864"         # preface 'crossing lines' element
+    title: "#1F3864"               # clause/table/figure titles
+    page_background: "#FFFFFF"     # cover + section page background
+    table_header: "#1F3864"        # table header background
+    table_row_even: "#EEF1F7"      # even table rows
+    table_row_odd: "#FFFFFF"       # odd table rows
+```
+
+Note: colours work against the normal OGC cover too. The `cover` block does a *full* cover replacement, so the dynamic title/number/edition/date are drawn onto the generated image (which is why the builder composes it rather than relying on Metanorma attributes — logo attributes like `:coverpage-image:` alone are not rendered by the OGC flavor).
+
+#### De-branding the rest of the document (legal page + footer + logo)
+
+Cover + colors handle the front page, but the OGC flavor also stamps its identity on the page-ii legal boilerplate, the page footer, and an OGC logo on the legal page. Three more `document_metadata` fields remove those:
+
+- **`copyright_holder`** — sets `:copyright-holder:`, which also drives the **PDF footer** organisation name (replacing "OPEN GEOSPATIAL CONSORTIUM").
+- **`boilerplate`** — replaces the page-ii legal text (copyright / license / legal notice / feedback) via `:boilerplate-authority:`. Any field left unset is synthesised from `copyright_holder`, so no OGC text leaks through.
+- **`suppress_flavor_logo`** — removes the OGC logo from the preface/legal page via a targeted PDF-stylesheet override. (Coupled to the OGC Metanorma flavor's XSL.)
+
+```yaml
+document_metadata:
+  copyright_holder: DGIWG
+  suppress_flavor_logo: true
+  boilerplate:
+    copyright: "Copyright © 2026 Defence Geospatial Information Working Group (DGIWG). All rights reserved."
+    license: "Use of this document is subject to the DGIWG terms and conditions."
+    legal: "Attention is drawn to the possibility that some elements may be subject to patent rights; DGIWG shall not be held responsible for identifying any such rights."
+    feedback: "Comments on this document should be directed to DGIWG."
+```
+
+With `cover` + `colors` + `copyright_holder` + `boilerplate` + `suppress_flavor_logo` (and `spec_uri_base` for the requirement/conformance identifiers), the generated PDF carries no OGC branding — only legitimate citations to the OGC standards the profile conforms to. See [`examples/nwp_radar.yaml`](examples/nwp_radar.yaml).
+
 ---
 
 ### `provider`, `classification`, and provenance metadata
@@ -672,6 +806,7 @@ The tool enforces these rules at build time. Violations produce clear error mess
 | Collection TRS validated | Each `extent.temporal.trs` checked against `extent_trs` |
 | `crs_details` / `crs` validated | Each `data_queries.*.variables.crs_details[].crs` and `crs[]` checked against `supported_crs` |
 | `default_output_format` validated | Each `data_queries.*.variables.default_output_format` must be one of that query's `output_formats` |
+| `require_vertical_direction` enforced | If set, every collection with a vertical extent must declare `extent.vertical.positive` as `up` or `down` |
 | Document dates format | `submission_date` / `approval_date` / `publication_date` must be `YYYY-MM-DD` |
 | Parameters need `unit` + `observedProperty` | Required by OGC API - EDR Part 3 |
 | `parameter_name_pattern` enforced | All `parameter_names` keys must match if set |

{oapi_profile_builder-3.1.0 → oapi_profile_builder-3.2.0}/README.md

@@ -1,6 +1,6 @@
 # OGC API Service Profile Builder
 
-Generate OGC API - EDR Part 3 Service Profile artifacts from a YAML config — OpenAPI 3.1.0, AsyncAPI, AsciiDoc requirements, and conformance tests.
+Generate OGC API - EDR Part 3 Service Profile artifacts from a YAML config — OpenAPI 3.1.0, AsyncAPI, AsciiDoc requirements and conformance tests, and a publication-ready Metanorma PDF with optional custom (e.g. DGIWG) branding.
 
 [![PyPI](https://img.shields.io/pypi/v/oapi-profile-builder)](https://pypi.org/project/oapi-profile-builder/)
 [![License](https://img.shields.io/badge/license-Apache-blue)](LICENSE)
@@ -35,13 +35,16 @@ output/
 
 ## Example Profiles
 
-Three working examples are included:
+Six working examples are included:
 
 | File | What it shows |
 |---|---|
 | [`examples/minimal_profile.yaml`](examples/minimal_profile.yaml) | Smallest valid profile — one collection, one requirement |
 | [`examples/insitu_observations_profile.yaml`](examples/insitu_observations_profile.yaml) | Full meteorological profile — 8 parameters with QUDT units, CF standard names, metocean extensions, CRS listing, temporal extent, custom dimensions, `parameter_schema` |
+| [`examples/nws_connect_profile.yaml`](examples/nws_connect_profile.yaml) | PubSub profile — generates `asyncapi.yaml` alongside the OpenAPI |
 | [`examples/nwsviz_profile.yaml`](examples/nwsviz_profile.yaml) | Production profile — 13 collections, 3 OGC API Processes, PDF metadata |
+| [`examples/nwp_radar.yaml`](examples/nwp_radar.yaml) | **DGIWG-branded** profile — custom cover logo, DGIWG colours/footer/legal page, `default_output_format`, per-query CRS, vertical `positive`, DGIWG namespace |
+| [`examples/nwp_earth_observations_lightning_profile.yaml`](examples/nwp_earth_observations_lightning_profile.yaml) | DGIWG lightning profile — same branding, CF units |
 
 ---
 
@@ -70,6 +73,8 @@ Add `--pdf` to also compile an OGC-compliant PDF via the `metanorma/metanorma` D
 oapi-profile-builder generate --config my_profile.yaml --output ./output --pdf
 ```
 
+The PDF can be rebranded for another SDO (e.g. DGIWG) — custom cover logo, colours, legal page, footer, and identifier namespace — all from the profile config. See [Document generation and branding](#document-generation-and-branding).
+
 ### `validate`
 
 Validates the config without writing any files. Useful in CI before generating.
@@ -174,6 +179,29 @@ jobs:
 
 ---
 
+## Document generation and branding
+
+With `--pdf`, the builder compiles a Metanorma document (`document.adoc` + `sections/`, `requirements/`, `abstract_tests/`) into `document.pdf` using the official `metanorma/metanorma` Docker image. By default this is an OGC `draft-standard` document.
+
+Everything about the document — cover, title-page metadata, legal page, footer, colours, and even the requirement/conformance identifier namespace — is driven from the profile config, so the same tooling can produce a document branded for another SDO such as **DGIWG** with no OGC branding remaining.
+
+| What you want to change | Field | Mechanism |
+|---|---|---|
+| Cover logo + tagline (replaces the OGC cover) | `document_metadata.cover` | Generated cover image via `:coverpage-image:` full replacement |
+| Title, doc number, edition, dates, sub-title/status | `title`, `version`, `document_metadata.{doc_number, doc_type, doc_subtype, status, *_date}` | Metanorma document attributes |
+| PDF colours (titles, tables, cover, backgrounds) | `document_metadata.colors` | `:presentation-metadata-color-*:` |
+| Page-ii legal text (copyright / license / notice) | `document_metadata.boilerplate` | `:boilerplate-authority:` |
+| Footer organisation name | `document_metadata.copyright_holder` | `:copyright-holder:` |
+| Remove the OGC logo from the legal page | `document_metadata.suppress_flavor_logo` | targeted `:pdf-stylesheet-override:` |
+| Requirement / conformance identifier namespace | `spec_uri_base` | derives `req_uri` / `conf_uri` |
+| Submitter table, notice paragraph, normative refs | `document_metadata.{submitters, notice, normative_references}` | Metanorma attributes / sections |
+
+Custom branding requires Pillow for the cover image: `pip install 'oapi-profile-builder[pdf]'`. Field-by-field detail is in the [`document_metadata`](#document_metadata) reference below; [`examples/nwp_radar.yaml`](examples/nwp_radar.yaml) is a complete DGIWG-branded example.
+
+> The `suppress_flavor_logo` override reaches into the OGC Metanorma flavor's XSL (template `insertLogoPreface`) and is coupled to that flavor. Everything else uses documented Metanorma attributes. For long-term SDO adoption, a dedicated Metanorma "taste"/flavor is the most durable path.
+
+---
+
 ## Profile Config Reference
 
 A profile config is a YAML file. The full JSON Schema is at [`profile.schema.json`](profile.schema.json).
@@ -400,6 +428,61 @@ extent_requirements:
 
 At least one of `extent_crs` or `supported_crs` is required. The same applies to TRS and VRS — all are optional individually but at least one CRS constraint must be present.
 
+#### Vertical direction (`positive`)
+
+OGC API - EDR's vertical extent has no field for which way values increase. This is ambiguous for VRS like pressure levels, which different providers order top-to-bottom or bottom-to-top inconsistently (pressure increases as altitude *decreases*). Set `extent.vertical.positive` to `up` or `down` on a collection (following the CF Conventions `positive` attribute) to make the ordering explicit:
+
+```yaml
+collections:
+  - id: my_collection
+    extent:
+      spatial: { ... }
+      vertical:
+        interval:
+          - ["1000", "100"]   # hPa, surface to top of atmosphere
+        values: ["1000", "850", "700", "500", "300", "100"]
+        vrs: "http://www.opengis.net/def/crs/EPSG/0/5798"  # or similar pressure VRS
+        positive: down   # pressure increases downward, toward the surface
+```
+
+Set `extent_requirements.require_vertical_direction: true` to make `positive` mandatory on every collection with a vertical extent, so a profile can enforce one consistent convention rather than leaving it up to each collection author:
+
+```yaml
+extent_requirements:
+  minimum_bbox: [-180, -90, 180, 90]
+  extent_crs:
+    allowed: ["http://www.opengis.net/def/crs/OGC/1.3/CRS84"]
+  require_vertical_direction: true
+```
+
+---
+
+### `output_formats`
+
+Maps format names (referenced by `collections[].output_formats` and `data_queries.*.variables.output_formats`) to a media type and, optionally, a schema reference. The `schema_ref` flows into the generated OpenAPI response `content` for that format — use it to point a format at a specific schema (e.g. a DGIWG-published schema for GeoTIFF or CoverageJSON) instead of the tool's built-in default.
+
+```yaml
+output_formats:
+  - name: CoverageJSON
+    media_type: application/prs.coverage+json
+    schema_ref: https://schemas.opengis.net/covjson/1.0/coveragejson.json
+  - name: GeoJSON
+    media_type: application/geo+json
+    schema_ref: https://geojson.org/schema/FeatureCollection.json
+  - name: GeoTIFF
+    media_type: image/tiff; application=geotiff
+    # Omit schema_ref until a published schema exists for this format —
+    # the requirement/abstract test can still state the standard to conform to.
+```
+
+| Field | Required | Description |
+|---|---|---|
+| `name` | yes | Format name, referenced elsewhere as a string (e.g. `CoverageJSON`) |
+| `media_type` | yes | MIME type used as the OpenAPI response `content` key and the `f` parameter value |
+| `schema_ref` | no | URL to a JSON Schema (or other schema) for this format. When set, the generated response uses `{"$ref": schema_ref}`; when omitted, a generic/default schema is used |
+
+`schema_ref` is optional — if no schema exists yet for a format (as is currently the case for some binary formats like GeoTIFF), leave it unset and capture the required standard as a normative `requirements[]` entry instead. Add `schema_ref` later once a schema URL exists.
+
 ---
 
 ### `parameter_schema`
@@ -556,6 +639,55 @@ document_metadata:
 
 The cover-page sub-title (e.g. "Draft Standard — Implementation — Approved") is produced by Metanorma from the `doc_type`, `doc_subtype`, and `status` combination.
 
+#### Custom branding (logo + colors)
+
+Two `document_metadata` blocks let you rebrand the PDF (e.g. for DGIWG) without a custom Metanorma flavor:
+
+- **`colors`** — recolours the PDF via Metanorma's `:presentation-metadata-color-*:` attributes. Values are hex colours.
+- **`cover`** — replaces the built-in OGC cover page with a generated one: your logo plus the document's title, number, edition and date. Requires Pillow (`pip install 'oapi-profile-builder[pdf]'`). The builder renders `cover.png` into the output directory and points Metanorma at it via `:coverpage-image:` + `:presentation-metadata-full-coverpage-replacement:`.
+
+```yaml
+document_metadata:
+  doc_number: "DGIWG 134"
+  cover:
+    logo: assets/dgiwg_logo.png    # path relative to the working directory (or absolute)
+    tagline: Delivering Military Advantage through multi-national geospatial interoperability
+    background: "#FFFFFF"          # optional cover background (default white)
+    text_color: "#1F3864"          # optional cover text colour (default black)
+  colors:
+    text: "#000000"                # body text
+    cover_text: "#1F3864"          # cover text / section numbers / ToC
+    cover_lines: "#1F3864"         # preface 'crossing lines' element
+    title: "#1F3864"               # clause/table/figure titles
+    page_background: "#FFFFFF"     # cover + section page background
+    table_header: "#1F3864"        # table header background
+    table_row_even: "#EEF1F7"      # even table rows
+    table_row_odd: "#FFFFFF"       # odd table rows
+```
+
+Note: colours work against the normal OGC cover too. The `cover` block does a *full* cover replacement, so the dynamic title/number/edition/date are drawn onto the generated image (which is why the builder composes it rather than relying on Metanorma attributes — logo attributes like `:coverpage-image:` alone are not rendered by the OGC flavor).
+
+#### De-branding the rest of the document (legal page + footer + logo)
+
+Cover + colors handle the front page, but the OGC flavor also stamps its identity on the page-ii legal boilerplate, the page footer, and an OGC logo on the legal page. Three more `document_metadata` fields remove those:
+
+- **`copyright_holder`** — sets `:copyright-holder:`, which also drives the **PDF footer** organisation name (replacing "OPEN GEOSPATIAL CONSORTIUM").
+- **`boilerplate`** — replaces the page-ii legal text (copyright / license / legal notice / feedback) via `:boilerplate-authority:`. Any field left unset is synthesised from `copyright_holder`, so no OGC text leaks through.
+- **`suppress_flavor_logo`** — removes the OGC logo from the preface/legal page via a targeted PDF-stylesheet override. (Coupled to the OGC Metanorma flavor's XSL.)
+
+```yaml
+document_metadata:
+  copyright_holder: DGIWG
+  suppress_flavor_logo: true
+  boilerplate:
+    copyright: "Copyright © 2026 Defence Geospatial Information Working Group (DGIWG). All rights reserved."
+    license: "Use of this document is subject to the DGIWG terms and conditions."
+    legal: "Attention is drawn to the possibility that some elements may be subject to patent rights; DGIWG shall not be held responsible for identifying any such rights."
+    feedback: "Comments on this document should be directed to DGIWG."
+```
+
+With `cover` + `colors` + `copyright_holder` + `boilerplate` + `suppress_flavor_logo` (and `spec_uri_base` for the requirement/conformance identifiers), the generated PDF carries no OGC branding — only legitimate citations to the OGC standards the profile conforms to. See [`examples/nwp_radar.yaml`](examples/nwp_radar.yaml).
+
 ---
 
 ### `provider`, `classification`, and provenance metadata
@@ -627,6 +759,7 @@ The tool enforces these rules at build time. Violations produce clear error mess
 | Collection TRS validated | Each `extent.temporal.trs` checked against `extent_trs` |
 | `crs_details` / `crs` validated | Each `data_queries.*.variables.crs_details[].crs` and `crs[]` checked against `supported_crs` |
 | `default_output_format` validated | Each `data_queries.*.variables.default_output_format` must be one of that query's `output_formats` |
+| `require_vertical_direction` enforced | If set, every collection with a vertical extent must declare `extent.vertical.positive` as `up` or `down` |
 | Document dates format | `submission_date` / `approval_date` / `publication_date` must be `YYYY-MM-DD` |
 | Parameters need `unit` + `observedProperty` | Required by OGC API - EDR Part 3 |
 | `parameter_name_pattern` enforced | All `parameter_names` keys must match if set |

{oapi_profile_builder-3.1.0 → oapi_profile_builder-3.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "oapi-profile-builder"
-version = "3.1.0"
+version = "3.2.0"
 description = "Authoritative tooling for creating OGC API Service Profiles (EDR, Features)"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -30,6 +30,7 @@ dependencies = [
 
 [project.optional-dependencies]
 validate = ["schemathesis>=3.0"]
+pdf = ["pillow>=10.0"]
 
 [project.urls]
 Homepage = "https://github.com/ShaneMill1/OGC-API-Service-Profile-Builder"

oapi_profile_builder-3.2.0/src/oapi_profile_builder/cover.py

@@ -0,0 +1,176 @@
+# =================================================================
+#
+# Authors: Shane Mill <shane.mill@noaa.gov>
+#
+# Copyright (c) 2026 Shane Mill
+#
+# Permission is hereby granted, free of charge, to any person
+# obtaining a copy of this software and associated documentation
+# files (the "Software"), to deal in the Software without
+# restriction, including without limitation the rights to use,
+# copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the
+# Software is furnished to do so, subject to the following
+# conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# =================================================================
+"""
+Custom PDF cover-page generation.
+
+When a profile sets ``document_metadata.cover.logo``, the builder renders a
+replacement cover-page image (organisation logo + the document's title, number,
+edition and date) which Metanorma then uses in place of the built-in OGC cover
+via ``:coverpage-image:`` + ``:presentation-metadata-full-coverpage-replacement:``.
+
+Rendering uses Pillow. DejaVu fonts are bundled with Pillow and resolved by name,
+so no system font paths are required.
+"""
+
+from __future__ import annotations
+
+from datetime import datetime
+from pathlib import Path
+
+# A4 portrait at ~150 DPI.
+_PAGE_W = 1240
+_PAGE_H = 1754
+
+_COVER_FILENAME = "cover.png"
+
+
+def _load_font(bold: bool, size: int):
+    from PIL import ImageFont
+
+    name = "DejaVuSans-Bold.ttf" if bold else "DejaVuSans.ttf"
+    try:
+        return ImageFont.truetype(name, size)
+    except Exception:
+        # Last-resort fallback; not scalable but keeps rendering from failing.
+        return ImageFont.load_default()
+
+
+def _italic_font(size: int):
+    from PIL import ImageFont
+
+    try:
+        return ImageFont.truetype("DejaVuSans-Oblique.ttf", size)
+    except Exception:
+        return _load_font(False, size)
+
+
+def _format_date(iso_date: str | None) -> str | None:
+    """Format 'YYYY-MM-DD' as 'DD Month YYYY' (e.g. '15 May 2026')."""
+    if not iso_date:
+        return None
+    try:
+        dt = datetime.strptime(iso_date, "%Y-%m-%d")
+    except ValueError:
+        return iso_date
+    # %-d is not portable; strip a leading zero manually.
+    return f"{dt.day} {dt.strftime('%B %Y')}"
+
+
+def build_cover_image(profile, output_dir: Path) -> str | None:
+    """Render the cover PNG into output_dir. Returns its filename, or None.
+
+    Returns None when no cover logo is configured. Raises RuntimeError with a
+    clear message if Pillow is unavailable or the logo file cannot be found.
+    """
+    m = getattr(profile, "document_metadata", None)
+    cover = getattr(m, "cover", None) if m else None
+    if not cover or not cover.logo:
+        return None
+
+    try:
+        from PIL import Image, ImageDraw
+    except ImportError as exc:  # pragma: no cover - depends on env
+        raise RuntimeError(
+            "document_metadata.cover.logo is set but Pillow is not installed. "
+            "Install it with: pip install 'oapi-profile-builder[pdf]'"
+        ) from exc
+
+    logo_path = Path(cover.logo).expanduser()
+    if not logo_path.is_absolute():
+        logo_path = (Path.cwd() / logo_path).resolve()
+    if not logo_path.exists():
+        raise RuntimeError(f"Cover logo not found: {logo_path}")
+
+    bg = cover.background or "#FFFFFF"
+    fg = cover.text_color or "#000000"
+
+    page = Image.new("RGB", (_PAGE_W, _PAGE_H), bg)
+    draw = ImageDraw.Draw(page)
+
+    def centered(text: str, font, y: int, fill: str) -> int:
+        """Draw text horizontally centered; return the y below the text."""
+        bbox = draw.textbbox((0, 0), text, font=font)
+        tw = bbox[2] - bbox[0]
+        th = bbox[3] - bbox[1]
+        draw.text(((_PAGE_W - tw) / 2, y), text, font=font, fill=fill)
+        return y + th
+
+    y = 180
+
+    # --- Logo (centered, scaled to a target width) ---
+    logo = Image.open(logo_path).convert("RGBA")
+    target_logo_w = 420          # desired cover logo width
+    max_logo_w = 520             # hard cap
+    max_upscale = 3.0            # don't upscale tiny logos beyond this (avoids heavy blur)
+    desired = min(target_logo_w, int(logo.width * max_upscale), max_logo_w)
+    if logo.width != desired:
+        scale = desired / logo.width
+        logo = logo.resize((desired, max(1, int(logo.height * scale))))
+    logo_x = int((_PAGE_W - logo.width) / 2)
+    page.paste(logo, (logo_x, y), logo)
+    y += logo.height + 60
+
+    # --- Tagline (italic) ---
+    if cover.tagline:
+        y = centered(cover.tagline, _italic_font(30), y, fg) + 60
+
+    # --- Document number ---
+    if m and m.doc_number:
+        y = centered(m.doc_number, _load_font(True, 46), y, fg) + 40
+
+    # --- Edition ---
+    edition = getattr(profile, "version", None)
+    if edition:
+        y = centered(f"Edition {edition}", _load_font(False, 28), y, fg) + 24
+
+    # --- Date ---
+    date_str = _format_date(m.publication_date if m else None)
+    if date_str:
+        y = centered(f"Dated {date_str}", _load_font(False, 28), y, fg) + 80
+
+    # --- Title (large, bold, wrapped) ---
+    title = getattr(profile, "title", "") or ""
+    title_font = _load_font(True, 54)
+    for line in _wrap(draw, title, title_font, _PAGE_W - 240):
+        y = centered(line, title_font, y, fg) + 16
+
+    target = (output_dir / _COVER_FILENAME).resolve()
+    if not str(target).startswith(str(output_dir.resolve())):
+        raise RuntimeError(f"Refusing to write cover outside output directory: {target}")
+    page.save(target)
+    return _COVER_FILENAME
+
+
+def _wrap(draw, text: str, font, max_width: int) -> list[str]:
+    """Greedy word-wrap to fit max_width pixels."""
+    words = text.split()
+    lines: list[str] = []
+    cur = ""
+    for w in words:
+        trial = f"{cur} {w}".strip()
+        bbox = draw.textbbox((0, 0), trial, font=font)
+        if bbox[2] - bbox[0] <= max_width or not cur:
+            cur = trial
+        else:
+            lines.append(cur)
+            cur = w
+    if cur:
+        lines.append(cur)
+    return lines

{oapi_profile_builder-3.1.0 → oapi_profile_builder-3.2.0}/src/oapi_profile_builder/generate.py

@@ -552,6 +552,15 @@ def _collection_response_schema(coll: Collection,
                                 "items": {"type": "string"},
                             },
                             "vrs": vrs_schema,
+                            "positive": {
+                                "type": "string",
+                                "enum": ["up", "down"],
+                                "description": (
+                                    "Direction in which vertical extent values increase "
+                                    "(CF Conventions 'positive' attribute). Disambiguates "
+                                    "interval ordering for VRS such as pressure levels."
+                                ),
+                            },
                         },
                     },
                     "custom": {
@@ -1365,6 +1374,82 @@ def _individual_test_adoc(profile: ServiceProfile, test_id: str) -> str:
 # Metanorma root document
 # ---------------------------------------------------------------------------
 
+_LOGO_OVERRIDE_XSL = """<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+                xmlns:fo="http://www.w3.org/1999/XSL/Format"
+                version="1.0">
+  <!-- Rebranding override: suppress the OGC flavor logo on the preface/legal
+       page (and the cover, which is replaced separately). Coupled to the OGC
+       Metanorma flavor's XSL template names. -->
+  <xsl:template name="insertLogoPreface"/>
+  <xsl:template name="insertLogo"/>
+</xsl:stylesheet>
+"""
+
+
+def _xml_escape(text: str) -> str:
+    return (
+        text.replace("&", "&amp;")
+        .replace("<", "&lt;")
+        .replace(">", "&gt;")
+    )
+
+
+def _build_boilerplate_xml(profile: ServiceProfile) -> str | None:
+    """Build a Metanorma boilerplate XML overriding the flavor's legal text.
+
+    Returns the XML string, or None when no boilerplate is configured. Any
+    statement not supplied is synthesised from copyright_holder so no flavor
+    default (e.g. OGC copyright) leaks through.
+    """
+    m = profile.document_metadata
+    bp = m.boilerplate if m else None
+    if not bp:
+        return None
+
+    holder = (m.copyright_holder if m and m.copyright_holder else None) or (
+        m.submitting_orgs[0] if m and m.submitting_orgs else "the copyright holder"
+    )
+    year = m.copyright_year if m else 2026
+
+    copyright_txt = bp.copyright or f"Copyright © {year} {holder}. All rights reserved."
+    license_txt = bp.license or f"Use of this document is subject to the terms and conditions of {holder}."
+    legal_txt = bp.legal or (
+        "Attention is drawn to the possibility that some of the elements of this "
+        f"document may be the subject of patent rights. {holder} shall not be held "
+        "responsible for identifying any or all such patent rights."
+    )
+    feedback_txt = bp.feedback or f"Comments on this document should be directed to {holder}."
+
+    return (
+        "<boilerplate>\n"
+        "  <copyright-statement>\n"
+        "    <clause>\n"
+        "      <title>Copyright notice</title>\n"
+        f"      <p id=\"bp-copyright\">{_xml_escape(copyright_txt)}</p>\n"
+        "    </clause>\n"
+        "  </copyright-statement>\n"
+        "  <license-statement>\n"
+        "    <clause>\n"
+        "      <title>License Agreement</title>\n"
+        f"      <p id=\"bp-license\">{_xml_escape(license_txt)}</p>\n"
+        "    </clause>\n"
+        "  </license-statement>\n"
+        "  <legal-statement>\n"
+        "    <clause>\n"
+        "      <title>Note</title>\n"
+        f"      <p id=\"bp-legal\">{_xml_escape(legal_txt)}</p>\n"
+        "    </clause>\n"
+        "  </legal-statement>\n"
+        "  <feedback-statement>\n"
+        "    <clause>\n"
+        f"      <p id=\"bp-feedback\">{_xml_escape(feedback_txt)}</p>\n"
+        "    </clause>\n"
+        "  </feedback-statement>\n"
+        "</boilerplate>\n"
+    )
+
+
 def _build_document_adoc(profile: ServiceProfile) -> str:
     m = profile.document_metadata
     year = m.copyright_year if m else 2026
@@ -1400,6 +1485,24 @@ def _build_document_adoc(profile: ServiceProfile) -> str:
         lines.append(f":keywords: {', '.join(m.keywords)}")
     if m and m.submitting_orgs:
         lines.append(f":submitting-organizations: {'; '.join(m.submitting_orgs)}")
+    # PDF colour-scheme overrides (mapped to Metanorma attributes).
+    if m and m.colors:
+        for attr, value in m.colors.to_metanorma_attributes().items():
+            lines.append(f":{attr}: {value}")
+    # Custom cover page: replace the built-in OGC cover with our generated image.
+    # The image file (cover.png) is written by generate(); this just references it.
+    if m and m.cover and m.cover.logo:
+        lines.append(":coverpage-image: cover.png")
+        lines.append(":presentation-metadata-full-coverpage-replacement: true")
+    # Copyright holder → also sets the PDF footer org name (replaces OGC default).
+    if m and m.copyright_holder:
+        lines.append(f":copyright-holder: {m.copyright_holder}")
+    # Custom legal boilerplate (page ii). The XML file is written by generate().
+    if m and m.boilerplate:
+        lines.append(":boilerplate-authority: boilerplate.xml")
+    # Suppress the flavor's built-in (OGC) logo on the preface page when rebranding.
+    if m and m.suppress_flavor_logo:
+        lines.append(":pdf-stylesheet-override: logo_override.xsl")
     lines += [
         ":mn-document-class: ogc",
         ":mn-output-extensions: xml,html,pdf",
@@ -1622,4 +1725,21 @@ def generate(profile: ServiceProfile, output_dir: Path) -> None:
     for path, content in _build_sections(profile).items():
         safe_write(path, content)
 
+    # Custom cover-page image (only when document_metadata.cover.logo is set).
+    m = profile.document_metadata
+    if m and m.cover and m.cover.logo:
+        from oapi_profile_builder.cover import build_cover_image
+        cover_file = build_cover_image(profile, output_dir)
+        if cover_file:
+            print(f"Custom cover page written to {output_dir / cover_file}")
+
+    # Custom legal boilerplate (page ii), replacing the flavor's built-in text.
+    boilerplate_xml = _build_boilerplate_xml(profile)
+    if boilerplate_xml:
+        safe_write("boilerplate.xml", boilerplate_xml)
+
+    # PDF stylesheet override to suppress the flavor's preface-page logo.
+    if m and m.suppress_flavor_logo:
+        safe_write("logo_override.xsl", _LOGO_OVERRIDE_XSL)
+
     print(f"Profile '{profile.name}' written to {output_dir}")

{oapi_profile_builder-3.1.0 → oapi_profile_builder-3.2.0}/src/oapi_profile_builder/models.py

@@ -73,10 +73,39 @@ class TemporalWithNullBounds(EdrBaseModel):
     trs: str
 
 
+class VerticalWithDirection(Vertical):
+    """Vertical extent with an explicit direction of increasing value.
+
+    OGC API - EDR's Vertical extent has no way to state whether the interval
+    values are ordered "positive up" (e.g. height) or "positive down" (e.g.
+    depth, or pressure levels — which increase in magnitude *downward* toward
+    the surface while decreasing in altitude). Different data providers order
+    pressure-level intervals top-to-bottom or bottom-to-top inconsistently.
+
+    ``positive`` follows the CF Conventions attribute of the same name
+    (https://cfconventions.org/cf-conventions/cf-conventions.html#vertical-coordinate)
+    so profiles can require a single, unambiguous convention.
+    """
+
+    positive: Optional[Literal["up", "down"]] = Field(
+        default=None,
+        description=(
+            "Direction in which vertical extent values increase, per the CF "
+            "Conventions 'positive' attribute. 'up' means values increase with "
+            "altitude/height (e.g. height above ground); 'down' means values "
+            "increase toward the surface/downward (e.g. depth, or pressure — "
+            "since pressure increases as altitude decreases). Recommended "
+            "whenever the VRS alone doesn't make the ordering unambiguous "
+            "(pressure levels are the common case)."
+        ),
+    )
+
+
 class ExtentWithNullBounds(EDRExtent):
     """Extent that uses TemporalWithNullBounds instead of the upstream Temporal."""
 
     temporal: Optional[TemporalWithNullBounds] = None
+    vertical: Optional[VerticalWithDirection] = None  # type: ignore[assignment]
 
 
 class Classification(BaseModel):
@@ -252,6 +281,16 @@ class ExtentRequirements(BaseModel):
         default=None,
         description="Constraint on extent.vertical.vrs — the VRS the vertical extent is expressed in",
     )
+    require_vertical_direction: bool = Field(
+        default=False,
+        description=(
+            "When true, every collection with a vertical extent must declare "
+            "extent.vertical.positive ('up' or 'down'), per the CF Conventions "
+            "'positive' attribute. Use this to force a single, unambiguous "
+            "ordering convention for vertical intervals (e.g. pressure levels) "
+            "across all collections in the profile."
+        ),
+    )
 
     # --- Supported CRS/TRS/VRS (lists — what the service supports for queries) ---
     supported_crs: CrsConstraint | None = Field(
@@ -334,6 +373,91 @@ DocStatus = Literal[
 # Loose ISO 8601 date (YYYY-MM-DD) check for document dates.
 _DATE_RE = re.compile(r"^\d{4}-\d{2}-\d{2}$")
 
+# Hex colour (#RGB or #RRGGBB) check for PDF colour overrides.
+_HEX_COLOR_RE = re.compile(r"^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$")
+
+
+class PdfColors(BaseModel):
+    """PDF colour-scheme overrides.
+
+    Each field maps to a Metanorma OGC ``:presentation-metadata-color-*:``
+    document attribute, letting a profile recolour the generated PDF (e.g. to a
+    DGIWG palette) without a custom Metanorma flavor. Values are hex colours
+    (``#RGB`` or ``#RRGGBB``). See
+    https://www.metanorma.org/author/ogc/ref/document-attributes/#pdf-color-scheme
+    """
+    text: str | None = Field(default=None, description="Body text colour (:presentation-metadata-color-text:)")
+    cover_text: str | None = Field(default=None, description="Cover-page text / section numbers / ToC (:presentation-metadata-color-secondary-shade-1:)")
+    cover_lines: str | None = Field(default=None, description="Preface 'crossing lines' design element (:presentation-metadata-color-secondary-shade-2:)")
+    title: str | None = Field(default=None, description="Clause/table/figure title colour (:presentation-metadata-color-text-title:)")
+    page_background: str | None = Field(default=None, description="Cover and section page background (:presentation-metadata-color-background-page:)")
+    table_header: str | None = Field(default=None, description="Table header background (:presentation-metadata-color-background-table-header:)")
+    table_row_even: str | None = Field(default=None, description="Even table row background (:presentation-metadata-color-background-table-row-even:)")
+    table_row_odd: str | None = Field(default=None, description="Odd table row background (:presentation-metadata-color-background-table-row-odd:)")
+
+    @field_validator("*")
+    @classmethod
+    def _valid_hex(cls, v: str | None) -> str | None:
+        if v is not None and not _HEX_COLOR_RE.match(v):
+            raise ValueError(f"colour '{v}' must be a hex colour like #RRGGBB")
+        return v
+
+    def to_metanorma_attributes(self) -> dict[str, str]:
+        """Map set fields to their Metanorma attribute names → value."""
+        mapping = {
+            "text": "presentation-metadata-color-text",
+            "cover_text": "presentation-metadata-color-secondary-shade-1",
+            "cover_lines": "presentation-metadata-color-secondary-shade-2",
+            "title": "presentation-metadata-color-text-title",
+            "page_background": "presentation-metadata-color-background-page",
+            "table_header": "presentation-metadata-color-background-table-header",
+            "table_row_even": "presentation-metadata-color-background-table-row-even",
+            "table_row_odd": "presentation-metadata-color-background-table-row-odd",
+        }
+        out: dict[str, str] = {}
+        for field, attr in mapping.items():
+            val = getattr(self, field, None)
+            if val:
+                out[attr] = val
+        return out
+
+
+class CoverPage(BaseModel):
+    """Custom PDF cover-page branding (e.g. DGIWG).
+
+    When ``logo`` is set, the builder renders a replacement cover page (logo +
+    the document's title, number, edition and date) and instructs Metanorma to
+    use it in place of the built-in OGC cover, via ``:coverpage-image:`` +
+    ``:presentation-metadata-full-coverpage-replacement:`` (supported for all
+    flavors). Requires Pillow (``pip install oapi-profile-builder[pdf]``).
+    """
+    logo: str = Field(description="Path to the cover logo image (PNG/JPG), relative to the working directory or absolute")
+    tagline: str | None = Field(default=None, description="Optional line rendered under the logo, e.g. an organisation motto")
+    background: str | None = Field(default=None, description="Cover background hex colour (default white)")
+    text_color: str | None = Field(default=None, description="Cover text hex colour (default black)")
+
+    @field_validator("background", "text_color")
+    @classmethod
+    def _valid_hex(cls, v: str | None) -> str | None:
+        if v is not None and not _HEX_COLOR_RE.match(v):
+            raise ValueError(f"colour '{v}' must be a hex colour like #RRGGBB")
+        return v
+
+
+class Boilerplate(BaseModel):
+    """Front-matter legal boilerplate (page ii) — copyright, license, legal notice.
+
+    Replaces the flavor's built-in boilerplate (e.g. the OGC copyright/license/
+    patent notice) via Metanorma's ``:boilerplate-authority:`` mechanism, so a
+    DGIWG (or other SDO) document doesn't carry OGC legal text. Any field left
+    unset is synthesised from ``copyright_holder`` so no flavor default leaks
+    through.
+    """
+    copyright: str | None = Field(default=None, description="Copyright notice paragraph")
+    license: str | None = Field(default=None, description="License agreement paragraph")
+    legal: str | None = Field(default=None, description="Legal/patent notice paragraph")
+    feedback: str | None = Field(default=None, description="Feedback/comments paragraph")
+
 
 class DocumentMetadata(BaseModel):
     """Metanorma/OGC document header metadata for PDF compilation."""
@@ -385,6 +509,39 @@ class DocumentMetadata(BaseModel):
         description="Additional normative references appended to the References section.",
     )
     external_id: str | None = None
+    colors: PdfColors | None = Field(
+        default=None,
+        description="PDF colour-scheme overrides (mapped to Metanorma :presentation-metadata-color-*: attributes).",
+    )
+    cover: CoverPage | None = Field(
+        default=None,
+        description="Custom cover-page branding (logo + generated cover) replacing the built-in OGC cover.",
+    )
+    copyright_holder: str | None = Field(
+        default=None,
+        description=(
+            "Copyright holder organisation (Metanorma :copyright-holder:). Also drives "
+            "the PDF footer organisation name, replacing the flavor default (e.g. 'OPEN "
+            "GEOSPATIAL CONSORTIUM')."
+        ),
+    )
+    boilerplate: Boilerplate | None = Field(
+        default=None,
+        description=(
+            "Front-matter legal boilerplate (copyright/license/legal/feedback) replacing "
+            "the flavor's built-in text via :boilerplate-authority:."
+        ),
+    )
+    suppress_flavor_logo: bool = Field(
+        default=False,
+        description=(
+            "When true, suppress the Metanorma flavor's built-in logo on the preface/"
+            "legal page (e.g. the OGC logo) via a targeted PDF stylesheet override. "
+            "Use when rebranding (e.g. DGIWG) so no OGC logo remains on internal pages. "
+            "Note: this overrides an OGC-flavor XSL template and is coupled to the OGC "
+            "Metanorma flavor."
+        ),
+    )
 
     @field_validator("submission_date", "approval_date", "publication_date")
     @classmethod
@@ -664,6 +821,14 @@ class ServiceProfile(BaseModel):
             if vrs:
                 _check(f"Collection '{coll.id}' extent.vertical.vrs", vrs, er.extent_vrs)
 
+            # --- extent.vertical.positive required? ---
+            if er.require_vertical_direction and coll.extent and coll.extent.vertical:
+                if getattr(coll.extent.vertical, "positive", None) not in ("up", "down"):
+                    raise ValueError(
+                        f"Collection '{coll.id}' extent.vertical.positive must be "
+                        f"'up' or 'down' (extent_requirements.require_vertical_direction is set)"
+                    )
+
             # --- top-level crs array → supported_crs ---
             if coll.crs and er.supported_crs:
                 for crs_val in coll.crs:

{oapi_profile_builder-3.1.0 → oapi_profile_builder-3.2.0/src/oapi_profile_builder.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: oapi-profile-builder
-Version: 3.1.0
+Version: 3.2.0
 Summary: Authoritative tooling for creating OGC API Service Profiles (EDR, Features)
 Author-email: Shane Mill <shane.mill@noaa.gov>
 License: Apache License
@@ -41,11 +41,13 @@ Requires-Dist: pyyaml>=6.0
 Requires-Dist: requests>=2.31
 Provides-Extra: validate
 Requires-Dist: schemathesis>=3.0; extra == "validate"
+Provides-Extra: pdf
+Requires-Dist: pillow>=10.0; extra == "pdf"
 Dynamic: license-file
 
 # OGC API Service Profile Builder
 
-Generate OGC API - EDR Part 3 Service Profile artifacts from a YAML config — OpenAPI 3.1.0, AsyncAPI, AsciiDoc requirements, and conformance tests.
+Generate OGC API - EDR Part 3 Service Profile artifacts from a YAML config — OpenAPI 3.1.0, AsyncAPI, AsciiDoc requirements and conformance tests, and a publication-ready Metanorma PDF with optional custom (e.g. DGIWG) branding.
 
 [![PyPI](https://img.shields.io/pypi/v/oapi-profile-builder)](https://pypi.org/project/oapi-profile-builder/)
 [![License](https://img.shields.io/badge/license-Apache-blue)](LICENSE)
@@ -80,13 +82,16 @@ output/
 
 ## Example Profiles
 
-Three working examples are included:
+Six working examples are included:
 
 | File | What it shows |
 |---|---|
 | [`examples/minimal_profile.yaml`](examples/minimal_profile.yaml) | Smallest valid profile — one collection, one requirement |
 | [`examples/insitu_observations_profile.yaml`](examples/insitu_observations_profile.yaml) | Full meteorological profile — 8 parameters with QUDT units, CF standard names, metocean extensions, CRS listing, temporal extent, custom dimensions, `parameter_schema` |
+| [`examples/nws_connect_profile.yaml`](examples/nws_connect_profile.yaml) | PubSub profile — generates `asyncapi.yaml` alongside the OpenAPI |
 | [`examples/nwsviz_profile.yaml`](examples/nwsviz_profile.yaml) | Production profile — 13 collections, 3 OGC API Processes, PDF metadata |
+| [`examples/nwp_radar.yaml`](examples/nwp_radar.yaml) | **DGIWG-branded** profile — custom cover logo, DGIWG colours/footer/legal page, `default_output_format`, per-query CRS, vertical `positive`, DGIWG namespace |
+| [`examples/nwp_earth_observations_lightning_profile.yaml`](examples/nwp_earth_observations_lightning_profile.yaml) | DGIWG lightning profile — same branding, CF units |
 
 ---
 
@@ -115,6 +120,8 @@ Add `--pdf` to also compile an OGC-compliant PDF via the `metanorma/metanorma` D
 oapi-profile-builder generate --config my_profile.yaml --output ./output --pdf
 ```
 
+The PDF can be rebranded for another SDO (e.g. DGIWG) — custom cover logo, colours, legal page, footer, and identifier namespace — all from the profile config. See [Document generation and branding](#document-generation-and-branding).
+
 ### `validate`
 
 Validates the config without writing any files. Useful in CI before generating.
@@ -219,6 +226,29 @@ jobs:
 
 ---
 
+## Document generation and branding
+
+With `--pdf`, the builder compiles a Metanorma document (`document.adoc` + `sections/`, `requirements/`, `abstract_tests/`) into `document.pdf` using the official `metanorma/metanorma` Docker image. By default this is an OGC `draft-standard` document.
+
+Everything about the document — cover, title-page metadata, legal page, footer, colours, and even the requirement/conformance identifier namespace — is driven from the profile config, so the same tooling can produce a document branded for another SDO such as **DGIWG** with no OGC branding remaining.
+
+| What you want to change | Field | Mechanism |
+|---|---|---|
+| Cover logo + tagline (replaces the OGC cover) | `document_metadata.cover` | Generated cover image via `:coverpage-image:` full replacement |
+| Title, doc number, edition, dates, sub-title/status | `title`, `version`, `document_metadata.{doc_number, doc_type, doc_subtype, status, *_date}` | Metanorma document attributes |
+| PDF colours (titles, tables, cover, backgrounds) | `document_metadata.colors` | `:presentation-metadata-color-*:` |
+| Page-ii legal text (copyright / license / notice) | `document_metadata.boilerplate` | `:boilerplate-authority:` |
+| Footer organisation name | `document_metadata.copyright_holder` | `:copyright-holder:` |
+| Remove the OGC logo from the legal page | `document_metadata.suppress_flavor_logo` | targeted `:pdf-stylesheet-override:` |
+| Requirement / conformance identifier namespace | `spec_uri_base` | derives `req_uri` / `conf_uri` |
+| Submitter table, notice paragraph, normative refs | `document_metadata.{submitters, notice, normative_references}` | Metanorma attributes / sections |
+
+Custom branding requires Pillow for the cover image: `pip install 'oapi-profile-builder[pdf]'`. Field-by-field detail is in the [`document_metadata`](#document_metadata) reference below; [`examples/nwp_radar.yaml`](examples/nwp_radar.yaml) is a complete DGIWG-branded example.
+
+> The `suppress_flavor_logo` override reaches into the OGC Metanorma flavor's XSL (template `insertLogoPreface`) and is coupled to that flavor. Everything else uses documented Metanorma attributes. For long-term SDO adoption, a dedicated Metanorma "taste"/flavor is the most durable path.
+
+---
+
 ## Profile Config Reference
 
 A profile config is a YAML file. The full JSON Schema is at [`profile.schema.json`](profile.schema.json).
@@ -445,6 +475,61 @@ extent_requirements:
 
 At least one of `extent_crs` or `supported_crs` is required. The same applies to TRS and VRS — all are optional individually but at least one CRS constraint must be present.
 
+#### Vertical direction (`positive`)
+
+OGC API - EDR's vertical extent has no field for which way values increase. This is ambiguous for VRS like pressure levels, which different providers order top-to-bottom or bottom-to-top inconsistently (pressure increases as altitude *decreases*). Set `extent.vertical.positive` to `up` or `down` on a collection (following the CF Conventions `positive` attribute) to make the ordering explicit:
+
+```yaml
+collections:
+  - id: my_collection
+    extent:
+      spatial: { ... }
+      vertical:
+        interval:
+          - ["1000", "100"]   # hPa, surface to top of atmosphere
+        values: ["1000", "850", "700", "500", "300", "100"]
+        vrs: "http://www.opengis.net/def/crs/EPSG/0/5798"  # or similar pressure VRS
+        positive: down   # pressure increases downward, toward the surface
+```
+
+Set `extent_requirements.require_vertical_direction: true` to make `positive` mandatory on every collection with a vertical extent, so a profile can enforce one consistent convention rather than leaving it up to each collection author:
+
+```yaml
+extent_requirements:
+  minimum_bbox: [-180, -90, 180, 90]
+  extent_crs:
+    allowed: ["http://www.opengis.net/def/crs/OGC/1.3/CRS84"]
+  require_vertical_direction: true
+```
+
+---
+
+### `output_formats`
+
+Maps format names (referenced by `collections[].output_formats` and `data_queries.*.variables.output_formats`) to a media type and, optionally, a schema reference. The `schema_ref` flows into the generated OpenAPI response `content` for that format — use it to point a format at a specific schema (e.g. a DGIWG-published schema for GeoTIFF or CoverageJSON) instead of the tool's built-in default.
+
+```yaml
+output_formats:
+  - name: CoverageJSON
+    media_type: application/prs.coverage+json
+    schema_ref: https://schemas.opengis.net/covjson/1.0/coveragejson.json
+  - name: GeoJSON
+    media_type: application/geo+json
+    schema_ref: https://geojson.org/schema/FeatureCollection.json
+  - name: GeoTIFF
+    media_type: image/tiff; application=geotiff
+    # Omit schema_ref until a published schema exists for this format —
+    # the requirement/abstract test can still state the standard to conform to.
+```
+
+| Field | Required | Description |
+|---|---|---|
+| `name` | yes | Format name, referenced elsewhere as a string (e.g. `CoverageJSON`) |
+| `media_type` | yes | MIME type used as the OpenAPI response `content` key and the `f` parameter value |
+| `schema_ref` | no | URL to a JSON Schema (or other schema) for this format. When set, the generated response uses `{"$ref": schema_ref}`; when omitted, a generic/default schema is used |
+
+`schema_ref` is optional — if no schema exists yet for a format (as is currently the case for some binary formats like GeoTIFF), leave it unset and capture the required standard as a normative `requirements[]` entry instead. Add `schema_ref` later once a schema URL exists.
+
 ---
 
 ### `parameter_schema`
@@ -601,6 +686,55 @@ document_metadata:
 
 The cover-page sub-title (e.g. "Draft Standard — Implementation — Approved") is produced by Metanorma from the `doc_type`, `doc_subtype`, and `status` combination.
 
+#### Custom branding (logo + colors)
+
+Two `document_metadata` blocks let you rebrand the PDF (e.g. for DGIWG) without a custom Metanorma flavor:
+
+- **`colors`** — recolours the PDF via Metanorma's `:presentation-metadata-color-*:` attributes. Values are hex colours.
+- **`cover`** — replaces the built-in OGC cover page with a generated one: your logo plus the document's title, number, edition and date. Requires Pillow (`pip install 'oapi-profile-builder[pdf]'`). The builder renders `cover.png` into the output directory and points Metanorma at it via `:coverpage-image:` + `:presentation-metadata-full-coverpage-replacement:`.
+
+```yaml
+document_metadata:
+  doc_number: "DGIWG 134"
+  cover:
+    logo: assets/dgiwg_logo.png    # path relative to the working directory (or absolute)
+    tagline: Delivering Military Advantage through multi-national geospatial interoperability
+    background: "#FFFFFF"          # optional cover background (default white)
+    text_color: "#1F3864"          # optional cover text colour (default black)
+  colors:
+    text: "#000000"                # body text
+    cover_text: "#1F3864"          # cover text / section numbers / ToC
+    cover_lines: "#1F3864"         # preface 'crossing lines' element
+    title: "#1F3864"               # clause/table/figure titles
+    page_background: "#FFFFFF"     # cover + section page background
+    table_header: "#1F3864"        # table header background
+    table_row_even: "#EEF1F7"      # even table rows
+    table_row_odd: "#FFFFFF"       # odd table rows
+```
+
+Note: colours work against the normal OGC cover too. The `cover` block does a *full* cover replacement, so the dynamic title/number/edition/date are drawn onto the generated image (which is why the builder composes it rather than relying on Metanorma attributes — logo attributes like `:coverpage-image:` alone are not rendered by the OGC flavor).
+
+#### De-branding the rest of the document (legal page + footer + logo)
+
+Cover + colors handle the front page, but the OGC flavor also stamps its identity on the page-ii legal boilerplate, the page footer, and an OGC logo on the legal page. Three more `document_metadata` fields remove those:
+
+- **`copyright_holder`** — sets `:copyright-holder:`, which also drives the **PDF footer** organisation name (replacing "OPEN GEOSPATIAL CONSORTIUM").
+- **`boilerplate`** — replaces the page-ii legal text (copyright / license / legal notice / feedback) via `:boilerplate-authority:`. Any field left unset is synthesised from `copyright_holder`, so no OGC text leaks through.
+- **`suppress_flavor_logo`** — removes the OGC logo from the preface/legal page via a targeted PDF-stylesheet override. (Coupled to the OGC Metanorma flavor's XSL.)
+
+```yaml
+document_metadata:
+  copyright_holder: DGIWG
+  suppress_flavor_logo: true
+  boilerplate:
+    copyright: "Copyright © 2026 Defence Geospatial Information Working Group (DGIWG). All rights reserved."
+    license: "Use of this document is subject to the DGIWG terms and conditions."
+    legal: "Attention is drawn to the possibility that some elements may be subject to patent rights; DGIWG shall not be held responsible for identifying any such rights."
+    feedback: "Comments on this document should be directed to DGIWG."
+```
+
+With `cover` + `colors` + `copyright_holder` + `boilerplate` + `suppress_flavor_logo` (and `spec_uri_base` for the requirement/conformance identifiers), the generated PDF carries no OGC branding — only legitimate citations to the OGC standards the profile conforms to. See [`examples/nwp_radar.yaml`](examples/nwp_radar.yaml).
+
 ---
 
 ### `provider`, `classification`, and provenance metadata
@@ -672,6 +806,7 @@ The tool enforces these rules at build time. Violations produce clear error mess
 | Collection TRS validated | Each `extent.temporal.trs` checked against `extent_trs` |
 | `crs_details` / `crs` validated | Each `data_queries.*.variables.crs_details[].crs` and `crs[]` checked against `supported_crs` |
 | `default_output_format` validated | Each `data_queries.*.variables.default_output_format` must be one of that query's `output_formats` |
+| `require_vertical_direction` enforced | If set, every collection with a vertical extent must declare `extent.vertical.positive` as `up` or `down` |
 | Document dates format | `submission_date` / `approval_date` / `publication_date` must be `YYYY-MM-DD` |
 | Parameters need `unit` + `observedProperty` | Required by OGC API - EDR Part 3 |
 | `parameter_name_pattern` enforced | All `parameter_names` keys must match if set |

{oapi_profile_builder-3.1.0 → oapi_profile_builder-3.2.0}/src/oapi_profile_builder.egg-info/SOURCES.txt

@@ -6,6 +6,7 @@ src/oapi_profile_builder/cite.py
 src/oapi_profile_builder/cite_features.py
 src/oapi_profile_builder/cli.py
 src/oapi_profile_builder/compile.py
+src/oapi_profile_builder/cover.py
 src/oapi_profile_builder/generate.py
 src/oapi_profile_builder/models.py
 src/oapi_profile_builder/server_validation.py

{oapi_profile_builder-3.1.0 → oapi_profile_builder-3.2.0}/src/oapi_profile_builder.egg-info/requires.txt

@@ -3,5 +3,8 @@ pydantic>=2.0
 pyyaml>=6.0
 requests>=2.31
 
+[pdf]
+pillow>=10.0
+
 [validate]
 schemathesis>=3.0