@lofcz/pptist 2.0.14 → 2.0.16

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

@@ -48,9 +48,12 @@ export interface PptistLayoutBuildResult {
  * 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.
+ *
+ * Async because slots may carry inline math; KaTeX is lazy-loaded up front (only
+ * when math is present) so the otherwise-synchronous builders can render it.
  */
 export declare function buildLayoutSlide(layoutId: string, slots: Slots, preset: PptistStylePreset, viewport: {
     width: number;
     height: number;
-}, backgroundMode?: PptistLayoutBackgroundMode): PptistLayoutBuildResult;
+}, backgroundMode?: PptistLayoutBackgroundMode): Promise<PptistLayoutBuildResult>;
 export {};

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

@@ -258,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;

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/dist/types/utils/markdown.d.ts

@@ -1 +1,16 @@
+/** True when a string carries math delimiters the math parser should handle. */
+export declare function containsMath(source: string): boolean;
 export declare function markdownToHtml(markdown: string): Promise<string>;
+/**
+ * Preload the math-capable markdown parser (lazy KaTeX + texmath) so
+ * `renderInlineMarkdown` can render `$…$` math synchronously afterwards. No-op
+ * once loaded; call before rendering content that may contain math.
+ */
+export declare function ensureInlineMathReady(): Promise<void>;
+/**
+ * Render one line of markdown to inline HTML (no `<p>` wrapper) using the same
+ * CommonMark + texmath pipeline as {@link markdownToHtml}. Inline math (`$…$`)
+ * renders only when the math parser has been preloaded via
+ * {@link ensureInlineMathReady}; otherwise math delimiters read as literal text.
+ */
+export declare function renderInlineMarkdown(markdown: string): string;

package/package.json

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