chore: untrack generated CSS

Author: antfu

.gitignore

@@ -1,6 +1,7 @@
 .cache
 .DS_Store
 .eslintcache
+.generated
 .idea
 *.log
 *.tgz

AGENTS.md

@@ -34,6 +34,8 @@ The `pnpm test` script intentionally runs `build` first so `tsnapi` snapshots co
 
 `pnpm typecheck` runs `scripts/verify-typecheck-coverage.ts` first - it fails the command (and CI, since CI just runs `pnpm typecheck`) if any workspace package has a `tsconfig.json` but no `typecheck` script, so a new package can't silently join the same blind spot. A package that genuinely can't typecheck yet needs a documented exception in that script, not a missing script.
 
+Ahead-of-time build artifacts that live under `src/` - the shadow-root stylesheets in `packages/hub-ui/src/client/.generated/` and `packages/json-render-ui/src/.generated/` - are **generated, not committed** (`.generated` is gitignored). Each owning package builds its own with `pnpm run build:css`, and three things guarantee the file is on disk before anything imports it: the root `postinstall` runs `turbo run build:css`, the Turbo `typecheck` task depends on both `build:css` tasks, and each package's `build` script chains `build:css` first. A new generated-under-`src` artifact follows the same shape - its own build script, declared `outputs` in `turbo.json`, and a `typecheck` dependency - rather than being checked in, since a minified single-line blob conflicts on every concurrent edit.
+
 `pnpm knip` finds unused files, dependencies, and exports across every workspace (config in `knip.jsonc`). It runs against source directly - no prior build needed. Most workspaces need no configuration; `knip.jsonc` only carries per-workspace overrides for cases knip's defaults can't infer on their own: a package's non-`index.ts` `exports` subpaths (knip's package.json→`dist`→`src` source mapping needs a workspace `tsconfig.json` `outDir`, which conflicts with this repo's cross-workspace `src/*.ts` imports, so multi-entry packages list their `exports`-mapped entry files explicitly instead - keep that list in sync with each `tsdown.config.ts`), config files knip's plugins don't discover in a nested location (a Next.js app rooted below the workspace root, `storybook-solidjs-vite` not matching the Storybook plugin trigger), and dependencies referenced dynamically outside its static import graph (icon collections consumed by UnoCSS at build time, plugin packages loaded via a runtime `import()` string). Prefer fixing the underlying gap or a scoped `ignoreDependencies`/`entry` override over a blanket `ignore`.
 
 ## Conventions

package.json

@@ -15,6 +15,7 @@
   "bugs": "https://github.com/devframes/devframe/issues",
   "scripts": {
     "build": "turbo run build --concurrency=3",
+    "build:css": "turbo run build:css",
     "ci:build": "tsx scripts/ci-retry.ts pnpm run build",
     "watch": "turbo watch build --concurrency=3",
     "play": "tsx scripts/play.ts",
@@ -33,7 +34,7 @@
     "release": "bumpp -r",
     "typecheck": "pnpm run verify:typecheck-coverage && turbo run typecheck",
     "verify:typecheck-coverage": "tsx scripts/verify-typecheck-coverage.ts",
-    "postinstall": "npx simple-git-hooks && skills-npm"
+    "postinstall": "npx simple-git-hooks && skills-npm && pnpm run build:css"
   },
   "devDependencies": {
     "@antfu/design": "catalog:frontend",

packages/hub-ui/src/client/.generated/css.ts

@@ -3,7 +3,15 @@
   "globalDependencies": ["pnpm-lock.yaml", "tsconfig.base.json"],
   "tasks": {
     "typecheck": {
-      "dependsOn": ["^typecheck"]
+      "dependsOn": ["^typecheck", "@devframes/hub-ui#build:css", "@devframes/json-render-ui#build:css"]
+    },
+    "@devframes/hub-ui#build:css": {
+      "outputLogs": "new-only",
+      "outputs": ["src/client/.generated/**"]
+    },
+    "@devframes/json-render-ui#build:css": {
+      "outputLogs": "new-only",
+      "outputs": ["src/.generated/**"]
     },
     "devframe#build": {
       "outputLogs": "new-only",