@openpresentation/opf 0.10.0 → 0.11.0

package/dist/examples.d.ts

@@ -1,4 +1,4 @@
-import { P as Presentation } from './presentation-BMTdX6O1.js';
+import { P as Presentation } from './presentation-Ct42Mitb.js';
 
 interface ExampleRecord {
     /** Filename slug, without the `.opf.json` suffix. */

package/dist/index.d.ts

@@ -1,10 +1,71 @@
-export { S as SchemaEntry, a as SchemaName, b as audience, c as chartType, d as colorScheme, f as fontScheme, l as language, e as layout, n as narrative, p as presentation, g as purpose, s as schemaEntries, h as schemaNames, i as schemas, j as socialPlatform, t as theme, k as tone } from './schemas-BYe5y8-i.js';
-export { A as Audience, C as CatalogEntry, a as CatalogIndex, b as CatalogIndexRecord, c as CatalogKind, d as CatalogRecord, e as ChartType, f as ColorScheme, F as FontScheme, L as Language, g as Layout, N as Narrative, P as Purpose, S as SocialPlatform, T as Theme, h as Tone, 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-HCTav5Wv.js';
+export { S as SchemaEntry, a as SchemaName, b as audience, c as chartType, d as colorScheme, f as fontScheme, l as language, e as layout, n as narrative, p as presentation, g as purpose, s as schemaEntries, h as schemaNames, i as schemas, j as socialPlatform, t as theme, k as tone } from './schemas-CiVmUT2p.js';
+import { C as CatalogKind } from './catalogs-atkOF4Vy.js';
+export { A as Audience, a as CatalogEntry, b as CatalogIndex, c as CatalogIndexRecord, d as CatalogRecord, e as ChartType, f as ColorScheme, F as FontScheme, L as Language, g as Layout, N as Narrative, P as Purpose, S as SocialPlatform, T as Theme, h as Tone, 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-atkOF4Vy.js';
 export { OPFValidationError, ValidationIssue, ValidationResult, assertValid, assertValidCatalogRecord, assertValidPresentation, validate, validateCatalogRecord, validatePresentation } from './validator.js';
 export { SpecFileEntry, SpecFileKind, SpecFilePath, specFileEntries, specFileKinds, specFilePaths } from './spec-files.js';
 export { LayoutPreviewIndex, LayoutPreviewRecord, getLayoutPreview, hasLayoutPreview, layoutPreviewIndex, layoutPreviewSlugs, layoutPreviews } from './previews.js';
-export { P as Presentation } from './presentation-BMTdX6O1.js';
+export { P as Presentation } from './presentation-Ct42Mitb.js';
 export { LintContract, LintDiagnostic, LintLocation, LintOptions, LintReport, LintSeverity, LintSuggestion, lintPresentation, lintSource } from './lint.js';
-export { CodeContent, CodeLayout, CodeLayoutDiagnostic, CodeLayoutOptions, CodeLineSegment, CodeLineSource, CodeTextFit, CodeTextPart, ComposeSlideOptions, ComposedFlow, ComposedGroup, ComposedItem, Composition, CompositionCandidate, CompositionDecision, CompositionExplanation, CompositionPenalties, CompositionTrack, FontFamilies, LayoutBox, LayoutDiagnostic, ListEntryLayout, ListFit, ListText, ListValue, MAX_COMPOSITION_DEPTH, MeasureTextWidth, MetricContent, MetricLayout, MetricLayoutDiagnostic, MetricLayoutOptions, MetricTextPart, MetricTextSource, OPFCompositionError, QuoteContent, QuoteLayout, QuoteLayoutDiagnostic, QuoteLayoutOptions, QuoteTextPart, QuoteTextSource, RichTextFit, RichTextFragment, RichTextLine, RichTextOptions, RichTextRun, SlideComposition, TextFit, TextLineInk, TextMeasurement, TextPlacement, TextPlacementLine, TextStyle, TimelineContent, TimelineEvent, TimelineLayout, TimelineLayoutDiagnostic, TimelineLayoutOptions, TimelineTextPart, chartColorForFill, colorContrast, composeSlide, fitList, fitRichText, fitText, layoutCode, layoutMetric, layoutQuote, layoutTimeline, measureText, measureTextOutline, placeTextLines, resolveCanvasDimensions, resolveFontFamilies, resolveTextStyle, textColorForFill, textWidthMeasurer, wrapText } from './composition.js';
+export { C as CodeContent, a as CodeLayout, b as CodeLayoutDiagnostic, c as CodeLayoutOptions, d as CodeLineSegment, e as CodeLineSource, f as CodeTextFit, g as CodeTextPart, h as ComposeSlideOptions, i as ComposedFlow, j as ComposedGroup, k as ComposedItem, l as Composition, m as CompositionCandidate, n as CompositionDecision, o as CompositionExplanation, p as CompositionPenalties, q as CompositionTrack, F as FontFamilies, r as FurnitureImagePart, s as FurnitureLayout, t as FurniturePart, u as FurniturePartBase, v as FurnitureTextPart, L as LayoutBox, w as LayoutDiagnostic, x as ListEntryLayout, y as ListFit, z as ListText, A as ListValue, M as MAX_COMPOSITION_DEPTH, B as MeasureTextWidth, D as MetricContent, E as MetricLayout, G as MetricLayoutDiagnostic, H as MetricLayoutOptions, I as MetricTextPart, J as MetricTextSource, O as OPFCompositionError, Q as QuoteContent, K as QuoteLayout, N as QuoteLayoutDiagnostic, P as QuoteLayoutOptions, R as QuoteTextPart, S as QuoteTextSource, T as ResolveColorRefOptions, U as ResolveColorRefRoles, V as RichTextFit, W as RichTextFragment, X as RichTextLine, Y as RichTextOptions, Z as RichTextRun, _ as SlideComposition, $ as TextFit, a0 as TextLineInk, a1 as TextMeasurement, a2 as TextPlacement, a3 as TextPlacementLine, a4 as TextStyle, a5 as TimelineContent, a6 as TimelineEvent, a7 as TimelineLayout, a8 as TimelineLayoutDiagnostic, a9 as TimelineLayoutOptions, aa as TimelineTextPart, ab as chartColorForFill, ac as colorContrast, ad as composeSlide, ae as fitList, af as fitRichText, ag as fitText, ah as layoutCode, ai as layoutFurniture, aj as layoutMetric, ak as layoutQuote, al as layoutTimeline, am as measureText, an as measureTextOutline, ao as normalizeHexColor, ap as placeTextLines, aq as resolveCanvasDimensions, ar as resolveColorRef, as as resolveFontFamilies, at as resolveTextStyle, au as textColorForFill, av as textWidthMeasurer, aw as wrapText } from './composition-Tv9Wm3Oh.js';
 export { OPFPaginationError, PaginatedPage, PaginationMapping, PaginationOptions, PaginationResult, PresentationPaginationOptions, PresentationPaginationResult, paginatePresentation, paginateSlide } from './pagination.js';
 export { DataCell, DataContentOptions, DataImportOptions, OPFDataImportError, TabularData, createDataContent, parseTabularData } from './data.js';
+
+/**
+ * Local catalog vendoring: resolve every catalog reference a presentation
+ * uses and inline the resolved records into `catalogs.<kind>.records`, so the
+ * document renders identically with no catalog lookups beyond itself.
+ *
+ * Resolution is local-only: inline records are kept as-is, ids that belong to
+ * a kind's custom `source` are left to that source, and everything else
+ * resolves against the bundled default catalogs. Every reference a record
+ * carries is chased in turn — whether the record came from the bundled
+ * catalogs or was already inline — so no inlined record dangles. Running the
+ * bundle twice is a no-op.
+ */
+interface BundleReport {
+    /** Record ids inlined by this run, per kind, in output order. */
+    added: Partial<Record<CatalogKind, string[]>>;
+    /** Referenced ids that were already inline in the document, per kind. */
+    alreadyInline: Partial<Record<CatalogKind, string[]>>;
+    /** Kinds left untouched because the document declares a custom source. */
+    keptSources: CatalogKind[];
+    /**
+     * Referenced bare ids that resolve nowhere locally, per kind — listed for
+     * exactly the positions the validator warns about, so `unresolved` means
+     * "the validator would warn about this": the string shorthand of
+     * `narrative`, the design references `themes`, `colorSchemes` and
+     * `fontSchemes` (string or `{ id }` form, at deck and slide level), and
+     * `chart.type`.
+     *
+     * Every other reference — tones, purposes, audiences, languages, layouts,
+     * social platforms, object-form narratives, and anything reached through a
+     * record rather than written by the author — is still resolved and inlined
+     * when it is found, and skipped in silence when it is not, because the
+     * validator does not warn there either.
+     *
+     * Informational: unknown ids are warnings, never errors.
+     */
+    unresolved: Partial<Record<CatalogKind, string[]>>;
+}
+interface BundleResult {
+    presentation: unknown;
+    report: BundleReport;
+}
+/**
+ * Resolve every catalog reference `value` uses and inline the resolved
+ * records, returning a new document plus a report of what changed. The input
+ * document is not modified.
+ *
+ * Anything that is not an object, and any document whose `catalogs` is
+ * present but not an object, is returned unchanged with an all-empty report:
+ * bundling there would have to overwrite that field, and schema-invalid input
+ * deserves a defined no-op over silent data loss. The CLI validates before
+ * bundling, so only a direct library call can reach that case.
+ *
+ * Ids that resolve nowhere are reported as unresolved for the positions the
+ * validator warns about, and silently skipped elsewhere; see
+ * `BundleReport.unresolved`.
+ */
+declare function bundlePresentation(value: unknown): BundleResult;
+
+export { type BundleReport, type BundleResult, CatalogKind, bundlePresentation };

package/dist/index.js

@@ -1,9 +1,207 @@
-export { specFileEntries, specFileKinds, specFilePaths } from './chunk-OZULJBSG.js';
+export { specFileEntries, specFileKinds, specFilePaths } from './chunk-RS5GZ5RW.js';
 export { getLayoutPreview, hasLayoutPreview, layoutPreviewIndex, layoutPreviewSlugs, layoutPreviews } from './chunk-PIQXLBBJ.js';
-export { lintPresentation, lintSource } from './chunk-NPOKUFEX.js';
+export { lintPresentation, lintSource } from './chunk-EQHZ3ZO4.js';
 export { OPFDataImportError, createDataContent, parseTabularData } from './chunk-SOSOBKQ2.js';
-export { OPFPaginationError, paginatePresentation, paginateSlide } from './chunk-TK3QHM3U.js';
-export { OPFValidationError, assertValid, assertValidCatalogRecord, assertValidPresentation, validate, validateCatalogRecord, validatePresentation } from './chunk-GCB6LGJM.js';
-export { MAX_COMPOSITION_DEPTH, OPFCompositionError, chartColorForFill, colorContrast, composeSlide, fitList, fitRichText, fitText, layoutCode, layoutMetric, layoutQuote, layoutTimeline, measureText, measureTextOutline, placeTextLines, resolveCanvasDimensions, resolveFontFamilies, resolveTextStyle, textColorForFill, textWidthMeasurer, wrapText } from './chunk-BAWLYSUN.js';
-export { audience, chartType, colorScheme, fontScheme, language, layout, narrative, presentation, purpose, schemaEntries, schemaNames, schemas, socialPlatform, theme, tone } from './chunk-GQSK3T7X.js';
-export { audiences, catalogEntries, catalogIndexes, catalogKinds, catalogSchemaNames, catalogs, chartTypes, colorSchemes, fontSchemes, languages, layouts, narratives, purposes, socialPlatforms, themes, tones } from './chunk-TWMRZ43O.js';
+export { OPFPaginationError, paginatePresentation, paginateSlide } from './chunk-FWA5XB45.js';
+import { isRecord, visitContentPayloads, bareIdPattern } from './chunk-CHKJ4QHQ.js';
+export { OPFValidationError, assertValid, assertValidCatalogRecord, assertValidPresentation, validate, validateCatalogRecord, validatePresentation } from './chunk-CHKJ4QHQ.js';
+export { MAX_COMPOSITION_DEPTH, OPFCompositionError, chartColorForFill, colorContrast, composeSlide, fitList, fitRichText, fitText, layoutCode, layoutFurniture, layoutMetric, layoutQuote, layoutTimeline, measureText, measureTextOutline, normalizeHexColor, placeTextLines, resolveCanvasDimensions, resolveColorRef, resolveFontFamilies, resolveTextStyle, textColorForFill, textWidthMeasurer, wrapText } from './chunk-FTWNWFIV.js';
+export { audience, chartType, colorScheme, fontScheme, language, layout, narrative, presentation, purpose, schemaEntries, schemaNames, schemas, socialPlatform, theme, tone } from './chunk-GN52EE3P.js';
+import { catalogEntries } from './chunk-6FU2KICU.js';
+export { audiences, catalogEntries, catalogIndexes, catalogKinds, catalogSchemaNames, catalogs, chartTypes, colorSchemes, fontSchemes, languages, layouts, narratives, purposes, socialPlatforms, themes, tones } from './chunk-6FU2KICU.js';
+
+// src/bundle.ts
+function reportKey(kind, id) {
+  return `${kind}:${id}`;
+}
+function referenceId(value) {
+  if (typeof value === "string" && bareIdPattern.test(value)) return value;
+  if (isRecord(value) && typeof value.id === "string" && bareIdPattern.test(value.id)) return value.id;
+  return void 0;
+}
+function addReference(collector, kind, value, reportable) {
+  const id = referenceId(value);
+  if (!id) return;
+  if (reportable) collector.reportable.add(reportKey(kind, id));
+  let ids = collector.referenced.get(kind);
+  if (!ids) {
+    ids = /* @__PURE__ */ new Set();
+    collector.referenced.set(kind, ids);
+  }
+  if (ids.has(id)) return;
+  ids.add(id);
+  collector.queue.push({ kind, id });
+}
+function collectDesignReferences(collector, design) {
+  if (!isRecord(design)) return;
+  addReference(collector, "themes", design.theme, true);
+  addReference(collector, "colorSchemes", design.colorScheme, true);
+  addReference(collector, "fontSchemes", design.fontScheme, true);
+  if (isRecord(design.theme)) {
+    addReference(collector, "colorSchemes", design.theme.colorScheme, true);
+    addReference(collector, "fontSchemes", design.theme.fontScheme, true);
+  }
+}
+function collectChartReference(collector, payload) {
+  if (!isRecord(payload.chart)) return;
+  addReference(collector, "chartTypes", payload.chart.type, typeof payload.chart.type === "string");
+}
+function collectSocialReferences(collector, holder) {
+  const entries = Array.isArray(holder) ? holder : [holder];
+  for (const entry of entries) {
+    if (!isRecord(entry) || !isRecord(entry.socials)) continue;
+    for (const key of Object.keys(entry.socials)) addReference(collector, "socialPlatforms", key, false);
+  }
+}
+function collectBeatReferences(collector, narrative2) {
+  if (!isRecord(narrative2) || !Array.isArray(narrative2.beats)) return;
+  for (const beat of narrative2.beats) {
+    if (isRecord(beat)) addReference(collector, "layouts", beat.layoutHint, false);
+  }
+}
+function collectLanguageReferences(collector, language2) {
+  addReference(collector, "languages", language2, false);
+  if (!isRecord(language2)) return;
+  addReference(collector, "fontSchemes", language2.fontScheme, false);
+  addReference(collector, "fontSchemes", language2.googleFontScheme, false);
+}
+function collectDocumentReferences(collector, document) {
+  addReference(collector, "narratives", document.narrative, typeof document.narrative === "string");
+  collectBeatReferences(collector, document.narrative);
+  addReference(collector, "tones", document.tone, false);
+  addReference(collector, "purposes", document.purpose, false);
+  collectLanguageReferences(collector, document.language);
+  const audiences2 = Array.isArray(document.audience) ? document.audience : [document.audience];
+  for (const entry of audiences2) addReference(collector, "audiences", entry, false);
+  collectDesignReferences(collector, document.design);
+  collectSocialReferences(collector, document.organization);
+  collectSocialReferences(collector, document.speaker);
+  if (!Array.isArray(document.slides)) return;
+  for (const slide of document.slides) {
+    if (!isRecord(slide)) continue;
+    addReference(collector, "layouts", slide.layout, false);
+    collectDesignReferences(collector, slide.design);
+    collectChartReference(collector, slide);
+    visitContentPayloads(slide, "", (payload) => {
+      collectChartReference(collector, payload);
+    });
+  }
+}
+function collectRecordReferences(collector, kind, record) {
+  if (kind === "themes") {
+    addReference(collector, "colorSchemes", record.colorScheme, false);
+    addReference(collector, "fontSchemes", record.fontScheme, false);
+  } else if (kind === "narratives") {
+    collectBeatReferences(collector, record);
+  } else if (kind === "languages") {
+    addReference(collector, "fontSchemes", record.fontScheme, false);
+    addReference(collector, "fontSchemes", record.googleFontScheme, false);
+  }
+}
+var bundledIndex;
+function bundledCatalogIndex() {
+  if (bundledIndex) return bundledIndex;
+  const index = /* @__PURE__ */ new Map();
+  for (const entry of catalogEntries) {
+    const records = /* @__PURE__ */ new Map();
+    for (const record of entry.records) {
+      if (isRecord(record) && typeof record.id === "string") records.set(record.id, record);
+    }
+    index.set(entry.kind, records);
+  }
+  bundledIndex = index;
+  return index;
+}
+function bundledRecord(kind, id) {
+  const record = bundledCatalogIndex().get(kind)?.get(id);
+  if (!record) return void 0;
+  const clone = structuredClone(record);
+  delete clone.$schema;
+  return clone;
+}
+function readKindState(catalogsField, kind) {
+  const entry = catalogsField[kind];
+  const inline = /* @__PURE__ */ new Map();
+  if (!isRecord(entry)) return { customSource: false, inline };
+  if (Array.isArray(entry.records)) {
+    for (const record of entry.records) {
+      if (isRecord(record) && typeof record.id === "string") inline.set(record.id, record);
+    }
+  }
+  const customSource = typeof entry.source === "string" || Array.isArray(entry.source) && entry.source.length > 0;
+  return { customSource, inline };
+}
+function kindState(states, catalogsField, kind) {
+  const cached = states.get(kind);
+  if (cached) return cached;
+  const state = readKindState(catalogsField, kind);
+  states.set(kind, state);
+  return state;
+}
+function pushReportId(map, kind, id) {
+  const list = map[kind];
+  if (list) list.push(id);
+  else map[kind] = [id];
+}
+function bundlePresentation(value) {
+  const report = { added: {}, alreadyInline: {}, keptSources: [], unresolved: {} };
+  if (!isRecord(value)) {
+    return { presentation: value, report };
+  }
+  const presentation2 = structuredClone(value);
+  if (presentation2.catalogs !== void 0 && !isRecord(presentation2.catalogs)) {
+    return { presentation: presentation2, report };
+  }
+  const catalogsField = isRecord(presentation2.catalogs) ? presentation2.catalogs : {};
+  const collector = { queue: [], referenced: /* @__PURE__ */ new Map(), reportable: /* @__PURE__ */ new Set() };
+  collectDocumentReferences(collector, presentation2);
+  const states = /* @__PURE__ */ new Map();
+  const resolved = /* @__PURE__ */ new Map();
+  for (let index = 0; index < collector.queue.length; index += 1) {
+    const pending = collector.queue[index];
+    if (!pending) continue;
+    const { kind, id } = pending;
+    const state = kindState(states, catalogsField, kind);
+    const inlineRecord = state.inline.get(id);
+    if (inlineRecord) {
+      collectRecordReferences(collector, kind, inlineRecord);
+      continue;
+    }
+    if (state.customSource) continue;
+    const record = bundledRecord(kind, id);
+    if (!record) continue;
+    let kindRecords = resolved.get(kind);
+    if (!kindRecords) {
+      kindRecords = /* @__PURE__ */ new Map();
+      resolved.set(kind, kindRecords);
+    }
+    kindRecords.set(id, record);
+    collectRecordReferences(collector, kind, record);
+  }
+  for (const [kind, ids] of collector.referenced) {
+    const state = kindState(states, catalogsField, kind);
+    if (state.customSource) report.keptSources.push(kind);
+    const kindResolved = resolved.get(kind);
+    const addedIds = [];
+    for (const id of [...ids].sort()) {
+      if (state.inline.has(id)) pushReportId(report.alreadyInline, kind, id);
+      else if (kindResolved?.has(id)) addedIds.push(id);
+      else if (!state.customSource && collector.reportable.has(reportKey(kind, id))) {
+        pushReportId(report.unresolved, kind, id);
+      }
+    }
+    if (!addedIds.length) continue;
+    if (!isRecord(presentation2.catalogs)) presentation2.catalogs = {};
+    const catalogs2 = presentation2.catalogs;
+    if (!isRecord(catalogs2[kind])) catalogs2[kind] = {};
+    const entry = catalogs2[kind];
+    if (!Array.isArray(entry.records)) entry.records = [];
+    const records = entry.records;
+    for (const id of addedIds) records.push(kindResolved?.get(id));
+    report.added[kind] = addedIds;
+  }
+  report.keptSources.sort();
+  return { presentation: presentation2, report };
+}
+
+export { bundlePresentation };

package/dist/lint.d.ts

@@ -1,7 +1,7 @@
-import { c as CatalogKind } from './catalogs-HCTav5Wv.js';
+import { C as CatalogKind } from './catalogs-atkOF4Vy.js';
 import { ValidationIssue } from './validator.js';
-import { J as JsonPrimitive } from './schemas-BYe5y8-i.js';
-import './presentation-BMTdX6O1.js';
+import { J as JsonPrimitive } from './schemas-CiVmUT2p.js';
+import './presentation-Ct42Mitb.js';
 
 type LintSeverity = 'error' | 'warning' | 'info';
 interface LintLocation {

package/dist/lint.js

@@ -1,5 +1,5 @@
-export { lintPresentation, lintSource } from './chunk-NPOKUFEX.js';
-import './chunk-GCB6LGJM.js';
-import './chunk-BAWLYSUN.js';
-import './chunk-GQSK3T7X.js';
-import './chunk-TWMRZ43O.js';
+export { lintPresentation, lintSource } from './chunk-EQHZ3ZO4.js';
+import './chunk-CHKJ4QHQ.js';
+import './chunk-FTWNWFIV.js';
+import './chunk-GN52EE3P.js';
+import './chunk-6FU2KICU.js';

package/dist/pagination.d.ts

@@ -1,11 +1,11 @@
-import { LayoutDiagnostic, ComposeSlideOptions, TextMeasurement } from './composition.js';
+import { w as LayoutDiagnostic, h as ComposeSlideOptions, a1 as TextMeasurement } from './composition-Tv9Wm3Oh.js';
 
 interface PaginationOptions extends ComposeSlideOptions {
     /** Readability floor used while choosing page breaks. Default 24 reference pixels. */
     minFontSize?: number;
     /** All-or-nothing resource limit. Defaults to 100 output slides. */
     maxSlides?: number;
-    /** Existing deck IDs to avoid when generating continuation IDs. */
+    /** Existing slide and content payload IDs to avoid when generating continuation IDs. */
     reservedIds?: string[];
 }
 interface PaginationMapping {
@@ -21,6 +21,8 @@ interface PaginationMapping {
 interface PaginatedPage {
     slideIndex: number;
     mappings: PaginationMapping[];
+    /** Repeated headings/furniture and their metadata sources; separate from body slices. */
+    repeatedMappings?: PaginationMapping[];
 }
 interface PaginationResult {
     slides: Record<string, any>[];

package/dist/pagination.js

@@ -1,5 +1,5 @@
-export { OPFPaginationError, paginatePresentation, paginateSlide } from './chunk-TK3QHM3U.js';
-import './chunk-GCB6LGJM.js';
-import './chunk-BAWLYSUN.js';
-import './chunk-GQSK3T7X.js';
-import './chunk-TWMRZ43O.js';
+export { OPFPaginationError, paginatePresentation, paginateSlide } from './chunk-FWA5XB45.js';
+import './chunk-CHKJ4QHQ.js';
+import './chunk-FTWNWFIV.js';
+import './chunk-GN52EE3P.js';
+import './chunk-6FU2KICU.js';

package/dist/{presentation-BMTdX6O1.d.ts → presentation-Ct42Mitb.d.ts}

@@ -273,6 +273,26 @@ type Asset = (string | {
      */
     format?: string;
 });
+/**
+ * A single named variable. A hex string is shorthand for { "type": "color", "value": value }.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "Variable".
+ */
+type Variable = (HexColor | {
+    /**
+     * Variable kind. Only 'color' is defined today; other kinds may be added when content surfaces exist to consume them.
+     */
+    type: "color";
+    /**
+     * Hex color shorthand accepted by selected string fields.
+     */
+    value: string;
+    /**
+     * Optional prose describing what the variable is for, surfaced by pickers and agents.
+     */
+    description?: string;
+});
 /**
  * A contiguous run of text. Strings cover unformatted spans; object form adds character formatting.
  *
@@ -301,7 +321,7 @@ type TextRun = (string | {
      */
     strikethrough?: boolean;
     /**
-     * Run text color as a hex string.
+     * Run text color. Documented forms: a hex string ('#RGB', '#RRGGBB', '#RRGGBBAA'), a color-scheme slot or role name resolved through the effective color scheme ('accent2', 'text'), or a 'var:<id>' reference into the top-level variables map. Prefer names over hex so runs survive re-theming. Any other string stays schema-valid so imported decks keep validating: validators warn and renderers fall back to the theme text color.
      */
     color?: string;
     /**
@@ -390,6 +410,16 @@ type TableCellValue = (string | number | boolean | null | TextRun[]);
  * via the `definition` "ContentPayload".
  */
 type ContentPayload = {
+    /**
+     * Optional stable identifier for this payload, unique among slide and payload ids in the document. Use when another system needs to address the payload across edits — patch-style agent edits, comments, review state, or generation provenance. Identity survives reordering where array indexes do not.
+     */
+    id?: string;
+    /**
+     * Custom data passthrough for agent workflows at payload scope; ignored by the engine but preserved across read/write round-trips.
+     */
+    extensions?: {
+        [k: string]: unknown;
+    };
     /**
      * Optional content kind. When omitted, engines infer the kind from the fields present.
      */
@@ -520,7 +550,7 @@ type CatalogSource = string;
  *
  * Fields that reference catalog records (narrative, language, tone, audience, purpose, design.theme / design.theme.id, design.colorScheme / design.colorScheme.id, design.fontScheme / design.fontScheme.id, Slide.layout, Chart.type, Organization.socials / Speaker.socials) resolve through the catalog system: inline 'catalogs.<kind>.records[]' on the document → 'catalogs.<kind>.source' on the document → engine defaults → the default catalog at https://www.pptx.gallery/<kind>. Every reference resolves to the catalog record's 'id' field. When an OPF document omits a reference entirely, the engine falls back to engine defaults (see /spec/reference/engine-defaults.json for a reference example). The defaults file is engine configuration; it is not part of the OPF document contract and has no JSON Schema.
  *
- * Most catalog references accept the bare 'id' as a string for the common case (e.g. narrative = 'classic-story', design.colorScheme = 'cool-horizon'). Audience, purpose, tone, design, and language object forms use 'id' as a base catalog reference plus inline overrides. Asset references use 'asset:<id>' strings that point into the top-level assets registry.
+ * Most catalog references accept the bare 'id' as a string for the common case (e.g. narrative = 'classic-story', design.colorScheme = 'cool-horizon'). Audience, purpose, tone, design, and language object forms use 'id' as a base catalog reference plus inline overrides. Asset references use 'asset:<id>' strings that point into the top-level assets registry, and content color fields (rich-text runs, styled table cells) accept hex values, color-scheme slot/role names, or 'var:<id>' references into the top-level variables map.
  */
 interface Presentation {
     /**
@@ -596,6 +626,7 @@ interface Presentation {
      */
     tags?: string[];
     design?: Design;
+    variables?: Variables;
     /**
      * Structured storyline describing the deck's arc and beats. Resolves to the 'id' of a 'narratives' catalog record.
      *
@@ -1870,6 +1901,12 @@ interface HeaderFooterItem2 {
     section?: boolean;
     [k: string]: unknown;
 }
+/**
+ * Optional named color variables for values the deck uses in more than one place or wants to name for intent (e.g. a risk red, a brand highlight). Content color fields reference entries as 'var:<id>' strings. Variables complement the color scheme: scheme slots and roles stay the primary vocabulary; variables cover deck-specific named colors that have no scheme slot.
+ */
+interface Variables {
+    [k: string]: Variable;
+}
 /**
  * Structured storyline used by AI to shape generated content. Mirrors the OPF Narrative Template record at https://openpresentation.org/schema/opf-narrative/v1 (sans '$schema'), so a library record and an inline narrative are interchangeable.
  *
@@ -2188,6 +2225,12 @@ interface Slide {
      */
     hidden?: boolean;
     composition?: Composition1;
+    /**
+     * Custom data passthrough for agent workflows at slide scope; ignored by the engine but preserved across read/write round-trips. Use for review state, generation provenance, or authoring conventions such as { "authoring": { "locked": true } }.
+     */
+    extensions?: {
+        [k: string]: unknown;
+    };
 }
 /**
  * Full-slide chart payload. Presence of this field infers type 'chart'.
@@ -2288,13 +2331,13 @@ interface StyledTableCell {
  */
 interface TableCellStyle {
     /**
-     * Explicit RGB or RGBA color. Eight-digit colors include alpha; #00000000 is transparent.
+     * Cell background: a hex color, a color-scheme slot or role name, or a 'var:<id>' variable reference. Eight-digit hex colors include alpha; #00000000 is transparent.
      */
-    fill?: string;
+    fill?: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "text" | "textSecondary") | string);
     /**
-     * Default text color, overridden by individual rich run colors.
+     * Default text color, overridden by individual rich run colors. Accepts a hex color, a color-scheme slot or role name, or a 'var:<id>' variable reference.
      */
-    color?: string;
+    color?: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "text" | "textSecondary") | string);
     /**
      * Horizontal text alignment inside the cell.
      */
@@ -2334,9 +2377,9 @@ interface TableCellPadding {
  */
 interface TableCellBorder {
     /**
-     * Explicit RGB or RGBA color. Eight-digit colors include alpha; #00000000 is transparent.
+     * Border color: a hex color, a color-scheme slot or role name, or a 'var:<id>' variable reference. Eight-digit hex colors include alpha; #00000000 is transparent.
      */
-    color: string;
+    color: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "text" | "textSecondary") | string);
     /**
      * Border width in reference pixels; 0 removes this edge.
      */

package/dist/repo-readme.js

@@ -1,5 +1,5 @@
 // src/generated/repo-readme.ts
-var repoReadmeRaw = '# Open Presentation Format (OPF)\n\n[![npm version](https://img.shields.io/npm/v/@openpresentation/opf?label=npm)](https://www.npmjs.com/package/@openpresentation/opf)\n[![npm downloads](https://img.shields.io/npm/dw/@openpresentation/opf)](https://www.npmjs.com/package/@openpresentation/opf)\n[![license](https://img.shields.io/npm/l/@openpresentation/opf)](./LICENSE)\n\nPublic npm package: [`@openpresentation/opf`](https://www.npmjs.com/package/@openpresentation/opf) (`npm install @openpresentation/opf`).\n\nOpen Presentation Format is the portable, human-readable JSON document format for slide decks.\n\nThis repository is the canonical home for the OPF **spec**, **JSON Schemas**, **catalog presets**, examples, generated developer types, local validation tooling, and planning docs for the future render/edit/convert toolkit. OpenPresentation publishes open-source code and documentation only; it does not provide hosted APIs, hosted rendering functions, queues, storage, authentication, jobs, previews, SLAs, telemetry, or managed infrastructure.\n\nFor AI agents, use the [OPF skill set](docs/agent-skills.md) for authoring, layout, presets, editing, export, and schema inspection.\n\nCLI 0.5.0 installs all six skills into your project with `npx @openpresentation/cli@latest skills install`. It uses local copies, preserves existing instructions and refuses to overwrite customized skills. See the [installation and update guide](docs/agent-skills.md) for personal or agent-specific targets and pre-release testing.\n\nFor LLM authoring, start with [the authoring guide](docs/llm-authoring.md), [dynamic composition](docs/dynamic-composition.md), and [local ecosystem verification](docs/ecosystem-development.md).\n\n## File naming\n\nOpen Presentation Format documents are JSON files. Use `*.opf.json` for complete OPF presentation documents, for example `board-review.opf.json` or `deck.opf.json`.\n\nAvoid using bare `*.opf` for OPF JSON. The `.opf` extension is already used by other document and project formats, while `.opf.json` keeps the OPF identity and still makes the underlying JSON format clear to editors, validators, agents, and version-control tooling.\n\n## Naming and reuse\n\nThe format name is **Open Presentation Format**. The schemas, catalogs, packages, and local tooling in this repository are free and open source under the MIT license, so third-party tools may read, write, validate, render, convert, and describe support for Open Presentation Format without adopting any product-specific branding.\n\n## Why OPF\n\n`.pptx` is a zipped bundle of XML. Humans can\'t diff it, LLMs can\'t read or write it reliably, and git can\'t track it meaningfully. Every change looks like a binary blob.\n\nOPF is plain JSON. A human can open it in an editor. A model can read and write it without guessing at schema-by-example. Decks live in git like the rest of your work.\n\nThat\'s the shift that lets LLMs actually *author* decks. When the format stops fighting them, models can do the work that matters \u2014 narrative structure, persuasive framing, data analysis, chart recommendations, ruthless revision passes \u2014 instead of wrestling with `<p:sp>` tags.\n\nAnd they don\'t start from a blank canvas. [pptx.gallery](https://pptx.gallery) is the human-browsable reference for OPF catalog presets: layouts, themes, color schemes, font schemes, chart types, narratives, audiences, purposes, tones, languages, and social platforms.\n\n## Start in three steps\n\n1. **Install the format package.** `npm install @openpresentation/opf`.\n2. **Author and validate a deck.** Write a `*.opf.json` file \u2014 start from [`docs/how-opf-works.md`](./docs/how-opf-works.md) or copy [`examples/technical/full-feature-tour.opf.json`](./examples/technical/full-feature-tour.opf.json) \u2014 and run `validatePresentation` on it.\n3. **Build on it.** Browse presets at [pptx.gallery](https://pptx.gallery), pin the schemas in your pipeline, and track the [toolkit libraries](#toolkit-libraries) for the render and convert libraries.\n\nYour deck lives in git from the first commit. Nothing in these steps calls a hosted service, and nothing ever will \u2014 that boundary is the point.\n\n## JavaScript and TypeScript\n\nThe canonical JavaScript/TypeScript package is published at [`packages/javascript`](./packages/javascript) as [`@openpresentation/opf`](https://www.npmjs.com/package/@openpresentation/opf). The schema is pre-stable (0.x \u2014 expect breaking changes between minor versions until 1.0). Its responsibility is local and format-level only:\n\n- export the canonical schemas from [`spec/`](./spec)\n- export bundled catalog records from [`spec/`](./spec)\n- export a typed raw spec file manifest for package-addressable `spec/` content\n- generate TypeScript types, with `Presentation` as the top-level type\n- validate OPF JSON and catalog records locally\n\nIt does not render `.pptx`, parse `.pptx`, generate content with AI, fetch remote catalogs, call hosted APIs, or provide managed services. Render/edit/convert packages live in separate MIT repos that depend on `@openpresentation/opf`. The format package also exposes pure composition geometry so those packages share layout behavior.\n\n## Toolkit libraries\n\nThe local toolkit lives in sibling repositories. See [ecosystem development](docs/ecosystem-development.md) for coordinated builds and verification, and [dynamic composition](docs/dynamic-composition.md) for portable layout rules.\n\n| Repo | Role | Boundary |\n|---|---|---|\n| `opf-render` | OPF to SVG/PNG/PDF | Local and embeddable rendering library |\n| `opf-editor` | WYSIWYG bindings/components | Headless editor primitives plus optional UI components |\n| `opf-pptx` | OPF to PPTX and PPTX to OPF | Pure local import/export library for browser and server use where supported |\n\nThese repos provide OSS primitives only. Downstream applications own hosting, auth, storage, collaboration, queues, previews, analytics, support, and workflow UX.\n\n## Usage\n\nInstall from npm:\n\n```sh\npnpm add @openpresentation/opf\n# or: npm install @openpresentation/opf\n```\n\nTo work on the package itself, clone this repo and build the workspace:\n\n```sh\npnpm install\npnpm build\n```\n\nUse the format package from JavaScript or TypeScript:\n\n```ts\nimport {\n  presentation,\n  audiences,\n  purposes,\n  tones,\n  validatePresentation,\n} from "@openpresentation/opf";\n\nimport type { Presentation } from "@openpresentation/opf";\n\nconst deck: Presentation = {\n  name: "Quarterly Review",\n  slides: [{ title: "Quarterly Review", items: ["Revenue", "Product", "Hiring"] }],\n};\n\nconst result = validatePresentation(deck);\nconsole.log(result.valid); // schema correctness\nconsole.log(result.warnings); // advisory issues, e.g. unknown catalog ids\nconsole.log(audiences.length, purposes.length, tones.length);\n```\n\nUse focused imports when you only need one surface:\n\n```ts\nimport { presentation } from "@openpresentation/opf/schemas";\nimport { audiences, purposes } from "@openpresentation/opf/catalogs";\nimport { specFileEntries } from "@openpresentation/opf/spec-files";\nimport { validate } from "@openpresentation/opf/validator";\nimport type { Presentation } from "@openpresentation/opf/types";\n```\n\nUse raw JSON when an engine or resolver needs package-addressable files:\n\n```ts\nimport presentationSchema from "@openpresentation/opf/spec/schemas/opf.schema.json" with {\n  type: "json",\n};\n```\n\nUse the [installable OPF CLI](./packages/cli/README.md) to create, validate, and edit files locally:\n\n```sh\npnpm --filter @openpresentation/cli build\nnode packages/cli/dist/index.js create deck.opf.json --title "Decision brief"\nnode packages/cli/dist/index.js validate deck.opf.json\nnode packages/cli/dist/index.js edit deck.opf.json --patch changes.json --in-place\n```\n\nSee [CSV and JSON data import](./docs/data-import.md) for editable tables and charts in the editor, CLI, and package API.\n\n## Layout\n\n| Path | Contents |\n|---|---|\n| [`spec/schemas/opf.schema.json`](./spec/schemas/opf.schema.json) | Canonical JSON Schema for top-level OPF `Presentation` documents. |\n| [`docs/how-opf-works.md`](./docs/how-opf-works.md) | Conceptual introduction: the document model, content shapes, catalog resolution, and the validation philosophy. Start here. |\n| [`docs/design-resolution.md`](./docs/design-resolution.md) | The design precedence algorithm (slide design \u2192 deck design \u2192 resolved theme \u2192 engine defaults) with worked examples. |\n| [`docs/schema-reference.md`](./docs/schema-reference.md) | Author-facing reference for top-level OPF fields and every presentation schema `$defs` object/type. |\n| [`docs/catalog-schema-reference.md`](./docs/catalog-schema-reference.md) | Author-facing reference for every companion catalog schema. |\n| [`docs/content-payloads.md`](./docs/content-payloads.md) | Author-facing notes for slide and region content payloads, including chart and table object shapes. |\n| [`docs/examples.md`](./docs/examples.md) | Guide to the expanded scenario-oriented examples under `examples/gallery/`. |\n| [`docs/live-editor.md`](./docs/live-editor.md) | Browser canvas, live OPF editing, font loading, installable preview packages, and current fidelity limits. |\n| [`docs/release-process.md`](./docs/release-process.md) | Maintainer runbook for tagging, trusted npm publishing, verification, and GitHub release notes. |\n| [`spec/schemas/*.schema.json`](./spec/schemas) | Companion schemas for catalog records and sub-objects. |\n| [`spec/catalogs/<catalog-kind>/`](./spec/catalogs) | Canonical bundled catalog records. |\n| [`spec/openapi.yaml`](./spec/openapi.yaml) | Optional reference OpenAPI contract for downstream services that choose to expose OPF over HTTP. OpenPresentation does not host this API. |\n| [`examples/technical/`](./examples/technical) | Focused OPF fixtures for validator, renderer, catalog-resolution, design, content-payload, and region behavior. |\n| [`examples/gallery/`](./examples/gallery) | Broader OPF example decks organized by industry, function, education, government, presentation type, international, and design/media scenarios. |\n| [`packages/javascript/`](./packages/javascript) | Public pre-stable source for `@openpresentation/opf`. |\n| [`packages/cli/`](./packages/cli) | Installable local CLI for creating, validating, editing, and inspecting OPF. |\n| [`legacy/`](./legacy) | Tombstone for service-specific clients, CLIs, tool integrations, and workflows removed from the OpenPresentation OSS repo. |\n\n## OpenPresentation Boundary\n\nOpenPresentation defines the format, bundled presets, local validation, examples, docs, and planned local render/edit/convert libraries. It does not provide hosted functions or managed product surfaces.\n\nFuture non-JavaScript OPF packages should follow the same local-first boundary: Python and Go packages should expose schemas, types/models, catalogs, validation, and package-addressable assets. Future toolkit packages should expose embeddable library APIs with no required network calls, hosted callbacks, hidden telemetry, or managed infrastructure assumptions.\n\nThe published JavaScript package copies package-addressable OPF schemas, catalogs, reference assets, and the optional reference `spec/openapi.yaml` from `spec/`. It intentionally remains `@openpresentation/opf` instead of introducing a separate `@openpresentation/opf-spec` package so downstream imports can advance by semver-pinning one canonical package.\n\n## License\n\nMIT. See [LICENSE](./LICENSE).\n';
+var repoReadmeRaw = '# Open Presentation Format (OPF)\n\n[![npm version](https://img.shields.io/npm/v/@openpresentation/opf?label=npm)](https://www.npmjs.com/package/@openpresentation/opf)\n[![npm downloads](https://img.shields.io/npm/dw/@openpresentation/opf)](https://www.npmjs.com/package/@openpresentation/opf)\n[![license](https://img.shields.io/npm/l/@openpresentation/opf)](./LICENSE)\n\nPublic npm package: [`@openpresentation/opf`](https://www.npmjs.com/package/@openpresentation/opf) (`npm install @openpresentation/opf`).\n\nOpen Presentation Format is the portable, human-readable JSON document format for slide decks.\n\nThis repository is the canonical home for the OPF **spec**, **JSON Schemas**, **catalog presets**, examples, generated developer types, local validation tooling, and planning docs for the future render/edit/convert toolkit. OpenPresentation publishes open-source code and documentation only; it does not provide hosted APIs, hosted rendering functions, queues, storage, authentication, jobs, previews, SLAs, telemetry, or managed infrastructure.\n\nFor AI agents, use the [OPF skill set](docs/agent-skills.md) for authoring, layout, presets, editing, export, and schema inspection.\n\nCLI 0.5.0 installs all six skills into your project with `npx @openpresentation/cli@latest skills install`. It uses local copies, preserves existing instructions and refuses to overwrite customized skills. See the [installation and update guide](docs/agent-skills.md) for personal or agent-specific targets and pre-release testing.\n\nFor a fresh Node 24 project that installs **published** packages (not this\ncheckout), follow the [developer quickstart](docs/quickstart.md) and the\n[compatibility matrix](docs/compatibility-matrix.md).\n\nFor LLM authoring, start with [the authoring guide](docs/llm-authoring.md), [dynamic composition](docs/dynamic-composition.md), and [local ecosystem verification](docs/ecosystem-development.md).\n\n## File naming\n\nOpen Presentation Format documents are JSON files. Use `*.opf.json` for complete OPF presentation documents, for example `board-review.opf.json` or `deck.opf.json`.\n\nAvoid using bare `*.opf` for OPF JSON. The `.opf` extension is already used by other document and project formats, while `.opf.json` keeps the OPF identity and still makes the underlying JSON format clear to editors, validators, agents, and version-control tooling.\n\n## Naming and reuse\n\nThe format name is **Open Presentation Format**. The schemas, catalogs, packages, and local tooling in this repository are free and open source under the MIT license, so third-party tools may read, write, validate, render, convert, and describe support for Open Presentation Format without adopting any product-specific branding.\n\n## Why OPF\n\n`.pptx` is a zipped bundle of XML. Humans can\'t diff it, LLMs can\'t read or write it reliably, and git can\'t track it meaningfully. Every change looks like a binary blob.\n\nOPF is plain JSON. A human can open it in an editor. A model can read and write it without guessing at schema-by-example. Decks live in git like the rest of your work.\n\nThat\'s the shift that lets LLMs actually *author* decks. When the format stops fighting them, models can do the work that matters \u2014 narrative structure, persuasive framing, data analysis, chart recommendations, ruthless revision passes \u2014 instead of wrestling with `<p:sp>` tags.\n\nAnd they don\'t start from a blank canvas. [pptx.gallery](https://pptx.gallery) is the human-browsable reference for OPF catalog presets: layouts, themes, color schemes, font schemes, chart types, narratives, audiences, purposes, tones, languages, and social platforms.\n\n## Start in three steps\n\n1. **Install the coordinated published packages** on Node 24. See [the developer quickstart](docs/quickstart.md) for the current pin set (`@openpresentation/opf@0.10.1` plus renderer, editor, PPTX and CLI 0.8.1 / 0.7.1).\n2. **Author, lint, paginate, preview and export.** Copy [`docs/quickstart/developer-quickstart.opf.json`](./docs/quickstart/developer-quickstart.opf.json) and run the commands in that guide. `validatePresentation` / `opf validate` is local schema checking, not visual verification.\n3. **Know the limits.** The [compatibility matrix](docs/compatibility-matrix.md) lists shipped APIs versus renderer issue 24, native PowerPoint issue 87, and other deferred work. Browse presets at [pptx.gallery](https://pptx.gallery).\n\nYour deck lives in git from the first commit. Nothing in these steps calls a hosted service, and nothing ever will \u2014 that boundary is the point.\n\n## JavaScript and TypeScript\n\nThe canonical JavaScript/TypeScript package is published at [`packages/javascript`](./packages/javascript) as [`@openpresentation/opf`](https://www.npmjs.com/package/@openpresentation/opf). The schema is pre-stable (0.x \u2014 expect breaking changes between minor versions until 1.0). Its responsibility is local and format-level only:\n\n- export the canonical schemas from [`spec/`](./spec)\n- export bundled catalog records from [`spec/`](./spec)\n- export a typed raw spec file manifest for package-addressable `spec/` content\n- generate TypeScript types, with `Presentation` as the top-level type\n- validate OPF JSON and catalog records locally\n\nIt does not render `.pptx`, parse `.pptx`, generate content with AI, fetch remote catalogs, call hosted APIs, or provide managed services. Render/edit/convert packages live in separate MIT repos that depend on `@openpresentation/opf`. The format package also exposes pure composition geometry so those packages share layout behavior.\n\n## Toolkit libraries\n\nThe local toolkit lives in sibling repositories. See [ecosystem development](docs/ecosystem-development.md) for coordinated builds and verification, and [dynamic composition](docs/dynamic-composition.md) for portable layout rules.\n\n| Repo | Role | Boundary |\n|---|---|---|\n| `opf-render` | OPF to SVG/PNG/PDF | Local and embeddable rendering library |\n| `opf-editor` | WYSIWYG bindings/components | Headless editor primitives plus optional UI components |\n| `opf-pptx` | OPF to PPTX and PPTX to OPF | Pure local import/export library for browser and server use where supported |\n\nThese repos provide OSS primitives only. Downstream applications own hosting, auth, storage, collaboration, queues, previews, analytics, support, and workflow UX.\n\n## Usage\n\nInstall from npm:\n\n```sh\npnpm add @openpresentation/opf\n# or: npm install @openpresentation/opf\n```\n\nTo work on the package itself, clone this repo and build the workspace:\n\n```sh\npnpm install\npnpm build\n```\n\nUse the format package from JavaScript or TypeScript:\n\n```ts\nimport {\n  presentation,\n  audiences,\n  purposes,\n  tones,\n  validatePresentation,\n} from "@openpresentation/opf";\n\nimport type { Presentation } from "@openpresentation/opf";\n\nconst deck: Presentation = {\n  name: "Quarterly Review",\n  slides: [{ title: "Quarterly Review", items: ["Revenue", "Product", "Hiring"] }],\n};\n\nconst result = validatePresentation(deck);\nconsole.log(result.valid); // schema correctness\nconsole.log(result.warnings); // advisory issues, e.g. unknown catalog ids\nconsole.log(audiences.length, purposes.length, tones.length);\n```\n\nUse focused imports when you only need one surface:\n\n```ts\nimport { presentation } from "@openpresentation/opf/schemas";\nimport { audiences, purposes } from "@openpresentation/opf/catalogs";\nimport { specFileEntries } from "@openpresentation/opf/spec-files";\nimport { validate } from "@openpresentation/opf/validator";\nimport type { Presentation } from "@openpresentation/opf/types";\n```\n\nUse raw JSON when an engine or resolver needs package-addressable files:\n\n```ts\nimport presentationSchema from "@openpresentation/opf/spec/schemas/opf.schema.json" with {\n  type: "json",\n};\n```\n\nUse the [installable OPF CLI](./packages/cli/README.md) to create, validate, and edit files locally:\n\n```sh\npnpm --filter @openpresentation/cli build\nnode packages/cli/dist/index.js create deck.opf.json --title "Decision brief"\nnode packages/cli/dist/index.js validate deck.opf.json\nnode packages/cli/dist/index.js edit deck.opf.json --patch changes.json --in-place\n```\n\nSee [CSV and JSON data import](./docs/data-import.md) for editable tables and charts in the editor, CLI, and package API.\n\n## Layout\n\n| Path | Contents |\n|---|---|\n| [`spec/schemas/opf.schema.json`](./spec/schemas/opf.schema.json) | Canonical JSON Schema for top-level OPF `Presentation` documents. |\n| [`docs/how-opf-works.md`](./docs/how-opf-works.md) | Conceptual introduction: the document model, content shapes, catalog resolution, and the validation philosophy. Start here. |\n| [`docs/design-resolution.md`](./docs/design-resolution.md) | The design precedence algorithm (slide design \u2192 deck design \u2192 resolved theme \u2192 engine defaults) with worked examples. |\n| [`docs/schema-reference.md`](./docs/schema-reference.md) | Author-facing reference for top-level OPF fields and every presentation schema `$defs` object/type. |\n| [`docs/catalog-schema-reference.md`](./docs/catalog-schema-reference.md) | Author-facing reference for every companion catalog schema. |\n| [`docs/content-payloads.md`](./docs/content-payloads.md) | Author-facing notes for slide and region content payloads, including chart and table object shapes. |\n| [`docs/examples.md`](./docs/examples.md) | Guide to the expanded scenario-oriented examples under `examples/gallery/`. |\n| [`docs/live-editor.md`](./docs/live-editor.md) | Browser canvas, live OPF editing, font loading, installable preview packages, and current fidelity limits. |\n| [`docs/release-process.md`](./docs/release-process.md) | Maintainer runbook for tagging, trusted npm publishing, verification, and GitHub release notes. |\n| [`spec/schemas/*.schema.json`](./spec/schemas) | Companion schemas for catalog records and sub-objects. |\n| [`spec/catalogs/<catalog-kind>/`](./spec/catalogs) | Canonical bundled catalog records. |\n| [`spec/openapi.yaml`](./spec/openapi.yaml) | Optional reference OpenAPI contract for downstream services that choose to expose OPF over HTTP. OpenPresentation does not host this API. |\n| [`examples/technical/`](./examples/technical) | Focused OPF fixtures for validator, renderer, catalog-resolution, design, content-payload, and region behavior. |\n| [`examples/gallery/`](./examples/gallery) | Broader OPF example decks organized by industry, function, education, government, presentation type, international, and design/media scenarios. |\n| [`packages/javascript/`](./packages/javascript) | Public pre-stable source for `@openpresentation/opf`. |\n| [`packages/cli/`](./packages/cli) | Installable local CLI for creating, validating, editing, and inspecting OPF. |\n| [`legacy/`](./legacy) | Tombstone for service-specific clients, CLIs, tool integrations, and workflows removed from the OpenPresentation OSS repo. |\n\n## OpenPresentation Boundary\n\nOpenPresentation defines the format, bundled presets, local validation, examples, docs, and planned local render/edit/convert libraries. It does not provide hosted functions or managed product surfaces.\n\nFuture non-JavaScript OPF packages should follow the same local-first boundary: Python and Go packages should expose schemas, types/models, catalogs, validation, and package-addressable assets. Future toolkit packages should expose embeddable library APIs with no required network calls, hosted callbacks, hidden telemetry, or managed infrastructure assumptions.\n\nThe published JavaScript package copies package-addressable OPF schemas, catalogs, reference assets, and the optional reference `spec/openapi.yaml` from `spec/`. It intentionally remains `@openpresentation/opf` instead of introducing a separate `@openpresentation/opf-spec` package so downstream imports can advance by semver-pinning one canonical package.\n\n## License\n\nMIT. See [LICENSE](./LICENSE).\n';
 
 // src/repo-readme.ts
 var repoReadme = repoReadmeRaw;

package/dist/{schemas-BYe5y8-i.d.ts → schemas-CiVmUT2p.d.ts}

@@ -39,6 +39,9 @@ declare const presentation: JsonSchemaDocument & {
         readonly "Dimensions": JsonObject;
         readonly "ThemeBackgroundSlot": JsonObject;
         readonly "HexColor": JsonObject;
+        readonly "ColorRef": JsonObject;
+        readonly "Variables": JsonObject;
+        readonly "Variable": JsonObject;
         readonly "BackgroundShortcut": JsonObject;
         readonly "Background": JsonObject;
         readonly "ThemeBackground": JsonObject;
@@ -132,6 +135,9 @@ declare const schemas: {
             readonly "Dimensions": JsonObject;
             readonly "ThemeBackgroundSlot": JsonObject;
             readonly "HexColor": JsonObject;
+            readonly "ColorRef": JsonObject;
+            readonly "Variables": JsonObject;
+            readonly "Variable": JsonObject;
             readonly "BackgroundShortcut": JsonObject;
             readonly "Background": JsonObject;
             readonly "ThemeBackground": JsonObject;

package/dist/schemas.d.ts

@@ -1 +1 @@
-export { S as SchemaEntry, a as SchemaName, b as audience, c as chartType, d as colorScheme, f as fontScheme, l as language, e as layout, n as narrative, p as presentation, g as purpose, s as schemaEntries, h as schemaNames, i as schemas, j as socialPlatform, t as theme, k as tone } from './schemas-BYe5y8-i.js';
+export { S as SchemaEntry, a as SchemaName, b as audience, c as chartType, d as colorScheme, f as fontScheme, l as language, e as layout, n as narrative, p as presentation, g as purpose, s as schemaEntries, h as schemaNames, i as schemas, j as socialPlatform, t as theme, k as tone } from './schemas-CiVmUT2p.js';

package/dist/schemas.js

@@ -1 +1 @@
-export { audience, chartType, colorScheme, fontScheme, language, layout, narrative, presentation, purpose, schemaEntries, schemaNames, schemas, socialPlatform, theme, tone } from './chunk-GQSK3T7X.js';
+export { audience, chartType, colorScheme, fontScheme, language, layout, narrative, presentation, purpose, schemaEntries, schemaNames, schemas, socialPlatform, theme, tone } from './chunk-GN52EE3P.js';