@lofcz/pptist 2.0.3 → 2.0.4

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

@@ -0,0 +1,15 @@
+/**
+ * Compile-time feature flags.
+ *
+ * `EXTRAS_ENABLED` gates demo / upstream-only chrome that has no place in an
+ * embedded product build: the AI / AIPPT entry points, the GitHub link, the
+ * feedback & FAQ links, and the "for testing only" demo disclaimer.
+ *
+ * The value comes from the `__PPTIST_EXTRAS_ENABLED__` constant that Vite
+ * replaces at build time (see `vite.config.ts` / `vite.config.embed.ts`). Because
+ * it resolves to a literal `true`/`false`, any `if (EXTRAS_ENABLED)` branch and
+ * any `v-if="EXTRAS_ENABLED"` subtree is eliminated by the bundler when the flag
+ * is off — the default for consumer builds. Enable it with
+ * `PPTIST_EXTRAS_ENABLED=true` at build time.
+ */
+export declare const EXTRAS_ENABLED: boolean;

package/dist/types/directive/tooltip.d.ts

@@ -1,4 +1,5 @@
 import type { Directive } from 'vue';
+import 'tippy.js/dist/tippy.css';
 import './tooltip.scss';
 declare const TooltipDirective: Directive;
 export default TooltipDirective;

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

@@ -0,0 +1,73 @@
+export interface PptistDocParam {
+    name: string;
+    type?: string;
+    required?: boolean;
+    description?: string;
+}
+export interface PptistCommandDoc {
+    summary?: string;
+    details?: string;
+    params?: PptistDocParam[];
+    examples?: string[];
+    tips?: string[];
+    related?: string[];
+}
+export interface PptistDomainDoc {
+    title: string;
+    summary: string;
+    whenToUse?: string;
+}
+export interface PptistDesignGuide {
+    id: string;
+    title: string;
+    summary: string;
+    /** Body lines (join with "\n" to render). */
+    body: string[];
+}
+export interface PptistDesignSystem {
+    summary: string;
+    coordinateSystem: {
+        summary: string;
+        notes: string[];
+    };
+    tokens: {
+        summary?: string;
+        colors?: Record<string, string>;
+        fontFamily?: string;
+        fontSizePx?: Record<string, number>;
+        spacingPx?: Record<string, number>;
+    };
+}
+export interface PptistAgenticDocs {
+    version: number;
+    summary: string;
+    designSystem: PptistDesignSystem;
+    domains: Record<string, PptistDomainDoc>;
+    commands: Record<string, PptistCommandDoc>;
+    guides: PptistDesignGuide[];
+}
+/** A command description merged with live registry facts (registered? mutates?). */
+export interface PptistCommandDescription extends PptistCommandDoc {
+    name: string;
+    domain: string;
+    registered: boolean;
+    mutates: boolean;
+}
+/** A domain summary merged with the live registry command list. */
+export interface PptistDomainSummary {
+    id: string;
+    title: string;
+    summary: string;
+    whenToUse?: string;
+    commandCount: number;
+    commands: string[];
+}
+/** Minimal structural view of the command registry needed for introspection. */
+export type PptistCommandRegistryView = ReadonlyMap<string, {
+    mutates: boolean;
+}>;
+export declare const AGENTIC_DOCS: PptistAgenticDocs;
+/** Describe a single command: its doc annotation plus live registry facts. */
+export declare function describeAgenticCommand(registry: PptistCommandRegistryView, commandType: string): PptistCommandDescription | null;
+/** List domains (from the live registry + docs) with their command names. */
+export declare function listAgenticDomains(registry: PptistCommandRegistryView): PptistDomainSummary[];

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

