@lofcz/pptist 2.0.13 → 2.0.15

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

@@ -78,6 +78,22 @@ export declare function normalizeAudioPatch(patch: PptistAudioElementPatch): Par
 export declare function resolveShapeFormula(element: PPTShapeElement): PPTShapeElement;
 export declare function normalizeShapeElement(element?: Partial<PPTShapeElement>): PPTShapeElement;
 export declare function mergeShapeElement(base: PPTShapeElement, patch: Partial<PPTShapeElement>): PPTShapeElement;
+export interface LatexGeometry {
+    path: string;
+    viewBox: [number, number];
+    width: number;
+    height: number;
+}
+/**
+ * Render a LaTeX formula to its SVG path + intrinsic box via hfmath — the EXACT
+ * pipeline the interactive LaTeXEditor uses (`new hfmath(latex).pathd()/box()`).
+ *
+ * The agent supplies only the `latex` string; it cannot pre-compute the SVG
+ * `path`. Without a path the `<svg>` renders nothing, so a "latex" element from
+ * the agent shows up blank. Deriving the path here makes agent-authored formulas
+ * render identically to ones drawn through the editor UI.
+ */
+export declare function deriveLatexGeometry(latex: string): LatexGeometry;
 export declare function normalizeLatexElement(element: PptistLatexElementInput): PPTLatexElement;
 export declare function normalizeLineElement(element: Partial<PPTLineElement> & {
     type?: 'line';

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 {
@@ -254,7 +258,7 @@ export interface PptistLatexElementSizing {
     height?: number;
     rotate?: number;
 }
-export type PptistLatexElementInput = PptistLatexElementSizing & Pick<PPTLatexElement, 'latex' | 'path'> & Partial<Pick<PPTLatexElement, 'id' | 'color' | 'strokeWidth' | 'viewBox' | 'fixedRatio' | 'link' | 'name' | 'lock' | 'groupId'>>;
+export type PptistLatexElementInput = PptistLatexElementSizing & Pick<PPTLatexElement, 'latex'> & Partial<Pick<PPTLatexElement, 'path' | 'id' | 'color' | 'strokeWidth' | 'viewBox' | 'fixedRatio' | 'link' | 'name' | 'lock' | 'groupId'>>;
 export type PptistLatexElementPatch = Partial<PptistLatexElementSizing & Pick<PPTLatexElement, 'latex' | 'path' | 'color' | 'strokeWidth' | 'viewBox' | 'fixedRatio' | 'link' | 'name' | 'lock' | 'groupId'>>;
 export interface PptistCreateLatexElementInput {
     slideId?: string;
@@ -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/mount.d.ts

@@ -5,7 +5,7 @@ import '../assets/styles/global.scss';
 import '../assets/styles/font.scss';
 import type { PptistMountOptions, PptistMountResult } from './types';
 /**
- * Mount PPTist into a DOM node (for sciobot-next / other React hosts).
+ * Mount PPTist into a DOM node (for React / other embedding hosts).
  * Vue + Pinia are bundled in the embed build — the host does not need Vue installed.
  */
 export declare function mountPptist(target: HTMLElement | string, options?: PptistMountOptions): Promise<PptistMountResult>;

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

@@ -24,14 +24,14 @@ export interface PptistStarterPresentationOptions {
     fontColor?: string;
     backgroundColor?: string;
 }
-/** Serializable deck passed between sciobot-next and PPTist. */
+/** Serializable deck passed between the embedding host and PPTist. */
 export interface PptistDocument {
     title: string;
     slides: Slide[];
     theme?: Partial<SlideTheme>;
 }
 export interface PptistMountOptions {
-    /** UI locale — same union as sciobot-next (`cs` | `en` | `sk` | `pl`). */
+    /** UI locale (`cs` | `en` | `sk` | `pl`). */
     locale?: Locales;
     /** Initial deck; takes precedence over `loadDocument` and the starter slide. */
     document?: PptistDocument;

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

@@ -2,7 +2,7 @@ import type { Locales } from './i18n-types';
 export type { Locales };
 declare global {
     interface Window {
-        /** Set by sciobot-next (React host) before PPTist mount in embed mode */
+        /** Set by the embedding host (e.g. a React app) before PPTist mount in embed mode */
         __PPTIST_LOCALE__?: string;
     }
 }

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

@@ -1,5 +1,5 @@
 /**
- * Vue composable for i18n — mirrors sciobot-next's `useI18nContext()` API.
+ * Vue composable for i18n — mirrors the typesafe-i18n `useI18nContext()` API.
  * Returns reactive `{ LL, locale, setLocale }`.
  */
 export declare function useI18nContext(): {

package/package.json

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