fika-editor 3.2.9 → 3.3.0

package/dist/types/views/Myna/MynaTemplateLibrary.d.ts

@@ -0,0 +1,3 @@
+export default function MynaTemplateLibrary({ locale }: {
+    locale: string;
+}): import("react").JSX.Element;

package/dist/types/views/Myna/MynaViewSettings.d.ts

@@ -0,0 +1,2 @@
+/** View preferences remain available in read-only mode; clearing guides edits the page. */
+export default function MynaViewSettings(): import("react").JSX.Element;

package/dist/types/views/Myna/MynaWorkspace.d.ts

@@ -0,0 +1 @@
+export default function MynaWorkspace(): import("react").JSX.Element;

package/dist/types/views/Myna/MynaZoomControl.d.ts

@@ -0,0 +1,3 @@
+export declare function fitMynaSelection(): void;
+export declare function fitMynaPages(): void;
+export default function MynaZoomControl(): import("react").JSX.Element;

package/dist/types/views/Myna/WorkspaceLabels.d.ts

@@ -0,0 +1,8 @@
+export declare function WorkspaceLabelsPanel(): import("react").JSX.Element;
+export declare const WorkspaceLabelsCanvas: import("react").MemoExoticComponent<({ left, top, originX, originY, scale }: {
+    left: number;
+    top: number;
+    originX: number;
+    originY: number;
+    scale: number;
+}) => import("react").JSX.Element>;

package/dist/types/views/Myna/WorkspaceObjects.d.ts

@@ -0,0 +1,9 @@
+import type { WorkspaceLabel } from '../../types/slides';
+export declare function WorkspaceObjectsPanel(): import("react").JSX.Element;
+export declare function WorkspaceObject({ label, owner, x, y, scale }: {
+    label: WorkspaceLabel;
+    owner: string;
+    x: number;
+    y: number;
+    scale: number;
+}): import("react").JSX.Element;

package/dist/types/views/Myna/catalog.d.ts

