opencode-trim 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hüseyin Hadi Çığ
+
+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

@@ -1,3 +1,35 @@
-# Temporary Holding Version
+# opencode-trim
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Lightweight, zero-dependency context and text trimming utilities for OpenCode plugins, multi-agent workflows, and AI prompts.
+
+## Features
+
+- **Whitespace Normalization:** Cleans up unnecessary spaces and collapses redundant line breaks.
+- **Character & Ellipsis Trimming:** Truncates prompt or response text safely to stay within character limits.
+- **Line Trimming:** Truncates log or stack trace outputs to a fixed number of lines.
+- **Zero Dependencies:** Pure ESM with TypeScript type declarations included.
+
+## Installation
+
+```bash
+npm install opencode-trim
+```
+
+## Quick Start
+
+```javascript
+import { trimWhitespace, trimChars, trimLines } from "opencode-trim";
+
+// Normalize whitespace and blank lines
+const cleanText = trimWhitespace("  Hello    World \n\n\n\n Foo  ");
+
+// Trim characters with ellipsis
+const truncated = trimChars("Long context string...", 10);
+
+// Trim lines
+const firstFiveLines = trimLines(multiLineLogs, 5);
+```
+
+## License
+
+MIT © [Hüseyin Hadi Çığ](https://github.com/huseyincig)

package/index.d.ts

@@ -0,0 +1,11 @@
+export declare function trimWhitespace(text: string): string;
+export declare function trimChars(text: string, maxLength: number, ellipsis?: string): string;
+export declare function trimLines(text: string, maxLines: number): string;
+
+declare const _default: {
+  trimWhitespace: typeof trimWhitespace;
+  trimChars: typeof trimChars;
+  trimLines: typeof trimLines;
+};
+
+export default _default;

package/index.js

@@ -0,0 +1,48 @@
+/**
+ * Trims leading and trailing whitespace per line, collapses multiple spaces and excessive empty lines.
+ * @param {string} text
+ * @returns {string}
+ */
+export function trimWhitespace(text) {
+  if (typeof text !== "string") return "";
+  return text
+    .split(/\r?\n/)
+    .map((line) => line.trim().replace(/[ \t]+/g, " "))
+    .join("\n")
+    .replace(/\n{3,}/g, "\n\n")
+    .trim();
+}
+
+/**
+ * Trims a text string to a maximum character length with an optional ellipsis.
+ * @param {string} text
+ * @param {number} maxLength
+ * @param {string} [ellipsis="..."]
+ * @returns {string}
+ */
+export function trimChars(text, maxLength, ellipsis = "...") {
+  if (typeof text !== "string") return "";
+  if (maxLength <= 0) return "";
+  if (text.length <= maxLength) return text;
+  return text.slice(0, Math.max(0, maxLength - ellipsis.length)) + ellipsis;
+}
+
+/**
+ * Trims excess lines from text to fit within maxLines.
+ * @param {string} text
+ * @param {number} maxLines
+ * @returns {string}
+ */
+export function trimLines(text, maxLines) {
+  if (typeof text !== "string") return "";
+  if (maxLines <= 0) return "";
+  const lines = text.split(/\r?\n/);
+  if (lines.length <= maxLines) return text;
+  return lines.slice(0, maxLines).join("\n");
+}
+
+export default {
+  trimWhitespace,
+  trimChars,
+  trimLines,
+};

package/package.json

@@ -1,6 +1,32 @@
 {
   "name": "opencode-trim",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Context and text trimming utilities for OpenCode plugins and workflows",
+  "type": "module",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js"
+    }
+  },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node --test"
+  },
+  "keywords": [
+    "opencode",
+    "trim",
+    "prompt-trimming",
+    "context-window",
+    "ai"
+  ],
+  "author": "Hüseyin Hadi Çığ",
+  "license": "MIT"
+}