@lofcz/pptist 2.0.8 → 2.0.10

package/dist/types/configs/font.d.ts

@@ -1,5 +1,7 @@
-export declare const EASTERN_EXTRAS_FONT_VALUES: string[];
-export declare const FONTS: {
-    label: import("typesafe-i18n").LocalizedString;
+export interface FontOption {
+    label: string;
     value: string;
-}[];
+}
+export declare const EASTERN_EXTRAS_FONT_VALUES: string[];
+export declare function getFonts(): FontOption[];
+export declare function useFonts(): import("vue").ComputedRef<FontOption[]>;

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

@@ -0,0 +1,72 @@
+/**
+ * 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';
+/**
+ * Un-normalized element inputs the builder emits. Typed as a discriminated
+ * union of per-type partials so the engine's required fields are still checked,
+ * while letting the bridge's `normalizeElement` fill ids/defaults on insert.
+ */
+export type PptistLayoutElementInput = (Partial<PPTTextElement> & {
+    type: 'text';
+}) | (Partial<PPTShapeElement> & {
+    type: 'shape';
+}) | (Partial<PPTImageElement> & {
+    type: 'image';
+}) | (Partial<PPTChartElement> & {
+    type: 'chart';
+}) | (Partial<PPTTableElement> & {
+    type: 'table';
+});
+export type PptistLayoutBackgroundMode = 'auto' | 'feature' | 'plain';
+export interface PptistLayoutSlotDef {
+    name: string;
+    /** Coarse shape of the value the agent should pass for this slot. */
+    type: 'text' | 'bullets' | 'image' | 'chart' | 'stats' | 'rows';
+    required: boolean;
+    description: string;
+}
+export interface PptistLayout {
+    id: string;
+    label: string;
+    /** One-line catalog description of the composition (what it looks like). */
+    summary: string;
+    /** When to reach for it. */
+    bestFor: string;
+    /** Whether it defaults to a feature (dark) background. */
+    feature: boolean;
+    slots: PptistLayoutSlotDef[];
+}
+type Slots = Record<string, unknown>;
+export declare const PPTX_LAYOUTS: PptistLayout[];
+export declare function listLayouts(): PptistLayout[];
+export interface PptistLayoutBuildResult {
+    slide: Partial<Slide>;
+    warnings: string[];
+}
+/**
+ * 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.
+ */
+export declare function buildLayoutSlide(layoutId: string, slots: Slots, preset: PptistStylePreset, viewport: {
+    width: number;
+    height: number;
+}, backgroundMode?: PptistLayoutBackgroundMode): PptistLayoutBuildResult;
+export {};

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

