weifuwu 0.27.25 → 0.27.26

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 (31) hide show
  1. package/README.md +17 -16
  2. package/dist/cli.js +6 -23
  3. package/dist/core/router.d.ts +16 -0
  4. package/dist/index.d.ts +1 -19
  5. package/dist/index.js +49 -600
  6. package/dist/types.d.ts +27 -7
  7. package/package.json +5 -9
  8. package/dist/docs/ssr/ui.md +0 -472
  9. package/dist/middleware/csrf.d.ts +0 -47
  10. package/dist/middleware/flash.d.ts +0 -90
  11. package/dist/middleware/i18n.d.ts +0 -39
  12. package/dist/middleware/theme.d.ts +0 -31
  13. package/dist/ssr/assets.d.ts +0 -5
  14. package/dist/ssr/compile.d.ts +0 -21
  15. package/dist/ssr/css.d.ts +0 -16
  16. package/dist/ssr/html.d.ts +0 -53
  17. package/dist/ssr/layout.d.ts +0 -2
  18. package/dist/ssr/ui/assets.d.ts +0 -4
  19. package/dist/ssr/view.d.ts +0 -36
  20. package/dist/template/AGENTS.md +0 -28
  21. package/dist/template/app.ts +0 -20
  22. package/dist/template/index.ts +0 -6
  23. package/dist/template/locales/en.json +0 -7
  24. package/dist/template/locales/zh-CN.json +0 -7
  25. package/dist/template/package.json +0 -11
  26. package/dist/template/tsconfig.json +0 -15
  27. package/dist/template/ui/app/globals.css +0 -2
  28. package/dist/template/ui/app/layout.ts +0 -39
  29. package/dist/template/ui/app/page.ts +0 -39
  30. package/dist/weifuwu-ui.css +0 -646
  31. package/dist/weifuwu-ui.js +0 -998
package/README.md CHANGED
@@ -66,7 +66,7 @@ app.use(rateLimit({ window: 60 }))
66
66
  ## Full-stack SSR
67
67
 
68
68
  Server-rendered HTML with zero frontend build tools. Uses `html()` tagged templates
69
- for safe HTML rendering, and `weifuwu-ui.js` for client-side interactions.
69
+ for safe HTML rendering, and **HTMX + Alpine.js + weifuwu-ui** for client-side interactions.
70
70
 
71
71
  ```ts
72
72
  import { Router, serve, html, raw, layout, view, wfuwAssets, wfuwVersion, theme, i18n, flash } from 'weifuwu'
@@ -78,7 +78,7 @@ app.use(theme())
78
78
  app.use(i18n({ dir: './locales' }))
79
79
  app.use(flash())
80
80
 
81
- // weifuwu-ui frontend runtime
81
+ // HTMX + Alpine.js + weifuwu-ui frontend assets
82
82
  app.use('/', wfuwAssets())
83
83
 
84
84
  // Layout (wraps all pages)
@@ -134,8 +134,10 @@ export default function (body: string, ctx: any) {
134
134
  <head>
135
135
  <meta charset="utf-8" />
136
136
  <link rel="stylesheet" href="/__wfw/css/weifuwu-ui.css?v=${wfuwVersion}" />
137
+ <script src="/__wfw/js/htmx.min.js?v=${wfuwVersion}"></script>
138
+ <script defer src="/__wfw/js/alpine.min.js?v=${wfuwVersion}"></script>
137
139
  <script src="/__wfw/js/weifuwu-ui.js?v=${wfuwVersion}"></script>
138
- <script id="__wfw-i18n" type="application/json">
140
+ <script id="__wf-i18n" type="application/json">
139
141
  ${raw(JSON.stringify(ctx.i18n?.messages || {}))}
140
142
  </script>
141
143
  </head>
@@ -160,16 +162,14 @@ export default function (ctx: any) {
160
162
  }
161
163
  ```
162
164
 
163
- ### UI frontend runtime (weifuwu-ui)
165
+ ### UI frontend runtime
164
166
 
165
- weifuwu-ui is a zero-dependency frontend runtime (~5KB) that ships with weifuwu.
166
- One `<script>` + `<link>` covers AJAX loading, state binding, SSE streaming,
167
- WebSocket, theme/i18n/flash integration, and UI components.
167
+ weifuwu ships with **HTMX** (AJAX, SSE, WebSocket, forms) + **Alpine.js** (state, DOM
168
+ binding, UI components) + **weifuwu-ui** (Alpine stores for theme/i18n/flash).
168
169
 
169
170
  ```ts
170
171
  import { wfuwAssets } from 'weifuwu'
171
-
172
- app.use(wfuwAssets()) // serve /__wfw/js/weifuwu-ui.js + /__wfw/css/weifuwu-ui.css
172
+ app.use(wfuwAssets()) // serve htmx.min.js + alpine.min.js + weifuwu-ui.js
173
173
  ```
