transone-cli 0.6.3 → 0.7.0

package/README.md

@@ -52,6 +52,10 @@ transone build --target mp-xiaohongshu # Xiaohongshu mini-program project (XHSML
 - `--base` sets the deployment base path (e.g. a GitHub Pages sub-path).
 - `--library` builds in library mode (no page entry required).
 
+Web `dev` and `build` emit fixed component `initStyles()` rules that can be resolved safely and document styles as static CSS files, loaded through `<link rel="stylesheet">`. Component extraction supports literal values and immutable module constants, including hover, media queries and rpx conversion. Methods that depend on props/state, mutate their style manager later, or contain unsupported statements keep runtime styling. When selectors or inheritance cannot be resolved safely, the bundle retains runtime component styling. Identified document `<style>` elements and sheets with relative resource URLs stay inline to preserve their behavior. Use component-specific selectors: extracted rules are available before component mount and follow a stable source-file order.
+
+Web production entry and chunk JavaScript filenames contain a content hash (for example `main-<hash>.js`); HTML references the emitted filenames. Unchanged content keeps its hash. Mini-program and library entry filenames follow their existing platform/package contracts.
+
 The iOS, Android, and Harmony native app targets are implemented. A generated project should still be opened in its platform IDE for runtime/device validation.
 
 ## Targets

package/README.zh-CN.md

@@ -27,6 +27,10 @@ transone dev                          # 开发服务（仅 web）
 transone create                       # 脚手架
 ```
 
+Web 的 `dev`、`build` 会将可安全静态确定的组件 `initStyles()` 样式与文档样式输出为静态 CSS，通过 `<link rel="stylesheet">` 加载。组件提取支持字面量、不可变模块常量、hover、media 与 rpx 换算；依赖 props/state、后续修改 StyleManager 或含不支持语句的方法继续在运行时处理。无法安全确定选择器或跨模块继承关系时，当前 bundle 的组件样式保留在运行时。带标识的文档 `<style>` 和含相对资源 URL 的样式保留内联，以维持原有行为。组件应使用专属选择器：提取的规则在挂载前就已生效，并按稳定的源文件顺序排列。
+
+Web 生产入口与分块 JS 文件名包含内容 hash，例如 `main-<hash>.js`，HTML 自动引用实际文件名；内容不变时 hash 不变。小程序及库入口保留平台与包约定的文件名。
+
 ```bash
 bun test          # 测试
 bun run build     # 构建 dist（CLI bundle + .d.ts）

package/dist/cli.js

@@ -5,7 +5,7 @@ import {
   createProject,
   isTargetType,
   startDevServer
-} from "./index-8k9x2k6m.js";
+} from "./index-x5rrsfyb.js";
 import"./index-k1qfvp0y.js";
 import"./index-yb2wsc7f.js";
 

package/dist/create.d.ts

@@ -11,6 +11,6 @@ export interface CreateProjectResult {
 /** Published framework version referenced by generated projects. */
 export declare const TRANSONE_FRAMEWORK_VERSION = "0.4.0";
 /** Published CLI version referenced by generated projects. */
-export declare const TRANSONE_CLI_VERSION = "0.6.3";
+export declare const TRANSONE_CLI_VERSION = "0.7.0";
 export declare const GITHUB_URL = "https://github.com/geektech-team/transone";
 export declare function createProject(options?: CreateProjectOptions): CreateProjectResult;

package/dist/document-styles.d.ts

@@ -0,0 +1,7 @@
+export interface DocumentStylesResult {
+    html: string;
+    assets: string[];
+}
+/** Externalize the document shell's CSS without changing stylesheet order. */
+export declare function emitDocumentStyles(html: string, outDir: string, assetUrl: (path: string) => string, stylesheets: string[], componentStylesheets?: string[]): Promise<DocumentStylesResult>;
+export declare function emitComponentStyles(styles: ReadonlyMap<string, string>, outDir: string): Promise<string[]>;