@@ -0,0 +1,111 @@
+/**
+ * Style presets for the agentic bridge.
+ *
+ * A "style" is a small, curated bundle of design tokens — a color palette with
+ * named *roles* (background / title / body / accent / …), a heading+body font
+ * pairing, and a typographic size scale. Presets are hand-tuned so every
+ * role-pair clears WCAG AA contrast, which lets the agent build good-looking,
+ * legible slides without hand-picking colors or font sizes.
+ *
+ * The agent flow is:
+ *   1. `styles.catalog`  → see the available presets.
+ *   2. `deck.applyStyle` → pick ONE; it sets the deck theme + records `styleId`.
+ *   3. `slides.createFromLayout` → layouts read the active preset's role tokens
+ *      to place themed, contrast-safe elements.
+ *
+ * Only the preset *id* is persisted on the deck theme (`theme.styleId`); the
+ * rich token data lives here in code, so it always renders deterministically
+ * and survives document serialization without bloating the saved deck.
+ */
+import type { SlideTheme } from '../../types/slides';
+/** Named color roles. Every role pairs with a readable foreground/background. */
+export interface PptistStylePalette {
+    /** Default slide background (content slides). */
+    background: string;
+    /** Subtle panel/card fill that sits on `background`. */
+    surface: string;
+    /** Heading/title text on `background`/`surface`. */
+    title: string;
+    /** Body/paragraph text on `background`/`surface`. */
+    body: string;
+    /** De-emphasized text (captions, labels) on `background`/`surface`. */
+    muted: string;
+    /** Hairline rules, dividers, and thin borders. */
+    rule: string;
+    /** Primary accent (bars, highlights, key numbers). */
+    accent: string;
+    /** Secondary accent for variety (second series, alt highlight). */
+    accent2: string;
+    /** Tinted accent wash for soft panels/bands. */
+    accentSoft: string;
+    /** Readable foreground when placed on `accent`. */
+    onAccent: string;
+    /** Feature background for title/section/closing slides (usually dark). */
+    featureBackground: string;
+    /** Title text on `featureBackground`. */
+    featureTitle: string;
+    /** Body/subtitle text on `featureBackground`. */
+    featureBody: string;
+    /** Accent that pops on `featureBackground`. */
+    featureAccent: string;
+}
+/** Typographic size scale in px (canvas units), largest → smallest. */
+export interface PptistStyleScale {
+    /** Hero/cover title. */
+    display: number;
+    /** Standard slide title. */
+    title: number;
+    /** Section header / column heading. */
+    sectionHeader: number;
+    /** Body copy and bullets. */
+    body: number;
+    /** Eyebrow labels, kickers, tags. */
+    label: number;
+    /** Captions, footnotes, source lines. */
+    caption: number;
+}
+export interface PptistStyleFonts {
+    /** Heading/display font family. */
+    heading: string;
+    /** Body/paragraph font family. */
+    body: string;
+}
+export interface PptistStylePreset {
+    id: string;
+    /** Human label shown in the catalog. */
+    label: string;
+    /** One-line description of the look & best use. */
+    description: string;
+    fonts: PptistStyleFonts;
+    palette: PptistStylePalette;
+    scale: PptistStyleScale;
+    /** Ordered chart series colors derived from the palette. */
+    chartColors: string[];
+}
+/** Compact catalog entry (what `styles.catalog` returns to the agent). */
+export interface PptistStyleSummary {
+    id: string;
+    label: string;
+    description: string;
+    fonts: PptistStyleFonts;
+    /** A few representative colors so the agent can picture the look. */
+    preview: {
+        background: string;
+        title: string;
+        body: string;
+        accent: string;
+        featureBackground: string;
+    };
+}
+export declare const DEFAULT_STYLE_ID = "academic";
+export declare const PPTX_STYLE_PRESETS: PptistStylePreset[];
+export declare function getStylePreset(id?: string | null): PptistStylePreset | undefined;
+/** Resolve a usable preset, falling back to the default when id is missing/unknown. */
+export declare function resolveStylePreset(id?: string | null): PptistStylePreset;
+export declare function listStylePresets(): PptistStyleSummary[];
+/**
+ * Build the deck-theme patch for a preset. Sets the inheritable defaults that
+ * manually-created elements pick up (`fontColor`, `fontName`, `backgroundColor`,
+ * `themeColors`) and records `styleId` so layouts can resolve the full preset.
+ */
+export declare function styleThemePatch(preset: PptistStylePreset): Partial<SlideTheme>;

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,8 +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 { 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 { PptistTemplateSummary, PptistTemplateSlideEntry, PptistTemplateSlidesCatalog, PptistTemplateSlidesCatalogResult, } from './templates';
 export type PptistKnownCommandType = keyof PptistCommandPayloadMap;
 export type PptistCommandType = PptistKnownCommandType | (string & {});
 export interface PptistDeckViewport {
@@ -420,6 +422,32 @@ export interface PptistElementFlipInput {
     flipH?: boolean;
     flipV?: boolean;
 }
+export interface PptistApplyTemplateResult {
+    templateId: string;
+    theme: SlideTheme;
+}
+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?: boolean;
+    /** Apply the template theme when the deck is still empty (default true). */
+    applyTemplateTheme?: boolean;
+}
+export interface PptistInsertFromTemplateResult {
+    slideId: string;
+    templateId: string;
+    slug: string;
+    elementIds: string[];
+}
+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;
     set(document: PptistDeckInput, meta?: PptistCommandMeta): Promise<PptistCommandResult<PptistDeckDocument>>;
@@ -429,6 +457,7 @@ export interface PptistAgentDeckApi {
     }>>;
     getTheme(): SlideTheme;
     setTheme(theme: PptistSlideThemePatch, meta?: PptistCommandMeta): Promise<PptistCommandResult<SlideTheme>>;
+    applyTemplate(templateId: string, meta?: PptistCommandMeta): Promise<PptistCommandResult<PptistApplyTemplateResult>>;
     applyTheme(theme: PptistSlideThemePatch, options?: PptistApplyThemeOptions, meta?: PptistCommandMeta): Promise<PptistCommandResult<SlideTheme>>;
     extractTheme(options?: PptistThemeExtractionOptions): SlideTheme;
     setViewport(viewport: {
@@ -443,6 +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>>;
+    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>>;
@@ -982,6 +1012,7 @@ export interface PptistAgentApi {
     guides(guideId?: string): PptistDesignGuide[] | PptistDesignGuide | null;
     deck: PptistAgentDeckApi;
     slides: PptistAgentSlidesApi;
+    templates: PptistAgentTemplatesApi;
     elements: PptistAgentElementsApi;
     text: PptistAgentTextApi;
     shapes: PptistAgentShapesApi;
@@ -1019,6 +1050,9 @@ export interface PptistCommandPayloadMap {
         theme: PptistSlideThemePatch | Partial<SlideTheme>;
         options?: PptistApplyThemeOptions;
     };
+    'deck.applyTemplate': {
+        templateId: string;
+    };
     'deck.extractTheme': {
         options?: PptistThemeExtractionOptions;
     } | undefined;
@@ -1029,6 +1063,10 @@ export interface PptistCommandPayloadMap {
     'deck.setTemplates': {
         templates: SlideTemplate[];
     };
+    'templates.catalog': undefined;
+    'templates.slidesCatalog': {
+        templateId: string;
+    };
     'import.json': PptistDocumentImportPayload;
     'import.pptist': PptistDocumentImportPayload;
     'import.pptxSafe': PptistDocumentImportPayload;
@@ -1043,6 +1081,7 @@ export interface PptistCommandPayloadMap {
         slideIdOrIndex?: PptistSlideReference;
     } | undefined;
     'slides.create': PptistCreateSlideInput | undefined;
+    'slides.insertFromTemplate': PptistInsertFromTemplateInput;
     'slides.insert': PptistInsertSlidesInput;
     'slides.update': {
         slideId: string;
@@ -1643,9 +1682,12 @@ export interface PptistCommandResultDataMap {
     'deck.getTheme': SlideTheme;
     'deck.setTheme': SlideTheme;
     'deck.applyTheme': SlideTheme;
+    'deck.applyTemplate': PptistApplyTemplateResult;
     'deck.extractTheme': SlideTheme;
     'deck.setViewport': PptistBridgeState;
     'deck.setTemplates': SlideTemplate[];
+    'templates.catalog': PptistTemplateSummary[];
+    'templates.slidesCatalog': PptistTemplateSlidesCatalogResult;
     'import.json': PptistDeckDocument;
     'import.pptist': PptistDeckDocument;
     'import.pptxSafe': PptistDeckDocument;
@@ -1655,6 +1697,7 @@ export interface PptistCommandResultDataMap {
     'slides.current': Slide | null;
     'slides.read': Slide | null;
     'slides.create': Slide;
+    'slides.insertFromTemplate': PptistInsertFromTemplateResult;
     'slides.insert': PptistInsertSlidesResult;
     'slides.update': Slide;
     'slides.delete': PptistDeleteSlidesResult;

package/dist/types/i18n/i18n-types.d.ts

@@ -2976,7 +2976,7 @@ export type NamespaceEditorTranslation = {
          */
         exportFiles: string;
         /**
-         * R​e​s​e​t​ ​s​l​i​d​e​s
+         * N​e​w​ ​p​r​e​s​e​n​t​a​t​i​o​n
          */
         resetSlides: string;
         /**
@@ -7518,7 +7518,7 @@ export type TranslationFunctions = {
              */
             exportFiles: () => LocalizedString;
             /**
-             * Reset slides
+             * New presentation
              */
             resetSlides: () => LocalizedString;
             /**

package/dist/types/store/slides.d.ts

@@ -41,6 +41,7 @@ export declare const useSlidesStore: import("pinia").StoreDefinition<"slides", S
                 blur: number;
                 color: string;
             };
+            styleId?: string | undefined;
         };
         slides: {
             id: string;
@@ -797,6 +798,7 @@ export declare const useSlidesStore: import("pinia").StoreDefinition<"slides", S
                 blur: number;
                 color: string;
             };
+            styleId?: string | undefined;
         };
         slides: {
             id: string;
@@ -1197,6 +1199,7 @@ export declare const useSlidesStore: import("pinia").StoreDefinition<"slides", S
                 blur: number;
                 color: string;
             };
+            styleId?: string | undefined;
         };
         slides: {
             id: string;

package/dist/types/types/slides.d.ts

@@ -738,6 +738,13 @@ export interface SlideTheme {
     fontName: string;
     outline: PPTElementOutline;
     shadow: PPTElementShadow;
+    /**
+     * Id of the agentic style preset last applied via `deck.applyStyle`. Additive
+     * and optional: it lets `slides.createFromLayout` inherit the active preset's
+     * role tokens (colors, fonts, type scale) without re-specifying them. It is a
+     * plain string so it survives theme merges and document (de)serialization.
+     */
+    styleId?: string;
 }
 export interface SlideTemplate {
     name: string;

package/package.json

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