@openpresentation/opf 0.10.1 → 0.11.1

package/dist/spec/reference/font-policy.schema.json

@@ -0,0 +1,328 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openpresentation.org/schema/opf-font-policy/v1",
+  "title": "OPF font policy",
+  "description": "Schema for spec/reference/font-policy.json (font-fidelity-everywhere FF-31): one row per font family with its license class, viewer availability, whether OPF may embed it, and the openly licensed replacement a renderer previews it with. Reference data for engines, not part of the OPF document contract.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "provisionalDecisions",
+    "description",
+    "version",
+    "measurement",
+    "families"
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string"
+    },
+    "provisionalDecisions": {
+      "description": "The one place provisional owner decisions live. Rows whose replacement names a decision take its family and compatibility from it.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "status",
+        "note",
+        "decisions"
+      ],
+      "properties": {
+        "status": {
+          "type": "string",
+          "pattern": "provisional"
+        },
+        "note": {
+          "type": "string",
+          "minLength": 1
+        },
+        "decisions": {
+          "type": "object",
+          "minProperties": 1,
+          "propertyNames": {
+            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+          },
+          "additionalProperties": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "replacement",
+              "compatibility"
+            ],
+            "properties": {
+              "replacement": {
+                "$ref": "#/$defs/family"
+              },
+              "compatibility": {
+                "$ref": "#/$defs/compatibility"
+              },
+              "metricModeFallback": {
+                "description": "Metric-mode registries still preview with this visual replacement (reported as visual) so an earlier metric behaviour does not regress.",
+                "type": "boolean"
+              },
+              "note": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    },
+    "description": {
+      "type": "string",
+      "minLength": 1
+    },
+    "version": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "measurement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "tool",
+        "corpus",
+        "evidence",
+        "definition"
+      ],
+      "properties": {
+        "tool": {
+          "type": "string"
+        },
+        "corpus": {
+          "type": "string"
+        },
+        "evidence": {
+          "type": "string"
+        },
+        "definition": {
+          "type": "string"
+        }
+      }
+    },
+    "families": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/$defs/entry"
+      }
+    }
+  },
+  "$defs": {
+    "family": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^[^\\u0000-\\u001f\"'\\\\<>;]+$"
+    },
+    "compatibility": {
+      "enum": [
+        "metric",
+        "visual"
+      ]
+    },
+    "share": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 1
+    },
+    "measured": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "replacement",
+        "meanAbsWidthDelta",
+        "meanWidthDelta",
+        "maxAbsWidthDelta",
+        "styles",
+        "reference"
+      ],
+      "properties": {
+        "replacement": {
+          "$ref": "#/$defs/family"
+        },
+        "meanAbsWidthDelta": {
+          "$ref": "#/$defs/share"
+        },
+        "meanWidthDelta": {
+          "type": "number",
+          "minimum": -1,
+          "maximum": 1
+        },
+        "maxAbsWidthDelta": {
+          "$ref": "#/$defs/share"
+        },
+        "styles": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 4
+        },
+        "reference": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "replacement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "measured"
+      ],
+      "properties": {
+        "family": {
+          "$ref": "#/$defs/family"
+        },
+        "compatibility": {
+          "$ref": "#/$defs/compatibility"
+        },
+        "decision": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+        },
+        "weight": {
+          "type": "integer",
+          "minimum": 100,
+          "maximum": 900
+        },
+        "measured": {
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/$defs/measured"
+            }
+          ]
+        },
+        "source": {
+          "type": "string",
+          "format": "uri"
+        }
+      },
+      "if": {
+        "properties": {
+          "decision": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "decision"
+        ]
+      },
+      "then": {
+        "properties": {
+          "family": false,
+          "compatibility": false
+        }
+      },
+      "else": {
+        "properties": {
+          "family": {
+            "$ref": "#/$defs/family"
+          },
+          "compatibility": {
+            "$ref": "#/$defs/compatibility"
+          }
+        },
+        "required": [
+          "family",
+          "compatibility"
+        ]
+      }
+    },
+    "entry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "family",
+        "licenseClass",
+        "license",
+        "availability",
+        "embeddableByOpf",
+        "replacement",
+        "sources"
+      ],
+      "properties": {
+        "family": {
+          "$ref": "#/$defs/family"
+        },
+        "licenseClass": {
+          "enum": [
+            "open",
+            "proprietary-standard",
+            "proprietary-nonstandard"
+          ]
+        },
+        "license": {
+          "type": "string",
+          "minLength": 1
+        },
+        "availability": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "enum": [
+              "windows",
+              "windows-optional",
+              "macos",
+              "office",
+              "office-cloud"
+            ]
+          }
+        },
+        "embeddableByOpf": {
+          "type": "boolean"
+        },
+        "replacement": {
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/$defs/replacement"
+            }
+          ]
+        },
+        "alternates": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/family"
+          }
+        },
+        "sources": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string",
+            "format": "uri",
+            "pattern": "^https://"
+          }
+        },
+        "note": {
+          "type": "string"
+        }
+      },
+      "if": {
+        "properties": {
+          "licenseClass": {
+            "const": "open"
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "embeddableByOpf": {
+            "const": true
+          }
+        }
+      },
+      "else": {
+        "properties": {
+          "embeddableByOpf": {
+            "const": false
+          }
+        }
+      }
+    }
+  }
+}

