@travetto/email-compiler 8.0.0-alpha.16 → 8.0.0-alpha.18

package/README.md

@@ -53,14 +53,22 @@ The module provides [Command Line Interface](https://github.com/travetto/travett
 ## CLI Compilation
 The module provides [Command Line Interface](https://github.com/travetto/travetto/tree/main/module/cli#readme "CLI infrastructure for Travetto framework") support for email template compilation also. Running
 
-**Terminal: Running template compilation**
+## CLI - email:compile
+
+**Terminal: Help for email:compile**
 ```bash
 $ trv email:compile --help
 
 Usage: email:compile [options]
 
+Compile all email templates into generated runtime artifacts.
+
+The command discovers templated inputs (for example, `.email.html`) and emits
+compiled outputs used at runtime (html/text/subject variants). With watch
+enabled, recompilation runs automatically on matching template changes.
+
 Options:
-  -w, --watch  Compile in watch mode
+  -w, --watch  Recompile templates whenever source templates change.
   --help       display help for command
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@travetto/email-compiler",
-  "version": "8.0.0-alpha.16",
+  "version": "8.0.0-alpha.18",
   "type": "module",
   "description": "Email compiling module",
   "keywords": [
@@ -27,20 +27,20 @@
     "directory": "module/email-compiler"
   },
   "dependencies": {
-    "@travetto/config": "^8.0.0-alpha.15",
-    "@travetto/di": "^8.0.0-alpha.14",
-    "@travetto/email": "^8.0.0-alpha.15",
-    "@travetto/image": "^8.0.0-alpha.14",
-    "@travetto/runtime": "^8.0.0-alpha.14",
-    "@travetto/worker": "^8.0.0-alpha.14",
+    "@travetto/config": "^8.0.0-alpha.17",
+    "@travetto/di": "^8.0.0-alpha.16",
+    "@travetto/email": "^8.0.0-alpha.17",
+    "@travetto/image": "^8.0.0-alpha.16",
+    "@travetto/runtime": "^8.0.0-alpha.16",
+    "@travetto/worker": "^8.0.0-alpha.16",
     "@types/inline-css": "^3.0.4",
     "html-entities": "^2.6.0",
     "inline-css": "^4.0.3",
     "purgecss": "^8.0.0",
-    "sass": "^1.99.0"
+    "sass": "^1.100.0"
   },
   "peerDependencies": {
-    "@travetto/cli": "^8.0.0-alpha.20"
+    "@travetto/cli": "^8.0.0-alpha.22"
   },
   "peerDependenciesMeta": {
     "@travetto/cli": {

package/support/cli.email_compile.ts

@@ -6,12 +6,16 @@ import { EmailCompiler } from '../src/compiler.ts';
 import { EmailCompileUtil } from '../src/util.ts';
 
 /**
- * CLI Entry point for running the email server
+ * Compile all email templates into generated runtime artifacts.
+ *
+ * The command discovers templated inputs (for example, `.email.html`) and emits
+ * compiled outputs used at runtime (html/text/subject variants). With watch
+ * enabled, recompilation runs automatically on matching template changes.
  */
 @CliCommand()
 export class EmailCompileCommand implements CliCommandShape {
 
-  /** Compile in watch mode */
+  /** Recompile templates whenever source templates change. */
   watch?: boolean;
 
   finalize(): void {

package/support/cli.email_editor.ts

@@ -5,7 +5,12 @@ import { DependencyRegistryIndex } from '@travetto/di';
 
 import { EditorService } from './bin/editor.ts';
 
-/** The email editor compilation service and output serving */
+/**
+ * Start the email template editor service for interactive preview and testing.
+ *
+ * The editor compiles templates on demand and hosts the preview/test workflow
+ * used during local template authoring.
+ */
 @CliCommand()
 export class EmailEditorCommand {
 

package/support/cli.email_test.ts

@@ -8,7 +8,10 @@ import { Env } from '@travetto/runtime';
 import { EditorService } from './bin/editor.ts';
 
 /**
- * CLI Entry point for running the email server
+ * Render and send a template file to a target recipient for quick validation.
+ *
+ * This command is useful during template development to verify real delivery and
+ * formatting without running the full editor workflow.
  */
 @CliCommand()
 export class EmailTestCommand implements CliCommandShape {