@openpresentation/opf 0.1.0

package/dist/spec/reference/engine-defaults.json

@@ -0,0 +1,35 @@
+{
+  "description": "Reference example of engine-side defaults consumed by an OPF runtime. Not part of the OPF document contract - engines load this file (or their own copy) at startup to fall back when an OPF document doesn't specify a value. There is no companion JSON Schema for this file: it is engine config, not a catalog record. Every catalog-referencing value below is resolved through the catalog system the same way an explicit reference in an OPF document would be (inline catalogs.<kind>.records[] -> catalogs.<kind>.source -> default catalog at https://www.pptx.gallery/<kind>). The optional catalogs.<kind>.source overrides below let a deployment redirect all default catalog fetches at once (e.g., to an internal mirror or local package), without each OPF document needing its own catalogs block. The 'chartTypes' array is in priority order: chartTypes[0] is the engine's primary chart type, chartTypes[1] secondary, chartTypes[2] tertiary.",
+
+  "catalogs": {
+    "narratives":   { "source": "https://www.pptx.gallery/narratives" },
+    "themes":       { "source": "https://www.pptx.gallery/themes" },
+    "colorSchemes": { "source": "https://www.pptx.gallery/color-schemes" },
+    "fontSchemes":  { "source": "https://www.pptx.gallery/font-schemes" },
+    "languages":    { "source": "https://www.pptx.gallery/languages" },
+    "layouts":      { "source": "https://www.pptx.gallery/layouts" },
+    "chartTypes":   { "source": "https://www.pptx.gallery/chart-types" },
+    "tones":        { "source": "https://www.pptx.gallery/tones" },
+    "audiences":    { "source": "https://www.pptx.gallery/audiences" },
+    "socialPlatforms": { "source": "https://www.pptx.gallery/social-platforms" }
+  },
+
+  "theme": "minimal",
+  "colorScheme": "cool-horizon",
+  "language": "english",
+  "narrative": "classic-story",
+  "tone": "formal",
+  "audience": "executives",
+
+  "fontScheme": {
+    "pptx":   { "latin": "aptos",  "ea": "microsoft-yahei", "cs": "nirmala-ui" },
+    "google": { "latin": "roboto", "ea": "noto-sans-sc",    "cs": "noto-sans" }
+  },
+
+  "chartTypes": [
+    "stacked-column-3x",
+    "stacked-area-3x",
+    "line-with-markers-3x"
+  ]
+}
+

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

@@ -0,0 +1,156 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openpresentation.org/schema/opf-audience/v1",
+  "title": "OPF Audience",
+  "description": "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.",
+  "type": "object",
+  "required": [
+    "$schema",
+    "id",
+    "name"
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "const": "https://openpresentation.org/schema/opf-audience/v1",
+      "description": "Identifies this record as an audience in the openpresentation.org catalog."
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "description": "Stable slug used by OPF documents to reference this audience via audience. Lowercase kebab-case.",
+      "examples": [
+        "executives",
+        "board",
+        "engineering-team",
+        "investors",
+        "customers",
+        "sales-team",
+        "marketing-team",
+        "all-hands",
+        "candidates",
+        "regulators"
+      ]
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable audience name shown in pickers.",
+      "examples": [
+        "Executives",
+        "Board of Directors",
+        "Engineering Team",
+        "Investors",
+        "Customers",
+        "Sales Team",
+        "Marketing Team",
+        "All Hands",
+        "Candidates",
+        "Regulators"
+      ]
+    },
+    "summary": {
+      "type": "string",
+      "description": "One-sentence positioning of the audience — who they are and what they care about.",
+      "examples": [
+        "Senior leaders who need the recommendation up front, the evidence behind it, and the ask.",
+        "Practitioners building the system; they want depth, mechanism, and tradeoffs."
+      ]
+    },
+    "description": {
+      "type": "string",
+      "description": "Longer prose describing the audience archetype and how to address them.",
+      "examples": [
+        "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": {
+      "type": "string",
+      "enum": [
+        "ic",
+        "manager",
+        "director",
+        "vp",
+        "c-suite",
+        "mixed"
+      ],
+      "description": "Typical seniority level of the audience. Engines use this as a hint for default depth and pacing."
+    },
+    "technicalFluency": {
+      "type": "string",
+      "enum": [
+        "low",
+        "medium",
+        "high",
+        "mixed"
+      ],
+      "description": "Typical technical fluency of the audience. AI generation uses this to decide whether to expand or assume technical terminology."
+    },
+    "decisionPower": {
+      "type": "string",
+      "enum": [
+        "informational",
+        "advisory",
+        "decision-maker"
+      ],
+      "description": "Whether the audience is expected to be informed, to advise, or to actually decide. Shapes the strength of the closing ask."
+    },
+    "attentionBudgetMinutes": {
+      "type": "number",
+      "exclusiveMinimum": 0,
+      "description": "Realistic upper bound on this audience's focused attention for a single presentation, in minutes. Used as a hint when comparing against duration and the resolved narrative's durationRange."
+    },
+    "recommendedNarratives": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Soft cross-link: narrative-catalog ids that work well for this audience. Used by picker UIs to suggest narratives once an audience is chosen. Validators warn on unknown ids; never error.",
+      "examples": [
+        ["scqa", "board-meeting", "qbr"]
+      ]
+    },
+    "recommendedTones": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Soft cross-link: tone-catalog ids that work well for this audience.",
+      "examples": [
+        ["formal", "authoritative"]
+      ]
+    },
+    "tags": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Free-form labels for filtering and search.",
+      "examples": [
+        ["leadership", "external"],
+        ["internal", "engineering"],
+        ["external", "customer"]
+      ]
+    },
+    "preview": {
+      "type": "object",
+      "description": "Visual previews of the record, used by picker UIs and inline rendering. All sub-fields are optional.",
+      "properties": {
+        "src": {
+          "type": "string",
+          "format": "uri",
+          "description": "Main preview image (PNG/JPG)."
+        },
+        "thumbnailSrc": {
+          "type": "string",
+          "format": "uri",
+          "description": "Smaller thumbnail preview suited to dense grid views."
+        },
+        "vectorSrc": {
+          "type": "string",
+          "format": "uri",
+          "description": "SVG / vector preview for crisp scaling at any size."
+        }
+      }
+    }
+  }
+}