package/dist/spec/schemas/chart-type.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://openpresentation.org/schema/opf-chart-type/v1",
   "title": "Chart Type",
-  "description": "Schema for chart-type records in the pptx.gallery catalog. Each record describes a named chart variant, its Open XML mapping, its series/category cardinality, the column structure of the underlying workbook, and a small sample dataset suitable for previews. Chart types are referenced from OPF chart content payloads; the engine resolves the reference against catalogs.chartTypes (inline) -> catalogs.chartTypes.source -> the default catalog at https://www.pptx.gallery/chart-types.",
+  "description": "Schema for chart-type records in the pptx.gallery catalog. The bundled catalog holds one record per chart type that Aspose.Slides officially supports (see mappings.renderers[\"aspose-slides\"].chartType). Each record describes a named chart variant, its Open XML mapping, its series/category cardinality, the column structure of the underlying workbook, and a small sample dataset suitable for previews. Chart types are referenced from OPF chart content payloads; the engine resolves the reference against catalogs.chartTypes (inline) -> catalogs.chartTypes.source -> the default catalog at https://www.pptx.gallery/chart-types.",
   "type": "object",
   "additionalProperties": false,
   "required": [
@@ -23,11 +23,11 @@
       "description": "Stable slug used by OPF documents to reference this chart type. Lowercase kebab-case. Chart type ids may start with a digit (e.g., '100pct-stacked-column', '3d-column') to mirror conventional chart naming.",
       "examples": [
         "column",
-        "clustered-column",
-        "stacked-column",
+        "bar",
+        "stacked-column-3x",
         "doughnut",
-        "bullet-column",
-        "100pct-stacked-column"
+        "treemap",
+        "100pct-stacked-column-3x"
       ]
     },
     "name": {
@@ -35,9 +35,9 @@
       "description": "Stable display/programmatic name for this chart type.",
       "examples": [
         "COLUMN",
-        "CLUSTERED_COLUMN",
+        "STACKED_COLUMN_3X",
         "DOUGHNUT",
-        "BULLET_COLUMN"
+        "TREEMAP"
       ]
     },
     "label": {
@@ -45,9 +45,9 @@
       "description": "Human-readable label shown in chart pickers.",
       "examples": [
         "Column",
-        "Clustered Column",
+        "Stacked Column",
         "Doughnut",
-        "Bullet Column"
+        "Treemap"
       ]
     },
     "summary": {
@@ -69,6 +69,10 @@
       "$ref": "#/$defs/ChartTypeMappings",
       "description": "Canonical and optional renderer-specific mappings used by engines to render this chart type."
     },
