coffeehaml 0.6.0 → 0.7.1

package/dist/src/vite-plugin.js

@@ -0,0 +1,78 @@
+// Generated by CoffeeScript 2.7.0
+// vite-plugin.coffee — Vite plugin for CoffeeHaml
+var COFFEEHAML_RE, coffeehaml, componentNameFromPath;
+
+import {
+  compile
+} from './compiler.js';
+
+import {
+  basename
+} from 'path';
+
+COFFEEHAML_RE = /\.(coffeehaml|cohaml|chaml)$/;
+
+componentNameFromPath = function(filepath) {
+  var stem;
+  stem = basename(filepath).split('.').shift() || 'Component';
+  return stem.charAt(0).toUpperCase() + stem.slice(1);
+};
+
+export default coffeehaml = function(options = {}) {
+  var compilerOpts, ref;
+  compilerOpts = Object.assign({
+    sourceMap: true,
+    wrap: 'component'
+  }, (ref = options.compilerOptions) != null ? ref : {});
+  return {
+    name: 'coffeehaml',
+    transform: function(code, id) {
+      var err, finalCode, name, postamble, preamble, result;
+      if (!COFFEEHAML_RE.test(id)) {
+        return;
+      }
+      result = compile(code, ...compilerOpts, {
+        filename: id,
+        componentName: compilerOpts.componentName || componentNameFromPath(id)
+      });
+      preamble = '';
+      postamble = '';
+      if (compilerOpts.wrap && compilerOpts.wrap !== 'none' && !Array.isArray(compilerOpts.wrap)) {
+        preamble = '// @refresh reset\n';
+        name = compilerOpts.componentName || componentNameFromPath(id);
+        postamble = `\nif (import.meta.hot) {
+  import.meta.hot.accept((mod) => {
+    if (mod?.${name}) import.meta.hot?.data?.refresh?.();
+  });
+}\n`;
+      }
+      finalCode = preamble + result.code + postamble;
+      if (result.errors.length > 0) {
+        err = result.errors[0];
+        this.error({
+          message: err.message
+        }, id, {
+          loc: err.location ? {
+            line: err.location.start.line + 1,
+            column: err.location.start.column + 1
+          } : void 0
+        });
+        return null;
+      }
+      return {
+        code: finalCode,
+        map: result.sourceMap ? {
+          mappings: result.sourceMap
+        } : null
+      };
+    },
+    handleHotUpdate: function({file, server}) {
+      if (COFFEEHAML_RE.test(file)) {
+        server.ws.send({
+          type: 'full-reload'
+        });
+        return [];
+      }
+    }
+  };
+};

package/dist/types.js

