codesummary 1.0.0 → 1.0.2

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.
Files changed (2) hide show
  1. package/README.md +92 -46
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -31,11 +31,13 @@ npm install -g codesummary
31
31
  ## 🎯 Quick Start
32
32
 
33
33
  1. **First-time setup** (interactive wizard):
34
+
34
35
  ```bash
35
36
  codesummary
36
37
  ```
37
38
 
38
39
  2. **Generate PDF for current project**:
40
+
39
41
  ```bash
40
42
  cd /path/to/your/project
41
43
  codesummary
@@ -140,39 +142,76 @@ CodeSummary stores global configuration in:
140
142
 
141
143
  ```json
142
144
  {
143
- \"output\": {
144
- \"mode\": \"fixed\",
145
- \"fixedPath\": \"~/Desktop/CodeSummaries\"
145
+ "output": {
146
+ "mode": "fixed",
147
+ "fixedPath": "~/Desktop/CodeSummaries"
146
148
  },
147
- \"allowedExtensions\": [
148
- \".json\", \".ts\", \".js\", \".jsx\", \".tsx\", \".xml\", \".html\",
149
- \".css\", \".scss\", \".md\", \".txt\", \".py\", \".java\", \".cs\",
150
- \".cpp\", \".c\", \".h\", \".yaml\", \".yml\", \".sh\", \".bat\",
151
- \".ps1\", \".php\", \".rb\", \".go\", \".rs\", \".swift\", \".kt\",
152
- \".scala\", \".vue\", \".svelte\", \".dockerfile\", \".sql\", \".graphql\"
149
+ "allowedExtensions": [
150
+ ".json",
151
+ ".ts",
152
+ ".js",
153
+ ".jsx",
154
+ ".tsx",
155
+ ".xml",
156
+ ".html",
157
+ ".css",
158
+ ".scss",
159
+ ".md",
160
+ ".txt",
161
+ ".py",
162
+ ".java",
163
+ ".cs",
164
+ ".cpp",
165
+ ".c",
166
+ ".h",
167
+ ".yaml",
168
+ ".yml",
169
+ ".sh",
170
+ ".bat",
171
+ ".ps1",
172
+ ".php",
173
+ ".rb",
174
+ ".go",
175
+ ".rs",
176
+ ".swift",
177
+ ".kt",
178
+ ".scala",
179
+ ".vue",
180
+ ".svelte",
181
+ ".dockerfile",
182
+ ".sql",
183
+ ".graphql"
153
184
  ],
154
- \"excludeDirs\": [
155
- \"node_modules\", \".git\", \".vscode\", \"dist\", \"build\",
156
- \"coverage\", \"out\", \"__pycache__\", \".next\", \".nuxt\"
185
+ "excludeDirs": [
186
+ "node_modules",
187
+ ".git",
188
+ ".vscode",
189
+ "dist",
190
+ "build",
191
+ "coverage",
192
+ "out",
193
+ "__pycache__",
194
+ ".next",
195
+ ".nuxt"
157
196
  ],
158
- \"styles\": {
159
- \"colors\": {
160
- \"title\": \"#333353\",
161
- \"section\": \"#00FFB9\",
162
- \"text\": \"#333333\",
163
- \"error\": \"#FF4D4D\",
164
- \"footer\": \"#666666\"
197
+ "styles": {
198
+ "colors": {
199
+ "title": "#333353",
200
+ "section": "#00FFB9",
201
+ "text": "#333333",
202
+ "error": "#FF4D4D",
203
+ "footer": "#666666"
165
204
  },
166
- \"layout\": {
167
- \"marginLeft\": 40,
168
- \"marginTop\": 40,
169
- \"marginRight\": 40,
170
- \"footerHeight\": 20
205
+ "layout": {
206
+ "marginLeft": 40,
207
+ "marginTop": 40,
208
+ "marginRight": 40,
209
+ "footerHeight": 20
171
210
  }
172
211
  },
173
- \"settings\": {
174
- \"documentTitle\": \"Project Code Summary\",
175
- \"maxFilesBeforePrompt\": 500
212
+ "settings": {
213
+ "documentTitle": "Project Code Summary",
214
+ "maxFilesBeforePrompt": 500
176
215
  }
177
216
  }
