@openpresentation/opf 0.11.1 → 0.11.3

package/dist/spec/catalogs/purposes/index.json

@@ -1,7 +1,9 @@
 {
   "$schema": "https://openpresentation.org/schema/opf-catalog-index/v1",
+  "kind": "purposes",
   "version": "1",
   "description": "Catalog of presentation purposes available in the openpresentation.org catalog. Each entry is a lightweight summary; full purpose records live in the per-id JSON files alongside this index. Purposes are referenced from OPF documents via purpose.",
+  "contentSha256": "43d9ba617491fe1d98b527d24032d5da9bc6763a01b0ea41da421c5ec27e649c",
   "records": [
     {
       "id": "inform",

package/dist/spec/catalogs/social-platforms/index.json

@@ -1,7 +1,9 @@
 {
   "$schema": "https://openpresentation.org/schema/opf-catalog-index/v1",
+  "kind": "social-platforms",
   "version": "1",
   "description": "Catalog of social-media platforms available in the openpresentation.org catalog. Each entry is a lightweight summary; full platform records live in the per-id JSON files alongside this index. The property keys of any Socials object on Organization or Speaker resolve to ids in this catalog.",
+  "contentSha256": "22292ed144ac3caf37a86c9e644f9b648cda51ed670cbc3c0ed64915d251b375",
   "records": [
     {
       "id": "linkedin",
@@ -65,4 +67,3 @@
     }
   ]
 }
-

package/dist/spec/catalogs/themes/index.json

@@ -1,13 +1,15 @@
 {
   "$schema": "https://openpresentation.org/schema/opf-catalog-index/v1",
+  "kind": "themes",
   "version": "1",
   "description": "Catalog of themes available in the openpresentation.org catalog. Each entry is a lightweight summary; full theme records live in the per-id JSON files alongside this index.",
+  "contentSha256": "5af95e3e353857bb49a2c303e66b99d74d884210070baac0b68291aad90fa8d5",
   "records": [
     {
-      "id": "bold",
-      "name": "Bold",
-      "description": "A vibrant, high-energy theme with bold colors and a dynamic, attention-grabbing style. Great for presentations that need to stand out.",
-      "file": "bold.json"
+      "id": "minimal",
+      "name": "Minimal",
+      "description": "A clean, minimalistic theme with a focus on simplicity and readability. Ideal for professional, straightforward presentations.",
+      "file": "minimal.json"
     },
     {
       "id": "classic",
@@ -22,10 +24,10 @@
       "file": "dark.json"
     },
     {
-      "id": "minimal",
-      "name": "Minimal",
-      "description": "A clean, minimalistic theme with a focus on simplicity and readability. Ideal for professional, straightforward presentations.",
-      "file": "minimal.json"
+      "id": "bold",
+      "name": "Bold",
+      "description": "A vibrant, high-energy theme with bold colors and a dynamic, attention-grabbing style. Great for presentations that need to stand out.",
+      "file": "bold.json"
     }
   ]
 }

package/dist/spec/catalogs/tones/index.json

@@ -1,7 +1,9 @@
 {
   "$schema": "https://openpresentation.org/schema/opf-catalog-index/v1",
+  "kind": "tones",
   "version": "1",
   "description": "Catalog of presentation tones available in the openpresentation.org catalog. Each entry is a lightweight summary; full tone records (voice cues, anti-patterns, sample phrases) live in the per-id JSON files alongside this index. Tones are referenced from OPF documents via tone.",
+  "contentSha256": "b5a8d0933f494d09cd3b9a399c8de2032c43d253fcf432974135e841fcc9e703",
   "records": [
     {
       "id": "formal",

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

@@ -5,9 +5,9 @@
     "note": "Owner decisions resolved provisionally with the recommended defaults. Changing a decision here is the whole edit: every row whose replacement names this decision takes its family and compatibility from it. A recorded measurement for a different family is ignored (treated as unmeasured) until scripts/measure-font-replacements.mjs is re-run.",
     "decisions": {
       "aptos-preview": {
-        "replacement": "Roboto",
-        "compatibility": "visual",
-        "note": "Default scheme aptos previews with Roboto; the PPTX still names Aptos."
+        "replacement": "Intos",
+        "compatibility": "metric",
+        "note": "Owner policy 2026-09-29: a licensed font the user selects previews with an open replacement that looks similar and has the same size on screen; the PPTX keeps the selected name. Aptos previews with Intos (metric, OFL-1.1, vendored in opf-render); Roboto and Carlito are alternates for registries built without the Intos faces (they are in the opf-render office pack)."
       },
       "segoe-ui-preview": {
         "replacement": "Red Hat Display",
@@ -25,7 +25,7 @@
   "description": "OPF font policy (font-fidelity-everywhere FF-31). One row per font family that OPF catalogs, defaults or renderer rules name. Renderers preview a proprietary family with its openly licensed replacement for measurement and drawing only. Exporters always write the chosen family, never write a replacement, and never embed a proprietary family. Open families may be bundled for rendering and reach a PPTX only through an explicit embed path. See docs/font-fidelity.md.",
   "version": 1,
   "measurement": {
-    "tool": "fontkit 2.0.4 shaping with default features (kerning, ligatures), as opf-render measures text",
+    "tool": "fontkit 2.0.4 shaping with default features (kerning, ligatures), as opf-render measures text; a replacement that lists disabledFeatures (Georgia -> Gelasio) is shaped with those features off",
     "corpus": "300 Latin title/body strings sampled from the 126 bundled example decks",
     "evidence": "docs/evidence/font-replacements-20260923/README.md",
     "definition": "For each style both fonts have (regular, bold, italic, bold italic, or the weight the family name encodes), the shaped advance width of every corpus string in the replacement is divided by the width in the real font. meanAbsWidthDelta averages |ratio - 1| over strings and styles; meanWidthDelta averages the signed value; maxAbsWidthDelta is the largest single-string |ratio - 1|. Reference fonts were read in place from a licensed Windows 11 + Microsoft 365 host and never copied."
@@ -106,16 +106,18 @@
       "embeddableByOpf": false,
       "replacement": {
         "decision": "aptos-preview",
+        "source": "https://github.com/muglug/intos/tree/fef9315c14da9e4b23b4c3cac8e718998d4e4736",
         "measured": {
-          "replacement": "Roboto",
-          "meanAbsWidthDelta": 0.0215,
-          "meanWidthDelta": 0.0008,
-          "maxAbsWidthDelta": 0.0739,
+          "replacement": "Intos",
+          "meanAbsWidthDelta": 0,
+          "meanWidthDelta": 0,
+          "maxAbsWidthDelta": 0,
           "styles": 4,
           "reference": "Aptos 2.01;O365"
         }
       },
       "alternates": [
+        "Roboto",
         "Carlito"
       ],
       "sources": [
@@ -126,7 +128,7 @@
         "https://microsoft.design/articles/a-change-of-typeface-microsoft-s-new-default-font-has-arrived/",
         "https://www.microsoft.com/en-us/download/details.aspx?id=106087"
       ],
-      "note": "Microsoft 365 cloud font; not redistributable. Roboto is the closest measured open face with all four styles already in the base pack. Carlito (the previous substitute) measured 7.1% narrower. Not in the Windows 10/11 font lists; delivered as a Microsoft 365 cloud font. Microsoft also offers a standalone download (Download Center id=106087) under Microsoft terms, not an open license."
+      "note": "Microsoft 365 cloud font; not redistributable. Intos is metric-compatible (OFL, Inter-derived outlines with Aptos advances, kerning and vertical metrics) and previews it in the default opf-render office pack; Roboto and Carlito are the visual fallbacks for registries built without the Intos faces. Not in the Windows 10/11 font lists; delivered as a Microsoft 365 cloud font. Microsoft also offers a standalone download (Download Center id=106087) under Microsoft terms, not an open license."
     },
     {
       "family": "Aptos Display",
@@ -137,18 +139,20 @@
       ],
       "embeddableByOpf": false,
       "replacement": {
-        "family": "Carlito",
-        "compatibility": "visual",
+        "family": "Intos Display",
+        "compatibility": "metric",
+        "source": "https://github.com/muglug/intos/tree/fef9315c14da9e4b23b4c3cac8e718998d4e4736",
         "measured": {
-          "replacement": "Carlito",
-          "meanAbsWidthDelta": 0.0184,
-          "meanWidthDelta": -0.0057,
-          "maxAbsWidthDelta": 0.0691,
+          "replacement": "Intos Display",
+          "meanAbsWidthDelta": 0,
+          "meanWidthDelta": 0,
+          "maxAbsWidthDelta": 0,
           "styles": 4,
           "reference": "Aptos Display 2.01;O365"
         }
       },
       "alternates": [
+        "Carlito",
         "Roboto"
       ],
       "sources": [
@@ -158,7 +162,7 @@
         "https://support.apple.com/en-us/122869",
         "https://microsoft.design/articles/a-change-of-typeface-microsoft-s-new-default-font-has-arrived/"
       ],
-      "note": "Part of the Aptos family; cloud font list has Aptos Display (+Bold/Italic/Bold Italic)."
+      "note": "Part of the Aptos family; cloud font list has Aptos Display (+Bold/Italic/Bold Italic). Intos Display is its metric-compatible preview replacement."
     },
     {
       "family": "Aptos Mono",
@@ -194,13 +198,14 @@
       ],
       "embeddableByOpf": false,
       "replacement": {
-        "family": "Carlito",
-        "compatibility": "visual",
+        "family": "Intos Narrow",
+        "compatibility": "metric",
+        "source": "https://github.com/muglug/intos/tree/fef9315c14da9e4b23b4c3cac8e718998d4e4736",
         "measured": {
-          "replacement": "Carlito",
-          "meanAbsWidthDelta": 0.0233,
-          "meanWidthDelta": 0.0222,
-          "maxAbsWidthDelta": 0.0786,
+          "replacement": "Intos Narrow",
+          "meanAbsWidthDelta": 0,
+          "meanWidthDelta": 0,
+          "maxAbsWidthDelta": 0,
           "styles": 4,
           "reference": "Aptos Narrow 2.01;O365"
         }
@@ -212,7 +217,10 @@
         "https://support.apple.com/en-us/122869",
         "https://microsoft.design/articles/a-change-of-typeface-microsoft-s-new-default-font-has-arrived/"
       ],
-      "note": "Part of the Aptos family; cloud font list has Aptos Narrow (+Bold/Italic/Bold Italic)."
+      "note": "Part of the Aptos family; cloud font list has Aptos Narrow (+Bold/Italic/Bold Italic). Intos Narrow is its metric-compatible preview replacement.",
+      "alternates": [
+        "Carlito"
+      ]
     },
     {
       "family": "Aptos Serif",
@@ -223,9 +231,17 @@
       ],
       "embeddableByOpf": false,
       "replacement": {
-        "family": "Tinos",
-        "compatibility": "visual",
-        "measured": null
+        "family": "Intos Serif",
+        "compatibility": "metric",
+        "source": "https://github.com/muglug/intos/tree/fef9315c14da9e4b23b4c3cac8e718998d4e4736",
+        "measured": {
+          "replacement": "Intos Serif",
+          "meanAbsWidthDelta": 0,
+          "meanWidthDelta": 0,
+          "maxAbsWidthDelta": 0,
+          "styles": 4,
+          "reference": "Aptos Serif 2.01;240513210638;O365"
+        }
       },
       "sources": [
         "https://learn.microsoft.com/en-us/typography/fonts/windows_11_font_list",
@@ -233,7 +249,10 @@
         "https://learn.microsoft.com/en-us/typography/font-list/aptos",
         "https://support.apple.com/en-us/122869"
       ],
-      "note": "Reference not available to the measuring host. Aptos family member; cloud list has Aptos Serif, Bold, Italic and Bold Italic."
+      "note": "Part of the Aptos family; cloud list has Aptos Serif, Bold, Italic and Bold Italic. Intos Serif (Gelasio-derived outlines, Aptos Serif metrics) is its metric-compatible preview replacement. Not installed on the measuring host: measured from the files in Microsoft's Aptos Fonts download (Download Center id=106087).",
+      "alternates": [
+        "Tinos"
+      ]
     },
     {
       "family": "Arabic Typesetting",
@@ -909,8 +928,8 @@
         "compatibility": "visual",
         "measured": {
           "replacement": "Source Sans 3",
-          "meanAbsWidthDelta": 0.0157,
-          "meanWidthDelta": 0.0151,
+          "meanAbsWidthDelta": 0.0158,
+          "meanWidthDelta": 0.0152,
           "maxAbsWidthDelta": 0.0521,
           "styles": 4,
           "reference": "Corbel 6.01"
@@ -1301,12 +1320,16 @@
       "embeddableByOpf": false,
       "replacement": {
         "family": "Gelasio",
-        "compatibility": "visual",
+        "compatibility": "metric",
+        "disabledFeatures": [
+          "liga",
+          "clig"
+        ],
         "measured": {
           "replacement": "Gelasio",
-          "meanAbsWidthDelta": 0.0002,
-          "meanWidthDelta": -0.0002,
-          "maxAbsWidthDelta": 0.0102,
+          "meanAbsWidthDelta": 0,
+          "meanWidthDelta": 0,
+          "maxAbsWidthDelta": 0,
           "styles": 4,
           "reference": "Georgia 5.59"
         },
@@ -1319,7 +1342,7 @@
         "https://learn.microsoft.com/en-us/typography/font-list/georgia",
         "https://support.apple.com/en-us/122869"
       ],
-      "note": "Gelasio is designed to Georgia metrics and every basic-Latin advance matches Georgia 5.59, but opf-render shapes with default features, and runs where Gelasio applies optional ligatures differ by up to 1.02%. OPF classes it as visual."
+      "note": "Gelasio is designed to Georgia metrics and every basic-Latin advance matches Georgia 5.59. With default features Gelasio applies fi/fl/ffi/ffl ligatures that Georgia does not, which changes runs by up to 1.02%. Renderers therefore turn liga and clig off in Gelasio (disabledFeatures); the measurement below shapes Gelasio that way. Georgia has no liga or clig feature, so its default shaping is unchanged. The metric claim holds only with those features off."
     },
     {
       "family": "Gill Sans MT",
@@ -1334,9 +1357,9 @@
         "compatibility": "visual",
         "measured": {
           "replacement": "Source Sans 3",
-          "meanAbsWidthDelta": 0.051,
-          "meanWidthDelta": 0.0038,
-          "maxAbsWidthDelta": 0.1456,
+          "meanAbsWidthDelta": 0.0511,
+          "meanWidthDelta": 0.0039,
+          "maxAbsWidthDelta": 0.1459,
           "styles": 4,
           "reference": "Gill Sans MT 1.65"
         }
@@ -1502,6 +1525,58 @@
         "https://support.apple.com/en-us/122869"
       ]
     },
+    {
+      "family": "Intos",
+      "licenseClass": "open",
+      "license": "OFL-1.1",
+      "availability": [],
+      "embeddableByOpf": true,
+      "replacement": null,
+      "sources": [
+        "https://github.com/muglug/intos/tree/fef9315c14da9e4b23b4c3cac8e718998d4e4736",
+        "https://github.com/muglug/intos/blob/fef9315c14da9e4b23b4c3cac8e718998d4e4736/LICENSE.txt"
+      ],
+      "note": "Metric-compatible with Aptos (Aptos advance widths, kerning and vertical metrics on Inter-derived outlines). Vendored in opf-render at the pinned commit; single-maintainer project created September 2026, so Roboto and Carlito stay as fallbacks."
+    },
+    {
+      "family": "Intos Display",
+      "licenseClass": "open",
+      "license": "OFL-1.1",
+      "availability": [],
+      "embeddableByOpf": true,
+      "replacement": null,
+      "sources": [
+        "https://github.com/muglug/intos/tree/fef9315c14da9e4b23b4c3cac8e718998d4e4736",
+        "https://github.com/muglug/intos/blob/fef9315c14da9e4b23b4c3cac8e718998d4e4736/LICENSE.txt"
+      ],
+      "note": "Metric-compatible with Aptos Display (Aptos advance widths, kerning and vertical metrics on Inter-derived outlines). Vendored in opf-render at the pinned commit; single-maintainer project created September 2026, so Roboto and Carlito stay as fallbacks."
+    },
+    {
+      "family": "Intos Narrow",
+      "licenseClass": "open",
+      "license": "OFL-1.1",
+      "availability": [],
+      "embeddableByOpf": true,
+      "replacement": null,
+      "sources": [
+        "https://github.com/muglug/intos/tree/fef9315c14da9e4b23b4c3cac8e718998d4e4736",
+        "https://github.com/muglug/intos/blob/fef9315c14da9e4b23b4c3cac8e718998d4e4736/LICENSE.txt"
+      ],
+      "note": "Metric-compatible with Aptos Narrow (Aptos advance widths, kerning and vertical metrics on Inter-derived outlines). Vendored in opf-render at the pinned commit; single-maintainer project created September 2026, so Roboto and Carlito stay as fallbacks."
+    },
+    {
+      "family": "Intos Serif",
+      "licenseClass": "open",
+      "license": "OFL-1.1",
+      "availability": [],
+      "embeddableByOpf": true,
+      "replacement": null,
+      "sources": [
+        "https://github.com/muglug/intos/tree/fef9315c14da9e4b23b4c3cac8e718998d4e4736",
+        "https://github.com/muglug/intos/blob/fef9315c14da9e4b23b4c3cac8e718998d4e4736/LICENSE.txt"
+      ],
+      "note": "Metric-compatible with Aptos Serif (Aptos Serif advance widths, kerning and vertical metrics on Gelasio-derived outlines). Vendored in opf-render at the pinned commit; Tinos stays as the visual fallback."
+    },
     {
       "family": "Kalinga",
       "licenseClass": "proprietary-standard",
@@ -2721,7 +2796,7 @@
         "https://learn.microsoft.com/en-us/typography/font-list/segoe-ui",
         "https://support.apple.com/en-us/122869"
       ],
-      "note": "Microsoft's OFL Selawik is the documented Segoe UI fallback but is not published as a pinned package; Red Hat Display is the closest measured shipped face. MS Learn lists vendor as Agfa Monotype but copyright Microsoft."
+      "note": "Microsoft's OFL Selawik 1.01 was measured and rejected as a metric replacement: 0.16% mean and 2.5% maximum in regular, no italic faces (2.65% mean), and Semibold is 1.75% off. Red Hat Display remains the closest shipped face with all four styles; see docs/programs/font-fidelity-everywhere/font-licensing.md."
     },
     {
       "family": "Segoe UI Emoji",

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

@@ -182,6 +182,16 @@
           "minimum": 100,
           "maximum": 900
         },
+        "disabledFeatures": {
+          "description": "OpenType feature tags a renderer must turn off when it shapes and draws this replacement (for example liga and clig for Gelasio, which ligates fi and fl where Georgia does not). The measurement below is taken with them off, and a metric claim holds only with them off.",
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "pattern": "^[A-Za-z0-9 ]{4}$"
+          }
+        },
         "measured": {
           "oneOf": [
             {

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

@@ -48,6 +48,27 @@
         "Regulators"
       ]
     },
+    "deprecation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["replacedBy"],
+      "description": "Present when this audience is deprecated, for example an alias kept for backward compatibility. Deprecated records stay resolvable so existing documents keep validating and rendering unchanged, but pickers and default listings exclude them and validators warn when a document references them. Same shape as the chart-type deprecation.",
+      "properties": {
+        "replacedBy": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*$",
+          "description": "Id of the non-deprecated audience record that documents should reference instead."
+        },
+        "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, if any."
+        }
+      }
+    },
     "summary": {
       "type": "string",
       "description": "One-sentence positioning of the audience — who they are and what they care about.",

package/dist/spec/schemas/catalog-index.schema.json

@@ -2,15 +2,37 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://openpresentation.org/schema/opf-catalog-index/v1",
   "title": "Catalog Index",
-  "description": "Generic shape shared by every `spec/catalogs/<kind>/index.json` file in the OPF repo. An index is a lightweight, ordered summary of the full-record JSON files that live alongside it: each entry names the record's stable id, a human-readable name, and the record's filename, plus whatever extra summary fields are useful for picker UIs (e.g. `summary`, `tags`, `bcp47`, `durationRange`). This schema describes the repo-internal catalog index files themselves, not OPF documents or individual catalog records — it is not part of the OPF document contract and is intentionally excluded from the package's published/typed schema surface.",
+  "description": "Generic shape shared by every `spec/catalogs/<kind>/index.json` file in the OPF repo and by the default-catalog index that pptx.gallery publishes at `https://www.pptx.gallery/<kind>/index.json` (spec/catalogs is a pinned snapshot of that catalog; see docs/default-catalog.md). An index is a lightweight, ordered summary of the full-record JSON files that live alongside it: each entry names the record's stable id, a human-readable name, and the record's filename, plus whatever extra summary fields are useful for picker UIs (e.g. `summary`, `tags`, `bcp47`, `durationRange`). This schema describes catalog index files themselves, not OPF documents or individual catalog records — it is not part of the OPF document contract and is intentionally excluded from the package's published/typed schema surface.",
   "type": "object",
   "required": ["$schema", "version", "description", "records"],
   "additionalProperties": false,
+  "patternProperties": {
+    "^x-": {
+      "description": "Publisher extension member, such as pptx.gallery's `x-gallery` reconciliation status. Consumers ignore top-level `x-*` members, and the pinned snapshot in spec/catalogs never carries them."
+    }
+  },
   "properties": {
     "$schema": {
       "type": "string",
       "const": "https://openpresentation.org/schema/opf-catalog-index/v1"
     },
+    "kind": {
+      "type": "string",
+      "description": "Catalog kind, as the URL segment of the default catalog (`https://www.pptx.gallery/<kind>`) and the `spec/catalogs/<kind>` directory name.",
+      "enum": [
+        "audiences",
+        "chart-types",
+        "color-schemes",
+        "font-schemes",
+        "languages",
+        "layouts",
+        "narratives",
+        "purposes",
+        "social-platforms",
+        "themes",
+        "tones"
+      ]
+    },
     "version": {
       "type": "string",
       "description": "Index format version, as a string.",
@@ -20,6 +42,11 @@
       "type": "string",
       "description": "Human-readable description of what this catalog kind holds and how entries are ordered."
     },
+    "contentSha256": {
+      "type": "string",
+      "description": "SHA-256 (lowercase hex) of the canonical JSON of the full records this index lists, in index order, with every top-level `x-*` member removed. Canonical JSON sorts object keys and has no insignificant whitespace. Lets a consumer prove it holds exactly the published content.",
+      "pattern": "^[0-9a-f]{64}$"
+    },
     "records": {
       "type": "array",
       "description": "Ordered list of lightweight record summaries. Order defines the catalog's canonical/display order; full record data lives in the sibling JSON file named by `file`.",
@@ -35,8 +62,8 @@
       "properties": {
         "id": {
           "type": "string",
-          "description": "Stable identifier, matching the `id` field inside the record file named by `file`.",
-          "pattern": "^[a-z][a-z0-9-]*$"
+          "description": "Stable identifier, matching the `id` field inside the record file named by `file`. Lowercase kebab-case; chart-type ids may start with a digit (e.g. '100pct-stacked-bar').",
+          "pattern": "^[a-z0-9][a-z0-9-]*$"
         },
         "name": {
           "type": "string",
@@ -46,6 +73,16 @@
           "type": "string",
           "description": "Filename of the full record, relative to this index file's directory.",
           "pattern": "^[^/]+\\.json$"
+        },
+        "deprecated": {
+          "type": "boolean",
+          "const": true,
+          "description": "Present on the entry of a record that carries `deprecation`. Pickers and default listings hide deprecated entries; the id keeps resolving."
+        },
+        "replacedBy": {
+          "type": "string",
+          "description": "The deprecated record's `deprecation.replacedBy`, repeated so a picker can offer the replacement without loading the record.",
+          "pattern": "^[a-z0-9][a-z0-9-]*$"
         }
       }
     }

package/dist/spec/schemas/catalog-manifest.schema.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openpresentation.org/schema/opf-catalog-manifest/v1",
+  "title": "Catalog Snapshot Manifest",
+  "description": "Shape of `spec/catalogs/manifest.json`, which pins the bundled catalogs to the default OPF catalog published by pptx.gallery. It records the gallery commit the snapshot came from and, per kind, how the snapshot relates to the published catalog plus a content hash of the bundled records. Written by scripts/sync-gallery-catalog.mjs and checked by scripts/check-spec-integrity.mjs; see docs/default-catalog.md. This schema describes a repo-internal file, not an OPF document or a catalog record; it is intentionally excluded from the package's published/typed schema surface.",
+  "type": "object",
+  "required": ["$schema", "description", "publisher", "source", "kinds"],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "const": "https://openpresentation.org/schema/opf-catalog-manifest/v1"
+    },
+    "description": {
+      "type": "string"
+    },
+    "publisher": {
+      "type": "string",
+      "description": "Base URL of the default-catalog publisher. Each kind is published at `<publisher>/<kind>/index.json`.",
+      "format": "uri"
+    },
+    "source": {
+      "type": "object",
+      "description": "The published catalog files the snapshot was taken from.",
+      "required": ["repository", "commit", "path"],
+      "additionalProperties": false,
+      "properties": {
+        "repository": {
+          "type": "string",
+          "description": "Git repository of the publisher.",
+          "format": "uri"
+        },
+        "commit": {
+          "type": "string",
+          "description": "Full commit SHA of the publisher checkout whose published files the snapshot matches."
+        },
+        "path": {
+          "type": "string",
+          "description": "Directory in that repository holding `<kind>/index.json` and `<kind>/<id>.json`."
+        }
+      }
+    },
+    "kinds": {
+      "type": "object",
+      "description": "One entry per catalog kind, keyed by the kind's URL segment.",
+      "additionalProperties": { "$ref": "#/$defs/KindEntry" }
+    }
+  },
+  "$defs": {
+    "KindEntry": {
+      "type": "object",
+      "required": ["mode", "records", "contentSha256", "gallery"],
+      "additionalProperties": false,
+      "properties": {
+        "mode": {
+          "type": "string",
+          "description": "'mirror': the snapshot holds every published record. 'subset': the snapshot keeps its existing ids (their content comes from the publisher) while the publisher also serves records that are not reconciled for bundling yet.",
+          "enum": ["mirror", "subset"]
+        },
+        "records": {
+          "type": "integer",
+          "description": "Number of records bundled for this kind.",
+          "minimum": 0
+        },
+        "contentSha256": {
+          "type": "string",
+          "description": "contentSha256 of the bundled records, as defined by the catalog index schema.",
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "gallery": {
+          "type": "object",
+          "description": "The published catalog for this kind at the pinned commit.",
+          "required": ["records", "contentSha256"],
+          "additionalProperties": false,
+          "properties": {
+            "records": { "type": "integer", "minimum": 0 },
+            "contentSha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+          }
+        }
+      }
+    }
+  }
+}

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

@@ -5,6 +5,11 @@
   "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,
+  "patternProperties": {
+    "^x-": {
+      "description": "Publisher extension member, such as the `x-gallery` presentation metadata that pptx.gallery adds to the records it publishes. Engines and validators ignore top-level `x-*` members, and the pinned snapshot in spec/catalogs never carries them."
+    }
+  },
   "required": [
     "$schema",
     "id",

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

@@ -36,6 +36,27 @@
         "Forest Green"
       ]
     },
+    "deprecation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["replacedBy"],
+      "description": "Present when this color scheme is deprecated, for example an alias kept for backward compatibility. Deprecated records stay resolvable so existing documents keep validating and rendering unchanged, but pickers and default listings exclude them and validators warn when a document references them. Same shape as the chart-type deprecation.",
+      "properties": {
+        "replacedBy": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*$",
+          "description": "Id of the non-deprecated color scheme record that documents should reference instead."
+        },
+        "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, if any."
+        }
+      }
+    },
     "summary": {
       "type": "string",
       "description": "One-sentence positioning of the palette — what mood it evokes and where to use it.",

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

@@ -40,6 +40,27 @@
         "Microsoft Yahei"
       ]
     },
+    "deprecation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["replacedBy"],
+      "description": "Present when this font scheme is deprecated, for example an alias kept for backward compatibility. Deprecated records stay resolvable so existing documents keep validating and rendering unchanged, but pickers and default listings exclude them and validators warn when a document references them. Same shape as the chart-type deprecation.",
+      "properties": {
+        "replacedBy": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*$",
+          "description": "Id of the non-deprecated font scheme record that documents should reference instead."
+        },
+        "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, if any."
+        }
+      }
+    },
     "major": {
       "type": "string",
       "description": "Heading (major) font family — mirrors the OOXML majorFont entry.",