@templatical/core 0.0.6 → 0.1.0

package/LICENSE

@@ -0,0 +1,56 @@
+Functional Source License, Version 1.1, MIT Future License
+
+Copyright (c) 2026-present Templatical
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+Templatical
+
+### The Software
+
+Templatical Email Editor — the visual drag-and-drop email template editor
+(@templatical/core, @templatical/editor, and @templatical/media-library
+packages).
+
+### Grant of Rights
+
+Subject to the terms and conditions of this License, We hereby grant You a
+non-exclusive, worldwide, non-transferable license to use, copy, modify,
+create derivative works, and redistribute the Software, subject to the
+following conditions:
+
+### Permitted Uses
+
+You may use the Software for any purpose, including commercial purposes,
+**provided that** you do not offer the Software, or a substantially similar
+product built using the Software, as a hosted or managed service that
+competes with Templatical's commercial offerings.
+
+### Change Date
+
+Two (2) years from the date of each release of the Software.
+
+### Change License
+
+MIT License
+
+On the Change Date, the above copyright notice and this permission notice
+shall be replaced with the MIT License, and the Software will be available
+under the MIT License for all purposes without restriction.
+
+### Notices
+
+You must retain this license notice in all copies or substantial portions
+of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+
+---
+
+Note: The @templatical/types, @templatical/renderer, and
+@templatical/import-beefree packages are licensed separately under the MIT
+License. See LICENSE-MIT for those packages' terms.

package/README.md

@@ -0,0 +1,64 @@
+# @templatical/core
+
+> Framework-agnostic editor logic — state, history, auto-save. The reactive engine behind `@templatical/editor`.
+
+[![npm version](https://img.shields.io/npm/v/@templatical/core?label=npm&color=cb3837)](https://www.npmjs.com/package/@templatical/core)
+[![License](https://img.shields.io/badge/license-FSL--1.1--MIT-blue)](https://github.com/templatical/sdk/blob/main/LICENSE)
+
+Powers [`@templatical/editor`](https://www.npmjs.com/package/@templatical/editor). Use this package directly if you want to build a custom UI on top of the Templatical state model — for example, a CLI tool, automation pipeline, or your own visual editor.
+
+Built on `@vue/reactivity` (no full Vue runtime), so it works anywhere reactive primitives do.
+
+## Install
+
+```bash
+npm install @templatical/core @templatical/types
+```
+
+## Usage
+
+```ts
+import { useEditor } from '@templatical/core';
+import { createDefaultTemplateContent, createTitleBlock } from '@templatical/types';
+import { watch } from '@vue/reactivity';
+
+const editor = useEditor({
+  content: createDefaultTemplateContent(),
+});
+
+// Mutate state — these methods live on the editor return value
+editor.addBlock(createTitleBlock({ text: 'Welcome!' }));
+editor.selectBlock(editor.content.value.blocks[0].id);
+
+// Read reactive state
+console.log(editor.content.value);          // current TemplateContent
+console.log(editor.selectedBlock.value);    // currently selected Block | null
+console.log(editor.state.isDirty);          // dirty flag
+
+// React to changes
+watch(editor.content, (next) => {
+  console.log('Template updated', next);
+});
+```
+
+## Exports
+
+- `useEditor` — reactive state (content, selection, viewport, darkMode, isDirty) + mutation methods (`addBlock`, `removeBlock`, `moveBlock`, `updateBlock`, `updateSettings`, `selectBlock`, …)
+- `useHistory` — undo/redo stack
+- `useHistoryInterceptor` — wraps mutation methods so they push onto the history stack automatically
+- `useBlockActions` — higher-level helpers built on top of `useEditor` (`createAndAddBlock(type)`, `duplicateBlock`, `deleteBlock`, `updateBlockProperty`)
+- `useAutoSave` — debounced save with onSave callback
+- `useConditionPreview` — display condition preview state
+- `useDataSourceFetch` — fetch helper for custom block data sources
+
+## Cloud subpath
+
+The `@templatical/core/cloud` subpath provides Templatical Cloud integrations (Auth, API client, WebSocket, AI chat/rewrite, collaboration, comments, scoring). Used by `@templatical/editor`'s `initCloud()`. See [Cloud docs](https://docs.templatical.com/cloud/).
+
+## Documentation
+
+Full reference at **[docs.templatical.com](https://docs.templatical.com)**.
+
+## License
+
+[FSL-1.1-MIT](https://github.com/templatical/sdk/blob/main/LICENSE) — free for any non-competing commercial use, automatically converts to MIT after 2 years per release.

package/dist/cloud/index.js

@@ -262,6 +262,7 @@ var ApiClient = class {
   constructor(authManager) {
     this.authManager = authManager;
   }
+  authManager;
   get projectId() {
     return this.authManager.projectId;
   }