chore: wip

chore: wip

chore: wip

chore: wip

chore: wip

chore: wip

chore: wip

chore: wip

chore: wip

Author: chrisbbreuer

.github/workflows/ci.yml

@@ -85,6 +85,7 @@ jobs:
 
   publish-commit:
     runs-on: ubuntu-latest
+
     steps:
       - uses: actions/checkout@v4
 
@@ -106,4 +107,4 @@ jobs:
         run: bun run build
 
       - name: Publish Commit
-        run: bunx pkg-pr-new publish
+        run: bunx pkg-pr-new publish './packages/dtsx' './packages/bun-plugin' './packages/vite-plugin'

.github/workflows/release.yml

@@ -1,24 +1,30 @@
-name: CI
+name: Releaser
 
 on:
   push:
     tags:
       - 'v*'
 
+permissions:
+  contents: write
+  packages: write
+  id-token: write
+
 jobs:
-  release:
-    name: release
+  npm:
     runs-on: ubuntu-latest
-
+    outputs:
+      version: ${{ env.VERSION }}
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout Code
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
-      - name: Install Bun
+      - name: Setup Bun
         uses: oven-sh/setup-bun@v2
 
-      - name: Use cached node_modules
+      - name: Use Cached node_modules
         uses: actions/cache@v4
         with:
           path: node_modules
@@ -29,24 +35,33 @@ jobs:
       - name: Install Dependencies
         run: bun install
 
+      - name: Extract tag version
+        id: get_version
+        run: echo "VERSION=${GITHUB_REF#refs/tags/}" >> $GITHUB_ENV
+
       - name: Publish to npm
         run: bun publish --access public
         env:
           BUN_AUTH_TOKEN: ${{secrets.NPM_TOKEN}}
 
-      - name: Create GitHub release
-        run: bunx changelogithub
-        env:
-          GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}
-
-      - name: Attach Binaries
+      - name: Create GitHub Release
+        id: create_release
         uses: stacksjs/[email protected]
         with:
           files: |
-            bin/dtsx-linux-x64.zip
-            bin/dtsx-linux-arm64.zip
-            bin/dtsx-windows-x64.zip
-            bin/dtsx-darwin-x64.zip
-            bin/dtsx-darwin-arm64.zip
+            ./packages/dtsx/bin/dtsx-linux-x64.zip
+            ./packages/dtsx/bin/dtsx-linux-arm64.zip
+            ./packages/dtsx/bin/dtsx-windows-x64.zip
+            ./packages/dtsx/bin/dtsx-darwin-x64.zip
+            ./packages/dtsx/bin/dtsx-darwin-arm64.zip
+          # --- Homebrew tap update support ---
+          # Path to your Homebrew formula template (update this path as needed)
+          # homebrewFormula: .github/homebrew-formula.rb
+          # The owner/repo of your Homebrew tap (update this value as needed)
+          # homebrewRepo: stacksjs/homebrew-tap
+          # Optionally uncomment and set these if you need custom values:
+          # homebrewBranch: main
+          # homebrewPath: Formula
+          # homebrewCommitFormat: "update: {{ formula }} to {{ version }}"
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -13,7 +13,7 @@ temp
 docs/.vitepress/cache
 storage
 fixtures/generated
-bin/dtsx*
+**/bin/dtsx*
 /test/temp-output
 test/debug
 /test/fixtures/generated

bun.lock

@@ -11,10 +11,39 @@
         "@stacksjs/gitlint": "^0.1.5",
         "@types/bun": "^1.2.14",
         "bun-git-hooks": "^0.2.16",
-        "bun-plugin-dtsx": "^0.21.12",
+        "bun-plugin-dtsx": "workspace:*",
+        "unocss": "^66.1.2",
+      },
+    },
+    "packages/bun-plugin": {
+      "name": "bun-plugin-dtsx",
+      "version": "0.8.3",
+      "bin": {
+        "dtsx": "./dist/bin/cli.js",
+      },
+      "devDependencies": {
+        "@stacksjs/dtsx": "workspace:*",
+      },
+    },
+    "packages/dtsx": {
+      "name": "@stacksjs/dtsx",
+      "version": "0.8.3",
+      "bin": {
+        "dtsx": "./dist/bin/cli.js",
+      },
+      "devDependencies": {
         "bunfig": "^0.10.0",
         "tinyglobby": "^0.2.13",
-        "unocss": "^66.1.2",
+      },
+    },
+    "packages/vite-plugin": {
+      "name": "vite-plugin-dtsx",
+      "version": "0.8.3",
+      "bin": {
+        "dtsx": "./dist/bin/cli.js",
+      },
+      "devDependencies": {
+        "@stacksjs/dtsx": "workspace:*",
       },
     },
   },
@@ -494,7 +523,7 @@
 
     "@stacksjs/docs": ["@stacksjs/[email protected]", "", { "dependencies": { "@iconify-json/carbon": "^1.2.8", "@shikijs/vitepress-twoslash": "^3.2.1", "@vite-pwa/assets-generator": "^1.0.0", "@vite-pwa/vitepress": "^1.0.0", "unocss": "^66.0.0", "unplugin-icons": "^22.1.0", "unplugin-vue-components": "^28.4.1", "vite-plugin-pwa": "^1.0.0", "vitepress": "1.6.3" } }, "sha512-kRk/aza/wQAAgF0fhUhG8bUHhqk3RnjBkZyoRW0fvYs3dLaAArJYX/uVquZixlQnqgizGeGZT986tEFjs5Ly+A=="],
 
-    "@stacksjs/dtsx": ["@stacksjs/dtsx@0.8.3", "", { "bin": { "dtsx": "dist/cli.js" } }, "sha512-+u/PEp478qHM8s7xT0AOZowd93mZ/5ptHFyiz0B/gcxmdrdNdM6bLIK5si5Uzy1cR5TOVN4oAB3+WMKDnJ3n1w=="],
+    "@stacksjs/dtsx": ["@stacksjs/dtsx@workspace:packages/dtsx"],
 
     "@stacksjs/error-handling": ["@stacksjs/[email protected]", "", {}, "sha512-rQcgyum8eZnVjaF+eb6ip/IHK4GuOidwy1GcbAOqXeDwbc7oUxWFlpT7pKMeYbYa+DWZjV1WdolLxSL/orQeCw=="],
 
@@ -766,7 +795,7 @@
 
     "bun-git-hooks": ["[email protected]", "", { "bin": { "git-hooks": "dist/bin/cli.js", "bun-git-hooks": "dist/bin/cli.js" } }, "sha512-xMqVjRKnhgFJIRfGPHzhGGWMOekqWvo36VlP7v+aUMGg4Qjgk2YsdVIItpx94P5/IwKyWvwAdngXJDmhcxTz/Q=="],
 
-    "bun-plugin-dtsx": ["bun-plugin-dtsx@0.21.12", "", { "dependencies": { "@stacksjs/dtsx": "^0.8.1" } }, "sha512-VqGDRoTKEnkD508k9jRlcwFoEEJXtjqLMGN+brRP4/3vH0wfLZkZiWG5jc490roZOmphrQlo5NgfFB/j71+Qtg=="],
+    "bun-plugin-dtsx": ["bun-plugin-dtsx@workspace:packages/bun-plugin"],
 
     "bun-types": ["[email protected]", "", { "dependencies": { "@types/node": "*" } }, "sha512-Kuh4Ub28ucMRWeiUUWMHsT9Wcbr4H3kLIO72RZZElSDxSu7vpetRvxIUDUaW6QtaIeixIpm7OXtNnZPf82EzwA=="],
 
@@ -1686,6 +1715,8 @@
 
     "vite": ["[email protected]", "", { "dependencies": { "esbuild": "^0.21.3", "postcss": "^8.4.43", "rollup": "^4.20.0" }, "optionalDependencies": { "fsevents": "~2.3.3" }, "peerDependencies": { "@types/node": "^18.0.0 || >=20.0.0", "less": "*", "lightningcss": "^1.21.0", "sass": "*", "sass-embedded": "*", "stylus": "*", "sugarss": "*", "terser": "^5.4.0" }, "optionalPeers": ["@types/node", "less", "lightningcss", "sass", "sass-embedded", "stylus", "sugarss", "terser"], "bin": { "vite": "bin/vite.js" } }, "sha512-qO3aKv3HoQC8QKiNSTuUM1l9o/XX3+c+VTgLHbJWHZGeTPVAg2XwazI9UWzoxjIJCGCV2zU60uqMzjeLZuULqA=="],
 
+    "vite-plugin-dtsx": ["vite-plugin-dtsx@workspace:packages/vite-plugin"],
+
     "vite-plugin-pwa": ["[email protected]", "", { "dependencies": { "debug": "^4.3.6", "pretty-bytes": "^6.1.1", "tinyglobby": "^0.2.10", "workbox-build": "^7.3.0", "workbox-window": "^7.3.0" }, "peerDependencies": { "@vite-pwa/assets-generator": "^1.0.0", "vite": "^3.1.0 || ^4.0.0 || ^5.0.0 || ^6.0.0" }, "optionalPeers": ["@vite-pwa/assets-generator"] }, "sha512-X77jo0AOd5OcxmWj3WnVti8n7Kw2tBgV1c8MCXFclrSlDV23ePzv2eTDIALXI2Qo6nJ5pZJeZAuX0AawvRfoeA=="],
 
     "vitepress": ["[email protected]", "", { "dependencies": { "@docsearch/css": "3.8.2", "@docsearch/js": "3.8.2", "@iconify-json/simple-icons": "^1.2.21", "@shikijs/core": "^2.1.0", "@shikijs/transformers": "^2.1.0", "@shikijs/types": "^2.1.0", "@types/markdown-it": "^14.1.2", "@vitejs/plugin-vue": "^5.2.1", "@vue/devtools-api": "^7.7.0", "@vue/shared": "^3.5.13", "@vueuse/core": "^12.4.0", "@vueuse/integrations": "^12.4.0", "focus-trap": "^7.6.4", "mark.js": "8.11.1", "minisearch": "^7.1.1", "shiki": "^2.1.0", "vite": "^5.4.14", "vue": "^3.5.13" }, "peerDependencies": { "markdown-it-mathjax3": "^4", "postcss": "^8" }, "optionalPeers": ["markdown-it-mathjax3", "postcss"], "bin": { "vitepress": "bin/vitepress.js" } }, "sha512-fCkfdOk8yRZT8GD9BFqusW3+GggWYZ/rYncOfmgcDtP3ualNHCAg+Robxp2/6xfH1WwPHtGpPwv7mbA3qomtBw=="],
@@ -1826,6 +1857,8 @@
 
     "@shikijs/twoslash/@shikijs/types": ["@shikijs/[email protected]", "", { "dependencies": { "@shikijs/vscode-textmate": "^10.0.2", "@types/hast": "^3.0.4" } }, "sha512-zHC1l7L+eQlDXLnxvM9R91Efh2V4+rN3oMVS2swCBssbj2U/FBwybD1eeLaq8yl/iwT+zih8iUbTBCgGZOYlVg=="],
 
+    "@stacksjs/development/bun-plugin-dtsx": ["[email protected]", "", { "dependencies": { "@stacksjs/dtsx": "^0.8.1" } }, "sha512-VqGDRoTKEnkD508k9jRlcwFoEEJXtjqLMGN+brRP4/3vH0wfLZkZiWG5jc490roZOmphrQlo5NgfFB/j71+Qtg=="],
+
     "@stacksjs/eslint-config/@stacksjs/logging": ["@stacksjs/[email protected]", "", {}, "sha512-rm/XGj7z+one5mQqwrgxRq/ulusyz2eWVe3QUP3/V9kKkDtEhI9tnmx4PLvVQZbxJgsVzcZeuyJ12OfxfpKFdg=="],
 
     "@stacksjs/eslint-plugin/@stacksjs/eslint-config": ["@stacksjs/[email protected]", "", { "dependencies": { "@antfu/install-pkg": "^1.0.0", "@clack/prompts": "^0.10.0", "@eslint-community/eslint-plugin-eslint-comments": "^4.4.1", "@eslint/markdown": "^6.3.0", "@stacksjs/eslint-plugin": "^0.2.4", "@stylistic/eslint-plugin": "^4.2.0", "@typescript-eslint/eslint-plugin": "^8.27.0", "@typescript-eslint/parser": "^8.27.0", "@vitest/eslint-plugin": "^1.1.38", "eslint-config-flat-gitignore": "^2.1.0", "eslint-flat-config-utils": "^2.0.1", "eslint-merge-processors": "^2.0.0", "eslint-plugin-antfu": "^3.1.1", "eslint-plugin-command": "^3.2.0", "eslint-plugin-import-x": "^4.9.1", "eslint-plugin-jsdoc": "^50.6.8", "eslint-plugin-jsonc": "^2.19.1", "eslint-plugin-n": "^17.16.2", "eslint-plugin-no-only-tests": "^3.3.0", "eslint-plugin-perfectionist": "^4.10.1", "eslint-plugin-pnpm": "^0.3.1", "eslint-plugin-regexp": "^2.7.0", "eslint-plugin-toml": "^0.12.0", "eslint-plugin-unicorn": "^57.0.0", "eslint-plugin-unused-imports": "^4.1.4", "eslint-plugin-vue": "^10.0.0", "eslint-plugin-yml": "^1.17.0", "eslint-processor-vue-blocks": "^2.0.0", "globals": "^16.0.0", "jsonc-eslint-parser": "^2.4.0", "local-pkg": "^1.1.1", "parse-gitignore": "^2.0.0", "toml-eslint-parser": "^0.10.0", "vue-eslint-parser": "^10.1.1", "yaml-eslint-parser": "^1.3.0" } }, "sha512-Jnz6z/tGjfKUToZXgCF8XRBqZlEXlkLTymJgD2O2CzYfG58uUV/7cqtn2ABPs+SJ5t8O4qYwbC6WDOMQjP+M2Q=="],