@@ -0,0 +1,233 @@
+import type { TranslationFunctions } from '../../i18n/i18n-types';
+type MynaTranslations = TranslationFunctions['myna'];
+import type { FikaDocument } from '../../embed/types';
+import type { PPTTextElement, Slide } from '../../types/slides';
+export declare const MYNA_FORMATS: readonly [{
+    readonly name: 'Social post';
+    readonly width: 1080;
+    readonly height: 1080;
+}, {
+    readonly name: 'Portrait post';
+    readonly width: 1080;
+    readonly height: 1350;
+}, {
+    readonly name: 'Story';
+    readonly width: 1080;
+    readonly height: 1920;
+}, {
+    readonly name: 'Presentation';
+    readonly width: 1920;
+    readonly height: 1080;
+}, {
+    readonly name: 'A4 portrait';
+    readonly width: 794;
+    readonly height: 1123;
+}, {
+    readonly name: 'A4 landscape';
+    readonly width: 1123;
+    readonly height: 794;
+}, {
+    readonly name: 'Poster';
+    readonly width: 1200;
+    readonly height: 1800;
+}, {
+    readonly name: 'Video thumbnail';
+    readonly width: 1280;
+    readonly height: 720;
+}, {
+    readonly name: 'Business card';
+    readonly width: 1050;
+    readonly height: 600;
+}, {
+    readonly name: 'Banner';
+    readonly width: 1500;
+    readonly height: 500;
+}];
+export declare const MYNA_TEMPLATES: readonly [{
+    readonly id: 'studio';
+    readonly name: 'Creative studio';
+    readonly category: 'Social';
+    readonly background: '#ede9df';
+    readonly ink: '#282c24';
+    readonly accent: '#d7f36b';
+    readonly heading: 'Ideas into\nimpact.';
+    readonly eyebrow: 'THE CREATIVE EDIT';
+    readonly body: 'A little curiosity. A fresh perspective.\nSomething worth sharing.';
+    readonly layout: 'editorial';
+}, {
+    readonly id: 'botanical';
+    readonly name: 'Grow together';
+    readonly category: 'Education';
+    readonly background: '#e9efdf';
+    readonly ink: '#183f33';
+    readonly accent: '#aec68c';
+    readonly heading: 'Room to\ngrow.';
+    readonly eyebrow: 'LEARN SOMETHING NEW';
+    readonly body: 'Small steps. Big discoveries.\nYour next chapter starts here.';
+    readonly layout: 'organic';
+}, {
+    readonly id: 'workshop';
+    readonly name: 'The workshop';
+    readonly category: 'Events';
+    readonly background: '#29243c';
+    readonly ink: '#fff5e9';
+    readonly accent: '#e8b3f1';
+    readonly heading: 'Make it\nhappen.';
+    readonly eyebrow: 'A HANDS-ON WORKSHOP';
+    readonly body: 'Bring your ideas. Find your people.\nCreate something extraordinary.';
+    readonly layout: 'poster';
+}, {
+    readonly id: 'launch';
+    readonly name: 'Fresh launch';
+    readonly category: 'Marketing';
+    readonly background: '#f6e1d6';
+    readonly ink: '#4b2c2e';
+    readonly accent: '#eb7754';
+    readonly heading: 'Meet your\nnew favorite.';
+    readonly eyebrow: 'SOMETHING GOOD IS HERE';
+    readonly body: 'Thoughtfully made. Ready for you.\nDiscover the collection.';
+    readonly layout: 'editorial';
+}, {
+    readonly id: 'lesson';
+    readonly name: 'A curious mind';
+    readonly category: 'Education';
+    readonly background: '#edf1fa';
+    readonly ink: '#253762';
+    readonly accent: '#b0c5f0';
+    readonly heading: 'Stay\ncurious.';
+    readonly eyebrow: 'TODAY’S BIG QUESTION';
+    readonly body: 'What will you discover today?\nExplore. Experiment. Explain.';
+    readonly layout: 'organic';
+}, {
+    readonly id: 'quote';
+    readonly name: 'Words to keep';
+    readonly category: 'Social';
+    readonly background: '#f8efdc';
+    readonly ink: '#524431';
+    readonly accent: '#dec48d';
+    readonly heading: 'Good things\ntake time.';
+    readonly eyebrow: 'A NOTE TO YOURSELF';
+    readonly body: 'Keep showing up.\nThe best is still ahead.';
+    readonly layout: 'poster';
+}];
+/** Resolve labels at insertion time; existing document content never changes with the UI locale. */
+export declare function getMynaTemplates(t?: MynaTranslations): ({
+    id: 'studio';
+    category: 'Social';
+    background: '#ede9df';
+    ink: '#282c24';
+    accent: '#d7f36b';
+    layout: 'editorial';
+    name: import("typesafe-i18n").LocalizedString;
+    heading: import("typesafe-i18n").LocalizedString;
+    eyebrow: import("typesafe-i18n").LocalizedString;
+    body: import("typesafe-i18n").LocalizedString;
+    categoryName: import("typesafe-i18n").LocalizedString;
+} | {
+    id: 'botanical';
+    category: 'Education';
+    background: '#e9efdf';
+    ink: '#183f33';
+    accent: '#aec68c';
+    layout: 'organic';
+    name: import("typesafe-i18n").LocalizedString;
+    heading: import("typesafe-i18n").LocalizedString;
+    eyebrow: import("typesafe-i18n").LocalizedString;
+    body: import("typesafe-i18n").LocalizedString;
+    categoryName: import("typesafe-i18n").LocalizedString;
+} | {
+    id: 'workshop';
+    category: 'Events';
+    background: '#29243c';
+    ink: '#fff5e9';
+    accent: '#e8b3f1';
+    layout: 'poster';
+    name: import("typesafe-i18n").LocalizedString;
+    heading: import("typesafe-i18n").LocalizedString;
+    eyebrow: import("typesafe-i18n").LocalizedString;
+    body: import("typesafe-i18n").LocalizedString;
+    categoryName: import("typesafe-i18n").LocalizedString;
+} | {
+    id: 'launch';
+    category: 'Marketing';
+    background: '#f6e1d6';
+    ink: '#4b2c2e';
+    accent: '#eb7754';
+    layout: 'editorial';
+    name: import("typesafe-i18n").LocalizedString;
+    heading: import("typesafe-i18n").LocalizedString;
+    eyebrow: import("typesafe-i18n").LocalizedString;
+    body: import("typesafe-i18n").LocalizedString;
+    categoryName: import("typesafe-i18n").LocalizedString;
+} | {
+    id: 'lesson';
+    category: 'Education';
+    background: '#edf1fa';
+    ink: '#253762';
+    accent: '#b0c5f0';
+    layout: 'organic';
+    name: import("typesafe-i18n").LocalizedString;
+    heading: import("typesafe-i18n").LocalizedString;
+    eyebrow: import("typesafe-i18n").LocalizedString;
+    body: import("typesafe-i18n").LocalizedString;
+    categoryName: import("typesafe-i18n").LocalizedString;
+} | {
+    id: 'quote';
+    category: 'Social';
+    background: '#f8efdc';
+    ink: '#524431';
+    accent: '#dec48d';
+    layout: 'poster';
+    name: import("typesafe-i18n").LocalizedString;
+    heading: import("typesafe-i18n").LocalizedString;
+    eyebrow: import("typesafe-i18n").LocalizedString;
+    body: import("typesafe-i18n").LocalizedString;
+    categoryName: import("typesafe-i18n").LocalizedString;
+})[];
+export declare function getMynaFormats(t?: MynaTranslations): ({
+    width: 1080;
+    height: 1080;
+    name: import("typesafe-i18n").LocalizedString;
+} | {
+    width: 1080;
+    height: 1350;
+    name: import("typesafe-i18n").LocalizedString;
+} | {
+    width: 1080;
+    height: 1920;
+    name: import("typesafe-i18n").LocalizedString;
+} | {
+    width: 1920;
+    height: 1080;
+    name: import("typesafe-i18n").LocalizedString;
+} | {
+    width: 794;
+    height: 1123;
+    name: import("typesafe-i18n").LocalizedString;
+} | {
+    width: 1123;
+    height: 794;
+    name: import("typesafe-i18n").LocalizedString;
+} | {
+    width: 1200;
+    height: 1800;
+    name: import("typesafe-i18n").LocalizedString;
+} | {
+    width: 1280;
+    height: 720;
+    name: import("typesafe-i18n").LocalizedString;
+} | {
+    width: 1050;
+    height: 600;
+    name: import("typesafe-i18n").LocalizedString;
+} | {
+    width: 1500;
+    height: 500;
+    name: import("typesafe-i18n").LocalizedString;
+})[];
+export declare function validMynaSize(width: number, height: number): boolean;
+export declare function createMynaPage(templateId: string, width: number, height: number, t?: MynaTranslations): Slide;
+export declare function createMynaDocument(t?: MynaTranslations): FikaDocument;
+/** A font pairing is two independently editable text boxes in one movable group. */
+export declare function createMynaTextPair(heading: string, font: string, width: number, height: number, color: string, t?: MynaTranslations): PPTTextElement[];
+export {};

