weifuwu 0.92.0 → 0.93.0

package/dist/server/index.js

@@ -270,8 +270,8 @@ async function sendResponse(res, response, opts) {
   res.writeHead(response.status, response.statusText, headers);
   if (response.body) {
     const reader = response.body.getReader();
-    const closed = new Promise((resolve3) => {
-      res.once("close", () => resolve3("closed"));
+    const closed = new Promise((resolve4) => {
+      res.once("close", () => resolve4("closed"));
     });
     res.on("error", () => {
     });
@@ -291,7 +291,7 @@ async function sendResponse(res, response, opts) {
         if (done) break;
         if (!res.write(value)) {
           const drained = new Promise(
-            (resolve3) => res.once("drain", () => resolve3("drain"))
+            (resolve4) => res.once("drain", () => resolve4("drain"))
           );
           if (await Promise.race([drained, closed]) === "closed") {
             await cancelStream();
@@ -1486,15 +1486,15 @@ var Router = class _Router {
         } catch {
         }
       }
-      await new Promise((resolve3) => {
+      await new Promise((resolve4) => {
         let remaining = clients.length;
         const done = () => {
           if (--remaining === 0) {
             clearTimeout(timer);
-            resolve3();
+            resolve4();
           }
         };
-        const timer = setTimeout(resolve3, 500);
+        const timer = setTimeout(resolve4, 500);
         for (const c of clients) c.once("close", done);
       });
     }
@@ -2012,7 +2012,7 @@ async function MemoryEmailServer(options = {}) {
       res.end(JSON.stringify({ error: err instanceof Error ? err.message : String(err) }));
     });
   });
-  await new Promise((resolve3) => server.listen(options.port ?? 0, "127.0.0.1", resolve3));
+  await new Promise((resolve4) => server.listen(options.port ?? 0, "127.0.0.1", resolve4));
   const port = server.address().port;
   return {
     port,
@@ -2020,7 +2020,7 @@ async function MemoryEmailServer(options = {}) {
     emails,
     requests,
     closeAllConnections: () => server.closeAllConnections(),
-    close: () => new Promise((resolve3, reject) => server.close((e) => e ? reject(e) : resolve3()))
+    close: () => new Promise((resolve4, reject) => server.close((e) => e ? reject(e) : resolve4()))
   };
 }
 
@@ -5337,7 +5337,7 @@ function messager(options) {
   function sendTo(userId, event) {
     broadcast(`user:${userId}`, event);
   }
-  function join(room, ws2) {
+  function join2(room, ws2) {
     let members = rooms.get(room);
     if (!members) {
       members = /* @__PURE__ */ new Set();
@@ -5395,7 +5395,7 @@ function messager(options) {
                 return;
               }
             }
-            join(msg.room, ws2);
+            join2(msg.room, ws2);
             ws2.send(JSON.stringify({ type: "subscribed", room: msg.room }));
           } else if (msg.type === "unsubscribe" && msg.room) {
             leave(msg.room, ws2);
@@ -5428,7 +5428,7 @@ function messager(options) {
     handler,
     broadcast,
     sendTo,
-    join,
+    join: join2,
     leave,
     close,
     createConversation,
@@ -9487,23 +9487,23 @@ function createAiClient(opts) {
   }
   const approvals = /* @__PURE__ */ new Map();
   function approve(response) {
-    const resolve3 = approvals.get(response.id);
-    if (!resolve3) return false;
+    const resolve4 = approvals.get(response.id);
+    if (!resolve4) return false;
     approvals.delete(response.id);
-    resolve3(response);
+    resolve4(response);
     return true;
   }
   async function waitApproval(req, emit, timeoutMs = DEFAULT_APPROVAL_TIMEOUT, signal) {
     const expiresAt = Date.now() + timeoutMs;
     emit("wf:approval_request", { ...req, expiresAt });
-    return new Promise((resolve3) => {
+    return new Promise((resolve4) => {
       let settled = false;
       const finish = (resp) => {
         if (settled) return;
         settled = true;
         clearTimeout(timer);
         signal?.removeEventListener("abort", onAbort);
-        resolve3(resp);
+        resolve4(resp);
       };
       const timer = setTimeout(() => {
         if (approvals.has(req.id)) approvals.delete(req.id);
@@ -9975,23 +9975,23 @@ function createApprovalHub(timeoutMs = DEFAULT_APPROVAL_TIMEOUT2) {
   const approvals = /* @__PURE__ */ new Map();
   return {
     approve(response) {
-      const resolve3 = approvals.get(response.id);
-      if (!resolve3) return false;
+      const resolve4 = approvals.get(response.id);
+      if (!resolve4) return false;
       approvals.delete(response.id);
-      resolve3(response);
+      resolve4(response);
       return true;
     },
     async waitApproval(req, emit, timeout = timeoutMs, signal) {
       const expiresAt = Date.now() + timeout;
       emit("wf:approval_request", { ...req, expiresAt });
-      return new Promise((resolve3) => {
+      return new Promise((resolve4) => {
         let settled = false;
         const finish = (resp) => {
           if (settled) return;
           settled = true;
           clearTimeout(timer);
           signal?.removeEventListener("abort", onAbort);
-          resolve3(resp);
+          resolve4(resp);
         };
         const timer = setTimeout(() => {
           if (approvals.has(req.id)) approvals.delete(req.id);
@@ -10205,7 +10205,7 @@ async function MemoryAiServer(options = {}) {
       }
     });
   });
-  await new Promise((resolve3) => server.listen(options.port ?? 0, "127.0.0.1", resolve3));
+  await new Promise((resolve4) => server.listen(options.port ?? 0, "127.0.0.1", resolve4));
   const addr = server.address();
   const port = typeof addr === "object" && addr ? addr.port : 0;
   return {
@@ -10213,7 +10213,7 @@ async function MemoryAiServer(options = {}) {
     url: `http://127.0.0.1:${port}`,
     requests,
     closeAllConnections: () => server.closeAllConnections(),
-    close: () => new Promise((resolve3) => server.close(() => resolve3()))
+    close: () => new Promise((resolve4) => server.close(() => resolve4()))
   };
 }
 async function readJson(req) {
@@ -10304,11 +10304,98 @@ async function handle(ai, method, url, req, res, preBody) {
 
 // src/server/ui/index.ts
 import { build } from "esbuild";
-import { readFile, stat as stat2 } from "node:fs/promises";
+import { readFile as readFile2, stat as stat2 } from "node:fs/promises";
 import { createHash as createHash2 } from "node:crypto";
-import { resolve as resolve2 } from "node:path";
+import { resolve as resolve3, dirname, basename } from "node:path";
 import { fileURLToPath } from "node:url";
 
+// src/client/layout/bundle.ts
+import { readFile, readdir } from "node:fs/promises";
+import { join, resolve as resolve2 } from "node:path";
+var LAYER_ORDER = ["tokens", "base", "layout", "components", "utilities"];
+var LAYER_OF = {
+  _tokens: "tokens",
+  _dark: "tokens",
+  _presets: "tokens",
+  _props: "tokens",
+  _base: "base",
+  _stack: "layout",
+  _row: "layout",
+  _split: "layout",
+  _center: "layout",
+  _justify: "layout",
+  _fill: "layout",
+  _grid: "layout",
+  _cluster: "layout",
+  _cover: "layout",
+  _position: "layout",
+  _sticky: "layout",
+  _overflow: "layout",
+  "_safe-area": "layout",
+  _layer: "layout",
+  "_align-self": "layout",
+  _nowrap: "layout",
+  _shrink: "layout",
+  _container: "layout",
+  "_app-shell": "layout",
+  _surface: "utilities",
+  _spacing: "utilities",
+  _border: "utilities",
+  _text: "utilities",
+  _hidden: "utilities",
+  _block: "utilities",
+  _flex: "utilities",
+  // display 工具族（基类 :where() 零优先级 + @media 变体正常优先级——变体恒胜基类，零 !important）
+  _popup: "layout"
+  // 框架内部浮层基类（popup-manager 消费——非用户词汇）
+};
+var TOKENS_LAYER = "tokens";
+var stripImports = (css) => css.replace(/@import\s+['"][^'"]+['"]\s*;?\s*\n?/g, "");
+async function layoutEntryFiles(layoutDir) {
+  const entry = await readFile(join(layoutDir, "weifuwu-layout.css"), "utf-8");
+  const files = [];
+  for (const line of entry.split("\n")) {
+    const m = line.match(/@import\s+['"]([^'"]+)['"]/);
+    if (m) files.push(m[1].replace(/^\.\//, ""));
+  }
+  if (!files.length) throw new Error(`layout \u5165\u53E3\u65E0 @import\uFF08${layoutDir}/weifuwu-layout.css\uFF09\u2014\u2014\u88C5\u914D\u5355\u6E90\u5931\u6548`);
+  return files;
+}
+async function isLayoutSourceDir(dir) {
+  try {
+    const entries = await readdir(dir);
+    return entries.includes("weifuwu-layout.css") && entries.some((f2) => /^_[a-z-]+\.css$/.test(f2));
+  } catch {
+    return false;
+  }
+}
+async function bundleLayout(layoutDir) {
+  const dir = resolve2(layoutDir);
+  const files = await layoutEntryFiles(dir);
+  const inputs = [join(dir, "weifuwu-layout.css")];
+  const chunks = [];
+  for (const f2 of files) {
+    const abs = join(dir, f2);
+    inputs.push(abs);
+    const content = stripImports(await readFile(abs, "utf-8")).trim();
+    const name = f2.replace(/\.css$/, "");
+    const layer = LAYER_OF[name];
+    if (!layer) {
+      throw new Error(`layout \u6587\u4EF6\u672A\u767B\u8BB0 @layer \u6620\u5C04: ${f2}\uFF08\u5728 src/client/layout/bundle.ts LAYER_OF \u4E2D\u767B\u8BB0\uFF09`);
+    }
+    chunks.push(layer === TOKENS_LAYER ? content : `@layer ${layer} {
+${content}
+}`);
+  }
+  const css = `/* weifuwu/layout \u2014 CSS \u5E03\u5C40\u539F\u8BED + \u8BBE\u8BA1 Token\uFF08\u88C5\u914D\u5355\u6E90\uFF1Asrc/client/layout/bundle.ts\uFF09 */
+
+@layer ${LAYER_ORDER.join(", ")};
+
+${chunks.join("\n\n")}
+`;
+  return { css, inputs };
+}
+
 // src/server/ui/html-safe.ts
 var HtmlSafe = class {
   value;
@@ -12892,11 +12979,11 @@ function openPopup(env, opts) {
       const registry = applier.registry;
       if (!registry) return;
       const ctx = env.getSharedContext() ?? {};
-      const cmds = await new Promise((resolve3, reject) => {
+      const cmds = await new Promise((resolve4, reject) => {
         const out = [];
         const req = () => env.requestRender?.();
         const obs = prev ? diffV2(prev, content, ctx, state2.segments, registry, req) : renderV2(content, ctx, registry, state2.segments, req);
-        obs.subscribe({ next: (c) => out.push(c), error: reject, complete: () => resolve3(out) });
+        obs.subscribe({ next: (c) => out.push(c), error: reject, complete: () => resolve4(out) });
       });
       for (const value of cmds) {
         if (state2.disposed || v !== state2.version) return;
@@ -14172,9 +14259,9 @@ function concatWith(tail) {
 
 // src/client/vdom/core/v2/integrate.ts
 function collectCommands(obs) {
-  return new Promise((resolve3, reject) => {
+  return new Promise((resolve4, reject) => {
     const out = [];
-    obs.subscribe({ next: (c) => out.push(c), error: reject, complete: () => resolve3(out) });
+    obs.subscribe({ next: (c) => out.push(c), error: reject, complete: () => resolve4(out) });
   });
 }
 async function v2ToHtml(root, ctx, registry) {
@@ -14211,6 +14298,35 @@ function unsafe(s) {
   return new HtmlSafe(s);
 }
 var MAX_CACHE_ENTRIES = 32;
+async function statAll(paths) {
+  const out = {};
+  for (const p of paths) {
+    try {
+      const st = await stat2(p);
+      out[p] = { mtimeMs: st.mtimeMs, size: st.size };
+    } catch {
+      out[p] = { mtimeMs: -1, size: -1 };
+    }
+  }
+  return out;
+}
+async function importClosure(absPath, seen = /* @__PURE__ */ new Set()) {
+  if (seen.has(absPath)) return [];
+  seen.add(absPath);
+  let css;
+  try {
+    css = await readFile2(absPath, "utf-8");
+  } catch {
+    return [];
+  }
+  const dir = dirname(absPath);
+  const out = [];
+  for (const m of css.matchAll(/@import\s+['"](\.[^'"]+\.css)['"]/g)) {
+    const dep = resolve3(dir, m[1]);
+    out.push(dep, ...await importClosure(dep, seen));
+  }
+  return out;
+}
 var postcssAvailable;
 async function checkPostcss() {
   if (postcssAvailable !== void 0) return postcssAvailable;
@@ -14225,12 +14341,12 @@ async function checkPostcss() {
 }
 function resolveEntry(entryPath) {
   if (entryPath.startsWith(".") || entryPath.startsWith("/")) {
-    return resolve2(entryPath);
+    return resolve3(entryPath);
   }
   try {
     return fileURLToPath(import.meta.resolve(entryPath));
   } catch {
-    return resolve2(entryPath);
+    return resolve3(entryPath);
   }
 }
 function ui(options = {}) {
@@ -14336,7 +14452,7 @@ function ui(options = {}) {
           });
           const inputs = {};
           for (const key of Object.keys(result.metafile?.inputs ?? {})) {
-            const abs = resolve2(key);
+            const abs = resolve3(key);
             try {
               const st = await stat2(abs);
               inputs[abs] = { mtimeMs: st.mtimeMs, size: st.size };
@@ -14351,14 +14467,13 @@ function ui(options = {}) {
       async css(entryPath) {
         const absPath = resolveEntry(entryPath);
         const { code, etag } = await compile2("css", absPath, async () => {
-          let code2 = await readFile(absPath, "utf-8");
-          const inputs = {};
-          try {
-            const st = await stat2(absPath);
-            inputs[absPath] = { mtimeMs: st.mtimeMs, size: st.size };
-          } catch {
-            inputs[absPath] = { mtimeMs: -1, size: -1 };
+          const dir = dirname(absPath);
+          if (basename(absPath) === "weifuwu-layout.css" && await isLayoutSourceDir(dir)) {
+            const bundle = await bundleLayout(dir);
+            return { code: bundle.css, inputs: await statAll(bundle.inputs) };
           }
+          let code2 = await readFile2(absPath, "utf-8");
+          const inputs = await statAll([absPath, ...await importClosure(absPath)]);
           if (await checkPostcss()) {
             try {
               const postcss = await import("postcss");
@@ -14701,7 +14816,7 @@ var PgConnection = class _PgConnection {
   /** 池空闲回收用：最近一次查询完成时间戳（pool release 时更新） */
   lastUsed = 0;
   connect() {
-    return new Promise((resolve3, reject) => {
+    return new Promise((resolve4, reject) => {
       this.status = "connecting";
       const sock = net.connect(this.opts.port, this.opts.host);
       this.socket = sock;
@@ -14733,7 +14848,7 @@ var PgConnection = class _PgConnection {
       this.onReady = () => {
         clearTimeout(timeout);
         this.status = "ready";
-        resolve3();
+        resolve4();
       };
       this.onAuthFail = (err) => {
         clearTimeout(timeout);
@@ -15030,7 +15145,7 @@ var PgConnection = class _PgConnection {
   }
   /** 查询：无参数走简单协议（Q），有参数走扩展查询（Parse/Bind/Execute/Sync） */
   query(sql, params) {
-    return new Promise((resolve3, reject) => {
+    return new Promise((resolve4, reject) => {
       if (this.status !== "ready" || !this.socket) {
         reject(new ConnectionError("postgres: not connected"));
         return;
@@ -15043,7 +15158,7 @@ var PgConnection = class _PgConnection {
         this.currentQuery = {
           columns: [],
           rows: [],
-          resolve: resolve3,
+          resolve: resolve4,
           reject
         };
         if (process.env.PGDBG2) console.error("[cquery]", JSON.stringify(sql.slice(0, 120)));
@@ -15053,12 +15168,12 @@ var PgConnection = class _PgConnection {
         let stmtEntry = this.getPrepared(sig);
         const encoded = encodeParams(params);
         if (!stmtEntry) {
-          this.issueExtendedQuery(sql, encoded, resolve3, reject);
+          this.issueExtendedQuery(sql, encoded, resolve4, reject);
         } else {
           this.currentQuery = {
             columns: [...stmtEntry.columns],
             rows: [],
-            resolve: resolve3,
+            resolve: resolve4,
             reject,
             sql,
             params: encoded,
@@ -15077,12 +15192,12 @@ var PgConnection = class _PgConnection {
    * 扩展查询首次准备：Parse + Describe + Flush（无 Sync——错误时由调用方发 Sync 复位）。
    * retry 路径复用：新语句名强制服务器按当前 schema 重新解析（DDL 失效恢复）。
    */
-  issueExtendedQuery(sql, params, resolve3, reject, retried) {
+  issueExtendedQuery(sql, params, resolve4, reject, retried) {
     const name = `wf_s${++this.stmtSeq}`;
     this.currentQuery = {
       columns: [],
       rows: [],
-      resolve: resolve3,
+      resolve: resolve4,
       reject,
       sql,
       params,
@@ -15106,7 +15221,7 @@ var PgConnection = class _PgConnection {
   /** 等待连接空闲（事务/多语句流程用） */
   waitIdle() {
     if (!this.currentQuery) return Promise.resolve();
-    return new Promise((resolve3) => this.waiters.push(resolve3));
+    return new Promise((resolve4) => this.waiters.push(resolve4));
   }
   /** 终止连接 */
   async close() {
@@ -15327,9 +15442,9 @@ var PgPool = class _PgPool {
       );
     }
     const timeoutMs = this.opts.acquireTimeoutMs ?? 3e4;
-    return new Promise((resolve3, reject) => {
+    return new Promise((resolve4, reject) => {
       const waiter = {
-        resolve: resolve3,
+        resolve: resolve4,
         reject
       };
       if (timeoutMs > 0) {
@@ -16779,9 +16894,9 @@ var RedisConnection = class {
   connect() {
     if (this.connectPromise) return this.connectPromise;
     this.closed = false;
-    this.connectPromise = new Promise((resolve3, reject) => {
+    this.connectPromise = new Promise((resolve4, reject) => {
       this.openSocket();
-      this.onceReady = () => resolve3();
+      this.onceReady = () => resolve4();
       this.onceFailed = (err) => reject(err);
     }).finally(() => {
       this.connectPromise = null;
@@ -16889,15 +17004,15 @@ var RedisConnection = class {
     if (this.offlineQueue.length >= this.opts.maxOfflineQueue) {
       return Promise.reject(new ConnectionError(`redis: offline queue full (${this.opts.maxOfflineQueue})`));
     }
-    return new Promise((resolve3, reject) => {
-      this.offlineQueue.push({ name, args, resolve: resolve3, reject, asBuffer: opts?.asBuffer });
+    return new Promise((resolve4, reject) => {
+      this.offlineQueue.push({ name, args, resolve: resolve4, reject, asBuffer: opts?.asBuffer });
     });
   }
   sendNow(name, args, asBuffer) {
     const start = performance.now();
-    return new Promise((resolve3, reject) => {
+    return new Promise((resolve4, reject) => {
       const p = {
-        resolve: resolve3,
+        resolve: resolve4,
         reject,
         asBuffer,
         blocking: BLOCKING_COMMANDS.has(name.toUpperCase())
@@ -16967,7 +17082,7 @@ var RedisConnection = class {
     if (this.status !== "ready" || !this.socket) {
       return Promise.reject(new ConnectionError("redis: not connected"));
     }
-    return new Promise((resolve3, reject) => {
+    return new Promise((resolve4, reject) => {
       const results = [];
       const batchPending = [];
       let settled = false;
@@ -16976,7 +17091,7 @@ var RedisConnection = class {
         if (results.length === count) {
           settled = true;
           if (batchTimer) clearTimeout(batchTimer);
-          resolve3(results);
+          resolve4(results);
         }
       };
       for (let i = 0; i < count; i++) {
@@ -17367,9 +17482,9 @@ var RedisPool = class _RedisPool {
       });
       this.replenish();
     }
-    return new Promise((resolve3, reject) => {
+    return new Promise((resolve4, reject) => {
       const waiter = () => {
-        if (this.clients.length > 0 && this.clients[0].connected) resolve3(this.clients[0]);
+        if (this.clients.length > 0 && this.clients[0].connected) resolve4(this.clients[0]);
         else reject(new ConnectionError("redis: pool exhausted after reconnect wait"));
       };
       this.replenishWaiters.push(waiter);
@@ -18500,13 +18615,13 @@ var MemoryRedisServer = class {
   }
   async start() {
     if (this.server) return;
-    await new Promise((resolve3) => {
+    await new Promise((resolve4) => {
       this.server = net3.createServer((sock) => this.handleSocket(sock));
       this.server.listen(this.opts.port, "127.0.0.1", () => {
         const addr = this.server.address();
         this.port = addr.port;
         this.url = `redis://127.0.0.1:${addr.port}`;
-        resolve3();
+        resolve4();
       });
     });
   }
@@ -18518,9 +18633,9 @@ var MemoryRedisServer = class {
       ctx.sock.destroy();
     }
     this.conns.clear();
-    await new Promise((resolve3) => {
-      if (!this.server) return resolve3();
-      this.server.close(() => resolve3());
+    await new Promise((resolve4) => {
+      if (!this.server) return resolve4();
+      this.server.close(() => resolve4());
       this.server = null;
     });
   }
@@ -18606,14 +18721,14 @@ var MemoryRedisServer = class {
         const v = await this.engine.command("LPOP", k);
         if (v !== null && v !== void 0) return encodeReply([k, v]);
       }
-      return await new Promise((resolve3) => {
-        const waiter = { keys, resolve: resolve3, timer: null, owner: ctx.id };
+      return await new Promise((resolve4) => {
+        const waiter = { keys, resolve: resolve4, timer: null, owner: ctx.id };
         this.blpopWaiters.push(waiter);
         if (timeout > 0) {
           waiter.timer = setTimeout(() => {
             const i = this.blpopWaiters.indexOf(waiter);
             if (i >= 0) this.blpopWaiters.splice(i, 1);
-            resolve3(encodeReply(null));
+            resolve4(encodeReply(null));
           }, timeout * 1e3);
         }
       });

package/docs/client.md

@@ -56,21 +56,57 @@ app.router(Router())
 ## 3. 设计语言
 
 微流明（Whisper Luminance）：中性色主导、品牌色点睛、动效短促有目的（120–300ms）、
-1px 边界即结构。**Token 即规范**——`src/client/layout/style.css`（183 双层 token：
-色阶/排版/动效/圆角/阴影/z-index）——组件只引用 token、零硬编码（audit 强制）。
+1px 边界即结构。**Token 即规范**——`src/client/layout/_tokens.css`（178 token：
+色阶/排版/动效/圆角/阴影/z-index；`_dark.css` 暗色覆写 · `_presets.css` 紧凑预设覆写）
+——组件只引用 token、零硬编码（audit 强制）。
+
+**token 两面纪律**（layout-inventory L10/L11 哨兵）：
+
+- **断点单源**：`--wf-bp-sm/md/lg/xl` = 640/768/1024/1280——CSS 媒体查询语法不能
+  `var()`，故 token 作**审计白名单源**：合法字面量只有两形态 `V`（`min-width`）与
+  `V - 0.02`（`max-width`）——二者无缝对接（旧碎片：组件面 `639px`/`767px` vs
+  layout 面 `767.98px`——767.00–767.98 区间两侧规则同时失配）
+- **死面 = 0（登记制）**：token 声明必须有消费证据（`var()` / TS 字面）——零消费即删，
+  结构性不可消费的（bp-* 机制源 · gap-2xl 标尺完整性）逐条登记理由；反向哨兵：
+  登记项一旦有消费者即需移出（防登记表腐化）
+- **双标尺（定案）**：`--wf-gap-*` **派生**自 `--wf-space-*`（紧一档：gap-md = space 裸档
+  = 12px · gap-lg = space-md）。容器内元素间距 < 控件内边距是有意的密度设计，**不是**
+  同名不同值的命名事故——关系入代码（L13 登记 + 值冻结），预设只覆写 space 标尺
+  （gap 自动跟随）
+- **同值双名（L12）**：同主题文件内值全等且名为「限定词插入」形态（`shadow` ⊂
+  `surface-shadow`）= 历史双名 → 必须 `var()` 单源（语义名保留、值改引用）；
+  跨域巧合（motion-sm 4px ≡ overlay-blur 4px · 240px/200px 三胞胎）**判负不耦合**
+  （耦合即隐形爆炸半径）
+- **px 字面量（L14）**：layout 类文件只允许登记白名单内的结构魔数（44px 命中区 ·
+  999px 胶囊 · 1px 发丝走 `--wf-border-width` · 2px/4px bleed 对 · 32px 视口内缩 ·
+  2px hover 微抬升）——新增字面量必须 token 化或登记
 
 品牌换色 = 改 seed 一个值；预设主题 = `data-theme` 一个属性（minimal/dark）。
 
 ## 4. 布局系统
 
-`src/client/layout/`——49 原语（`_*.css`）+ 92 工具 + 2 内部，全部 `wf-` 前缀：
+`src/client/layout/`——50 原语（`_*.css`）+ 98 工具 + 2 内部，全部 `wf-` 前缀；
+**装配单源**：四处管线（build 产物 / showcase dev / 场景 dev / `ctx.ui.css`）共用
+`bundle.ts`——层序单源（D4 审计比对）；**发布产物 minify**（esbuild——见文末载荷面）：
 
 - **原语**：`wf-stack` / `wf-row` / `wf-grid` / `wf-center` / `wf-card-surface` / `wf-divider`
 - **工具**：`wf-padding` / `wf-margin` / `wf-text-*` / `wf-bg-*` / `wf-hidden`
-- **命名规则**：三类词根 + 三后缀（完整词根表见 `apps/showcase/src/demos/layout.tsx`
-  与 `src/test/contract/layout-inventory.test.ts` L1 计数断言——**测试即登记表**）
-
-零值形态唯一（`none` 归一）· 对齐域禁方向词 · 双名歼灭——layout-inventory 8 断言锁定。
+- **命名规则**：三类词根 + 三后缀（完整词根表 = **机器生成** `docs/layout.md`：类清单/断点表/
+  钩子表/标尺派生/零消费公共面示例——与 `layout-inventory` 哨兵同源，改布局源码后
+  `node scripts/layout-reference.mjs` 再生成；L15 校验漂移即红）
+
+零值形态唯一（`none` 归一）· 对齐域禁方向词 · 双名歼灭 · 零值档位矩阵（取消面缺口登记）·
+冲突矩阵（同属性不同值对的同元素共用逐对登记胜者+胜因）· 层叠机制锁定（层序/`:where()`/
+`!important` 白名单/`@property` 钩子注册）· 断点与 token 单源 · token 双名歼灭 ·
+间距标尺派生登记 · px 字面量白名单——layout-inventory **20 断言**锁定；
+层叠语义的浏览器计算值读数见场景层 `e2e-layout-semantics.test.ts`。
+
+**载荷面（W6 minify）**：dist 发布产物 `weifuwu-layout.css` **28.1K**（gzip 5.7K · brotli 5.1K）·
+`weifuwu/components/style.css` **220.9K**（gzip 29.4K · brotli 24.3K）——esbuild minify（
+`build.mjs` 实装：`@layer`/`@property`/`@supports`/转义类名全保留，注释全剥离）；
+**无组件应用只引 `weifuwu/layout`**（28.1K / br 5.1K——独立面，零组件 CSS 成本）。
+按需子集（per-component 子路径 / purge）**判负**：动态类名漏删风险 + 构建期改造成本
++ br 后 24.3K 非瓶颈——推翻条件：真实应用首屏 CSS 成为 LCP 阻塞的实测数据。
 
 ## 5. 组件编写规范（唯一入口）
 
@@ -116,6 +152,32 @@ props camelCase · **`className=`（组件 props）`class=`（DOM 元素）** ·
 **状态变体类必须有规则或 `:where(.wf-x) {}` 显式声明**（L3 已扩围组件源码——未定义立即红）·
 动效 `--wf-dur-*`/`--wf-ease-*` · transition 含 visibility（隐藏不可 Tab 聚焦）
 
+**组件 px 四纪律（C1 哨兵强制——`contract/components-px.test.ts` 四桶登记制）**：
+
+1. **间距走标尺**：padding/margin/gap 的 4/8/12/16/24/32px →
+   `var(--wf-space-*)`/`var(--wf-gap-*)`（**任一档位值字面量 = 红**——含 var 混合声明
+   `padding: 8px var(--wf-x)` 同样适用——半 token 禁止；档位外值 = 结构桶登记制）
+2. **边框宽走发丝 token**：`border[N]: 1px solid/dashed …` → `var(--wf-border-width)`
+   （色可走 var/currentColor/transparent——hex 已锁 0；**非 1px 宽 = 强调边框**——无 token 面登记制）
+3. **结构值登记制**：非档位 px（结构尺寸/魔数——height/width/min-*/outline/box-shadow 偏移/
+   44px 命中区/z-index:1 等）→ `scripts/components-px-whitelist.json` structural/zIndex 桶
+   **登记 + 理由**（新增未登记 = 红 · 处理完未移出 = 幽灵红）
+4. **豁免面**：派生表达式（calc/env/min/max/clamp——L13 同款）与 0px 零值形态——非作者手写终值
+
+> 紧凑预设语义：**只有走 var() 的组件才跟随缩放**（_presets.css「间距缩一档」——手写=静止=活体缺口）。
+
+**C2 扩展纪律（`contract/components-token.test.ts` 三桶——token 消费哨兵）**：
+
+5. **文本行高走档**：`line-height` 值 ∈ {1.5, 1.25}（恒等档）→ `var(--wf-line-height)`/
+   `var(--wf-line-height-tight)`（近值=红）；代码排版 1.6（CodeBlock/DiffView——2 消费者
+   <3 升档门——第三消费者出现即升 --wf-line-height-code）；豁免面 {1 重置/0/px 图标}
+6. **弹层宽走钩子**：`.wf-popup` 系面板 **禁止手写 max-width**——基类
+   `min(var(--wf-popup-max, 480px), calc(100vw - 32px))` 是唯一入口；组件默认宽用
+   **回退值**表达（`min(var(--wf-popup-max, 320px), …)`——回退=默认宽）；非弹层面板宽
+   （命令面板/通知条/工作区）判负登记——`popup-max` 钩子调不动 = 钩子失效面
+7. **token 零消费双分类**：{保留类（色板档/暗色映射档/布局档/断点档——消费形态非
+   var() 引用）/真死候选}——新增零消费 token 需登记（消费矩阵哨兵——对齐 L11 组件版）
+
 ### 5.5 测试二层（覆盖哨兵 ≥2 层）
 
 1. **契约 harness**（`<Comp>.test.ts`——mount/render/createTable 命令流断言）