@lit-pigeon/editor 0.1.3 → 0.3.0

package/dist/index.d.ts

@@ -1,18 +1,24 @@
 import { AssetManagerConfig } from '@lit-pigeon/core';
 import { AssetStorage } from '@lit-pigeon/core';
+import { BrandColor } from '@lit-pigeon/core';
+import { BrandKit } from '@lit-pigeon/core';
 import { ButtonBlock } from '@lit-pigeon/core';
 import { ColumnNode } from '@lit-pigeon/core';
 import { CSSResult } from 'lit';
 import { DividerBlock } from '@lit-pigeon/core';
 import { EditorConfig } from '@lit-pigeon/core';
+import { FontDefinition } from '@lit-pigeon/core';
 import { HeroBlock } from '@lit-pigeon/core';
 import { HtmlBlock } from '@lit-pigeon/core';
 import { ImageBlock } from '@lit-pigeon/core';
+import { LinkType } from '@lit-pigeon/core';
 import { LitElement } from 'lit';
 import { MergeTag } from '@lit-pigeon/core';
 import { NavBarBlock } from '@lit-pigeon/core';
 import { PigeonDocument } from '@lit-pigeon/core';
+import { PropertyValues } from 'lit';
 import { Renderer } from '@lit-pigeon/core';
+import { RowLibraryStorage } from '@lit-pigeon/core';
 import { RowNode } from '@lit-pigeon/core';
 import { Selection as Selection_2 } from '@lit-pigeon/core';
 import { SocialBlock } from '@lit-pigeon/core';
@@ -46,13 +52,11 @@ export declare interface DragData {
     blockId?: string;
     rowId?: string;
     columnId?: string;
+    /** Saved row node for library-row drags. */
+    node?: RowNode;
 }
 
-/**
- * Drag-and-drop manager using native HTML5 drag/drop API.
- * Stores drag state globally so any component can query it.
- */
-export declare type DragItemType = 'palette-block' | 'palette-row' | 'existing-block' | 'existing-row';
+export declare type DragItemType = 'palette-block' | 'palette-row' | 'existing-block' | 'existing-row' | 'library-row';
 
 /**
  * Drop-zone calculation utilities.
@@ -97,6 +101,7 @@ export declare class PigeonAssetManager extends LitElement {
      * cycle out of an update→state→update loop on initial property arrival.
      */
     private _tab;
+    private _stockTabLoaded;
     private _dragOver;
     private _uploading;
     private _progress;