package/dist/types/views/Myna/exportPages.d.ts

@@ -0,0 +1,2 @@
+/** One-based page specification, preserving the user's order and removing duplicates. */
+export declare function parseExportPages(value: string, count: number): number[] | null;

package/dist/types/views/Myna/inspectorLabels.d.ts

@@ -0,0 +1,30 @@
+/** Myna inspector copy kept independent from generated dictionaries. */
+declare const en: {
+    page: string;
+    selection: string;
+    selected: string;
+    appearance: string;
+    typography: string;
+    image: string;
+    geometry: string;
+    arrange: string;
+    motion: string;
+    transition: string;
+    design: string;
+    pageHint: string;
+    multiHint: string;
+    readOnly: string;
+    text: string;
+    shape: string;
+    line: string;
+    chart: string;
+    table: string;
+    latex: string;
+    code: string;
+    video: string;
+    audio: string;
+    photo: string;
+};
+type Labels = Record<keyof typeof en, string>;
+export declare const inspectorLabels: (locale: string) => Labels;
+export {};

package/dist/types/views/Myna/libraryMessages.d.ts

@@ -0,0 +1,28 @@
+declare const en: {
+    title: string;
+    hint: string;
+    name: string;
+    save: string;
+    saving: string;
+    search: string;
+    all: string;
+    favorites: string;
+    recent: string;
+    empty: string;
+    use: string;
+    rename: string;
+    remove: string;
+    confirm: string;
+    cancel: string;
+    favorite: string;
+    unfavorite: string;
+    saved: string;
+    added: string;
+    failed: string;
+    unreadable: string;
+    pages: string;
+    fit: string;
+};
+export type LibraryMessages = typeof en;
+export declare const libraryMessages: (locale: string) => LibraryMessages;
+export {};

