feat: add colorSpace as canonical name, deprecate colorspace (non-breaking)

[GarthDB]

Replaces colorspace with colorSpace for consistency (fixes #190) without a breaking change.

Approach: deprecation alias

• Color / BackgroundColor: Constructor and updateColor accept both colorspace and colorSpace; colorSpace takes precedence. New colorSpace getter/setter; colorspace kept as deprecated alias with console.warn.
• createScale: Same: accept both param names, prefer colorSpace, warn when colorspace is used.
• TypeScript: colorSpace added to ColorBase and createScale options; colorspace marked @deprecated.
• docs/ui: Uses colorSpace in config, URL serialization, and internal scale classes. URL config parsing supports both keys for backward compatibility.

Existing code continues to work; a future major can remove the deprecated form.

Supersedes the approach in PR #191 (which was a breaking rename); this PR implements the deprecation-alias strategy commented on that PR.

Made with Cursor

[changeset-bot]

🦋 Changeset detected

Latest commit: f6ac136

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@adobe/leonardo-contrast-colors	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[github-actions]

Run report for f6ac136c

Total time: 15.1s | Comparison time: 28.4s | Estimated savings: 13.3s (46.8% faster)

	Action	Time	Status	Info
⬛️	SetupProto(0.53.2)	0.1ms	Skipped
🟩	SyncWorkspace	7.9ms	Passed
🟩	SyncProject(contrast-colors)	0.3ms	Passed
🟩	SyncProject(ui)	0.3ms	Passed
🟩	RunTask(ui:makeDistDir)	128ms	Passed
🟩	RunTask(ui:copyCNAME)	17.8ms	Passed
⬛️	SetupToolchain(node:24.0.0)	1.4s	Skipped
🟩	InstallWorkspaceDeps(node:24.0.0)	0.4ms	Passed
🟩	RunTask(ui:copyUIIcons)	36.8ms	Passed
🟩	RunTask(ui:copyWorkflowIcons)	66.5ms	Passed
🟩	RunTask(ui:lint)	3.8s	Passed
🟩	RunTask(contrast-colors:test-types)	7s	Passed
🟩	RunTask(contrast-colors:test)	7.2s	Passed
🟩	RunTask(ui:buildSite)	13.6s	Passed

Touched files

.changeset/colorSpace-deprecation-alias.md
.github/workflows/ci.yml
docs/ui/moon.yml
docs/ui/src/demo.js
docs/ui/src/js/addColorsFromImage.js
docs/ui/src/js/colorDetailsPanel.js
docs/ui/src/js/colorScale.js
docs/ui/src/js/colorScaleDiverging.js
docs/ui/src/js/colorScaleSequential.js
docs/ui/src/js/createOutputParameters.js
docs/ui/src/js/createPaletteCharts.js
docs/ui/src/js/initialDivergingScale.js
docs/ui/src/js/initialSequentialScale.js
docs/ui/src/js/initialTheme.js
docs/ui/src/js/params.js
docs/ui/src/theme.js
package.json
packages/contrast-colors/chroma-js.d.ts
packages/contrast-colors/index.d.ts
packages/contrast-colors/lib/color.js
packages/contrast-colors/lib/theme.js
packages/contrast-colors/lib/utils.js
packages/contrast-colors/moon.yml
packages/contrast-colors/package.json
packages/contrast-colors/test/index.test-d.ts
pnpm-lock.yaml

[GarthDB]

Follow-up bug fixes (pushed to this branch)

A few issues in the deprecation-alias implementation were fixed in commit f6ac136:

1. Color._generateColorScale — It was still passing colorspace to createScale(), which triggered the deprecation warning on every scale regeneration. Updated to pass colorSpace so internal calls don’t spam the console.

2. docs/ui params.js — The OKLAB/OKLCH smoothing check used color.colorSpace only, so URL configs that used the old colorspace key (e.g. bookmarks) skipped first-color smoothing. It now uses the normalized colorSpaceVal (color.colorSpace ?? color.colorspace).

3. Theme updateColor — When the deprecated colorspace key was passed, it was aliased without a warning. Added a console.warn when colorspace is used so it’s consistent with the Color constructor/setter.

4. Color constructor — The unsupported-output error message referenced colorSpace instead of this._output; corrected so the message shows the actual invalid output value.

The index.d.ts changes in this PR (canonical colorSpace and @deprecated colorspace) already match this behavior; no type changes were needed in the follow-up.

[GarthDB]

The changes to the index.d.ts and tests are also satisfy the original intent of the #102 pr.