@lofcz/pptist 2.0.6 → 2.0.8

package/dist/types/components/Tabs.vue.d.ts

@@ -1,4 +1,5 @@
 import { type CSSProperties } from 'vue';
+import 'overlayscrollbars/overlayscrollbars.css';
 interface TabItem {
     key: string;
     label: string;

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

@@ -1,3 +1,4 @@
+export declare const EASTERN_EXTRAS_FONT_VALUES: string[];
 export declare const FONTS: {
     label: import("typesafe-i18n").LocalizedString;
     value: string;

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

@@ -0,0 +1,28 @@
+import type { TranslationFunctions } from '../i18n/i18n-types';
+import type { Slide, SlideTheme } from '../types/slides';
+export interface StarterPresentationOptions {
+    title?: string;
+    titlePlaceholder?: string;
+    subtitlePlaceholder?: string;
+    bodyPlaceholder?: string;
+    /** Title-slide (cover) title size. PowerPoint default ≈ 40. */
+    titleFontSize?: number;
+    /** Title-slide (cover) subtitle size. PowerPoint default ≈ 20. */
+    subtitleFontSize?: number;
+    /** Content-slide title size. PowerPoint default ≈ 28. */
+    contentTitleFontSize?: number;
+    /** Content-slide body (level 1) size. PowerPoint default ≈ 20. */
+    bodyFontSize?: number;
+    placeholderColor?: string;
+    fontName?: string;
+    fontColor?: string;
+    backgroundColor?: string;
+}
+export interface StarterPresentationDocument {
+    title: string;
+    slides: Slide[];
+    theme?: Partial<SlideTheme>;
+}
+export declare const buildTitleSlide: (LL: TranslationFunctions, options?: StarterPresentationOptions) => Slide;
+export declare const buildContentSlide: (LL: TranslationFunctions, options?: StarterPresentationOptions) => Slide;
+export declare const buildStarterPresentation: (LL: TranslationFunctions, options?: StarterPresentationOptions) => StarterPresentationDocument;

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

@@ -0,0 +1 @@
+export declare const resolveTemplateAssetUrl: (asset: string) => string;

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

@@ -0,0 +1,20 @@
+import type { TranslationFunctions } from '../i18n/i18n-types';
+import type { Slide, SlideTheme } from '../types/slides';
+export type BuiltInTemplateId = 'template_1' | 'template_2' | 'template_3' | 'template_4' | 'template_5' | 'template_6' | 'template_7' | 'template_8';
+export interface TemplatePayload {
+    title?: string;
+    width?: number;
+    height?: number;
+    slides: Slide[];
+    theme?: Partial<SlideTheme>;
+}
+export type TemplatePayloadLoader = () => Promise<TemplatePayload | Slide[]>;
+export interface TemplateNormalizationConfig {
+    stripFontFamiliesWhenExtrasDisabled: string[];
+}
+export declare const setCustomTemplateLoaders: (loaders?: Record<string, TemplatePayloadLoader>) => void;
+export declare const TEMPLATE_NORMALIZATION_CONFIG: TemplateNormalizationConfig;
+export declare const isBuiltInTemplateId: (id: string) => id is BuiltInTemplateId;
+export declare const loadBuiltInTemplate: (id: string) => Promise<TemplatePayload | null>;
+export declare const loadConfiguredTemplate: (id: string) => Promise<Slide[] | TemplatePayload | null>;
+export declare const normalizeTemplatePayload: (payload: TemplatePayload | Slide[], LL: TranslationFunctions, config?: TemplateNormalizationConfig) => TemplatePayload;

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

@@ -1,5 +1,5 @@
 export { mountPptist, unmountPptist } from './mount';
-export type { PptistController, PptistDocument, PptistMountOptions, PptistMountResult, } from './types';
+export type { PptistController, PptistDocument, PptistMountOptions, PptistMountResult, PptistDocumentLoader, PptistStarterPresentationOptions, PptistTemplateLoader, PptistTemplatePayload, } from './types';
 export type * from './agentic/types';
 export type { Locales as PptistLocales } from '../i18n/locale';
 export type { ChartData, ChartOptions, ChartType, Note, NoteReply, PPTAnimation, PPTAudioElement, PPTChartElement, PPTElement, PPTElementLink, PPTImageElement, PPTLatexElement, PPTLineElement, PPTShapeElement, PPTTableElement, PPTTextElement, PPTVideoElement, ShapeText, Slide, SlideBackground, SlideTemplate, SlideTheme, TableCell, TableCellStyle, TextAlign, TurningMode, } from '../types/slides';

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

@@ -1,6 +1,29 @@
 import type { Locales } from '../i18n/locale';
 import type { Slide, SlideTheme, SlideTemplate } from '../types/slides';
 import type { PptistAgentApi, PptistSlideReference } from './agentic/types';
+export interface PptistTemplatePayload {
+    title?: string;
+    width?: number;
+    height?: number;
+    slides: Slide[];
+    theme?: Partial<SlideTheme>;
+}
+export type PptistTemplateLoader = () => Promise<PptistTemplatePayload | Slide[]>;
+export type PptistDocumentLoader = () => Promise<PptistDocument | null | undefined>;
+export interface PptistStarterPresentationOptions {
+    title?: string;
+    titlePlaceholder?: string;
+    subtitlePlaceholder?: string;
+    bodyPlaceholder?: string;
+    titleFontSize?: number;
+    subtitleFontSize?: number;
+    contentTitleFontSize?: number;
+    bodyFontSize?: number;
+    placeholderColor?: string;
+    fontName?: string;
+    fontColor?: string;
+    backgroundColor?: string;
+}
 /** Serializable deck passed between sciobot-next and PPTist. */
 export interface PptistDocument {
     title: string;
@@ -10,21 +33,24 @@ export interface PptistDocument {
 export interface PptistMountOptions {
     /** UI locale — same union as sciobot-next (`cs` | `en` | `sk` | `pl`). */
     locale?: Locales;
-    /** Initial deck; when omitted, mock slides are loaded if `loadMockOnEmpty` is true. */
+    /** Initial deck; takes precedence over `loadDocument` and the starter slide. */
     document?: PptistDocument;
-    /** When no `document`, fetch `mocks/slides.json` from `assetBaseUrl` (default: `/`). */
+    /** Optional async document loader for hosts that resolve a deck from the current URL/session. */
+    loadDocument?: PptistDocumentLoader;
+    /** Legacy demo behavior: when explicitly true, load `mocks/slides.json` instead of the starter slide. */
     loadMockOnEmpty?: boolean;
-    /**
-     * Base URL for runtime assets (template covers, mocks).
-     * Dev: `http://127.0.0.1:5173` while PPTist dev server runs, or sciobot proxy path.
-     */
+    /** Customize the default one-slide starter deck used when no existing document is loaded. */
+    starterPresentation?: PptistStarterPresentationOptions;
+    /** Base URL for runtime image/font assets and fallback mock decks. */
     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).
+     * Style/template catalog shown in the design picker. Built-in template ids are
+     * loaded from lazy bundled JSON chunks. Custom ids can be resolved with
+     * `templateLoaders`, or as a fallback from `mocks/<id>.json` at `assetBaseUrl`.
      */
     templates?: SlideTemplate[];
+    /** Optional custom template payload loaders keyed by `templates[].id`. */
+    templateLoaders?: Record<string, PptistTemplateLoader>;
     /** Fired when title, slides, or theme change (debounced). */
     onChange?: (document: PptistDocument) => void;
     onChangeDebounceMs?: number;

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

@@ -3495,6 +3495,18 @@ export type NamespaceEditorTranslation = {
          * U​n​t​i​t​l​e​d​ ​p​r​e​s​e​n​t​a​t​i​o​n
          */
         untitled: string;
+        /**
+         * C​l​i​c​k​ ​t​o​ ​a​d​d​ ​t​i​t​l​e
+         */
+        clickToAddTitle: string;
+        /**
+         * C​l​i​c​k​ ​t​o​ ​a​d​d​ ​s​u​b​t​i​t​l​e
+         */
+        clickToAddSubtitle: string;
+        /**
+         * C​l​i​c​k​ ​t​o​ ​a​d​d​ ​t​e​x​t
+         */
+        clickToAddText: string;
     };
     templates: {
         /**
@@ -3579,6 +3591,93 @@ export type NamespaceEditorTranslation = {
              */
             end: string;
         };
+        placeholderText: {
+            /**
+             * T​e​m​p​l​a​t​e​ ​c​o​v​e​r​ ​t​i​t​l​e
+             */
+            coverTitle: string;
+            /**
+             * T​e​m​p​l​a​t​e​ ​c​o​v​e​r​ ​s​u​b​t​i​t​l​e
+             */
+            coverSubtitle: string;
+            /**
+             * B​r​i​e​f​ ​p​r​e​s​e​n​t​a​t​i​o​n​ ​s​u​m​m​a​r​y
+             */
+            coverDescription: string;
+            /**
+             * P​r​e​s​e​n​t​e​r​:​ ​X​X​X
+             */
+            presenter: string;
+            /**
+             * D​a​t​e​:​ ​X​X​X
+             */
+            date: string;
+            /**
+             * T​i​m​e​:​ ​X​X​X
+             */
+            time: string;
+            /**
+             * B​u​s​i​n​e​s​s​ ​r​e​p​o​r​t​ ​|​ ​W​o​r​k​ ​s​u​m​m​a​r​y​ ​|​ ​W​o​r​k​ ​p​l​a​n
+             */
+            businessReport: string;
+            /**
+             * C​o​n​t​e​n​t​s
+             */
+            contentsTitle: string;
+            /**
+             * S​e​c​t​i​o​n​ ​{​i​n​d​e​x​}
+             * @param {unknown} index
+             */
+            contentsItem: RequiredParams<'index'>;
+            /**
+             * S​e​c​t​i​o​n​ ​t​i​t​l​e
+             */
+            sectionTitle: string;
+            /**
+             * B​r​i​e​f​ ​s​e​c​t​i​o​n​ ​i​n​t​r​o​d​u​c​t​i​o​n
+             */
+            sectionBody: string;
+            /**
+             * C​o​n​t​e​n​t​ ​p​a​g​e​ ​t​i​t​l​e
+             */
+            contentTitle: string;
+            /**
+             * K​e​y​ ​p​o​i​n​t
+             */
+            itemTitle: string;
+            /**
+             * S​u​p​p​o​r​t​i​n​g​ ​d​e​t​a​i​l
+             */
+            itemBody: string;
+            /**
+             * T​h​a​n​k​ ​y​o​u
+             */
+            thankYou: string;
+            /**
+             * W​e​l​c​o​m​e
+             */
+            welcome: string;
+            /**
+             * T​i​t​l​e​ ​1
+             */
+            title1: string;
+            /**
+             * T​i​t​l​e​ ​2
+             */
+            title2: string;
+            /**
+             * T​i​t​l​e​ ​3
+             */
+            title3: string;
+            /**
+             * T​i​t​l​e​ ​4
+             */
+            title4: string;
+            /**
+             * B​o​d​y​ ​t​e​x​t
+             */
+            bodyText: string;
+        };
         /**
          * I​n​s​e​r​t​ ​a​l​l
          */
@@ -7942,6 +8041,18 @@ export type TranslationFunctions = {
              * Untitled presentation
              */
             untitled: () => LocalizedString;
+            /**
+             * Click to add title
+             */
+            clickToAddTitle: () => LocalizedString;
+            /**
+             * Click to add subtitle
+             */
+            clickToAddSubtitle: () => LocalizedString;
+            /**
+             * Click to add text
+             */
+            clickToAddText: () => LocalizedString;
         };
         templates: {
             /**
@@ -8026,6 +8137,94 @@ export type TranslationFunctions = {
                  */
                 end: () => LocalizedString;
             };
+            placeholderText: {
+                /**
+                 * Template cover title
+                 */
+                coverTitle: () => LocalizedString;
+                /**
+                 * Template cover subtitle
+                 */
+                coverSubtitle: () => LocalizedString;
+                /**
+                 * Brief presentation summary
+                 */
+                coverDescription: () => LocalizedString;
+                /**
+                 * Presenter: XXX
+                 */
+                presenter: () => LocalizedString;
+                /**
+                 * Date: XXX
+                 */
+                date: () => LocalizedString;
+                /**
+                 * Time: XXX
+                 */
+                time: () => LocalizedString;
+                /**
+                 * Business report | Work summary | Work plan
+                 */
+                businessReport: () => LocalizedString;
+                /**
+                 * Contents
+                 */
+                contentsTitle: () => LocalizedString;
+                /**
+                 * Section {index}
+                 */
+                contentsItem: (arg: {
+                    index: unknown;
+                }) => LocalizedString;
+                /**
+                 * Section title
+                 */
+                sectionTitle: () => LocalizedString;
+                /**
+                 * Brief section introduction
+                 */
+                sectionBody: () => LocalizedString;
+                /**
+                 * Content page title
+                 */
+                contentTitle: () => LocalizedString;
+                /**
+                 * Key point
+                 */
+                itemTitle: () => LocalizedString;
+                /**
+                 * Supporting detail
+                 */
+                itemBody: () => LocalizedString;
+                /**
+                 * Thank you
+                 */
+                thankYou: () => LocalizedString;
+                /**
+                 * Welcome
+                 */
+                welcome: () => LocalizedString;
+                /**
+                 * Title 1
+                 */
+                title1: () => LocalizedString;
+                /**
+                 * Title 2
+                 */
+                title2: () => LocalizedString;
+                /**
+                 * Title 3
+                 */
+                title3: () => LocalizedString;
+                /**
+                 * Title 4
+                 */
+                title4: () => LocalizedString;
+                /**
+                 * Body text
+                 */
+                bodyText: () => LocalizedString;
+            };
             /**
              * Insert all
              */

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

@@ -153,6 +153,10 @@ export declare const useMainStore: import("pinia").StoreDefinition<"main", MainS
         content: string;
         defaultFontName: string;
         defaultColor: string;
+        placeholder?: string | undefined;
+        placeholderFontSize?: number | undefined;
+        placeholderColor?: string | undefined;
+        placeholderAlign?: import("../embed").TextAlign | undefined;
         outline?: {
             style?: import("../types/slides").LineStyleType | undefined;
             width?: number | undefined;
@@ -576,6 +580,10 @@ export declare const useMainStore: import("pinia").StoreDefinition<"main", MainS
         content: string;
         defaultFontName: string;
         defaultColor: string;
+        placeholder?: string | undefined;
+        placeholderFontSize?: number | undefined;
+        placeholderColor?: string | undefined;
+        placeholderAlign?: import("../embed").TextAlign | undefined;
         outline?: {
             style?: import("../types/slides").LineStyleType | undefined;
             width?: number | undefined;

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

@@ -49,6 +49,10 @@ export declare const useSlidesStore: import("pinia").StoreDefinition<"slides", S
                 content: string;
                 defaultFontName: string;
                 defaultColor: string;
+                placeholder?: string | undefined;
+                placeholderFontSize?: number | undefined;
+                placeholderColor?: string | undefined;
+                placeholderAlign?: import("../types/slides").TextAlign | undefined;
                 outline?: {
                     style?: import("../types/slides").LineStyleType | undefined;
                     width?: number | undefined;
@@ -418,6 +422,10 @@ export declare const useSlidesStore: import("pinia").StoreDefinition<"slides", S
             content: string;
             defaultFontName: string;
             defaultColor: string;
+            placeholder?: string | undefined;
+            placeholderFontSize?: number | undefined;
+            placeholderColor?: string | undefined;
+            placeholderAlign?: import("../types/slides").TextAlign | undefined;
             outline?: {
                 style?: import("../types/slides").LineStyleType | undefined;
                 width?: number | undefined;
@@ -797,6 +805,10 @@ export declare const useSlidesStore: import("pinia").StoreDefinition<"slides", S
                 content: string;
                 defaultFontName: string;
                 defaultColor: string;
+                placeholder?: string | undefined;
+                placeholderFontSize?: number | undefined;
+                placeholderColor?: string | undefined;
+                placeholderAlign?: import("../types/slides").TextAlign | undefined;
                 outline?: {
                     style?: import("../types/slides").LineStyleType | undefined;
                     width?: number | undefined;
@@ -1193,6 +1205,10 @@ export declare const useSlidesStore: import("pinia").StoreDefinition<"slides", S
                 content: string;
                 defaultFontName: string;
                 defaultColor: string;
+                placeholder?: string | undefined;
+                placeholderFontSize?: number | undefined;
+                placeholderColor?: string | undefined;
+                placeholderAlign?: import("../types/slides").TextAlign | undefined;
                 outline?: {
                     style?: import("../types/slides").LineStyleType | undefined;
                     width?: number | undefined;

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

@@ -170,6 +170,10 @@ export interface PPTTextElement extends PPTBaseElement {
     content: string;
     defaultFontName: string;
     defaultColor: string;
+    placeholder?: string;
+    placeholderFontSize?: number;
+    placeholderColor?: string;
+    placeholderAlign?: TextAlign;
     outline?: PPTElementOutline;
     fill?: string;
     lineHeight?: number;

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

@@ -91,6 +91,10 @@ export declare const rotateRectLikeElement: (element: Exclude<PPTElement, PPTLin
     content: string;
     defaultFontName: string;
     defaultColor: string;
+    placeholder?: string;
+    placeholderFontSize?: number;
+    placeholderColor?: string;
+    placeholderAlign?: import("../types/slides").TextAlign;
     outline?: import("../types/slides").PPTElementOutline;
     fill?: string;
     lineHeight?: number;

package/dist/types/views/components/element/ProsemirrorEditor.vue.d.ts

@@ -16,6 +16,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
         value: string;
         ignore: boolean;
     }) => any;
+    emptyChange: (empty: boolean) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onBlur?: (() => any) | undefined;
     onFocus?: (() => any) | undefined;
@@ -24,6 +25,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
         value: string;
         ignore: boolean;
     }) => any) | undefined;
+    onEmptyChange?: ((empty: boolean) => any) | undefined;
 }>, {
     editable: boolean;
     autoFocus: boolean;

package/dist/types/views/components/element/TextElement/TextPlaceholder.vue.d.ts

@@ -0,0 +1,17 @@
+import type { TextAlign, TextType } from '../../../../types/slides';
+type __VLS_Props = {
+    label: string;
+    contentType: TextType;
+    fontSize: number;
+    color: string;
+    align?: TextAlign;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    activate: (payload: MouseEvent) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onActivate?: ((payload: MouseEvent) => any) | undefined;
+}>, {
+    align: TextAlign;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lofcz/pptist",
-  "version": "2.0.6",
+  "version": "2.0.8",
   "description": "PPTist presentation editor embed bundle with a typed agentic bridge.",
   "type": "module",
   "main": "dist/embed/pptist-embed.js",
@@ -82,6 +82,7 @@
     "mitt": "^3.0.1",
     "nanoid": "^5.0.7",
     "number-precision": "^1.6.0",
+    "overlayscrollbars": "^2.16.0",
     "pinia": "^3.0.2",
     "pptxgenjs": "^3.12.0",
     "pptxtojson": "^2.0.4",