@openpresentation/opf 0.13.0 → 0.14.0

package/dist/lint-B7azdiuE.d.ts

@@ -1,197 +0,0 @@
-import { C as CatalogKind } from './catalogs-ywCamd8C.js';
-import { V as ValidationIssue } from './validator-CIylxoIm.js';
-import { J as JsonPrimitive } from './schemas-BbPonsTz.js';
-import { T as TextMeasurement } from './composition-D7we69Tr.js';
-
-/** Same three levels as `lintSource`. */
-type AuditSeverity = LintSeverity;
-type AuditCategory = 'accessibility' | 'design' | 'content';
-/** One JSON Patch operation (RFC 6902 subset) a quick fix applies. Paths are JSON Pointers into the audited document. */
-interface AuditPatchOperation {
-    op: 'add' | 'replace' | 'remove';
-    path: string;
-    value?: unknown;
-}
-/**
- * A suggested repair. Core never applies it: a host shows it and applies it through its own undoable edit path.
- * `focus` fixes only name the field the author must fill in; `patch` fixes are small, deterministic and leave
- * every unrelated field untouched.
- */
-interface AuditFix {
-    /** Stable id within one diagnostic, such as `focus-alt` or `inherit-text-color`. */
-    id: string;
-    label: string;
-    kind: 'patch' | 'focus';
-    /** True when applying the fix cannot change the meaning of the content (a colour switched to a readable one, a field focused). */
-    safe: boolean;
-    patch?: AuditPatchOperation[];
-    /** For `focus`: the JSON Pointer of the field to edit and a hint of what it is. */
-    focus?: {
-        path: string;
-        field: 'alt' | 'title' | 'text' | 'link' | 'language' | 'fontSize';
-        value?: unknown;
-    };
-}
-interface AuditDiagnostic extends LintDiagnostic {
-    /** `audit/<rule>`; ids are stable across releases. */
-    ruleId: string;
-    /** Zero-based slide index when the finding belongs to one slide. */
-    slide?: number;
-    slideId?: string;
-    category: AuditCategory;
-    /** Measured values behind the finding (ratios, sizes, counts), for reporters and tests. */
-    measured?: Record<string, number | string | boolean | null>;
-    fixes?: AuditFix[];
-}
-interface AuditThresholds {
-    /** Minimum WCAG contrast ratio for normal text. WCAG 2.x AA: 4.5. */
-    contrastNormal: number;
-    /** Minimum ratio for large text (at least 18 pt, or 14 pt bold). WCAG 2.x AA: 3. */
-    contrastLarge: number;
-    /** Smallest rendered text size, in points, before `audit/min-font-size` reports. */
-    minFontSizePt: number;
-    /** Words on one slide above which `audit/slide-word-count` reports. */
-    maxWordsPerSlide: number;
-    /** Distinct font families across the deck above which `audit/font-family-count` reports. */
-    maxFontFamilies: number;
-    /** Minimum effective pixels per inch of an embedded raster image at its displayed size. */
-    minImagePpi: number;
-    /** Largest title offset between slides of the same layout, as a fraction of the slide width/height. */
-    titlePositionTolerance: number;
-    /** Smallest CIE76 colour difference between two chart series (after colour-vision simulation) before they count as confusable. */
-    minSeriesColorDifference: number;
-}
-interface AuditOptions {
-    /** Per-rule severity, or `off`. Keys are full ids (`audit/text-contrast`) or the bare name (`text-contrast`). */
-    rules?: Record<string, AuditSeverity | 'off'>;
-    /** Rules not to run (full ids or bare names). */
-    ignore?: readonly string[];
-    /** When set, run only these rules (full ids or bare names). */
-    only?: readonly string[];
-    /**
-     * Suppress a rule below a JSON Pointer prefix, for one accepted exception, for example
-     * `{rule: 'audit/text-contrast', path: '/slides/3'}`. A prefix matches whole path segments.
-     */
-    ignorePaths?: readonly {
-        rule: string;
-        path: string;
-    }[];
-    thresholds?: Partial<AuditThresholds>;
-    /** Loaded catalog records, consulted after the document's own `catalogs` and before the bundled ones. */
-    catalogs?: Partial<Record<CatalogKind, readonly unknown[]>>;
-    /**
-     * The host's measured fonts. Without it composition uses core's portable estimate; see docs/audit.md.
-     * A function receives the zero-based slide index, so a host can supply a script-aware measurement per slide.
-     */
-    textMeasurement?: TextMeasurement | ((slideIndex: number) => TextMeasurement | undefined);
-    /** Chart series palette (opaque `#RRGGBB`), in the engine's order. Default: the palette opf-render and opf-pptx use. */
-    chartPalette?: readonly string[];
-}
-interface AuditRuleInfo {
-    /** Stable `audit/<name>` id. */
-    id: string;
-    name: string;
-    category: AuditCategory;
-    /** Default severity. */
-    severity: AuditSeverity;
-    summary: string;
-    /** Why the rule exists. */
-    rationale: string;
-    /** The accessibility or design standard it follows, when there is one. */
-    standard?: string;
-    /** What the check cannot see or approximates. */
-    approximations?: string;
-    /** Threshold names (`AuditThresholds`) the rule reads. */
-    thresholds?: (keyof AuditThresholds)[];
-}
-interface AuditReport {
-    /** True when no finding has severity `error` (the same meaning as lint's `valid`). */
-    valid: boolean;
-    /** False when the document failed schema validation, so no design rule was run. */
-    documentValid: boolean;
-    diagnostics: AuditDiagnostic[];
-    counts: Record<AuditSeverity, number>;
-    /** Rule ids that ran, in registry order. */
-    rulesRun: string[];
-    slideCount: number;
-    thresholds: AuditThresholds;
-    checks: {
-        /** `estimated` unless the host supplied `textMeasurement`. */
-        textMeasurement: 'estimated' | 'provided';
-        /** Text contrast is computed against solid, gradient and pattern backgrounds; picture pixels are never read. */
-        backgroundPixels: 'not-read';
-        /** Image resolution reads only embedded `data:` images; URLs are never fetched. */
-        imageBytes: 'embedded-only';
-        nativeExport: 'not-checked';
-    };
-}
-
-type LintSeverity = 'error' | 'warning' | 'info';
-interface LintLocation {
-    offset: number;
-    length: number;
-    line: number;
-    column: number;
-}
-interface LintSuggestion {
-    value: JsonPrimitive;
-    label: string;
-    origin: 'schema' | 'built-in' | 'loaded' | 'document' | 'contract';
-    definition: string;
-}
-interface LintDiagnostic {
-    ruleId: string;
-    severity: LintSeverity;
-    /** JSON Pointer into the document, or the explicitly supplied lint context. */
-    path: string;
-    scope: 'document' | 'context';
-    message: string;
-    help: string;
-    definition?: string;
-    lookup?: string[];
-    suggestions?: LintSuggestion[];
-    /** Full validation issue retained, including errors inside union alternatives. */
-    validation?: ValidationIssue;
-    /** Original-source UTF-16 offsets and one-based line/column. */
-    location?: LintLocation;
-    /**
-     * Suggested repairs (the audit fix shape: JSON Patch that core never applies). RR-54: an
-     * `opf/chart-value-not-numeric` cell whose column is written in one display style carries the column's fix.
-     */
-    fixes?: AuditFix[];
-}
-interface LintContract {
-    /** JSON Pointer pattern; a complete '*' segment matches one path segment. */
-    path: string;
-    allowedValues: JsonPrimitive[];
-    severity?: LintSeverity;
-    message?: string;
-    documentation?: string;
-}
-interface LintOptions {
-    /** Records already loaded by the host. This API never fetches catalog URLs. */
-    catalogs?: Partial<Record<CatalogKind, readonly unknown[]>>;
-    /** Explicit host policy. Document metadata is never interpreted as policy. */
-    contracts?: readonly LintContract[];
-}
-interface LintReport {
-    valid: boolean;
-    schemaValid: boolean | null;
-    diagnostics: LintDiagnostic[];
-    counts: Record<LintSeverity, number>;
-    checks: {
-        syntax: 'checked' | 'not-applicable';
-        schema: 'checked' | 'not-run';
-        catalogReferences: 'local-context' | 'not-run';
-        assetReferences: 'registry-only' | 'not-run';
-        contracts: 'checked' | 'not-run';
-        layout: 'not-checked';
-        fonts: 'not-checked';
-        nativeExport: 'not-checked';
-    };
-}
-declare function lintPresentation(document: unknown, options?: LintOptions): LintReport;
-/** Lint strict JSON source without normalizing whitespace or duplicate keys. */
-declare function lintSource(source: string, options?: LintOptions): LintReport;
-
-export { type AuditThresholds as A, type LintDiagnostic as L, type AuditOptions as a, type AuditReport as b, type AuditRuleInfo as c, type AuditCategory as d, type AuditDiagnostic as e, type AuditFix as f, type AuditPatchOperation as g, type AuditSeverity as h, type LintLocation as i, type LintSeverity as j, type LintContract as k, type LintOptions as l, type LintReport as m, type LintSuggestion as n, lintPresentation as o, lintSource as p };

