transone-cli 0.3.1 → 0.4.0

package/README.md

@@ -23,7 +23,7 @@ Usage:
   transone dev [--host <host>] [--port <port>] [--base <path>] [--no-watch]
   transone build [--target <target>] [--out-dir <path>] [--base <path>] [--library]
 
-Targets: web, mp-weixin, mp-alipay, mp-bytedance, app-ios, app-android, app-harmony (default: web)
+Targets: web, mp-weixin, mp-alipay, mp-bytedance, mp-xiaohongshu, app-ios, app-android, app-harmony (default: web)
 ```
 
 ### `transone create`
@@ -43,13 +43,14 @@ transone build --target web           # H5 site / SPA
 transone build --target mp-weixin     # WeChat mini-program project (WXML/WXSS/JS)
 transone build --target mp-alipay     # Alipay mini-program project (AXML/ACSS)
 transone build --target mp-bytedance  # ByteDance mini-program project (TTML/TTSS)
+transone build --target mp-xiaohongshu # Xiaohongshu mini-program project (XHSML/CSS)
 ```
 
 - `--out-dir` overrides the output directory.
 - `--base` sets the deployment base path (e.g. a GitHub Pages sub-path).
 - `--library` builds in library mode (no page entry required).
 
-Unimplemented targets fail fast at compile time with a clear error pointing to the corresponding roadmap stage.
+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
 
@@ -59,7 +60,8 @@ Unimplemented targets fail fast at compile time with a clear error pointing to t
 | `mp-weixin` | Native WeChat mini-program project | Compile-time static conversion (WXML / WXSS / JS) | Implemented |
 | `mp-alipay` | Native Alipay mini-program project | Compile-time static conversion (AXML / ACSS) | Implemented |
 | `mp-bytedance` | Native ByteDance mini-program project | Compile-time static conversion (TTML / TTSS) | Implemented |
-| `app-ios` / `app-android` / `app-harmony` | Native app | TBD | Roadmap |
+| `mp-xiaohongshu` | Native Xiaohongshu Mini Program (not Mini Widget) | Compile-time static conversion (XHSML / CSS) | Implemented |
+| `app-ios` / `app-android` / `app-harmony` | Native app (SwiftUI / Jetpack Compose / ArkUI) | Compile-time source generation | Implemented |
 
 Mini-program builds emit a complete native project: `app.json` / `app.js` / app style file / project config, plus `pages/<route>/<name>.*` and `components/<tag>/<tag>.*`. Platform differences (template syntax, style language, event binding, lifecycle mapping) are handled by the `MpDialect` abstraction.
 
@@ -93,13 +95,21 @@ export default defineConfig({
 });
 ```
 
-The `mp` field accepts either a single `MiniProgramConfig` (applies to every mini-program target; recommended for WeChat-only apps) or a per-platform map like `{ 'mp-weixin': {...}, 'mp-alipay': {...} }` — only the config for the current target is used.
+The `mp` field accepts either a single `MiniProgramConfig` (applies to every mini-program target) or a per-platform map like `{ 'mp-weixin': {...}, 'mp-alipay': {...}, 'mp-xiaohongshu': {...} }` — only the config for the current target is used. Xiaohongshu uses the default placeholder app ID unless you set its own `appId`.
+
+Generate the Counter playground project for Xiaohongshu with:
+
+```bash
+bun run --cwd playground/counter build:xiaohongshu
+```
+
+The output is `playground/counter/dist/build/mp-xiaohongshu`.
 
 ## How the compiler works
 
 1. Loads the project config and resolves pages from the entry file.
 2. For Web: renders directly with the browser runtime (H5 site / SPA).
-3. For mini-program targets: statically analyzes the root component class of each page, then compiles the component tree into native files — WXML/JS (WeChat), AXML/ACSS (Alipay), TTML/TTSS (ByteDance) — including styles, template bindings, event methods, and data-state mapping. The generated code is a standalone native project with no TransOne runtime.
+3. For mini-program targets: statically analyzes the root component class of each page, then compiles the component tree into native files — WXML/WXSS (WeChat), AXML/ACSS (Alipay), TTML/TTSS (ByteDance), and XHSML/CSS (Xiaohongshu) — including styles, template bindings, event methods, and data-state mapping. The generated code is a standalone native project with no TransOne runtime.
 4. Library components are resolved through the `"source"` field of each package's `package.json` (see `transone-ui`).
 
 ## Extending a new target

package/README.zh-CN.md

@@ -8,10 +8,11 @@ TransOne 多端编译器：Bun 原生 CLI，按 Target 将一份 TypeScript 源
 
 ```text
 web            直接渲染（HTML + 浏览器运行时，M1 已实现）
-mp-weixin      WXML / WXSS / JS 静态转换（M2 规划中）
-mp-alipay      AXML / ACSS 静态转换（M3 规划中）
-mp-bytedance   ttml / ttss 静态转换（M3 规划中）
-app-*          远期占位（app-ios / app-android / app-harmony）
+mp-weixin      WXML / WXSS / JS 静态转换（已实现）
+mp-alipay      AXML / ACSS 静态转换（已实现）
+mp-bytedance   TTML / TTSS 静态转换（已实现）
+mp-xiaohongshu XHSML / CSS 静态转换（已实现；小红书小程序，非小组件）
+app-*          原生应用代码生成（app-ios / app-android / app-harmony，已实现）
 ```
 
 新增目标端：实现 `BuildTarget` 接口并注册到 `TargetRegistry`，无需改动构建入口。
@@ -20,7 +21,8 @@ app-*          远期占位（app-ios / app-android / app-harmony）
 
 ```bash
 transone build --target web           # 产出 H5 站点
