fika-editor 3.2.8 → 3.2.9

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

@@ -0,0 +1,24 @@
+import { type PresetTheme } from './theme';
+/** Host-localized designs displayed in the slide design picker, in supplied order. */
+export type FikaDesignTheme = Omit<PresetTheme, 'id' | 'name'> & {
+    id: string;
+    name: string;
+};
+/** Undefined restores Fika defaults; [] intentionally hides the preset catalog. */
+export declare function resolveDesignThemes(themes?: readonly FikaDesignTheme[]): readonly PresetTheme[];
+export declare const useDesignThemes: import("zustand").UseBoundStore<import("zustand").StoreApi<{
+    themes: readonly PresetTheme[];
+}>>;
+/** Updates the catalog only; never restyles or replaces the host document. */
+export declare function setFikaDesignThemes(themes?: readonly FikaDesignTheme[]): void;
+/** Obtain independent copies of Fika's built-in designs for filtering/extending. */
+export declare function getFikaDefaultDesignThemes(): FikaDesignTheme[];
+/** Small JSON-safe catalog for host/agent discovery, not full document content. */
+export declare function listFikaDesignThemes(): {
+    id: string;
+    name: string;
+    background: string;
+    fontColor: string;
+    colors: string[];
+}[];
+export declare function getFikaDesignTheme(id: string): PresetTheme;

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

@@ -36,7 +36,7 @@ export declare const themeBackgroundCycle: (theme: PresetTheme) => SlideBackgrou
 export declare const resolvePresetBackground: (theme: PresetTheme, slideType?: SlideType, index?: number) => SlideBackground;
 export declare const resolvePresetFontColor: (theme: PresetTheme, _slideType?: SlideType) => string;
 export declare const themeChartColors: (theme: Pick<PresetTheme, 'colors' | 'chartColors'>) => string[];
-export declare const matchPresetTheme: (themeColors: string[]) => PresetTheme | undefined;
+export declare const matchPresetTheme: (themeColors: string[], presets?: readonly PresetTheme[]) => PresetTheme | undefined;
 /** Paint a layout preview/insert with the active preset's type-specific background and type. */
 export declare const applyPresetToLayoutSlide: (slide: Slide, theme: PresetTheme, index?: number) => void;
 export declare const sameSlideBackground: (a?: SlideBackground, b?: SlideBackground) => boolean;

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

@@ -0,0 +1,8 @@
+/** Remove only explicitly replaced theme properties from HTML style attributes.
+ * Matching whole declarations avoids corrupting background-color / border-color
+ * or literal lesson text that happens to contain CSS examples.
+ */
+export declare function stripThemeInlineStyles(content: string, patch: {
+    fontColor?: string;
+    fontName?: string;
+}): string;

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

