Release v0.2.0 cli by CarlosEduJs · Pull Request #13 · CarlosEduJs/bdsg

CarlosEduJs · 2026-01-15T00:03:58Z

Description

Add gradient generation support to bdsg-cli, enabling OKLCH-based color gradient creation from the command line. This aligns the CLI with bdsg v0.2.0 features.

Type of Change

feat: New feature
fix: Bug fix
docs: Documentation only
refactor: Code refactoring (no functional changes)
perf: Performance improvement
test: Adding or updating tests
chore: Maintenance (dependencies, config, etc.)

Changes

Add bdsg generate gradient command with OKLCH interpolation
Support easing functions: linear, easeIn, easeOut, easeInOut
Support hue direction control: shorter, longer, increasing, decreasing
Output CSS variables with gradient stops and CSS gradient strings
JSON export with full gradient metadata
Update bdsg dependency from ^0.1.3 to ^0.2.0
Bump CLI version to 0.2.0
Update README.md with gradient command documentation
Update CHANGELOG.md with v0.2.0 release notes

Testing

Tests pass (bun test)
Types are correct (bun run check-types)
Code is formatted (bun run check)
Manual testing: bdsg generate gradient "#FF0000" "#0000FF" -s 5

Breaking Changes

This PR introduces breaking changes

Checklist

PR title follows Conventional Commits format
Code follows the project's style guidelines
Self-review completed
Documentation updated (if needed)
Tests added/updated (if needed)

…ents linear/radials

Copilot

Pull request overview

This PR adds gradient generation support to bdsg-cli, aligning it with the bdsg v0.2.0 library release. The new generate gradient command enables OKLCH-based color gradient creation with easing functions and hue direction control.

Changes:

Added bdsg generate gradient command with OKLCH interpolation, easing functions (linear, easeIn, easeOut, easeInOut), and hue direction control (shorter, longer, increasing, decreasing)
Updated bdsg dependency from ^0.1.3 to ^0.2.0 and bumped CLI version to 0.2.0
Updated README.md and CHANGELOG.md with v0.2.0 release documentation

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File	Description
packages/bdsg-cli/src/commands/generate.ts	Added new gradient command with options for name, steps, easing, direction, output directory, and format
packages/bdsg-cli/package.json	Bumped version to 0.2.0 and updated bdsg dependency to ^0.2.0
packages/bdsg-cli/README.md	Added gradient command documentation with usage examples and available options
CHANGELOG.md	Added v0.2.0 release notes for bdsg-cli with gradient command features

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-01-15T00:08:00Z

packages/bdsg-cli/src/commands/generate.ts

+					const easingFn =
+						EASING[options.easing as keyof typeof EASING] || EASING.linear;
+


The easing option validation should fail with a clear error message when an invalid value is provided, rather than silently falling back to EASING.linear. This could confuse users who make typos or provide invalid easing function names. Consider validating the easing option against the valid values (linear, easeIn, easeOut, easeInOut) and throwing an error if invalid.

Suggested change

const easingFn =

EASING[options.easing as keyof typeof EASING] || EASING.linear;

const validEasings = ["linear", "easeIn", "easeOut", "easeInOut"] as const;

if (!validEasings.includes(options.easing)) {

throw new Error(

`Invalid easing option "${options.easing}". Valid options are: ${validEasings.join(

", ",

)}.`,

);

}

const easingFn = EASING[options.easing as keyof typeof EASING];

Copilot · 2026-01-15T00:08:00Z

packages/bdsg-cli/src/commands/generate.ts

