@lit-pigeon/core 0.2.0 → 0.3.1

package/README.md

@@ -0,0 +1,57 @@
+# @lit-pigeon/core
+
+The pure TypeScript engine behind the [Lit Pigeon](https://github.com/snxstudio/lit-pigeon)
+email editor — document schema, immutable `EditorState` + `Transaction`
+system, commands, undo/redo history, a ProseMirror-inspired plugin registry,
+and the starter-template / brand-kit / asset / row-library storage
+interfaces. Zero runtime UI dependencies, so it runs in the browser, Node, or
+an edge worker.
+
+## Install
+
+```bash
+npm install @lit-pigeon/core
+```
+
+## Usage
+
+```ts
+import {
+  createDefaultDocument,
+  EditorState,
+  createHistoryPlugin,
+  validateDocument,
+  getStarterTemplates,
+} from '@lit-pigeon/core';
+
+// Start from a blank document, or a starter template.
+const doc = createDefaultDocument();
+const [welcome] = getStarterTemplates(); // welcome / newsletter / transactional / promo
+// welcome.document is a PigeonDocument
+
+// Drive edits through immutable transactions (with undo/redo history).
+let state = EditorState.create({ doc, plugins: [createHistoryPlugin()] });
+const tr = state.createTransaction();
+// ...apply command steps to `tr`, then:
+state = state.apply(tr);
+
+// Validate before rendering / persisting.
+const errors = validateDocument(state.doc);
+```
+
+`PigeonDocument` is a plain JSON tree (`body → rows → columns → blocks`), so it
+serialises anywhere. Render it to email HTML with
+[`@lit-pigeon/renderer-mjml`](../renderer-mjml) or
+[`@lit-pigeon/ssr`](../ssr).
+
+Also exported: the command set (`insertBlock`, `moveBlock`, `insertRow`,
+`resizeColumns`, …), `createBlock`/`createRow` factories, `undo`/`redo`, the
+block registry (`registerBlock`, `getBlockDefinition`), and in-memory storage
+adapters (`InMemoryTemplateStorage`, `InMemoryBrandKitStorage`,
+`InMemoryAssetStorage`, `InMemoryRowLibraryStorage`).
+
+Part of [Lit Pigeon](https://github.com/snxstudio/lit-pigeon) — open-source drag-and-drop email editor.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -60,6 +60,7 @@ export declare interface AssetManagerConfig {
     presignedUpload?: {
         getUploadParams: (file: File) => Promise<PresignedUploadParams>;
     };
+    stock?: StockConfig;
 }
 
 /**
@@ -766,6 +767,23 @@ export declare interface Step {
     invert(doc: PigeonDocument): Step;
 }
 
+export declare interface StockConfig {
+    /** Unsplash Access Key (used client-side). Enables the Unsplash source. */
+    unsplash?: {
+        accessKey: string;
+    };
+    /** Pexels API key (used client-side). Enables the Pexels source. */
+    pexels?: {
+        apiKey: string;
+    };
+    /**
+     * utm_source label for Unsplash attribution links and the download-ping
+     * request. Unsplash guidelines require identifying your application.
+     * Defaults to "lit-pigeon" when unset; hosts should override.
+     */
+    appName?: string;
+}
+
 /**
  * Built-in system link types. `unsubscribe`/`view-in-browser` emit fixed
  * `{{…}}` placeholder hrefs (conventional ESP tokens, resolved by the host at

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lit-pigeon/core",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Pure TypeScript engine for the Pigeon email editor",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -14,7 +14,9 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md",
+    "LICENSE"
   ],
   "dependencies": {
     "immer": "^10.1.0",
@@ -37,6 +39,20 @@
     "directory": "packages/core"
   },
   "license": "MIT",
+  "homepage": "https://github.com/snxstudio/lit-pigeon/tree/main/packages/core#readme",
+  "bugs": "https://github.com/snxstudio/lit-pigeon/issues",
+  "author": "Lit Pigeon Contributors",
+  "keywords": [
+    "email",
+    "email-template",
+    "email-editor",
+    "mjml",
+    "html-email",
+    "lit",
+    "web-components",
+    "drag-and-drop",
+    "no-code"
+  ],
   "scripts": {
     "build": "vite build",
     "dev": "vite build --watch",