package/dist/lint.d.ts

@@ -1,7 +0,0 @@
-import './catalogs-ywCamd8C.js';
-import './validator-CIylxoIm.js';
-import './schemas-BbPonsTz.js';
-export { k as LintContract, L as LintDiagnostic, i as LintLocation, l as LintOptions, m as LintReport, j as LintSeverity, n as LintSuggestion, o as lintPresentation, p as lintSource } from './lint-B7azdiuE.js';
-import './presentation-mG-IYErQ.js';
-import './composition-D7we69Tr.js';
-import './chart-data-Cdr6rRVV.js';

package/dist/lint.js

@@ -1,6 +0,0 @@
-export { lintPresentation, lintSource } from './chunk-INU7ZNSB.js';
-import './chunk-IYCJUKWD.js';
-import './chunk-MPM7NRG7.js';
-import './chunk-S5W34SIJ.js';
-import './chunk-E34DJ5LL.js';
-import './chunk-7QBCWNWL.js';

package/dist/spec/catalogs/audiences/customers.json

@@ -1,27 +0,0 @@
-{
-  "$schema": "https://openpresentation.org/schema/opf-audience/v1",
-  "id": "customers",
-  "name": "Customers",
-  "summary": "Buyers and users — outcome-focused, allergic to jargon, sensitive to time.",
-  "description": "Customer audiences want to know what changes for them. Lead with their problem in their language; show the solution as a path; demonstrate it with peers they recognize. Keep the technical depth in an appendix unless asked. Always close with the next concrete step (trial, pilot, intro).",
-  "seniority": "mixed",
-  "technicalFluency": "mixed",
-  "decisionPower": "decision-maker",
-  "attentionBudgetMinutes": 30,
-  "recommendedNarratives": [
-    "problem-solution",
-    "persuasive-sales",
-    "challenge-resolution",
-    "company-intro"
-  ],
-  "recommendedTones": [
-    "persuasive",
-    "casual",
-    "authoritative"
-  ],
-  "tags": ["external", "customer", "sales"],
-  "deprecation": {
-    "replacedBy": "customer",
-    "reason": "Duplicate of 'customer', the id pptx.gallery publishes. Kept so existing documents keep validating and rendering unchanged; use 'customer' in new documents."
-  }
-}

