@openpresentation/opf 0.10.1 → 0.11.1

package/dist/{catalogs-DoVmvDr7.d.ts → catalogs-DJ-B5ZyD.d.ts}

@@ -1,4 +1,4 @@
-import { a as SchemaName } from './schemas-BYe5y8-i.js';
+import { a as SchemaName } from './schemas-X_NniU4A.js';
 
 /**
  * Schema for audience records in the pptx.gallery library. Each record names an audience archetype (e.g. 'executives', 'engineering-team', 'investors') and carries seniority, technical-fluency, decision-power, and attention-budget hints used by AI-driven generation. Audiences are referenced from OPF documents via audience; the engine resolves the reference against catalogs.audiences (inline) → catalogs.audiences.source → the default catalog at https://www.pptx.gallery/audiences. The audience field also accepts free-form strings; this catalog is for engine-aware audience archetypes that carry generation hints.
@@ -453,7 +453,7 @@ interface Composition {
 }
 
 /**
- * Schema for chart-type records in the pptx.gallery catalog. 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.
+ * 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.
  */
 interface ChartType {
     /**
@@ -481,6 +481,7 @@ interface ChartType {
      */
     description?: string;
     mappings: ChartTypeMappings;
+    deprecation?: ChartTypeDeprecation;
     /**
      * Top-level grouping in the chart picker (column, bar, line, area, pie, radar, etc.).
      */
@@ -559,7 +560,7 @@ interface ChartType {
 interface ChartTypeMappings {
     openxml: OpenXmlChartMapping;
     /**
-     * Optional renderer-specific mappings. Keys are renderer ids; values are intentionally opaque to OPF.
+     * Optional renderer-specific mappings. Keys are renderer ids; values are intentionally opaque to OPF. The bundled catalog records the matching Aspose.Slides ChartType enumeration member under the "aspose-slides" key, e.g. {"aspose-slides": {"chartType": "StackedColumn"}}.
      */
     renderers?: {
         [k: string]: {
@@ -658,6 +659,23 @@ interface OpenXmlChartMapping1 {
      */
     notes?: string;
 }
+/**
+ * Present when this chart type is deprecated. Deprecated records stay resolvable so existing documents keep validating, but pickers and default listings exclude them, validators warn when a document references them, and they are removed in the release named by `removal`.
+ */
+interface ChartTypeDeprecation {
+    /**
+     * Id of the non-deprecated chart type that documents should reference instead.
+     */
+    replacedBy: string;
+    /**
+     * Why the record is deprecated.
+     */
+    reason?: string;
+    /**
+     * Package version in which the record is scheduled for removal from the bundled catalog.
+     */
+    removal?: string;
+}
 /**
  * One column of the embedded chart workbook, annotated with its role and grid position.
  *
@@ -913,19 +931,23 @@ interface Language {
      */
     bcp47: string;
     /**
-     * Base text direction for the language.
+     * Curated culture tag for OOXML text-run language attributes (a:rPr/@lang, a:endParaRPr/@lang), in the language-[Script-]REGION form Office recognizes (e.g. 'ja-JP', 'ar-SA', 'ms-MY', 'nb-NO', 'fil-PH', 'zh-CN'). Engines emit it instead of 'bcp47' when the document names the language by catalog id or by a tag without a region; a region-bearing tag written by the author is emitted as written. Curated rather than inferred so output does not depend on the runtime's locale data.
+     */
+    ooxmlLang?: string;
+    /**
+     * Base text direction for the language. When omitted, engines derive it from the script: Arabic (Arab), Hebrew (Hebr), Syriac (Syrc), Thaana (Thaa), N'Ko (Nkoo), Adlam (Adlm), Samaritan (Samr), Mandaic (Mand) and Hanifi Rohingya (Rohg) are right-to-left; every other script is left-to-right. Bundled language records state it explicitly.
      */
     direction?: ("ltr" | "rtl");
     /**
-     * ISO 15924 script code when the writing system should be explicit.
+     * ISO 15924 script code of the language's writing system. The script selects the OOXML font slot the language's text uses: East Asian scripts (Hans, Hant, Hani, Jpan, Kore, Hang, Hira, Kana, Bopo, Yiii) use the eastAsian slot; complex scripts (for example Arab, Hebr, Syrc, Thaa, Deva, Beng, Guru, Gujr, Orya, Taml, Telu, Knda, Mlym, Sinh, Thai, Laoo, Tibt, Mymr, Khmr, Mong) use the complexScript slot; every other script (Latn, Cyrl, Grek, Armn, Geor, Ethi, ...) uses the latin slot. When omitted, engines infer it from the BCP-47 tag. Bundled language records state it explicitly. See docs/programs/font-fidelity-everywhere/script-font-model.md.
      */
     script?: string;
     /**
-     * Default font-scheme id for this language when targeting PowerPoint output. Resolves against catalogs.fontSchemes the same way design.fontScheme or design.fontScheme.id does.
+     * Default font-scheme id for this language when targeting PowerPoint output. Resolves against catalogs.fontSchemes the same way design.fontScheme or design.fontScheme.id does. Its major/minor families fill the language's script slot (eastAsian or complexScript, chosen by 'script') unless the effective design font scheme sets that slot itself; the latin slot always follows the design font scheme.
      */
     fontScheme?: string;
     /**
-     * Default font-scheme id for this language when targeting Google Slides output. Resolves against catalogs.fontSchemes the same way design.fontScheme or design.fontScheme.id does.
+     * Default font-scheme id for this language when targeting Google Slides output. Resolves against catalogs.fontSchemes the same way design.fontScheme or design.fontScheme.id does. Used in place of 'fontScheme' when resolving script fonts for Google Slides output.
      */
     googleFontScheme?: string;
     /**
@@ -1084,6 +1106,54 @@ interface FontScheme {
      * Body (minor) font family — mirrors the OOXML minorFont entry.
      */
     minor: string;
+    /**
+     * Optional monospaced font for code blocks and inline code. It has the same shape as the OPF FontScheme 'code' role, so a record and an inline design.fontScheme override are interchangeable. OOXML has no code slot, so exporters write this family on code runs. When neither design.fontScheme nor the resolved record defines 'code', engines fall back to Roboto Mono.
+     */
+    code?: {
+        /**
+         * Monospaced font family name.
+         */
+        family: string;
+        /**
+         * Numeric font weight (e.g., 400 for regular, 700 for bold).
+         */
+        weight?: number;
+        /**
+         * Font style.
+         */
+        style?: ("normal" | "italic");
+        /**
+         * Letter spacing (tracking) in ems.
+         */
+        letterSpacing?: number;
+        [k: string]: unknown;
+    };
+    /**
+     * East Asian script fonts. Maps to the OOXML a:ea element of majorFont (major) and minorFont (minor), and to run-level a:ea. When set, they fill the eastAsian slot for every language; when omitted, the slot comes from this scheme's own major/minor when languageFamily is 'ea' and the scheme's languages list is empty or names the presentation language, then from the presentation language's font scheme for East Asian languages, and otherwise from the latin (major/minor) families. A missing 'major' or 'minor' falls back to the other.
+     */
+    eastAsian?: {
+        /**
+         * Heading (major) eastAsian font family — mirrors majorFont a:ea.
+         */
+        major?: string;
+        /**
+         * Body (minor) eastAsian font family — mirrors minorFont a:ea.
+         */
+        minor?: string;
+    };
+    /**
+     * Complex-script fonts (for example Arabic, Hebrew, Indic and Thai). Maps to the OOXML a:cs element of majorFont (major) and minorFont (minor), and to run-level a:cs. When set, they fill the complexScript slot for every language; when omitted, the slot comes from this scheme's own major/minor when languageFamily is 'cs' and the scheme's languages list is empty or names the presentation language, then from the presentation language's font scheme for complex-script languages, and otherwise from the latin (major/minor) families. A missing 'major' or 'minor' falls back to the other.
+     */
+    complexScript?: {
+        /**
+         * Heading (major) complexScript font family — mirrors majorFont a:cs.
+         */
+        major?: string;
+        /**
+         * Body (minor) complexScript font family — mirrors minorFont a:cs.
+         */
+        minor?: string;
+    };
     /**
      * High-level typographic class of the scheme.
      */
@@ -1093,7 +1163,7 @@ interface FontScheme {
      */
     app?: ("PowerPoint" | "Google Slides");
     /**
-     * OOXML font-language family this scheme is intended for: 'latin' for Latin-script content, 'ea' for East Asian scripts, 'cs' for Complex Scripts.
+     * OOXML font-language family this scheme is intended for: 'latin' for Latin-script content, 'ea' for East Asian scripts, 'cs' for Complex Scripts. As the design font scheme, an 'ea' or 'cs' scheme also fills that script slot with its own major/minor families when its languages list is empty or names the presentation language.
      */
     languageFamily?: ("latin" | "ea" | "cs");
     /**
@@ -1195,4 +1265,4 @@ interface CatalogEntry {
 }
 declare const catalogEntries: readonly CatalogEntry[];
 
-export { type Audience as A, type CatalogEntry as C, type FontScheme as F, type Language as L, type Narrative as N, type Purpose as P, type SocialPlatform as S, type Theme as T, type CatalogIndex as a, type CatalogIndexRecord as b, type CatalogKind as c, type CatalogRecord as d, type ChartType as e, type ColorScheme as f, type Layout as g, type Tone as h, audiences as i, catalogEntries as j, catalogIndexes as k, catalogKinds as l, catalogSchemaNames as m, catalogs as n, chartTypes as o, colorSchemes as p, fontSchemes as q, languages as r, layouts as s, narratives as t, purposes as u, socialPlatforms as v, themes as w, tones as x };
+export { type Audience as A, type CatalogKind as C, type FontScheme as F, type Language as L, type Narrative as N, type Purpose as P, type SocialPlatform as S, type Theme as T, type CatalogEntry as a, type CatalogIndex as b, type CatalogIndexRecord as c, type CatalogRecord as d, type ChartType as e, type ColorScheme as f, type Layout as g, type Tone as h, audiences as i, catalogEntries as j, catalogIndexes as k, catalogKinds as l, catalogSchemaNames as m, catalogs as n, chartTypes as o, colorSchemes as p, fontSchemes as q, languages as r, layouts as s, narratives as t, purposes as u, socialPlatforms as v, themes as w, tones as x };

package/dist/catalogs.d.ts

@@ -1,2 +1,2 @@
-export { C as CatalogEntry, a as CatalogIndex, b as CatalogIndexRecord, c as CatalogKind, d as CatalogRecord, i as audiences, j as catalogEntries, k as catalogIndexes, l as catalogKinds, m as catalogSchemaNames, n as catalogs, o as chartTypes, p as colorSchemes, q as fontSchemes, r as languages, s as layouts, t as narratives, u as purposes, v as socialPlatforms, w as themes, x as tones } from './catalogs-DoVmvDr7.js';
-import './schemas-BYe5y8-i.js';
+export { a as CatalogEntry, b as CatalogIndex, c as CatalogIndexRecord, C as CatalogKind, d as CatalogRecord, i as audiences, j as catalogEntries, k as catalogIndexes, l as catalogKinds, m as catalogSchemaNames, n as catalogs, o as chartTypes, p as colorSchemes, q as fontSchemes, r as languages, s as layouts, t as narratives, u as purposes, v as socialPlatforms, w as themes, x as tones } from './catalogs-DJ-B5ZyD.js';
+import './schemas-X_NniU4A.js';

package/dist/catalogs.js

@@ -1 +1 @@
-export { audiences, catalogEntries, catalogIndexes, catalogKinds, catalogSchemaNames, catalogs, chartTypes, colorSchemes, fontSchemes, languages, layouts, narratives, purposes, socialPlatforms, themes, tones } from './chunk-TU7I3KSB.js';
+export { audiences, catalogEntries, catalogIndexes, catalogKinds, catalogSchemaNames, catalogs, chartTypes, colorSchemes, fontSchemes, languages, layouts, narratives, purposes, socialPlatforms, themes, tones } from './chunk-7LF37SG3.js';