comment-parser 1.2.4 → 1.3.0

package/lib/parser/tokenizers/description.cjs

@@ -10,13 +10,14 @@ const primitives_1 = require("../../primitives.cjs");
  * Makes no changes to `spec.lines[].tokens` but joins them into `spec.description`
  * following given spacing srtategy
  * @param {Spacing} spacing tells how to handle the whitespace
+ * @param {BlockMarkers} markers tells how to handle comment block delimitation
  */
 
 
-function descriptionTokenizer(spacing = 'compact') {
+function descriptionTokenizer(spacing = 'compact', markers = primitives_1.Markers) {
   const join = getJoiner(spacing);
   return spec => {
-    spec.description = join(spec.source);
+    spec.description = join(spec.source, markers);
     return spec;
   };
 }
@@ -31,7 +32,7 @@ function getJoiner(spacing) {
 
 exports.getJoiner = getJoiner;
 
-function compactJoiner(lines) {
+function compactJoiner(lines, markers = primitives_1.Markers) {
   return lines.map(({
     tokens: {
       description
@@ -47,13 +48,13 @@ const getDescription = ({
   tokens
 }) => (tokens.delimiter === '' ? tokens.start : tokens.postDelimiter.slice(1)) + tokens.description;
 
-function preserveJoiner(lines) {
+function preserveJoiner(lines, markers = primitives_1.Markers) {
   if (lines.length === 0) return ''; // skip the opening line with no description
 
-  if (lines[0].tokens.description === '' && lines[0].tokens.delimiter === primitives_1.Markers.start) lines = lines.slice(1); // skip the closing line with no description
+  if (lines[0].tokens.description === '' && lines[0].tokens.delimiter === markers.start) lines = lines.slice(1); // skip the closing line with no description
 
   const lastLine = lines[lines.length - 1];
-  if (lastLine !== undefined && lastLine.tokens.description === '' && lastLine.tokens.end.endsWith(primitives_1.Markers.end)) lines = lines.slice(0, -1); // description starts at the last line of type definition
+  if (lastLine !== undefined && lastLine.tokens.description === '' && lastLine.tokens.end.endsWith(markers.end)) lines = lines.slice(0, -1); // description starts at the last line of type definition
 
   lines = lines.slice(lines.reduce(lineNo, 0));
   return lines.map(getDescription).join('\n');

package/lib/parser/tokenizers/description.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["description.js"],"names":["Object","defineProperty","exports","value","getJoiner","primitives_1","require","descriptionTokenizer","spacing","join","spec","description","source","default","compactJoiner","preserveJoiner","lines","map","tokens","trim","filter","lineNo","num","i","type","getDescription","delimiter","start","postDelimiter","slice","length","Markers","lastLine","undefined","end","endsWith","reduce"],"mappings":"AAAA;;AACAA,MAAM,CAACC,cAAP,CAAsBC,OAAtB,EAA+B,YAA/B,EAA6C;AAAEC,EAAAA,KAAK,EAAE;AAAT,CAA7C;AACAD,OAAO,CAACE,SAAR,GAAoB,KAAK,CAAzB;;AACA,MAAMC,YAAY,GAAGC,OAAH,wBAAlB;AACA;AACA;AACA;AACA;AACA;;;AACA,SAASC,oBAAT,CAA8BC,OAAO,GAAG,SAAxC,EAAmD;AAC/C,QAAMC,IAAI,GAAGL,SAAS,CAACI,OAAD,CAAtB;AACA,SAAQE,IAAD,IAAU;AACbA,IAAAA,IAAI,CAACC,WAAL,GAAmBF,IAAI,CAACC,IAAI,CAACE,MAAN,CAAvB;AACA,WAAOF,IAAP;AACH,GAHD;AAIH;;AACDR,OAAO,CAACW,OAAR,GAAkBN,oBAAlB;;AACA,SAASH,SAAT,CAAmBI,OAAnB,EAA4B;AACxB,MAAIA,OAAO,KAAK,SAAhB,EACI,OAAOM,aAAP;AACJ,MAAIN,OAAO,KAAK,UAAhB,EACI,OAAOO,cAAP;AACJ,SAAOP,OAAP;AACH;;AACDN,OAAO,CAACE,SAAR,GAAoBA,SAApB;;AACA,SAASU,aAAT,CAAuBE,KAAvB,EAA8B;AAC1B,SAAOA,KAAK,CACPC,GADE,CACE,CAAC;AAAEC,IAAAA,MAAM,EAAE;AAAEP,MAAAA;AAAF;AAAV,GAAD,KAAiCA,WAAW,CAACQ,IAAZ,EADnC,EAEFC,MAFE,CAEMT,WAAD,IAAiBA,WAAW,KAAK,EAFtC,EAGFF,IAHE,CAGG,GAHH,CAAP;AAIH;;AACD,MAAMY,MAAM,GAAG,CAACC,GAAD,EAAM;AAAEJ,EAAAA;AAAF,CAAN,EAAkBK,CAAlB,KAAwBL,MAAM,CAACM,IAAP,KAAgB,EAAhB,GAAqBF,GAArB,GAA2BC,CAAlE;;AACA,MAAME,cAAc,GAAG,CAAC;AAAEP,EAAAA;AAAF,CAAD,KAAgB,CAACA,MAAM,CAACQ,SAAP,KAAqB,EAArB,GAA0BR,MAAM,CAACS,KAAjC,GAAyCT,MAAM,CAACU,aAAP,CAAqBC,KAArB,CAA2B,CAA3B,CAA1C,IACnCX,MAAM,CAACP,WADX;;AAEA,SAASI,cAAT,CAAwBC,KAAxB,EAA+B;AAC3B,MAAIA,KAAK,CAACc,MAAN,KAAiB,CAArB,EACI,OAAO,EAAP,CAFuB,CAG3B;;AACA,MAAId,KAAK,CAAC,CAAD,CAAL,CAASE,MAAT,CAAgBP,WAAhB,KAAgC,EAAhC,IACAK,KAAK,CAAC,CAAD,CAAL,CAASE,MAAT,CAAgBQ,SAAhB,KAA8BrB,YAAY,CAAC0B,OAAb,CAAqBJ,KADvD,EAEIX,KAAK,GAAGA,KAAK,CAACa,KAAN,CAAY,CAAZ,CAAR,CANuB,CAO3B;;AACA,QAAMG,QAAQ,GAAGhB,KAAK,CAACA,KAAK,CAACc,MAAN,GAAe,CAAhB,CAAtB;AACA,MAAIE,QAAQ,KAAKC,SAAb,IACAD,QAAQ,CAACd,MAAT,CAAgBP,WAAhB,KAAgC,EADhC,IAEAqB,QAAQ,CAACd,MAAT,CAAgBgB,GAAhB,CAAoBC,QAApB,CAA6B9B,YAAY,CAAC0B,OAAb,CAAqBG,GAAlD,CAFJ,EAGIlB,KAAK,GAAGA,KAAK,CAACa,KAAN,CAAY,CAAZ,EAAe,CAAC,CAAhB,CAAR,CAZuB,CAa3B;;AACAb,EAAAA,KAAK,GAAGA,KAAK,CAACa,KAAN,CAAYb,KAAK,CAACoB,MAAN,CAAaf,MAAb,EAAqB,CAArB,CAAZ,CAAR;AACA,SAAOL,KAAK,CAACC,GAAN,CAAUQ,cAAV,EAA0BhB,IAA1B,CAA+B,IAA/B,CAAP;AACH","sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.getJoiner = void 0;\nconst primitives_1 = require(\"../../primitives\");\n/**\n * Makes no changes to `spec.lines[].tokens` but joins them into `spec.description`\n * following given spacing srtategy\n * @param {Spacing} spacing tells how to handle the whitespace\n */\nfunction descriptionTokenizer(spacing = 'compact') {\n    const join = getJoiner(spacing);\n    return (spec) => {\n        spec.description = join(spec.source);\n        return spec;\n    };\n}\nexports.default = descriptionTokenizer;\nfunction getJoiner(spacing) {\n    if (spacing === 'compact')\n        return compactJoiner;\n    if (spacing === 'preserve')\n        return preserveJoiner;\n    return spacing;\n}\nexports.getJoiner = getJoiner;\nfunction compactJoiner(lines) {\n    return lines\n        .map(({ tokens: { description } }) => description.trim())\n        .filter((description) => description !== '')\n        .join(' ');\n}\nconst lineNo = (num, { tokens }, i) => tokens.type === '' ? num : i;\nconst getDescription = ({ tokens }) => (tokens.delimiter === '' ? tokens.start : tokens.postDelimiter.slice(1)) +\n    tokens.description;\nfunction preserveJoiner(lines) {\n    if (lines.length === 0)\n        return '';\n    // skip the opening line with no description\n    if (lines[0].tokens.description === '' &&\n        lines[0].tokens.delimiter === primitives_1.Markers.start)\n        lines = lines.slice(1);\n    // skip the closing line with no description\n    const lastLine = lines[lines.length - 1];\n    if (lastLine !== undefined &&\n        lastLine.tokens.description === '' &&\n        lastLine.tokens.end.endsWith(primitives_1.Markers.end))\n        lines = lines.slice(0, -1);\n    // description starts at the last line of type definition\n    lines = lines.slice(lines.reduce(lineNo, 0));\n    return lines.map(getDescription).join('\\n');\n}\n"],"file":"description.cjs"}
+{"version":3,"sources":["description.js"],"names":["Object","defineProperty","exports","value","getJoiner","primitives_1","require","descriptionTokenizer","spacing","markers","Markers","join","spec","description","source","default","compactJoiner","preserveJoiner","lines","map","tokens","trim","filter","lineNo","num","i","type","getDescription","delimiter","start","postDelimiter","slice","length","lastLine","undefined","end","endsWith","reduce"],"mappings":"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","sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.getJoiner = void 0;\nconst primitives_1 = require(\"../../primitives\");\n/**\n * Makes no changes to `spec.lines[].tokens` but joins them into `spec.description`\n * following given spacing srtategy\n * @param {Spacing} spacing tells how to handle the whitespace\n * @param {BlockMarkers} markers tells how to handle comment block delimitation\n */\nfunction descriptionTokenizer(spacing = 'compact', markers = primitives_1.Markers) {\n    const join = getJoiner(spacing);\n    return (spec) => {\n        spec.description = join(spec.source, markers);\n        return spec;\n    };\n}\nexports.default = descriptionTokenizer;\nfunction getJoiner(spacing) {\n    if (spacing === 'compact')\n        return compactJoiner;\n    if (spacing === 'preserve')\n        return preserveJoiner;\n    return spacing;\n}\nexports.getJoiner = getJoiner;\nfunction compactJoiner(lines, markers = primitives_1.Markers) {\n    return lines\n        .map(({ tokens: { description } }) => description.trim())\n        .filter((description) => description !== '')\n        .join(' ');\n}\nconst lineNo = (num, { tokens }, i) => tokens.type === '' ? num : i;\nconst getDescription = ({ tokens }) => (tokens.delimiter === '' ? tokens.start : tokens.postDelimiter.slice(1)) +\n    tokens.description;\nfunction preserveJoiner(lines, markers = primitives_1.Markers) {\n    if (lines.length === 0)\n        return '';\n    // skip the opening line with no description\n    if (lines[0].tokens.description === '' &&\n        lines[0].tokens.delimiter === markers.start)\n        lines = lines.slice(1);\n    // skip the closing line with no description\n    const lastLine = lines[lines.length - 1];\n    if (lastLine !== undefined &&\n        lastLine.tokens.description === '' &&\n        lastLine.tokens.end.endsWith(markers.end))\n        lines = lines.slice(0, -1);\n    // description starts at the last line of type definition\n    lines = lines.slice(lines.reduce(lineNo, 0));\n    return lines.map(getDescription).join('\\n');\n}\n"],"file":"description.cjs"}

package/lib/parser/tokenizers/description.d.ts

@@ -1,9 +1,9 @@
-import { Line } from '../../primitives';
+import { Line, BlockMarkers, Markers } from '../../primitives';
 import { Tokenizer } from './index';
 /**
  * Walks over provided lines joining description token into a single string.
  * */
-export declare type Joiner = (lines: Line[]) => string;
+export declare type Joiner = (lines: Line[], markers?: BlockMarkers) => string;
 /**
  * Shortcut for standard Joiners
  * compact - strip surrounding whitespace and concat lines using a single string
@@ -14,6 +14,7 @@ export declare type Spacing = 'compact' | 'preserve' | Joiner;
  * Makes no changes to `spec.lines[].tokens` but joins them into `spec.description`
  * following given spacing srtategy
  * @param {Spacing} spacing tells how to handle the whitespace
+ * @param {BlockMarkers} markers tells how to handle comment block delimitation
  */
-export default function descriptionTokenizer(spacing?: Spacing): Tokenizer;
+export default function descriptionTokenizer(spacing?: Spacing, markers?: typeof Markers): Tokenizer;
 export declare function getJoiner(spacing: Spacing): Joiner;

package/lib/primitives.cjs

@@ -4,6 +4,8 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.Markers = void 0;
+/** @deprecated */
+
 var Markers;
 
 (function (Markers) {

package/lib/primitives.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["primitives.js"],"names":["Object","defineProperty","exports","value","Markers"],"mappings":"AAAA;;AACAA,MAAM,CAACC,cAAP,CAAsBC,OAAtB,EAA+B,YAA/B,EAA6C;AAAEC,EAAAA,KAAK,EAAE;AAAT,CAA7C;AACAD,OAAO,CAACE,OAAR,GAAkB,KAAK,CAAvB;AACA,IAAIA,OAAJ;;AACA,CAAC,UAAUA,OAAV,EAAmB;AAChBA,EAAAA,OAAO,CAAC,OAAD,CAAP,GAAmB,KAAnB;AACAA,EAAAA,OAAO,CAAC,SAAD,CAAP,GAAqB,MAArB;AACAA,EAAAA,OAAO,CAAC,OAAD,CAAP,GAAmB,GAAnB;AACAA,EAAAA,OAAO,CAAC,KAAD,CAAP,GAAiB,IAAjB;AACH,CALD,EAKGA,OAAO,GAAGF,OAAO,CAACE,OAAR,KAAoBF,OAAO,CAACE,OAAR,GAAkB,EAAtC,CALb","sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.Markers = void 0;\nvar Markers;\n(function (Markers) {\n    Markers[\"start\"] = \"/**\";\n    Markers[\"nostart\"] = \"/***\";\n    Markers[\"delim\"] = \"*\";\n    Markers[\"end\"] = \"*/\";\n})(Markers = exports.Markers || (exports.Markers = {}));\n"],"file":"primitives.cjs"}
+{"version":3,"sources":["primitives.js"],"names":["Object","defineProperty","exports","value","Markers"],"mappings":"AAAA;;AACAA,MAAM,CAACC,cAAP,CAAsBC,OAAtB,EAA+B,YAA/B,EAA6C;AAAEC,EAAAA,KAAK,EAAE;AAAT,CAA7C;AACAD,OAAO,CAACE,OAAR,GAAkB,KAAK,CAAvB;AACA;;AACA,IAAIA,OAAJ;;AACA,CAAC,UAAUA,OAAV,EAAmB;AAChBA,EAAAA,OAAO,CAAC,OAAD,CAAP,GAAmB,KAAnB;AACAA,EAAAA,OAAO,CAAC,SAAD,CAAP,GAAqB,MAArB;AACAA,EAAAA,OAAO,CAAC,OAAD,CAAP,GAAmB,GAAnB;AACAA,EAAAA,OAAO,CAAC,KAAD,CAAP,GAAiB,IAAjB;AACH,CALD,EAKGA,OAAO,GAAGF,OAAO,CAACE,OAAR,KAAoBF,OAAO,CAACE,OAAR,GAAkB,EAAtC,CALb","sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.Markers = void 0;\n/** @deprecated */\nvar Markers;\n(function (Markers) {\n    Markers[\"start\"] = \"/**\";\n    Markers[\"nostart\"] = \"/***\";\n    Markers[\"delim\"] = \"*\";\n    Markers[\"end\"] = \"*/\";\n})(Markers = exports.Markers || (exports.Markers = {}));\n"],"file":"primitives.cjs"}

package/lib/primitives.d.ts

@@ -1,9 +1,16 @@
+/** @deprecated */
 export declare enum Markers {
     start = "/**",
     nostart = "/***",
     delim = "*",
     end = "*/"
 }
+export interface BlockMarkers {
+    start: string;
+    nostart: string;
+    delim: string;
+    end: string;
+}
 export interface Block {
     description: string;
     tags: Spec[];

package/lib/transforms/align.cjs

@@ -26,10 +26,10 @@ const zeroWidth = {
   name: 0
 };
 
-const getWidth = (w, {
+const getWidth = (markers = primitives_1.Markers) => (w, {
   tokens: t
 }) => ({
-  start: t.delimiter === primitives_1.Markers.start ? t.start.length : w.start,
+  start: t.delimiter === markers.start ? t.start.length : w.start,
   tag: Math.max(w.tag, t.tag.length),
   type: Math.max(w.type, t.type.length),
   name: Math.max(w.name, t.name.length)
@@ -37,7 +37,7 @@ const getWidth = (w, {
 
 const space = len => ''.padStart(len, ' ');
 
-function align() {
+function align(markers = primitives_1.Markers) {
   let intoTags = false;
   let w;
 
@@ -46,7 +46,7 @@ function align() {
     if (tokens.tag !== '') intoTags = true;
     const isEmpty = tokens.tag === '' && tokens.name === '' && tokens.type === '' && tokens.description === ''; // dangling '*/'
 
-    if (tokens.end === primitives_1.Markers.end && isEmpty) {
+    if (tokens.end === markers.end && isEmpty) {
       tokens.start = space(w.start + 1);
       return Object.assign(Object.assign({}, line), {
         tokens
@@ -54,11 +54,11 @@ function align() {
     }
 
     switch (tokens.delimiter) {
-      case primitives_1.Markers.start:
+      case markers.start:
         tokens.start = space(w.start);
         break;
 
-      case primitives_1.Markers.delim:
+      case markers.delim:
         tokens.start = space(w.start + 1);
         break;
 
@@ -116,7 +116,7 @@ function align() {
     } = _a,
         fields = __rest(_a, ["source"]);
 
-    w = source.reduce(getWidth, Object.assign({}, zeroWidth));
+    w = source.reduce(getWidth(markers), Object.assign({}, zeroWidth));
     return util_1.rewireSource(Object.assign(Object.assign({}, fields), {
       source: source.map(update)
     }));

package/lib/transforms/align.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["align.js"],"names":["__rest","s","e","t","p","Object","prototype","hasOwnProperty","call","indexOf","getOwnPropertySymbols","i","length","propertyIsEnumerable","defineProperty","exports","value","primitives_1","require","util_1","zeroWidth","start","tag","type","name","getWidth","w","tokens","delimiter","Markers","Math","max","space","len","padStart","align","intoTags","update","line","assign","isEmpty","description","end","delim","postDelimiter","nothingAfter","postName","postType","postTag","_a","source","fields","reduce","rewireSource","map","default"],"mappings":"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","sourcesContent":["\"use strict\";\nvar __rest = (this && this.__rest) || function (s, e) {\n    var t = {};\n    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)\n        t[p] = s[p];\n    if (s != null && typeof Object.getOwnPropertySymbols === \"function\")\n        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {\n            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))\n                t[p[i]] = s[p[i]];\n        }\n    return t;\n};\nObject.defineProperty(exports, \"__esModule\", { value: true });\nconst primitives_1 = require(\"../primitives\");\nconst util_1 = require(\"../util\");\nconst zeroWidth = {\n    start: 0,\n    tag: 0,\n    type: 0,\n    name: 0,\n};\nconst getWidth = (w, { tokens: t }) => ({\n    start: t.delimiter === primitives_1.Markers.start ? t.start.length : w.start,\n    tag: Math.max(w.tag, t.tag.length),\n    type: Math.max(w.type, t.type.length),\n    name: Math.max(w.name, t.name.length),\n});\nconst space = (len) => ''.padStart(len, ' ');\nfunction align() {\n    let intoTags = false;\n    let w;\n    function update(line) {\n        const tokens = Object.assign({}, line.tokens);\n        if (tokens.tag !== '')\n            intoTags = true;\n        const isEmpty = tokens.tag === '' &&\n            tokens.name === '' &&\n            tokens.type === '' &&\n            tokens.description === '';\n        // dangling '*/'\n        if (tokens.end === primitives_1.Markers.end && isEmpty) {\n            tokens.start = space(w.start + 1);\n            return Object.assign(Object.assign({}, line), { tokens });\n        }\n        switch (tokens.delimiter) {\n            case primitives_1.Markers.start:\n                tokens.start = space(w.start);\n                break;\n            case primitives_1.Markers.delim:\n                tokens.start = space(w.start + 1);\n                break;\n            default:\n                tokens.delimiter = '';\n                tokens.start = space(w.start + 2); // compensate delimiter\n        }\n        if (!intoTags) {\n            tokens.postDelimiter = tokens.description === '' ? '' : ' ';\n            return Object.assign(Object.assign({}, line), { tokens });\n        }\n        const nothingAfter = {\n            delim: false,\n            tag: false,\n            type: false,\n            name: false,\n        };\n        if (tokens.description === '') {\n            nothingAfter.name = true;\n            tokens.postName = '';\n            if (tokens.name === '') {\n                nothingAfter.type = true;\n                tokens.postType = '';\n                if (tokens.type === '') {\n                    nothingAfter.tag = true;\n                    tokens.postTag = '';\n                    if (tokens.tag === '') {\n                        nothingAfter.delim = true;\n                    }\n                }\n            }\n        }\n        tokens.postDelimiter = nothingAfter.delim ? '' : ' ';\n        if (!nothingAfter.tag)\n            tokens.postTag = space(w.tag - tokens.tag.length + 1);\n        if (!nothingAfter.type)\n            tokens.postType = space(w.type - tokens.type.length + 1);\n        if (!nothingAfter.name)\n            tokens.postName = space(w.name - tokens.name.length + 1);\n        return Object.assign(Object.assign({}, line), { tokens });\n    }\n    return (_a) => {\n        var { source } = _a, fields = __rest(_a, [\"source\"]);\n        w = source.reduce(getWidth, Object.assign({}, zeroWidth));\n        return util_1.rewireSource(Object.assign(Object.assign({}, fields), { source: source.map(update) }));\n    };\n}\nexports.default = align;\n"],"file":"align.cjs"}
+{"version":3,"sources":["align.js"],"names":["__rest","s","e","t","p","Object","prototype","hasOwnProperty","call","indexOf","getOwnPropertySymbols","i","length","propertyIsEnumerable","defineProperty","exports","value","primitives_1","require","util_1","zeroWidth","start","tag","type","name","getWidth","markers","Markers","w","tokens","delimiter","Math","max","space","len","padStart","align","intoTags","update","line","assign","isEmpty","description","end","delim","postDelimiter","nothingAfter","postName","postType","postTag","_a","source","fields","reduce","rewireSource","map","default"],"mappings":"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","sourcesContent":["\"use strict\";\nvar __rest = (this && this.__rest) || function (s, e) {\n    var t = {};\n    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)\n        t[p] = s[p];\n    if (s != null && typeof Object.getOwnPropertySymbols === \"function\")\n        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {\n            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))\n                t[p[i]] = s[p[i]];\n        }\n    return t;\n};\nObject.defineProperty(exports, \"__esModule\", { value: true });\nconst primitives_1 = require(\"../primitives\");\nconst util_1 = require(\"../util\");\nconst zeroWidth = {\n    start: 0,\n    tag: 0,\n    type: 0,\n    name: 0,\n};\nconst getWidth = (markers = primitives_1.Markers) => (w, { tokens: t }) => ({\n    start: t.delimiter === markers.start ? t.start.length : w.start,\n    tag: Math.max(w.tag, t.tag.length),\n    type: Math.max(w.type, t.type.length),\n    name: Math.max(w.name, t.name.length),\n});\nconst space = (len) => ''.padStart(len, ' ');\nfunction align(markers = primitives_1.Markers) {\n    let intoTags = false;\n    let w;\n    function update(line) {\n        const tokens = Object.assign({}, line.tokens);\n        if (tokens.tag !== '')\n            intoTags = true;\n        const isEmpty = tokens.tag === '' &&\n            tokens.name === '' &&\n            tokens.type === '' &&\n            tokens.description === '';\n        // dangling '*/'\n        if (tokens.end === markers.end && isEmpty) {\n            tokens.start = space(w.start + 1);\n            return Object.assign(Object.assign({}, line), { tokens });\n        }\n        switch (tokens.delimiter) {\n            case markers.start:\n                tokens.start = space(w.start);\n                break;\n            case markers.delim:\n                tokens.start = space(w.start + 1);\n                break;\n            default:\n                tokens.delimiter = '';\n                tokens.start = space(w.start + 2); // compensate delimiter\n        }\n        if (!intoTags) {\n            tokens.postDelimiter = tokens.description === '' ? '' : ' ';\n            return Object.assign(Object.assign({}, line), { tokens });\n        }\n        const nothingAfter = {\n            delim: false,\n            tag: false,\n            type: false,\n            name: false,\n        };\n        if (tokens.description === '') {\n            nothingAfter.name = true;\n            tokens.postName = '';\n            if (tokens.name === '') {\n                nothingAfter.type = true;\n                tokens.postType = '';\n                if (tokens.type === '') {\n                    nothingAfter.tag = true;\n                    tokens.postTag = '';\n                    if (tokens.tag === '') {\n                        nothingAfter.delim = true;\n                    }\n                }\n            }\n        }\n        tokens.postDelimiter = nothingAfter.delim ? '' : ' ';\n        if (!nothingAfter.tag)\n            tokens.postTag = space(w.tag - tokens.tag.length + 1);\n        if (!nothingAfter.type)\n            tokens.postType = space(w.type - tokens.type.length + 1);\n        if (!nothingAfter.name)\n            tokens.postName = space(w.name - tokens.name.length + 1);\n        return Object.assign(Object.assign({}, line), { tokens });\n    }\n    return (_a) => {\n        var { source } = _a, fields = __rest(_a, [\"source\"]);\n        w = source.reduce(getWidth(markers), Object.assign({}, zeroWidth));\n        return util_1.rewireSource(Object.assign(Object.assign({}, fields), { source: source.map(update) }));\n    };\n}\nexports.default = align;\n"],"file":"align.cjs"}

package/lib/transforms/align.d.ts

@@ -1,2 +1,3 @@
 import { Transform } from './index';
-export default function align(): Transform;
+import { Markers } from '../primitives';
+export default function align(markers?: typeof Markers): Transform;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "comment-parser",
-  "version": "1.2.4",
+  "version": "1.3.0",
   "description": "Generic JSDoc-like comment parser",
   "type": "module",
   "main": "lib/index.cjs",
@@ -66,15 +66,16 @@
   ],
   "author": "Sergiy Yavorsky <sergiy@yavorsky.me> (https://github.com/syavorsky)",
   "contributors": [
+    "Alex Grozav (https://github.com/alexgrozav)",
     "Alexej Yaroshevich (https://github.com/zxqfox)",
     "Andre Wachsmuth (https://github.com/blutorange)",
     "Brett Zamir (https://github.com/brettz9)",
     "Dieter Oberkofler (https://github.com/doberkofler)",
     "Evgeny Reznichenko (https://github.com/zxcabs)",
     "Javier \"Ciberma\" Mora (https://github.com/jhm-ciberman)",
+    "Jayden Seric (https://github.com/jaydenseric)",
     "Jordan Harband (https://github.com/ljharb)",
-    "tengattack (https://github.com/tengattack)",
-    "Jayden Seric (https://github.com/jaydenseric)"
+    "tengattack (https://github.com/tengattack)"
   ],
   "license": "MIT",
   "bugs": {

package/src/parser/index.ts

@@ -1,4 +1,4 @@
-import { Block, Line, Problem } from '../primitives';
+import { Block, Line, Problem, BlockMarkers, Markers } from '../primitives';
 import { splitLines } from '../util';
 import blockParser from './block-parser';
 import sourceParser from './source-parser';
@@ -18,6 +18,8 @@ export interface Options {
   fence: string;
   // block and comment description compaction strategy
   spacing: 'compact' | 'preserve';
+  // comment description markers
+  markers: BlockMarkers;
   // tokenizer functions extracting name, type, and description out of tag, see Tokenizer
   tokenizers: Tokenizer[];
 }
@@ -28,6 +30,7 @@ export default function getParser({
   startLine = 0,
   fence = '```',
   spacing = 'compact',
+  markers = Markers,
   tokenizers = [
     tokenizeTag(),
     tokenizeType(spacing),
@@ -37,7 +40,7 @@ export default function getParser({
 }: Partial<Options> = {}): Parser {
   if (startLine < 0 || startLine % 1 > 0) throw new Error('Invalid startLine');
 
-  const parseSource = sourceParser({ startLine });
+  const parseSource = sourceParser({ startLine, markers });
   const parseBlock = blockParser({ fence });
   const parseSpec = specParser({ tokenizers });
   const joinDescription = getDescriptionJoiner(spacing);
@@ -57,7 +60,7 @@ export default function getParser({
       const specs = sections.slice(1).map(parseSpec);
 
       blocks.push({
-        description: joinDescription(sections[0]),
+        description: joinDescription(sections[0], markers),
         tags: specs,
         source: lines,
         problems: specs.reduce(

package/src/parser/source-parser.ts

@@ -1,14 +1,16 @@
-import { Line, Markers, Tokens } from '../primitives';
+import { Line, Tokens, BlockMarkers, Markers } from '../primitives';
 import { seedTokens, splitSpace, splitCR } from '../util';
 
 export interface Options {
   startLine: number;
+  markers: BlockMarkers;
 }
 
 export type Parser = (source: string) => Line[] | null;
 
 export default function getParser({
   startLine = 0,
+  markers = Markers,
 }: Partial<Options> = {}): Parser {
   let block: Line[] | null = null;
   let num = startLine;
@@ -22,12 +24,12 @@ export default function getParser({
 
     if (
       block === null &&
-      rest.startsWith(Markers.start) &&
-      !rest.startsWith(Markers.nostart)
+      rest.startsWith(markers.start) &&
+      !rest.startsWith(markers.nostart)
     ) {
       block = [];
-      tokens.delimiter = rest.slice(0, Markers.start.length);
-      rest = rest.slice(Markers.start.length);
+      tokens.delimiter = rest.slice(0, markers.start.length);
+      rest = rest.slice(markers.start.length);
       [tokens.postDelimiter, rest] = splitSpace(rest);
     }
 
@@ -36,22 +38,22 @@ export default function getParser({
       return null;
     }
 
-    const isClosed = rest.trimRight().endsWith(Markers.end);
+    const isClosed = rest.trimRight().endsWith(markers.end);
 
     if (
       tokens.delimiter === '' &&
-      rest.startsWith(Markers.delim) &&
-      !rest.startsWith(Markers.end)
+      rest.startsWith(markers.delim) &&
+      !rest.startsWith(markers.end)
     ) {
-      tokens.delimiter = Markers.delim;
-      rest = rest.slice(Markers.delim.length);
+      tokens.delimiter = markers.delim;
+      rest = rest.slice(markers.delim.length);
       [tokens.postDelimiter, rest] = splitSpace(rest);
     }
 
     if (isClosed) {
       const trimmed = rest.trimRight();
-      tokens.end = rest.slice(trimmed.length - Markers.end.length);
-      rest = trimmed.slice(0, -Markers.end.length);
+      tokens.end = rest.slice(trimmed.length - markers.end.length);
+      rest = trimmed.slice(0, -markers.end.length);
     }
 
     tokens.description = rest;

package/src/parser/tokenizers/description.ts

@@ -1,10 +1,10 @@
-import { Spec, Line, Markers } from '../../primitives';
+import { Spec, Line, BlockMarkers, Markers } from '../../primitives';
 import { Tokenizer } from './index';
 
 /**
  * Walks over provided lines joining description token into a single string.
  * */
-export type Joiner = (lines: Line[]) => string;
+export type Joiner = (lines: Line[], markers?: BlockMarkers) => string;
 
 /**
  * Shortcut for standard Joiners
@@ -17,13 +17,15 @@ export type Spacing = 'compact' | 'preserve' | Joiner;
  * Makes no changes to `spec.lines[].tokens` but joins them into `spec.description`
  * following given spacing srtategy
  * @param {Spacing} spacing tells how to handle the whitespace
+ * @param {BlockMarkers} markers tells how to handle comment block delimitation
  */
 export default function descriptionTokenizer(
-  spacing: Spacing = 'compact'
+  spacing: Spacing = 'compact',
+  markers = Markers
 ): Tokenizer {
   const join = getJoiner(spacing);
   return (spec: Spec): Spec => {
-    spec.description = join(spec.source);
+    spec.description = join(spec.source, markers);
     return spec;
   };
 }
@@ -31,10 +33,11 @@ export default function descriptionTokenizer(
 export function getJoiner(spacing: Spacing): Joiner {
   if (spacing === 'compact') return compactJoiner;
   if (spacing === 'preserve') return preserveJoiner;
+
   return spacing;
 }
 
-function compactJoiner(lines: Line[]): string {
+function compactJoiner(lines: Line[], markers = Markers): string {
   return lines
     .map(({ tokens: { description } }: Line) => description.trim())
     .filter((description) => description !== '')
@@ -48,13 +51,13 @@ const getDescription = ({ tokens }: Line) =>
   (tokens.delimiter === '' ? tokens.start : tokens.postDelimiter.slice(1)) +
   tokens.description;
 
-function preserveJoiner(lines: Line[]): string {
+function preserveJoiner(lines: Line[], markers = Markers): string {
   if (lines.length === 0) return '';
 
   // skip the opening line with no description
   if (
     lines[0].tokens.description === '' &&
-    lines[0].tokens.delimiter === Markers.start
+    lines[0].tokens.delimiter === markers.start
   )
     lines = lines.slice(1);
 
@@ -64,7 +67,7 @@ function preserveJoiner(lines: Line[]): string {
   if (
     lastLine !== undefined &&
     lastLine.tokens.description === '' &&
-    lastLine.tokens.end.endsWith(Markers.end)
+    lastLine.tokens.end.endsWith(markers.end)
   )
     lines = lines.slice(0, -1);
 

package/src/primitives.ts

@@ -1,3 +1,4 @@
+/** @deprecated */
 export enum Markers {
   start = '/**',
   nostart = '/***',
@@ -5,6 +6,13 @@ export enum Markers {
   end = '*/',
 }
 
+export interface BlockMarkers {
+  start: string;
+  nostart: string;
+  delim: string;
+  end: string;
+}
+
 export interface Block {
   description: string;
   tags: Spec[];

package/src/transforms/align.ts

@@ -1,5 +1,5 @@
 import { Transform } from './index';
-import { Markers, Block, Line } from '../primitives';
+import { BlockMarkers, Block, Line, Markers } from '../primitives';
 import { rewireSource } from '../util';
 
 interface Width {
@@ -16,16 +16,18 @@ const zeroWidth = {
   name: 0,
 };
 
-const getWidth = (w: Width, { tokens: t }: Line) => ({
-  start: t.delimiter === Markers.start ? t.start.length : w.start,
-  tag: Math.max(w.tag, t.tag.length),
-  type: Math.max(w.type, t.type.length),
-  name: Math.max(w.name, t.name.length),
-});
+const getWidth =
+  (markers = Markers) =>
+  (w: Width, { tokens: t }: Line) => ({
+    start: t.delimiter === markers.start ? t.start.length : w.start,
+    tag: Math.max(w.tag, t.tag.length),
+    type: Math.max(w.type, t.type.length),
+    name: Math.max(w.name, t.name.length),
+  });
 
 const space = (len: number) => ''.padStart(len, ' ');
 
-export default function align(): Transform {
+export default function align(markers = Markers): Transform {
   let intoTags = false;
   let w: Width;
 
@@ -40,16 +42,16 @@ export default function align(): Transform {
       tokens.description === '';
 
     // dangling '*/'
-    if (tokens.end === Markers.end && isEmpty) {
+    if (tokens.end === markers.end && isEmpty) {
       tokens.start = space(w.start + 1);
       return { ...line, tokens };
     }
 
     switch (tokens.delimiter) {
-      case Markers.start:
+      case markers.start:
         tokens.start = space(w.start);
         break;
-      case Markers.delim:
+      case markers.delim:
         tokens.start = space(w.start + 1);
         break;
       default:
@@ -101,7 +103,7 @@ export default function align(): Transform {
   }
 
   return ({ source, ...fields }: Block): Block => {
-    w = source.reduce(getWidth, { ...zeroWidth });
+    w = source.reduce(getWidth(markers), { ...zeroWidth });
     return rewireSource({ ...fields, source: source.map(update) });
   };
 }

package/tests/e2e/examples.js

@@ -80,7 +80,7 @@ function parse_escaping(source, parse, stringify, transforms) {
   // parse(source, {fence: '###'}) -- update source correspondingly
 
   /**
-   * @example "some code" 
+   * @example "some code"
   ###
   @decorator
   function hello() {