@openpresentation/opf 0.24.2 → 0.26.0-rc.0

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

@@ -2,13 +2,13 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://openpresentation.org/schema/opf-layout/v2",
   "title": "Slide Layout",
-  "description": "Schema for slide-layout records (OPF 0.19). A layout is a grid template: 'areas' names the cells of a grid using nested row arrays, 'columns' and 'rows' size its tracks, and 'regions' says, for every body area, which content kinds it takes and how several blocks share it. Slide content stays flat: engines bind a slide's blocks to the regions by reading order, role and kind (bindRegions in @openpresentation/opf), a block may pin itself to a region with 'region', and an empty region collapses into a neighbour. Built-in and custom layouts are records of this one schema; a custom layout is embedded under catalogs.custom.layouts or shipped in a catalog. Documents reference a layout from Slide.layout; a slide without a layout, with layout 'auto', or whose layout resolves nowhere composes automatically.\n\nA document references a record as a bare id or 'name:id' and resolves it in its own catalogs groups first, then in the catalog the host registered for the group's source; engines never fetch a catalog. A published record file carries '$schema' and 'id'; the copy a document embeds under catalogs.<group>.<kind>.<id> carries neither (the key is the id) and no 'x-*' display metadata.",
+  "description": "Schema for slide-layout records. A layout is one ordered list of regions, declared once, in reading order: 'direction' says whether the record's 'regions' sit side by side (row) or are stacked (column), and each region says which content kinds it takes and how several blocks share it. A split is an entry that nests a second list the other way, which is how a layout gets two dimensions. 'title' and 'subtitle' are reserved heading regions. Engines compile the list into a grid of tracks (the guillotine partition it describes). Slide content stays flat: engines bind a slide's blocks to the regions by reading order, role and kind (bindRegions in @openpresentation/opf), a block may pin itself to a region with 'region', and an empty region collapses into a neighbour. Built-in and custom layouts are records of this one schema; a custom layout is embedded under catalogs.custom.layouts or shipped in a catalog. Documents reference a layout from Slide.layout; a slide without a layout, with layout 'auto', or whose layout resolves nowhere composes automatically.\n\nA document references a record as a bare id or 'name:id' and resolves it in its own catalogs groups first, then in the catalog the host registered for the group's source; engines never fetch a catalog. A published record file carries '$schema' and 'id'; the copy a document embeds under catalogs.<group>.<kind>.<id> carries neither (the key is the id) and no 'x-*' display metadata.",
   "type": "object",
   "required": [
     "$schema",
     "id",
     "name",
-    "areas"
+    "regions"
   ],
   "properties": {
     "$schema": {
@@ -58,105 +58,76 @@
       "$ref": "#/$defs/DesignHints",
       "description": "The layout's design defaults, with the same keys and values as the deck's design and a slide's design (a slide overrides exactly what its layout sets, by the same name). An absent key means the layout has no opinion. Per key the slide's design wins, then the deck's design, then the resolved theme's design, then this record's design, then the engine default. Composition, the renderer and the PPTX exporter all read the one result."
     },
-    "areas": {
-      "type": "array",
-      "minItems": 1,
-      "maxItems": 12,
-      "items": {
-        "type": "array",
-        "minItems": 1,
-        "maxItems": 12,
-        "items": {
-          "type": "string",
-          "pattern": "^(?:[a-z][a-z0-9-]*|\\.)$"
-        }
-      },
-      "description": "The grid as nested arrays: each inner array is a row, each string is one cell, and a name repeated over adjacent cells spans them; '.' is an empty cell. Cells are lowercase names ([a-z][a-z0-9-]*) or '.', and every row has the same number of cells (at most 12 rows and 12 columns). A name's cells must form one filled rectangle. 'title' and 'subtitle' are heading areas: 'title' holds the slide's heading group (tag, title and subtitle, stacked) and a 'subtitle' area takes the subtitle out of it; they have no regions entry, and a 'subtitle' area needs a 'title' area. A layout with no 'title' area gets an implicit auto row on top for a slide that has headings. Every other name is a body region and needs an entry in 'regions'. The grid rules a schema cannot express are the validate finding opf/layout-template.",
+    "direction": {
+      "type": "string",
+      "enum": [
+        "row",
+        "column"
+      ],
+      "description": "How the record's 'regions' are laid out: 'row' places them side by side, left to right in reading order; 'column' stacks them top to bottom. Default 'column'.",
       "examples": [
-        [
-          [
-            "title"
-          ],
-          [
-            "body"
-          ]
-        ],
-        [
-          [
-            "title",
-            "title"
-          ],
-          [
-            "timeline",
-            "notes"
-          ],
-          [
-            "timeline",
-            "metrics"
-          ]
-        ]
+        "row",
+        "column"
       ]
     },
-    "columns": {
+    "anchor": {
+      "type": "string",
+      "enum": [
+        "top",
+        "middle",
+        "bottom"
+      ],
+      "description": "Vertical position of the content of every body region when it is shorter than the region. A split's 'anchor' replaces it for the regions under that split, and a region's own 'anchor' replaces both. Only 'anchor' is inherited, and only by body regions: the heading regions 'title' and 'subtitle' never take it, and the other region rules stay per region. Default 'top'."
+    },
+    "regions": {
       "type": "array",
       "minItems": 1,
       "maxItems": 12,
       "items": {
-        "type": "number",
-        "exclusiveMinimum": 0,
-        "maximum": 100
+        "$ref": "#/$defs/RegionEntry"
       },
-      "description": "Relative column widths, one per cell of a row; the columns share the content width in proportion, separated by the gap. Omitted: all 1. Columns are numbers only.",
+      "description": "The record's regions in reading order: 1 to 12 entries, each a region ({ name, size?, ...rules }) or a split ({ direction, regions, size?, anchor? }). Every region is declared once, here, with its content rules; a block can target a body region with 'region': '<name>'. Names are unique across the whole record. 'size' is a number above 0 and up to 100 (default 1) that siblings share in proportion, separated by the gap; 'auto' is the height the content needs, allowed only in a column. 'title' and 'subtitle' are heading regions that take only a size (default auto in a column, 1 in a row): 'title' holds the slide's heading group (tag, title and subtitle, stacked) and a 'subtitle' region takes the subtitle out of it, and a 'subtitle' needs a 'title'. A record with no 'title' region gets an implicit auto row on top for a slide that has headings. Splits nest at most three levels (the record's own list is level 1). Rules the schema cannot express (a reserved or repeated name, a 'subtitle' without a 'title', 'auto' outside a column, nesting too deep, more than 12 rows or columns once compiled) are the validate findings opf/layout-template and opf/layout-region.",
       "examples": [
         [
-          1,
-          1
-        ],
-        [
-          3,
-          2
-        ]
-      ]
-    },
-    "rows": {
-      "type": "array",
-      "minItems": 1,
-      "maxItems": 12,
-      "items": {
-        "oneOf": [
           {
-            "type": "number",
-            "exclusiveMinimum": 0,
-            "maximum": 100
+            "name": "main",
+            "size": 2,
+            "accepts": [
+              "text"
+            ]
           },
           {
-            "const": "auto"
+            "name": "aside",
+            "size": 1,
+            "accepts": [
+              "metric"
+            ]
           }
-        ]
-      },
-      "description": "Relative row heights, one per string of 'areas'. 'auto' is the height the row's content needs at the starting text size (at most half the content box; areas that span several rows do not size it); the numeric rows share the rest in proportion. An auto row whose areas are all empty has no height. Omitted: all 1.",
-      "examples": [
-        [
-          "auto",
-          1
         ],
         [
-          "auto",
-          1,
-          "auto"
+          {
+            "name": "title"
+          },
+          {
+            "direction": "row",
+            "regions": [
+              {
+                "name": "first",
+                "accepts": [
+                  "text"
+                ]
+              },
+              {
+                "name": "second",
+                "accepts": [
+                  "text"
+                ]
+              }
+            ]
+          }
         ]
       ]
     },
-    "regions": {
-      "type": "object",
-      "propertyNames": {
-        "pattern": "^[a-z][a-z0-9-]*$"
-      },
-      "additionalProperties": {
-        "$ref": "#/$defs/Region"
-      },
-      "description": "One entry per body area, keyed by the area's name. Region names may not be 'title', 'subtitle', 'tag', 'auto' or one of the promoted-region words ('left', 'center', 'right', 'top', 'middle', 'bottom'), so a Markdown block's region= option stays unambiguous. Region rules the schema cannot express (an area without a region, a region without an area, a reserved name) are the validate finding opf/layout-region."
-    },
     "overflowRegion": {
       "type": "string",
       "pattern": "^[a-z][a-z0-9-]*$",
@@ -219,15 +190,128 @@
       "$ref": "#/$defs/Composition"
     }
   },
+  "patternProperties": {
+    "^x-": {}
+  },
+  "additionalProperties": false,
   "$defs": {
-    "Region": {
+    "RegionEntry": {
+      "description": "One entry of a regions list: a heading region, a body region or a split.",
+      "oneOf": [
+        {
+          "$ref": "#/$defs/HeadingRegion"
+        },
+        {
+          "$ref": "#/$defs/Region"
+        },
+        {
+          "$ref": "#/$defs/Split"
+        }
+      ]
+    },
+    "RegionSize": {
+      "oneOf": [
+        {
+          "type": "number",
+          "exclusiveMinimum": 0,
+          "maximum": 100
+        },
+        {
+          "const": "auto"
+        }
+      ],
+      "description": "The region's or split's share along its parent's direction: a number above 0 and up to 100 that siblings share in proportion (the gap is taken out first), default 1; or 'auto', the length the content needs at the starting text size (at most half the content box; a split sized auto is as tall as its tallest content, and every row of a column split sized auto is auto too; auto regions with no content take no space). 'auto' is allowed only on an entry of a column; in a row it is the validate finding opf/layout-template. The default for a heading region is 'auto' in a column and 1 in a row.",
+      "examples": [
+        1,
+        2,
+        "auto"
+      ]
+    },
+    "HeadingRegion": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "name"
+      ],
+      "description": "A reserved heading region: 'title' holds the slide's heading group (tag, title and subtitle, stacked) and 'subtitle' takes the subtitle out of it. A heading region takes only a size. At most one of each; a 'subtitle' needs a 'title'.",
+      "properties": {
+        "name": {
+          "type": "string",
+          "enum": [
+            "title",
+            "subtitle"
+          ],
+          "description": "'title' or 'subtitle'."
+        },
+        "size": {
+          "$ref": "#/$defs/RegionSize"
+        }
+      }
+    },
+    "Split": {
       "type": "object",
       "additionalProperties": false,
       "required": [
-        "accepts"
+        "direction",
+        "regions"
       ],
-      "description": "One body region of a layout: which content it takes and how several blocks share it.",
+      "description": "A split nests a list of regions the other way inside one cell of its parent: a row of regions inside a column, or a column inside a row. It has no name; its regions are declared in reading order like the record's own. Splits nest at most three levels (the record's own list is level 1).",
       "properties": {
+        "direction": {
+          "type": "string",
+          "enum": [
+            "row",
+            "column"
+          ],
+          "description": "How the split's 'regions' are laid out: 'row' side by side, 'column' stacked."
+        },
+        "regions": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 12,
+          "items": {
+            "$ref": "#/$defs/RegionEntry"
+          },
+          "description": "The split's regions in reading order: 1 to 12 regions and splits."
+        },
+        "size": {
+          "$ref": "#/$defs/RegionSize"
+        },
+        "anchor": {
+          "type": "string",
+          "enum": [
+            "top",
+            "middle",
+            "bottom"
+          ],
+          "description": "Vertical position of the content of every body region under this split, unless the region sets its own. The heading regions 'title' and 'subtitle' never inherit it."
+        }
+      }
+    },
+    "Region": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "One body region of a layout: its name, its share of the space and the rules for which content it takes and how several blocks share it.",
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*$",
+          "not": {
+            "enum": [
+              "title",
+              "subtitle"
+            ]
+          },
+          "description": "The region's name, lowercase kebab-case, unique across the whole record. A block targets it with 'region': '<name>'. It may not be 'title' (those are heading regions), 'tag', 'auto' or one of the promoted-region words ('left', 'center', 'right', 'top', 'middle', 'bottom'), so a Markdown block's region= option stays unambiguous: the validate finding opf/layout-region.",
+          "examples": [
+            "main",
+            "aside",
+            "chart"
+          ]
+        },
+        "size": {
+          "$ref": "#/$defs/RegionSize"
+        },
         "accepts": {
           "type": "array",
           "minItems": 1,
@@ -248,7 +332,7 @@
               "group"
             ]
           },
