srcpack 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present Konstantin Tarkus <koistya@kriasoft.com>
+
+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,165 @@
+# Srcpack
+
+Zero-config CLI for bundling code into LLM-optimized context files.
+
+## Quick Start
+
+```bash
+npx srcpack --init       # Create config interactively
+npx srcpack              # Bundle all
+```
+
+## Why
+
+LLM context fails when codebases are large, noisy, or poorly organized. Srcpack lets you split code into semantic bundles (e.g., `web`, `api`, `docs`) with clear file boundaries and an index header—optimized for ChatGPT, Claude, Gemini, etc.
+
+## Configuration
+
+Create `srcpack.config.ts` in your project root:
+
+```typescript
+import { defineConfig } from "srcpack";
+
+export default defineConfig({
+  bundles: {
+    web: "apps/web/**/*",
+    api: ["apps/api/**/*", "!apps/api/**/*.test.ts"],
+    docs: {
+      include: "docs/**/*",
+      index: false, // disable index header
+    },
+  },
+});
+```
+
+Or add to `package.json`:
+
+```json
+{
+  "srcpack": {
+    "bundles": {
+      "web": "apps/web/**/*"
+    }
+  }
+}
+```
+
+### Options
+
+| Option    | Default    | Description                      |
+| --------- | ---------- | -------------------------------- |
+| `outDir`  | `.srcpack` | Output directory for bundles     |
+| `bundles` | —          | Named bundles with glob patterns |
+| `upload`  | —          | Upload destination(s)            |
+
+### Bundle Config
+
+```typescript
+// Simple glob
+"src/**/*"
+
+// Array with exclusions
+["src/**/*", "!src/**/*.test.ts"]
+
+// Full options
+{
+  include: "src/**/*",
+  outfile: "~/Downloads/bundle.txt",   // custom output path
+  index: true                          // include index header (default)
+}
+```
+
+Patterns follow glob syntax. Prefix with `!` to exclude. `.gitignore` patterns are respected automatically.
+
+### Google Drive Upload
+
+To upload bundles to Google Drive, add OAuth credentials to your config:
+
+```typescript
+export default defineConfig({
+  bundles: {
+    /* ... */
+  },
+  upload: {
+    provider: "gdrive",
+    folder: "srcpack/outputs", // target folder path
+    clientId: "...", // OAuth 2.0 client ID
+    clientSecret: "...", // OAuth 2.0 client secret
+  },
+});
+```
+
+**Setup:**
+
+1. Go to [Google Cloud Console](https://console.cloud.google.com/)
+2. Create a project (or select existing)
+3. Enable the Google Drive API
+4. Go to **Credentials** → **Create Credentials** → **OAuth client ID**
+5. Select **Desktop app**, then copy the client ID and secret
+
+Multiple destinations are supported via array:
+
+```typescript
+upload: [
+  {
+    provider: "gdrive",
+    folder: "backup1",
+    clientId: "...",
+    clientSecret: "...",
+  },
+  {
+    provider: "gdrive",
+    folder: "backup2",
+    clientId: "...",
+    clientSecret: "...",
+  },
+];
+```
+
+## Output Format
+
+```text
+# Index (3 files)
+# [1]   src/index.ts  L1-L42 (42 lines)
+# [2]   src/utils.ts  L43-L89 (47 lines)
+# [3]   src/api.ts    L90-L150 (61 lines)
+
+#==> [1] src/index.ts <==
+import { utils } from "./utils";
+...
+
+#==> [2] src/utils.ts <==
+export function utils() {
+...
+```
+
+- Numbered entries for easy cross-reference in conversations
+- Line ranges point to actual content lines
+- `#` prefix keeps format safe inside code blocks
+
+## CLI
+
+```bash
+npx srcpack              # Bundle all, upload if gdrive configured
+npx srcpack web api      # Bundle specific bundles only
+npx srcpack --dry-run    # Preview without writing files
+npx srcpack --init       # Interactive config setup
+```
+
+## API
+
+```typescript
+import { defineConfig, loadConfig } from "srcpack";
+
+// In config files
+export default defineConfig({
+  bundles: { web: "apps/web/**/*" },
+});
+
+// Programmatic
+const config = await loadConfig();
+```
+
+## License
+
+MIT

package/dist/bundle.d.ts

@@ -0,0 +1,37 @@
+import type { BundleConfigInput } from "./config.ts";
+export interface FileEntry {
+    path: string;
+    lines: number;
+    startLine: number;
+    endLine: number;
+}
+export interface BundleResult {
+    content: string;
+    index: FileEntry[];
+}
+/**
+ * Resolve bundle config to a list of file paths.
+ * Respects .gitignore patterns in the working directory.
+ */
+export declare function resolvePatterns(config: BundleConfigInput, cwd: string): Promise<string[]>;
+/**
+ * Format the index header block.
+ * Format designed for LLM context files (ChatGPT, Grok, Gemini):
+ * - Numbered entries for cross-reference with file separators
+ * - ASCII-only characters for broad compatibility
+ * - Line locations that point to actual file content
+ */
+export declare function formatIndex(index: FileEntry[]): string;
+export interface BundleOptions {
+    includeIndex?: boolean;
+}
+/**
+ * Create a bundle from a list of files.
+ * Line numbers in the index point to the first line of actual file content,
+ * not to the separator line.
+ */
+export declare function createBundle(files: string[], cwd: string, options?: BundleOptions): Promise<BundleResult>;
+/**
+ * Bundle a single named bundle from config
+ */
+export declare function bundleOne(name: string, config: BundleConfigInput, cwd: string): Promise<BundleResult>;

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+export {};