package/dist/spec/catalogs/audiences/executives.json

@@ -1,27 +0,0 @@
-{
-  "$schema": "https://openpresentation.org/schema/opf-audience/v1",
-  "id": "executives",
-  "name": "Executives",
-  "summary": "Senior leaders who need the recommendation up front, the evidence behind it, and the ask.",
-  "description": "Executives are time-poor and decision-oriented. Lead with the recommendation, support it with three claims and one number per claim, and end with a clear ask. Avoid drilling into mechanisms unless invited; offer to follow up rather than including everything in the deck.",
-  "seniority": "c-suite",
-  "technicalFluency": "medium",
-  "decisionPower": "decision-maker",
-  "attentionBudgetMinutes": 30,
-  "recommendedNarratives": [
-    "scqa",
-    "qbr",
-    "strategic-narrative",
-    "project-proposal"
-  ],
-  "recommendedTones": [
-    "formal",
-    "authoritative",
-    "persuasive"
-  ],
-  "tags": ["leadership", "decision-making"],
-  "deprecation": {
-    "replacedBy": "executive",
-    "reason": "Duplicate of 'executive', the id pptx.gallery publishes. Kept so existing documents keep validating and rendering unchanged; use 'executive' in new documents."
-  }
-}

package/dist/spec/catalogs/audiences/investors.json

