Skip to content

refactor(docs): extract site workspace#62

Draft
kjanat wants to merge 4 commits into
masterfrom
docs-workspace-39
Draft

refactor(docs): extract site workspace#62
kjanat wants to merge 4 commits into
masterfrom
docs-workspace-39

Conversation

@kjanat

@kjanat kjanat commented Jul 17, 2026

Copy link
Copy Markdown
Owner

Summary

  • add a private @kjanat/dreamcli-docs workspace with its own scripts, dependencies, and TypeScript config
  • keep thin root docs:* aliases while removing all docs-only dependencies and the VitePress override from the root manifest
  • switch docs fixtures to the workspace dependency instead of the root-only #dreamcli import map
  • replace the remaining global Bun link in examples/pwsh-demo with a relative file dependency so clean Cloudflare installs do not require a pre-linked package

Why

The docs toolchain was owned by the published root package, and introducing a package boundary exposed two hidden root assumptions: Vite types in the root TypeScript config and #dreamcli/* imports inherited from the root manifest. Cloudflare installs also failed because one workspace still referenced @kjanat/dreamcli through a global named Bun link that does not exist in a clean build environment.

The docs package now owns its complete toolchain and resolves the library through an explicit relative dependency. Root aliases preserve existing CI and development commands, and the unchanged Cloudflare build command continues to work through workspace resolution.

Validation

  • bun install --frozen-lockfile
  • bunx tsc --noEmit --project docs/tsconfig.json
  • bun --bun vitepress build docs
  • bunx wrangler deploy --dry-run from docs/
  • bun run ci (87 test files, 2,845 tests)

Closes #39

@coderabbitai

coderabbitai Bot commented Jul 17, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are limited based on label configuration.

🏷️ Required labels (at least one) (1)
  • cr:review
🚫 Excluded labels (none allowed) (2)
  • wip
  • cr:skip

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: ASSERTIVE

Plan: Pro

Run ID: 2c4ac498-9702-4719-934f-35ce795da11b

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

Comment @coderabbitai help to get the list of available commands.

@pkg-pr-new

pkg-pr-new Bot commented Jul 17, 2026

Copy link
Copy Markdown

Open in StackBlitz

bun add https://pkg.pr.new/@kjanat/dreamcli@62
npm i https://pkg.pr.new/@kjanat/dreamcli@62

commit: 2512297

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jul 17, 2026

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
dreamcli 2512297 Commit Preview URL

Branch Preview URL
Jul 17 2026, 06:40 PM

kjanat added 2 commits July 17, 2026 18:23
Generate Deno imports from package metadata so Bun, npm, and JSR do
not maintain separate dependency versions. Track the definition schema
and satisfy Deno's public documentation checks without weakening types.
@socket-security

Copy link
Copy Markdown

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff Package Supply Chain
Security
Vulnerability Quality Maintenance License
Updatedrunner-run@​0.19.1 ⏵ 0.20.069 +11009996 +1100
Addedimportmapify@​1.0.17410010088100
Updatedvite@​8.1.4 ⏵ 8.1.59810082 +198 +1100
Updatedtsdown@​0.22.8 ⏵ 0.22.998 +110088 +198 +1100
Updatedwrangler@​4.111.0 ⏵ 4.112.0100 +2100100 +25100 +5100

View full report

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.

Extract docs site into its own workspace package (docs/package.json)

1 participant