174
174
 
175
175
  In your layout (with cache-busting via `wfuwVersion`):
@@ -179,6 +179,8 @@ import { wfuwVersion } from 'weifuwu'
179
179
  ```
180
180
 
181
181
  ```html
182
+ <script src="/__wfw/js/htmx.min.js?v=${wfuwVersion}"></script>
183
+ <script defer src="/__wfw/js/alpine.min.js?v=${wfuwVersion}"></script>
182
184
  <script src="/__wfw/js/weifuwu-ui.js?v=${wfuwVersion}"></script>
183
185
  <link rel="stylesheet" href="/__wfw/css/weifuwu-ui.css?v=${wfuwVersion}" />
184
186
  ```
@@ -560,9 +562,7 @@ app.get('/', view('./ui/app/page.ts'))
560
562
 
561
563
  #### wfuwAssets()
562
564
 
563
- Serve weifuwu-ui.js and weifuwu-ui.css — zero-dependency frontend runtime (~5KB total).
564
- Covers: AJAX loading, state binding, SSE streaming, WebSocket, theme/i18n/flash,
565
- modal/collapse/tabs/dropdown/toast components.
565
+ Serve HTMX, Alpine.js, and weifuwu-ui (Alpine stores for theme/i18n/flash).
566
566
 
567
567
  ```ts
568
568
  import { wfuwAssets } from 'weifuwu'
@@ -574,6 +574,8 @@ import { wfuwVersion } from 'weifuwu'
574
574
  ```
575
575
 
576
576
  ```html
577
+ <script src="/__wfw/js/htmx.min.js?v=${wfuwVersion}"></script>
578
+ <script defer src="/__wfw/js/alpine.min.js?v=${wfuwVersion}"></script>
577
579
  <script src="/__wfw/js/weifuwu-ui.js?v=${wfuwVersion}"></script>
578
580
  <link rel="stylesheet" href="/__wfw/css/weifuwu-ui.css?v=${wfuwVersion}" />
579
581
  ```
@@ -702,9 +704,8 @@ Creates a minimal API project with `app.ts`, `index.ts`, and TypeScript config.
702
704
 
703
705
  ### Frontend
704
706
 
705
- - weifuwu-ui.js (~5KB) — built-in, zero external dependencies
706
-
707
- Covers: AJAX loading, state binding, SSE streaming, WebSocket, theme/i18n/flash,
708
- modal/collapse/tabs/dropdown/toast components.
707
+ - **HTMX** (~14KB) — AJAX loading, SSE, WebSocket, form submission
708
+ - **Alpine.js** (~15KB) — state management, DOM binding, UI components
709
+ - **weifuwu-ui** (~2KB) — Alpine stores for theme/i18n/flash/toast
709
710
 
710
711
  Zero build tools. Zero frontend framework compilation.
package/dist/cli.js CHANGED
@@ -1,7 +1,7 @@
1
1
  #!/usr/bin/env node
2
2
 
3
3
  // cli.ts
4
- import { mkdir, writeFile, readFile, cp } from "node:fs/promises";
4
+ import { mkdir, writeFile } from "node:fs/promises";
5
5
  import { existsSync } from "node:fs";
6
6
  import { execSync } from "node:child_process";
7
7
  import { join, dirname, resolve } from "node:path";
@@ -28,11 +28,7 @@ async function cmdInit(name, opts) {
28
28
  process.exit(1);
29
29
  }
30
30
  const pkg = await readPkg();
31
- if (opts.minimal) {
32
- await generateMinimal(targetDir, name, pkg.version, opts.skipInstall);
33
- } else {
34
- await generateFull(targetDir, name, pkg.version, opts.skipInstall);
35
- }
31
+ await generateMinimal(targetDir, name, pkg.version, opts.skipInstall);
36
32
  }
37
33
  async function generateMinimal(targetDir, name, version, skipInstall) {
38
34
  await mkdir(targetDir, { recursive: true });
@@ -64,17 +60,6 @@ async function generateMinimal(targetDir, name, version, skipInstall) {
64
60
  await writeCommonFiles(targetDir);
65
61
  await finishInit(targetDir, skipInstall);
66
62
  }
67
- async function generateFull(targetDir, name, version, skipInstall) {
68
- const templateDir = existsSync(join(__dirname, "cli", "template")) ? join(__dirname, "cli", "template") : join(__dirname, "template");
69
- await cp(templateDir, targetDir, { recursive: true });
70
- const pkgPath = join(targetDir, "package.json");
71
- const pkgContent = await readFile(pkgPath, "utf-8");
72
- await writeFile(
73
- pkgPath,
74
- pkgContent.replace("__PROJECT_NAME__", name).replace("__VERSION__", version)
75
- );
76
- await finishInit(targetDir, skipInstall);
77
- }
78
63
  async function writePackageJson(targetDir, name, version, extra) {
79
64
  const pkg = {
80
65
  name,
@@ -107,8 +92,7 @@ var HELP = `
107
92
  weifuwu \u2014 Web-standard HTTP microframework for Node.js
