@openpresentation/opf 0.1.0 → 0.2.1

package/dist/spec/catalogs/narratives/rags-to-riches.json

@@ -1,80 +1,80 @@
-{
-  "$schema": "https://openpresentation.org/schema/opf-narrative/v1",
-  "id": "rags-to-riches",
-  "name": "Rags to Riches",
-  "summary": "Underdog journey from initial failure to eventual success. Pulls on resilience, grit, and perseverance — useful for founder stories, brand stories, and any deck where the audience needs to feel the cost behind the win.",
-  "audienceFit": [
-    "general-audience",
-    "customers",
-    "press",
-    "candidates"
-  ],
-  "durationRange": {
-    "minMinutes": 5,
-    "maxMinutes": 20
-  },
-  "tags": [
-    "storytelling",
-    "founder",
-    "brand",
-    "inspirational"
-  ],
-  "beats": [
-    {
-      "id": "origin",
-      "name": "Origin",
-      "description": "Start at the bottom. Describe the humble beginning, the constraint, the moment before anything had been built. Concrete details — a place, a year, a feeling — earn the audience's investment in what follows.",
-      "instructions": "Humble beginning",
-      "slideType": "text",
-      "layoutHint": "text-1x-left"
-    },
-    {
-      "id": "inspiration",
-      "name": "Inspiration",
-      "description": "Show the moment the protagonist found their calling. A conversation, a customer, a problem they couldn't unsee. The inspiration is the engine that pushes the rest of the story uphill.",
-      "instructions": "Discover true calling",
-      "slideType": "text",
-      "layoutHint": "text-1x-left"
-    },
-    {
-      "id": "opportunity",
-      "name": "Opportunity",
-      "description": "Reveal the chance the protagonist took. Why this and not something safer? Make the choice visible — opportunities only count when there was something else they passed up to grab them.",
-      "instructions": "Spot golden chance",
-      "slideType": "text",
-      "layoutHint": "text-1x-left"
-    },
-    {
-      "id": "adversity",
-      "name": "Adversity",
-      "description": "Walk through the hardest stretch. Concrete failures, near-misses, moments of doubt. Resist the temptation to skip past the pain — the audience trusts the win more when the loss was real.",
-      "instructions": "Face hardest struggles",
-      "slideType": "text",
-      "layoutHint": "text-1x-left"
-    },
-    {
-      "id": "overcoming",
-      "name": "Overcoming",
-      "description": "Show how the obstacles got beaten. What changed, what was learned, what hard call was made. The transition from 'rags' to 'riches' should feel earned, not granted.",
-      "instructions": "Surmount tough obstacles",
-      "slideType": "text",
-      "layoutHint": "text-1x-left"
-    },
-    {
-      "id": "impactful-change",
-      "name": "Impactful Change",
-      "description": "Describe the moment the world tipped. The customer who said yes, the product that broke through, the metric that turned. One concrete transformation lands harder than a montage.",
-      "instructions": "Alter the status quo",
-      "slideType": "text",
-      "layoutHint": "text-1x-left"
-    },
-    {
-      "id": "lasting-legacy",
-      "name": "Lasting Legacy",
-      "description": "Close on what the journey means for those who come next. The lesson, the people changed, the work that endures. Leave the audience with a takeaway that outlives the story.",
-      "layoutHint": "title-left",
-      "instructions": "Create enduring effect",
-      "slideType": "text"
-    }
-  ]
-}
+{
+  "$schema": "https://openpresentation.org/schema/opf-narrative/v1",
+  "id": "rags-to-riches",
+  "name": "Rags to Riches",
+  "summary": "Underdog journey from initial failure to eventual success. Pulls on resilience, grit, and perseverance — useful for founder stories, brand stories, and any deck where the audience needs to feel the cost behind the win.",
+  "audienceFit": [
+    "general-audience",
+    "customers",
+    "press",
+    "candidates"
+  ],
+  "durationRange": {
+    "minMinutes": 5,
+    "maxMinutes": 20
+  },
+  "tags": [
+    "storytelling",
+    "founder",
+    "brand",
+    "inspirational"
+  ],
+  "beats": [
+    {
+      "id": "origin",
+      "name": "Origin",
+      "description": "Start at the bottom. Describe the humble beginning, the constraint, the moment before anything had been built. Concrete details — a place, a year, a feeling — earn the audience's investment in what follows.",
+      "instructions": "Humble beginning",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "inspiration",
+      "name": "Inspiration",
+      "description": "Show the moment the protagonist found their calling. A conversation, a customer, a problem they couldn't unsee. The inspiration is the engine that pushes the rest of the story uphill.",
+      "instructions": "Discover true calling",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "opportunity",
+      "name": "Opportunity",
+      "description": "Reveal the chance the protagonist took. Why this and not something safer? Make the choice visible — opportunities only count when there was something else they passed up to grab them.",
+      "instructions": "Spot golden chance",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "adversity",
+      "name": "Adversity",
+      "description": "Walk through the hardest stretch. Concrete failures, near-misses, moments of doubt. Resist the temptation to skip past the pain — the audience trusts the win more when the loss was real.",
+      "instructions": "Face hardest struggles",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "overcoming",
+      "name": "Overcoming",
+      "description": "Show how the obstacles got beaten. What changed, what was learned, what hard call was made. The transition from 'rags' to 'riches' should feel earned, not granted.",
+      "instructions": "Surmount tough obstacles",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "impactful-change",
+      "name": "Impactful Change",
+      "description": "Describe the moment the world tipped. The customer who said yes, the product that broke through, the metric that turned. One concrete transformation lands harder than a montage.",
+      "instructions": "Alter the status quo",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "lasting-legacy",
+      "name": "Lasting Legacy",
+      "description": "Close on what the journey means for those who come next. The lesson, the people changed, the work that endures. Leave the audience with a takeaway that outlives the story.",
+      "layoutHint": "title-left",
+      "instructions": "Create enduring effect",
+      "slideType": "text"
+    }
+  ]
+}