-          "description": "Content kinds the region takes: the body content kinds, and 'group' for a content group of any content. A group is also accepted where every one of its leaf kinds is.",
+          "description": "Content kinds the region takes: the body content kinds, and 'group' for a content group of any content. A group is also accepted where every one of its leaf kinds is. Omitted: every body content kind and 'group'.",
           "examples": [
             [
               "text",
@@ -308,7 +392,7 @@
             "middle",
             "bottom"
           ],
-          "description": "Vertical position of the region's content when it is shorter than the region. Default 'top'."
+          "description": "Vertical position of the region's content when it is shorter than the region. Replaces the 'anchor' of the record and of the splits around it. Default: the nearest of those that sets one, else 'top'."
         },
         "empty": {
           "type": "string",
@@ -318,7 +402,10 @@
           ],
           "description": "What the region does on a slide that gives it no content: 'collapse' (default) joins its cells to a neighbouring area that shares the full length of one of its edges and is not itself empty; 'keep' leaves the space."
         }
-      }
+      },
+      "required": [
+        "name"
+      ]
     },
     "DesignHints": {
       "type": "object",

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

@@ -3819,7 +3819,7 @@
             {
               "source": "https://www.pptx.gallery",
               "layouts": {
-                "two-column": { "name": "Two column", "areas": [["title", "title"], ["primary", "secondary"]], "regions": { "primary": { "accepts": ["text"] }, "secondary": { "accepts": ["text"] } } }
+                "two-column": { "name": "Two column", "regions": [{ "name": "title" }, { "direction": "row", "regions": [{ "name": "primary", "accepts": ["text"] }, { "name": "secondary", "accepts": ["text"] }] }] }
               }
             },
             false
@@ -3846,10 +3846,10 @@
           },
           "acme": {
             "source": "pkg:@acme/opf-catalog",
-            "layouts": { "hero": { "name": "Hero", "areas": [["title"]] } }
+            "layouts": { "hero": { "name": "Hero", "regions": [{ "name": "title" }] } }
           },
           "custom": {
-            "layouts": { "q4-special": { "name": "Q4 special", "areas": [["title"], ["chart"]], "regions": { "chart": { "accepts": ["chart"], "flow": "none" } } } }
+            "layouts": { "q4-special": { "name": "Q4 special", "regions": [{ "name": "title" }, { "name": "chart", "accepts": ["chart"], "flow": "none" }] } }
           }
         }
       ]