@@ -1926,6 +1959,8 @@
 
     "@shikijs/core/@shikijs/engine-javascript/oniguruma-to-es": ["[email protected]", "", { "dependencies": { "emoji-regex-xs": "^1.0.0", "regex": "^6.0.1", "regex-recursion": "^6.0.2" } }, "sha512-bUH8SDvPkH3ho3dvwJwfonjlQ4R80vjyvrU8YpxuROddv55vAEJrTuCuCVUhhsHbtlD9tGGbaNApGQckXhS8iQ=="],
 
+    "@stacksjs/development/bun-plugin-dtsx/@stacksjs/dtsx": ["@stacksjs/[email protected]", "", { "bin": { "dtsx": "dist/cli.js" } }, "sha512-+u/PEp478qHM8s7xT0AOZowd93mZ/5ptHFyiz0B/gcxmdrdNdM6bLIK5si5Uzy1cR5TOVN4oAB3+WMKDnJ3n1w=="],
+
     "eslint-plugin-vuejs-accessibility/vue-eslint-parser/eslint-scope": ["[email protected]", "", { "dependencies": { "esrecurse": "^4.3.0", "estraverse": "^5.2.0" } }, "sha512-dOt21O7lTMhDM+X9mB4GX+DZrZtCUJPL/wlcTqxyrx5IvO0IYtILdtrQGQp+8n5S0gwSVmOf9NQrjMOgfQZlIg=="],
 
     "eslint-plugin-vuejs-accessibility/vue-eslint-parser/eslint-visitor-keys": ["[email protected]", "", {}, "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag=="],

docs/advanced/index.md

@@ -1,31 +1,150 @@
 # Advanced Topics
 
-This section covers advanced topics and techniques for using dtsx effectively.
+This section covers advanced topics and techniques for using dtsx effectively in complex scenarios.
 
-## Advanced Type Processing
+## Type Processing
 
-- **Complex Type Inference**: Handling nested and recursive types
-- **Type Relationship Tracking**: Maintaining type relationships across files
-- **Custom Type Transformations**: Advanced type manipulation techniques
-- **Type Augmentation**: Extending existing type definitions
+Learn about dtsx's advanced type processing capabilities:
 
-## Performance Optimization
+- **[Type Processing](./type-processing.md)**: Deep dive into how dtsx processes TypeScript types
+- **Complex Type Inference**: Handling nested, recursive, and conditional types
+- **Type Relationship Tracking**: Maintaining type dependencies across files
+- **Declaration Extraction**: Understanding the AST-based extraction process
+- **Comment Preservation**: Advanced comment handling and formatting
 
-- **Import Optimization Strategies**: Advanced techniques for optimizing imports
-- **Memory Management**: Handling large codebases efficiently
-- **Parallel Processing**: Optimizing multi-file processing
-- **Caching Strategies**: Improving build times with caching
+## Performance & Optimization
 
