Cursor rule

1---
2globs: packages/pglite-inspector/src/**/*
3---
4 
5## PGlite Inspector (Devtool)
6 
7- **Role**: Developer-only tooling to inspect and debug the in-browser PGlite database.
8- Must **not** become a production dependency for core features.
9 
10### API & Integration
11 
12- Keep the public surface minimal:
13  - Primary entry point is `setupPGliteDevtools({ app, db })`.
14  - Avoid exposing low-level PGlite internals; the caller should only need a `PGlite` instance and a Vue `App`.
15- Callers (e.g. `apps/web/src/main.ts`) must guard usage with `import.meta.env.DEV` and handle the case where `db` is unavailable.
16 
17### Behavior & UX
18 
19- Present a clear, read-only view of:
20  - Table list and basic metadata.
21  - Columns and types.
22  - Sample data (capped to a safe limit).
23- Timeline events (queries) should:
24  - Be lightweight to emit.
25  - Not significantly slow down query execution even in debug mode.
26 
27### Reliability & Safety
28 
29- On any error (failed query, inspector read failure):
30  - Fail gracefully with a visible error state in devtools.
31  - Avoid crashing the host app.
32- Logging:
33  - Use `console.error` sparingly for truly unexpected failures in dev builds only.
34  - Do not spam the console on every normal query.
35 
36