@@ -2,6 +2,8 @@ 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 { PptistAgenticDocs, PptistCommandDescription, PptistDesignGuide, PptistDomainSummary } from './manifestDocs';
+export type { PptistAgenticDocs, PptistCommandDescription, PptistCommandDoc, PptistDesignGuide, PptistDesignSystem, PptistDocParam, PptistDomainDoc, PptistDomainSummary, } from './manifestDocs';
 export type PptistKnownCommandType = keyof PptistCommandPayloadMap;
 export type PptistCommandType = PptistKnownCommandType | (string & {});
 export interface PptistDeckViewport {
@@ -276,7 +278,10 @@ export interface PptistLineStyleInput {
 export interface PptistCreateTextInput {
     slideId?: string;
     index?: number;
+    /** HTML content (wins over `markdown` when both are supplied). */
     content?: string;
+    /** Markdown content; converted to HTML by the bridge. */
+    markdown?: string;
     element?: Partial<PPTTextElement>;
     select?: boolean;
 }
@@ -557,6 +562,10 @@ export interface PptistAgentTextApi {
     setContent(elementId: string, content: string, meta?: PptistCommandMeta & {
         slideId?: string;
     }): Promise<PptistCommandResult<PPTTextElement>>;
+    /** Replace content from a Markdown string (converted to HTML). */
+    setMarkdown(elementId: string, markdown: string, meta?: PptistCommandMeta & {
+        slideId?: string;
+    }): Promise<PptistCommandResult<PPTTextElement>>;
     updateContent(elementId: string, update: PptistTextContentUpdateInput, meta?: PptistCommandMeta & {
         slideId?: string;
     }): Promise<PptistCommandResult<PPTTextElement>>;
@@ -961,6 +970,16 @@ export interface PptistAgentApi {
     executeBatch(commands: PptistAgentCommand[], options?: PptistBatchOptions): Promise<PptistCommandResult[]>;
     canExecute(command: PptistAgentCommand): PptistAgentCapability;
     subscribe(listener: PptistBridgeListener): PptistUnsubscribe;
+    /** Convert a Markdown string to the HTML PPTist stores. Math support is loaded on demand. */
+    markdownToHtml(markdown: string): Promise<string>;
+    /** Full authoring docs: design system, domain/command notes, and guides. */
+    docs(): PptistAgenticDocs;
+    /** Domains with their live command lists, for hierarchical discovery. */
+    domains(): PptistDomainSummary[];
+    /** Drill into one command: its doc annotation merged with live registry facts. */
+    describe(commandType: string): PptistCommandDescription | null;
+    /** Slide composition recipes; pass a guide id to fetch a single guide. */
+    guides(guideId?: string): PptistDesignGuide[] | PptistDesignGuide | null;
     deck: PptistAgentDeckApi;
     slides: PptistAgentSlidesApi;
     elements: PptistAgentElementsApi;
@@ -1203,6 +1222,11 @@ export interface PptistCommandPayloadMap {
         slideId?: string;
         content: string;
     };
+    'text.setMarkdown': {
+        elementId: string;
+        slideId?: string;
+        markdown: string;
+    };
     'text.updateContent': {
         elementId: string;
         slideId?: string;
@@ -1683,6 +1707,7 @@ export interface PptistCommandResultDataMap {
     };
     'text.getContent': string | null;
     'text.setContent': PPTTextElement;
+    'text.setMarkdown': PPTTextElement;
     'text.updateContent': PPTTextElement;
     'text.clearContent': PPTTextElement;
     'text.setStyle': PPTTextElement;

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

@@ -1,5 +1,5 @@
 import type { Locales } from '../i18n/locale';
-import type { Slide, SlideTheme } from '../types/slides';
+import type { Slide, SlideTheme, SlideTemplate } from '../types/slides';
 import type { PptistAgentApi, PptistSlideReference } from './agentic/types';
 /** Serializable deck passed between sciobot-next and PPTist. */
 export interface PptistDocument {
@@ -19,6 +19,12 @@ export interface PptistMountOptions {
      * Dev: `http://127.0.0.1:5173` while PPTist dev server runs, or sciobot proxy path.
      */
     assetBaseUrl?: string;
+    /**
+     * Style/template catalog shown in the design picker. Each entry's `id` maps to
+     * a `mocks/<id>.json` payload resolved against `assetBaseUrl`. Omit to use the
+     * bundled defaults (which fall back to the demo deck when a file is missing).
+     */
+    templates?: SlideTemplate[];
     /** Fired when title, slides, or theme change (debounced). */
     onChange?: (document: PptistDocument) => void;
     onChangeDebounceMs?: number;

package/dist/types/utils/assetBase.d.ts

@@ -0,0 +1,4 @@
+export declare function setPptistAssetBase(base: string | undefined | null): void;
+export declare function getPptistAssetBase(): string;
+/** Resolve a packaged-asset path against the configured asset base. */
+export declare function resolvePptistAsset(path: string): string;

package/dist/types/utils/markdown.d.ts

@@ -0,0 +1 @@
+export declare function markdownToHtml(markdown: string): Promise<string>;

package/docs/AGENTIC_BRIDGE.md

@@ -26,6 +26,11 @@ controller.execute({ id: 'cmd_1', type: 'slides.create', payload: { slide } })
 controller.executeBatch(commands, { atomic: true })
 controller.canExecute(command)
 controller.subscribe(event => {})
+await controller.markdownToHtml(markdown)
+controller.docs()
+controller.domains()
+controller.describe(commandType)
+controller.guides(guideId?)
 
 controller.deck.*
 controller.slides.*
@@ -168,6 +173,8 @@ Content rules:
 - Element create payloads must include `element.type`.
 - Whole-document writes (`deck.set`, `deck.patch`, `import.json`, `import.pptist`, and `import.pptxSafe`) require a JSON-serializable payload with a string `title` and a `slides` array before store state is touched.
 - Text-like content is stored as HTML where the model already expects HTML, for example text element `content`, shape `text.content`, slide `remark`, and note `content`.
+- Markdown flavor: `markdown-it` + `markdown-it-texmath` (KaTeX).
+- Use `content` / `text.setContent` for trusted HTML; use `markdown` / `text.setMarkdown` for Markdown.
 - Slide links should be validated against `slides.list()` before use.
 - DOM-dependent import/export paths remain outside the JSON bridge until they have been converted to a serializable document payload.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lofcz/pptist",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "description": "PPTist presentation editor embed bundle with a typed agentic bridge.",
   "type": "module",
   "main": "dist/embed/pptist-embed.js",
@@ -74,7 +74,10 @@
     "hfmath": "^0.0.2",
     "html-to-image": "^1.11.13",
     "jsonrepair": "^3.13.2",
+    "katex": "^0.17.0",
     "lodash": "^4.17.21",
+    "markdown-it": "^14.2.0",
+    "markdown-it-texmath": "^1.0.0",
     "mitt": "^3.0.1",
     "nanoid": "^5.0.7",
     "number-precision": "^1.6.0",
@@ -108,6 +111,7 @@
     "@types/crypto-js": "^4.2.1",
     "@types/file-saver": "^2.0.7",
     "@types/lodash": "^4.14.202",
+    "@types/markdown-it": "^14.1.2",
     "@types/node": "^25.9.1",
     "@types/tinycolor2": "^1.4.6",
     "@vitejs/plugin-vue": "^6.0.7",