@@ -1,12 +1,122 @@
-/** Compiler error with source location. */
-export class CompileError extends Error {
-    constructor(message, phase, code, location, hint) {
-        super(message);
-        this.name = 'CompileError';
-        this.phase = phase;
-        this.code = code;
-        this.location = location;
-        this.hint = hint;
-    }
-}
-//# sourceMappingURL=types.js.map
+// Generated by CoffeeScript 2.7.0
+// types.coffee — shared types for CoffeeHaml compiler
+// CoffeeScript version — interfaces become plain classes with JSDoc
+
+// ─── Source Location ───────────────────────────────────────
+export var SourcePosition = (function() {
+  class SourcePosition {
+    constructor(line, column) {
+      this.line = line;
+      this.column = column;
+    }
+
+  };
+
+  SourcePosition.prototype.line = 0; // 0-based
+
+  SourcePosition.prototype.column = 0; // 0-based
+
+  return SourcePosition;
+
+}).call(this);
+
+export var SourceLocation = (function() {
+  class SourceLocation {
+    constructor({start, end, offset, length, file}) {
+      this.start = start;
+      this.end = end;
+      this.offset = offset;
+      this.length = length;
+      this.file = file;
+    }
+
+  };
+
+  SourceLocation.prototype.start = null; // SourcePosition
+
+  SourceLocation.prototype.end = null; // SourcePosition
+
+  SourceLocation.prototype.offset = 0;
+
+  SourceLocation.prototype.length = 0;
+
+  SourceLocation.prototype.file = null;
+
+  return SourceLocation;
+
+}).call(this);
+
+export var CompileError = (function() {
+  // ─── Compile Error ─────────────────────────────────────────
+  class CompileError extends Error {
+    constructor(message, phase, code, location = null, hint = null) {
+      super(message);
+      this.phase = phase;
+      this.code = code;
+      this.location = location;
+      this.hint = hint;
+      this.name = 'CompileError';
+    }
+
+  };
+
+  CompileError.prototype.location = null;
+
+  CompileError.prototype.phase = '';
+
+  CompileError.prototype.hint = null;
+
+  CompileError.prototype.code = '';
+
+  return CompileError;
+
+}).call(this);
+
+export var CompileWarning = (function() {
+  // ─── Compile Warning ───────────────────────────────────────
+  class CompileWarning {
+    constructor(message1, location = null, phase = '') {
+      this.message = message1;
+      this.location = location;
+      this.phase = phase;
+    }
+
+  };
+
+  CompileWarning.prototype.message = '';
+
+  CompileWarning.prototype.location = null;
+
+  CompileWarning.prototype.phase = '';
+
+  return CompileWarning;
+
+}).call(this);
+
+// ─── Compiler Options ──────────────────────────────────────
+export var CompilerOptions = null; // plain object, documented below
+
+
+// CompilerOptions shape:
+//   filename?: string
+//   sourceMap?: boolean
+//   jsxRuntime?: string
+//   jsxImportSource?: string
+//   filters?: { [name: string]: (content: string, filterName: string) => string }
+//   wrap?: 'none' | 'component' | 'observer' | string[]
+//   componentName?: string
+
+// ─── Compile Result ────────────────────────────────────────
+export var CompileResult = null; // { code, sourceMap?, errors: CompileError[], warnings: CompileWarning[] }
+
+
+// ─── Emitter Options ───────────────────────────────────────
+export var EmitterOptions = null; // same shape as CompilerOptions without export-related fields
+
+
+// ─── Emit Result ───────────────────────────────────────────
+export var EmitResult = null; // { code, sourceMap?, warnings: CompileWarning[] }
+
+
+// ─── Filter Handler ────────────────────────────────────────
+export var FilterHandler = null; // (content: string, filterName: string) => string

package/dist/vite-plugin.js

