Skip to content

Conversation

@DmitryBochkarev
Copy link

@DmitryBochkarev DmitryBochkarev commented Dec 6, 2025

This PR is based on #497 and #500

Closes #54

I plan to provide more detailed examples in https://github.com/DmitryBochkarev/nelm-ts-examples

This is quite a big PR. I can try to split it into separate commits. 1000 lines of 2000 all implementation code are TS project initialization code(nelm chart create), and 2/3 of the rest of the code is tests - so 1,000 lines of actual feature implementation.

This PR is slightly diverged from original proposal regarding target js bundle file name. I named it ts/chart_render_main.js so it is explicit and hard to randomly create such file.

TypeScript types a more simple than propose in #500
but it can be fixed later.

What is implemented

  • Feature gate NELM_FEAT_TS_CHARTS
  • Packaging with transpiling from TypeScript to a JavaScript bundle (one file)
  • Rendering packaged or source directory. If a packaged JS bundle is present, rendering uses it instead of trying to transpile.
  • SourceMaps with proper backtraces to the original file on render errors
  • Generation of a TypeScript project. If the feature is enabled, by default, it initializes a TS project with proper structure. If --only-ts is specified, it adds a TS project to an existing chart or creates a new chart with only TS without a templates directory. Here is generated chart
  • If no external packages are used there are no external dependencies are needed only nelm

What is not implemented

  • Proper documentation for the feature
  • Minification is not implemented because it breaks SourceMaps for some reason (I have not found a relevant issue in esbuild issues)
  • Tree shaking – esbuild documentation states that tree shaking does not work with the CommonJS target
  • ApiVersion for rendered values (only manifests are read), but it is easy to implement
  • Separate npm package for nelm types

What I need help with

  • I need more complex examples of charts that can push the limits of this feature to eliminate some blind spots
  • I need help with proper testing of this feature (develop, pack, upload, download, install)

Introduce nelm chart create integration that can generate
TypeScript-based charts. Add --only-ts flag, tschart package to generate
boilerplate and Chart.yaml/values/.helmignore, register the new command

