@openpresentation/opf 0.1.0 → 0.2.2

package/dist/spec/schemas/language.schema.json

@@ -1,158 +1,158 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://openpresentation.org/schema/opf-language/v1",
-  "title": "OPF Language",
-  "description": "Schema for language records in the pptx.gallery library. Each record names a presentation language, carries a BCP-47 language tag, and pairs it with sensible default font schemes for PowerPoint and Google Slides output. Languages are referenced from OPF documents via language; the engine resolves the reference against catalogs.languages (inline) → catalogs.languages.source → the default catalog at https://www.pptx.gallery/languages. The presentation language field also accepts BCP-47 tags directly or inline Language objects for engine-aware language records that carry default-font hints.",
-  "type": "object",
-  "required": [
-    "$schema",
-    "id",
-    "name",
-    "bcp47"
-  ],
-  "properties": {
-    "$schema": {
-      "type": "string",
-      "const": "https://openpresentation.org/schema/opf-language/v1",
-      "description": "Identifies this record as a language in the openpresentation.org catalog."
-    },
-    "id": {
-      "type": "string",
-      "pattern": "^[a-z][a-z0-9-]*$",
-      "description": "Stable slug used by OPF documents to reference this language via language. Lowercase kebab-case.",
-      "examples": [
-        "english",
-        "spanish",
-        "japanese",
-        "chinese-simplified"
-      ]
-    },
-    "name": {
-      "type": "string",
-      "description": "Human-readable language name.",
-      "examples": [
-        "English",
-        "Spanish",
-        "Japanese",
-        "Chinese (simplified)"
-      ]
-    },
-    "code": {
-      "type": "string",
-      "description": "ISO 639-3 (or 639-2) three-letter language code. Carried for engines that prefer ISO codes.",
-      "examples": [
-        "ENG",
-        "SPA",
-        "FRA",
-        "JPN",
-        "CHI"
-      ]
-    },
-    "bcp47": {
-      "type": "string",
-      "description": "BCP-47 language tag for this record. Use 'en-GB' for UK English; 'en-UK' is not a valid BCP-47 region form.",
-      "examples": [
-        "en",
-        "en-US",
-        "en-GB",
-        "es-MX",
-        "ja-JP",
-        "zh-Hans"
-      ]
-    },
-    "direction": {
-      "type": "string",
-      "enum": ["ltr", "rtl"],
-      "description": "Base text direction for the language.",
-      "examples": ["ltr", "rtl"]
-    },
-    "script": {
-      "type": "string",
-      "description": "ISO 15924 script code when the writing system should be explicit.",
-      "examples": ["Latn", "Arab", "Cyrl", "Hans", "Hant"]
-    },
-    "fontScheme": {
-      "type": "string",
-      "description": "Default font-scheme id for this language when targeting PowerPoint output. Resolves against catalogs.fontSchemes the same way design.fontScheme or design.fontScheme.id does.",
-      "examples": [
-        "aptos",
-        "microsoft-yahei",
-        "nirmala-ui"
-      ]
-    },
-    "googleFontScheme": {
-      "type": "string",
-      "description": "Default font-scheme id for this language when targeting Google Slides output. Resolves against catalogs.fontSchemes the same way design.fontScheme or design.fontScheme.id does.",
-      "examples": [
-        "roboto",
-        "noto-sans",
-        "noto-sans-sc"
-      ]
-    },
-    "summary": {
-      "type": "string",
-      "description": "One-sentence note about coverage or font defaults.",
-      "examples": [
-        "English language preset using a Latin-script font scheme.",
-        "Japanese language preset paired with a Microsoft YaHei East-Asian scheme."
-      ]
-    },
-    "description": {
-      "type": "string",
-      "description": "Longer prose describing the language record and any font-pairing rationale.",
-      "examples": [
-        "English (US) preset. Defaults to Aptos for PowerPoint output and Roboto for Google Slides output. Use this entry as a baseline; override fontScheme on individual decks when brand fonts differ."
-      ]
-    },
-    "tags": {
-      "type": "array",
-      "items": {
-        "type": "string"
-      },
-      "description": "Free-form labels for filtering and search.",
-      "examples": [
-        [
-          "latin",
-          "default"
-        ],
-        [
-          "east-asian"
-        ],
-        [
-          "complex-script",
-          "rtl"
-        ]
-      ]
-    },
-    "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/languages/english.png"
-          ]
-        },
-        "thumbnailSrc": {
-          "type": "string",
-          "format": "uri",
-          "description": "Smaller thumbnail preview suited to dense grid views.",
-          "examples": [
-            "https://www.pptx.gallery/languages/english.thumbnail.png"
-          ]
-        },
-        "vectorSrc": {
-          "type": "string",
-          "format": "uri",
-          "description": "SVG / vector preview for crisp scaling at any size.",
-          "examples": [
-            "https://www.pptx.gallery/languages/english.svg"
-          ]
-        }
-      }
-    }
-  }
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openpresentation.org/schema/opf-language/v1",
+  "title": "Language",
+  "description": "Schema for language records in the pptx.gallery library. Each record names a presentation language, carries a BCP-47 language tag, and pairs it with sensible default font schemes for PowerPoint and Google Slides output. Languages are referenced from OPF documents via language; the engine resolves the reference against catalogs.languages (inline) → catalogs.languages.source → the default catalog at https://www.pptx.gallery/languages. The presentation language field also accepts BCP-47 tags directly or inline Language objects for engine-aware language records that carry default-font hints.",
+  "type": "object",
+  "required": [
+    "$schema",
+    "id",
+    "name",
+    "bcp47"
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "const": "https://openpresentation.org/schema/opf-language/v1",
+      "description": "Identifies this record as a language in the openpresentation.org catalog."
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "description": "Stable slug used by OPF documents to reference this language via language. Lowercase kebab-case.",
+      "examples": [
+        "english",
+        "spanish",
+        "japanese",
+        "chinese-simplified"
+      ]
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable language name.",
+      "examples": [
+        "English",
+        "Spanish",
+        "Japanese",
+        "Chinese (simplified)"
+      ]
+    },
+    "code": {
+      "type": "string",
+      "description": "ISO 639-3 (or 639-2) three-letter language code. Carried for engines that prefer ISO codes.",
+      "examples": [
+        "ENG",
+        "SPA",
+        "FRA",
+        "JPN",
+        "CHI"
+      ]
+    },
+    "bcp47": {
+      "type": "string",
+      "description": "BCP-47 language tag for this record. Use 'en-GB' for UK English; 'en-UK' is not a valid BCP-47 region form.",
+      "examples": [
+        "en",
+        "en-US",
+        "en-GB",
+        "es-MX",
+        "ja-JP",
+        "zh-Hans"
+      ]
+    },
+    "direction": {
+      "type": "string",
+      "enum": ["ltr", "rtl"],
+      "description": "Base text direction for the language.",
+      "examples": ["ltr", "rtl"]
+    },
+    "script": {
+      "type": "string",
+      "description": "ISO 15924 script code when the writing system should be explicit.",
+      "examples": ["Latn", "Arab", "Cyrl", "Hans", "Hant"]
+    },
+    "fontScheme": {
+      "type": "string",
+      "description": "Default font-scheme id for this language when targeting PowerPoint output. Resolves against catalogs.fontSchemes the same way design.fontScheme or design.fontScheme.id does.",
+      "examples": [
+        "aptos",
+        "microsoft-yahei",
+        "nirmala-ui"
+      ]
+    },
+    "googleFontScheme": {
+      "type": "string",
+      "description": "Default font-scheme id for this language when targeting Google Slides output. Resolves against catalogs.fontSchemes the same way design.fontScheme or design.fontScheme.id does.",
+      "examples": [
+        "roboto",
+        "noto-sans",
+        "noto-sans-sc"
+      ]
+    },
+    "summary": {
+      "type": "string",
+      "description": "One-sentence note about coverage or font defaults.",
+      "examples": [
+        "English language preset using a Latin-script font scheme.",
+        "Japanese language preset paired with a Microsoft YaHei East-Asian scheme."
+      ]
+    },
+    "description": {
+      "type": "string",
+      "description": "Longer prose describing the language record and any font-pairing rationale.",
+      "examples": [
+        "English (US) preset. Defaults to Aptos for PowerPoint output and Roboto for Google Slides output. Use this entry as a baseline; override fontScheme on individual decks when brand fonts differ."
+      ]
+    },
+    "tags": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Free-form labels for filtering and search.",
+      "examples": [
+        [
+          "latin",
+          "default"
+        ],
+        [
+          "east-asian"
+        ],
+        [
+          "complex-script",
+          "rtl"
+        ]
+      ]
+    },
+    "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/languages/english.png"
+          ]
+        },
+        "thumbnailSrc": {
+          "type": "string",
+          "format": "uri",
+          "description": "Smaller thumbnail preview suited to dense grid views.",
+          "examples": [
+            "https://www.pptx.gallery/languages/english.thumbnail.png"
+          ]
+        },
+        "vectorSrc": {
+          "type": "string",
+          "format": "uri",
+          "description": "SVG / vector preview for crisp scaling at any size.",
+          "examples": [
+            "https://www.pptx.gallery/languages/english.svg"
+          ]
+        }
+      }
+    }
+  }
+}