comment-block-replacer 0.1.18 → 0.1.20

package/CHANGELOG.md

@@ -3,6 +3,25 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [0.1.20](https://github.com/DavidWells/markdown-magic/compare/comment-block-replacer@0.1.19...comment-block-replacer@0.1.20) (2026-06-23)
+
+**Note:** Version bump only for package comment-block-replacer
+
+
+
+
+
+## [0.1.19](https://github.com/DavidWells/markdown-magic/compare/comment-block-replacer@0.1.18...comment-block-replacer@0.1.19) (2026-05-30)
+
+
+### Bug Fixes
+
+* **block-replacer:** update test to reflect preloaded-content behavior ([f1394c4](https://github.com/DavidWells/markdown-magic/commit/f1394c44a174101aac8e5972f0734c3011ca17fa))
+
+
+
+
+
 ## [0.1.18](https://github.com/DavidWells/markdown-magic/compare/comment-block-replacer@0.1.17...comment-block-replacer@0.1.18) (2026-01-19)
 
 **Note:** Version bump only for package comment-block-replacer

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "comment-block-replacer",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "description": "Process files with comment block replacements",
   "main": "src/index.js",
   "types": "types/index.d.ts",
@@ -15,7 +15,7 @@
     "release:major": "pnpm run build && pnpm version major && pnpm publish"
   },
   "dependencies": {
-    "comment-block-transformer": "0.7.0",
+    "comment-block-transformer": "0.8.1",
     "is-valid-path": "^0.1.1"
   },
   "devDependencies": {
@@ -25,5 +25,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "37ed26b98df488f005d9ef91ecd8cd9649c5c067"
+  "gitHead": "2a9f186dc8de21560157805b95c9d2ef28bdb71b"
 }

package/src/index.js

@@ -16,6 +16,7 @@ const { blockTransformer } = require('comment-block-transformer')
  * @typedef {ProcessContentConfig & {
  *   content?: string
  *   srcPath?: string
+ *   parsedBlocks?: import('comment-block-parser').ParseBlocksResult
  *   outputPath?: string
  *   dryRun?: boolean
  *   patterns?: {
@@ -82,11 +83,11 @@ async function processFile(opts = {}) {
   const outputDir = output.directory || opts.outputDir
 
   let srcPath = opts.srcPath
-  if (srcPath && content) {
-    throw new Error(`Can't set both "srcPath" & "content"`)
-  }
   let fileContents
-  if (content) {
+  if (typeof content === 'string' && srcPath) {
+    // Allow callers to provide preloaded content for srcPath files
+    fileContents = content
+  } else if (content) {
     const isFile = isValidFile(content) && content.indexOf('\n') === -1
     srcPath = (isFile) ? content : undefined
     fileContents = (!isFile) ? content : undefined

package/test/index.test.js

@@ -192,20 +192,18 @@ test content
   assert.is(result.isChanged, false)
 })
 
-test('should handle both srcPath and content error', async () => {
+test('should handle both srcPath and content using preloaded content', async () => {
   /** @type {ProcessFileOptions} */
   const options = {
-    srcPath: '/some/path',
-    content: 'some content',
+    srcPath: '/some/nonexistent/path',
+    content: 'preloaded content',
     dryRun: true
   }
 
-  try {
-    await processFile(options)
-    assert.unreachable('Should have thrown an error')
-  } catch (error) {
-    assert.ok(error.message.includes('Can\'t set both "srcPath" & "content"'))
-  }
+  // When both srcPath and content are provided, content is used as preloaded
+  // file contents (caching optimization) — no error should be thrown.
+  const result = await processFile(options)
+  assert.ok(result, 'Should return a result without throwing')
 })
 
 test('should handle file with output directory', async () => {

package/types/index.d.ts

@@ -1,69 +0,0 @@
-export type ProcessContentConfig = import("comment-block-transformer").ProcessContentConfig;
-export type ProcessContentResult = import("comment-block-transformer").ProcessContentResult;
-/**
- * Extended configuration for processing files with additional file-specific options
- */
-export type ProcessFileOptions = ProcessContentConfig & {
-    content?: string;
-    srcPath?: string;
-    outputPath?: string;
-    dryRun?: boolean;
-    patterns?: {
-        openPattern?: RegExp;
-        closePattern?: RegExp;
-    };
-    output?: {
-        directory?: string;
-    };
-    outputDir?: string;
-    applyTransformsToSource?: boolean;
-    open?: string;
-    close?: string;
-};
-/**
- * Result of processing a file with comment block replacements
- */
-export type ProcessFileResult = {
-    /**
-     * - Whether the content was modified
-     */
-    isChanged: boolean;
-    /**
-     * - Whether srcPath differs from outputPath
-     */
-    isNewPath: boolean;
-    /**
-     * - Whether comments should be stripped from output
-     */
-    stripComments: boolean;
-    /**
-     * - Source file path used
-     */
-    srcPath?: string;
-    /**
-     * - Output file path used
-     */
-    outputPath?: string;
-    /**
-     * - Array of transforms that were applied
-     */
-    transforms: any[];
-    /**
-     * - Array of transforms that were not found
-     */
-    missingTransforms: any[];
-    /**
-     * - Original input content
-     */
-    originalContents: string;
-    /**
-     * - Processed output content
-     */
-    updatedContents: string;
-};
-/**
- * Process a file with comment block replacements using configured transforms
- * @param {ProcessFileOptions} [opts={}] - Processing options
- * @returns {Promise<ProcessContentResult>} Result object with processed content and metadata
- */
-export function processFile(opts?: ProcessFileOptions): Promise<ProcessContentResult>;