@@ -1,27 +0,0 @@
-{
-  "$schema": "https://openpresentation.org/schema/opf-audience/v1",
-  "id": "investors",
-  "name": "Investors",
-  "summary": "Capital allocators evaluating fit, traction, and risk-adjusted return.",
-  "description": "Investors read pattern-matching against their existing portfolio. They want the story (why this market, why now, why you), the proof (traction, retention, gross margin, growth rate), and the ask (raise size, use of funds, milestones). They will not assume — make the bull case explicit and acknowledge the bear case rather than hide it.",
-  "seniority": "mixed",
-  "technicalFluency": "medium",
-  "decisionPower": "decision-maker",
-  "attentionBudgetMinutes": 30,
-  "recommendedNarratives": [
-    "venture-pitch",
-    "early-startup-pitch",
-    "pitch-deck",
-    "strategic-narrative"
-  ],
-  "recommendedTones": [
-    "persuasive",
-    "authoritative",
-    "inspirational"
-  ],
-  "tags": ["external", "capital", "fundraising"],
-  "deprecation": {
-    "replacedBy": "investor",
-    "reason": "Duplicate of 'investor', the id pptx.gallery publishes. Kept so existing documents keep validating and rendering unchanged; use 'investor' in new documents."
-  }
-}

package/dist/spec/catalogs/audiences/marketing-team.json

@@ -1,27 +0,0 @@
-{
-  "$schema": "https://openpresentation.org/schema/opf-audience/v1",
-  "id": "marketing-team",
-  "name": "Marketing Team",
-  "summary": "Brand and demand-gen practitioners aligning on positioning, messaging, and campaigns.",
-  "description": "Marketing audiences want positioning, messaging hierarchy, and campaign-level metrics. Tie strategy to specific campaigns and channels. Show the funnel — leads, conversion, velocity — and explain how each campaign moves a stage of it.",
-  "seniority": "mixed",
-  "technicalFluency": "low",
-  "decisionPower": "advisory",
-  "attentionBudgetMinutes": 45,
-  "recommendedNarratives": [
-    "marketing-strategy",
-    "product-launch",
-    "qbr",
-    "weekly-progress"
-  ],
-  "recommendedTones": [
-    "casual",
-    "persuasive",
-    "authoritative"
-  ],
-  "tags": ["internal", "go-to-market", "brand"],
-  "deprecation": {
-    "replacedBy": "marketing",
-    "reason": "Duplicate of 'marketing', the id pptx.gallery publishes. Kept so existing documents keep validating and rendering unchanged; use 'marketing' in new documents."
-  }
-}

package/dist/spec/catalogs/audiences/regulators.json

@@ -1,27 +0,0 @@
-{
-  "$schema": "https://openpresentation.org/schema/opf-audience/v1",
-  "id": "regulators",
-  "name": "Regulators",
-  "summary": "Government, agency, and policy reviewers evaluating compliance, risk, and impact.",
-  "description": "Regulator audiences expect precision, completeness, and verifiable claims. Cite frameworks and standards explicitly; quantify risks with named mitigations; avoid promotional framing entirely. Document what you don't know alongside what you do.",
-  "seniority": "mixed",
-  "technicalFluency": "medium",
-  "decisionPower": "decision-maker",
-  "attentionBudgetMinutes": 60,
-  "recommendedNarratives": [
-    "scqa",
-    "challenge-resolution",
-    "strategic-advisory",
-    "performance-improvement-plan"
-  ],
-  "recommendedTones": [
-    "formal",
-    "authoritative",
-    "technical"
-  ],
-  "tags": ["external", "compliance", "policy"],
-  "deprecation": {
-    "replacedBy": "regulatory",
-    "reason": "Duplicate of 'regulatory', the id pptx.gallery publishes. Kept so existing documents keep validating and rendering unchanged; use 'regulatory' in new documents."
-  }
-}

package/dist/spec/catalogs/audiences/sales-team.json