@@ -3925,7 +3925,7 @@
     "Composition": {
       "type": "object",
       "additionalProperties": false,
-      "description": "Automatic slide and content-group arrangement. Nested content groups arrange their children independently, inheriting only minFontSize and overflow. Explicit promoted regions retain their positions. A v2 layout defines its grid through areas, tracks and regions; its composition supports gap, padding, minFontSize and overflow rather than mode, columns or weights.",
+      "description": "Automatic slide and content-group arrangement. Nested content groups arrange their children independently, inheriting only minFontSize and overflow. Explicit promoted regions retain their positions. A layout defines its grid as one ordered list of regions; its composition supports gap, padding, minFontSize and overflow rather than mode, columns or weights.",
       "properties": {
         "mode": {
           "type": "string",

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-export { P as Presentation } from './presentation-Dn-fm0iY.js';
+export { P as Presentation } from './presentation-Bwo8Ko6D.js';
 export { b as CatalogKind } from './catalog-refs-CSHevLn1.js';
 export { SchemaName } from './schemas.js';
 export { a as Finding, d as FindingCategory, e as FindingFix, f as FindingFocus, b as FindingLocation, F as FindingReport, c as FindingSeverity, g as FindingSuggestion, J as JsonPatchOperation, V as ValidationIssue } from './finding-l9dlQ2NF.js';
@@ -368,7 +368,21 @@ interface ColorVariant {
 }
 
 /**
- * Schema for slide-layout records (OPF 0.19). A layout is a grid template: 'areas' names the cells of a grid using nested row arrays, 'columns' and 'rows' size its tracks, and 'regions' says, for every body area, which content kinds it takes and how several blocks share it. Slide content stays flat: engines bind a slide's blocks to the regions by reading order, role and kind (bindRegions in @openpresentation/opf), a block may pin itself to a region with 'region', and an empty region collapses into a neighbour. Built-in and custom layouts are records of this one schema; a custom layout is embedded under catalogs.custom.layouts or shipped in a catalog. Documents reference a layout from Slide.layout; a slide without a layout, with layout 'auto', or whose layout resolves nowhere composes automatically.
+ * One entry of a regions list: a heading region, a body region or a split.
+ *
+ * This interface was referenced by `Layout`'s JSON-Schema
+ * via the `definition` "RegionEntry".
+ */
+type RegionEntry = (HeadingRegion | Region | Split);
+/**
+ * The region's or split's share along its parent's direction: a number above 0 and up to 100 that siblings share in proportion (the gap is taken out first), default 1; or 'auto', the length the content needs at the starting text size (at most half the content box; a split sized auto is as tall as its tallest content, and every row of a column split sized auto is auto too; auto regions with no content take no space). 'auto' is allowed only on an entry of a column; in a row it is the validate finding opf/layout-template. The default for a heading region is 'auto' in a column and 1 in a row.
+ *
+ * This interface was referenced by `Layout`'s JSON-Schema
+ * via the `definition` "RegionSize".
+ */
+type RegionSize = (number | "auto");
+/**
+ * Schema for slide-layout records. A layout is one ordered list of regions, declared once, in reading order: 'direction' says whether the record's 'regions' sit side by side (row) or are stacked (column), and each region says which content kinds it takes and how several blocks share it. A split is an entry that nests a second list the other way, which is how a layout gets two dimensions. 'title' and 'subtitle' are reserved heading regions. Engines compile the list into a grid of tracks (the guillotine partition it describes). Slide content stays flat: engines bind a slide's blocks to the regions by reading order, role and kind (bindRegions in @openpresentation/opf), a block may pin itself to a region with 'region', and an empty region collapses into a neighbour. Built-in and custom layouts are records of this one schema; a custom layout is embedded under catalogs.custom.layouts or shipped in a catalog. Documents reference a layout from Slide.layout; a slide without a layout, with layout 'auto', or whose layout resolves nowhere composes automatically.
  *
  * A document references a record as a bare id or 'name:id' and resolves it in its own catalogs groups first, then in the catalog the host registered for the group's source; engines never fetch a catalog. A published record file carries '$schema' and 'id'; the copy a document embeds under catalogs.<group>.<kind>.<id> carries neither (the key is the id) and no 'x-*' display metadata.
  */
@@ -395,32 +409,20 @@ interface Layout {
     description?: string;
     design?: DesignHints;
     /**
-     * The grid as nested arrays: each inner array is a row, each string is one cell, and a name repeated over adjacent cells spans them; '.' is an empty cell. Cells are lowercase names ([a-z][a-z0-9-]*) or '.', and every row has the same number of cells (at most 12 rows and 12 columns). A name's cells must form one filled rectangle. 'title' and 'subtitle' are heading areas: 'title' holds the slide's heading group (tag, title and subtitle, stacked) and a 'subtitle' area takes the subtitle out of it; they have no regions entry, and a 'subtitle' area needs a 'title' area. A layout with no 'title' area gets an implicit auto row on top for a slide that has headings. Every other name is a body region and needs an entry in 'regions'. The grid rules a schema cannot express are the validate finding opf/layout-template.
-     *
-     * @minItems 1
-     * @maxItems 12
+     * How the record's 'regions' are laid out: 'row' places them side by side, left to right in reading order; 'column' stacks them top to bottom. Default 'column'.
      */
-    areas: [[string, ...(string)[]]] | [[string, ...(string)[]], [string, ...(string)[]]] | [[string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]]] | [[string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]]] | [[string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]]] | [[string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]]] | [[string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]]] | [[string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]]] | [[string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]]] | [[string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]]] | [[string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]]] | [[string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]]];
+    direction?: ("row" | "column");
     /**
-     * Relative column widths, one per cell of a row; the columns share the content width in proportion, separated by the gap. Omitted: all 1. Columns are numbers only.
-     *
-     * @minItems 1
-     * @maxItems 12
+     * Vertical position of the content of every body region when it is shorter than the region. A split's 'anchor' replaces it for the regions under that split, and a region's own 'anchor' replaces both. Only 'anchor' is inherited, and only by body regions: the heading regions 'title' and 'subtitle' never take it, and the other region rules stay per region. Default 'top'.
      */
