@openpresentation/opf 0.1.0

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

@@ -0,0 +1,92 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openpresentation.org/schema/opf-purpose/v1",
+  "title": "OPF Purpose",
+  "description": "Schema for purpose records in the pptx.gallery library. Each record names a presentation objective such as informing, aligning, persuading, driving a decision, or selling. Purposes are referenced from OPF documents via purpose; the engine resolves the reference against catalogs.purposes (inline) → catalogs.purposes.source → the default catalog at https://www.pptx.gallery/purposes. The purpose field also accepts free-form strings and inline Purpose objects.",
+  "type": "object",
+  "required": [
+    "$schema",
+    "id",
+    "name"
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "const": "https://openpresentation.org/schema/opf-purpose/v1",
+      "description": "Identifies this record as a purpose in the openpresentation.org catalog."
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "description": "Stable slug used by OPF documents to reference this purpose via purpose. Lowercase kebab-case.",
+      "examples": ["inform", "decide", "align", "persuade", "educate", "report", "pitch", "sell", "plan"]
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable purpose name shown in pickers.",
+      "examples": ["Inform", "Drive a Decision", "Align", "Persuade"]
+    },
+    "summary": {
+      "type": "string",
+      "description": "One-sentence positioning of the purpose — what this deck is trying to accomplish."
+    },
+    "description": {
+      "type": "string",
+      "description": "Longer prose describing when to use this purpose and how it should shape a deck."
+    },
+    "outcome": {
+      "type": "string",
+      "description": "Desired audience outcome after the presentation.",
+      "examples": ["Approve the recommendation", "Understand the status", "Adopt the plan"]
+    },
+    "successCriteria": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Observable signals that the deck accomplished this purpose."
+    },
+    "recommendedNarratives": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Soft cross-link: narrative-catalog ids that work well for this purpose."
+    },
+    "recommendedTones": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Soft cross-link: tone-catalog ids that work well for this purpose."
+    },
+    "tags": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Free-form labels for filtering and search."
+    },
+    "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."
+        }
+      }
+    }
+  }
+}

package/dist/spec/schemas/social-platform.schema.json