+				const spinner = ora("Generating gradient...").start();
+
+				try {
+					const steps = Number.parseInt(options.steps, 10);


The steps option should be validated before parsing to ensure it's a valid numeric string. If a user provides a non-numeric value, Number.parseInt will return NaN, which will cause a less user-friendly error message from the library validation. Consider adding validation to check if options.steps is a valid number string and provide a clear error message if not.

Suggested change

const steps = Number.parseInt(options.steps, 10);

const stepsRaw = options.steps;

if (!/^\d+$/.test(stepsRaw)) {

throw new Error(

`Invalid value for --steps: "${stepsRaw}". Please provide a positive integer.`,

);

}

const steps = Number.parseInt(stepsRaw, 10);

Copilot · 2026-01-15T00:08:00Z

packages/bdsg-cli/src/commands/generate.ts

+					if (options.format === "json") {
+						const gradient: Record<string, unknown> = {
+							name: options.name,
+							start: startColor,
+							end: endColor,
+							steps,
+							colors,
+							css: {
+								linear: toCssGradient("linear", colors, 90),
+								radial: toCssGradient("radial", colors),
+							},
+						};
+						await writeFile(
+							join(options.output, `${options.name}.json`),
+							JSON.stringify({ gradient }, null, 2),
+						);
+					} else {


The format option should be validated to ensure it's either "css" or "json". If a user provides an invalid format value, the code currently defaults to CSS output without any warning to the user. Consider validating the format option and providing a clear error message for invalid values.

* Release v0.2.0 bdsg (#11) * feat(bdsg): add okloch color space, feat palettes with olock, gradient system - two colors and multi colors; reorder imports in others files * generate test file * chore: add suport validation zod in gradient file * refactor: remove zod schemas from files and centralized in a single file * chore: biome write files * chore: move gradient tests out of oklch tests * docs(bdsg): update readme * docs: update changelog * tests: generate new tests suites * docs: update readme * refactor: remove unused interpolation property and fix version notation * ci: add dev branch to workflow * Release v0.2.0 cli (#13) * feat(bdsg-cli): add new options and new outputs css variables + gradients linear/radials * docs: update readme * docs: update changelog * docs: update version to reflet package * feat(bdsg-cli): add gradient command and input validation

CarlosEduJs added 4 commits January 14, 2026 20:41

feat(bdsg-cli): add new options and new outputs css variables + gradi…

385974e

…ents linear/radials

docs: update readme

7f7854f

docs: update changelog

30b1e5d

docs: update version to reflet package

6aff3d0

CarlosEduJs requested a review from Copilot January 15, 2026 00:04

Copilot started reviewing on behalf of CarlosEduJs January 15, 2026 00:04 View session

Copilot AI reviewed Jan 15, 2026

View reviewed changes

feat(bdsg-cli): add gradient command and input validation

4b941a4

CarlosEduJs merged commit a97d270 into dev Feb 4, 2026
2 checks passed

CarlosEduJs mentioned this pull request Feb 4, 2026

release v0.2.0 (#12) #14

Merged

CarlosEduJs deleted the release/v0.2.0-cli branch February 4, 2026 22:39

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Release v0.2.0 cli#13

Release v0.2.0 cli#13
CarlosEduJs merged 5 commits intodevfrom
release/v0.2.0-cli

CarlosEduJs commented Jan 15, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Jan 15, 2026

Uh oh!

Copilot AI Jan 15, 2026

Uh oh!

Copilot AI Jan 15, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

		const easingFn =
		EASING[options.easing as keyof typeof EASING] \|\| EASING.linear;

-					const easingFn =
-						EASING[options.easing as keyof typeof EASING] || EASING.linear;
+					const validEasings = ["linear", "easeIn", "easeOut", "easeInOut"] as const;
+					if (!validEasings.includes(options.easing)) {
+						throw new Error(
+							`Invalid easing option "${options.easing}". Valid options are: ${validEasings.join(
+								", ",
+							)}.`,
+						);
+					}
+					const easingFn = EASING[options.easing as keyof typeof EASING];

-					const steps = Number.parseInt(options.steps, 10);
+					const stepsRaw = options.steps;
+					if (!/^\d+$/.test(stepsRaw)) {
+						throw new Error(
+							`Invalid value for --steps: "${stepsRaw}". Please provide a positive integer.`,
+						);
+					}
+					const steps = Number.parseInt(stepsRaw, 10);

Conversation

CarlosEduJs commented Jan 15, 2026

Description

Type of Change

Changes

Testing

Breaking Changes

Checklist

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Jan 15, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 15, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 15, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants