fix: comment generation

Author: chrisbbreuer

packages/dtsx/src/processor.ts

@@ -1394,10 +1394,34 @@ function parseObjectProperties(content: string): Array<[string, string]> {
   let inString = false
   let stringChar = ''
   let inKey = true
+  let inComment = false
+  let commentDepth = 0
 
   for (let i = 0; i < content.length; i++) {
     const char = content[i]
     const prevChar = i > 0 ? content[i - 1] : ''
+    const nextChar = i < content.length - 1 ? content[i + 1] : ''
+
+    // Track JSDoc/block comments to avoid parsing colons inside them
+    if (!inString && !inComment && char === '/' && nextChar === '*') {
+      inComment = true
+      commentDepth = 1
+      current += char
+      continue
+    }
+    else if (inComment && char === '*' && nextChar === '/') {
+      commentDepth--
+      if (commentDepth === 0) {
+        inComment = false
+      }
+      current += char
+      continue
+    }
+    else if (inComment && char === '/' && nextChar === '*') {
+      commentDepth++
+      current += char
+      continue
+    }
 
     if (!inString && (char === '"' || char === '\'' || char === '`')) {
       inString = true
@@ -1408,7 +1432,7 @@ function parseObjectProperties(content: string): Array<[string, string]> {
       inString = false
       current += char
     }
-    else if (!inString) {
+    else if (!inString && !inComment) {
       if (char === '{' || char === '[' || char === '(') {
         depth++
         current += char

packages/dtsx/test/dts.test.ts

@@ -27,6 +27,7 @@ describe('dts-generation', () => {
 
   // List of all fixture files to test (excluding checker.ts which is too large)
   const fixtures = [
+    'abseil.io',
     'class',
     'edge-cases',
     'enum',

packages/dtsx/test/fixtures/input/abseil.io.ts

@@ -0,0 +1,74 @@
+/**
+ * **abseil.io** - Abseil Common Libraries (C++)
+ *
+ * @domain `abseil.io`
+ * @version `20250512.0.0` (17 versions available)
+ * @versions From newest version to oldest. @see https://ts-pkgx.netlify.app/packages/abseil-io.md
+ *
+ * @install `sh <(curl https://pkgx.sh) +abseil.io -- $SHELL -i`
+ *
+ * @example
+ * ```typescript
+ * import { pantry } from 'ts-pkgx'
+ *
+ * const pkg = pantry.abseilio
+ * console.log(pkg.name)        // "abseil.io"
+ * console.log(pkg.description) // "Abseil Common Libraries (C++)"
+ * console.log(pkg.versions[0]) // "20250512.0.0" (latest)
+ * ```
+ *
+ * @see https://ts-pkgx.netlify.app/packages/abseil-io.md
+ * @see https://ts-pkgx.netlify.app/usage
+ */
+export const abseilioPackage = {
+  /**
+   * The display name of this package.
+   */
+  name: 'abseil.io' as const,
+  /**
+   * The canonical domain name for this package.
+   */
+  domain: 'abseil.io' as const,
+  /**
+   * Brief description of what this package does.
+   */
+  description: 'Abseil Common Libraries (C++)' as const,
+  packageYmlUrl: 'https://github.com/pkgxdev/pantry/tree/main/projects/abseil.io/package.yml' as const,
+  homepageUrl: '' as const,
+  githubUrl: 'https://github.com/pkgxdev/pantry/' as const,
+  /**
+   * Command to install this package using pkgx.
+   * @example sh <(curl https://pkgx.sh) +package-name
+   */
+  installCommand: 'sh <(curl https://pkgx.sh) +abseil.io -- $SHELL -i' as const,
+  programs: [] as const,
+  companions: [] as const,
+  dependencies: [] as const,
+  /**
+   * Available versions from newest to oldest.
+   * @see https://ts-pkgx.netlify.app/usage for installation instructions
+   */
+  versions: [
+    '20250512.0.0',
+    '20250127.1.0',
+    '20250127.0.0',
+    '20240722.1.0',
+    '20240722.0.0',
+    '20240116.3.0',
+    '20240116.2.0',
+    '20240116.1.0',
+    '20240116.0.0',
+    '20230802.3.0',
+    '20230802.2.0',
+    '20230802.1.0',
+    '20230802.0.0',
+    '20230125.4.0',
+    '20230125.3.0',
+    '20230125.2.0',
+    '20220623.2.0',
+  ] as const,
+  aliases: [] as const,
+  fullPath: 'abseil.io' as const,
+}
+
+export type AbseilioPackage = typeof abseilioPackage

packages/dtsx/test/fixtures/output/abseil.io.d.ts

@@ -0,0 +1,55 @@
+/**
+ * **abseil.io** - Abseil Common Libraries (C++)
+ *
+ * @domain `abseil.io`
+ * @version `20250512.0.0` (17 versions available)
+ * @versions From newest version to oldest. @see https://ts-pkgx.netlify.app/packages/abseil-io.md
+ *
+ * @install `sh <(curl https://pkgx.sh) +abseil.io -- $SHELL -i`
+ *
+ * @example
+ * ```typescript
+ * import { pantry } from 'ts-pkgx'
+ *
+ * const pkg = pantry.abseilio
+ * console.log(pkg.name)        // "abseil.io"
+ * console.log(pkg.description) // "Abseil Common Libraries (C++)"
+ * console.log(pkg.versions[0]) // "20250512.0.0" (latest)
+ * ```
+ *
+ * @see https://ts-pkgx.netlify.app/packages/abseil-io.md
+ * @see https://ts-pkgx.netlify.app/usage
+ */
+export declare const abseilioPackage: {
+  /**
+   * The display name of this package.
+   */
+  name: 'abseil.io';
+  /**
+   * The canonical domain name for this package.
+   */
+  domain: 'abseil.io';
+  /**
+   * Brief description of what this package does.
+   */
+  description: 'Abseil Common Libraries (C++)';
+  packageYmlUrl: 'https://github.com/pkgxdev/pantry/tree/main/projects/abseil.io/package.yml';
+  homepageUrl: '';
+  githubUrl: 'https://github.com/pkgxdev/pantry/';
+  /**
+   * Command to install this package using pkgx.
+   * @example sh <(curl https://pkgx.sh) +package-name
+   */
+  installCommand: 'sh <(curl https://pkgx.sh) +abseil.io -- $SHELL -i';
+  programs: readonly [];
+  companions: readonly [];
+  dependencies: readonly [];
+  /**
+   * Available versions from newest to oldest.
+   * @see https://ts-pkgx.netlify.app/usage for installation instructions
+   */
+  versions: readonly ['20250512.0.0', '20250127.1.0', '20250127.0.0', '20240722.1.0', '20240722.0.0', '20240116.3.0', '20240116.2.0', '20240116.1.0', '20240116.0.0', '20230802.3.0', '20230802.2.0', '20230802.1.0', '20230802.0.0', '20230125.4.0', '20230125.3.0', '20230125.2.0', '20220623.2.0'];
+  aliases: readonly [];
+  fullPath: 'abseil.io'
+};
+export type AbseilioPackage = typeof abseilioPackage