@openpresentation/opf 0.1.0 → 0.2.2

package/dist/spec/schemas/font-scheme.schema.json

@@ -1,174 +1,174 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://openpresentation.org/schema/opf-font-scheme/v1",
-  "title": "OPF Font Scheme",
-  "description": "Schema for font-scheme records in the pptx.gallery library. Each scheme pairs a major (heading) and minor (body) font family in the OOXML majorFont/minorFont sense, scoped to a target app (PowerPoint or Google Slides) and a language family (Latin, East Asian, or Complex Script). Font schemes are referenced from OPF documents via design.fontScheme or design.fontScheme.id; the engine resolves the reference against catalogs.fontSchemes (inline) → catalogs.fontSchemes.source → the default catalog at https://www.pptx.gallery/font-schemes. Role overrides on design.fontScheme (heading, body, accent, code) take precedence over the resolved scheme.",
-  "type": "object",
-  "required": [
-    "$schema",
-    "id",
-    "name",
-    "major",
-    "minor"
-  ],
-  "properties": {
-    "$schema": {
-      "type": "string",
-      "const": "https://openpresentation.org/schema/opf-font-scheme/v1",
-      "description": "Identifies this record as a font scheme in the openpresentation.org catalog."
-    },
-    "id": {
-      "type": "string",
-      "pattern": "^[a-z][a-z0-9-]*$",
-      "description": "Stable slug used by OPF documents to reference this font scheme. Lowercase kebab-case.",
-      "examples": [
-        "aptos",
-        "tenorite",
-        "seaford",
-        "noto-sans",
-        "microsoft-yahei"
-      ]
-    },
-    "name": {
-      "type": "string",
-      "description": "Human-readable scheme name shown in pickers.",
-      "examples": [
-        "Aptos",
-        "Tenorite",
-        "Seaford",
-        "Noto Sans",
-        "Microsoft Yahei"
-      ]
-    },
-    "major": {
-      "type": "string",
-      "description": "Heading (major) font family — mirrors the OOXML majorFont entry.",
-      "examples": [
-        "Aptos Display",
-        "Calibri",
-        "Microsoft YaHei"
-      ]
-    },
-    "minor": {
-      "type": "string",
-      "description": "Body (minor) font family — mirrors the OOXML minorFont entry.",
-      "examples": [
-        "Aptos",
-        "Calibri",
-        "Microsoft YaHei"
-      ]
-    },
-    "type": {
-      "type": "string",
-      "enum": [
-        "sans-serif",
-        "serif",
-        "monospace"
-      ],
-      "description": "High-level typographic class of the scheme."
-    },
-    "app": {
-      "type": "string",
-      "enum": [
-        "PowerPoint",
-        "Google Slides"
-      ],
-      "description": "Target application this font pairing is intended for."
-    },
-    "languageFamily": {
-      "type": "string",
-      "enum": [
-        "latin",
-        "ea",
-        "cs"
-      ],
-      "description": "OOXML font-language family this scheme is intended for: 'latin' for Latin-script content, 'ea' for East Asian scripts, 'cs' for Complex Scripts."
-    },
-    "languages": {
-      "type": "array",
-      "items": {
-        "type": "string"
-      },
-      "description": "Optional list of human-readable language names this scheme is curated for. Useful for picker UIs that group fonts by language coverage.",
-      "examples": [
-        [
-          "Chinese (simplified)",
-          "Chinese (traditional)",
-          "Japanese",
-          "Korean"
-        ]
-      ]
-    },
-    "textSample": {
-      "type": "string",
-      "description": "Short specimen string used by picker UIs to preview the scheme.",
-      "examples": [
-        "Smooth professional look",
-        "这是用微软雅黑字体写的"
-      ]
-    },
-    "summary": {
-      "type": "string",
-      "description": "One-sentence positioning of the font pairing.",
-      "examples": [
-        "PowerPoint-default sans-serif curated for general business decks.",
-        "East-Asian sans-serif suitable for Chinese, Japanese, and Korean content."
-      ]
-    },
-    "description": {
-      "type": "string",
-      "description": "Longer prose describing the font scheme and where it shines.",
-      "examples": [
-        "Aptos is the default Microsoft 365 sans-serif. The major (display) cut adds optical weight for headings, and the minor (text) cut keeps body copy readable at smaller sizes."
-      ]
-    },
-    "tags": {
-      "type": "array",
-      "items": {
-        "type": "string"
-      },
-      "description": "Free-form labels for filtering and search.",
-      "examples": [
-        [
-          "latin",
-          "sans-serif",
-          "default"
-        ],
-        [
-          "east-asian",
-          "system"
-        ]
-      ]
-    },
-    "preview": {
-      "type": "object",
-      "description": "Visual previews of the record, used by picker UIs and inline rendering. All sub-fields are optional; engines fall back gracefully when previews aren't available.",
-      "properties": {
-        "src": {
-          "type": "string",
-          "format": "uri",
-          "description": "Main preview image (PNG/JPG). Used as the primary visual in picker UIs and previews of the record.",
-          "examples": [
-            "https://www.pptx.gallery/font-schemes/aptos.png"
-          ]
-        },
-        "thumbnailSrc": {
-          "type": "string",
-          "format": "uri",
-          "description": "Smaller thumbnail preview suited to dense grid views.",
-          "examples": [
-            "https://www.pptx.gallery/font-schemes/aptos.thumbnail.png"
-          ]
-        },
-        "vectorSrc": {
-          "type": "string",
-          "format": "uri",
-          "description": "SVG / vector preview for crisp scaling at any size.",
-          "examples": [
-            "https://www.pptx.gallery/font-schemes/aptos.svg"
-          ]
-        }
-      }
-    }
-  }
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openpresentation.org/schema/opf-font-scheme/v1",
+  "title": "Font Scheme",
+  "description": "Schema for font-scheme records in the pptx.gallery library. Each scheme pairs a major (heading) and minor (body) font family in the OOXML majorFont/minorFont sense, scoped to a target app (PowerPoint or Google Slides) and a language family (Latin, East Asian, or Complex Script). Font schemes are referenced from OPF documents via design.fontScheme or design.fontScheme.id; the engine resolves the reference against catalogs.fontSchemes (inline) → catalogs.fontSchemes.source → the default catalog at https://www.pptx.gallery/font-schemes. Role overrides on design.fontScheme (heading, body, accent, code) take precedence over the resolved scheme.",
+  "type": "object",
+  "required": [
+    "$schema",
+    "id",
+    "name",
+    "major",
+    "minor"
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "const": "https://openpresentation.org/schema/opf-font-scheme/v1",
+      "description": "Identifies this record as a font scheme in the openpresentation.org catalog."
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "description": "Stable slug used by OPF documents to reference this font scheme. Lowercase kebab-case.",
+      "examples": [
+        "aptos",
+        "tenorite",
+        "seaford",
+        "noto-sans",
+        "microsoft-yahei"
+      ]
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable scheme name shown in pickers.",
+      "examples": [
+        "Aptos",
+        "Tenorite",
+        "Seaford",
+        "Noto Sans",
+        "Microsoft Yahei"
+      ]
+    },
+    "major": {
+      "type": "string",
+      "description": "Heading (major) font family — mirrors the OOXML majorFont entry.",
+      "examples": [
+        "Aptos Display",
+        "Calibri",
+        "Microsoft YaHei"
+      ]
+    },
+    "minor": {
+      "type": "string",
+      "description": "Body (minor) font family — mirrors the OOXML minorFont entry.",
+      "examples": [
+        "Aptos",
+        "Calibri",
+        "Microsoft YaHei"
+      ]
+    },
+    "type": {
+      "type": "string",
+      "enum": [
+        "sans-serif",
+        "serif",
+        "monospace"
+      ],
+      "description": "High-level typographic class of the scheme."
+    },
+    "app": {
+      "type": "string",
+      "enum": [
+        "PowerPoint",
+        "Google Slides"
+      ],
+      "description": "Target application this font pairing is intended for."
+    },
+    "languageFamily": {
+      "type": "string",
+      "enum": [
+        "latin",
+        "ea",
+        "cs"
+      ],
+      "description": "OOXML font-language family this scheme is intended for: 'latin' for Latin-script content, 'ea' for East Asian scripts, 'cs' for Complex Scripts."
+    },
+    "languages": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Optional list of human-readable language names this scheme is curated for. Useful for picker UIs that group fonts by language coverage.",
+      "examples": [
+        [
+          "Chinese (simplified)",
+          "Chinese (traditional)",
+          "Japanese",
+          "Korean"
+        ]
+      ]
+    },
+    "textSample": {
+      "type": "string",
+      "description": "Short specimen string used by picker UIs to preview the scheme.",
+      "examples": [
+        "Smooth professional look",
+        "这是用微软雅黑字体写的"
+      ]
+    },
+    "summary": {
+      "type": "string",
+      "description": "One-sentence positioning of the font pairing.",
+      "examples": [
+        "PowerPoint-default sans-serif curated for general business decks.",
+        "East-Asian sans-serif suitable for Chinese, Japanese, and Korean content."
+      ]
+    },
+    "description": {
+      "type": "string",
+      "description": "Longer prose describing the font scheme and where it shines.",
+      "examples": [
+        "Aptos is the default Microsoft 365 sans-serif. The major (display) cut adds optical weight for headings, and the minor (text) cut keeps body copy readable at smaller sizes."
+      ]
+    },
+    "tags": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Free-form labels for filtering and search.",
+      "examples": [
+        [
+          "latin",
+          "sans-serif",
+          "default"
+        ],
+        [
+          "east-asian",
+          "system"
+        ]
+      ]
+    },
+    "preview": {
+      "type": "object",
+      "description": "Visual previews of the record, used by picker UIs and inline rendering. All sub-fields are optional; engines fall back gracefully when previews aren't available.",
+      "properties": {
+        "src": {
+          "type": "string",
+          "format": "uri",
+          "description": "Main preview image (PNG/JPG). Used as the primary visual in picker UIs and previews of the record.",
+          "examples": [
+            "https://www.pptx.gallery/font-schemes/aptos.png"
+          ]
+        },
+        "thumbnailSrc": {
+          "type": "string",
+          "format": "uri",
+          "description": "Smaller thumbnail preview suited to dense grid views.",
+          "examples": [
+            "https://www.pptx.gallery/font-schemes/aptos.thumbnail.png"
+          ]
+        },
+        "vectorSrc": {
+          "type": "string",
+          "format": "uri",
+          "description": "SVG / vector preview for crisp scaling at any size.",
+          "examples": [
+            "https://www.pptx.gallery/font-schemes/aptos.svg"
+          ]
+        }
+      }
+    }
+  }
+}