@lofcz/pptist 2.0.12 → 2.0.14

package/dist/types/embed/agentic/layouts.d.ts

@@ -1,20 +1,3 @@
-/**
- * Compositional slide layouts for the agentic bridge.
- *
- * A "layout" is a named, pre-composed slide recipe (title, bullets, two-column,
- * image+text, big stat, quote, chart, comparison, …). The agent picks a layout
- * by id and fills a few content *slots*; the builder here lays out themed,
- * contrast-safe elements using the active style preset's role tokens and a
- * fixed margin grid. This is the preferred way to add slides — it removes the
- * need to hand-place boxes or hand-pick colors/sizes, and it never emits raw
- * authoring HTML the agent has to reason about.
- *
- * Builders are deterministic and pure (no async, no store access): given a
- * viewport, a style preset, and slots, they return a `Partial<Slide>` that the
- * bridge normalizes and inserts. Text content is rendered to the small, safe
- * HTML subset PPTist stores (`<p>/<ul>/<li>/<span style>` with inline size and
- * color), with light inline markdown (`**bold**`, `_italic_`, `` `code` ``).
- */
 import type { PPTChartElement, PPTImageElement, PPTShapeElement, PPTTableElement, PPTTextElement, Slide } from '../../types/slides';
 import type { PptistStylePreset } from './styles';
 /**
@@ -62,8 +45,9 @@ export interface PptistLayoutBuildResult {
 /**
  * Build a themed slide from a layout id + content slots. Pure and deterministic:
  * returns a `Partial<Slide>` (background + un-normalized elements) plus any
- * non-fatal warnings (e.g. a missing optional image). Throws on missing
- * required slots or an unknown layout.
+ * non-fatal warnings (e.g. a missing optional image). Text is auto-fit to each
+ * box via pretext, so content never overflows. Throws on missing required slots
+ * or an unknown layout.
  */
 export declare function buildLayoutSlide(layoutId: string, slots: Slots, preset: PptistStylePreset, viewport: {
     width: number;

package/dist/types/embed/agentic/types.d.ts

@@ -3,9 +3,13 @@ import type { ShapeCategoryKey, ShapePoolItem } from '../../configs/shapes';
 import type { Broken2LineDirection, ChartData, ChartOptions, ChartType, Gradient, LinePoint, LineStyleType, Note, NoteReply, PPTAnimation, PPTAudioElement, PPTChartElement, PPTElement, PPTElementLink, PPTElementOutline, PPTElementShadow, PPTImageElement, PPTLatexElement, PPTLineElement, PPTShapeElement, PPTTableElement, PPTTextElement, PPTVideoElement, ShapeText, Slide, SlideBackground, SlideTemplate, SlideTheme, TableCell, TableCellStyle, TextAlign, TurningMode } from '../../types/slides';
 import type { PptistDocument } from '../types';
 import type { PptistTemplateSlidesCatalogResult, PptistTemplateSummary } from './templates';
+import type { PptistLayout, PptistLayoutBackgroundMode } from './layouts';
+import type { PptistStyleSummary } from './styles';
 import type { PptistAgenticDocs, PptistCommandDescription, PptistDesignGuide, PptistDomainSummary } from './manifestDocs';
 export type { PptistAgenticDocs, PptistCommandDescription, PptistCommandDoc, PptistDesignGuide, PptistDesignSystem, PptistDocParam, PptistDomainDoc, PptistDomainSummary, } from './manifestDocs';
 export type { PptistTemplateSummary, PptistTemplateSlideEntry, PptistTemplateSlidesCatalog, PptistTemplateSlidesCatalogResult, } from './templates';
+export type { PptistLayout, PptistLayoutSlotDef, PptistLayoutBackgroundMode, } from './layouts';
+export type { PptistStyleSummary, PptistStylePreset, PptistStylePalette, PptistStyleScale, PptistStyleFonts, } from './styles';
 export type PptistKnownCommandType = keyof PptistCommandPayloadMap;
 export type PptistCommandType = PptistKnownCommandType | (string & {});
 export interface PptistDeckViewport {
@@ -450,6 +454,35 @@ export interface PptistAgentTemplatesApi {
     /** List insertable slides for a template, grouped by type (cover, contents, …). */
     slidesCatalog(templateId: string, meta?: PptistCommandMeta): Promise<PptistCommandResult<PptistTemplateSlidesCatalogResult>>;
 }
+export interface PptistApplyStyleResult {
+    /** The preset id actually applied (the requested one, or the default fallback). */
+    styleId: string;
+    theme: SlideTheme;
+}
+export interface PptistCreateFromLayoutInput {
+    /** Layout id from `layouts.catalog` (e.g. `title`, `bullets`, `twoColumn`). */
+    layoutId: string;
+    /** Content slots for the layout. Keys + shapes are described per layout in the catalog. */
+    slots?: Record<string, unknown>;
+    index?: number;
+    select?: boolean;
+    /** Force a feature (dark) or plain background; defaults to the layout's own preference. */
+    backgroundMode?: PptistLayoutBackgroundMode;
+}
+export interface PptistCreateFromLayoutResult {
+    slideId: string;
+    layoutId: string;
+    elementIds: string[];
+    textElementIds: string[];
+}
+export interface PptistAgentStylesApi {
+    /** List the contrast-safe visual identity presets (academic/minimal/bold/playful). */
+    catalog(): PptistStyleSummary[];
+}
+export interface PptistAgentLayoutsApi {
+    /** List the compositional slide recipes and their content slots. */
+    catalog(): PptistLayout[];
+}
 export interface PptistAgentDeckApi {
     get(): PptistDeckDocument;
     set(document: PptistDeckInput, meta?: PptistCommandMeta): Promise<PptistCommandResult<PptistDeckDocument>>;
@@ -460,6 +493,8 @@ export interface PptistAgentDeckApi {
     getTheme(): SlideTheme;
     setTheme(theme: PptistSlideThemePatch, meta?: PptistCommandMeta): Promise<PptistCommandResult<SlideTheme>>;
     applyTemplate(templateId: string, meta?: PptistCommandMeta): Promise<PptistCommandResult<PptistApplyTemplateResult>>;
+    /** Apply a style preset (from `styles.catalog`) as the deck's visual identity; records `theme.styleId`. */
+    applyStyle(styleId: string, meta?: PptistCommandMeta): Promise<PptistCommandResult<PptistApplyStyleResult>>;
     applyTheme(theme: PptistSlideThemePatch, options?: PptistApplyThemeOptions, meta?: PptistCommandMeta): Promise<PptistCommandResult<SlideTheme>>;
     extractTheme(options?: PptistThemeExtractionOptions): SlideTheme;
     setViewport(viewport: {
@@ -474,6 +509,8 @@ export interface PptistAgentSlidesApi {
     current(): Slide | null;
     read(slideIdOrIndex?: PptistSlideReference, meta?: PptistCommandMeta): Promise<PptistCommandResult<Slide | null>>;
     create(input?: PptistCreateSlideInput, meta?: PptistCommandMeta): Promise<PptistCommandResult<Slide>>;
+    /** Build + insert a themed slide from a layout recipe (from `layouts.catalog`) using the active style preset. */
+    createFromLayout(input: PptistCreateFromLayoutInput, meta?: PptistCommandMeta): Promise<PptistCommandResult<PptistCreateFromLayoutResult>>;
     insertFromTemplate(input: PptistInsertFromTemplateInput, meta?: PptistCommandMeta): Promise<PptistCommandResult<PptistInsertFromTemplateResult>>;
     insert(input: PptistInsertSlidesInput, meta?: PptistCommandMeta): Promise<PptistCommandResult<PptistInsertSlidesResult>>;
     update(slideId: string, patch: Partial<Slide>, meta?: PptistCommandMeta): Promise<PptistCommandResult<Slide>>;
@@ -1015,6 +1052,8 @@ export interface PptistAgentApi {
     deck: PptistAgentDeckApi;
     slides: PptistAgentSlidesApi;
     templates: PptistAgentTemplatesApi;
+    styles: PptistAgentStylesApi;
+    layouts: PptistAgentLayoutsApi;
     elements: PptistAgentElementsApi;
     text: PptistAgentTextApi;
     shapes: PptistAgentShapesApi;
@@ -1055,6 +1094,9 @@ export interface PptistCommandPayloadMap {
     'deck.applyTemplate': {
         templateId: string;
     };
+    'deck.applyStyle': {
+        styleId: string;
+    };
     'deck.extractTheme': {
         options?: PptistThemeExtractionOptions;
     } | undefined;
@@ -1069,6 +1111,8 @@ export interface PptistCommandPayloadMap {
     'templates.slidesCatalog': {
         templateId: string;
     };
+    'styles.catalog': undefined;
+    'layouts.catalog': undefined;
     'import.json': PptistDocumentImportPayload;
     'import.pptist': PptistDocumentImportPayload;
     'import.pptxSafe': PptistDocumentImportPayload;
@@ -1083,6 +1127,7 @@ export interface PptistCommandPayloadMap {
         slideIdOrIndex?: PptistSlideReference;
     } | undefined;
     'slides.create': PptistCreateSlideInput | undefined;
+    'slides.createFromLayout': PptistCreateFromLayoutInput;
     'slides.insertFromTemplate': PptistInsertFromTemplateInput;
     'slides.insert': PptistInsertSlidesInput;
     'slides.update': {
@@ -1685,11 +1730,14 @@ export interface PptistCommandResultDataMap {
     'deck.setTheme': SlideTheme;
     'deck.applyTheme': SlideTheme;
     'deck.applyTemplate': PptistApplyTemplateResult;
+    'deck.applyStyle': PptistApplyStyleResult;
     'deck.extractTheme': SlideTheme;
     'deck.setViewport': PptistBridgeState;
     'deck.setTemplates': SlideTemplate[];
     'templates.catalog': PptistTemplateSummary[];
     'templates.slidesCatalog': PptistTemplateSlidesCatalogResult;
+    'styles.catalog': PptistStyleSummary[];
+    'layouts.catalog': PptistLayout[];
     'import.json': PptistDeckDocument;
     'import.pptist': PptistDeckDocument;
     'import.pptxSafe': PptistDeckDocument;
@@ -1699,6 +1747,7 @@ export interface PptistCommandResultDataMap {
     'slides.current': Slide | null;
     'slides.read': Slide | null;
     'slides.create': Slide;
+    'slides.createFromLayout': PptistCreateFromLayoutResult;
     'slides.insertFromTemplate': PptistInsertFromTemplateResult;
     'slides.insert': PptistInsertSlidesResult;
     'slides.update': Slide;

package/dist/types/embed/types.d.ts

@@ -39,6 +39,8 @@ export interface PptistMountOptions {
     loadDocument?: PptistDocumentLoader;
     /** Legacy demo behavior: when explicitly true, load `mocks/slides.json` instead of the starter slide. */
     loadMockOnEmpty?: boolean;
+    /** Set false when the embed host renders its own empty/loading state. */
+    showLoadingData?: boolean;
     /** Customize the default one-slide starter deck used when no existing document is loaded. */
     starterPresentation?: PptistStarterPresentationOptions;
     /** Base URL for runtime image/font assets and fallback mock decks. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lofcz/pptist",
-  "version": "2.0.12",
+  "version": "2.0.14",
   "description": "PPTist presentation editor embed bundle with a typed agentic bridge.",
   "type": "module",
   "main": "dist/embed/pptist-embed.js",