@@ -598,6 +598,18 @@ export interface FikaAgentDeckApi {
     setTitle(title: string, meta?: FikaCommandMeta): Promise<FikaCommandResult<{
         title: string;
     }>>;
+    listDesignThemes(): Array<{
+        id: string;
+        name: string;
+        background: string;
+        fontColor: string;
+        colors: string[];
+    }>;
+    applyDesignTheme(themeId: string, meta?: FikaCommandMeta): Promise<FikaCommandResult<{
+        themeId: string;
+        name: string;
+        slideCount: number;
+    }>>;
     getTheme(): SlideTheme;
     setTheme(theme: FikaSlideThemePatch, meta?: FikaCommandMeta): Promise<FikaCommandResult<SlideTheme>>;
     applyTemplate(templateId: string, meta?: FikaCommandMeta): Promise<FikaCommandResult<FikaApplyTemplateResult>>;
@@ -1200,6 +1212,10 @@ export interface FikaCommandPayloadMap {
     'deck.setTitle': {
         title: string;
     };
+    'deck.listDesignThemes': undefined;
+    'deck.applyDesignTheme': {
+        themeId: string;
+    };
     'deck.getTheme': undefined;
     'deck.setTheme': {
         theme: FikaSlideThemePatch | Partial<SlideTheme>;
@@ -1892,6 +1908,18 @@ export interface FikaCommandResultDataMap {
     'deck.setTitle': {
         title: string;
     };
+    'deck.listDesignThemes': Array<{
+        id: string;
+        name: string;
+        background: string;
+        fontColor: string;
+        colors: string[];
+    }>;
+    'deck.applyDesignTheme': {
+        themeId: string;
+        name: string;
+        slideCount: number;
+    };
     'deck.getTheme': SlideTheme;
     'deck.setTheme': SlideTheme;
     'deck.applyTheme': SlideTheme;

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

@@ -10,3 +10,5 @@ export type { FikaMediaConfig, FikaMediaConstraints, FikaMediaKind, FikaMediaSiz
 export type * from './agentic/types';
 export type { Locales as FikaLocales } 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';
+export type { FikaDesignTheme } from '../configs/designThemes';
+export { getFikaDefaultDesignThemes } from '../configs/designThemes';

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

@@ -1,3 +1,4 @@
+import type { FikaDesignTheme } from '../configs/designThemes';
 import type { FikaExportTabsConfig } from '../configs/exportTabs';
 import type { FikaExportMediaResolver } from '../configs/exportMediaResolver';
 import type { FikaExportWatermark, FikaExportWatermarkPosition, FikaExportWatermarkResolver, FikaWatermarkSurface } from '../configs/exportWatermark';
@@ -63,6 +64,8 @@ export interface FikaHeaderMenuItem {
 /** `editor` is the default full editor; `presentation` boots straight into the fullscreen slideshow with no editor chrome. */
 export type FikaViewMode = 'editor' | 'presentation';
 export interface FikaMountOptions {
+    /** Replacement design catalog in display order. Omit for Fika defaults; [] hides presets. Does not restyle the loaded document. */
+    designThemes?: readonly FikaDesignTheme[];
     /** UI locale (`cs` | `en` | `sk` | `pl`). */
     locale?: Locales;
     /** Initial deck; takes precedence over `loadDocument` and the starter slide. */
@@ -191,6 +194,8 @@ export interface FikaController extends FikaAgentApi {
     importPptx(data: File | Blob | ArrayBuffer, options?: FikaImportPptxOptions): Promise<boolean>;
     setTitle(title: string): void;
     setLocale(locale: Locales): Promise<void>;
+    /** Replace the visible design catalog without changing slide content. Undefined restores defaults. */
+    setDesignThemes(themes?: readonly FikaDesignTheme[]): void;
     /**
      * Paint one slide offscreen (thumbnail painter, no DOM capture) and return
      * the encoded image. Defaults to the current slide.

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

@@ -0,0 +1,8 @@
+import type { Slide, SlideTheme } from '../types/slides';
+import { type PresetTheme } from '../configs/theme';
+export declare const setSlideTheme: (slide: Slide, theme: PresetTheme, index?: number) => void;
+/** Shared by the design picker and agent command, with no store/history effects. */
+export declare function applyDesignTheme(slides: readonly Slide[], currentTheme: SlideTheme, preset: PresetTheme): {
+    slides: Slide[];
+    theme: SlideTheme;
+};

package/docs/AGENTIC_BRIDGE.md

@@ -518,4 +518,12 @@ await savePresentationDocument(controller.getDocument())
 await controller.executeBatch(commands, { atomic: true })
 ```
 
-Use `controller.export.json()` for a synchronous serializable snapshot. Use `controller.import.json(document)`, `controller.execute({ type: 'import.json', payload: { document } })`, or `controller.execute({ type: 'export.json' })` when sciobot needs command results for whole-document import/export.
+Use `controller.export.json()` for a synchronous serializable snapshot. Use `controller.import.json(document)`, `controller.execute({ type: 'import.json', payload: { document } })`, or `controller.execute({ type: 'export.json' })` when sciobot needs command results for whole-document import/export.
+### Partial theme application
+
+`deck.applyTheme` with `options.applyToSlides: true` applies only the supplied
+properties to existing slide content. For example, `{ theme: { fontName:
+'Calibri' }, options: { applyToSlides: true } }` replaces text/shape/table font
+families without resetting backgrounds, text colors, chart palettes or sizes.
+Inline property removal is restricted to style declarations; background-color,
+border-color and literal CSS examples in lesson text are preserved.

package/docs/EMBED.md

@@ -479,3 +479,43 @@ The ProseMirror schema preserves hard line breaks and Markdown strikethrough
 through storage, static rendering, and editing.
 Pass `assetBaseUrl` to `mountFika()` to resolve lazy editor CSS under the same
 asset directory as the embed stylesheet.
+
+### Host-configured slide designs
+
+Pass `designThemes` to replace the built-in design cards (not editor chrome).
+The supplied order and host-localized `name` appear in the picker. Custom designs
+also drive layout previews, new layout slides, background looks and chart colors.
+Omit the option for Fika defaults; pass `[]` to hide the preset section.
+Configuring the catalog does not apply a design to the existing document.
+
+```ts
+import { mountFika, getFikaDefaultDesignThemes, type FikaDesignTheme } from 'fika-editor/embed'
+
+const paper: FikaDesignTheme = {
+  id: 'my-paper', name: 'Paper',
+  background: '#FAF8F4', fontColor: '#2B3445', fontname: 'Inter',
+  colors: ['#D25F2B', '#2A7FA3', '#5F8A2C'],
+  borderColor: '#E3DFD6',
+}
+const { controller } = await mountFika('#editor', { designThemes: [paper] })
+controller.setDesignThemes([{ ...paper, name: 'Papír' }]) // reactive label/catalog update
+controller.setDesignThemes(getFikaDefaultDesignThemes()) // independent copies of defaults
+```
+
+Design IDs must be nonempty and unique; names and accent palettes are required.
+Use distinct accent palettes so the active design can be recognized after a
+saved document is loaded. Optional `chartColors`, `featureFontColor`,
+`contentBackground`, `featureBackground`, `altBackground` and `backgrounds`
+provide the same appearance controls as built-in designs. Catalogs are runtime
+host configuration, not part of the persisted document. Like Fika's other embed
+configuration and stores, the catalog is shared by the active editor runtime;
+use separate runtimes for independently configured simultaneous editors.
+
+Agents can use the same active catalog via `controller.deck.listDesignThemes()`
+(read-only), then apply one by ID with
+`controller.deck.applyDesignTheme('scio-blue')`. The command-bus equivalent is
+`{ type: 'deck.applyDesignTheme', payload: { themeId: 'scio-blue' } }`.
+Application uses the picker implementation and creates one undo step for the
+whole deck. Unknown IDs fail without changing the presentation. Hosts should
+include the small catalog in agent context so applying a named theme needs only
+one call, without a preceding discovery request.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fika-editor",
-  "version": "3.2.8",
+  "version": "3.2.9",
   "description": "Fika presentation editor embed bundle with a typed agentic bridge.",
   "type": "module",
   "main": "dist/embed/fika-embed.js",