108
93
 
109
94
  Usage:
110
- npx weifuwu init <name> Create a new project (SSR + shadcn UI)
111
- npx weifuwu init <name> --minimal Create a minimal API-only project
95
+ npx weifuwu init <name> Create a new project
112
96
  npx weifuwu init <name> --skip-install Skip npm install
113
97
  npx weifuwu version Print version
114
98
  `;
@@ -118,18 +102,17 @@ if (cmd === "version" || cmd === "-v" || cmd === "--version") {
118
102
  const { values, positionals } = parseArgs({
119
103
  args: process.argv.slice(3),
120
104
  options: {
121
- "skip-install": { type: "boolean" },
122
- minimal: { type: "boolean" }
105
+ "skip-install": { type: "boolean" }
123
106
  },
124
107
  strict: false,
125
108
  allowPositionals: true
126
109
  });
127
110
  const name = positionals[0];
128
111
  if (!name) {
129
- console.error("Usage: npx weifuwu init <name> [--skip-install] [--minimal]");
112
+ console.error("Usage: npx weifuwu init <name> [--skip-install]");
130
113
  process.exit(1);
131
114
  }
132
- cmdInit(name, { skipInstall: !!values["skip-install"], minimal: !!values["minimal"] }).catch(
115
+ cmdInit(name, { skipInstall: !!values["skip-install"] }).catch(
133
116
  console.error
134
117
  );
135
118
  } else {
package/dist/core/router.d.ts CHANGED
@@ -2,6 +2,22 @@ import type { WebSocket, Context, Handler, Middleware, ErrorHandler } from '../t
2
2
  import { type IncomingMessage } from 'node:http';
3
3
  import type { Duplex } from 'node:stream';
4
4
  import { type Hub } from '../hub.ts';
5
+ declare module '../types.ts' {
6
+ interface Context {
7
+ ws: {
8
+ /** Per-connection state object */
9
+ state: Record<string, unknown>;
10
+ /** Send JSON to this connection */
11
+ json(data: unknown): void;
12
+ /** Join a room */
13
+ join(room: string): void;
14
+ /** Leave a room */
15
+ leave(room: string): void;
16
+ /** Broadcast to a room */
17
+ sendRoom(room: string, data: unknown): void;
18
+ };
19
+ }
20
+ }
5
21
  export type WebSocketHandler = {
6
22
  open?: (ws: WebSocket, ctx: Context) => void | Promise<void>;
7
23
  message?: (ws: WebSocket, ctx: Context, data: string | Buffer) => void | Promise<void>;
package/dist/index.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- export type { Context, Handler, Middleware, ErrorHandler } from './types.ts';
1
+ export type { Context, Handler, Middleware, ErrorHandler, WsContext } from './types.ts';
2
2
  export { HttpError } from './types.ts';
3
3
  export { currentTraceId, currentTrace, runWithTrace, traceElapsed, trace } from './core/trace.ts';
4
4
  export type { TraceContext, TraceInjected, TraceOptions } from './core/trace.ts';
@@ -49,21 +49,3 @@ export { queue } from './queue/index.ts';
49
49
  export type { QueueOptions, QueueJob, Queue, QueueInjected } from './queue/types.ts';
50
50
  export { health } from './middleware/health.ts';
51
51
  export type { HealthOptions } from './middleware/health.ts';
52
- export { theme } from './middleware/theme.ts';
53
- export type { ThemeOptions, ThemeInjected } from './middleware/theme.ts';
54
- export { i18n } from './middleware/i18n.ts';
55
- export type { I18nOptions, I18nInjected } from './middleware/i18n.ts';
56
- export { flash } from './middleware/flash.ts';
57
- export type { FlashOptions, FlashInjected, FlashModule } from './middleware/flash.ts';
58
- export { csrf } from './middleware/csrf.ts';
59
- export type { CsrfOptions, CsrfInjected, CsrfModule } from './middleware/csrf.ts';
60
- export { html, raw } from './ssr/html.ts';
61
- export type { RawString } from './ssr/html.ts';
62
- export { layout } from './ssr/layout.ts';
63
- export { view } from './ssr/view.ts';
64
- export type { ViewOptions } from './ssr/view.ts';
65
- export { loadModule, clearModuleCache } from './ssr/compile.ts';
66
- export { cssContext, cssRouter, clearCSSCache } from './ssr/css.ts';
67
- export type { CssAsset } from './ssr/css.ts';
68
- export { assetRouter, assetScripts } from './ssr/assets.ts';
69
- export { wfuwAssets, wfuwVersion } from './ssr/ui/assets.ts';