-    columns?: [number] | [number, number] | [number, number, number] | [number, number, number, number] | [number, number, number, number, number] | [number, number, number, number, number, number] | [number, number, number, number, number, number, number] | [number, number, number, number, number, number, number, number] | [number, number, number, number, number, number, number, number, number] | [number, number, number, number, number, number, number, number, number, number] | [number, number, number, number, number, number, number, number, number, number, number] | [number, number, number, number, number, number, number, number, number, number, number, number];
+    anchor?: ("top" | "middle" | "bottom");
     /**
-     * Relative row heights, one per string of 'areas'. 'auto' is the height the row's content needs at the starting text size (at most half the content box; areas that span several rows do not size it); the numeric rows share the rest in proportion. An auto row whose areas are all empty has no height. Omitted: all 1.
+     * The record's regions in reading order: 1 to 12 entries, each a region ({ name, size?, ...rules }) or a split ({ direction, regions, size?, anchor? }). Every region is declared once, here, with its content rules; a block can target a body region with 'region': '<name>'. Names are unique across the whole record. 'size' is a number above 0 and up to 100 (default 1) that siblings share in proportion, separated by the gap; 'auto' is the height the content needs, allowed only in a column. 'title' and 'subtitle' are heading regions that take only a size (default auto in a column, 1 in a row): 'title' holds the slide's heading group (tag, title and subtitle, stacked) and a 'subtitle' region takes the subtitle out of it, and a 'subtitle' needs a 'title'. A record with no 'title' region gets an implicit auto row on top for a slide that has headings. Splits nest at most three levels (the record's own list is level 1). Rules the schema cannot express (a reserved or repeated name, a 'subtitle' without a 'title', 'auto' outside a column, nesting too deep, more than 12 rows or columns once compiled) are the validate findings opf/layout-template and opf/layout-region.
      *
      * @minItems 1
      * @maxItems 12
      */