@@ -119,8 +124,11 @@ export declare class PigeonAssetManager extends LitElement {
     static styles: CSSResult;
     updated(changed: Map<string, unknown>): void;
     private get _activeTab();
+    private get _hasStock();
     render(): TemplateResult<1>;
     private _renderTabs;
+    private _handleStockTabClick;
+    private _renderStock;
     private _renderLibrary;
     private _renderAssetCard;
     private _renderUpload;
@@ -146,13 +154,14 @@ export declare class PigeonAssetManager extends LitElement {
 export declare class PigeonBodyPanel extends LitElement {
     doc: PigeonDocument;
     mergeTags: MergeTag[];
+    swatches: BrandColor[];
+    brandFonts: FontDefinition[];
     private _pickerOpen;
     private _pickerX;
     private _pickerY;
     private _previewInputRef;
     private _triggerRef;
     static styles: CSSResult[];
-    private _fontFamilies;
     render(): TemplateResult<1>;
     private _togglePicker;
     private _onMergeTagInsert;
@@ -188,12 +197,15 @@ export declare class PigeonButtonPanel extends LitElement {
     block: ButtonBlock;
     rowId: string;
     columnId: string;
+    swatches: BrandColor[];
+    linkTypes: LinkType[];
     static styles: CSSResult;
     render(): TemplateResult<1>;
     private _emit;
     private _onTextChange;
     private _contentToText;
     private _onHrefChange;
+    private _onLinkTypeSelect;
     private _onBgColorChange;
     private _onTextColorChange;
     private _onBorderRadiusChange;
@@ -247,8 +259,11 @@ export declare class PigeonCanvas extends LitElement {
 export declare class PigeonColorPicker extends LitElement {
     label: string;
     value: string;
+    /** Optional brand-kit swatches rendered as quick-pick buttons. */
+    swatches: BrandColor[];
     static styles: CSSResult;
     render(): TemplateResult<1>;
+    private _applySwatch;
     private _onColorInput;
     private _onTextChange;
     private _emitChange;
@@ -261,6 +276,9 @@ export declare class PigeonColumn extends LitElement {
     editingBlockId: string | null;
     private _dropIndex;
     private _isDragOver;
+    /** Id of the block currently being dragged from this column, or null. Dims
+     *  the source block while a reorder drag is in flight. */
+    private _draggingBlockId;
     static styles: CSSResult;
     render(): TemplateResult<1>;
     private _renderBlock;
@@ -275,6 +293,9 @@ export declare class PigeonColumn extends LitElement {
     private _onDragOver;
     private _onDragLeave;
     private _onDrop;
+    private _resetDragState;
+    private _onBlockDragStart;
+    private _onBlockDragEnd;
 }
 
 export declare class PigeonDividerBlock extends LitElement {
@@ -350,7 +371,9 @@ export declare class PigeonEditor extends LitElement {
     /** Optional renderer for preview mode. */
     renderer?: Renderer;
     /** Optional function to convert document to MJML. */
-    documentToMjml?: (doc: PigeonDocument) => string;
+    documentToMjml?: (doc: PigeonDocument, options?: {
+        fonts?: FontDefinition[];
+    }) => string;
     /**
      * Optional template storage backend. When unset, the editor falls back to
      * an in-memory storage seeded with the starter templates so the picker is
@@ -377,12 +400,23 @@ export declare class PigeonEditor extends LitElement {
     private _editingBlockId;
     /** Lazily-initialised default template storage. */
     private _defaultTemplateStorage?;
+    /** Lazily-initialised default row library storage. */
+    private _defaultRowLibrary?;
     /** In-memory clipboard for Cmd/Ctrl+C / Cmd/Ctrl+V on blocks. */
     private _clipboard;
+    private _activeBrandKit;
+    private _brandKitStorage;
     static styles: CSSResult[];
     connectedCallback(): void;
     disconnectedCallback(): void;
     updated(changed: Map<string, unknown>): void;
+    /**
+     * Set the host `dir` attribute based on `config.locale` and `config.dir`.
+     * The host `dir` attribute drives the layout direction automatically for RTL locales.
+     * The `.editor-body` flex layout will flip under `dir="rtl"` via the browser's built-in
+     * bidirectional layout support.
+     */
+    private _applyDir;
     /**
      * Sync the active `theme` to the host classes the token sheet keys off, and
      * apply any `themeOverrides` as inline custom properties.
@@ -407,6 +441,23 @@ export declare class PigeonEditor extends LitElement {
     setMergeTags(tags: MergeTag[]): void;
     render(): TemplateResult<1>;
     private _resolveTemplateStorage;
+    private _resolveRowLibrary;
+    private _linkTypes;
+    /**
+     * Resolve `config.brandKit` into a single active kit. A plain `BrandKit` is
+     * used directly; a `BrandKitStorage` (duck-typed by a `list` method) is
+     * async-loaded and the first kit becomes active.
+     */
+    private _resolveBrandKit;
+    /** Fonts to load in preview/export: host fontConfig + brand fonts that carry a URL, deduped by family. */
+    private _renderFonts;
+    private _emitBrandKitError;
+    private _handleBrandKitEdit;
+    /** Apply a single body attribute through an undoable transaction. */
+    private _applyBodyAttribute;
+    private _handleBrandColorApply;
+    private _handleBrandFontApply;
+    private _handleBrandLogoInsert;
     private _handleTemplatesOpen;
     private _handleTemplateLoad;
     private _handleTemplateSave;
@@ -433,6 +484,12 @@ export declare class PigeonEditor extends LitElement {
     private _handleRowMove;
     private _handleRowDuplicate;
     private _handleRowDelete;
+    private _handleRowSave;
+    private _handleRowInsertSaved;
+    private _handleLibraryInsert;
+    private _handleLibraryDelete;
+    private _refreshSavedTab;
+    private _emitRowLibraryError;
     /**
      * Returns true if the event originates from a text-editing context
      * (input, textarea, select, or contentEditable element), in which
@@ -485,6 +542,7 @@ export declare class PigeonHeroPanel extends LitElement {
     columnId: string;
     assetManagerConfig?: AssetManagerConfig;
     assetStorage?: AssetStorage;
+    swatches: BrandColor[];
     private _assetManagerOpen;
     static styles: CSSResult[];
     render(): TemplateResult<1>;
@@ -577,6 +635,7 @@ export declare class PigeonNavBarPanel extends LitElement {
     block: NavBarBlock;
     rowId: string;
     columnId: string;
+    swatches: BrandColor[];
     static styles: CSSResult[];
     render(): TemplateResult<1>;
     private _emit;
@@ -595,13 +654,22 @@ export declare class PigeonNavBarPanel extends LitElement {
 export declare class PigeonPalette extends LitElement {
     doc?: PigeonDocument;
     selection: Selection_2 | null;
+    brandKit: BrandKit | null;
+    rowLibrary: RowLibraryStorage | null;
     private _blockDefs;
     private _activeTab;
+    private _brandTabLoaded;
+    private _savedTabLoaded;
     static styles: CSSResult;
     connectedCallback(): void;
+    updated(changed: PropertyValues): void;
     render(): TemplateResult<1>;
     private _renderContentTab;
     private _renderLayersTab;
+    private _handleBrandTabClick;
+    private _renderBrandTab;
+    private _handleSavedTabClick;
+    private _renderSavedTab;
 }
 
 export declare class PigeonPaletteItem extends LitElement {
@@ -623,7 +691,10 @@ export declare class PigeonPaletteItem extends LitElement {
 export declare class PigeonPreview extends LitElement {
     renderer?: Renderer;
     doc?: PigeonDocument;
-    documentToMjml?: (doc: PigeonDocument) => string;
+    documentToMjml?: (doc: PigeonDocument, options?: {
+        fonts?: FontDefinition[];
+    }) => string;
+    fonts: FontDefinition[];
     open: boolean;
     private _viewMode;
     private _device;
@@ -656,6 +727,11 @@ export declare class PigeonProperties extends LitElement {
     mergeTags: MergeTag[];
     assetManagerConfig?: AssetManagerConfig;
     assetStorage?: AssetStorage;
+    brandKit: BrandKit | null;
+    fontConfig: FontDefinition[];
+    linkTypes: LinkType[];
+    private get _swatches();
+    private get _brandFonts();
     static styles: CSSResult;
     render(): TemplateResult<1>;
     /**
@@ -688,6 +764,7 @@ export declare class PigeonRow extends LitElement {
     private _onMoveUp;
     private _onMoveDown;
     private _onDuplicate;
+    private _onSave;
     private _onDelete;
     private _onDragStart;
     private _onDragEnd;
@@ -696,7 +773,7 @@ export declare class PigeonRow extends LitElement {
 export declare class PigeonRowPanel extends LitElement {
     row: RowNode;
     static styles: CSSResult[];
-    private _layouts;
+    private get _layouts();
     render(): TemplateResult<1>;
     private _emitRowUpdate;
     private _onLayoutSelect;