remix 3.0.0-rc.2 → 3.0.0-rc.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (77) hide show
  1. package/INDEX.md +94 -0
  2. package/dist/fetch-router.d.ts +1 -3
  3. package/dist/fetch-router.d.ts.map +1 -1
  4. package/dist/fetch-router.js +0 -1
  5. package/dist/index.d.ts +18 -0
  6. package/dist/index.d.ts.map +1 -0
  7. package/dist/index.js +1 -0
  8. package/guides/01-start-here.md +807 -0
  9. package/guides/02-routing-and-controllers.md +326 -0
  10. package/guides/03-request-handling.md +342 -0
  11. package/guides/04-rendering-ui.md +998 -0
  12. package/guides/05-interactivity.md +987 -0
  13. package/guides/06-streaming-ui-with-frames.md +361 -0
  14. package/guides/07-animation.md +1013 -0
  15. package/guides/08-data-and-validation.md +56 -0
  16. package/guides/09-forms-and-mutations.md +52 -0
  17. package/guides/10-auth-sessions-security.md +61 -0
  18. package/guides/11-files-and-assets.md +98 -0
  19. package/guides/12-errors-and-cancellation.md +44 -0
  20. package/guides/13-testing.md +441 -0
  21. package/guides/14-cli-and-tooling.md +52 -0
  22. package/guides/15-production.md +57 -0
  23. package/package.json +64 -50
  24. package/src/assets/README.md +118 -12
  25. package/src/async-context-middleware/README.md +6 -6
  26. package/src/auth/README.md +10 -6
  27. package/src/auth-middleware/README.md +7 -7
  28. package/src/cli/README.md +2 -0
  29. package/src/compression-middleware/README.md +8 -6
  30. package/src/cookie/README.md +5 -3
  31. package/src/cop-middleware/README.md +6 -6
  32. package/src/cors-middleware/README.md +10 -5
  33. package/src/csrf-middleware/README.md +21 -13
  34. package/src/data-table/README.md +4 -4
  35. package/src/data-table-mysql/README.md +5 -5
  36. package/src/data-table-postgres/README.md +5 -5
  37. package/src/data-table-sqlite/README.md +5 -5
  38. package/src/fetch-proxy/README.md +38 -3
  39. package/src/fetch-router/README.md +17 -15
  40. package/src/fetch-router.ts +1 -3
  41. package/src/file-storage/README.md +3 -3
  42. package/src/file-storage-s3/README.md +3 -3
  43. package/src/form-data-middleware/README.md +8 -5
  44. package/src/form-data-parser/README.md +13 -7
  45. package/src/fs/README.md +4 -4
  46. package/src/headers/README.md +8 -2
  47. package/src/html-template/README.md +1 -1
  48. package/src/index.ts +18 -0
  49. package/src/lazy-file/README.md +2 -2
  50. package/src/logger-middleware/README.md +1 -1
  51. package/src/method-override-middleware/README.md +3 -3
  52. package/src/multipart-parser/README.md +26 -5
  53. package/src/multiple-import-maps-polyfill/README.md +2 -2
  54. package/src/node-fetch-server/README.md +3 -1
  55. package/src/node-hmr/README.md +16 -7
  56. package/src/render-middleware/README.md +5 -5
  57. package/src/response/README.md +251 -0
  58. package/src/route-pattern/README.md +5 -1
  59. package/src/session/README.md +4 -4
  60. package/src/session-middleware/README.md +12 -4
  61. package/src/session-storage-memcache/README.md +3 -3
  62. package/src/session-storage-redis/README.md +1 -1
  63. package/src/spa/README.md +3 -3
  64. package/src/static-middleware/README.md +15 -3
  65. package/src/tar-parser/README.md +54 -1
  66. package/src/terminal/README.md +2 -2
  67. package/src/test/README.md +14 -4
  68. package/src/ui/README.md +36 -8
  69. package/src/ui/anchor/README.md +8 -8
  70. package/src/ui/animation/README.md +2 -0
  71. package/src/ui-hmr/README.md +4 -4
  72. package/src/ui/accordion/primitives/README.md +0 -202
  73. package/src/ui/combobox/primitives/README.md +0 -194
  74. package/src/ui/menu/primitives/README.md +0 -161
  75. package/src/ui/select/primitives/README.md +0 -117
  76. package/src/ui/tabs/primitives/README.md +0 -141
  77. package/src/ui/toggle/primitives/README.md +0 -56