-    rows?: [(number | "auto")] | [(number | "auto"), (number | "auto")] | [(number | "auto"), (number | "auto"), (number | "auto")] | [(number | "auto"), (number | "auto"), (number | "auto"), (number | "auto")] | [(number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto")] | [(number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto")] | [(number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto")] | [(number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto")] | [(number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto")] | [(number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto")] | [(number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto")] | [(number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto")];
-    /**
-     * One entry per body area, keyed by the area's name. Region names may not be 'title', 'subtitle', 'tag', 'auto' or one of the promoted-region words ('left', 'center', 'right', 'top', 'middle', 'bottom'), so a Markdown block's region= option stays unambiguous. Region rules the schema cannot express (an area without a region, a region without an area, a reserved name) are the validate finding opf/layout-region.
-     */
-    regions?: {
-        [k: string]: Region;
-    };
+    regions: [RegionEntry] | [RegionEntry, RegionEntry] | [RegionEntry, RegionEntry, RegionEntry] | [RegionEntry, RegionEntry, RegionEntry, RegionEntry] | [RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry] | [RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry] | [RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry] | [RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry] | [RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry] | [RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry] | [RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry] | [RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry];
     /**
      * The region where content that no region accepts goes, whatever its 'accepts', while it has room; content beyond every region's room is drawn there too, with the warning opf/layout-unplaced. Omitted: the first primary region (in reading order) whose flow is not 'none'.
      */
