react-markdown-table-ts 0.5.6 → 0.5.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +65 -63
- package/dist/index.cjs.js +20 -24
- package/dist/index.cjs.js.map +1 -1
- package/dist/index.esm.js +20 -24
- package/dist/index.esm.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
@@ -1,63 +1,65 @@
|
|
1
|
-
# ⚛️ react-markdown-table-ts 🛡️
|
2
|
-
|
3
|
-
[](https://www.npmjs.com/package/react-markdown-table-ts)
|
4
|
-

|
5
|
-
[](https://codecov.io/gh/keithwalsh/react-markdown-table-ts)
|
6
|
-
|
7
|
-
|
8
|
-
|
9
|
-
|
10
|
-
|
11
|
-
|
12
|
-
|
13
|
-
- **
|
14
|
-
- **
|
15
|
-
- **
|
16
|
-
- **
|
17
|
-
- **
|
18
|
-
- **
|
19
|
-
- **
|
20
|
-
|
21
|
-
|
22
|
-
|
23
|
-
|
24
|
-
|
25
|
-
|
26
|
-
|
27
|
-
|
28
|
-
|
29
|
-
|
30
|
-
|
31
|
-
|
32
|
-
|
33
|
-
|
34
|
-
|
35
|
-
|
36
|
-
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
46
|
-
|
47
|
-
|
48
|
-
|
49
|
-
|
50
|
-
|
51
|
-
|
52
|
-
|
53
|
-
|
54
|
-
|
55
|
-
|
56
|
-
['
|
57
|
-
|
58
|
-
|
59
|
-
|
60
|
-
|
61
|
-
|
62
|
-
|
63
|
-
|
1
|
+
# ⚛️ react-markdown-table-ts 🛡️
|
2
|
+
|
3
|
+
[](https://www.npmjs.com/package/react-markdown-table-ts)
|
4
|
+

|
5
|
+
[](https://codecov.io/gh/keithwalsh/react-markdown-table-ts)
|
6
|
+
[](https://packagequality.com/#?package=react-markdown-table-ts)
|
7
|
+
[](https://codeclimate.com/github/keithwalsh/react-markdown-table-ts)
|
8
|
+
|
9
|
+
A React component that converts structured data into Markdown table syntax and displays it within a `<pre>` tag.
|
10
|
+
|
11
|
+
## ✨ Features
|
12
|
+
|
13
|
+
- **Type Safety:** Built with TypeScript to provide strong type guarantees.
|
14
|
+
- **Easy Integration:** Simple API for converting data arrays into Markdown table strings.
|
15
|
+
- **Customizable Alignments:** Specify column alignments (left, center, right, or none) with ease.
|
16
|
+
- **Compact Mode:** Option to generate compact tables with minimal padding.
|
17
|
+
- **Tab-Separated Columns:** Option to add tabs between columns.
|
18
|
+
- **Newline Handling: Option** to replace newlines in cells with HTML line breaks.
|
19
|
+
- **Raw Markdown Access:** Retrieve the generated Markdown string for further processing or usage.
|
20
|
+
- **Header Options:** Choose whether to include a header row or use default alphabetical headers.
|
21
|
+
- **Flexible Styling:** Apply custom CSS classes for styling the rendered Markdown.
|
22
|
+
|
23
|
+
## 📦 Installation
|
24
|
+
|
25
|
+
Install the package via npm:
|
26
|
+
|
27
|
+
```
|
28
|
+
|
29
|
+
npm install react-markdown-table-ts
|
30
|
+
|
31
|
+
```
|
32
|
+
|
33
|
+
## 🔧 API
|
34
|
+
|
35
|
+
### MarkdownTable Props
|
36
|
+
|
37
|
+
| Prop | Type | Default | Description |
|
38
|
+
| :------------------: | :-------------------------------------------: | :---------: | :-----------------------------------------: |
|
39
|
+
| `data` | `string[][]` | `null` | The table data as a 2D array of strings |
|
40
|
+
| `columnAlignments` | `('left' \| 'center' \| 'right' \| 'none')[]` | `[]` | Alignment for each column |
|
41
|
+
| `isCompact` | `boolean` | `false` | Use minimal column widths |
|
42
|
+
| `className` | `string` | `undefined` | CSS class for the `<pre>` tag |
|
43
|
+
| `hasTabs` | `boolean` | `false` | Add tabs between table columns |
|
44
|
+
| `canReplaceNewlines` | `boolean` | `false` | Replace newlines in cells with `<br>` tags |
|
45
|
+
| `onTableCreate` | `(markdownString: string) => void` | `undefined` | Callback to receive the Markdown string |
|
46
|
+
| `hasHeader` | `boolean` | `true` | Whether the first row of `data` is a header |
|
47
|
+
|
48
|
+
## 🚀 Usage
|
49
|
+
|
50
|
+
```jsx
|
51
|
+
import React from 'react';
|
52
|
+
import {MarkdownTable} from 'markdown-table-component';
|
53
|
+
|
54
|
+
const App = () => {
|
55
|
+
const data = [
|
56
|
+
['Header 1', 'Header 2', 'Header 3'],
|
57
|
+
['Row 1, Col 1', 'Row 1, Col 2', 'Row 1, Col 3'],
|
58
|
+
['Row 2, Col 1', 'Row 2, Col 2', 'Row 2, Col 3'],
|
59
|
+
];
|
60
|
+
|
61
|
+
return <MarkdownTable data={data} />;
|
62
|
+
};
|
63
|
+
|
64
|
+
export default App;
|
65
|
+
```
|
package/dist/index.cjs.js
CHANGED
@@ -4095,6 +4095,17 @@ var MarkdownTableError = /** @class */ (function (_super) {
|
|
4095
4095
|
}(Error));
|
4096
4096
|
|
4097
4097
|
// src/utils.ts
|
4098
|
+
/**
|
4099
|
+
* Adjusts column alignments array to match the required column count
|
4100
|
+
* @param columnAlignments - Original alignment settings
|
4101
|
+
* @param columnCount - Required number of columns
|
4102
|
+
* @returns Adjusted array of column alignments
|
4103
|
+
*/
|
4104
|
+
function getAdjustedAlignments(columnAlignments, columnCount) {
|
4105
|
+
var defaultAlignment = 'left';
|
4106
|
+
return columnAlignments.length < columnCount
|
4107
|
+
? __spreadArray(__spreadArray([], Array.from(columnAlignments), true), Array(columnCount - columnAlignments.length).fill(defaultAlignment), true) : Array.from(columnAlignments);
|
4108
|
+
}
|
4098
4109
|
/**
|
4099
4110
|
* Calculates the maximum width for each column based on the content.
|
4100
4111
|
* @param tableRows - All rows (header and body) of the table.
|
@@ -4128,16 +4139,14 @@ function formatMarkdownRow(columnCount, currentRow, columnAlignments, columnWidt
|
|
4128
4139
|
if (useTabs === void 0) { useTabs = false; }
|
4129
4140
|
if (canReplaceNewlines === void 0) { canReplaceNewlines = false; }
|
4130
4141
|
if (hasPadding === void 0) { hasPadding = true; }
|
4131
|
-
var
|
4132
|
-
var adjustedAlignments = columnAlignments.length < columnCount
|
4133
|
-
? __spreadArray(__spreadArray([], columnAlignments, true), Array(columnCount - columnAlignments.length).fill(defaultAlignment), true) : columnAlignments;
|
4142
|
+
var adjustedAlignments = getAdjustedAlignments(columnAlignments, columnCount);
|
4134
4143
|
var markdownRow = '|';
|
4135
4144
|
for (var i = 0; i < columnCount; i++) {
|
4136
4145
|
var cell = (_a = currentRow[i]) !== null && _a !== void 0 ? _a : '';
|
4137
4146
|
if (canReplaceNewlines) {
|
4138
4147
|
cell = replaceNewlinesInCell(cell);
|
4139
4148
|
}
|
4140
|
-
var alignment = (_b = adjustedAlignments[i]) !== null && _b !== void 0 ? _b :
|
4149
|
+
var alignment = (_b = adjustedAlignments[i]) !== null && _b !== void 0 ? _b : 'left';
|
4141
4150
|
var targetWidth = columnWidths ? columnWidths[i] : cell.length;
|
4142
4151
|
var padding = hasPadding ? ' ' : '';
|
4143
4152
|
if (alignment === 'right') {
|
@@ -4169,12 +4178,10 @@ function formatAlignmentRow(columnCount, columnAlignments, columnWidths, useTabs
|
|
4169
4178
|
var _a;
|
4170
4179
|
if (useTabs === void 0) { useTabs = false; }
|
4171
4180
|
if (hasPadding === void 0) { hasPadding = true; }
|
4172
|
-
var
|
4173
|
-
var adjustedAlignments = columnAlignments.length < columnCount
|
4174
|
-
? __spreadArray(__spreadArray([], columnAlignments, true), Array(columnCount - columnAlignments.length).fill(defaultAlignment), true) : columnAlignments;
|
4181
|
+
var adjustedAlignments = getAdjustedAlignments(columnAlignments, columnCount);
|
4175
4182
|
var alignmentRow = '|';
|
4176
4183
|
for (var i = 0; i < columnCount; i++) {
|
4177
|
-
var alignment = (_a = adjustedAlignments[i]) !== null && _a !== void 0 ? _a :
|
4184
|
+
var alignment = (_a = adjustedAlignments[i]) !== null && _a !== void 0 ? _a : 'left';
|
4178
4185
|
var targetWidth = columnWidths ? columnWidths[i] : 3;
|
4179
4186
|
var alignIndicator = '';
|
4180
4187
|
var padding = hasPadding ? ' ' : '';
|
@@ -18578,24 +18585,13 @@ var MarkdownTable = function (_a) {
|
|
18578
18585
|
if (!Array.isArray(inputData) || inputData.length === 0) {
|
18579
18586
|
throw new MarkdownTableError("The 'data' prop must be a non-empty two-dimensional array.");
|
18580
18587
|
}
|
18581
|
-
var
|
18582
|
-
? {
|
18583
|
-
|
18584
|
-
|
18585
|
-
}
|
18586
|
-
: {
|
18587
|
-
inputDataHeader: generateAlphabetHeaders(inputData[0].length),
|
18588
|
-
inputDataBody: inputData,
|
18589
|
-
};
|
18590
|
-
return generateMarkdownTableString(tableData, columnAlignments, adjustColumnWidths, hasTabs, canReplaceNewlines, hasPadding);
|
18588
|
+
var _a = hasHeader
|
18589
|
+
? { inputDataHeader: inputData[0], inputDataBody: inputData.slice(1) }
|
18590
|
+
: { inputDataHeader: generateAlphabetHeaders(inputData[0].length), inputDataBody: inputData }, inputDataHeader = _a.inputDataHeader, inputDataBody = _a.inputDataBody;
|
18591
|
+
return generateMarkdownTableString({ inputDataHeader: inputDataHeader, inputDataBody: inputDataBody }, columnAlignments, adjustColumnWidths, hasTabs, canReplaceNewlines, hasPadding);
|
18591
18592
|
}
|
18592
18593
|
catch (error) {
|
18593
|
-
|
18594
|
-
return "Error: ".concat(error.message);
|
18595
|
-
}
|
18596
|
-
else {
|
18597
|
-
throw error;
|
18598
|
-
}
|
18594
|
+
return error instanceof MarkdownTableError ? "Error: ".concat(error.message) : (function () { throw error; })();
|
18599
18595
|
}
|
18600
18596
|
}, [
|
18601
18597
|
inputData,
|