splitdown 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [1.0.0] - 2026-01-23
+
+### Added
+-   Initial release.
+-   CLI tool to split markdown files by headings.
+-   Configurable output directory and filename prefix.
+-   Unit tests with Vitest.
+-   Linting and formatting with ESLint and Prettier.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kaf
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,61 @@
+# Splitdown
+
+![CI](https://github.com/iamkaf/splitdown/actions/workflows/ci.yml/badge.svg)
+![License](https://img.shields.io/badge/license-MIT-blue.svg)
+![NPM Version](https://img.shields.io/npm/v/splitdown.svg)
+
+Split large Markdown files into manageable chunks based on headings. Useful for feeding docs into AI assistants with context window limits.
+
+## Features
+
+- Split by heading level (h1-h6)
+- Auto-numbered files to preserve order
+- Sanitized, human-readable filenames
+- Configurable output directory and filename prefixes
+
+## Installation
+
+```bash
+npm install
+npm run build
+```
+
+## Usage
+
+```bash
+npx splitdown <input-file> [options]
+```
+
+### Examples
+
+**Split by H2 headings (default):**
+
+```bash
+npx splitdown README.md
+```
+
+**Split by H1 headings to a specific directory:**
+
+```bash
+npx splitdown docs.md --level 1 --output ./chapters
+```
+
+## Options
+
+| Option     | Alias | Default          | Description                     |
+| ---------- | ----- | ---------------- | ------------------------------- |
+| `--output` | `-o`  | `./split-output` | Output directory                |
+| `--level`  | `-l`  | `2`              | Heading level to split on (1-6) |
+| `--prefix` | `-p`  | `section-`       | Filename prefix                 |
+
+## Development
+
+```bash
+npm install
+npm run dev   # watch mode
+npm run build # production build
+```
+
+## License
+
+MIT

package/dist/index.js

@@ -0,0 +1,109 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/index.ts
+var import_commander = require("commander");
+var fs2 = __toESM(require("fs"));
+
+// src/lib.ts
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+function parseMarkdownSections(content, level = 2) {
+  const lines = content.split("\n");
+  const sections = [];
+  let currentSection = null;
+  lines.forEach((line, index) => {
+    const headingMatch = line.match(/^(#{1,6})\s+(.+)$/);
+    if (headingMatch) {
+      const headingLevel = headingMatch[1].length;
+      const headingTitle = headingMatch[2];
+      if (headingLevel <= level) {
+        if (currentSection) {
+          sections.push(currentSection);
+        }
+        currentSection = {
+          title: headingTitle,
+          level: headingLevel,
+          content: line + "\n",
+          lineStart: index + 1
+        };
+      } else if (currentSection) {
+        currentSection.content += line + "\n";
+      }
+    } else if (currentSection) {
+      currentSection.content += line + "\n";
+    }
+  });
+  if (currentSection) {
+    sections.push(currentSection);
+  }
+  return sections;
+}
+function sanitizeFilename(title) {
+  return title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").substring(0, 50);
+}
+function splitMarkdown(inputFile, outputDir, level, prefix) {
+  const content = fs.readFileSync(inputFile, "utf-8");
+  const sections = parseMarkdownSections(content, level);
+  console.log(
+    `Found ${sections.length} sections at heading level ${level} or above
+`
+  );
+  if (!fs.existsSync(outputDir)) {
+    fs.mkdirSync(outputDir, { recursive: true });
+  }
+  sections.forEach((section, index) => {
+    const filename = `${prefix}${String(index + 1).padStart(2, "0")}-${sanitizeFilename(section.title)}.md`;
+    const filepath = path.join(outputDir, filename);
+    fs.writeFileSync(filepath, section.content.trimEnd());
+    console.log(`\u2713 ${filename} (${section.content.split("\n").length} lines)`);
+  });
+  console.log(`
+Split complete. Files saved to: ${outputDir}`);
+}
+
+// src/index.ts
+var program = new import_commander.Command();
+program.name("splitdown").description(
+  "Split markdown files by headings for easier sharing with AI assistants"
+).version("1.0.0");
+program.argument("<input>", "input markdown file").option("-o, --output <dir>", "output directory", "./split-output").option("-l, --level <number>", "heading level to split on (1-6)", "2").option("-p, --prefix <string>", "prefix for output filenames", "section-").action((input, options) => {
+  try {
+    const level = parseInt(options.level, 10);
+    if (level < 1 || level > 6) {
+      console.error("Error: Heading level must be between 1 and 6");
+      process.exit(1);
+    }
+    if (!fs2.existsSync(input)) {
+      console.error(`Error: File not found: ${input}`);
+      process.exit(1);
+    }
+    splitMarkdown(input, options.output, level, options.prefix);
+  } catch (error) {
+    console.error("Error:", error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+});
+program.parse();

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "splitdown",
+  "version": "1.0.0",
+  "description": "Split markdown files by headings for easier sharing with AI assistants",
+  "bin": {
+    "splitdown": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs --clean",
+    "dev": "tsup src/index.ts --format cjs --watch",
+    "test": "vitest run",
+    "lint": "eslint . --ext .ts",
+    "format": "prettier --write .",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "markdown",
+    "cli",
+    "split",
+    "ai",
+    "headings"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/iamkaf/splitdown.git"
+  },
+  "bugs": {
+    "url": "https://github.com/iamkaf/splitdown/issues"
+  },
+  "homepage": "https://github.com/iamkaf/splitdown#readme",
+  "author": "Kaf",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^11.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@typescript-eslint/eslint-plugin": "^8.53.1",
+    "@typescript-eslint/parser": "^8.53.1",
+    "eslint": "^8.57.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.5",
+    "prettier": "^3.8.1",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3",
+    "vitest": "^4.0.18"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ]
+}