Add moi shadcn spec and applet Tailwind experiment

[molefrog]

Documents the decided shadcn strategy for applets in a single spec, docs/moi-shadcn.md — moi shadcn, a shadcn-lite proxy over the shadcn package's programmatic engine: zero config files in the workspace, always Base UI, components in .moi/ui/, and a deliberately dumb command that writes source files and prints next steps. Every empirical claim in the spec was verified by experiment during this session (research trail in the session log below).

The one behavior change is a small EXPERIMENT-marked patch to the applet build:

// synthetic Tailwind entry now inlines (from moi's own node_modules):
@import 'tailwindcss';
+ <tw-animate-css>        ← animate-in, fade-in-0 …
+ <shadcn/tailwind.css>   ← data-open: variants, keyframes, scroll-fade
<theme.css>               ← unchanged

Without it, every shadcn idiom is silently dropped by Tailwind v4 (verified); with it, all emit correctly scoped, +11 KB usage-driven.

Worth a close look:

• server/bundler/build-applet.ts — the only code change; affects every applet build. Includes demo --secondary values that belong in the host theme and will move there in the foundation PR.
• docs/moi-shadcn.md §Theming — records a live host bug (workspace color themes never reach force-dark widgets; only fonts pass through) with the proposed hue-vs-mode fix.
• §Opinions and §What add does — the command's non-responsibilities (no install, no rebuild, no overwrite) are load-bearing design decisions, not omissions.

Verified: bun test server/test/build-applet.test.ts server/test/applet-css.test.ts — 54 pass, 0 fail; live browser runs confirm the portal finding and the theme cascade; a zero-config installer PoC installed 4 registry components end to end through the moi build.

🤖 Generated with Claude Code

https://claude.ai/code/session_01JktaFqESZKUaoiKttzLnW4

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a0f3f98c4c

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Add the shared UI directory to Tailwind sources

When an applet follows the new spec and imports generated controls from ../ui/button, the class strings inside .moi/ui/button.tsx are outside sourceDir (.moi/widgets or .moi/views). This patch inlines shadcn's Tailwind extensions, but the synthetic CSS still only sources the applet directory, so Tailwind emits these variants/utilities only if the same class names also appear in the widget/view file; most installed component styling will be silently dropped. Add .moi/ui (or the walked local import graph) as a Tailwind source before this can support .moi/ui components.

Useful? React with 👍 / 👎.

[chatgpt-codex-connector]

Keep secondary values inherited from the host theme

For any applet using bg-secondary/text-secondary-foreground, this synthetic :root rule is later scoped to the applet container by scopeAppletCss, so every applet gets fixed neutral secondary colors instead of inheriting workspace theme tokens. It also masks a future host-level --secondary because the container-scoped declaration is closer in the cascade. Keep this entry to @theme aliases only and put the actual defaults/derivations in the host theme where other tokens live.

Useful? React with 👍 / 👎.