package/dist/types/views/Myna/pageLayout.d.ts

@@ -0,0 +1,22 @@
+import type { Slide } from '../../types/slides';
+export interface PagePosition {
+    x: number;
+    y: number;
+}
+export type PageArrangement = 'grid' | 'horizontal' | 'vertical';
+export declare const PAGE_GAP = 120;
+/** Explicit positions may intentionally overlap. Only new, unpositioned pages avoid collisions. */
+export declare function resolvePagePositions(slides: readonly Pick<Slide, 'id' | 'canvasPosition'>[], width: number, height: number): Map<string, PagePosition>;
+export declare function arrangePagePositions(slides: readonly Pick<Slide, 'id'>[], width: number, height: number, arrangement: PageArrangement): Map<string, PagePosition>;
+export declare function pageLayoutBounds(slides: readonly Pick<Slide, 'id' | 'canvasPosition'>[], width: number, height: number, positions?: Map<string, PagePosition>): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+/** Move complete groups with their element-linked notes and animations; page-local geometry is retained. */
+export declare function movePageElements(source: Slide, target: Slide, selectedIds: readonly string[]): {
+    source: Slide;
+    target: Slide;
+    movedIds: string[];
+};

package/dist/types/views/Myna/pageSnapping.d.ts

@@ -0,0 +1,41 @@
+/** Geometry is in document coordinates; tolerance is measured in screen pixels. */
+export interface PageSnapRect {
+    id: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface PageSnapGuide {
+    axis: 'x' | 'y';
+    position: number;
+    start: number;
+    end: number;
+}
+export interface PageSnapSpacing {
+    axis: 'x' | 'y';
+    from: number;
+    to: number;
+    cross: number;
+    distance: number;
+}
+export interface PageSnapOptions {
+    moving: readonly PageSnapRect[];
+    stationary: readonly PageSnapRect[];
+    dx: number;
+    dy: number;
+    scale: number;
+    thresholdPx?: number;
+    gridSize?: number;
+    customGuides?: readonly PageSnapGuide[];
+    /** Constrain movement to this axis. */
+    axis?: 'x' | 'y';
+}
+export interface PageSnapResult {
+    dx: number;
+    dy: number;
+    guides: PageSnapGuide[];
+    spacing: PageSnapSpacing[];
+}
+/** Applies a single translation to a selection, retaining its internal layout. */
+export declare function snapPageDrag(options: PageSnapOptions): PageSnapResult;

package/dist/types/views/Myna/pdf.d.ts

@@ -0,0 +1,10 @@
+/** Flattened, multipage PDF export. Each JPEG preserves the canvas rendering. */
+export interface MynaPdfPage {
+    jpeg: Uint8Array;
+    pixelWidth: number;
+    pixelHeight: number;
+    /** PDF points (1/72 inch), independent of the raster resolution. */
+    width: number;
+    height: number;
+}
+export declare function createMynaPdf(pages: MynaPdfPage[]): Uint8Array;

package/dist/types/views/Myna/photoFrameLabels.d.ts

@@ -0,0 +1,28 @@
+declare const en: {
+    title: string;
+    hint: string;
+    rect: string;
+    roundRect: string;
+    ellipse: string;
+    two: string;
+    three: string;
+    four: string;
+    six: string;
+    nine: string;
+    hero: string;
+    fill: string;
+    crop: string;
+    clear: string;
+    gutter: string;
+    swap: string;
+    cell: string;
+    error: string;
+    busy: string;
+    document: string;
+    empty: string;
+};
+type Labels = {
+    [K in keyof typeof en]: string;
+};
+export declare const photoFrameLabels: Record<string, Labels>;
+export {};

package/dist/types/views/Myna/photoFrameUpload.d.ts

@@ -0,0 +1,5 @@
+export declare function loadPhotoFrameImage(input: string | File): Promise<{
+    width: number;
+    height: number;
+    src: string;
+}>;

package/dist/types/views/Myna/photoFrames.d.ts

@@ -0,0 +1,11 @@
+import type { PPTImageElement, ImageClipDataRange } from '../../types/slides';
+export declare const FRAME_LAYOUTS: readonly ['rect', 'roundRect', 'ellipse', 'two', 'three', 'four', 'six', 'nine', 'hero'];
+export type FrameLayout = typeof FRAME_LAYOUTS[number];
+export declare const FRAME_PLACEHOLDER: string;
+/** Cell rectangles in fractional grid units. Mixed-span hero keeps a large left cell. */
+export declare function frameCells(layout: FrameLayout): number[][];
+export declare function coverRange(sourceWidth: number, sourceHeight: number, width: number, height: number): ImageClipDataRange;
+export declare function createPhotoFrames(layout: FrameLayout, width: number, height: number, gutter?: number, name?: string): PPTImageElement[];
+/** Uses current bounds, so moved/resized native groups keep their current location. */
+export declare function layoutPhotoFrames(elements: PPTImageElement[], gutter: number): PPTImageElement[];
+export declare function fillPhotoFrame(element: PPTImageElement, src: string, sourceWidth: number, sourceHeight: number): PPTImageElement;

package/dist/types/views/Myna/qrCode.d.ts

@@ -0,0 +1,7 @@
+import type { PPTImageElement } from '../../types/slides';
+export type QrCodeOptions = NonNullable<PPTImageElement['qrCode']>;
+export declare const DEFAULT_QR: QrCodeOptions;
+export declare function validateQrOptions(options: QrCodeOptions): void;
+/** Encoder owns all QR structure/error correction. SVG is only a vector rendering of its module matrix. */
+export declare function qrSvg(options: QrCodeOptions): string;
+export declare const qrImageSrc: (options: QrCodeOptions) => string;

package/dist/types/views/Myna/qrMessages.d.ts

@@ -0,0 +1,18 @@
+declare const en: {
+    title: string;
+    hint: string;
+    content: string;
+    correction: string;
+    foreground: string;
+    background: string;
+    insert: string;
+    update: string;
+    text: string;
+    contrast: string;
+    error: string;
+    select: string;
+    size: string;
+};
+type Messages = typeof en;
+export declare const qrMessages: (locale: string) => Messages;
+export {};

package/dist/types/views/Myna/svg.d.ts

@@ -0,0 +1,21 @@
+import type { Slide, SlideTheme } from '../../types/slides';
+export interface MynaSvgTarget {
+    slide: Slide;
+    theme: SlideTheme;
+    viewportSize: number;
+    viewportRatio: number;
+}
+export interface MynaSvgOptions {
+    selectedIds?: readonly string[];
+    transparentBackground?: boolean;
+    signal?: AbortSignal;
+}
+export interface MynaSvgResult {
+    blob: Blob;
+    svg: string;
+    width: number;
+    height: number;
+    warnings: string[];
+}
+/** Portable SVG with editable vector primitives; complex unsupported objects are isolated raster fallbacks. */
+export declare function exportMynaSvg(target: MynaSvgTarget, options?: MynaSvgOptions): Promise<MynaSvgResult>;

package/dist/types/views/Myna/svgWatermark.d.ts

@@ -0,0 +1,2 @@
+import type { FikaExportWatermark } from '../../configs/exportWatermark';
+export declare function watermarkSvg(svg: string, width: number, height: number, watermark: FikaExportWatermark, background: string): Promise<Blob>;

package/dist/types/views/Myna/templateLibrary.d.ts

@@ -0,0 +1,26 @@
+import type { Slide, SlideTheme } from '../../types/slides';
+export declare const TEMPLATE_LIBRARY_KEY = "fika:myna:personal-templates:v1";
+export declare const TEMPLATE_LIBRARY_LIMIT: number;
+export interface PersonalTemplate {
+    id: string;
+    name: string;
+    width: number;
+    height: number;
+    slides: Slide[];
+    theme: SlideTheme;
+    createdAt: number;
+    updatedAt: number;
+    lastUsedAt: number;
+    favorite: boolean;
+}
+export interface LibraryStorage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+}
+export declare function readTemplateLibrary(storage: LibraryStorage): PersonalTemplate[];
+export declare function writeTemplateLibrary(storage: LibraryStorage, templates: PersonalTemplate[]): void;
+/** Materialize session-only media before persisting. Remote links remain links, visibly disclosed in the UI. */
+export declare function portableTemplateSlides(slides: readonly Slide[]): Promise<Slide[]>;
+/** Clone every identity and reference. Never re-use IDs from a stored design. */
+export declare function instantiateTemplate(template: PersonalTemplate, width: number, height: number): Slide[];
+export declare function rankTemplates(templates: PersonalTemplate[], width: number, height: number, sort?: 'match' | 'recent'): PersonalTemplate[];