@@ -0,0 +1,184 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openpresentation.org/schema/opf-social-platform/v1",
+  "title": "OPF Social Platform",
+  "description": "Schema for social-platform records in the pptx.gallery library. Each record describes a single social-media platform — its base URL, profile-URL pattern, handle prefix, brand color, and themed icons. Records are referenced from OPF documents indirectly: the property keys of any Socials object (Organization.socials, Speaker.socials) match record ids, and renderers use the catalog record to format URLs and pick icons. The engine resolves references against catalogs.socialPlatforms (inline) → catalogs.socialPlatforms.source → the default catalog at https://www.pptx.gallery/social-platforms.",
+  "type": "object",
+  "required": [
+    "$schema",
+    "id",
+    "name"
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "const": "https://openpresentation.org/schema/opf-social-platform/v1",
+      "description": "Identifies this record as a social-platform entry in the openpresentation.org catalog."
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "description": "Stable slug used by OPF documents to reference this platform — appears as a property key on Socials objects. Lowercase kebab-case.",
+      "examples": [
+        "linkedin",
+        "x",
+        "github",
+        "youtube",
+        "instagram",
+        "facebook",
+        "tiktok",
+        "threads",
+        "mastodon",
+        "bluesky"
+      ]
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable platform name shown in pickers and footers.",
+      "examples": [
+        "LinkedIn",
+        "X",
+        "GitHub",
+        "YouTube",
+        "Instagram",
+        "Facebook",
+        "TikTok",
+        "Threads",
+        "Mastodon",
+        "Bluesky"
+      ]
+    },
+    "summary": {
+      "type": "string",
+      "description": "One-sentence positioning of the platform — what it's used for and who's on it.",
+      "examples": [
+        "Professional social network for individuals and companies.",
+        "Real-time microblog for news, opinions, and discussion."
+      ]
+    },
+    "description": {
+      "type": "string",
+      "description": "Longer prose describing the platform and any rendering conventions (e.g., handle prefixes, distributed instances).",
+      "examples": [
+        "LinkedIn distinguishes between member profiles ('/in/<handle>') and company pages ('/company/<handle>'). Renderers should pick the appropriate URL pattern based on whether the parent is an Organization or a Speaker."
+      ]
+    },
+    "baseUrl": {
+      "type": "string",
+      "format": "uri",
+      "description": "Canonical base URL of the platform — used as the prefix when normalizing handles to full URLs.",
+      "examples": [
+        "https://linkedin.com",
+        "https://x.com",
+        "https://github.com",
+        "https://youtube.com"
+      ]
+    },
+    "profileUrlPattern": {
+      "type": "string",
+      "description": "URL pattern for individual member profiles. Use '{handle}' as the placeholder for the handle (with the prefix already stripped).",
+      "examples": [
+        "https://linkedin.com/in/{handle}",
+        "https://x.com/{handle}",
+        "https://github.com/{handle}",
+        "https://youtube.com/@{handle}"
+      ]
+    },
+    "companyUrlPattern": {
+      "type": "string",
+      "description": "Optional URL pattern for organization / company pages, when the platform distinguishes them from member profiles. Use '{handle}' as the placeholder.",
+      "examples": [
+        "https://linkedin.com/company/{handle}",
+        "https://github.com/{handle}",
+        "https://facebook.com/{handle}"
+      ]
+    },
+    "handlePrefix": {
+      "type": "string",
+      "description": "Conventional prefix character displayed before the handle (e.g. '@' for X / Mastodon / Threads / TikTok). Empty string when no prefix is used. Renderers strip it before substituting into URL patterns.",
+      "examples": ["@", ""]
+    },
+    "handleExample": {
+      "type": "string",
+      "description": "Example handle in its conventional rendered form, used by picker UIs and validation hints.",
+      "examples": [
+        "alice-chen",
+        "@alicechen",
+        "alicechen",
+        "alice.bsky.social",
+        "@alice@hachyderm.io"
+      ]
+    },
+    "brandColor": {
+      "type": "string",
+      "description": "Brand color (hex) used for branded icon chips, link styling, or section accents.",
+      "examples": [
+        "#0A66C2",
+        "#000000",
+        "#181717",
+        "#FF0000"
+      ]
+    },
+    "icon": {
+      "type": "string",
+      "description": "Default icon source. Accepts an HTTPS URL, data URI, relative path, or asset reference. Used as the fallback when a themed (Light/Dark) variant isn't set.",
+      "examples": [
+        "https://www.pptx.gallery/social-platforms/linkedin.svg",
+        "./assets/social-platforms/linkedin.svg",
+        "asset:social-linkedin"
+      ]
+    },
+    "iconLight": {
+      "type": "string",
+      "description": "Light-colored icon variant intended for rendering on dark backgrounds.",
+      "examples": [
+        "https://www.pptx.gallery/social-platforms/linkedin-light.svg",
+        "./assets/social-platforms/linkedin-light.svg"
+      ]
+    },
+    "iconDark": {
+      "type": "string",
+      "description": "Dark-colored icon variant intended for rendering on light backgrounds.",
+      "examples": [
+        "https://www.pptx.gallery/social-platforms/linkedin-dark.svg",
+        "./assets/social-platforms/linkedin-dark.svg"
+      ]
+    },
+    "tags": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Free-form labels for filtering and search.",
+      "examples": [
+        ["professional", "default"],
+        ["microblog", "news"],
+        ["developer", "code"],
+        ["video"],
+        ["decentralized"]
+      ]
+    },
+    "preview": {
+      "type": "object",
+      "description": "Visual previews of the record, used by picker UIs and inline rendering. All sub-fields are optional; engines fall back gracefully when previews aren't available.",
+      "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."
+        }
+      }
+    }
+  }
+}
+

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

