@lofcz/pptist 2.0.9 → 2.0.10

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

@@ -0,0 +1,32 @@
+import { type BuiltInTemplateId, type TemplatePayload } from '../../configs/templates';
+import type { Slide, SlideTheme, SlideType } from '../../types/slides';
+export interface PptistTemplateSummary {
+    /** Built-in id, e.g. `template_1` (Crimson landscape). */
+    id: BuiltInTemplateId | string;
+    name: string;
+    cover: string;
+    origin?: string;
+}
+export interface PptistTemplateSlideEntry {
+    /** Stable slug within this template, e.g. `cover_1`, `content_2`. */
+    slug: string;
+    type: SlideType;
+    description: string;
+    elementCount: number;
+}
+export type PptistTemplateSlidesCatalog = Record<SlideType, PptistTemplateSlideEntry[]>;
+export interface PptistTemplateSlidesCatalogResult {
+    templateId: string;
+    templateName: string;
+    slideCount: number;
+    byType: PptistTemplateSlidesCatalog;
+}
+export declare function listTemplateCatalog(): PptistTemplateSummary[];
+export declare function loadTemplatePayload(templateId: string): Promise<TemplatePayload>;
+export declare function buildTemplateSlidesCatalog(templateId: string): Promise<PptistTemplateSlidesCatalogResult>;
+export declare function resolveTemplateSlide(payload: TemplatePayload, slug: string): {
+    slide: Slide;
+    type: SlideType;
+};
+export declare function assertBuiltInTemplateId(templateId: string): asserts templateId is BuiltInTemplateId;
+export declare function templateThemePatch(payload: TemplatePayload): Partial<SlideTheme> | undefined;

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

@@ -2,12 +2,10 @@ import type { Locales } from '../../i18n/locale';
 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 { PptistStyleSummary } from './styles';
-import type { PptistLayout, PptistLayoutBackgroundMode } from './layouts';
+import type { PptistTemplateSlidesCatalogResult, PptistTemplateSummary } from './templates';
 import type { PptistAgenticDocs, PptistCommandDescription, PptistDesignGuide, PptistDomainSummary } from './manifestDocs';
 export type { PptistAgenticDocs, PptistCommandDescription, PptistCommandDoc, PptistDesignGuide, PptistDesignSystem, PptistDocParam, PptistDomainDoc, PptistDomainSummary, } from './manifestDocs';
