@gmb/bitmark-parser 3.0.1-alpha.2 → 3.0.1-alpha.4

package/dist/index.js

@@ -4,7 +4,7 @@ import { createRequire } from "module";
 // src/generated/package_info.ts
 var PACKAGE_INFO = {
   "name": "@gmb/bitmark-parser",
-  "version": "3.0.1-alpha.2",
+  "version": "3.0.1-alpha.4",
   "author": "Get More Brain Ltd <info@getmorebrain.com>",
   "license": "ISC",
   "description": "A parser for bitmark text, powered by WebAssembly."
@@ -16,22 +16,31 @@ var wasm = require2("../wasm/bitmark_wasm.js");
 function version() {
   return PACKAGE_INFO.version;
 }
-function lex(input, stage = "lex") {
-  return wasm.lex(input, stage);
+function lex(input, options = {}) {
+  return wasm.lex(input, options.stage ?? "lex");
 }
-function parse(input) {
-  return wasm.parse(input);
+function parse(input, options = {}) {
+  return wasm.parse(input, options.mode ?? "optimized");
 }
-function convert(input, optionsJson = "{}") {
-  return wasm.convert(input, optionsJson);
+function convert(input, options = {}) {
+  return wasm.convert(input, options.mode ?? "optimized", options.warnings ?? false, options.plainText ?? false, options.pretty ?? false, options.indent ?? 2);
 }
-function breakscapeText(input, format = "bitmark++", location = "body") {
+function breakscapeText(input, options = {}) {
+  const format = options.format ?? "bitmark++";
+  const location = options.location ?? "body";
   return wasm.breakscape_text(input, format, location);
 }
-function unbreakscapeText(input, format = "bitmark++", location = "body") {
+function unbreakscapeText(input, options = {}) {
+  const format = options.format ?? "bitmark++";
+  const location = options.location ?? "body";
   return wasm.unbreakscape_text(input, format, location);
 }
-function info(infoType = "list", format = "text", bit = "", pretty = false, indent = 2) {
+function info(options = {}) {
+  const infoType = options.infoType ?? "list";
+  const format = options.format ?? "text";
+  const bit = options.bit ?? "";
+  const pretty = options.pretty ?? false;
+  const indent = options.indent ?? 2;
   return wasm.info(infoType, format, bit, pretty, indent);
 }
 function generate(_json) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/generated/package_info.ts"],"sourcesContent":["// @zen-component: WASM-TSBindings\n\nimport { createRequire } from \"node:module\";\nimport { PACKAGE_INFO } from \"./generated/package_info.js\";\nconst require = createRequire(import.meta.url);\nconst wasm = require(\"../wasm/bitmark_wasm.js\") as typeof import(\"../wasm/bitmark_wasm.js\");\n\n/**\n * Get the version of the @gmb/bitmark-parser library.\n *\n * @returns Version string (e.g. \"3.0.0\").\n */\nexport function version(): string {\n  return PACKAGE_INFO.version;\n}\n\n/**\n * Lex bitmark input text, returning one line per token.\n *\n * @param input  - The bitmark source text.\n * @param stage  - Lexer stage: `\"lex\"` (combined), `\"lex-bitmark\"`, or `\"lex-text\"`.\n * @returns Token dump string (one token per line).\n */\nexport function lex(input: string, stage: string = \"lex\"): string {\n  return wasm.lex(input, stage);\n}\n\n/**\n * Parse bitmark input text and return the reference JSON format.\n *\n * @param input - The bitmark source text.\n * @returns JSON string of the parsed bitmark document.\n */\nexport function parse(input: string): string {\n  return wasm.parse(input);\n}\n\n/**\n * Auto-detect input format and convert between bitmark and JSON.\n *\n * @param input - Bitmark or JSON input text.\n * @param optionsJson - JSON string with options: mode, warnings, plainText.\n * @returns Converted output string.\n */\nexport function convert(input: string, optionsJson: string = \"{}\"): string {\n  return wasm.convert(input, optionsJson);\n}\n\n/**\n * Breakscape text (escape bitmark special characters).\n *\n * @param input - The text to breakscape.\n * @param format - Text format: `\"bitmark++\"` (default) or `\"plainText\"`.\n * @param location - Text location: `\"body\"` (default) or `\"tag\"`.\n * @returns Breakscaped text.\n */\nexport function breakscapeText(input: string, format: string = \"bitmark++\", location: string = \"body\"): string {\n  return wasm.breakscape_text(input, format, location);\n}\n\n/**\n * Unbreakscape text (unescape bitmark special characters).\n *\n * @param input - The text to unbreakscape.\n * @param format - Text format: `\"bitmark++\"` (default) or `\"plainText\"`.\n * @param location - Text location: `\"body\"` (default) or `\"tag\"`.\n * @returns Unbreakscaped text.\n */\nexport function unbreakscapeText(input: string, format: string = \"bitmark++\", location: string = \"body\"): string {\n  return wasm.unbreakscape_text(input, format, location);\n}\n\n/**\n * Query information about supported bit types.\n *\n * @param infoType - Info type: `\"list\"`, `\"bit\"`, `\"all\"`, or `\"deprecated\"`.\n * @param format - Output format: `\"text\"` (default) or `\"json\"`.\n * @param bit - Bit name (required when `infoType` is `\"bit\"`).\n * @param pretty - Whether to pretty-print JSON output.\n * @param indent - Indent size for pretty-printing (default: 2).\n * @returns Information string.\n */\nexport function info(infoType: string = \"list\", format: string = \"text\", bit: string = \"\", pretty: boolean = false, indent: number = 2): string {\n  return wasm.info(infoType, format, bit, pretty, indent);\n}\n\n/**\n * Generate bitmark text from a JSON AST.\n *\n * @param _json - JSON string of the AST.\n * @throws Always throws — not yet implemented.\n */\nexport function generate(_json: string): string {\n  throw new Error(\"generate is not yet implemented\");\n}\n","// This file is automatically generated. DO NOT EDIT.\n\n/* eslint-disable */\n\nexport const PACKAGE_INFO = {\n  \"name\": \"@gmb/bitmark-parser\",\n  \"version\": \"3.0.1-alpha.2\",\n  \"author\": \"Get More Brain Ltd <info@getmorebrain.com>\",\n  \"license\": \"ISC\",\n  \"description\": \"A parser for bitmark text, powered by WebAssembly.\"\n};\n"],"mappings":";AAEA,SAAS,qBAAqB;;;ACEvB,IAAM,eAAe;AAAA,EAC1B,QAAQ;AAAA,EACR,WAAW;AAAA,EACX,UAAU;AAAA,EACV,WAAW;AAAA,EACX,eAAe;AACjB;;;ADNA,IAAMA,WAAU,cAAc,YAAY,GAAG;AAC7C,IAAM,OAAOA,SAAQ,yBAAyB;AAOvC,SAAS,UAAkB;AAChC,SAAO,aAAa;AACtB;AASO,SAAS,IAAI,OAAe,QAAgB,OAAe;AAChE,SAAO,KAAK,IAAI,OAAO,KAAK;AAC9B;AAQO,SAAS,MAAM,OAAuB;AAC3C,SAAO,KAAK,MAAM,KAAK;AACzB;AASO,SAAS,QAAQ,OAAe,cAAsB,MAAc;AACzE,SAAO,KAAK,QAAQ,OAAO,WAAW;AACxC;AAUO,SAAS,eAAe,OAAe,SAAiB,aAAa,WAAmB,QAAgB;AAC7G,SAAO,KAAK,gBAAgB,OAAO,QAAQ,QAAQ;AACrD;AAUO,SAAS,iBAAiB,OAAe,SAAiB,aAAa,WAAmB,QAAgB;AAC/G,SAAO,KAAK,kBAAkB,OAAO,QAAQ,QAAQ;AACvD;AAYO,SAAS,KAAK,WAAmB,QAAQ,SAAiB,QAAQ,MAAc,IAAI,SAAkB,OAAO,SAAiB,GAAW;AAC9I,SAAO,KAAK,KAAK,UAAU,QAAQ,KAAK,QAAQ,MAAM;AACxD;AAQO,SAAS,SAAS,OAAuB;AAC9C,QAAM,IAAI,MAAM,iCAAiC;AACnD;","names":["require"]}
+{"version":3,"sources":["../src/index.ts","../src/generated/package_info.ts"],"sourcesContent":["// @zen-component: WASM-TSBindings\n\nimport { createRequire } from \"node:module\";\nimport { PACKAGE_INFO } from \"./generated/package_info.js\";\nimport type { LexOptions, ParseOptions, ConvertOptions, BreakscapeOptions, InfoOptions } from \"./types.js\";\nconst require = createRequire(import.meta.url);\nconst wasm = require(\"../wasm/bitmark_wasm.js\") as typeof import(\"../wasm/bitmark_wasm.js\");\n\nexport type { LexOptions, LexStage, ParseOptions, ConvertOptions, OutputMode, BreakscapeOptions, TextFormat, TextLocation, InfoOptions, InfoType, InfoFormat } from \"./types.js\";\n\n/**\n * Get the version of the @gmb/bitmark-parser library.\n *\n * @returns Version string (e.g. \"3.0.0\").\n */\nexport function version(): string {\n  return PACKAGE_INFO.version;\n}\n\n/**\n * Lex bitmark input text, returning one line per token.\n *\n * @param input  - The bitmark source text.\n * @param options - Lex options (e.g. `{ stage: \"lex-bitmark\" }`).\n * @returns Token dump string (one token per line).\n */\nexport function lex(input: string, options: LexOptions = {}): string {\n  return wasm.lex(input, options.stage ?? \"lex\");\n}\n\n/**\n * Parse bitmark input text and return the reference JSON format.\n *\n * @param input - The bitmark source text.\n * @param options - Parse options (e.g. `{ mode: \"full\" }`).\n * @returns JSON string of the parsed bitmark document.\n */\nexport function parse(input: string, options: ParseOptions = {}): string {\n  return wasm.parse(input, options.mode ?? \"optimized\");\n}\n\n/**\n * Auto-detect input format and convert between bitmark and JSON.\n *\n * @param input - Bitmark or JSON input text.\n * @param options - Convert options (e.g. `{ mode: \"full\", warnings: true }`).\n * @returns Converted output string.\n */\nexport function convert(input: string, options: ConvertOptions = {}): string {\n  return wasm.convert(input, options.mode ?? \"optimized\", options.warnings ?? false, options.plainText ?? false, options.pretty ?? false, options.indent ?? 2);\n}\n\n/**\n * Breakscape text (escape bitmark special characters).\n *\n * @param input - The text to breakscape.\n * @param options - Breakscape options (e.g. `{ format: \"plainText\", location: \"tag\" }`).\n * @returns Breakscaped text.\n */\nexport function breakscapeText(input: string, options: BreakscapeOptions = {}): string {\n  const format = options.format ?? \"bitmark++\";\n  const location = options.location ?? \"body\";\n  return wasm.breakscape_text(input, format, location);\n}\n\n/**\n * Unbreakscape text (unescape bitmark special characters).\n *\n * @param input - The text to unbreakscape.\n * @param options - Unbreakscape options (e.g. `{ format: \"plainText\", location: \"tag\" }`).\n * @returns Unbreakscaped text.\n */\nexport function unbreakscapeText(input: string, options: BreakscapeOptions = {}): string {\n  const format = options.format ?? \"bitmark++\";\n  const location = options.location ?? \"body\";\n  return wasm.unbreakscape_text(input, format, location);\n}\n\n/**\n * Query information about supported bit types.\n *\n * @param options - Info options (e.g. `{ infoType: \"bit\", format: \"json\", bit: \"cloze\" }`).\n * @returns Information string.\n */\nexport function info(options: InfoOptions = {}): string {\n  const infoType = options.infoType ?? \"list\";\n  const format = options.format ?? \"text\";\n  const bit = options.bit ?? \"\";\n  const pretty = options.pretty ?? false;\n  const indent = options.indent ?? 2;\n  return wasm.info(infoType, format, bit, pretty, indent);\n}\n\n/**\n * Generate bitmark text from a JSON AST.\n *\n * @param _json - JSON string of the AST.\n * @throws Always throws — not yet implemented.\n */\nexport function generate(_json: string): string {\n  throw new Error(\"generate is not yet implemented\");\n}\n","// This file is automatically generated. DO NOT EDIT.\n\n/* eslint-disable */\n\nexport const PACKAGE_INFO = {\n  \"name\": \"@gmb/bitmark-parser\",\n  \"version\": \"3.0.1-alpha.4\",\n  \"author\": \"Get More Brain Ltd <info@getmorebrain.com>\",\n  \"license\": \"ISC\",\n  \"description\": \"A parser for bitmark text, powered by WebAssembly.\"\n};\n"],"mappings":";AAEA,SAAS,qBAAqB;;;ACEvB,IAAM,eAAe;AAAA,EAC1B,QAAQ;AAAA,EACR,WAAW;AAAA,EACX,UAAU;AAAA,EACV,WAAW;AAAA,EACX,eAAe;AACjB;;;ADLA,IAAMA,WAAU,cAAc,YAAY,GAAG;AAC7C,IAAM,OAAOA,SAAQ,yBAAyB;AASvC,SAAS,UAAkB;AAChC,SAAO,aAAa;AACtB;AASO,SAAS,IAAI,OAAe,UAAsB,CAAC,GAAW;AACnE,SAAO,KAAK,IAAI,OAAO,QAAQ,SAAS,KAAK;AAC/C;AASO,SAAS,MAAM,OAAe,UAAwB,CAAC,GAAW;AACvE,SAAO,KAAK,MAAM,OAAO,QAAQ,QAAQ,WAAW;AACtD;AASO,SAAS,QAAQ,OAAe,UAA0B,CAAC,GAAW;AAC3E,SAAO,KAAK,QAAQ,OAAO,QAAQ,QAAQ,aAAa,QAAQ,YAAY,OAAO,QAAQ,aAAa,OAAO,QAAQ,UAAU,OAAO,QAAQ,UAAU,CAAC;AAC7J;AASO,SAAS,eAAe,OAAe,UAA6B,CAAC,GAAW;AACrF,QAAM,SAAS,QAAQ,UAAU;AACjC,QAAM,WAAW,QAAQ,YAAY;AACrC,SAAO,KAAK,gBAAgB,OAAO,QAAQ,QAAQ;AACrD;AASO,SAAS,iBAAiB,OAAe,UAA6B,CAAC,GAAW;AACvF,QAAM,SAAS,QAAQ,UAAU;AACjC,QAAM,WAAW,QAAQ,YAAY;AACrC,SAAO,KAAK,kBAAkB,OAAO,QAAQ,QAAQ;AACvD;AAQO,SAAS,KAAK,UAAuB,CAAC,GAAW;AACtD,QAAM,WAAW,QAAQ,YAAY;AACrC,QAAM,SAAS,QAAQ,UAAU;AACjC,QAAM,MAAM,QAAQ,OAAO;AAC3B,QAAM,SAAS,QAAQ,UAAU;AACjC,QAAM,SAAS,QAAQ,UAAU;AACjC,SAAO,KAAK,KAAK,UAAU,QAAQ,KAAK,QAAQ,MAAM;AACxD;AAQO,SAAS,SAAS,OAAuB;AAC9C,QAAM,IAAI,MAAM,iCAAiC;AACnD;","names":["require"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gmb/bitmark-parser",
-  "version": "3.0.1-alpha.2",
+  "version": "3.0.1-alpha.4",
   "description": "A parser for bitmark text, powered by WebAssembly.",
   "author": "Get More Brain Ltd <info@getmorebrain.com>",
   "license": "ISC",

package/wasm/bitmark_wasm.d.ts

@@ -17,23 +17,24 @@ export function unbreakscape_text(input: string, format: string, location: strin
 /**
  * Parse bitmark input text and return the reference JSON format.
  *
- * Uses the full pipeline: parse → validate → serialize with optimized mode.
+ * Uses the full pipeline: parse → validate → serialize.
+ *
+ * `mode`: `"optimized"` (default) or `"full"`
  */
-export function parse(input: string): string;
+export function parse(input: string, mode: string): string;
 /**
  * Auto-detect input format and convert between bitmark and JSON.
  *
- * `options_json` is a JSON string with optional fields:
- * - `"mode"`: `"optimized"` (default) or `"full"`
- * - `"warnings"`: `true` or `false` (default)
- * - `"plainText"`: `true` or `false` (default)
- * - `"pretty"`: `true` or `false` (default)
- * - `"indent"`: number (default: 2)
+ * `mode`: `"optimized"` (default) or `"full"`
+ * `warnings`: whether to include validation warnings (default: false)
+ * `plain_text`: output text as plain text — debug mode (default: false)
+ * `pretty`: prettify JSON output (default: false)
+ * `indent`: indent size for pretty-printing (default: 2)
  *
  * Returns JSON if input is bitmark, or an error message if input is JSON
  * (generator not yet implemented).
  */
-export function convert(input: string, options_json: string): string;
+export function convert(input: string, mode: string, warnings: boolean, plain_text: boolean, pretty: boolean, indent: number): string;
 /**
  * Query information about supported bit types.
  *
@@ -49,11 +50,11 @@ export function info(info_type: string, format: string, bit: string, pretty: boo
  * the Rust CLI: `{kind:?} {span:?} "{text}"`.
  *
  * `stage` selects the lexer pipeline:
- * - `"lex"` — combined (default)
- * - `"lex-bitmark"` — bitmark-level only
- * - `"lex-text"` — text-level only
- * - `"lex-json"` — combined, JSON array output
- * - `"lex-bitmark-json"` — bitmark-level, JSON array output
- * - `"lex-text-json"` — text-level, JSON array output
+ *   - `"lex"` — combined (default)
+ *   - `"lex-bitmark"` — bitmark-level only
+ *   - `"lex-text"` — text-level only
+ *   - `"lex-json"` — combined, JSON array output
+ *   - `"lex-bitmark-json"` — bitmark-level, JSON array output
+ *   - `"lex-text-json"` — text-level, JSON array output
  */
 export function lex(input: string, stage: string): string;

package/wasm/bitmark_wasm.js

@@ -154,55 +154,63 @@ module.exports.unbreakscape_text = function(input, format, location) {
 /**
  * Parse bitmark input text and return the reference JSON format.
  *
- * Uses the full pipeline: parse → validate → serialize with optimized mode.
+ * Uses the full pipeline: parse → validate → serialize.
+ *
+ * `mode`: `"optimized"` (default) or `"full"`
  * @param {string} input
+ * @param {string} mode
  * @returns {string}
  */
-module.exports.parse = function(input) {
-    let deferred2_0;
-    let deferred2_1;
+module.exports.parse = function(input, mode) {
+    let deferred3_0;
+    let deferred3_1;
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
         const ptr0 = passStringToWasm0(input, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
         const len0 = WASM_VECTOR_LEN;
-        wasm.parse(retptr, ptr0, len0);
+        const ptr1 = passStringToWasm0(mode, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
+        const len1 = WASM_VECTOR_LEN;
+        wasm.parse(retptr, ptr0, len0, ptr1, len1);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
-        deferred2_0 = r0;
-        deferred2_1 = r1;
+        deferred3_0 = r0;
+        deferred3_1 = r1;
         return getStringFromWasm0(r0, r1);
     } finally {
         wasm.__wbindgen_add_to_stack_pointer(16);
-        wasm.__wbindgen_export_2(deferred2_0, deferred2_1, 1);
+        wasm.__wbindgen_export_2(deferred3_0, deferred3_1, 1);
     }
 };
 
 /**
  * Auto-detect input format and convert between bitmark and JSON.
  *
- * `options_json` is a JSON string with optional fields:
- * - `"mode"`: `"optimized"` (default) or `"full"`
- * - `"warnings"`: `true` or `false` (default)
- * - `"plainText"`: `true` or `false` (default)
- * - `"pretty"`: `true` or `false` (default)
- * - `"indent"`: number (default: 2)
+ * `mode`: `"optimized"` (default) or `"full"`
+ * `warnings`: whether to include validation warnings (default: false)
+ * `plain_text`: output text as plain text — debug mode (default: false)
+ * `pretty`: prettify JSON output (default: false)
+ * `indent`: indent size for pretty-printing (default: 2)
  *
  * Returns JSON if input is bitmark, or an error message if input is JSON
  * (generator not yet implemented).
  * @param {string} input
- * @param {string} options_json
+ * @param {string} mode
+ * @param {boolean} warnings
+ * @param {boolean} plain_text
+ * @param {boolean} pretty
+ * @param {number} indent
  * @returns {string}
  */
-module.exports.convert = function(input, options_json) {
+module.exports.convert = function(input, mode, warnings, plain_text, pretty, indent) {
     let deferred3_0;
     let deferred3_1;
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
         const ptr0 = passStringToWasm0(input, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
         const len0 = WASM_VECTOR_LEN;
-        const ptr1 = passStringToWasm0(options_json, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
+        const ptr1 = passStringToWasm0(mode, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
         const len1 = WASM_VECTOR_LEN;
-        wasm.convert(retptr, ptr0, len0, ptr1, len1);
+        wasm.convert(retptr, ptr0, len0, ptr1, len1, warnings, plain_text, pretty, indent);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         deferred3_0 = r0;
@@ -257,12 +265,12 @@ module.exports.info = function(info_type, format, bit, pretty, indent) {
  * the Rust CLI: `{kind:?} {span:?} "{text}"`.
  *
  * `stage` selects the lexer pipeline:
- * - `"lex"` — combined (default)
- * - `"lex-bitmark"` — bitmark-level only
- * - `"lex-text"` — text-level only
- * - `"lex-json"` — combined, JSON array output
- * - `"lex-bitmark-json"` — bitmark-level, JSON array output
- * - `"lex-text-json"` — text-level, JSON array output
+ *   - `"lex"` — combined (default)
+ *   - `"lex-bitmark"` — bitmark-level only
+ *   - `"lex-text"` — text-level only
+ *   - `"lex-json"` — combined, JSON array output
+ *   - `"lex-bitmark-json"` — bitmark-level, JSON array output
+ *   - `"lex-text-json"` — text-level, JSON array output
  * @param {string} input
  * @param {string} stage
  * @returns {string}

package/wasm/bitmark_wasm_bg.wasm.d.ts

@@ -2,10 +2,10 @@
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
 export const breakscape_text: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
-export const convert: (a: number, b: number, c: number, d: number, e: number) => void;
+export const convert: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
 export const info: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
 export const lex: (a: number, b: number, c: number, d: number, e: number) => void;
-export const parse: (a: number, b: number, c: number) => void;
+export const parse: (a: number, b: number, c: number, d: number, e: number) => void;
 export const unbreakscape_text: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
 export const __wbindgen_add_to_stack_pointer: (a: number) => number;
 export const __wbindgen_export_0: (a: number, b: number) => number;