nodeModulesPath := filepath.Join(tsDir, "node_modules")
if _, err := os.Stat(nodeModulesPath); os.IsNotExist(err) {
log.Default.Debug(ctx, "No node_modules directory found, skipping vendor bundle")
Copy link
Member

@ilya-lesikov ilya-lesikov Dec 18, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should handle these cases:

  1. node_modules are up-to-date: proceed
  2. node_modules are not-up-to-date: error
  3. node_modules are empty/nonexistent, but there are dependencies in the project: error
  4. node_modules are empty/nonexistent, but there are no dependencies in the project: proceed
  5. node_modules are not empty, but there are no dependencies: error

Not sure how can we do it. And can we do this reliably and programmatically at all.

@ilya-lesikov
Copy link
Member

@cubic

@cubic-dev-ai
Copy link

cubic-dev-ai bot commented Dec 30, 2025

@cubic

@ilya-lesikov I have started the AI code review. It will take a few minutes to complete.

Copy link

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

3 issues found across 23 files

Prompt for AI agents (all issues)

Check if these issues are valid — if so, understand the root cause of each and fix them.


<file name="internal/tschart/transformer_mem.go">

<violation number="1" location="internal/tschart/transformer_mem.go:217">
P1: Using `filepath.Join` in virtual filesystem context will cause cross-platform issues. On Windows, this produces backslash-separated paths that won&#39;t match the forward-slash keys in the files map. Use `path.Join` from the `path` package instead, which always uses forward slashes.</violation>
</file>

<file name="internal/tschart/init.go">

<violation number="1" location="internal/tschart/init.go:331">
P2: The `chartName` is directly interpolated into JSON without escaping. If the chart name contains special JSON characters (quotes, backslashes), this produces invalid JSON. Consider using `json.Marshal` for proper escaping or validate the chart name before use.</violation>
</file>

<file name="internal/tschart/runtime.go">

<violation number="1" location="internal/tschart/runtime.go:104">
P2: Calling `ToObject(nil)` with nil runtime is unsafe and could cause a panic. The `formatJSError` function needs access to the goja runtime to safely convert the error value to an object. Consider passing the `*goja.Runtime` as a parameter, or add defensive nil checks.</violation>
</file>

Since this is your first cubic review, here's how it works:

  • cubic automatically reviews your code and comments on bugs and improvements
  • Teach cubic by replying to its comments. cubic learns from your replies and gets better over time
  • Ask questions if you need clarification on any suggestion

Reply to cubic to teach it or ask questions. Tag @cubic-dev-ai to re-run a review.


errMsg := gojaErr.Error()

stackProp := gojaErr.Value().ToObject(nil).Get("stack")
Copy link

@cubic-dev-ai cubic-dev-ai bot Dec 30, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: Calling ToObject(nil) with nil runtime is unsafe and could cause a panic. The formatJSError function needs access to the goja runtime to safely convert the error value to an object. Consider passing the *goja.Runtime as a parameter, or add defensive nil checks.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At internal/tschart/runtime.go, line 104:

<comment>Calling `ToObject(nil)` with nil runtime is unsafe and could cause a panic. The `formatJSError` function needs access to the goja runtime to safely convert the error value to an object. Consider passing the `*goja.Runtime` as a parameter, or add defensive nil checks.</comment>

<file context>
@@ -0,0 +1,112 @@
+
+	errMsg := gojaErr.Error()
+
+	stackProp := gojaErr.Value().ToObject(nil).Get(&quot;stack&quot;)
+	if stackProp == nil || goja.IsUndefined(stackProp) || goja.IsNull(stackProp) {
+		return fmt.Errorf(&quot;%s\n  at %s&quot;, errMsg, currentFile)
</file context>
Fix with Cubic

@ilya-lesikov ilya-lesikov requested a review from Copilot December 30, 2025 09:56

This comment was marked as off-topic.

@ilya-lesikov
Copy link
Member

/review

Copy link

@bito-code-review bito-code-review bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review Agent Run #aee90b

Actionable Suggestions - 4
  • ts/nelm-types/src/index.ts - 1
  • internal/chart/chart_render.go - 1
  • internal/tschart/init.go - 1
  • cmd/nelm/chart_init.go - 1
Additional Suggestions - 5
  • internal/tschart/runtime.go - 1
    • Invalid goja API usage · Line 104-104
      The ToObject(nil) call on line 104 violates goja's API, as Value.ToObject requires a valid *goja.Runtime. This could cause a panic during error formatting when JavaScript exceptions occur. If the runtime isn't available here, consider restructuring to pass it from the caller.
  • internal/tschart/transformer_unit_test.go - 2
    • Incomplete test assertions · Line 383-401
      The tests for generateVendorEntrypoint check the var declaration, require statements, and global assignment, but miss verifying the exports assignment. This could allow regressions if the exports line is removed from the function. Consider adding checks for 'exports.__NELM_VENDOR__ = __NELM_VENDOR__' in both test cases.
    • Test Isolation Improvement · Line 40-40
      The test for non-existent path uses a relative path not isolated in the test's tempDir, unlike other tests that use tempDir. This could potentially cause the test to fail if the current working directory has a file or directory with that name. Using filepath.Join(tempDir, "non-existent") would ensure proper isolation.
  • internal/tschart/init_test.go - 1
    • Missing Error Test Case · Line 155-257
      The test suite for InitChartStructure is missing coverage for the error case where the ts/ directory already exists. While the implementation correctly checks and returns an error in this scenario (matching InitTSBoilerplate's behavior), adding this test would ensure the error path is verified, preventing potential regressions if the check is accidentally removed.
  • pkg/action/chart_init.go - 1
    • Unused struct field · Line 17-17
      The TempDirPath field in ChartInitOptions is defined but not referenced in ChartInit or its callees. If this is for future temp dir logic, consider adding a comment; otherwise, remove to avoid confusion.
Review Details
  • Files reviewed - 21 · Commit Range: 9a6e649..37f16e7
    • cmd/nelm/chart.go
    • cmd/nelm/chart_init.go
    • cmd/nelm/chart_pack.go
    • go.mod
    • go.sum
    • internal/chart/chart_render.go
    • internal/tschart/console.go
    • internal/tschart/engine.go
    • internal/tschart/engine_unit_test.go
    • internal/tschart/init.go
    • internal/tschart/init_test.go
    • internal/tschart/runtime.go
    • internal/tschart/test_helpers_test.go
    • internal/tschart/transformer.go
    • internal/tschart/transformer_dir.go
    • internal/tschart/transformer_mem.go
    • internal/tschart/transformer_unit_test.go
    • internal/tschart/tschart_test.go
    • pkg/action/chart_init.go
    • pkg/featgate/feat.go
    • ts/nelm-types/src/index.ts
  • Files skipped - 2
    • ts/nelm-types/package.json - Reason: Filter setting
    • ts/nelm-types/tsconfig.json - Reason: Filter setting
  • Tools
    • Whispers (Secret Scanner) - ✔︎ Successful
    • Detect-secrets (Secret Scanner) - ✔︎ Successful
    • Golangci-lint (Linter) - ✔︎ Successful
    • Eslint (Linter) - ✔︎ Successful

Bito Usage Guide

Commands

Type the following command in the pull request comment and save the comment.

  • /review - Manually triggers a full AI review.

  • /pause - Pauses automatic reviews on this pull request.

  • /resume - Resumes automatic reviews.

  • /resolve - Marks all Bito-posted review comments as resolved.

  • /abort - Cancels all in-progress reviews.

Refer to the documentation for additional commands.

Configuration

This repository uses Default Agent You can customize the agent settings here or contact your Bito workspace admin at ilya.lesikov@flant.com.

Documentation & Help

AI Code Review powered by Bito Logo

Icon: string;
APIVersion: string;
Condition: string;
Tags: string;

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Type mismatch in Tags field

The Tags field is incorrectly typed as string, but Helm Chart.yaml specifies tags as a list of strings, so it should be string[] to match the expected data structure.

Code Review Run #aee90b


Should Bito avoid suggestions like this for future reviews? (Manage Rules)

  • Yes, avoid them

}

if featgate.FeatGateTypescript.Enabled() {
jsRenderedTemplates, err := renderJSTemplates(ctx, originalChartPath, chart, renderedValues)

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bug: Wrong path for TS rendering

For remote charts, originalChartPath is the remote URL, but TypeScript rendering requires the local filesystem path where the chart is downloaded. Use chartPath instead, which is updated by downloadChart to point to the local directory.

Code suggestion
Check the AI-generated fix before applying
 --- a/internal/chart/chart_render.go
 +++ b/internal/chart/chart_render.go
 @@ -212,1 +212,1 @@
 -		jsRenderedTemplates, err := renderJSTemplates(ctx, originalChartPath, chart, renderedValues)
 +		jsRenderedTemplates, err := renderJSTemplates(ctx, chartPath, chart, renderedValues)

Code Review Run #aee90b


Should Bito avoid suggestions like this for future reviews? (Manage Rules)

  • Yes, avoid them

"description": "TypeScript chart for %s",
"main": "src/index.ts",
"scripts": {
"build": "npx tsc --noEmit",

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Incorrect build script

The build script only type-checks without emitting compiled files, which doesn't match standard build expectations and ignores the tsconfig.json outDir setting. This could confuse users expecting a working build.

Code Review Run #aee90b


Should Bito avoid suggestions like this for future reviews? (Manage Rules)

  • Yes, avoid them

@ilya-lesikov

This comment was marked as off-topic.

greptile-apps[bot]

This comment was marked as off-topic.

@ilya-lesikov

This comment was marked as off-topic.

@ilya-lesikov ilya-lesikov changed the title TypeScript based charts definition. Closes #54 feat: TypeScript support in charts Jan 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Alternative to Go templates

2 participants