package/dist/types/views/Myna/viewStore.d.ts

@@ -0,0 +1,14 @@
+export interface MynaViewPreferences {
+    showRulers: boolean;
+    showGuides: boolean;
+    snapToGuides: boolean;
+    guidesLocked: boolean;
+    snapPages: boolean;
+    snapPagesToGrid: boolean;
+    showGrid: boolean;
+    gridSize: number;
+}
+export interface MynaViewState extends MynaViewPreferences {
+    setPreference: <K extends keyof MynaViewPreferences>(key: K, value: MynaViewPreferences[K]) => void;
+}
+export declare const useMynaViewStore: import("zustand").UseBoundStore<import("zustand").StoreApi<MynaViewState>>;

package/dist/types/views/Myna/workspaceLabels.d.ts

@@ -0,0 +1,10 @@
+import type { WorkspaceLabel, Slide } from '../../types/slides';
+/** Conservative text extents for workspace camera fitting; labels remain non-artwork. */
+export declare function workspaceLabelsBounds(slides: readonly Slide[], pageWidth?: number, pageHeight?: number): {
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+};
+/** Sections grow to include their explicit member pages, without changing page positions. */
+export declare function workspaceObjectRect(label: WorkspaceLabel, slides: readonly Pick<Slide, 'id' | 'canvasPosition'>[], width: number, height: number): WorkspaceLabel;

