@lit-pigeon/editor 0.1.2 → 0.2.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.
@@ -146,13 +150,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 +193,15 @@ export declare class PigeonButtonPanel extends LitElement {
     block: ButtonBlock;
     rowId: string;
     columnId: string;
-    static styles: CSSResult[];
+    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;
@@ -217,6 +225,9 @@ export declare class PigeonCanvas extends LitElement {
     device: 'desktop' | 'tablet' | 'mobile';
     private _rowDropIndex;
     private _isDragOver;
+    /** Row currently under the pointer, or null. Drives which single row shows
+     *  its action bar so adjacent rows' bars never overlap. */
+    private _hoveredRowId;
     static styles: CSSResult;
     render(): TemplateResult<1>;
     /**
@@ -226,6 +237,14 @@ export declare class PigeonCanvas extends LitElement {
      * the frame stays neutral).
      */
     private _renderCanvasArea;
+    /**
+     * Tracks the row under the pointer by walking the composed path for the
+     * nearest `<pigeon-row>`. Because the action bar is a DOM child of the row
+     * (even though it sits in the outer margin), hovering the bar still resolves
+     * to that row, so it stays visible. Over empty canvas it resolves to null,
+     * falling back to the selected row.
+     */
+    private _onPointerOverRow;
     private _onCanvasClick;
     private _onDragOver;
     private _onDragLeave;
@@ -236,8 +255,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;
@@ -250,6 +272,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;
@@ -264,6 +289,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 {
@@ -339,7 +367,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
@@ -366,12 +396,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.
@@ -396,6 +437,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;
@@ -417,10 +475,17 @@ export declare class PigeonEditor extends LitElement {
     private _handleBlockExitEdit;
     private _handleBlockSelect;
     private _handleRowSelect;
+    private _handleColumnSelect;
     private _handleBodySelect;
     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
@@ -473,6 +538,7 @@ export declare class PigeonHeroPanel extends LitElement {
     columnId: string;
     assetManagerConfig?: AssetManagerConfig;
     assetStorage?: AssetStorage;
+    swatches: BrandColor[];
     private _assetManagerOpen;
     static styles: CSSResult[];
     render(): TemplateResult<1>;
@@ -565,6 +631,7 @@ export declare class PigeonNavBarPanel extends LitElement {
     block: NavBarBlock;
     rowId: string;
     columnId: string;
+    swatches: BrandColor[];
     static styles: CSSResult[];
     render(): TemplateResult<1>;
     private _emit;
@@ -583,13 +650,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 {
@@ -611,7 +687,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;
@@ -644,8 +723,22 @@ 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>;
+    /**
+     * Renders the parent-selection trail. `Row` is always a clickable jump to
+     * the parent row. When a block is selected (`current` set), `Column` is also
+     * clickable and the block label is the trailing, non-interactive crumb. For
+     * a column selection (`current` omitted) `Column` is the trailing crumb.
+     */
+    private _renderBreadcrumb;
+    private _select;
+    private _blockLabel;
     private _renderBlockPanel;
     private _findRow;
     private _findBlock;
@@ -657,6 +750,9 @@ export declare class PigeonRow extends LitElement {
     totalRows: number;
     selection: Selection_2 | null;
     editingBlockId: string | null;
+    /** Whether to show this row's action bar / label. The canvas drives this so
+     *  that only one row shows its bar at a time (see pigeon-canvas). */
+    showActions: boolean;
     private _dragging;
     static styles: CSSResult;
     render(): TemplateResult<1>;
@@ -664,6 +760,7 @@ export declare class PigeonRow extends LitElement {
     private _onMoveUp;
     private _onMoveDown;
     private _onDuplicate;
+    private _onSave;
     private _onDelete;
     private _onDragStart;
     private _onDragEnd;
@@ -672,7 +769,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;