starlight-table 1.0.0

package/README.md

@@ -0,0 +1,118 @@
+# starlight-table
+
+**Description**
+
+starlight-table is a flexible terminal table and list builder for Starlight.
+It does not force any predefined structure. Developers fully control columns,
+rows, and layout.
+
+
+
+
+## Why starlight-table?
+
+
+  - No predefined schema
+  - Builder-style API
+  - Add rows dynamically
+  - Works for products, reports, logs, and data views
+  - Outputs clean ASCII tables
+
+
+## Creating a Table
+
+Use `createTable()` to start building a table.
+
+`
+import { createTable } from "starlight-table"
+
+let table = createTable()
+`
+
+
+
+
+## Setting Headers
+
+Headers are optional. You can define any number of columns.
+
+`
+table.setHeaders(["Product", "Price", "Stock"])
+`
+
+
+
+
+## Adding Rows
+
+Rows can be added one by one or in batches.
+
+`
+table.addRow(["Keyboard", "$50", 10])
+table.addRow(["Mouse", "$25", 20])
+`
+
+You can also add multiple rows at once.
+
+`
+table.addRows([
+  ["Monitor", "$300", 5],
+  ["USB Cable", "$5", 100]
+])
+`
+
+
+
+
+## Rendering the Table
+
+Once your data is ready, render the table as a string.
+
+`
+const output = table.render()
+`
+
+This output can be printed using `sldeploy`.
+
+
+
+
+## Creating Lists
+
+starlight-table also supports simple lists.
+
+`
+import { createList } from "starlight-table"
+
+const list = createList([
+  "Flexible",
+  "Readable",
+  "Developer-controlled"
+])
+`
+
+
+
+
+## Common Use Cases
+
+
+  - Product listings
+  - CLI dashboards
+  - Debug output
+  - Reports
+  - Log summaries
+
+
+## Design Philosophy
+
+starlight-table is designed to:
+
+  - Give developers full control
+  - Remain simple and predictable
+  - Integrate naturally with Starlight
+
+
+**There are no limits on rows or columns.**
+
+You decide how your table looks.

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "starlight-table",
+  "version": "1.0.0",
+  "description": "Flexible table and list builder for Starlight",
+  "type": "module",
+  "main": "starlight-table.mjs",
+  "keywords": [
+    "starlight",
+    "table",
+    "cli",
+    "ascii",
+    "builder",
+    "terminal"
+  ],
+  "author": "Macedon",
+  "license": "MIT"
+}

package/starlight-table.mjs

@@ -0,0 +1,94 @@
+/**
+ * Starlight Table Builder
+ * Fully configurable ASCII table generator
+ */
+
+function pad(text, width) {
+  const str = String(text)
+  return str + " ".repeat(Math.max(0, width - str.length))
+}
+
+function separator(widths) {
+  return "+" + widths.map(w => "-".repeat(w + 2)).join("+") + "+"
+}
+
+function row(cells, widths) {
+  return "| " + cells.map((c, i) => pad(c, widths[i])).join(" | ") + " |"
+}
+
+class Table {
+  constructor() {
+    this.headers = []
+    this.rows = []
+  }
+
+  setHeaders(headers) {
+    this.headers = headers.map(h => String(h))
+    return this
+  }
+
+  addRow(row) {
+    this.rows.push(row.map(v => v === null || v === undefined ? "" : String(v)))
+    return this
+  }
+
+  addRows(rows) {
+    for (const r of rows) {
+      this.addRow(r)
+    }
+    return this
+  }
+
+  columnWidths() {
+    const all = []
+    if (this.headers.length) all.push(this.headers)
+    all.push(...this.rows)
+
+    const cols = Math.max(...all.map(r => r.length))
+    const widths = []
+
+    for (let i = 0; i < cols; i++) {
+      widths[i] = Math.max(
+        ...all.map(r => (r[i] ? r[i].length : 0))
+      )
+    }
+
+    return widths
+  }
+
+  render() {
+    if (!this.headers.length && !this.rows.length) {
+      return ""
+    }
+
+    const widths = this.columnWidths()
+    const lines = []
+
+    lines.push(separator(widths))
+
+    if (this.headers.length) {
+      lines.push(row(this.headers, widths))
+      lines.push(separator(widths))
+    }
+
+    for (const r of this.rows) {
+      lines.push(row(r, widths))
+    }
+
+    lines.push(separator(widths))
+    return lines.join("\n")
+  }
+}
+
+function createTable() {
+  return new Table()
+}
+
+function createList(items, bullet = "-") {
+  return items.map(i => `${bullet} ${i}`).join("\n")
+}
+
+export {
+  createTable,
+  createList
+}