@@ -0,0 +1,168 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openpresentation.org/schema/opf-theme/v1",
+  "title": "OPF Theme",
+  "description": "Schema for theme records in the pptx.gallery library. Each theme is a small, named bundle that pairs a color scheme, a font scheme, a default theme-controlled background, and a slide size. Themes are referenced from OPF documents via design.theme or design.theme.id; the engine resolves the reference against catalogs.themes (inline) → catalogs.themes.source → the default catalog at https://www.pptx.gallery/themes. Inline overrides on design.colorScheme / design.fontScheme / design.background / design.dimensions take precedence over a resolved theme.",
+  "type": "object",
+  "required": [
+    "$schema",
+    "id",
+    "name"
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "const": "https://openpresentation.org/schema/opf-theme/v1",
+      "description": "Identifies this record as a theme in the openpresentation.org catalog."
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "description": "Stable slug used by OPF documents to reference this theme via design.theme. Lowercase kebab-case.",
+      "examples": [
+        "minimal",
+        "classic",
+        "dark",
+        "bold"
+      ]
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable theme name shown in pickers.",
+      "examples": [
+        "Minimal",
+        "Classic",
+        "Dark",
+        "Bold"
+      ]
+    },
+    "summary": {
+      "type": "string",
+      "description": "One-sentence positioning of the theme — when to reach for it.",
+      "examples": [
+        "A clean, minimalist theme for professional, straightforward presentations.",
+        "A rich dark-mode theme with bold contrast and modern style."
+      ]
+    },
+    "description": {
+      "type": "string",
+      "description": "Longer prose describing what the theme looks and feels like and the kinds of decks it suits.",
+      "examples": [
+        "A clean, minimalistic theme with a focus on simplicity and readability. Ideal for professional, straightforward presentations."
+      ]
+    },
+    "colorScheme": {
+      "type": "string",
+      "description": "Catalog reference to the theme's default color scheme — resolved against catalogs.colorSchemes the same way design.colorScheme or design.colorScheme.id is. Accepts a bare id, HTTPS URL, or 'pkg:' reference.",
+      "examples": [
+        "cool-horizon",
+        "boost",
+        "burnt-orange"
+      ]
+    },
+    "fontScheme": {
+      "type": "string",
+      "description": "Catalog reference to the theme's default font scheme — resolved against catalogs.fontSchemes the same way design.fontScheme or design.fontScheme.id is. Accepts a bare id, HTTPS URL, or 'pkg:' reference.",
+      "examples": [
+        "aptos",
+        "tenorite",
+        "seaford",
+        "impact"
+      ]
+    },
+    "background": {
+      "$ref": "#/$defs/ThemeBackground"
+    },
+    "dimensions": {
+      "type": "string",
+      "enum": ["16:9", "4:3", "16:10", "letter", "a4", "widescreen", "standard"],
+      "description": "Default slide size for this theme. Accepts the same preset values as design.dimensions.preset.",
+      "examples": [
+        "16:9",
+        "4:3",
+        "16:10",
+        "letter",
+        "a4",
+        "widescreen",
+        "standard"
+      ]
+    },
+    "tags": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Free-form labels for filtering and search.",
+      "examples": [
+        [
+          "minimal",
+          "professional"
+        ],
+        [
+          "bold",
+          "high-impact"
+        ]
+      ]
+    },
+    "preview": {
+      "type": "object",
+      "description": "Visual previews of the record, used by picker UIs and inline rendering. All sub-fields are optional; engines fall back gracefully when previews aren't available.",
+      "properties": {
+        "src": {
+          "type": "string",
+          "format": "uri",
+          "description": "Main preview image (PNG/JPG). Used as the primary visual in picker UIs and previews of the record.",
+          "examples": [
+            "https://www.pptx.gallery/themes/minimal.png"
+          ]
+        },
+        "thumbnailSrc": {
+          "type": "string",
+          "format": "uri",
+          "description": "Smaller thumbnail preview suited to dense grid views.",
+          "examples": [
+            "https://www.pptx.gallery/themes/minimal.thumbnail.png"
+          ]
+        },
+        "vectorSrc": {
+          "type": "string",
+          "format": "uri",
+          "description": "SVG / vector preview for crisp scaling at any size.",
+          "examples": [
+            "https://www.pptx.gallery/themes/minimal.svg"
+          ]
+        }
+      }
+    }
+  },
+  "$defs": {
+    "ThemeBackgroundSlot": {
+      "type": "string",
+      "description": "PowerPoint theme-controlled slide background slot from the active color scheme. These are slots, not assumptions about actual colors: light1 is usually white and dark1 is usually black by convention, but the color scheme controls the real values.",
+      "enum": [
+        "light1",
+        "light2",
+        "dark1",
+        "dark2"
+      ]
+    },
+    "ThemeBackground": {
+      "type": "object",
+      "description": "Theme-controlled PowerPoint slide background. The slot is resolved through the active color scheme and remains theme-aware.",
+      "required": [
+        "type",
+        "slot"
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "theme",
+          "description": "Theme-controlled background fill."
+        },
+        "slot": {
+          "$ref": "#/$defs/ThemeBackgroundSlot"
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,146 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openpresentation.org/schema/opf-tone/v1",
+  "title": "OPF Tone",
+  "description": "Schema for tone records in the pptx.gallery library. Each record names a presentation tone (e.g. 'formal', 'casual', 'inspirational') and carries voice cues, anti-patterns, and sample phrases that AI-driven generation uses to shape output. Tones are referenced from OPF documents via tone; the engine resolves the reference against catalogs.tones (inline) → catalogs.tones.source → the default catalog at https://www.pptx.gallery/tones.",
+  "type": "object",
+  "required": [
+    "$schema",
+    "id",
+    "name"
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "const": "https://openpresentation.org/schema/opf-tone/v1",
+      "description": "Identifies this record as a tone in the openpresentation.org catalog."
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "description": "Stable slug used by OPF documents to reference this tone via tone. Lowercase kebab-case.",
+      "examples": [
+        "formal",
+        "casual",
+        "inspirational",
+        "technical",
+        "persuasive",
+        "authoritative",
+        "conversational"
+      ]
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable tone name shown in pickers.",
+      "examples": [
+        "Formal",
+        "Casual",
+        "Inspirational",
+        "Technical",
+        "Persuasive",
+        "Authoritative",
+        "Conversational"
+      ]
+    },
+    "summary": {
+      "type": "string",
+      "description": "One-sentence positioning of the tone — when to reach for it.",
+      "examples": [
+        "Polished, restrained voice for board, investor, and regulator audiences.",
+        "Warm, plain-spoken voice for internal updates and customer storytelling."
+      ]
+    },
+    "description": {
+      "type": "string",
+      "description": "Longer prose describing the tone and the kinds of decks it suits.",
+      "examples": [
+        "Authoritative without being cold. Use third-person constructions, full sentences, and concrete numbers. Avoid hedges and humor that depend on shared in-jokes; rely on clarity and precision to land."
+      ]
+    },
+    "voiceCues": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Short directives that shape AI generation toward this tone. Phrased as imperatives, e.g. 'use second-person', 'favor short sentences', 'lead with the recommendation'.",
+      "examples": [
+        [
+          "Use third person.",
+          "Lead with the recommendation, then evidence.",
+          "Quote concrete numbers; avoid round-tripping ranges."
+        ]
+      ]
+    },
+    "avoid": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Anti-patterns that AI generation should not produce when this tone is active.",
+      "examples": [
+        [
+          "Slang, idioms, or in-jokes.",
+          "Hedging language ('maybe', 'sort of', 'I think').",
+          "Marketing superlatives ('world-class', 'best-in-class')."
+        ]
+      ]
+    },
+    "samplePhrases": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Short example phrases that exemplify this tone. Used by picker UIs and as few-shot examples for AI generation.",
+      "examples": [
+        [
+          "Q4 revenue grew 18% year over year, led by enterprise expansion.",
+          "We recommend approving the Series B raise at $30M.",
+          "Net retention was 124%; gross retention was 96%."
+        ]
+      ]
+    },
+    "recommendedNarratives": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Soft cross-link: narrative-catalog ids this tone pairs well with. Used by picker UIs to suggest narratives once a tone is chosen. Validators warn on unknown ids; never error.",
+      "examples": [
+        ["board-meeting", "qbr", "scqa"]
+      ]
+    },
+    "tags": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Free-form labels for filtering and search.",
+      "examples": [
+        ["business", "executive"],
+        ["internal", "warm"],
+        ["motivational", "keynote"]
+      ]
+    },
+    "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."
+        }
+      }
+    }
+  }
+}