@openpresentation/opf 0.22.2 → 0.23.0

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

@@ -693,6 +693,14 @@
           "description": "Default slide background applied across the deck unless overridden on a slide (slides.N.design.background); the resolved theme's background is the fallback. A background is the only canvas fill and never moves content. String shorthand accepts theme slots ('light1', 'light2', 'dark1', 'dark2'), hex colors, or an image source starting with 'asset:', 'https://', 'data:', './' or '../' (a cover image); object forms support theme, solid, gradient, image, or pattern fills.",
           "examples": ["dark1", "#ffff00", { "type": "theme", "slot": "light1" }]
         },
+        "variant": {
+          "oneOf": [
+            { "$ref": "#/$defs/ThemeBackgroundSlot" },
+            { "$ref": "#/$defs/ColorVariant" }
+          ],
+          "description": "Optional color variant, as a background slot ('light1', 'light2', 'dark1', 'dark2'; the same as { background: slot }) or the object form, which is needed only for an accent order: which slot of the color scheme is the slide background (and so which are the text and the alternate surface), and optionally the order of the accents. A variant is a mapping over the same twelve-slot scheme, as PowerPoint's color map is, never a second scheme. Without it the background decides: a theme-slot background ('dark1', { type: 'theme', slot }) is the variant of that slot, a picture or gradient takes its 'tone', and any other background picks light or dark by its luminance. A slide's variant replaces the deck's whole, including its accent order.",
+          "examples": ["dark1", { "background": "light1", "accents": ["accent2", "accent1", "accent3", "accent4", "accent5", "accent6"] }]
+        },
         "logo": {
           "oneOf": [
             {
@@ -1435,6 +1443,28 @@
       "description": "An image source in a string shorthand: an 'asset:<id>' reference, an HTTPS URL, a data URI, or a relative path starting with './' or '../' (resolved against the OPF file location).",
       "examples": ["asset:cover-photo", "https://cdn.acme.com/backgrounds/cover.jpg", "./images/harbour.jpg"]
     },
+    "ColorVariant": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["background"],
+      "description": "A variant of the deck's single color scheme, as a mapping over its twelve slots (PowerPoint's clrMap): 'background' is the slot the slide background and the role bg1 take, and with it the other roles: light1 maps bg1 = light1, tx1 = dark1, bg2 = light2, tx2 = dark2; dark1 maps bg1 = dark1, tx1 = light1, bg2 = dark2, tx2 = light2; light2 and dark2 make that slot both the background and the alternate surface (light2: bg1 = bg2 = light2, tx1 = dark1, tx2 = dark2; dark2: bg1 = bg2 = dark2, tx1 = light1, tx2 = light2), which is how a slide with that theme background has always been drawn. Text, secondary text, the card surface and every neutral (borders, gridlines, chart axis, code panel) follow the map. The PowerPoint export writes it as the master's clrMap, or a slide's clrMapOvr.",
+      "properties": {
+        "background": {
+          "$ref": "#/$defs/ThemeBackgroundSlot",
+          "description": "The scheme slot that is the background (bg1) of the variant."
+        },
+        "accents": {
+          "type": "array",
+          "minItems": 6,
+          "maxItems": 6,
+          "uniqueItems": true,
+          "items": { "type": "string", "enum": ["accent1", "accent2", "accent3", "accent4", "accent5", "accent6"] },
+          "description": "Optional accent order: a permutation of accent1 to accent6. Entry i is the scheme slot drawn as accent i + 1, so primary, secondary and accent (the first three) and the chart series colors follow it. Default: the scheme's own order.",
+          "examples": [["accent2", "accent1", "accent3", "accent4", "accent5", "accent6"]]
+        }
+      },
+      "examples": [{ "background": "dark1" }, { "background": "light2", "accents": ["accent2", "accent1", "accent3", "accent4", "accent5", "accent6"] }]
+    },
     "Background": {
       "description": "Background fill applied to slides. Theme backgrounds preserve PowerPoint's color-scheme background choice; other variants represent fixed background fills.",
       "oneOf": [
@@ -1488,6 +1518,11 @@
       "description": "Fixed gradient slide background fill.",
       "required": ["type", "gradient"],
       "properties": {
+        "tone": {
+          "type": "string",
+          "enum": ["dark", "light"],
+          "description": "Whether the background is dark or light, which picks the color map (dark1 or light1) so text, lines and neutrals read on it. Without a tone a picture or gradient takes the deck's variant, else counts as light."
+        },
         "type": {
           "type": "string",
           "const": "gradient",
@@ -1540,6 +1575,11 @@
       "description": "Picture background: the image fills the whole canvas behind everything and never moves content (to push content aside, use an image block with placement). The string shorthand 'asset:x' (or any image source) is { type: 'image', src: 'asset:x' }, a cover image. Paint order: the colour scheme's default slide background, the picture, then the overlay, then furniture and content.",
       "required": ["type", "src"],
       "properties": {
+        "tone": {
+          "type": "string",
+          "enum": ["dark", "light"],
+          "description": "Whether the background is dark or light, which picks the color map (dark1 or light1) so text, lines and neutrals read on it. Without a tone a picture or gradient takes the deck's variant, else counts as light."
+        },
         "type": {
           "type": "string",
           "const": "image",

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-export { P as Presentation } from './presentation-fN6tORPZ.js';
+export { P as Presentation } from './presentation-Dn-fm0iY.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';

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

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

package/dist/{validator-Cflv4F9e.d.ts → validator-BuAV_HUo.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-fN6tORPZ.js';
-import { b as ValidationThresholds, c as ValidationRuleInfo, V as ValidationReport, a as ValidateOptions } from './validation-types-B21fZfb2.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';
 
 /**
  * RR-78: the version of the catalog record schemas (spec/schemas/<kind>.schema.json) this core reads. A catalog package

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-Cflv4F9e.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-BuAV_HUo.js';
 import './finding-l9dlQ2NF.js';
-import './presentation-fN6tORPZ.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-B21fZfb2.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 './catalog-refs-CSHevLn1.js';
 import './schemas.js';
 import './json-BFSdESOE.js';
-import './composition-CkHn6JrM.js';
+import './composition-qX-igJe5.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-23MOKE4B.js';
-export { promotedRegionKeys } from './chunk-VKNFZEMG.js';
-import './chunk-3UAVON3O.js';
+export { DEFAULT_VALIDATION_THRESHOLDS, OPFValidationError, assertValid, assertValidCatalogRecord, findValidationRule, validate, validateCatalogRecord, validationCategories, validationRules } from './chunk-L67MPTPZ.js';
+export { promotedRegionKeys } from './chunk-N3ZPLGK5.js';
+import './chunk-ZIRSAFRC.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-fN6tORPZ.js';
-import { a as ValidateOptions, V as ValidationReport } from './validation-types-B21fZfb2.js';
+import { P as Presentation } from './presentation-Dn-fm0iY.js';
+import { a as ValidateOptions, V as ValidationReport } from './validation-types-CzPKoKWo.js';
 import { a as Finding, b as FindingLocation } from './finding-l9dlQ2NF.js';
-import './composition-CkHn6JrM.js';
+import './composition-qX-igJe5.js';
 import './chart-data-BnNqgnC-.js';
 import './json-BFSdESOE.js';
 

package/dist/yaml.js

@@ -1,7 +1,7 @@
-export { OPFYamlError, YAML_SCHEMA_URL, fromYaml, parseYamlData, scanYamlComments, toYaml } from './chunk-7XNAMCGT.js';
-import './chunk-3T7MNRBY.js';
-import './chunk-X3PQMMAY.js';
-import './chunk-2SENTA2R.js';
-import './chunk-23MOKE4B.js';
-import './chunk-VKNFZEMG.js';
-import './chunk-3UAVON3O.js';
+export { OPFYamlError, YAML_SCHEMA_URL, fromYaml, parseYamlData, scanYamlComments, toYaml } from './chunk-B2XALDGS.js';
+import './chunk-TILQBXPZ.js';
+import './chunk-YMBA3V2O.js';
+import './chunk-F55S5HDP.js';
+import './chunk-L67MPTPZ.js';
+import './chunk-N3ZPLGK5.js';
+import './chunk-ZIRSAFRC.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openpresentation/opf",
-  "version": "0.22.2",
+  "version": "0.23.0",
   "description": "Canonical Open Presentation Format schemas, TypeScript types, local validation and composition; in Node, the file API and the CLI defaults register the pptx.gallery catalog of @openpresentation/gallery.",
   "license": "MIT",
   "author": "Open Presentation",
@@ -168,8 +168,8 @@
     "typescript": "~5.9.3"
   },
   "peerDependencies": {
-    "@openpresentation/opf-pptx": "^0.22.0",
-    "@openpresentation/opf-render": "^0.22.0"
+    "@openpresentation/opf-pptx": "^0.23.0",
+    "@openpresentation/opf-render": "^0.23.0"
   },
   "peerDependenciesMeta": {
     "@openpresentation/opf-pptx": {

package/dist/conversion-LBQMY7LX.js

@@ -1,19 +0,0 @@
-export { convertFiles, deckFileFormat, exportFormatOf, openDeck, planConversion, readInput, saveDeck, writePlanned } from './chunk-AHKRJSCF.js';
-import './chunk-MG34DCDB.js';
-import './chunk-MAJHCGOW.js';
-import './chunk-UJSAR6GF.js';
-import './chunk-SPCONMIY.js';
-import './chunk-MLMTXXM4.js';
-import './chunk-SBWIZSPB.js';
-import './chunk-7XNAMCGT.js';
-import './chunk-3T7MNRBY.js';
-import './chunk-BULGAKBY.js';
-import './chunk-YSJRBRHB.js';
-import './chunk-X3PQMMAY.js';
-import './chunk-YUIEWE5B.js';
-import './chunk-KUNXFN7B.js';
-import './chunk-2SENTA2R.js';
-import './chunk-23MOKE4B.js';
-import './chunk-VKNFZEMG.js';
-import './chunk-3UAVON3O.js';
-import './chunk-F7PLNWHQ.js';