weifuwu 0.91.0 → 0.93.0

package/dist/client/layout/bundle.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 层序（优先级从低到高——后声明者胜）
+ *
+ * **utilities 在 components 之后**（LAYOUT-PLAN W2）：工具类是消费侧的**显式覆盖**意图，
+ * 必须能胜组件自身样式（Tailwind 惯例）。旧序（utilities 在 components 之前）下的实证：
+ *   · `.wf-card--pad-lg + .wf-padding-xs` → 24px（工具类 4px 被吞）
+ *   · `.wf-btn + .wf-hidden` → inline-flex（**隐藏失效**——agent-platform 面板按钮
+ *     桌面隐藏不生效，当时靠 `wf-hidden\@lg { … !important }` 变通）
+ * 层序声明必须是**活 atrule**（见文件头 ③：旧 build 的未闭合注释曾吞掉本声明 →
+ * 优先级退化为块首现顺序，改层序会是空操作）。unlayered 应用 CSS 仍胜全部层（规范行为）。
+ */
+export declare const LAYER_ORDER: readonly ["tokens", "base", "layout", "components", "utilities"];
+/** 文件 → 层归属（未登记即抛错——静默降级 = 层叠优先级悄悄变化） */
+export declare const LAYER_OF: Record<string, string>;
+export interface CssBundle {
+    /** 装配后的完整 CSS（可直接作为 Response body / 写盘） */
+    css: string;
+    /** 参与装配的文件绝对路径（新鲜度键——mtime+size 逐个校验） */
+    inputs: string[];
+}
+/** entry 的 `@import` 顺序（源面即顺序面——单源①） */
+export declare function layoutEntryFiles(layoutDir: string): Promise<string[]>;
+/** 目录是否为 layout 源面（有 entry + 分量 `_*.css`——dist 只有合并产物 → false） */
+export declare function isLayoutSourceDir(dir: string): Promise<boolean>;
+/**
+ * 装配 layout CSS（Token + 暗色 + 预设 + 基础 + 原语 + 工具——按 LAYER_OF 分层）
+ * @param layoutDir `src/client/layout` 绝对/相对路径
+ */
+export declare function bundleLayout(layoutDir: string): Promise<CssBundle>;
+/**
+ * 装配组件 CSS = layout 全量 + 全部组件 CSS（`@layer components`）
+ * 组件目录动态扫描（新增组件自动包含——硬编码列表会静默漏 CSS）
+ */
+export declare function bundleComponents(layoutDir: string, componentsDir: string): Promise<CssBundle>;
+/**
+ * 类 → 层归属映射（契约用：跨管线层归属全等断言）
+ *
+ * 顶层 `@layer <name> { … }` 块内的 `.wf-*` 归该层（块内嵌套 @media/@supports 自然包含）；
+ * 块外的类归 `unlayered`（tokens 层文件不包裹——但其内容零类，仅 :root 变量）。
+ * 首现优先（同类多规则同层——跨管线比较只看归属，不看声明明细）。
+ */
+export declare function layerMapOf(css: string): Map<string, string>;