@@ -1,63 +1,78 @@
-import { compile } from './compiler.js';
-import { basename } from 'path';
-const COFFEEHAML_RE = /\.(coffeehaml|cohaml|chaml)$/;
-/** Derive a PascalCase component name from a filename stem. */
-function componentNameFromPath(filepath) {
-    const stem = basename(filepath).split('.').shift() || 'Component';
-    return stem.charAt(0).toUpperCase() + stem.slice(1);
-}
-export default function coffeehaml(options = {}) {
-    // Default to component mode — the only sensible default for Vite/React projects
-    const compilerOpts = {
-        sourceMap: true,
-        wrap: 'component',
-        ...options.compilerOptions,
-    };
-    return {
-        name: 'coffeehaml',
-        transform(code, id) {
-            if (!COFFEEHAML_RE.test(id))
-                return;
-            const result = compile(code, {
-                ...compilerOpts,
-                filename: id,
-                componentName: compilerOpts.componentName || componentNameFromPath(id),
-            });
-            // Inject React Fast Refresh pragma and HMR accept when in component mode
-            let preamble = '';
-            let postamble = '';
-            if (compilerOpts.wrap && compilerOpts.wrap !== 'none' && !compilerOpts.wrap.includes) {
-                // Component or observer mode — add Fast Refresh support
-                preamble = '// @refresh reset\n';
-                const name = compilerOpts.componentName || componentNameFromPath(id);
-                postamble = `\nif (import.meta.hot) {\n  import.meta.hot.accept((mod) => {\n    if (mod?.${name}) import.meta.hot?.data?.refresh?.();\n  });\n}\n`;
-            }
-            const finalCode = preamble + result.code + postamble;
-            if (result.errors.length > 0) {
-                const err = result.errors[0];
-                this.error({
-                    message: err.message,
-                    id,
-                    // @ts-ignore
-                    loc: err.location ? {
-                        line: err.location.start.line + 1,
-                        column: err.location.start.column + 1,
-                    } : undefined,
-                });
-                return null;
-            }
-            return {
-                code: finalCode,
-                map: result.sourceMap ? { mappings: result.sourceMap } : null,
-            };
-        },
-        handleHotUpdate({ file, server }) {
-            if (COFFEEHAML_RE.test(file)) {
-                // Invalidate and reload — the transform hook will recompile
-                server.ws.send({ type: 'full-reload' });
-                return [];
-            }
-        },
-    };
-}
-//# sourceMappingURL=vite-plugin.js.map
+// Generated by CoffeeScript 2.7.0
+// vite-plugin.coffee — Vite plugin for CoffeeHaml
+var COFFEEHAML_RE, coffeehaml, componentNameFromPath;
+
+import {
+  compile
+} from './compiler.js';
+
+import {
+  basename
+} from 'path';
+
+COFFEEHAML_RE = /\.(coffeehaml|cohaml|chaml)$/;
+
+componentNameFromPath = function(filepath) {
+  var stem;
+  stem = basename(filepath).split('.').shift() || 'Component';
+  return stem.charAt(0).toUpperCase() + stem.slice(1);
+};
+
+export default coffeehaml = function(options = {}) {
+  var compilerOpts, ref;
+  compilerOpts = Object.assign({
+    sourceMap: true,
+    wrap: 'component'
+  }, (ref = options.compilerOptions) != null ? ref : {});
+  return {
+    name: 'coffeehaml',
+    transform: function(code, id) {
+      var err, finalCode, name, postamble, preamble, result;
+      if (!COFFEEHAML_RE.test(id)) {
+        return;
+      }
+      result = compile(code, ...compilerOpts, {
+        filename: id,
+        componentName: compilerOpts.componentName || componentNameFromPath(id)
+      });
+      preamble = '';
+      postamble = '';
+      if (compilerOpts.wrap && compilerOpts.wrap !== 'none' && !Array.isArray(compilerOpts.wrap)) {
+        preamble = '// @refresh reset\n';
+        name = compilerOpts.componentName || componentNameFromPath(id);
+        postamble = `\nif (import.meta.hot) {
+  import.meta.hot.accept((mod) => {
+    if (mod?.${name}) import.meta.hot?.data?.refresh?.();
+  });
+}\n`;
+      }
+      finalCode = preamble + result.code + postamble;
+      if (result.errors.length > 0) {
+        err = result.errors[0];
+        this.error({
+          message: err.message
+        }, id, {
+          loc: err.location ? {
+            line: err.location.start.line + 1,
+            column: err.location.start.column + 1
+          } : void 0
+        });
+        return null;
+      }
+      return {
+        code: finalCode,
+        map: result.sourceMap ? {
+          mappings: result.sourceMap
+        } : null
+      };
+    },
+    handleHotUpdate: function({file, server}) {
+      if (COFFEEHAML_RE.test(file)) {
+        server.ws.send({
+          type: 'full-reload'
+        });
+        return [];
+      }
+    }
+  };
+};

package/docs/examples.md

@@ -371,6 +371,206 @@ Haml comments and their nested children are stripped entirely.
   init = ->
     console.log "ready"
   init()