package/dist/types/views/Myna/workspaceSelectors.d.ts

@@ -0,0 +1,17 @@
+import type { Slide } from '../../types/slides';
+type Source = {
+    slides: Slide[];
+};
+export type WorkspacePage = Pick<Slide, 'id' | 'canvasName' | 'canvasPosition' | 'guides'>;
+export type WorkspaceAnnotations = Pick<Slide, 'id' | 'workspaceLabels'>;
+export declare const selectWorkspacePages: (state: Source) => WorkspacePage[];
+export declare const selectWorkspacePageNames: (state: Source) => Pick<Slide, "canvasName" | "id">[];
+export declare const selectWorkspaceAnnotations: (state: Source) => WorkspaceAnnotations[];
+export declare const useWorkspacePages: () => WorkspacePage[];
+export declare const useWorkspaceAnnotations: () => WorkspaceAnnotations[];
+export declare const selectWorkspacePageSummaries: (state: Source) => {
+    id: string;
+    canvasName?: string;
+    summary: string;
+}[];
+export {};

package/docs/AGENTIC_BRIDGE.md

@@ -527,3 +527,26 @@ properties to existing slide content. For example, `{ theme: { fontName:
 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.
+
+## Canvas authoring with compact context
+
+Myna uses the same native document and command bus. `canvas.get` returns a bounded
+page overview plus element IDs, geometry, frame relationships, and short text
+excerpts for one page. It excludes image bytes, SVG paths, and rich-text HTML.
+The default read is 40 elements with 160 text characters each; `offset`, `limit`
+(maximum 100), and `textLimit` (maximum 500) let hosts request only what is needed.
+
+`canvas.apply` accepts `{ operations: [...] }` (1–100 operations) and returns only
+operation acknowledgements and IDs. One call is one undoable transaction, and a
+failure rolls back the entire call. Operations are `title`, `viewport`, `page`,
+`pageUpdate`, `text`, `textUpdate`, `shape`, `element`, `update`, and `remove`.
+Use explicit IDs to reference newly created pages/elements in the same call.
+Text is authored as Markdown with fixed-size boxes. `textUpdate` preserves the
+existing first-run typography unless `style` overrides it. The `element` and
+`update` operations expose native artwork types and nested-frame properties.
+Existing bridge commands remain available for specialized editing.
+
+For an initial invitation, batch the title, viewport, page, decorative shapes,
+and text. For a revision, read only the target page and send targeted operations;
+do not resend the document or automatically attach a screenshot on every turn.
+The first `page` operation reuses an untouched, unnamed empty starter page.

package/docs/EMBED.md

@@ -519,3 +519,36 @@ 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.
+
+### Content-aware canvas resizing
+
+`controller.deck.setViewport({ ratio: 0.75 })` fits the entire deck to 4:3 in
+one undo step, using the same operation as the size menu and custom size dialog.
+It identifies full-width headings and independent body columns, distributes
+rows through their available height, scales type with its boxes, preserves media
+proportions and groups, remaps connectors, and anchors vector edge decorations.
+It consumes spare vertical gutters before shrinking type when returning to a
+shorter canvas. It preserves the authored composition rather than inventing a
+new reading order or cropping photographs. Imported objects already outside the
+canvas may still need manual correction.
+
+Hosts authoring slides into a differently sized deck can use the pure,
+DOM-free `resizeDeckSlides(slides, from, to)` export from `fika-editor/layout`;
+`from` and `to` are `{ width, height }`. Raw document loading remains available
+through `deck.set` / `deck.patch` with `slides` and `viewport` supplied together.
+
+Host design themes can opt into `preserveColorRoles: true` to keep pale panels,
+neutral surfaces and saturated accents separate during theme application.
+Text is retinted against the actual panel beneath it, including badge and table
+cell fills. Named `Decor` shapes become soft accents on the selected background.
+Reapplying a selected theme is supported, including for older generated decks.
+
+
+## Myna graphic design mode
+
+Pass `viewMode: 'canva'` (or its `'myna'` alias) to open the Myna design
+workspace. Omit `document` for its square editable starter, or provide any
+ordinary Fika document and viewport. `createMynaDocument()` and `MYNA_FORMATS`
+are exported for hosts that need the starter or format catalog. The same
+controller, history, media uploader, read-only options, and change callbacks
+apply. See [Myna integration and capabilities](./MYNA.md).