+    "deprecation": {
+      "$ref": "#/$defs/ChartTypeDeprecation",
+      "description": "Present when this chart type is deprecated. Deprecated records stay resolvable so existing documents keep validating, but pickers and default listings exclude them, validators warn when a document references them, and they are removed in the release named by `removal`."
+    },
     "group": {
       "type": "string",
       "description": "Top-level grouping in the chart picker (column, bar, line, area, pie, radar, etc.).",
@@ -305,6 +309,35 @@
     }
   },
   "$defs": {
+    "ChartTypeDeprecation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "replacedBy"
+      ],
+      "properties": {
+        "replacedBy": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9-]*$",
+          "description": "Id of the non-deprecated chart type that documents should reference instead.",
+          "examples": [
+            "column",
+            "stacked-column-3x"
+          ]
+        },
+        "reason": {
+          "type": "string",
+          "description": "Why the record is deprecated."
+        },
+        "removal": {
+          "type": "string",
+          "description": "Package version in which the record is scheduled for removal from the bundled catalog.",
+          "examples": [
+            "0.12.0"
+          ]
+        }
+      }
+    },
     "ChartTypeMappings": {
       "type": "object",
       "additionalProperties": false,
@@ -318,11 +351,18 @@
         },
         "renderers": {
           "type": "object",
-          "description": "Optional renderer-specific mappings. Keys are renderer ids; values are intentionally opaque to OPF.",
+          "description": "Optional renderer-specific mappings. Keys are renderer ids; values are intentionally opaque to OPF. The bundled catalog records the matching Aspose.Slides ChartType enumeration member under the \"aspose-slides\" key, e.g. {\"aspose-slides\": {\"chartType\": \"StackedColumn\"}}.",
           "additionalProperties": {
             "type": "object",
             "additionalProperties": true
-          }
+          },
+          "examples": [
+            {
+              "aspose-slides": {
+                "chartType": "ClusteredColumn"
+              }
+            }
+          ]
         }
       }
     },

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

@@ -58,6 +58,96 @@
         "Microsoft YaHei"
       ]
     },
+    "code": {
+      "type": "object",
+      "description": "Optional monospaced font for code blocks and inline code. It has the same shape as the OPF FontScheme 'code' role, so a record and an inline design.fontScheme override are interchangeable. OOXML has no code slot, so exporters write this family on code runs. When neither design.fontScheme nor the resolved record defines 'code', engines fall back to Roboto Mono.",
+      "required": [
+        "family"
+      ],
+      "properties": {
+        "family": {
+          "type": "string",
+          "description": "Monospaced font family name.",
+          "examples": [
+            "Consolas",
+            "Courier New"
+          ]
+        },
+        "weight": {
+          "type": "number",
+          "description": "Numeric font weight (e.g., 400 for regular, 700 for bold)."
+        },
+        "style": {
+          "type": "string",
+          "enum": [
+            "normal",
+            "italic"
+          ],
+          "description": "Font style."
+        },
+        "letterSpacing": {
+          "type": "number",
+          "description": "Letter spacing (tracking) in ems."
+        }
+      },
+      "examples": [
+        {
+          "family": "Consolas"
+        }
+      ]
+    },
+    "eastAsian": {
+      "type": "object",
+      "additionalProperties": false,
+      "minProperties": 1,
+      "description": "East Asian script fonts. Maps to the OOXML a:ea element of majorFont (major) and minorFont (minor), and to run-level a:ea. When set, they fill the eastAsian slot for every language; when omitted, the slot comes from this scheme's own major/minor when languageFamily is 'ea' and the scheme's languages list is empty or names the presentation language, then from the presentation language's font scheme for East Asian languages, and otherwise from the latin (major/minor) families. A missing 'major' or 'minor' falls back to the other.",
+      "properties": {
+        "major": {
+          "type": "string",
+          "description": "Heading (major) eastAsian font family — mirrors majorFont a:ea.",
+          "examples": [
+            "Noto Sans JP",
+            "Meiryo",
+            "Microsoft YaHei"
+          ]
+        },
+        "minor": {
+          "type": "string",
+          "description": "Body (minor) eastAsian font family — mirrors minorFont a:ea.",
+          "examples": [
+            "Noto Sans JP",
+            "Meiryo",
+            "Microsoft YaHei"
+          ]
+        }
+      }
+    },
+    "complexScript": {
+      "type": "object",
+      "additionalProperties": false,
+      "minProperties": 1,
+      "description": "Complex-script fonts (for example Arabic, Hebrew, Indic and Thai). Maps to the OOXML a:cs element of majorFont (major) and minorFont (minor), and to run-level a:cs. When set, they fill the complexScript slot for every language; when omitted, the slot comes from this scheme's own major/minor when languageFamily is 'cs' and the scheme's languages list is empty or names the presentation language, then from the presentation language's font scheme for complex-script languages, and otherwise from the latin (major/minor) families. A missing 'major' or 'minor' falls back to the other.",
+      "properties": {
+        "major": {
+          "type": "string",
+          "description": "Heading (major) complexScript font family — mirrors majorFont a:cs.",
+          "examples": [
+            "Noto Sans Arabic",
+            "Arial",
+            "Mangal"
+          ]
+        },
+        "minor": {
+          "type": "string",
+          "description": "Body (minor) complexScript font family — mirrors minorFont a:cs.",
+          "examples": [
+            "Noto Sans Arabic",
+            "Arial",
+            "Mangal"
+          ]
+        }
+      }
+    },
     "type": {
       "type": "string",
       "enum": [
@@ -82,7 +172,7 @@
         "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."
+      "description": "OOXML font-language family this scheme is intended for: 'latin' for Latin-script content, 'ea' for East Asian scripts, 'cs' for Complex Scripts. As the design font scheme, an 'ea' or 'cs' scheme also fills that script slot with its own major/minor families when its languages list is empty or names the presentation language."
     },
     "languages": {
       "type": "array",

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

@@ -60,20 +60,25 @@
         "zh-Hans"
       ]
     },