@@ -1,27 +0,0 @@
-{
-  "$schema": "https://openpresentation.org/schema/opf-audience/v1",
-  "id": "sales-team",
-  "name": "Sales Team",
-  "summary": "Quota-carrying reps who want talk tracks, objection handling, and crisp proof.",
-  "description": "Sales audiences need actionable assets, not strategy framing. Surface the talk tracks they'll repeat, the three objections they'll hear, and the data points that close. Keep slides scannable — much of this content is consumed asynchronously between calls.",
-  "seniority": "mixed",
-  "technicalFluency": "low",
-  "decisionPower": "informational",
-  "attentionBudgetMinutes": 30,
-  "recommendedNarratives": [
-    "marketing-strategy",
-    "persuasive-sales",
-    "weekly-progress",
-    "status-update"
-  ],
-  "recommendedTones": [
-    "casual",
-    "persuasive",
-    "conversational"
-  ],
-  "tags": ["internal", "go-to-market", "enablement"],
-  "deprecation": {
-    "replacedBy": "sales",
-    "reason": "Duplicate of 'sales', the id pptx.gallery publishes. Kept so existing documents keep validating and rendering unchanged; use 'sales' in new documents."
-  }
-}

package/dist/spec/catalogs/chart-types/100pct-bullet-bar-2x.json

@@ -1,91 +0,0 @@
-{
-  "$schema": "https://openpresentation.org/schema/opf-chart-type/v1",
-  "id": "100pct-bullet-bar-2x",
-  "name": "100PCT_BULLET_BAR_2X",
-  "label": "100% Bullet Bar 2x",
-  "mappings": {
-    "openxml": {
-      "composition": "mixed",
-      "series": [
-        {
-          "element": "barChart",
-          "barDir": "bar",
-          "grouping": "stacked",
-          "composition": "single"
-        },
-        {
-          "element": "scatterChart",
-          "scatterStyle": "marker",
-          "composition": "single"
-        }
-      ],
-      "notes": "Bullet bars combine threshold bands with a value marker."
-    }
-  },
-  "deprecation": {
-    "replacedBy": "100pct-stacked-bar-3x",
-    "reason": "Composition of several chart series types (bands, markers, helper series, or small multiples), not a single Aspose.Slides ChartType. Use '100pct-stacked-bar-3x', the closest supported ChartType.",
-    "removal": "0.12.0"
-  },
-  "categories": 8,
-  "columns": [
-    "ValueCategory",
-    "Alpha",
-    "Beta"
-  ],
-  "group": "Bullet",
-  "groupSort": 10,
-  "series": 2,
-  "seriesGroups": 2,
-  "slideNumber": 58,
-  "useSecondaryCategories": true,
-  "workbookRange": "Sheet1!$A$1:$I$3",
-  "complexity": "calculated",
-  "dataColumns": [
-    {
-      "name": "ValueCategory",
-      "role": "categoryLabel",
-      "type": "string",
-      "position": "row0_col0"
-    },
-    {
-      "name": "Alpha",
-      "role": "series",
-      "type": "number",
-      "position": "row1_col0"
-    },
-    {
-      "name": "Beta",
-      "role": "series",
-      "type": "number",
-      "position": "row2_col0"
-    }
-  ],
-  "helperColumns": [
-    "Excellent",
-    "Good",
-    "Fair",
-    "Poor",
-    "Actual %",
-    "Target %"
-  ],
-  "sampleData": {
-    "headers": [
-      "ValueCategory",
-      "Actual",
-      "Target"
-    ],
-    "rows": [
-      [
-        "Metric 1",
-        75,
-        97
-      ],
-      [
-        "Metric 2",
-        70,
-        84
-      ]
-    ]
-  }
-}

package/dist/spec/catalogs/chart-types/100pct-bullet-bar-3x.json