package/dist/spec/catalogs/narratives/reveal.json

@@ -1,87 +1,87 @@
-{
-  "$schema": "https://openpresentation.org/schema/opf-narrative/v1",
-  "id": "reveal",
-  "name": "Reveal",
-  "summary": "Insight-driven keynote arc inspired by Amy Cuddy's 2012 talk on body language: connect through personal story, ground in research, illustrate with anecdote, summarize, break stereotypes, advise, demonstrate authenticity, close with impact. For talks that aim to change how the audience sees something they thought they understood.",
-  "audienceFit": [
-    "general-audience",
-    "academics",
-    "professionals"
-  ],
-  "durationRange": {
-    "minMinutes": 15,
-    "maxMinutes": 25
-  },
-  "tags": [
-    "keynote",
-    "research",
-    "talk",
-    "inspirational"
-  ],
-  "beats": [
-    {
-      "id": "personal-story",
-      "name": "Personal Story",
-      "description": "Open with a personal experience that establishes why the topic matters to you. Specificity earns intimacy; intimacy earns the audience's permission to be moved.",
-      "instructions": "Share personal experiences to connect with the audience",
-      "slideType": "text",
-      "layoutHint": "text-1x-left"
-    },
-    {
-      "id": "research-exposition",
-      "name": "Research Exposition",
-      "description": "Lay out the scientific or empirical data that backs the premise. Be rigorous but not academic — the audience needs to understand the evidence well enough to defend it later.",
-      "instructions": "Unravel scientific data backing the premise",
-      "slideType": "text",
-      "layoutHint": "text-1x-left"
-    },
-    {
-      "id": "real-life-anecdote",
-      "name": "Real-Life Anecdote",
-      "description": "Illustrate the research with a story from the field. Make the abstract finding feel like something that happens to people the audience could imagine being.",
-      "instructions": "Illustrate with stories to make the point relatable",
-      "slideType": "text",
-      "layoutHint": "text-1x-left"
-    },
-    {
-      "id": "critical-insights",
-      "name": "Critical Insights",
-      "description": "Summarize the two or three findings the audience must walk away with. Distill them into language a non-specialist could repeat without distortion.",
-      "instructions": "Summarize key points",
-      "slideType": "text",
-      "layoutHint": "text-1x-left"
-    },
-    {
-      "id": "break-stereotypes",
-      "name": "Break Stereotypes",
-      "description": "Question redundant norms or beliefs the research undermines. Be specific about what's being challenged so the audience knows what to update.",
-      "instructions": "Question redundant norms and belief systems",
-      "slideType": "text",
-      "layoutHint": "text-1x-left"
-    },
-    {
-      "id": "empowering-advice",
-      "name": "Empowering Advice",
-      "description": "Translate the insights into a small, actionable practice. The advice should be doable today, not only next quarter — the goal is movement, not aspiration.",
-      "instructions": "Motivational message to act upon",
-      "slideType": "text",
-      "layoutHint": "text-1x-left"
-    },
-    {
-      "id": "authenticity",
-      "name": "Authenticity",
-      "description": "Speak honestly about your own struggle with the topic. Vulnerability, used with restraint, is what turns research into a felt truth.",
-      "instructions": "Honest and real communication to demonstrate authenticity",
-      "slideType": "text",
-      "layoutHint": "text-1x-left"
-    },
-    {
-      "id": "close-with-impact",
-      "name": "Close With Impact",
-      "description": "End on a motivational high — the line, image, or invitation you want to follow the audience out of the room. Close the talk where it began, transformed.",
-      "layoutHint": "title-left",
-      "instructions": "End on a motivational high",
-      "slideType": "text"
-    }
-  ]
-}
+{
+  "$schema": "https://openpresentation.org/schema/opf-narrative/v1",
+  "id": "reveal",
+  "name": "Reveal",
+  "summary": "Insight-driven keynote arc inspired by Amy Cuddy's 2012 talk on body language: connect through personal story, ground in research, illustrate with anecdote, summarize, break stereotypes, advise, demonstrate authenticity, close with impact. For talks that aim to change how the audience sees something they thought they understood.",
+  "audienceFit": [
+    "general-audience",
+    "academics",
+    "professionals"
+  ],
+  "durationRange": {
+    "minMinutes": 15,
+    "maxMinutes": 25
+  },
+  "tags": [
+    "keynote",
+    "research",
+    "talk",
+    "inspirational"
+  ],
+  "beats": [
+    {
+      "id": "personal-story",
+      "name": "Personal Story",
+      "description": "Open with a personal experience that establishes why the topic matters to you. Specificity earns intimacy; intimacy earns the audience's permission to be moved.",
+      "instructions": "Share personal experiences to connect with the audience",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "research-exposition",
+      "name": "Research Exposition",
+      "description": "Lay out the scientific or empirical data that backs the premise. Be rigorous but not academic — the audience needs to understand the evidence well enough to defend it later.",
+      "instructions": "Unravel scientific data backing the premise",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "real-life-anecdote",
+      "name": "Real-Life Anecdote",
+      "description": "Illustrate the research with a story from the field. Make the abstract finding feel like something that happens to people the audience could imagine being.",
+      "instructions": "Illustrate with stories to make the point relatable",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "critical-insights",
+      "name": "Critical Insights",
+      "description": "Summarize the two or three findings the audience must walk away with. Distill them into language a non-specialist could repeat without distortion.",
+      "instructions": "Summarize key points",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "break-stereotypes",
+      "name": "Break Stereotypes",
+      "description": "Question redundant norms or beliefs the research undermines. Be specific about what's being challenged so the audience knows what to update.",
+      "instructions": "Question redundant norms and belief systems",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "empowering-advice",
+      "name": "Empowering Advice",
+      "description": "Translate the insights into a small, actionable practice. The advice should be doable today, not only next quarter — the goal is movement, not aspiration.",
+      "instructions": "Motivational message to act upon",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "authenticity",
+      "name": "Authenticity",
+      "description": "Speak honestly about your own struggle with the topic. Vulnerability, used with restraint, is what turns research into a felt truth.",
+      "instructions": "Honest and real communication to demonstrate authenticity",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "close-with-impact",
+      "name": "Close With Impact",
+      "description": "End on a motivational high — the line, image, or invitation you want to follow the audience out of the room. Close the talk where it began, transformed.",
+      "layoutHint": "title-left",
+      "instructions": "End on a motivational high",
+      "slideType": "text"
+    }
+  ]
+}

