@openpresentation/opf 0.2.1 → 0.2.2

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

@@ -62,16 +62,23 @@
       "examples": ["Bob Lee", ["Bob Lee", "Carla Diaz"]]
     },
     "audience": {
-      "type": "array",
-      "items": {
-        "oneOf": [
-          { "type": "string" },
-          { "$ref": "#/$defs/Audience" }
-        ]
-      },
-      "minItems": 1,
-      "description": "Intended audiences for the presentation. Each item accepts either:\n- A string shorthand: free-form description ('Series B investors'), an audiences catalog id ('executives'), an HTTPS URL, or a 'pkg:' reference.\n- An inline Audience object for custom audience metadata or catalog-backed overrides. Object form mirrors https://openpresentation.org/schema/opf-audience/v1 without '$schema'.\n\nResolution order for catalog ids and references: inline catalogs.audiences.records[] → catalogs.audiences.source → default catalog at https://www.pptx.gallery/audiences.",
+      "oneOf": [
+        { "type": "string" },
+        {
+          "type": "array",
+          "items": {
+            "oneOf": [
+              { "type": "string" },
+              { "$ref": "#/$defs/Audience" }
+            ]
+          },
+          "minItems": 1
+        }
+      ],
+      "description": "Intended audiences for the presentation. Accepts either:\n- A single string shorthand: free-form description ('Series B investors'), an audiences catalog id ('executives'), an HTTPS URL, or a 'pkg:' reference.\n- An array of string shorthands and/or inline Audience objects for custom audience metadata or catalog-backed overrides. Object form mirrors https://openpresentation.org/schema/opf-audience/v1 without '$schema'.\n\nResolution order for catalog ids and references: inline catalogs.audiences.records[] → catalogs.audiences.source → default catalog at https://www.pptx.gallery/audiences.",
       "examples": [
+        "executives",
+        "Biology Students and Wildlife Enthusiasts",
         ["executives"],
         ["board", "c-suite"],
         ["Series B investors", "https://acme.com/decks/audiences/acme-board.json"],
@@ -1586,7 +1593,7 @@
         "items": {
           "type": "array",
           "items": { "$ref": "#/$defs/ListItem" },
-          "description": "Full-slide generic list payload. Presence of this field infers type 'list'."
+          "description": "Full-slide generic list payload. Presence of this field infers type 'list'. At slide root, multiple content payload kinds with no explicit type, blocks, or regions are accepted as shorthand for layout-agnostic blocks."
         },
         "bullets": {
           "type": "array",
@@ -1638,7 +1645,7 @@
         "blocks": {
           "type": "array",
           "items": { "$ref": "#/$defs/ContentPayload" },
-          "description": "Layout-agnostic content blocks rendered together as a composed payload when exact placement is unspecified."
+          "description": "Layout-agnostic content blocks rendered together as a composed payload when exact placement is unspecified. At slide root, multiple content payload kinds with no explicit type, blocks, or regions are accepted as shorthand for equivalent blocks."
         },
         "design": {
           "$ref": "#/$defs/Design",

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-export { P as Presentation, V as ValidationIssue, a as ValidationResult } from './validator-D7WwzKyx.js';
+export { P as Presentation, V as ValidationIssue, a as ValidationResult } from './validator-MwlR2F56.js';
 export { CatalogKind } from './catalogs.js';
 export { SchemaName } from './schemas.js';
 

package/dist/{validator-D7WwzKyx.d.ts → validator-MwlR2F56.d.ts}

@@ -550,15 +550,13 @@ interface Presentation {
      */
     author?: (string | [string, ...(string)[]]);
     /**
-     * Intended audiences for the presentation. Each item accepts either:
-     * - A string shorthand: free-form description ('Series B investors'), an audiences catalog id ('executives'), an HTTPS URL, or a 'pkg:' reference.
-     * - An inline Audience object for custom audience metadata or catalog-backed overrides. Object form mirrors https://openpresentation.org/schema/opf-audience/v1 without '$schema'.
+     * Intended audiences for the presentation. Accepts either:
+     * - A single string shorthand: free-form description ('Series B investors'), an audiences catalog id ('executives'), an HTTPS URL, or a 'pkg:' reference.
+     * - An array of string shorthands and/or inline Audience objects for custom audience metadata or catalog-backed overrides. Object form mirrors https://openpresentation.org/schema/opf-audience/v1 without '$schema'.
      *
      * Resolution order for catalog ids and references: inline catalogs.audiences.records[] → catalogs.audiences.source → default catalog at https://www.pptx.gallery/audiences.
-     *
-     * @minItems 1
      */
-    audience?: [(string | Audience), ...((string | Audience))[]];
+    audience?: (string | [(string | Audience), ...((string | Audience))[]]);
     /**
      * Primary goal of the presentation. Accepts either:
      * - A string shorthand: free-form goal ('Raise a Series B round of $30M'), a purposes catalog id ('decide', 'align'), an HTTPS URL, or a 'pkg:' reference.
@@ -2022,7 +2020,7 @@ interface Slide {
      */
     text?: (string | TextRun[]);
     /**
-     * Full-slide generic list payload. Presence of this field infers type 'list'.
+     * Full-slide generic list payload. Presence of this field infers type 'list'. At slide root, multiple content payload kinds with no explicit type, blocks, or regions are accepted as shorthand for layout-agnostic blocks.
      */
     items?: ListItem[];
     /**
@@ -2121,7 +2119,7 @@ interface Slide {
         events: [TimelineEvent, ...(TimelineEvent)[]];
     });
     /**
-     * Layout-agnostic content blocks rendered together as a composed payload when exact placement is unspecified.
+     * Layout-agnostic content blocks rendered together as a composed payload when exact placement is unspecified. At slide root, multiple content payload kinds with no explicit type, blocks, or regions are accepted as shorthand for equivalent blocks.
      */
     blocks?: ContentPayload[];
     design?: Design1;

package/dist/validator.d.ts

@@ -1,3 +1,3 @@
 import './catalogs.js';
-export { O as OPFValidationError, S as SchemaOrKind, V as ValidationIssue, a as ValidationResult, b as assertValid, c as assertValidCatalogRecord, d as assertValidPresentation, v as validate, e as validateCatalogRecord, f as validatePresentation } from './validator-D7WwzKyx.js';
+export { O as OPFValidationError, S as SchemaOrKind, V as ValidationIssue, a as ValidationResult, b as assertValid, c as assertValidCatalogRecord, d as assertValidPresentation, v as validate, e as validateCatalogRecord, f as validatePresentation } from './validator-MwlR2F56.js';
 import './schemas.js';

package/dist/validator.js

@@ -110,20 +110,29 @@ var presentation = {
       ]
     },
     "audience": {
-      "type": "array",
-      "items": {
-        "oneOf": [
-          {
-            "type": "string"
+      "oneOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "array",
+          "items": {
+            "oneOf": [
+              {
+                "type": "string"
+              },
+              {
+                "$ref": "#/$defs/Audience"
+              }
+            ]
           },
-          {
-            "$ref": "#/$defs/Audience"
-          }
-        ]
-      },
-      "minItems": 1,
-      "description": "Intended audiences for the presentation. Each item accepts either:\n- A string shorthand: free-form description ('Series B investors'), an audiences catalog id ('executives'), an HTTPS URL, or a 'pkg:' reference.\n- An inline Audience object for custom audience metadata or catalog-backed overrides. Object form mirrors https://openpresentation.org/schema/opf-audience/v1 without '$schema'.\n\nResolution order for catalog ids and references: inline catalogs.audiences.records[] \u2192 catalogs.audiences.source \u2192 default catalog at https://www.pptx.gallery/audiences.",
+          "minItems": 1
+        }
+      ],
+      "description": "Intended audiences for the presentation. Accepts either:\n- A single string shorthand: free-form description ('Series B investors'), an audiences catalog id ('executives'), an HTTPS URL, or a 'pkg:' reference.\n- An array of string shorthands and/or inline Audience objects for custom audience metadata or catalog-backed overrides. Object form mirrors https://openpresentation.org/schema/opf-audience/v1 without '$schema'.\n\nResolution order for catalog ids and references: inline catalogs.audiences.records[] \u2192 catalogs.audiences.source \u2192 default catalog at https://www.pptx.gallery/audiences.",
       "examples": [
+        "executives",
+        "Biology Students and Wildlife Enthusiasts",
         [
           "executives"
         ],
@@ -2478,7 +2487,7 @@ Resolution order: inline catalogs.fontSchemes.records[] -> catalogs.fontSchemes.
           "items": {
             "$ref": "#/$defs/ListItem"
           },
-          "description": "Full-slide generic list payload. Presence of this field infers type 'list'."
+          "description": "Full-slide generic list payload. Presence of this field infers type 'list'. At slide root, multiple content payload kinds with no explicit type, blocks, or regions are accepted as shorthand for layout-agnostic blocks."
         },
         "bullets": {
           "type": "array",
@@ -2548,7 +2557,7 @@ Resolution order: inline catalogs.fontSchemes.records[] -> catalogs.fontSchemes.
           "items": {
             "$ref": "#/$defs/ContentPayload"
           },
-          "description": "Layout-agnostic content blocks rendered together as a composed payload when exact placement is unspecified."
+          "description": "Layout-agnostic content blocks rendered together as a composed payload when exact placement is unspecified. At slide root, multiple content payload kinds with no explicit type, blocks, or regions are accepted as shorthand for equivalent blocks."
         },
         "design": {
           "$ref": "#/$defs/Design",
@@ -6484,6 +6493,12 @@ function inferredKinds(value) {
   if (hasOwn(value, "timeline")) kinds.push("timeline");
   return kinds;
 }
+function isImplicitBlocksComposition(value, inferred, options) {
+  if (options.allowBlocks !== true || hasOwn(value, "blocks")) {
+    return false;
+  }
+  return inferred.length > 1;
+}
 function validateContentPayload(value, path, options = {}) {
   const issues = [];
   const explicitType = value.type;
@@ -6510,6 +6525,9 @@ function validateContentPayload(value, path, options = {}) {
     return issues;
   }
   if (!kind && inferred.length > 1) {
+    if (isImplicitBlocksComposition(value, inferred, options)) {
+      return issues;
+    }
     issues.push(semanticIssue(path, "content payload mixes fields from incompatible content types", {
       inferredTypes: inferred
     }));