@@ -1,103 +0,0 @@
-{
-  "$schema": "https://openpresentation.org/schema/opf-chart-type/v1",
-  "id": "100pct-bullet-bar-3x",
-  "name": "100PCT_BULLET_BAR_3X",
-  "label": "100% Bullet Bar 3x",
-  "mappings": {
-    "openxml": {
-      "composition": "mixed",
-      "series": [
-        {
-          "element": "barChart",
-          "barDir": "bar",
-          "grouping": "stacked",
-          "composition": "single"
-        },
-        {
-          "element": "scatterChart",
-          "scatterStyle": "marker",
-          "composition": "single"
-        }
-      ],
-      "notes": "Bullet bars combine threshold bands with a value marker."
-    }
-  },
-  "deprecation": {
-    "replacedBy": "100pct-stacked-bar-3x",
-    "reason": "Composition of several chart series types (bands, markers, helper series, or small multiples), not a single Aspose.Slides ChartType. Use '100pct-stacked-bar-3x', the closest supported ChartType.",
-    "removal": "0.12.0"
-  },
-  "categories": 8,
-  "columns": [
-    "ValueCategory",
-    "Alpha",
-    "Beta",
-    "Gamma"
-  ],
-  "group": "Bullet",
-  "groupSort": 10,
-  "series": 3,
-  "seriesGroups": 2,
-  "slideNumber": 59,
-  "useSecondaryCategories": true,
-  "workbookRange": "Sheet1!$A$1:$I$4",
-  "complexity": "calculated",
-  "dataColumns": [
-    {
-      "name": "ValueCategory",
-      "role": "categoryLabel",
-      "type": "string",
-      "position": "row0_col0"
-    },
-    {
-      "name": "Alpha",
-      "role": "series",
-      "type": "number",
-      "position": "row1_col0"
-    },
-    {
-      "name": "Beta",
-      "role": "series",
-      "type": "number",
-      "position": "row2_col0"
-    },
-    {
-      "name": "Gamma",
-      "role": "series",
-      "type": "number",
-      "position": "row3_col0"
-    }
-  ],
-  "helperColumns": [
-    "Excellent",
-    "Good",
-    "Fair",
-    "Poor",
-    "Actual %",
-    "Target %"
-  ],
-  "sampleData": {
-    "headers": [
-      "ValueCategory",
-      "Actual",
-      "Target"
-    ],
-    "rows": [
-      [
-        "Metric 1",
-        95,
-        75
-      ],
-      [
-        "Metric 2",
-        95,
-        88
-      ],
-      [
-        "Metric 3",
-        65,
-        82
-      ]
-    ]
-  }
-}

package/dist/spec/catalogs/chart-types/100pct-bullet-bar.json

@@ -1,79 +0,0 @@
-{
-  "$schema": "https://openpresentation.org/schema/opf-chart-type/v1",
-  "id": "100pct-bullet-bar",
-  "name": "100PCT_BULLET_BAR",
-  "label": "100% Bullet Bar",
-  "mappings": {
-    "openxml": {
-      "composition": "mixed",
-      "series": [
-        {
-          "element": "barChart",
-          "barDir": "bar",
-          "grouping": "stacked",
-          "composition": "single"
-        },
-        {
-          "element": "scatterChart",
-          "scatterStyle": "marker",
-          "composition": "single"
-        }
-      ],
-      "notes": "Bullet bars combine threshold bands with a value marker."
-    }
-  },
-  "deprecation": {
-    "replacedBy": "100pct-stacked-bar-3x",
-    "reason": "Composition of several chart series types (bands, markers, helper series, or small multiples), not a single Aspose.Slides ChartType. Use '100pct-stacked-bar-3x', the closest supported ChartType.",
-    "removal": "0.12.0"
-  },
-  "categories": 8,
-  "columns": [
-    "ValueCategory",
-    "Alpha"
-  ],
-  "group": "Bullet",
-  "groupSort": 10,
-  "series": 1,
-  "seriesGroups": 2,
-  "slideNumber": 57,
-  "useSecondaryCategories": true,
-  "workbookRange": "Sheet1!$A$1:$I$2",
-  "complexity": "calculated",
-  "dataColumns": [
-    {
-      "name": "ValueCategory",
-      "role": "categoryLabel",
-      "type": "string",
-      "position": "row0_col0"
-    },
-    {
-      "name": "Alpha",
-      "role": "series",
-      "type": "number",
-      "position": "row1_col0"
-    }
-  ],
-  "helperColumns": [
-    "Excellent",
-    "Good",
-    "Fair",
-    "Poor",
-    "Actual %",
-    "Target %"
-  ],
-  "sampleData": {
-    "headers": [
-      "ValueCategory",
-      "Actual",
-      "Target"
-    ],
-    "rows": [
-      [
-        "Metric 1",
-        61,
-        95
-      ]
-    ]
-  }
-}