@@ -448,6 +450,10 @@ interface Layout {
         [k: string]: unknown;
     };
     composition?: Composition;
+    /**
+     * This interface was referenced by `Layout`'s JSON-Schema definition
+     * via the `patternProperty` "^x-".
+     */
     [k: string]: unknown;
 }
 /**
@@ -488,18 +494,36 @@ interface DesignHints {
     mirror?: boolean;
 }
 /**
- * One body region of a layout: which content it takes and how several blocks share it.
+ * A reserved heading region: 'title' holds the slide's heading group (tag, title and subtitle, stacked) and 'subtitle' takes the subtitle out of it. A heading region takes only a size. At most one of each; a 'subtitle' needs a 'title'.
+ *
+ * This interface was referenced by `Layout`'s JSON-Schema
+ * via the `definition` "HeadingRegion".
+ */
+interface HeadingRegion {
+    /**
+     * 'title' or 'subtitle'.
+     */
+    name: ("title" | "subtitle");
+    size?: RegionSize;
+}
+/**
+ * One body region of a layout: its name, its share of the space and the rules for which content it takes and how several blocks share it.
  *
  * This interface was referenced by `Layout`'s JSON-Schema
  * via the `definition` "Region".
  */
 interface Region {
     /**
-     * Content kinds the region takes: the body content kinds, and 'group' for a content group of any content. A group is also accepted where every one of its leaf kinds is.
+     * The region's name, lowercase kebab-case, unique across the whole record. A block targets it with 'region': '<name>'. It may not be 'title' (those are heading regions), 'tag', 'auto' or one of the promoted-region words ('left', 'center', 'right', 'top', 'middle', 'bottom'), so a Markdown block's region= option stays unambiguous: the validate finding opf/layout-region.
+     */
+    name: string;
+    size?: RegionSize;
+    /**
+     * Content kinds the region takes: the body content kinds, and 'group' for a content group of any content. A group is also accepted where every one of its leaf kinds is. Omitted: every body content kind and 'group'.
      *
      * @minItems 1
      */
-    accepts: [("text" | "list" | "image" | "video" | "chart" | "table" | "code" | "metric" | "quote" | "timeline" | "group"), ...(("text" | "list" | "image" | "video" | "chart" | "table" | "code" | "metric" | "quote" | "timeline" | "group"))[]];
+    accepts?: [("text" | "list" | "image" | "video" | "chart" | "table" | "code" | "metric" | "quote" | "timeline" | "group"), ...(("text" | "list" | "image" | "video" | "chart" | "table" | "code" | "metric" | "quote" | "timeline" | "group"))[]];
     /**
      * Which content the region wants first. Binding gives a picture (image, video) to a media region first, then primary, secondary, supporting; every other kind to a primary region first, then secondary, supporting, media; of two equal regions the first in reading order fills first. A supporting region receives content only when no primary or secondary region that accepts it has room, or by a pin. Default 'primary'.
      */
@@ -521,7 +545,7 @@ interface Region {
      */
     listColumns?: ("auto" | 1);
     /**
-     * Vertical position of the region's content when it is shorter than the region. Default 'top'.
+     * Vertical position of the region's content when it is shorter than the region. Replaces the 'anchor' of the record and of the splits around it. Default: the nearest of those that sets one, else 'top'.
      */
     anchor?: ("top" | "middle" | "bottom");
     /**
@@ -529,6 +553,30 @@ interface Region {
      */
     empty?: ("collapse" | "keep");
 }
+/**
+ * A split nests a list of regions the other way inside one cell of its parent: a row of regions inside a column, or a column inside a row. It has no name; its regions are declared in reading order like the record's own. Splits nest at most three levels (the record's own list is level 1).
+ *
+ * This interface was referenced by `Layout`'s JSON-Schema
+ * via the `definition` "Split".
+ */
+interface Split {
+    /**
+     * How the split's 'regions' are laid out: 'row' side by side, 'column' stacked.
+     */
+    direction: ("row" | "column");
+    /**
+     * The split's regions in reading order: 1 to 12 regions and splits.
+     *
+     * @minItems 1
+     * @maxItems 12
+     */
+    regions: [RegionEntry] | [RegionEntry, RegionEntry] | [RegionEntry, RegionEntry, RegionEntry] | [RegionEntry, RegionEntry, RegionEntry, RegionEntry] | [RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry] | [RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry] | [RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry] | [RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry] | [RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry] | [RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry] | [RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry] | [RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry, RegionEntry];
+    size?: RegionSize;
+    /**
+     * Vertical position of the content of every body region under this split, unless the region sets its own. The heading regions 'title' and 'subtitle' never inherit it.
+     */
+    anchor?: ("top" | "middle" | "bottom");
+}
 /**
  * Only 'gap', 'padding', 'minFontSize' and 'overflow', with their 0.18 meaning. A template's regions replace composition.mode, columns and weights.
  */

package/dist/{validation-types-CzPKoKWo.d.ts → validation-types-JW8e06ee.d.ts}

@@ -1,5 +1,5 @@
 import { C as Catalog } from './catalog-refs-CSHevLn1.js';
-import { T as TextMeasurement } from './composition-qX-igJe5.js';
+import { T as TextMeasurement } from './composition-Daqvi-GV.js';
 import { c as FindingSeverity, F as FindingReport } from './finding-l9dlQ2NF.js';
 import { J as JsonPrimitive } from './json-BFSdESOE.js';
 

package/dist/{validator-BuAV_HUo.d.ts → validator-Dym2zYVK.d.ts}

@@ -1,8 +1,8 @@
 import { b as CatalogKind } from './catalog-refs-CSHevLn1.js';
 import { SchemaName } from './schemas.js';
 import { a as Finding } from './finding-l9dlQ2NF.js';
-import { P as Presentation } from './presentation-Dn-fm0iY.js';
-import { b as ValidationThresholds, c as ValidationRuleInfo, V as ValidationReport, a as ValidateOptions } from './validation-types-CzPKoKWo.js';
+import { P as Presentation } from './presentation-Bwo8Ko6D.js';
+import { b as ValidationThresholds, c as ValidationRuleInfo, V as ValidationReport, a as ValidateOptions } from './validation-types-JW8e06ee.js';
 
 /**
  * RR-78: the version of the catalog record schemas (spec/schemas/<kind>.schema.json) this core reads. A catalog package
@@ -10,7 +10,7 @@ import { b as ValidationThresholds, c as ValidationRuleInfo, V as ValidationRepo
  * @openpresentation/gallery does); the Node defaults refuse a gallery that targets another one. A record schema change that
  * old records no longer validate against raises it.
  */
-declare const CATALOG_SCHEMA = 3;
+declare const CATALOG_SCHEMA = 4;
 /** Kinds of catalog display metadata: published by catalogs for pickers, never referenced by documents. */
 declare const catalogDisplayKinds: readonly ["chartTypes", "languages", "socialPlatforms"];
 type CatalogDisplayKind = (typeof catalogDisplayKinds)[number];

package/dist/validator.d.ts

@@ -1,9 +1,9 @@
-export { D as DEFAULT_VALIDATION_THRESHOLDS, O as OPFValidationError, c as assertValid, d as assertValidCatalogRecord, g as findValidationRule, p as promotedRegionKeys, v as validate, h as validateCatalogRecord, i as validationRules } from './validator-BuAV_HUo.js';
+export { D as DEFAULT_VALIDATION_THRESHOLDS, O as OPFValidationError, c as assertValid, d as assertValidCatalogRecord, g as findValidationRule, p as promotedRegionKeys, v as validate, h as validateCatalogRecord, i as validationRules } from './validator-Dym2zYVK.js';
 import './finding-l9dlQ2NF.js';
-import './presentation-Dn-fm0iY.js';
-export { C as Contract, d as ValidateFonts, a as ValidateOptions, e as ValidationCategory, f as ValidationChecks, V as ValidationReport, g as ValidationRuleCost, c as ValidationRuleInfo, b as ValidationThresholds, v as validationCategories } from './validation-types-CzPKoKWo.js';
+import './presentation-Bwo8Ko6D.js';
+export { C as Contract, d as ValidateFonts, a as ValidateOptions, e as ValidationCategory, f as ValidationChecks, V as ValidationReport, g as ValidationRuleCost, c as ValidationRuleInfo, b as ValidationThresholds, v as validationCategories } from './validation-types-JW8e06ee.js';
 import './catalog-refs-CSHevLn1.js';
 import './schemas.js';
 import './json-BFSdESOE.js';
-import './composition-qX-igJe5.js';
+import './composition-Daqvi-GV.js';
 import './chart-data-BnNqgnC-.js';

package/dist/validator.js

@@ -1,3 +1,3 @@
-export { DEFAULT_VALIDATION_THRESHOLDS, OPFValidationError, assertValid, assertValidCatalogRecord, findValidationRule, validate, validateCatalogRecord, validationCategories, validationRules } from './chunk-F6CDJTSE.js';
-export { promotedRegionKeys } from './chunk-N3ZPLGK5.js';
-import './chunk-BN3A5TVI.js';
+export { DEFAULT_VALIDATION_THRESHOLDS, OPFValidationError, assertValid, assertValidCatalogRecord, findValidationRule, validate, validateCatalogRecord, validationCategories, validationRules } from './chunk-P7S3ORB4.js';
+export { promotedRegionKeys } from './chunk-XRMV2GMB.js';
+import './chunk-F4HFDP6I.js';

package/dist/yaml.d.ts

@@ -1,8 +1,8 @@
 import { C as Catalog } from './catalog-refs-CSHevLn1.js';
-import { P as Presentation } from './presentation-Dn-fm0iY.js';
-import { a as ValidateOptions, V as ValidationReport } from './validation-types-CzPKoKWo.js';
+import { P as Presentation } from './presentation-Bwo8Ko6D.js';
+import { a as ValidateOptions, V as ValidationReport } from './validation-types-JW8e06ee.js';
 import { a as Finding, b as FindingLocation } from './finding-l9dlQ2NF.js';
-import './composition-qX-igJe5.js';
+import './composition-Daqvi-GV.js';
 import './chart-data-BnNqgnC-.js';
 import './json-BFSdESOE.js';