fix: address scaffold and framework papercuts (#65–#85)

[antosubash]

Summary

Bundled fixes covering eleven open issues. Every change is scoped to framework templates and core helpers; existing in-tree behaviour is preserved by the test suite (431 tests passing).

Issues addressed

Scaffold (sm new) templates

• Vite dev server fails to bundle use-sync-external-store CJS shim #65 vite: pre-bundle the use-sync-external-store CJS shim so recharts / react-redux pulls don't blow up the dev server.
• sm new scaffold ships no Tailwind config — every page renders unstyled #82 / Dev server renders unstyled UI: no Tailwind/PostCSS in host scaffold #78 tailwind: add tailwindcss + @tailwindcss/vite to the host package.json template, register the plugin in vite.config.ts, and ship a styles.css that imports the UI globals + module @source globs.
• sm new scaffold doesn't call configureI18n — every t() returns raw key #83 i18n: scaffold app.tsx now calls configureI18n from initial Inertia shared props and listens to router events for locale transitions.
• Page resolver in sm new scaffold drops nested pages — Users admin page unreachable #84 page resolver: glob and regex now allow nested .tsx pages (e.g. pages/Users/Index.tsx). Same fix applied to the in-tree host/client_app/pages.ts.
• sm new --preset full generates pyproject.toml with unpublished/conflicting deps #67 catalog: --preset full no longer pulls in the datasets example module; new examples preset opts in to demo modules.

Framework

• Inertia template only uses asset manifest for SM_ENVIRONMENT='production' literal #80 inertia env: any non-development/testing environment now uses the production manifest path (was a literal "production" check), so staging/qa hosts render with built assets instead of a stranded /main.tsx script tag.
• Postgres enum labels uppercase but Python StrEnum values lowercase — raw SQL footgun #79 enum render: render_item now emits sa.Enum(..., values_callable=...) for StrEnum columns so Postgres labels match lowercase StrEnum values rather than uppercase attribute names.
• Alembic autogenerate missing imports + duplicate GIST index for GeoAlchemy2 columns #69 alembic imports: render_item adds the imports for fastapi_users_db_sqlalchemy.generics and geoalchemy2 types so autogenerated migrations are importable without manual patching.
• Misc papercuts: SM_PROJECT_ROOT fallback, gen-pages silent no-op, http test client URLs, pydantic-v2 attrs, executemany RETURNING #77 SM_PROJECT_ROOT: app builder now walks up from cwd looking for pyproject.toml / .env / alembic.ini sentinels instead of a fixed parents[3] depth, so wheel installs work without setting the env var. gen-pages CLI summary also includes the module count.
• No diagnostic when a module ships routes/views but skips register_menu_items / register_permissions #85 SM019 diagnostic: warns when a module overrides register_routes with a non-empty view_prefix but never registers a menu item — pages exist but the sidebar can't surface them.

Packages

• @simple-module-py/ui@0.0.3 missing 13 peer dependencies #72 ui peer deps: declare the radix-ui, cmdk, vaul, recharts, etc. peer dependencies the components actually import, so npm warns at install rather than build time.

Out of scope

A few issues were skipped because they target architectural changes outside this repo or affect publish-only concerns:

• @vitejs/plugin-react 'can't detect preamble' on module-shipped .tsx pages #66 plugin-react preamble for module-shipped pages — needs deeper investigation
• Schema-per-module triggered by SM_DATABASE_URL env var creates unsolvable worker config #68 schema-per-module env-var coupling — architectural change
• View routers with prefix /<name> + route / produce 307 on bare-prefix URL #70 redirect_slashes default — too invasive to flip globally
• SM_BG_TASKS_TASK_ALWAYS_EAGER ineffective for tests that don't use the client fixture #71 background_tasks eager mode bootstrapping — covered by external simple_module_test fixtures
• Module-shipped .tsx pages need symlink + vite aliases + inline tsconfig boilerplate #73 module-shipped .tsx page resolution (vite aliases / symlinks) — broader plugin work
• GrantsHelper API/docs drift: user_id type hint and user_groups parameter #74 GrantsHelper API drift — refers to external lacowiki_sharing / simple_module_sharing packages
• pytest infra: tests/__init__.py collision + pytest_plugins location restriction #75 pytest infra (tests/__init__.py / pytest_plugins) — documentation/process
• host_conftest pooled async engine causes 'Future attached to a different loop' across tests #76 host_conftest pooled engine — repo conftest uses in-memory SQLite, not affected
• UsersSettings ignores SM_USERS_* env vars but validator still requires non-placeholder secrets #81 UsersSettings env var override — affects DB-bootstrap UX, separate redesign

Test plan

• uv run pytest framework/ tests/ --ignore=tests/e2e — 431 passed
• uv run ruff check framework/
• uv run ruff format --check framework/
• New SM019 diagnostic covered by 4 tests in framework/core/tests/test_module_diagnostics.py
• Updated --preset full wizard test reflects the new catalog contract

https://claude.ai/code/session_01MvfqvaCPGZd5SQW8TpJkHc

---

Generated by Claude Code