+    "ooxmlLang": {
+      "type": "string",
+      "description": "Curated culture tag for OOXML text-run language attributes (a:rPr/@lang, a:endParaRPr/@lang), in the language-[Script-]REGION form Office recognizes (e.g. 'ja-JP', 'ar-SA', 'ms-MY', 'nb-NO', 'fil-PH', 'zh-CN'). Engines emit it instead of 'bcp47' when the document names the language by catalog id or by a tag without a region; a region-bearing tag written by the author is emitted as written. Curated rather than inferred so output does not depend on the runtime's locale data.",
+      "examples": ["en-US", "ja-JP", "ar-SA", "ms-MY", "nb-NO", "zh-CN"]
+    },
     "direction": {
       "type": "string",
       "enum": ["ltr", "rtl"],
-      "description": "Base text direction for the language.",
+      "description": "Base text direction for the language. When omitted, engines derive it from the script: Arabic (Arab), Hebrew (Hebr), Syriac (Syrc), Thaana (Thaa), N'Ko (Nkoo), Adlam (Adlm), Samaritan (Samr), Mandaic (Mand) and Hanifi Rohingya (Rohg) are right-to-left; every other script is left-to-right. Bundled language records state it explicitly.",
       "examples": ["ltr", "rtl"]
     },
     "script": {
       "type": "string",
-      "description": "ISO 15924 script code when the writing system should be explicit.",
-      "examples": ["Latn", "Arab", "Cyrl", "Hans", "Hant"]
+      "description": "ISO 15924 script code of the language's writing system. The script selects the OOXML font slot the language's text uses: East Asian scripts (Hans, Hant, Hani, Jpan, Kore, Hang, Hira, Kana, Bopo, Yiii) use the eastAsian slot; complex scripts (for example Arab, Hebr, Syrc, Thaa, Deva, Beng, Guru, Gujr, Orya, Taml, Telu, Knda, Mlym, Sinh, Thai, Laoo, Tibt, Mymr, Khmr, Mong) use the complexScript slot; every other script (Latn, Cyrl, Grek, Armn, Geor, Ethi, ...) uses the latin slot. When omitted, engines infer it from the BCP-47 tag. Bundled language records state it explicitly. See docs/programs/font-fidelity-everywhere/script-font-model.md.",
+      "examples": ["Latn", "Cyrl", "Grek", "Arab", "Hebr", "Jpan", "Kore", "Hans", "Hant", "Deva", "Thai"]
     },
     "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.",
+      "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. Its major/minor families fill the language's script slot (eastAsian or complexScript, chosen by 'script') unless the effective design font scheme sets that slot itself; the latin slot always follows the design font scheme.",
       "examples": [
         "aptos",
         "microsoft-yahei",
@@ -82,7 +87,7 @@
     },
     "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.",
+      "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. Used in place of 'fontScheme' when resolving script fonts for Google Slides output.",
       "examples": [
         "roboto",
         "noto-sans",