+
+---
+
+## 11. Statement Continuation (v0.4.2)
+
+Indented children of `-` control blocks compile as continuation code lines.
+No more single-line straitjacket for complex logic:
+
+```haml
+- if user.role == 'admin' && user.permissions.includes('write')
+  %AdminPanel
+    %h2 Admin
+    %p Welcome back, = user.name
+```
+
+Multi-statement blocks:
+
+```haml
+- if results.length > 0
+  sorted = results.sort (a, b) -> b.score - a.score
+  topThree = sorted.slice 0, 3
+  %Results{ data: topThree }
+```
+
+Works with `for`, `while`, and bare statements too:
+
+```haml
+%div
+  - x = computeBaseValue()
+  - x *= multiplier
+  - x += offset
+  %p= x
+```
+
+---
+
+## 12. Expression Continuation (v0.5.0)
+
+Long inline expressions can break across indented continuation lines:
+
+```haml
+%h1= "Welcome, " +
+  user.firstName + " " +
+  user.lastName
+
+%div= someFunction(
+  arg1,
+  arg2,
+  arg3
+)
+```
+
+Indented TEXT children of `=` are joined into the expression before compilation:
+
+```haml
+%p= formatMessage(
+  user.name,
+  user.role,
+  if premium then "⭐" else ""
+)
+```
+
+---
+
+## 13. Arrow Continuation (v0.6.0)
+
+`=` with an arrow function can have indented element children — the elements
+become the arrow body's JSX:
+
+```haml
+%ul
+  = items.map (item) ->
+    %li{ key: item.id }
+      %span.icon= item.icon
+      %a{ href: item.url }= item.label
+```
+
+Compiles to:
+
+```js
+jsx("ul", null,
+  ...items.map(item => jsx("li", { key: item.id },
+    jsx("span", { className: "icon" }, item.icon),
+    jsx("a", { href: item.url }, item.label)
+  ))
+)
+```
+
+Works inline within elements too:
+
+```haml
+%Dashboard
+  = widgets.filter (w) -> w.active
+    .map (w) ->
+      %WidgetCard{ widget: w, key: w.id }
+```
+
+---
+
+## 14. CLI Init Scaffold (v0.6.0)
+
+Interactive project setup wizard:
+
+```bash
+$ npx coffeehaml init
+
+  ☕ CoffeeHaml init — project scaffold
+  Working directory: /my-react-app
+  Detected: package.json, Vite, TypeScript
+
+  Add coffeehaml as devDependency? (Y/n):
+  Configure Vite plugin? (Y/n):
+  Create sample .chaml component? (Y/n):
+  Add build/watch scripts to package.json? (Y/n):
+```
+
+Detects your project type, installs dependencies, patches Vite config,
+creates a sample component, and adds npm scripts — all interactive.
+
+---
+
+## 15. Watch Mode (v0.5.0)
+
+```bash
+# Watch and recompile on every change
+$ npx coffeehaml watch src/ --wrap component
+
+# With observer HOC wrapping
+$ npx coffeehaml watch src/ --wrap observer
+```
+
+Uses native `fs.watch` — zero dependencies. Recursively scans on startup,
+recompiles individual files on change.
+
+---
+
+## 16. HOC Wrapping (v0.4.0)
+
+Wrap components in higher-order functions:
+
+```haml
+-# With Vite plugin (default: component)
+-# Or via CLI / Node API:
+
+%div.page
+  %h1 Hello
+```
+
+```bash
+# Single HOC
+$ npx coffeehaml compile app.chaml --wrap observer
+# → export default observer(function App(props) { ... })
+
+# HOC chain
+$ npx coffeehaml compile app.chaml --wrap observer,memo,forwardRef
+# → export default observer(memo(forwardRef(function App(props) { ... })))
+```
+
+Node API:
+
+```js
+compile(source, { wrap: ['observer', 'memo'] })
+compile(source, { wrap: 'observer' })
+compile(source, { wrap: 'component' })  // plain component
+```
+
+---
+
+## 17. Multi-Error Parser Recovery (v0.6.0)
+
+The parser no longer stops at the first error. It collects all errors,
+recovers at structural boundaries, and returns a partial AST:
+
+```js
+const result = compile(brokenSource);
+console.log(result.errors);
+// [
+//   { message: "Unexpected token '}'", location: { line: 3, column: 12 } },
+//   { message: "Unclosed attribute block", location: { line: 7, column: 1 } },
+// ]
+```
+
+Errors carry source locations (line/column) for IDE integration and
+clickable terminal output.
+
+---
+
+## 18. Source-Located Errors (v0.5.0)
+
+All errors carry file, line, and column:
+
+```bash
+$ npx coffeehaml compile bad.chaml
+Error: bad.chaml:12:3 — Unexpected ')' in expression
+  %div{ onClick: -> handle() ) }
+                ^
+```
+
+CoffeeScript compile errors are wrapped with source location context,
+making it clear which `.chaml` line triggered the failure.
 ```
 
 ### Markdown (build-time)
@@ -716,4 +916,4 @@ Or use a raw CoffeeScript expression:
 ```
 
 Fragments are implicit — multiple top-level nodes in a Document emit