-transone build --target mp-weixin     # 未实现时编译期报错并给出路线图阶段
+transone build --target mp-weixin     # 生成微信小程序原生工程
+transone build --target mp-xiaohongshu # 生成小红书小程序原生工程（XHSML / CSS）
 transone dev                          # 开发服务（仅 web）
 transone create                       # 脚手架
 ```
@@ -30,6 +32,17 @@ bun test          # 测试
 bun run build     # 构建 dist（CLI bundle + .d.ts）
 ```
 
+在 Counter 演练项目中生成微信、支付宝、字节和小红书小程序：
+
+```bash
+bun run --cwd playground/counter build:weixin
+bun run --cwd playground/counter build:alipay
+bun run --cwd playground/counter build:bytedance
+bun run --cwd playground/counter build:xiaohongshu
+```
+
+小红书产物位于 `playground/counter/dist/build/mp-xiaohongshu`。`mp` 配置既支持适用于所有小程序端的扁平配置，也支持按 target 分组；小红书未配置 `appId` 时使用占位默认值，导入开发者工具前应设置真实 App ID。
+
 ## 文档
 
 - 在线文档（CLI 子站）：<https://geektech-team.github.io/transone/cli/>

package/dist/app/analyze.d.ts

@@ -0,0 +1,2 @@
+import type { NativeScreen } from './types';
+export declare function analyzeNativeScreen(entry: string): Promise<NativeScreen>;

package/dist/app/build-app.d.ts

@@ -0,0 +1,3 @@
+import type { BuildResult, ResolvedConfig } from '../types';
+import type { NativeDialect } from './types';
+export declare function buildNativeApp(config: ResolvedConfig, dialect: NativeDialect): Promise<BuildResult>;

package/dist/app/dialects.d.ts

@@ -0,0 +1,4 @@
+import type { NativeDialect } from './types';
+export declare const IOS_DIALECT: NativeDialect;
+export declare const ANDROID_DIALECT: NativeDialect;
+export declare const HARMONY_DIALECT: NativeDialect;

package/dist/app/errors.d.ts

@@ -0,0 +1 @@
+export declare function nativeError(filePath: string, message: string): Error;

package/dist/app/types.d.ts

@@ -0,0 +1,61 @@
+import type { ResolvedAppConfig } from '../types';
+export type NativeStateValue = string | number | boolean;
+export interface NativeStateEntry {
+    key: string;
+    value: NativeStateValue;
+}
+export interface NativeStyle {
+    color?: string;
+    backgroundColor?: string;
+    fontSize?: number;
+    fontWeight?: string | number;
+    padding?: number;
+    margin?: number;
+    width?: number;
+    height?: number;
+    borderRadius?: number;
+    textAlign?: string;
+}
+export type NativeTextPart = {
+    kind: 'literal';
+    value: string;
+} | {
+    kind: 'state';
+    key: string;
+};
+export type NativeAction = {
+    kind: 'increment';
+    key: string;
+    by: number;
+} | {
+    kind: 'set-literal';
+    key: string;
+    value: NativeStateValue;
+};
+export type NativeNode = {
+    kind: 'container';
+    children: NativeNode[];
+    style?: NativeStyle;
+} | {
+    kind: 'text';
+    parts: NativeTextPart[];
+    style?: NativeStyle;
+} | {
+    kind: 'button';
+    parts: NativeTextPart[];
+    action: NativeAction;
+    style?: NativeStyle;
+};
+export interface NativeScreen {
+    name: string;
+    state: NativeStateEntry[];
+    root: Extract<NativeNode, {
+        kind: 'container';
+    }>;
+}
+export interface NativeDialect {
+    readonly id: 'app-ios' | 'app-android' | 'app-harmony';
+    readonly label: string;
+    readonly resourceDirectory: string;
+    generateProject(screen: NativeScreen, config: ResolvedAppConfig): Record<string, string>;
+}

package/dist/{build-mp-k1dgvwwx.js → build-mp-6j38wf4r.js}

@@ -1,23 +1,14 @@
 // @bun
 import {
-  __require
-} from "./index-yb2wsc7f.js";
+  loadTypescript
+} from "./index-k1qfvp0y.js";
+import"./index-yb2wsc7f.js";
 
 // src/mp/build-mp.ts
 import { cp, mkdir, readdir, rm, writeFile } from "fs/promises";
 import { existsSync as existsSync2 } from "fs";
 import { basename, dirname as dirname3, join as join3, relative, resolve as resolve2 } from "path";
 
-// src/mp/ts-loader.ts
-var tsModule = null;
-async function loadTypescript() {
-  if (tsModule) {
-    return tsModule;
-  }
-  tsModule = await import("typescript");
-  return tsModule;
-}
-
 // src/mp/analyze.ts
 import { existsSync, readFileSync } from "fs";
 import { dirname, join, resolve } from "path";
@@ -2805,5 +2796,5 @@ export {
   buildMiniProgram
 };
 
-//# debugId=EBDB309ADE017FFC64756E2164756E21
-//# sourceMappingURL=build-mp-k1dgvwwx.js.map
+//# debugId=B563DD7B11FB4E5E64756E2164756E21
+//# sourceMappingURL=build-mp-6j38wf4r.js.map