178
217
  ```
@@ -182,16 +221,19 @@ CodeSummary stores global configuration in:
182
221
  Generated PDFs use **A4 format** with optimized margins and contain three main sections:
183
222
 
184
223
  ### 1. Project Overview
224
+
185
225
  - Document title and project name
186
226
  - Generation timestamp
187
227
  - List of included file types with descriptions
188
228
 
189
229
  ### 2. File Structure
230
+
190
231
  - Complete hierarchical listing of all included files
191
232
  - Organized by relative paths from project root
192
233
  - Sorted alphabetically for easy navigation
193
234
 
194
235
  ### 3. File Content
236
+
195
237
  - **Complete source code** for each file (no truncation)
196
238
  - Proper formatting with monospace fonts for code
197
239
  - Intelligent text wrapping without overlap
@@ -229,24 +271,24 @@ MYPROJECT_code_20250729_141602.pdf
229
271
 
230
272
  CodeSummary supports an extensive range of text-based file formats:
231
273
 
232
- | Extension | Language/Type | Extension | Language/Type |
233
- | --------- | -------------- | ------------ | ----------------- |
234
- | `.js` | JavaScript | `.py` | Python |
235
- | `.ts` | TypeScript | `.java` | Java |
236
- | `.jsx` | React JSX | `.cs` | C# |
237
- | `.tsx` | TypeScript JSX | `.cpp` | C++ |
238
- | `.json` | JSON | `.c` | C |
239
- | `.xml` | XML | `.h` | Header |
240
- | `.html` | HTML | `.yaml/.yml` | YAML |
241
- | `.css` | CSS | `.sh` | Shell Script |
242
- | `.scss` | SCSS | `.bat` | Batch File |
243
- | `.md` | Markdown | `.ps1` | PowerShell |
244
- | `.txt` | Plain Text | `.php` | PHP |
245
- | `.go` | Go | `.rb` | Ruby |
246
- | `.rs` | Rust | `.swift` | Swift |
247
- | `.kt` | Kotlin | `.scala` | Scala |
248
- | `.vue` | Vue.js | `.svelte` | Svelte |
249
- | `.sql` | SQL | `.graphql` | GraphQL |
274
+ | Extension | Language/Type | Extension | Language/Type |
275
+ | --------- | -------------- | ------------ | ------------- |
276
+ | `.js` | JavaScript | `.py` | Python |
277
+ | `.ts` | TypeScript | `.java` | Java |
278
+ | `.jsx` | React JSX | `.cs` | C# |
279
+ | `.tsx` | TypeScript JSX | `.cpp` | C++ |
280
+ | `.json` | JSON | `.c` | C |
281
+ | `.xml` | XML | `.h` | Header |
282
+ | `.html` | HTML | `.yaml/.yml` | YAML |
283
+ | `.css` | CSS | `.sh` | Shell Script |
284
+ | `.scss` | SCSS | `.bat` | Batch File |
285
+ | `.md` | Markdown | `.ps1` | PowerShell |
286
+ | `.txt` | Plain Text | `.php` | PHP |
287
+ | `.go` | Go | `.rb` | Ruby |
288
+ | `.rs` | Rust | `.swift` | Swift |
289
+ | `.kt` | Kotlin | `.scala` | Scala |
290
+ | `.vue` | Vue.js | `.svelte` | Svelte |
291
+ | `.sql` | SQL | `.graphql` | GraphQL |
250
292
 
251
293
  ## 🛠️ Development
252
294
 
@@ -289,20 +331,24 @@ node bin/codesummary.js
289
331
  ### Common Issues
290
332
 
291
333
  **Configuration not found**
334
+
292
335
  - Run `codesummary` to trigger first-time setup
293
336
  - Check file permissions in config directory
294
337
 
295
338
  **PDF generation fails**
339
+
296
340
  - Verify output directory permissions
297
341
  - Ensure Node.js version ≥18.0.0
298
342
  - Close any open PDF viewers on the target file
299
343
 
300
344
  **Files not showing up**
345
+
301
346
  - Check that file extensions are in `allowedExtensions`
302
347
  - Verify directories aren't in `excludeDirs` list
303
348
  - Ensure files are text-based (not binary)
304
349
 
305
350
  **Large project performance**
351
+
306
352
  - Adjust `maxFilesBeforePrompt` in configuration
307
353
  - Use extension filtering to reduce file count
308
354
  - CodeSummary handles large files efficiently with streaming
@@ -367,4 +413,4 @@ This project is licensed under the GNU General Public License v3.0 - see the [LI
367
413
 
368
414
  ---
369
415
 
370
- **Made with ❤️ for developers worldwide**
416
+ **Made with ❤️ for developers worldwide**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "codesummary",
3
- "version": "1.0.0",
3
+ "version": "1.0.2",
4
4
  "description": "Cross-platform CLI tool that automatically generates comprehensive PDF documentation from project source code with complete content processing and smart conflict handling",
5
5
  "main": "src/index.js",
6
6
  "type": "module",
@@ -81,4 +81,4 @@
81
81
  "publishConfig": {
82
82
  "access": "public"
83
83
  }
84
- }
84
+ }