@openpresentation/opf 0.20.5 → 0.21.0

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

@@ -3175,6 +3175,14 @@
           "description": "Text alternative for the chart: what the data shows (the point and the key numbers), not 'a chart' or 'bar chart'. The preview exposes it as the chart's accessible name (role img with aria-label) and the PowerPoint export writes it as the chart frame's alternative text (descr); import reads it back. An empty string marks the chart decorative, with the same meaning as an empty Asset alt, but it is a reviewed choice that opf/chart-text-alternative still reports as info (a chart almost always carries a message). When absent, validate accepts text beside the chart instead.",
           "examples": ["Revenue grew from $12M in Q1 to $18M in Q2, with the steepest rise in the West region."]
         },
+        "colors": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/ColorRef" },
+          "minItems": 1,
+          "maxItems": 24,
+          "description": "Optional series colors, by position: entry i replaces palette color i, the color of series i (the i-th plotted value column), of slice or category i on a pie, doughnut, treemap or funnel chart, and of the i-th color a histogram, pareto, waterfall or box-and-whisker chart draws with. An entry is any ColorRef: a hex color, a color-scheme slot or role ('accent3', 'secondary') or a 'var:<id>' color variable; a scheme name keeps following the deck if its scheme changes, and is written to PowerPoint as a theme color. Positions past the last entry keep the deck palette (accent1 to accent6, then their tints). A color is kept at 3:1 contrast against the chart panel (a lighter or darker shade is used when it falls short) and 'chart.highlight' wins over it: highlighted marks take the primary color and the rest the muted neutral. A color that cannot be resolved falls back to the palette color for its position. Absent keeps the deck palette exactly.",
+          "examples": [["accent3", "#7B241C"]]
+        },
         "highlight": {
           "$ref": "#/$defs/ChartHighlight",
           "description": "Optional emphasis: the series and/or categories that carry the message. The engines draw the highlighted marks in the deck's primary (accent) color and every other mark in a muted neutral derived from the theme (a light grey on a light chart panel, a dim grey on a dark one); there is no color field. A mark is highlighted when its series OR its category is named. Absent keeps today's colors exactly. Supported on column, bar and line charts (series and categories; on a line a category highlight marks that category's points), pie and doughnut charts (categories, one per slice), and area, scatter and radar charts (series); the histogram, pareto, waterfall, funnel, treemap, box-and-whisker, map and combo constructs drop the option with a 'chart-option-adapted' diagnostic, as does a part the type cannot highlight. A name that matches no column or row label is a 'chart-highlight-unknown-name' error."

package/dist/types.d.ts

@@ -1,7 +1,7 @@
-export { P as Presentation } from './presentation-BG4QCcdB.js';
+export { P as Presentation } from './presentation-ZNcXSpvm.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-DqgwzUmr.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';
 import './json-BFSdESOE.js';
 
 /**

package/dist/{validation-types-DRaNnieo.d.ts → validation-types-uLDSrJgM.d.ts}

@@ -1,6 +1,6 @@
 import { C as Catalog } from './catalog-refs-CSHevLn1.js';
-import { T as TextMeasurement } from './composition-QtS1rnhv.js';
-import { c as FindingSeverity, F as FindingReport } from './finding-DqgwzUmr.js';
+import { T as TextMeasurement } from './composition-DzAV0cfU.js';
+import { c as FindingSeverity, F as FindingReport } from './finding-l9dlQ2NF.js';
 import { J as JsonPrimitive } from './json-BFSdESOE.js';
 
 /**
@@ -249,7 +249,7 @@ interface ValidateOptions {
     thresholds?: Partial<ValidationThresholds>;
     /** The host's fonts. The layout rules use `fonts.textMeasurement`; see `ValidateFonts`. */
     fonts?: ValidateFonts;
-    /** Chart series palette (opaque `#RRGGBB`), in the engine's order. Default: the palette opf-render and opf-pptx use. */
+    /** Chart series palette (opaque `#RRGGBB`), in the engine's order. Default: `chartSeriesPalette` of each slide's colour scheme (accent1 to accent6, then their tints), as opf-render and opf-pptx draw them. */
     chartPalette?: readonly string[];
     /** Check as a template (true) or a normal deck (false), overriding the root `template` marker. */
     template?: boolean;

package/dist/{validator-BJtXHJKh.d.ts → validator-DxAjRPmE.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-DqgwzUmr.js';
-import { P as Presentation } from './presentation-BG4QCcdB.js';
-import { b as ValidationThresholds, c as ValidationRuleInfo, V as ValidationReport, a as ValidateOptions } from './validation-types-DRaNnieo.js';
+import { a as Finding } from './finding-l9dlQ2NF.js';
+import { P as Presentation } from './presentation-ZNcXSpvm.js';
+import { b as ValidationThresholds, c as ValidationRuleInfo, V as ValidationReport, a as ValidateOptions } from './validation-types-uLDSrJgM.js';
 
 /**
  * RR-78: the version of the catalog record schemas (spec/schemas/<kind>.schema.json) this core reads. A catalog package
@@ -19,12 +19,6 @@ type CatalogRecordKind = CatalogKind | CatalogDisplayKind;
 /** The companion schema each catalog record kind validates against. */
 declare const catalogSchemaNames: Readonly<Record<CatalogRecordKind, SchemaName>>;
 
-/**
- * The series palette opf-render and opf-pptx draw charts with (`CHART_COLORS`), in series order. A host with
- * its own palette passes `ValidateOptions.chartPalette`.
- */
-declare const DEFAULT_CHART_PALETTE: readonly string[];
-
 /**
  * The rule registry: every rule `validate` can report, with its category, default severity, cost, rationale and the
  * standard it follows. The format, references and policy rules are produced by the schema and reference checks; the
@@ -70,4 +64,4 @@ declare function assertValid(value: unknown, options?: ValidateOptions): asserts
 declare function validateCatalogRecord(kind: CatalogRecordKind, value: unknown): ValidationReport;
 declare function assertValidCatalogRecord(kind: CatalogRecordKind, value: unknown): void;
 
-export { CATALOG_SCHEMA as C, DEFAULT_CHART_PALETTE as D, OPFValidationError as O, type CatalogDisplayKind as a, type CatalogRecordKind as b, DEFAULT_VALIDATION_THRESHOLDS as c, assertValid as d, assertValidCatalogRecord as e, catalogDisplayKinds as f, catalogSchemaNames as g, findValidationRule as h, validateCatalogRecord as i, validationRules as j, promotedRegionKeys as p, validate as v };
+export { CATALOG_SCHEMA as C, DEFAULT_VALIDATION_THRESHOLDS as D, OPFValidationError as O, type CatalogDisplayKind as a, type CatalogRecordKind as b, assertValid as c, assertValidCatalogRecord as d, catalogDisplayKinds as e, catalogSchemaNames as f, findValidationRule as g, validateCatalogRecord as h, validationRules as i, promotedRegionKeys as p, validate as v };

package/dist/validator.d.ts

@@ -1,9 +1,9 @@
-export { D as DEFAULT_CHART_PALETTE, c as DEFAULT_VALIDATION_THRESHOLDS, O as OPFValidationError, d as assertValid, e as assertValidCatalogRecord, h as findValidationRule, p as promotedRegionKeys, v as validate, i as validateCatalogRecord, j as validationRules } from './validator-BJtXHJKh.js';
-import './finding-DqgwzUmr.js';
-import './presentation-BG4QCcdB.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-DRaNnieo.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-DxAjRPmE.js';
+import './finding-l9dlQ2NF.js';
+import './presentation-ZNcXSpvm.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-uLDSrJgM.js';
 import './catalog-refs-CSHevLn1.js';
 import './schemas.js';
 import './json-BFSdESOE.js';
-import './composition-QtS1rnhv.js';
+import './composition-DzAV0cfU.js';
 import './chart-data-BnNqgnC-.js';

package/dist/validator.js

@@ -1,3 +1,3 @@
-export { DEFAULT_CHART_PALETTE, DEFAULT_VALIDATION_THRESHOLDS, OPFValidationError, assertValid, assertValidCatalogRecord, findValidationRule, validate, validateCatalogRecord, validationCategories, validationRules } from './chunk-2M7U4WL3.js';
-export { promotedRegionKeys } from './chunk-XAYMPBNE.js';
-import './chunk-VFMHM2IL.js';
+export { DEFAULT_VALIDATION_THRESHOLDS, OPFValidationError, assertValid, assertValidCatalogRecord, findValidationRule, validate, validateCatalogRecord, validationCategories, validationRules } from './chunk-XQARTOZJ.js';
+export { promotedRegionKeys } from './chunk-X6SB52RP.js';
+import './chunk-BWWGYOOG.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-BG4QCcdB.js';
-import { a as ValidateOptions, V as ValidationReport } from './validation-types-DRaNnieo.js';
-import { a as Finding, b as FindingLocation } from './finding-DqgwzUmr.js';
-import './composition-QtS1rnhv.js';
+import { P as Presentation } from './presentation-ZNcXSpvm.js';
+import { a as ValidateOptions, V as ValidationReport } from './validation-types-uLDSrJgM.js';
+import { a as Finding, b as FindingLocation } from './finding-l9dlQ2NF.js';
+import './composition-DzAV0cfU.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-IDMQWS6O.js';
-import './chunk-7PQZDC2H.js';
-import './chunk-S4FR7ATF.js';
-import './chunk-TCBEF5OY.js';
-import './chunk-2M7U4WL3.js';
-import './chunk-XAYMPBNE.js';
-import './chunk-VFMHM2IL.js';
+export { OPFYamlError, YAML_SCHEMA_URL, fromYaml, parseYamlData, scanYamlComments, toYaml } from './chunk-D2XIDBUB.js';
+import './chunk-ARLOTG23.js';
+import './chunk-U55BQQKU.js';
+import './chunk-YZ7RZ4MU.js';
+import './chunk-XQARTOZJ.js';
+import './chunk-X6SB52RP.js';
+import './chunk-BWWGYOOG.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openpresentation/opf",
-  "version": "0.20.5",
+  "version": "0.21.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",

package/dist/conversion-DRCJIMWS.js

@@ -1,19 +0,0 @@
-export { convertFiles, deckFileFormat, exportFormatOf, openDeck, planConversion, readInput, saveDeck, writePlanned } from './chunk-WD4W7KKK.js';
-import './chunk-OIGCC6VA.js';
-import './chunk-52GKVP3I.js';
-import './chunk-UJSAR6GF.js';
-import './chunk-TZ5IZETE.js';
-import './chunk-5SQ6CIWR.js';
-import './chunk-Z75YB54S.js';
-import './chunk-IDMQWS6O.js';
-import './chunk-7PQZDC2H.js';
-import './chunk-URUNMZFO.js';
-import './chunk-YOLDSF7U.js';
-import './chunk-S4FR7ATF.js';
-import './chunk-DYGYMBBW.js';
-import './chunk-V66KJA3H.js';
-import './chunk-TCBEF5OY.js';
-import './chunk-2M7U4WL3.js';
-import './chunk-XAYMPBNE.js';
-import './chunk-VFMHM2IL.js';
-import './chunk-F7PLNWHQ.js';