htmlemmurt 0.4.0 → 0.5.0

package/README.md

@@ -19,6 +19,8 @@ const { html, dependencies, errors } = compile('<cascett classe="a">Uè</cascett
 
 `compile` non lancia mai eccezioni: gli errori stanno in `errors`, con `message`, `file`, `line`, `column` e `suggestion`, in napoletano. Le opzioni sono `filename`, `root` (la cartella per i percorsi che cominciano con `/`), `read` (per leggere i file in un altro modo) e `inline` (incolla nella pagina i file di `<fratm da>`). I moduli `.fratm` li compila il pacchetto [`fratmscript`](https://www.npmjs.com/package/fratmscript).
 
+`format(source)` restituisce la pagina come la scrive `emmurt fmt`, cambiando solo spazi e a capo, oppure `null` se la pagina ha errori (li dice `compile`).
+
 ## Con Vite
 
 ```js

package/index.d.ts

@@ -48,6 +48,11 @@ export interface Vocabulary {
 
 /** Compiles htmlemmurt to HTML. Never throws on invalid source: check `errors`. */
 export function compile(source: string, options?: CompileOptions): CompileResult;
+/**
+ * The page as `emmurt fmt` writes it: only spaces and line breaks change.
+ * Null when it has errors, which `compile` reports.
+ */
+export function format(source: string): string | null;
 /** Every Neapolitan name and its HTML. */
 export function vocabulary(): Vocabulary;
 /** Version of the compiler. */

package/index.js

@@ -7,7 +7,7 @@ import { createApi } from './lib/api.js';
 const wasm = createRequire(import.meta.url)('./wasm/node/emmurt_wasm.js');
 const api = createApi(wasm);
 
-export const { vocabulary, version, runtimeError } = api;
+export const { format, vocabulary, version, runtimeError } = api;
 export { formatError } from './lib/api.js';
 
 /**

package/lib/api.js

@@ -9,6 +9,11 @@ export function createApi(wasm) {
     return { html: response.html, dependencies: response.dependencies, errors: response.errors };
   }
 
+  // Undefined from the bindings when the page cannot be formatted
+  function format(source) {
+    return wasm.format(String(source)) ?? null;
+  }
+
   function vocabulary() {
     return JSON.parse(wasm.vocabulary());
   }
@@ -19,7 +24,7 @@ export function createApi(wasm) {
     return wasm.runtimeError(name, message);
   }
 
-  return { compile, vocabulary, version: wasm.version, runtimeError };
+  return { compile, format, vocabulary, version: wasm.version, runtimeError };
 }
 
 /** `file:line:column: message`, then the hint on its own line. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "htmlemmurt",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "htmlemmurt compiler (WebAssembly), Vite plugin and browser runtime: HTML, ma comme si deve 🤌",
   "license": "MIT",
   "author": "Vito Esposito",

package/web.d.ts

@@ -5,6 +5,8 @@ import type { CompileOptions, CompileResult, Vocabulary, EmmurtError } from './i
 export function init(input?: string | URL | Request | Response | BufferSource | WebAssembly.Module): Promise<void>;
 /** Compiles htmlemmurt to HTML. Without `read`, includes cannot be resolved. */
 export function compile(source: string, options?: Omit<CompileOptions, 'root'>): CompileResult;
+/** The page as `emmurt fmt` writes it, or null when it has errors: `compile` says which. */
+export function format(source: string): string | null;
 export function vocabulary(): Vocabulary;
 export function version(): string;
 export function runtimeError(error: unknown): string;

package/web.js

@@ -19,6 +19,7 @@ function loadedApi() {
 }
 
 export const compile = (source, options) => loadedApi().compile(source, options);
+export const format = (source) => loadedApi().format(source);
 export const vocabulary = () => loadedApi().vocabulary();
 export const version = () => loadedApi().version();
 export const runtimeError = (error) => loadedApi().runtimeError(error);