package/INDEX.md ADDED
@@ -0,0 +1,94 @@
1
+ # Remix Documentation Index
2
+
3
+ Search this generated index by task, export name, or description. Use the guides for app workflows and the package READMEs for API details that match the installed Remix version.
4
+
5
+ ## Guides
6
+
7
+ | Guide | Description |
8
+ | --- | --- |
9
+ | [Start Here](guides/01-start-here.md) | A high-level introduction to Remix and the mental model behind a Remix application. |
10
+ | [Routing and Controllers](guides/02-routing-and-controllers.md) | How route maps, route helpers, controllers, actions, and responses define Remix request handling. |
11
+ | [Request Handling](guides/03-request-handling.md) | How a Web Request becomes a Web Response across runtime adapters and the middleware pipeline. |
12
+ | [Rendering UI](guides/04-rendering-ui.md) | How to build pages from Remix components, props, context, document shells, styles, and first-party UI. |
13
+ | [Interactivity](guides/05-interactivity.md) | How server-rendered UI hydrates, handles events, connects components to application models, navigates, and cancels stale work. |
14
+ | [Streaming UI with Frames](guides/06-streaming-ui-with-frames.md) | How to stream and reload route-owned UI with Frame, fallbacks, and server and browser frame resolvers. |
15
+ | [Animation](guides/07-animation.md) | The CSS-first animation model and Remix UI helpers for motion that respects rendering state. |
16
+ | [Data and Validation](guides/08-data-and-validation.md) | How Remix validates inputs, defines relational data, queries databases, and runs SQL migrations. |
17
+ | [Forms and Mutations](guides/09-forms-and-mutations.md) | How native forms, action responses, validation failures, redirects, and enhanced mutations fit together. |
18
+ | [Auth, Sessions, and Security](guides/10-auth-sessions-security.md) | How Remix stores per-browser state, resolves identity, protects routes, and defends browser request boundaries. |
19
+ | [Files and Assets](guides/11-files-and-assets.md) | How Remix serves static files and source assets, accepts bounded uploads, stores files, and returns HTTP file responses. |
20
+ | [Errors and Cancellation](guides/12-errors-and-cancellation.md) | How expected HTTP failures, uncaught server errors, rendering failures, client runtime errors, and aborted work propagate through Remix. |
21
+ | [Testing](guides/13-testing.md) | How to choose a test boundary and test Remix routes, stateful request flows, components, and end-to-end behavior. |
22
+ | [CLI and Tooling](guides/14-cli-and-tooling.md) | The Remix command-line workflow for creating, inspecting, testing, checking, and running TypeScript projects. |
23
+ | [Production](guides/15-production.md) | How to configure, start, cache, observe, and shut down a Remix application in production. |
24
+
25
+ ## Package APIs
26
+
27
+ Exports covered by the same README are grouped together.
28
+
29
+ | Exports | Description | Docs |
30
+ | --- | --- | --- |
31
+ | `remix/assert` | Node assert-compatible utilities for any JavaScript environment | [README](src/assert/README.md) |
32
+ | `remix/assets`<br>`remix/assets/types/hmr` | Fetch-based server for compiling browser JS/TS and CSS assets on demand | [README](src/assets/README.md) |
33
+ | `remix/auth` | Browser login, OAuth, and OIDC helpers for Remix | [README](src/auth/README.md) |
34
+ | `remix/cookie` | A toolkit for working with cookies in JavaScript | [README](src/cookie/README.md) |
35
+ | `remix/data-schema`<br>`remix/data-schema/checks`<br>`remix/data-schema/coerce`<br>`remix/data-schema/form-data`<br>`remix/data-schema/lazy` | Tiny, standards-aligned schema validation | [README](src/data-schema/README.md) |
36
+ | `remix/data-table`<br>`remix/data-table/cli`<br>`remix/data-table/migrations`<br>`remix/data-table/migrations/node`<br>`remix/data-table/operators`<br>`remix/data-table/sql-helpers` | A typed, relational query toolkit for JavaScript | [README](src/data-table/README.md) |
37
+ | `remix/data-table/mysql` | MySQL database implementation for remix/data-table | [README](src/data-table-mysql/README.md) |
38
+ | `remix/data-table/postgres` | PostgreSQL database implementation for remix/data-table | [README](src/data-table-postgres/README.md) |
39
+ | `remix/data-table/sqlite` | SQLite database implementation for remix/data-table | [README](src/data-table-sqlite/README.md) |
40
+ | `remix/fetch-proxy` | An HTTP proxy for the web Fetch API | [README](src/fetch-proxy/README.md) |
41
+ | `remix/file-storage`<br>`remix/file-storage/fs`<br>`remix/file-storage/memory` | Key/value storage for JavaScript File objects | [README](src/file-storage/README.md) |
42
+ | `remix/file-storage/s3` | S3 backend for remix/file-storage | [README](src/file-storage-s3/README.md) |
43
+ | `remix/form-data-parser` | A request.formData() wrapper with streaming file upload handling | [README](src/form-data-parser/README.md) |
44
+ | `remix/fs` | Filesystem utilities using the Web File API | [README](src/fs/README.md) |
45
+ | `remix/headers`<br>`remix/headers/accept`<br>`remix/headers/accept-encoding`<br>`remix/headers/accept-language`<br>`remix/headers/cache-control`<br>`remix/headers/content-disposition`<br>`remix/headers/content-range`<br>`remix/headers/content-type`<br>`remix/headers/cookie`<br>`remix/headers/if-match`<br>`remix/headers/if-none-match`<br>`remix/headers/if-range`<br>`remix/headers/range`<br>`remix/headers/raw-headers`<br>`remix/headers/set-cookie`<br>`remix/headers/vary` | A toolkit for working with HTTP headers in JavaScript | [README](src/headers/README.md) |
46
+ | `remix/html-template` | HTML template tag with auto-escaping for JavaScript | [README](src/html-template/README.md) |
47
+ | `remix/lazy-file` | Lazy, streaming files for JavaScript | [README](src/lazy-file/README.md) |
48
+ | `remix/middleware/async-context` | Middleware for storing request context in AsyncLocalStorage | [README](src/async-context-middleware/README.md) |
49
+ | `remix/middleware/auth` | Pluggable authentication middleware for Remix | [README](src/auth-middleware/README.md) |
50
+ | `remix/middleware/compression` | Middleware for compressing HTTP responses | [README](src/compression-middleware/README.md) |
51
+ | `remix/middleware/cop` | Middleware for tokenless cross-origin protection in Fetch API servers | [README](src/cop-middleware/README.md) |
52
+ | `remix/middleware/cors` | Middleware for handling CORS in Fetch API servers | [README](src/cors-middleware/README.md) |
53
+ | `remix/middleware/csrf` | Middleware for CSRF protection in Fetch API servers | [README](src/csrf-middleware/README.md) |
54
+ | `remix/middleware/form-data` | Middleware for parsing FormData from request bodies | [README](src/form-data-middleware/README.md) |
55
+ | `remix/middleware/logger` | Middleware for logging HTTP requests and responses | [README](src/logger-middleware/README.md) |
56
+ | `remix/middleware/method-override` | Middleware for overriding HTTP request methods from form data | [README](src/method-override-middleware/README.md) |
57
+ | `remix/middleware/render` | Conventional Remix UI and custom request-scoped render middleware | [README](src/render-middleware/README.md) |
58
+ | `remix/middleware/session` | Middleware for managing sessions with cookie-based storage | [README](src/session-middleware/README.md) |
59
+ | `remix/middleware/static` | Middleware for serving static files from the filesystem | [README](src/static-middleware/README.md) |
60
+ | `remix/mime` | Utilities for working with MIME types | [README](src/mime/README.md) |
61
+ | `remix/multipart-parser`<br>`remix/multipart-parser/node` | A fast, efficient parser for multipart streams in any JavaScript environment | [README](src/multipart-parser/README.md) |
62
+ | `remix/multiple-import-maps-polyfill` | Polyfill for dynamic JavaScript imports that depend on import maps added at runtime | [README](src/multiple-import-maps-polyfill/README.md) |
63
+ | `remix/node-fetch-server`<br>`remix/node-fetch-server/test` | Build servers for Node.js using the web fetch API | [README](src/node-fetch-server/README.md) |
64
+ | `remix/node-hmr`<br>`remix/node-hmr/runtime`<br>`remix/node-hmr/types` | Run Node.js applications with Hot Module Reloading | [README](src/node-hmr/README.md) |
65
+ | `remix/node-tsx`<br>`remix/node-tsx/load-module` | Run Node.js with TypeScript and JSX syntax support | [README](src/node-tsx/README.md) |
66
+ | `remix/response/compress`<br>`remix/response/file`<br>`remix/response/html`<br>`remix/response/redirect` | Response helpers for the web Fetch API | [README](src/response/README.md) |
67
+ | `remix/route-pattern`<br>`remix/route-pattern/href`<br>`remix/route-pattern/join`<br>`remix/route-pattern/match`<br>`remix/route-pattern/specificity` | Match and generate URLs with strong typing | [README](src/route-pattern/README.md) |
68
+ | `remix/router`<br>`remix/routes` | A minimal, composable router for the web Fetch API | [README](src/fetch-router/README.md) |
69
+ | `remix/session`<br>`remix/session-storage/cookie`<br>`remix/session-storage/fs`<br>`remix/session-storage/memory` | Session management for JavaScript | [README](src/session/README.md) |
70
+ | `remix/session-storage/memcache` | Memcache session storage for remix/session | [README](src/session-storage-memcache/README.md) |
71
+ | `remix/session-storage/redis` | Redis session storage for remix/session | [README](src/session-storage-redis/README.md) |
72
+ | `remix/spa` | Client-rendered application routing for Remix | [README](src/spa/README.md) |
73
+ | `remix/tar-parser` | A fast, efficient parser for tar streams in any JavaScript environment | [README](src/tar-parser/README.md) |
74
+ | `remix/terminal` | Terminal output utilities for JavaScript libraries and CLIs | [README](src/terminal/README.md) |
75
+ | `remix/test`<br>`remix/test/cli` | A test framework for JavaScript and TypeScript projects | [README](src/test/README.md) |
76
+ | `remix/ui`<br>`remix/ui/dev/refresh`<br>`remix/ui/jsx-dev-runtime`<br>`remix/ui/jsx-runtime` | UI runtime, headless primitives, and styled components for Remix | [README](src/ui/README.md) |
77
+ | `remix/ui-hmr`<br>`remix/ui-hmr/assets`<br>`remix/ui-hmr/node`<br>`remix/ui-hmr/runtime/browser`<br>`remix/ui-hmr/runtime/server` | Hot module replacement runtime and transforms for Remix UI components | [README](src/ui-hmr/README.md) |
78
+ | `remix/ui/accordion`<br>`remix/ui/accordion/primitives` | UI runtime, headless primitives, and styled components for Remix | [README](src/ui/accordion/README.md) |
79
+ | `remix/ui/anchor` | UI runtime, headless primitives, and styled components for Remix | [README](src/ui/anchor/README.md) |
80
+ | `remix/ui/animation` | UI runtime, headless primitives, and styled components for Remix | [README](src/ui/animation/README.md) |
81
+ | `remix/ui/breadcrumbs` | UI runtime, headless primitives, and styled components for Remix | [README](src/ui/breadcrumbs/README.md) |
82
+ | `remix/ui/button` | UI runtime, headless primitives, and styled components for Remix | [README](src/ui/button/README.md) |
83
+ | `remix/ui/checkbox` | UI runtime, headless primitives, and styled components for Remix | [README](src/ui/checkbox/README.md) |
84
+ | `remix/ui/combobox`<br>`remix/ui/combobox/primitives` | UI runtime, headless primitives, and styled components for Remix | [README](src/ui/combobox/README.md) |
85
+ | `remix/ui/input` | UI runtime, headless primitives, and styled components for Remix | [README](src/ui/input/README.md) |
86
+ | `remix/ui/listbox` | UI runtime, headless primitives, and styled components for Remix | [README](src/ui/listbox/README.md) |
87
+ | `remix/ui/menu`<br>`remix/ui/menu/primitives` | UI runtime, headless primitives, and styled components for Remix | [README](src/ui/menu/README.md) |
88
+ | `remix/ui/popover` | UI runtime, headless primitives, and styled components for Remix | [README](src/ui/popover/README.md) |
89
+ | `remix/ui/radio` | UI runtime, headless primitives, and styled components for Remix | [README](src/ui/radio/README.md) |
90
+ | `remix/ui/select`<br>`remix/ui/select/primitives` | UI runtime, headless primitives, and styled components for Remix | [README](src/ui/select/README.md) |
91
+ | `remix/ui/server` | UI runtime, headless primitives, and styled components for Remix | [README](src/ui/server/README.md) |
92
+ | `remix/ui/tabs`<br>`remix/ui/tabs/primitives` | UI runtime, headless primitives, and styled components for Remix | [README](src/ui/tabs/README.md) |
93
+ | `remix/ui/test` | UI runtime, headless primitives, and styled components for Remix | [README](src/ui/test/README.md) |
94
+ | `remix/ui/toggle`<br>`remix/ui/toggle/primitives` | UI runtime, headless primitives, and styled components for Remix | [README](src/ui/toggle/README.md) |
@@ -1,7 +1,5 @@
1
+ import type { RouterTypes as RemixRouterTypes } from './index.ts';
1
2
  export * from '@remix-run/fetch-router';