-## Integration Patterns
+Optimize dtsx for large codebases and complex projects:
 
-- **Build System Integration**: Integrating with various build tools
-- **CI/CD Integration**: Setting up automated declaration generation
-- **Custom Transformers**: Creating custom type transformers
-- **Plugin System**: Extending dtsx functionality
+- **[Performance](./performance.md)**: Performance optimization strategies and best practices
+- **Import Optimization**: Advanced techniques for optimizing import statements
+- **Memory Management**: Handling large codebases efficiently with Bun's runtime
+- **File Processing**: Optimizing multi-file processing workflows
+- **Output Structure**: Choosing the right output structure for your needs
 
-## Troubleshooting
+## Integration & Automation
 
-- **Common Issues**: Solutions to frequent problems
-- **Debugging Techniques**: Advanced debugging strategies
-- **Performance Profiling**: Identifying and fixing performance bottlenecks
+Integrate dtsx into your development workflow:
+
+- **[Integration](./integration.md)**: Build system and CI/CD integration patterns
+- **Build Tool Integration**: Webpack, Vite, Rollup, and other bundler integration
+- **CI/CD Pipelines**: Automated declaration generation in continuous integration
+- **Package.json Scripts**: Effective npm script configurations
+- **Development Workflows**: Hot reloading and watch mode strategies
+
+## Troubleshooting & Debugging
+
+Solve common issues and debug complex scenarios:
+
+- **[Troubleshooting](./troubleshooting.md)**: Common issues and their solutions
+- **TypeScript Configuration**: Isolated declarations and tsconfig.json setup
 - **Type Resolution**: Handling complex type resolution scenarios
+- **Import/Export Issues**: Debugging import and export problems
+- **Performance Debugging**: Identifying and fixing performance bottlenecks
+
+## Configuration Patterns
+
+Advanced configuration techniques:
+
+### Multi-Package Monorepos
+```typescript
+// dts.config.ts
+export default {
+  entrypoints: [
+    'packages/*/src/index.ts',
+    'packages/*/src/types.ts'
+  ],
+  outputStructure: 'mirror',
+  clean: true
+}
+```
+
+### Selective Type Generation
+```typescript
+// Generate only specific modules
+export default {
+  entrypoints: [
+    'src/public-api/**/*.ts',
+    '!src/internal/**/*.ts'
+  ]
+}
+```
+
+### Custom Output Structures
+```typescript
+// Flat structure for libraries
+export default {
+  outputStructure: 'flat',
+  outdir: './types'
+}
+```
+
+## Best Practices
+
+### Type Design
+- Use explicit type annotations for public APIs
+- Leverage JSDoc comments for comprehensive documentation
+- Design types with isolated declarations in mind
+- Avoid complex type computations in public interfaces
+
+### Project Structure
+- Organize types in dedicated files when appropriate
+- Use barrel exports for clean public APIs
+- Separate internal types from public interfaces
+- Maintain consistent naming conventions
+
+### Performance
+- Use type-only imports when possible
+- Minimize circular dependencies
+- Consider output structure impact on bundle size
+- Enable verbose logging only for debugging
+
+### Documentation
+- Include comprehensive JSDoc comments
+- Use `@example` tags for usage examples
+- Document complex type relationships
+- Maintain up-to-date type documentation
+
+## Advanced Use Cases
+
+### Library Development
+Creating type-safe libraries with comprehensive declaration files:
+
+```typescript
+// src/index.ts
+/**
+ * Main library interface
+ * @example
+ * const lib = new MyLibrary({ config: true })
+ */
+export class MyLibrary {
+  constructor(options: LibraryOptions) {}
+}
+
+export type { LibraryOptions } from './types'
+```
+
+### API Client Generation
+Generating types for API clients and SDKs:
+
+```typescript
+// Generate types for REST API responses
+export interface ApiResponse<T = unknown> {
+  data: T
+  status: number
+  message?: string
+}
+```
+
+### Plugin Systems
+
+Creating extensible plugin architectures with proper typing:
+
+```typescript
+// Plugin interface with proper type constraints
+export interface Plugin<TConfig = Record<string, unknown>> {
+  name: string
+  config?: TConfig
+  initialize(): Promise<void>
+}
+```