-a React Fragment automatically.
+a React Fragment automatically.

package/docs/grammar.md

@@ -341,6 +341,95 @@ arr...
 "Hello, #{name}"
 
 // Heregex
+```
+
+---
+
+## Continuation (v0.4.2 / v0.5.0 / v0.6.0)
+
+CoffeeHaml supports three forms of indented continuation, extending the
+grammar beyond single-line constructs.
+
+### Statement Continuation (`-`, v0.4.2)
+
+```
+Statement      := '-' Whitespace CodeStatement Newline
+                  (Indent CodeLine+ Dedent)?
+
+CodeLine       := [^\\n]+ Newline
+                // Indented code lines concatenated to the primary statement.
+                // Enables multi-line CoffeeScript inside - blocks.
+```
+
+The indented lines are joined to the primary statement with newline
+separators before CoffeeScript compilation:
+
+```haml
+- x = computeValue()
+  x *= multiplier        # continuation
+  x += offset            # continuation
+%p= x
+```
+
+Compiles as a single CoffeeScript block: `x = computeValue(); x *= multiplier; x += offset`.
+
+### Expression Continuation (`=`, v0.5.0)
+
+```
+Output         := '=' Whitespace Expression Newline
+                  (Indent TextLine+ Dedent)?
+
+TextLine       := [^\\n]+ Newline
+                // TEXT children of = outputs are joined to the expression.
+```
+
+Indented TEXT children of `=` outputs are concatenated into the expression:
+
+```haml
+%h1= "Hello, " +
+  user.firstName +
+  " " +
+  user.lastName
+```
+
+### Arrow Continuation (`= expr ->`, v0.6.0)
+
+```
+ArrowOutput    := '=' Whitespace Expression ArrowSuffix Newline
+                  (Indent Node+ Dedent)?
+
+ArrowSuffix    := '->' | '=>' Arguments?
+                // Detected after CoffeeScript expression parsing.
+                // Triggers element-body mode for indented children.
+```
+
+When `=` is followed by an expression ending in a CoffeeScript arrow
+(`->` or `=>`), the indented children become the arrow body — compiled
+as JSX elements within the arrow function:
+
+```haml
+= items.map (item) ->
+  %li{ key: item.id }
+    %span= item.label
+```
+
+Compiles to:
+
+```js
+items.map(item => jsx("li", { key: item.id },
+  jsx("span", null, item.label)
+))
+```
+
+This works both at the module level (`emitOutput`) and inline within
+elements (`emitChildToJs`), enabling functional mapping with full element
+syntax in both positions.
+
+### Continuation Precedence
+
+1. Arrow continuation takes priority — if the expression ends with `->` or `=>`, children are treated as the arrow body.
+2. Otherwise, TEXT children are joined as expression continuations (for multi-line expressions).
+3. Statement continuations are always code lines, joined before CoffeeScript compilation.
 /// pattern /g
 
 // Destructuring
@@ -429,4 +518,4 @@ it checks patterns in this order:
 7. `-` → ControlFlow
 8. `=` / `==` → Output
 9. `:` + identifier → Filter
-10. anything else → RawText
+10. anything else → RawText