2
- export interface RouterTypes {
3
- }
4
- type RemixRouterTypes = RouterTypes;
5
3
  declare module '@remix-run/fetch-router' {
6
4
  interface RouterTypes extends RemixRouterTypes {
7
5
  }
@@ -1 +1 @@
1
- {"version":3,"file":"fetch-router.d.ts","sourceRoot":"","sources":["../src/fetch-router.ts"],"names":[],"mappings":"AACA,cAAc,yBAAyB,CAAA;AAEvC,MAAM,WAAW,WAAW;CAAG;AAC/B,KAAK,gBAAgB,GAAG,WAAW,CAAA;AAEnC,OAAO,QAAQ,yBAAyB,CAAC;IACvC,UAAU,WAAY,SAAQ,gBAAgB;KAAG;CAClD"}
1
+ {"version":3,"file":"fetch-router.d.ts","sourceRoot":"","sources":["../src/fetch-router.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,IAAI,gBAAgB,EAAE,MAAM,YAAY,CAAA;AACjE,cAAc,yBAAyB,CAAA;AAEvC,OAAO,QAAQ,yBAAyB,CAAC;IACvC,UAAU,WAAY,SAAQ,gBAAgB;KAAG;CAClD"}
@@ -1,2 +1 @@
1
- // IMPORTANT: This file is auto-generated, please do not edit manually.
2
1
  export * from '@remix-run/fetch-router';
@@ -0,0 +1,18 @@
1
+ // IMPORTANT: This file is auto-generated, please do not edit manually.
2
+ /**
3
+ * Ambient router type configuration for application-wide defaults.
4
+ *
5
+ * Apps may augment this interface to define the default request context used by
6
+ * `createAction()`, `createController()`, and `getContext()`.
7
+ * Apps with multiple routers should pass explicit context types instead.
8
+ *
9
+ * @example
10
+ * ```ts
11
+ * declare module 'remix' {
12
+ * interface RouterTypes {
13
+ * context: AppContext
14
+ * }
15
+ * }
16
+ * ```
17
+ */
18
+ export interface RouterTypes {}
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,WAAW;CAAG"}
package/dist/index.js ADDED
@@ -0,0 +1 @@
1
+ export {};