package/dist/spec/catalogs/narratives/scqa.json

@@ -1,55 +1,55 @@
-{
-  "$schema": "https://openpresentation.org/schema/opf-narrative/v1",
-  "id": "scqa",
-  "name": "SCQA (Situation–Complication–Question–Answer)",
-  "summary": "Barbara Minto's pyramid-principle arc: surface the recommendation up front, then layer key arguments and supporting evidence beneath it. The default for executive memos, strategic recommendations, and consulting decks where the audience needs the answer fast.",
-  "audienceFit": [
-    "executives",
-    "boards",
-    "leadership-teams"
-  ],
-  "durationRange": {
-    "minMinutes": 5,
-    "maxMinutes": 20
-  },
-  "tags": [
-    "executive",
-    "strategy",
-    "consulting",
-    "minto",
-    "pyramid"
-  ],
-  "beats": [
-    {
-      "id": "situation",
-      "name": "Situation",
-      "description": "Establish the shared context: what is true today that the audience already agrees on. State only facts the audience accepts without argument. The goal is alignment, not persuasion — you are setting the stage."
-    },
-    {
-      "id": "complication",
-      "name": "Complication",
-      "description": "Introduce the disturbance to the situation: what changed, what is at risk, what is no longer working. This is the tension that makes the audience lean in. Be specific and quantify the change where possible."
-    },
-    {
-      "id": "question",
-      "name": "Key Question",
-      "description": "Surface the question the complication forces the audience to answer. Frame it explicitly — 'Should we…?', 'How do we…?', 'What changes if…?'. The question should feel inevitable given the complication."
-    },
-    {
-      "id": "answer",
-      "name": "Answer",
-      "description": "Deliver the recommendation in a single sentence, up front. No arguments yet, no caveats — just the conclusion the rest of the deck will defend. This is the apex of the Minto pyramid; everything that follows supports it.",
-      "layoutHint": "title-left"
-    },
-    {
-      "id": "key-arguments",
-      "name": "Key Arguments",
-      "description": "Lay out the two or three top-level reasons the answer is correct. One slide per argument, or one summary slide naming all of them. Each argument should stand alone as a compelling reason; together they should be exhaustive of the case."
-    },
-    {
-      "id": "supporting-evidence",
-      "name": "Supporting Evidence",
-      "description": "Present the data, examples, and case studies that ground each argument. Pyramid-principle style: every claim above is backed by something verifiable here. Cite sources; show the numbers; let the evidence carry the weight."
-    }
-  ]
-}
+{
+  "$schema": "https://openpresentation.org/schema/opf-narrative/v1",
+  "id": "scqa",
+  "name": "SCQA (Situation–Complication–Question–Answer)",
+  "summary": "Barbara Minto's pyramid-principle arc: surface the recommendation up front, then layer key arguments and supporting evidence beneath it. The default for executive memos, strategic recommendations, and consulting decks where the audience needs the answer fast.",
+  "audienceFit": [
+    "executives",
+    "boards",
+    "leadership-teams"
+  ],
+  "durationRange": {
+    "minMinutes": 5,
+    "maxMinutes": 20
+  },
+  "tags": [
+    "executive",
+    "strategy",
+    "consulting",
+    "minto",
+    "pyramid"
+  ],
+  "beats": [
+    {
+      "id": "situation",
+      "name": "Situation",
+      "description": "Establish the shared context: what is true today that the audience already agrees on. State only facts the audience accepts without argument. The goal is alignment, not persuasion — you are setting the stage."
+    },
+    {
+      "id": "complication",
+      "name": "Complication",
+      "description": "Introduce the disturbance to the situation: what changed, what is at risk, what is no longer working. This is the tension that makes the audience lean in. Be specific and quantify the change where possible."
+    },
+    {
+      "id": "question",
+      "name": "Key Question",
+      "description": "Surface the question the complication forces the audience to answer. Frame it explicitly — 'Should we…?', 'How do we…?', 'What changes if…?'. The question should feel inevitable given the complication."
+    },
+    {
+      "id": "answer",
+      "name": "Answer",
+      "description": "Deliver the recommendation in a single sentence, up front. No arguments yet, no caveats — just the conclusion the rest of the deck will defend. This is the apex of the Minto pyramid; everything that follows supports it.",
+      "layoutHint": "title-left"
+    },
+    {
+      "id": "key-arguments",
+      "name": "Key Arguments",
+      "description": "Lay out the two or three top-level reasons the answer is correct. One slide per argument, or one summary slide naming all of them. Each argument should stand alone as a compelling reason; together they should be exhaustive of the case."
+    },
+    {
+      "id": "supporting-evidence",
+      "name": "Supporting Evidence",
+      "description": "Present the data, examples, and case studies that ground each argument. Pyramid-principle style: every claim above is backed by something verifiable here. Cite sources; show the numbers; let the evidence carry the weight."
+    }
+  ]
+}

