FE-726: generate ds-helpers styled-system before publishing

[lunelson]

🌟 What is the purpose of this PR?

Ensure the generated Panda styled-system/ files are present in the @hashintel/ds-helpers npm tarball when the package is packed/published, without committing that generated output to git.

This fixes the broken @hashintel/ds-helpers@0.2.0 package shape reported in FE-726, where the published tarball included export paths pointing at styled-system/ but omitted the generated directory itself.

🔗 Related links

• Fixes FE-726: @hashintel/ds-helpers@0.2.0 published tarball is missing the entire styled-system/ directory #8719
• https://linear.app/hash/issue/FE-726/user-report-hashintelds-helpers020-published-tarball-is-missing-the (internal)

🚫 Blocked by

• Not blocked

🔍 What does this change?

• Adds a prepack script to @hashintel/ds-helpers so packaging runs Turbo codegen before npm assembles the tarball.
• Adds a no-op codegen script for @hashintel/ds-helpers, making it addressable in the Turbo graph.
• Adds libs/@hashintel/ds-helpers/turbo.json so ds-helpers#codegen depends on @hashintel/ds-components#codegen, which is the source-owned generator that writes ../ds-helpers/styled-system.
• Overrides ds-helpers#build locally to avoid a Turbo dependency cycle while preserving styled-system/ as generated, gitignored output.
• Adds a patch changeset for @hashintel/ds-helpers.

Pre-Merge Checklist 🚀

🚢 Has this modified a publishable library?

This PR:

• modifies an npm-publishable library and I have added a changeset file(s)

📜 Does this require a change to the docs?

The changes in this PR:

• are internal and do not require a docs change

🕸️ Does this require a change to the Turbo Graph?

The changes in this PR:

• affected the execution graph, and the turbo.json's have been updated to reflect this

⚠️ Known issues

The already-published @hashintel/ds-helpers@0.2.0 tarball cannot be changed in place; this will publish a patched package version with the generated files included.

🐾 Next steps

After merge, publish the changeset release for @hashintel/ds-helpers so consumers can upgrade to the fixed package version.

🛡 What tests cover this?

• Manual package verification with npm pack --dry-run --json from libs/@hashintel/ds-helpers, after deleting local styled-system/.
• Manual Turbo verification with turbo run codegen --filter @hashintel/ds-helpers.

❓ How to test this?

1. Remove any local generated output: rm -rf libs/@hashintel/ds-helpers/styled-system
2. Run: cd libs/@hashintel/ds-helpers && npm pack --dry-run --json
3. Confirm prepack runs turbo run codegen --filter @hashintel/ds-helpers.
4. Confirm the pack output includes styled-system/ files, e.g. styled-system/css/index.mjs and styled-system/tokens/index.mjs.

📹 Demo

N/A — packaging fix only.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
hash	Ready	Preview, Comment	May 20, 2026 8:23am
hashdotdesign-tokens	Ready	Preview, Comment	May 20, 2026 8:23am
petrinaut	Ready	Preview	May 20, 2026 8:23am

[lunelson]

• FE-726: generate ds-helpers styled-system before publishing #8732 👈 (View in Graphite)
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[cursor]

PR Summary

Medium Risk
Adjusts Turbo task dependencies and npm packaging hooks for @hashintel/ds-helpers, which could affect build/publish behavior and caching if misconfigured. No runtime logic changes, but a bad graph edge could reintroduce cycles or ship missing artifacts.

Overview
Ensures @hashintel/ds-helpers publishes its generated styled-system/** output without committing it to git by running Turbo codegen during npm pack/npm publish.

Adds a local turbo.json that makes ds-helpers#codegen depend on @hashintel/ds-components#codegen (and overrides build deps to avoid a Turbo cycle), plus a prepack hook and no-op codegen script in package.json to materialize styled-system/** before packing. Includes a patch changeset and clarifies the package boundary rules in AGENTS.md.

^{Reviewed by Cursor Bugbot for commit 4fa497b. Bugbot is set up for automated code reviews on this repo. Configure here.}

[augmentcode]

🤖 Augment PR Summary

Summary: Ensures the published @hashintel/ds-helpers tarball includes the Panda-generated styled-system/ output by running codegen during prepack.

Changes: Adds a no-op codegen script plus a package-local turbo.json task graph (and a patch changeset) so packing triggers generation without committing the output.

_{🤖 Was this summary useful? React with 👍 or 👎}

[augmentcode]

Review completed. 2 suggestions posted.

Comment augment review to trigger a new review at any time.

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 54853b1. Configure here.}