@openpresentation/opf 0.1.0

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

@@ -0,0 +1,200 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openpresentation.org/schema/opf-color-scheme/v1",
+  "title": "OPF Color Scheme",
+  "description": "Schema for color-scheme records in the pptx.gallery library. Each scheme is a named palette with the twelve PowerPoint color slots (six accents, two darks, two lights, plus hyperlink and followed-hyperlink), suitable for being mapped directly into OOXML theme XML. Color schemes are referenced from OPF documents via design.colorScheme or design.colorScheme.id; the engine resolves the reference against catalogs.colorSchemes (inline) -> catalogs.colorSchemes.source -> the default catalog at https://www.pptx.gallery/color-schemes. Slot overrides on design.colorScheme take precedence over the resolved scheme.\n\nThe slot fields here mirror the inline-override fields on the in-document ColorScheme type (in opf.schema.json), so library entries and inline OPF overrides are interchangeable.",
+  "type": "object",
+  "required": [
+    "$schema",
+    "id",
+    "name"
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "const": "https://openpresentation.org/schema/opf-color-scheme/v1",
+      "description": "Identifies this record as a color 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 color scheme. Lowercase kebab-case.",
+      "examples": [
+        "cool-horizon",
+        "boost",
+        "burnt-orange",
+        "forest-green"
+      ]
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable scheme name shown in pickers.",
+      "examples": [
+        "Cool Horizon",
+        "Boost",
+        "Burnt Orange",
+        "Forest Green"
+      ]
+    },
+    "summary": {
+      "type": "string",
+      "description": "One-sentence positioning of the palette — what mood it evokes and where to use it.",
+      "examples": [
+        "Cool blue-green palette tuned for B2B SaaS and finance decks.",
+        "High-energy warm palette built around burnt-orange accents."
+      ]
+    },
+    "description": {
+      "type": "string",
+      "description": "Longer prose describing the palette and its intended use.",
+      "examples": [
+        "A balanced cool-toned scheme: a deep navy dark slot pairs with mid-saturation blues and a teal accent for charts and callouts. Works well on both light and dark backgrounds."
+      ]
+    },
+    "accent1": {
+      "type": "string",
+      "description": "Accent 1 color (hex). Mirrors the OOXML accent1 slot.",
+      "examples": [
+        "#2874A6",
+        "#FD3223",
+        "#F77F00"
+      ]
+    },
+    "accent2": {
+      "type": "string",
+      "description": "Accent 2 color (hex). Mirrors the OOXML accent2 slot.",
+      "examples": [
+        "#1B4F72",
+        "#0308DB",
+        "#D62828"
+      ]
+    },
+    "accent3": {
+      "type": "string",
+      "description": "Accent 3 color (hex). Mirrors the OOXML accent3 slot.",
+      "examples": [
+        "#5499C7",
+        "#4F4955",
+        "#003049"
+      ]
+    },
+    "accent4": {
+      "type": "string",
+      "description": "Accent 4 color (hex). Mirrors the OOXML accent4 slot.",
+      "examples": [
+        "#7BDBB2",
+        "#A1DB30",
+        "#FCBF49"
+      ]
+    },
+    "accent5": {
+      "type": "string",
+      "description": "Accent 5 color (hex). Mirrors the OOXML accent5 slot.",
+      "examples": [
+        "#3AC67A",
+        "#0682FE",
+        "#EAE2B7"
+      ]
+    },
+    "accent6": {
+      "type": "string",
+      "description": "Accent 6 color (hex). Mirrors the OOXML accent6 slot.",
+      "examples": [
+        "#24A89E",
+        "#FC03BE",
+        "#BFBFBF"
+      ]
+    },
+    "dark1": {
+      "type": "string",
+      "description": "Dark 1 color (hex). Typically the deepest neutral; OOXML dark1.",
+      "examples": [
+        "#000000"
+      ]
+    },
+    "dark2": {
+      "type": "string",
+      "description": "Dark 2 color (hex). Secondary dark; OOXML dark2.",
+      "examples": [
+        "#011842"
+      ]
+    },
+    "light1": {
+      "type": "string",
+      "description": "Light 1 color (hex). Typically the slide canvas; OOXML lt1.",
+      "examples": [
+        "#FFFFFF"
+      ]
+    },
+    "light2": {
+      "type": "string",
+      "description": "Light 2 color (hex). Secondary light surface; OOXML lt2.",
+      "examples": [
+        "#F0F0F0"
+      ]
+    },
+    "hyperlink": {
+      "type": "string",
+      "description": "Hyperlink color (hex). OOXML hlink.",
+      "examples": [
+        "#0563C1"
+      ]
+    },
+    "followedHyperlink": {
+      "type": "string",
+      "description": "Followed-hyperlink color (hex). OOXML folHlink.",
+      "examples": [
+        "#954F72"
+      ]
+    },
+    "tags": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Free-form labels for filtering and search.",
+      "examples": [
+        [
+          "corporate",
+          "blue",
+          "calm"
+        ],
+        [
+          "bold",
+          "warm",
+          "high-energy"
+        ]
+      ]
+    },
+    "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/color-schemes/cool-horizon.png"
+          ]
+        },
+        "thumbnailSrc": {
+          "type": "string",
+          "format": "uri",
+          "description": "Smaller thumbnail preview suited to dense grid views.",
+          "examples": [
+            "https://www.pptx.gallery/color-schemes/cool-horizon.thumbnail.png"
+          ]
+        },
+        "vectorSrc": {
+          "type": "string",
+          "format": "uri",
+          "description": "SVG / vector preview for crisp scaling at any size.",
+          "examples": [
+            "https://www.pptx.gallery/color-schemes/cool-horizon.svg"
+          ]
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +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"
+          ]
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +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"
+          ]
+        }
+      }
+    }
+  }
+}