-export type { PptistStylePreset, PptistStylePalette, PptistStyleScale, PptistStyleFonts, PptistStyleSummary, } from './styles';
-export type { PptistLayout, PptistLayoutSlotDef, PptistLayoutBackgroundMode, } from './layouts';
+export type { PptistTemplateSummary, PptistTemplateSlideEntry, PptistTemplateSlidesCatalog, PptistTemplateSlidesCatalogResult, } from './templates';
 export type PptistKnownCommandType = keyof PptistCommandPayloadMap;
 export type PptistCommandType = PptistKnownCommandType | (string & {});
 export interface PptistDeckViewport {
@@ -424,45 +422,31 @@ export interface PptistElementFlipInput {
     flipH?: boolean;
     flipV?: boolean;
 }
-export interface PptistApplyStyleOptions {
-    /** Restyle existing slide content (fonts/colors) to match the preset too. */
-    applyToSlides?: boolean;
-}
-export interface PptistApplyStyleResult {
-    styleId: string;
+export interface PptistApplyTemplateResult {
+    templateId: string;
     theme: SlideTheme;
 }
-export interface PptistCreateFromLayoutInput {
-    /** Layout id from `layouts.catalog` (e.g. `bullets`, `twoColumn`, `chart`). */
-    layout: string;
-    /** Content slots for the layout. Shapes vary per layout (see its `slots`). */
-    slots?: Record<string, unknown>;
-    /** Style preset id to use; defaults to the deck's active style. */
-    style?: string;
-    /** Insertion index (defaults to the end). */
+export interface PptistInsertFromTemplateInput {
+    /** Built-in template id from `templates.catalog` (e.g. `template_1` = Crimson landscape). */
+    templateId: string;
+    /** Slide slug from `templates.slidesCatalog` (e.g. `cover_1`, `content_2`). */
+    slug: string;
     index?: number;
-    /** Select the new slide after creating it (default true). */
     select?: boolean;
-    /** Background override: `auto` (layout default), `feature` (dark), `plain`. */
-    background?: PptistLayoutBackgroundMode;
+    /** Apply the template theme when the deck is still empty (default true). */
+    applyTemplateTheme?: boolean;
 }
-export interface PptistCreateFromLayoutResult {
+export interface PptistInsertFromTemplateResult {
     slideId: string;
+    templateId: string;
+    slug: string;
     elementIds: string[];
-    layout: string;
-    styleId: string;
 }
-export interface PptistAgentStylesApi {
-    /** List the style presets (id, label, fonts, preview colors). */
-    catalog(): PptistStyleSummary[];
-    /** Apply a preset to the deck theme (and optionally restyle existing slides). */
-    apply(style: string, options?: PptistApplyStyleOptions, meta?: PptistCommandMeta): Promise<PptistCommandResult<PptistApplyStyleResult>>;
-}
-export interface PptistAgentLayoutsApi {
-    /** List the compositional layouts with their content slots. */
-    catalog(): PptistLayout[];
-    /** Create a new themed slide from a layout id + slots. */
-    createSlide(input: PptistCreateFromLayoutInput, meta?: PptistCommandMeta): Promise<PptistCommandResult<PptistCreateFromLayoutResult>>;
+export interface PptistAgentTemplatesApi {
+    /** List built-in presentation templates (styles) shown in the template picker. */
+    catalog(): PptistTemplateSummary[];
+    /** List insertable slides for a template, grouped by type (cover, contents, …). */
+    slidesCatalog(templateId: string, meta?: PptistCommandMeta): Promise<PptistCommandResult<PptistTemplateSlidesCatalogResult>>;
 }
 export interface PptistAgentDeckApi {
     get(): PptistDeckDocument;
@@ -473,7 +457,7 @@ export interface PptistAgentDeckApi {
     }>>;
     getTheme(): SlideTheme;
     setTheme(theme: PptistSlideThemePatch, meta?: PptistCommandMeta): Promise<PptistCommandResult<SlideTheme>>;
-    applyStyle(style: string, options?: PptistApplyStyleOptions, meta?: PptistCommandMeta): Promise<PptistCommandResult<PptistApplyStyleResult>>;
+    applyTemplate(templateId: string, meta?: PptistCommandMeta): Promise<PptistCommandResult<PptistApplyTemplateResult>>;
     applyTheme(theme: PptistSlideThemePatch, options?: PptistApplyThemeOptions, meta?: PptistCommandMeta): Promise<PptistCommandResult<SlideTheme>>;
     extractTheme(options?: PptistThemeExtractionOptions): SlideTheme;
     setViewport(viewport: {
@@ -488,7 +472,7 @@ export interface PptistAgentSlidesApi {
     current(): Slide | null;
     read(slideIdOrIndex?: PptistSlideReference, meta?: PptistCommandMeta): Promise<PptistCommandResult<Slide | null>>;
     create(input?: PptistCreateSlideInput, meta?: PptistCommandMeta): Promise<PptistCommandResult<Slide>>;
-    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>>;
     delete(slideId: string | string[], meta?: PptistCommandMeta): Promise<PptistCommandResult<PptistDeleteSlidesResult>>;
@@ -1028,8 +1012,7 @@ export interface PptistAgentApi {
     guides(guideId?: string): PptistDesignGuide[] | PptistDesignGuide | null;
     deck: PptistAgentDeckApi;
     slides: PptistAgentSlidesApi;
-    styles: PptistAgentStylesApi;
-    layouts: PptistAgentLayoutsApi;
+    templates: PptistAgentTemplatesApi;
     elements: PptistAgentElementsApi;
     text: PptistAgentTextApi;
     shapes: PptistAgentShapesApi;
@@ -1067,9 +1050,8 @@ export interface PptistCommandPayloadMap {
         theme: PptistSlideThemePatch | Partial<SlideTheme>;
         options?: PptistApplyThemeOptions;
     };
-    'deck.applyStyle': {
-        style: string;
-        applyToSlides?: boolean;
+    'deck.applyTemplate': {
+        templateId: string;
     };
     'deck.extractTheme': {
         options?: PptistThemeExtractionOptions;
@@ -1081,8 +1063,10 @@ export interface PptistCommandPayloadMap {
     'deck.setTemplates': {
         templates: SlideTemplate[];
     };
-    'styles.catalog': undefined;
-    'layouts.catalog': undefined;
+    'templates.catalog': undefined;
+    'templates.slidesCatalog': {
+        templateId: string;
+    };
     'import.json': PptistDocumentImportPayload;
     'import.pptist': PptistDocumentImportPayload;
     'import.pptxSafe': PptistDocumentImportPayload;
@@ -1097,7 +1081,7 @@ export interface PptistCommandPayloadMap {
         slideIdOrIndex?: PptistSlideReference;
     } | undefined;
     'slides.create': PptistCreateSlideInput | undefined;
-    'slides.createFromLayout': PptistCreateFromLayoutInput;
+    'slides.insertFromTemplate': PptistInsertFromTemplateInput;
     'slides.insert': PptistInsertSlidesInput;
     'slides.update': {
         slideId: string;
@@ -1698,12 +1682,12 @@ export interface PptistCommandResultDataMap {
     'deck.getTheme': SlideTheme;
     'deck.setTheme': SlideTheme;
     'deck.applyTheme': SlideTheme;
-    'deck.applyStyle': PptistApplyStyleResult;
+    'deck.applyTemplate': PptistApplyTemplateResult;
     'deck.extractTheme': SlideTheme;
     'deck.setViewport': PptistBridgeState;
     'deck.setTemplates': SlideTemplate[];
-    'styles.catalog': PptistStyleSummary[];
-    'layouts.catalog': PptistLayout[];
+    'templates.catalog': PptistTemplateSummary[];
+    'templates.slidesCatalog': PptistTemplateSlidesCatalogResult;
     'import.json': PptistDeckDocument;
     'import.pptist': PptistDeckDocument;
     'import.pptxSafe': PptistDeckDocument;
@@ -1713,7 +1697,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;
     'slides.delete': PptistDeleteSlidesResult;

package/package.json

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