package/dist/spec/catalogs/narratives/status-update.json

@@ -1,72 +1,72 @@
-{
-  "$schema": "https://openpresentation.org/schema/opf-narrative/v1",
-  "id": "status-update",
-  "name": "Status Update",
-  "summary": "Concise progress-report arc for keeping a stakeholder informed: headline, brief, progress, results, plan, feedback. Optimized for short, repeated updates rather than one-time deep dives.",
-  "audienceFit": [
-    "stakeholders",
-    "managers",
-    "customers",
-    "executives"
-  ],
-  "durationRange": {
-    "minMinutes": 5,
-    "maxMinutes": 15
-  },
-  "tags": [
-    "reporting",
-    "operations",
-    "customer-relationship",
-    "weekly"
-  ],
-  "beats": [
-    {
-      "id": "headline",
-      "name": "Headline",
-      "description": "Open with the single most important sentence the audience needs to know — on track, off track, or shifted. The headline replaces 'how's it going' with a clear answer.",
-      "layoutHint": "title-left",
-      "instructions": "Title & date",
-      "slideType": "text"
-    },
-    {
-      "id": "brief",
-      "name": "Brief",
-      "description": "State the objective for the period and what was promised. One slide, three lines. Frames the rest of the update so progress is read against a clear bar.",
-      "instructions": "Summary/objectives",
-      "slideType": "text",
-      "layoutHint": "text-1x-left"
-    },
-    {
-      "id": "progress",
-      "name": "Progress",
-      "description": "Walk through the actions taken since the last update. Specific, attributable, dated. Avoid effort theater — list outcomes and material moves, not activity for its own sake.",
-      "instructions": "Explain actions taken",
-      "slideType": "text",
-      "layoutHint": "text-1x-left"
-    },
-    {
-      "id": "results",
-      "name": "Results",
-      "description": "Show the outcomes those actions produced. Metrics, customer signals, decisions made. Keep the comparison crisp — versus plan, versus last period, versus benchmark.",
-      "instructions": "Show outcomes",
-      "slideType": "text",
-      "layoutHint": "text-1x-left"
-    },
-    {
-      "id": "action-plan",
-      "name": "Action Plan",
-      "description": "Outline the next steps and who owns them. Be specific about the next decision point and what would have to happen to slip the schedule.",
-      "instructions": "Outline next steps",
-      "slideType": "text",
-      "layoutHint": "text-1x-left"
-    },
-    {
-      "id": "feedback",
-      "name": "Feedback",
-      "description": "Invite the audience to weigh in: where you'd like input, where you need a decision, where help would unblock you. End the update with an open hand, not a closed file.",
-      "layoutHint": "title-left",
-      "instructions": "Ask for response",
-      "slideType": "text"
-    }
-  ]
-}
+{
+  "$schema": "https://openpresentation.org/schema/opf-narrative/v1",
+  "id": "status-update",
+  "name": "Status Update",
+  "summary": "Concise progress-report arc for keeping a stakeholder informed: headline, brief, progress, results, plan, feedback. Optimized for short, repeated updates rather than one-time deep dives.",
+  "audienceFit": [
+    "stakeholders",
+    "managers",
+    "customers",
+    "executives"
+  ],
+  "durationRange": {
+    "minMinutes": 5,
+    "maxMinutes": 15
+  },
+  "tags": [
+    "reporting",
+    "operations",
+    "customer-relationship",
+    "weekly"
+  ],
+  "beats": [
+    {
+      "id": "headline",
+      "name": "Headline",
+      "description": "Open with the single most important sentence the audience needs to know — on track, off track, or shifted. The headline replaces 'how's it going' with a clear answer.",
+      "layoutHint": "title-left",
+      "instructions": "Title & date",
+      "slideType": "text"
+    },
+    {
+      "id": "brief",
+      "name": "Brief",
+      "description": "State the objective for the period and what was promised. One slide, three lines. Frames the rest of the update so progress is read against a clear bar.",
+      "instructions": "Summary/objectives",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "progress",
+      "name": "Progress",
+      "description": "Walk through the actions taken since the last update. Specific, attributable, dated. Avoid effort theater — list outcomes and material moves, not activity for its own sake.",
+      "instructions": "Explain actions taken",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "results",
+      "name": "Results",
+      "description": "Show the outcomes those actions produced. Metrics, customer signals, decisions made. Keep the comparison crisp — versus plan, versus last period, versus benchmark.",
+      "instructions": "Show outcomes",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "action-plan",
+      "name": "Action Plan",
+      "description": "Outline the next steps and who owns them. Be specific about the next decision point and what would have to happen to slip the schedule.",
+      "instructions": "Outline next steps",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "feedback",
+      "name": "Feedback",
+      "description": "Invite the audience to weigh in: where you'd like input, where you need a decision, where help would unblock you. End the update with an open hand, not a closed file.",
+      "layoutHint": "title-left",
+      "instructions": "Ask for response",
+      "slideType": "text"
+    }
+  ]
+}