@weapp-vite/oxfmt 0.0.0-stage → 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 ice breaker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,72 @@
-# Temporary Holding Version
+# @weapp-vite/oxfmt
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+小程序共享格式预设与安全格式化入口。配套 Vite+ 1.2.0 / Oxfmt 0.73.0，CLI 与 VSCode 共用 `@weapp-vite/language-service`。
+
+```ts
+import { recommended } from '@weapp-vite/oxfmt'
+import { defineConfig } from 'vite-plus'
+
+export default defineConfig({
+  fmt: recommended,
+})
+```
+
+默认两空格、单引号、无分号、LF、末尾换行和多行尾逗号。不排序 import、`package.json` 字段或 Tailwind class。
+
+## 项目命令
+
+```sh
+pnpm exec weapp-vite-format --write
+pnpm exec weapp-vite-format --check
+pnpm exec weapp-vite-format --check-all
+```
+
+| 命令 | 处理范围 |
+| --- | --- |
+| `--write` | 在内存完成全部候选文件的格式与语义预检，通过后写入 |
+| `--check` | 使用相同格式入口只读检查，任何文件需要格式化时失败 |
+| `--check-all` | 一次 `vp check`、原生语言预检与格式检查，以及项目存在的 `lint:vue`、`stylelint` 脚本 |
+
+标准文件使用项目安装的 Oxfmt API，原生模板、脚本模块和样式进入对应适配器。`--check-all` 不替代项目独立的 TypeScript 类型检查。原生语言诊断也可通过 `weapp-vite-lint --native-only` 单独执行。
+
+## 语言范围与语义保护
+
+| 文件 | 处理方式 |
+| --- | --- |
+| `.wxml`、`.axml`、`.ttml`、`.swan`、`.jxml`、`.qml`、`.ksml`、`.xhsml`、`.tyml` | 共享 TS scanner 与源码片段编辑，仅调整标签和属性布局 |
+| `.wxss`、`.acss`、`.ttss`、`.qss`、`.jxss`、`.tyss` 和原生 `.css` | CSS 格式化，保留 `rpx`、Tailwind 指令、条件注释和声明顺序；Stylelint 负责样式语义 |
+| 独立/内联 WXS、SJS、KS、filter | 平台方言预检、词法兼容处理、Oxfmt、格式化后 AST 与方言复验 |
+| `.wxs.ts`、`.sjs.ts`、`.ks.ts`、`.filter.ts` 及 `lang="ts/js"` | 按待编译源码处理，不把合法源码提前限制为宿主原生语法 |
+
+模板逐字保留文本空白、实体、插值、属性值及引号、属性顺序、重复属性和显式闭合形式，不经过 DOM 序列化。内联脚本由模块适配器独立处理；`formatWxml` 兼容 API 仍保持内联脚本原文。
+
+脚本模块按实际平台检查模块系统和内建能力，不把所有 `.sjs` 解释成微信 WXS。百度原生 filter 使用相对 `.filter.js` 引用并通过默认导出暴露函数。方言、词法、结构或 AST 语义校验失败时拒绝写回；文件在预检期间被修改时拒绝覆盖。
+
+预设排除依赖、构建产物、`.weapp-vite`、受管生成目录与锁文件。供标准 `vp fmt` 跳过原生模板和模块的忽略项由组合 CLI 接管，不会因此跳过普通源码。不要把原生模板重新关联为 HTML；单独的 `vp fmt` 不包含完整原生语言检查。
+
+## 配置与 workspace
+
+`lint` / `fmt` 继续位于 `vite.config.ts`。平台选择放在 `weapp.language`，支持 `platform` 与 `overrides: [{ files: string[], platform }]`；配置影响 CLI 和 VSCode。存在歧义或互相冲突的模块引用时给出诊断，需显式配置归属。
+
+`--write` / `--check` 使用最近的项目配置，也可通过 `--config` 指定 Vite 配置或 `.oxfmtrc.json`。格式遵循实际 `fmt`、文件 `overrides`、忽略路径和 `.gitignore`；不通过忽略普通源码消除格式失败。
+
+```sh
+pnpm exec weapp-vite-format --write src/pages
+pnpm exec weapp-vite-format --check -c .oxfmtrc.json 'src/**/*.wxml'
+```
+
+`--check-all` 与 `vp check` 优先使用 workspace 根配置，不接受 `--config`；成员预设不覆盖父工作区的 `lint` / `fmt` 所有权。根配置的 glob 和忽略路径需相对根目录定位到成员项目。
+
+## 程序接口与编辑器
+
+```ts
+import { formatDocument } from '@weapp-vite/oxfmt/languages'
+import { formatWxml } from '@weapp-vite/oxfmt/wxml'
+
+const template = await formatDocument(source, 'src/page.axml')
+const compatible = await formatWxml(source, 'src/page.wxml', { printWidth: 100 })
+```
+
+`formatDocument` 支持全部登记语言与内联模块。`@weapp-vite/oxfmt/project` 导出项目配置解析、文档归属解析和 `prepareProjectFormatting`，供 CLI 与编辑器适配层复用。显式传入格式选项时采用该配置；需要固定风格时提供完整所需选项。
+
+VSCode 扩展使用项目安装的工具，仅在受信任工作区加载项目配置与格式化器。模板及原生模块使用扩展的唯一格式化提供者，标准 JS/TS 使用 Oxc；错误输入显示诊断并返回零修改。此包不新增完整模板类型检查器，不替代 Vue 专项 ESLint、Stylelint 或平台编译器。本轮验收覆盖 TS、CLI、VSCode 和构建，不代表真实小程序 IDE runtime 验收。

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export {}

package/dist/cli.mjs

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+import { recommended } from "./index.mjs";
+import { t as prepareFormatting } from "./prepare-D65ZFJWl.mjs";
+import process from "node:process";
+import * as fs from "node:fs/promises";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { loadProjectConfig } from "@weapp-vite/language-service/project";
+import { execa } from "execa";
+// src/project/args.ts
+/** CLI 参数只描述检查对象和模式，不能静默接受未实现的开关。 */
+function parseArgs(args) {
+	let mode;
+	let configFile;
+	const inputs = [];
+	for (let index = 0; index < args.length; index++) {
+		const argument = args[index];
+		if (argument === "--write" || argument === "--check" || argument === "--check-all") {
+			if (mode && mode !== argument) throw new Error("只能选择一种格式检查或写入模式");
+			mode = argument;
+		} else if (argument === "-c" || argument === "--config") {
+			configFile = args[++index];
+			if (!configFile || configFile.startsWith("-")) throw new Error("--config 需要配置文件路径");
+		} else if (argument.startsWith("--config=")) {
+			configFile = argument.slice(9);
+			if (!configFile) throw new Error("--config 需要配置文件路径");
+		} else if (argument.startsWith("-")) throw new Error(`未知参数：${argument}`);
+		else inputs.push(argument);
+	}
+	if (!mode) throw new Error("请指定 --write、--check 或 --check-all");
+	if (mode === "--check-all" && configFile) throw new Error("Vite+ check 使用工作区配置，不接受 --config");
+	return {
+		mode,
+		configFile,
+		inputs: inputs.length ? inputs : ["."]
+	};
+}
+// src/project/transaction.ts
+/** 同卷暂存新旧完整内容，所有暂存成功后才原子替换；回滚只触及仍归本次操作的内容。 */
+async function commitFormatting(candidates, io = fs) {
+	const staged = [];
+	const written = [];
+	const failures = [];
+	try {
+		for (const candidate of candidates.filter((item) => item.source !== item.formatted)) {
+			const directory = await io.mkdtemp(path.join(path.dirname(candidate.file), ".weapp-vite-format-"));
+			const entry = {
+				candidate,
+				directory,
+				next: path.join(directory, "next"),
+				previous: path.join(directory, "previous")
+			};
+			staged.push(entry);
+			const { mode } = await io.stat(candidate.file);
+			await io.writeFile(entry.previous, candidate.source, { mode });
+			await io.writeFile(entry.next, candidate.formatted, { mode });
+		}
+		for (const candidate of candidates) if (await io.readFile(candidate.file, "utf8") !== candidate.source) throw new Error("格式化期间项目文件发生变化，拒绝覆盖");
+		for (const entry of staged) {
+			if (await io.readFile(entry.candidate.file, "utf8") !== entry.candidate.source) throw new Error("格式化期间项目文件发生变化，拒绝覆盖");
+			await io.rename(entry.next, entry.candidate.file);
+			written.push(entry);
+		}
+	} catch (error) {
+		failures.push(error);
+		for (const entry of written.reverse()) try {
+			if (await io.readFile(entry.candidate.file, "utf8") === entry.candidate.formatted) await io.rename(entry.previous, entry.candidate.file);
+		} catch (restoreError) {
+			failures.push(restoreError);
+		}
+	} finally {
+		for (const entry of staged) try {
+			await io.rm(entry.directory, {
+				recursive: true,
+				force: true
+			});
+		} catch (cleanupError) {
+			failures.push(cleanupError);
+		}
+	}
+	if (failures.length) throw new AggregateError(failures, "格式化写入失败，已回滚仍归本次写入的文件");
+}
+// src/project/index.ts
+async function checkProject(cwd, inputs) {
+	const vp = fileURLToPath(new URL("../bin/vp", import.meta.resolve("vite-plus")));
+	let exitCode = (await execa(process.execPath, [
+		vp,
+		"check",
+		...inputs
+	], {
+		cwd,
+		stdio: "inherit",
+		reject: false
+	})).exitCode ?? 1;
+	const manifest = JSON.parse(await readFile(path.join(cwd, "package.json"), "utf8"));
+	for (const script of ["lint:vue", "stylelint"]) if (manifest.scripts?.[script]) {
+		const checked = await execa("npm", ["run", script], {
+			cwd,
+			stdio: "inherit",
+			reject: false
+		});
+		exitCode ||= checked.exitCode ?? 1;
+	}
+	return exitCode;
+}
+/** 一次预检全部候选文件；读取后发生源码变化时拒绝覆盖，检查模式不写入。 */
+async function runFormat(args, cwd = process.cwd()) {
+	if (args.includes("--help") || args.includes("-h")) {
+		process.stdout.write("weapp-vite-format <--write|--check|--check-all> [-c config.json] [paths...]\n");
+		return;
+	}
+	const { mode, configFile, inputs } = parseArgs(args);
+	const project = await loadProjectConfig(cwd, {
+		configFile,
+		workspaceFirst: mode === "--check-all"
+	});
+	const scopedInputs = inputs.map((input) => {
+		const negative = input.startsWith("!");
+		const target = negative ? input.slice(1) : input;
+		const relative = path.relative(project.root, path.resolve(cwd, target)).split(path.sep).join("/");
+		return `${negative ? "!" : ""}${relative || "."}`;
+	});
+	const candidates = await prepareFormatting(project.root, scopedInputs, project.fmt ?? recommended, project.language);
+	const changes = candidates.filter((candidate) => candidate.source !== candidate.formatted);
+	if (mode !== "--write") {
+		for (const change of changes) {
+			const label = path.relative(cwd, change.file).split(path.sep).join("/");
+			process.stderr.write(`${change.file.endsWith(".wxml") ? "WXML" : "文件"} 需要格式化：${label}\n`);
+		}
+		const exitCode = mode === "--check-all" ? await checkProject(cwd, inputs) : 0;
+		if (exitCode !== 0 || changes.length > 0) process.exitCode = exitCode || 1;
+		return;
+	}
+	await commitFormatting(candidates);
+}
+// src/cli.ts
+runFormat(process.argv.slice(2)).catch((error) => {
+	console.error(error instanceof Error ? error.message : String(error));
+	process.exitCode = 1;
+});
+export {};

package/dist/index.d.mts

@@ -0,0 +1,20 @@
+export declare const nativeFormatIgnorePatterns: string[];
+/** 小程序格式预设；原生模板和模块交给安全适配器，样式语义仍交给 Stylelint。 */
+export declare const recommended: {
+  ignorePatterns: string[];
+  associations: {
+    files: string[];
+    language: "css";
+  }[];
+  tabWidth: number;
+  useTabs: false;
+  singleQuote: true;
+  semi: false;
+  trailingComma: "all";
+  endOfLine: "lf";
+  insertFinalNewline: true;
+  htmlWhitespaceSensitivity: "strict";
+  sortImports: false;
+  sortPackageJson: false;
+  sortTailwindcss: false;
+};

package/dist/index.mjs

@@ -0,0 +1,33 @@
+import { t as formatOptions } from "./options-CitIeLO-.mjs";
+import { FILTER_EXTENSIONS, SCRIPT_EXTENSIONS, STYLE_EXTENSIONS, TEMPLATE_EXTENSIONS } from "@weapp-vite/language-service";
+// src/index.ts
+const nativeFormatIgnorePatterns = [
+	...FILTER_EXTENSIONS.map((extension) => `**/*${extension}`),
+	...TEMPLATE_EXTENSIONS.map((extension) => `**/*${extension}`),
+	...SCRIPT_EXTENSIONS.flatMap((extension) => [
+		`**/*${extension}`,
+		`**/*${extension}.ts`,
+		`**/*${extension}.js`
+	])
+];
+/** 小程序格式预设；原生模板和模块交给安全适配器，样式语义仍交给 Stylelint。 */
+const recommended = {
+	...formatOptions,
+	ignorePatterns: [
+		"**/node_modules/**",
+		"**/dist/**",
+		"**/dist-*/**",
+		"**/.weapp-vite/**",
+		"**/miniprogram_npm/**",
+		"**/generated/**",
+		"**/pnpm-lock.yaml",
+		"**/package-lock.json",
+		"**/yarn.lock",
+		...nativeFormatIgnorePatterns
+	],
+	associations: [{
+		files: STYLE_EXTENSIONS.map((extension) => `**/*${extension}`),
+		language: "css"
+	}]
+};
+export { nativeFormatIgnorePatterns, recommended };

package/dist/languages/index.d.mts

@@ -0,0 +1,5 @@
+import { DocumentInput, LanguageOptions } from "@weapp-vite/language-service";
+import { FormatConfig } from "vite-plus/fmt";
+export type DocumentFormatOptions = FormatConfig & LanguageOptions & Pick<DocumentInput, 'sourceKind' | 'dialect' | 'language'>;
+/** 同一公开入口供 CLI 与编辑器格式化模板、内联/独立模块及原生样式。 */
+export declare function formatDocument(source: string, fileName: string, options?: DocumentFormatOptions): Promise<string>;

package/dist/languages/index.mjs

@@ -0,0 +1,62 @@
+import { t as formatOptions } from "../options-CitIeLO-.mjs";
+import { LanguageError, STYLE_EXTENSIONS, TEMPLATE_EXTENSIONS, analyzeDocument, formatScript, formatTemplate, getTemplateScriptInput, isScriptModuleFile, resolveLanguageProfile } from "@weapp-vite/language-service";
+// src/languages/index.ts
+/** 同一公开入口供 CLI 与编辑器格式化模板、内联/独立模块及原生样式。 */
+async function formatDocument(source, fileName, options = formatOptions) {
+	const profile = resolveLanguageProfile(fileName, options);
+	const normalized = fileName.toLowerCase();
+	const settings = { ...options };
+	if (TEMPLATE_EXTENSIONS.some((extension) => normalized.endsWith(extension))) {
+		const analysis = analyzeDocument({
+			source,
+			fileName,
+			options
+		});
+		if (!analysis.valid) throw new LanguageError(fileName, analysis.diagnostics.filter((diagnostic) => diagnostic.severity === "error"));
+		let formatted = source;
+		for (const script of [...analysis.template?.scripts ?? []].sort((left, right) => right.start - left.start)) {
+			const input = getTemplateScriptInput(fileName, script, analysis.platform);
+			const result = await formatScript(input.source, input.fileName, {
+				platform: input.platform,
+				sourceKind: input.sourceKind,
+				language: input.language,
+				dialect: input.dialect,
+				format: async (virtualFile, code, required) => {
+					const { format } = await import("vite-plus/fmt");
+					return format(virtualFile, code, {
+						...settings,
+						...required
+					});
+				}
+			});
+			if (result.diagnostics.some((diagnostic) => diagnostic.severity === "error")) throw new LanguageError(fileName, result.diagnostics.map((diagnostic) => ({
+				...diagnostic,
+				start: diagnostic.start + script.start,
+				end: diagnostic.end + script.start
+			})));
+			formatted = formatted.slice(0, script.start) + result.code + formatted.slice(script.end);
+		}
+		return formatTemplate(formatted, fileName, settings);
+	}
+	const { format } = await import("vite-plus/fmt").catch((cause) => {
+		throw new Error("脚本与样式格式化需要项目安装 Vite+ >=1.2.0。", { cause });
+	});
+	if (isScriptModuleFile(normalized) || options.dialect) {
+		const result = await formatScript(source, fileName, {
+			platform: profile?.platform,
+			sourceKind: options.sourceKind,
+			dialect: options.dialect,
+			language: options.language,
+			format: (virtualFile, code, required) => format(virtualFile, code, {
+				...settings,
+				...required
+			})
+		});
+		if (result.diagnostics.some((diagnostic) => diagnostic.severity === "error")) throw new LanguageError(fileName, result.diagnostics);
+		return result.code;
+	}
+	const result = await format(STYLE_EXTENSIONS.some((extension) => normalized.endsWith(extension)) ? `${fileName}.css` : fileName, source, settings);
+	if (result.errors.length > 0) throw new Error(`${fileName}: ${result.errors.map((error) => error.message).join("\n")}`);
+	return result.code;
+}
+export { formatDocument };

package/dist/options-CitIeLO-.mjs

@@ -0,0 +1,15 @@
+// src/options.ts
+const formatOptions = {
+	tabWidth: 2,
+	useTabs: false,
+	singleQuote: true,
+	semi: false,
+	trailingComma: "all",
+	endOfLine: "lf",
+	insertFinalNewline: true,
+	htmlWhitespaceSensitivity: "strict",
+	sortImports: false,
+	sortPackageJson: false,
+	sortTailwindcss: false
+};
+export { formatOptions as t };

package/dist/prepare-D65ZFJWl.mjs

@@ -0,0 +1,88 @@
+import { nativeFormatIgnorePatterns, recommended } from "./index.mjs";
+import { formatDocument } from "./languages/index.mjs";
+import { STYLE_EXTENSIONS } from "@weapp-vite/language-service";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { analyzeProject, collectProjectFiles, isNativeDocument } from "@weapp-vite/language-service/project";
+import picomatch from "picomatch";
+// src/project/config.ts
+const LANGUAGE_EXTENSION = {
+	"javascript": "js",
+	"jsx": "jsx",
+	"typescript": "ts",
+	"tsx": "tsx",
+	"json": "json",
+	"jsonc": "jsonc",
+	"json5": "json5",
+	"css": "css",
+	"scss": "scss",
+	"less": "less",
+	"graphql": "graphql",
+	"yaml": "yaml",
+	"markdown": "md",
+	"toml": "toml",
+	"html": "html",
+	"angular-html": "component.html",
+	"vue": "vue",
+	"svelte": "svelte",
+	"astro": "astro",
+	"handlebars": "hbs",
+	"mdx": "mdx"
+};
+/** 文件收集和关联由项目层处理，格式化引擎只接收当前文件的选项。 */
+function toFormatOptions(config) {
+	const { associations: _associations, ignorePatterns: _ignorePatterns, overrides: _overrides, ...options } = config;
+	return options;
+}
+/** CLI 与编辑器对项目相对路径应用同一份文件覆盖及语言关联。 */
+function resolveDocumentFormatOptions(fileName, config) {
+	fileName = fileName.replaceAll("\\", "/").replace(/^\.\//, "");
+	const matches = (files, excludeFiles = []) => picomatch(files, { dot: true })(fileName) && !picomatch(excludeFiles, { dot: true })(fileName);
+	let options = toFormatOptions(config);
+	for (const override of config.overrides ?? []) if (matches(override.files, override.excludeFiles)) options = {
+		...options,
+		...override.options
+	};
+	let virtualFile = fileName;
+	if (!isNativeDocument(fileName) && !STYLE_EXTENSIONS.some((extension) => fileName.toLowerCase().endsWith(extension))) {
+		for (const association of config.associations ?? []) if (matches(association.files, association.excludeFiles)) virtualFile = `${fileName}.${LANGUAGE_EXTENSION[association.language]}`;
+	}
+	return {
+		fileName: virtualFile,
+		options
+	};
+}
+// src/project/prepare.ts
+const STANDARD_FILE = /\.(?:[cm]?[jt]sx?|json[5c]?|css|scss|less|html?|vue|ya?ml|md|markdown|mdx|graphql|gql|toml|svelte|astro|hbs|handlebars)$/i;
+/** 所有文件先在内存完成解析、方言和格式校验，再交给调用方一次提交。 */
+async function prepareFormatting(root, inputs, config, language) {
+	const ignores = [...recommended.ignorePatterns, ...config.ignorePatterns ?? []].filter((pattern) => !nativeFormatIgnorePatterns.includes(pattern));
+	const files = await collectProjectFiles(root, inputs, ignores);
+	const native = new Map((await analyzeProject(root, inputs, language, ignores)).map((document) => [document.file, document]));
+	const candidates = [];
+	for (const file of files) {
+		const fileName = path.relative(root, file).split(path.sep).join("/");
+		const settings = resolveDocumentFormatOptions(fileName, config);
+		if (!isNativeDocument(file) && !STANDARD_FILE.test(file) && !STYLE_EXTENSIONS.some((extension) => file.endsWith(extension)) && settings.fileName === fileName) continue;
+		const source = native.get(file)?.source ?? await readFile(file, "utf8");
+		const document = native.get(file);
+		if (document && !document.analysis.valid) throw new Error(document.analysis.diagnostics.filter((diagnostic) => diagnostic.severity === "error").map((diagnostic) => `${fileName}:${diagnostic.start + 1}: ${diagnostic.message}`).join("\n"));
+		const formatted = await formatDocument(source, settings.fileName, {
+			...settings.options,
+			...language,
+			...document ? {
+				sourceKind: document.input.sourceKind,
+				dialect: document.input.dialect,
+				language: document.input.language
+			} : {},
+			...document?.platform ? { platform: document.platform } : {}
+		});
+		candidates.push({
+			file,
+			source,
+			formatted
+		});
+	}
+	return candidates;
+}
+export { resolveDocumentFormatOptions as n, prepareFormatting as t };

package/dist/project/public.d.mts

@@ -0,0 +1,16 @@
+import { LanguageOptions } from "@weapp-vite/language-service";
+import { ProjectLanguageConfig, loadProjectConfig, resolveProjectDocumentInput, resolveProjectReference } from "@weapp-vite/language-service/project";
+import { FormatConfig, OxfmtConfig } from "vite-plus/fmt";
+/** CLI 与编辑器对项目相对路径应用同一份文件覆盖及语言关联。 */
+export declare function resolveDocumentFormatOptions(fileName: string, config: OxfmtConfig): {
+  fileName: string;
+  options: FormatConfig;
+};
+interface FormatCandidate {
+  file: string;
+  source: string;
+  formatted: string;
+}
+/** 所有文件先在内存完成解析、方言和格式校验，再交给调用方一次提交。 */
+declare function prepareFormatting(root: string, inputs: string[], config: OxfmtConfig, language: LanguageOptions): Promise<FormatCandidate[]>;
+export { type FormatCandidate, type ProjectLanguageConfig, loadProjectConfig, prepareFormatting as prepareProjectFormatting, resolveProjectDocumentInput, resolveProjectReference };

package/dist/project/public.mjs

@@ -0,0 +1,3 @@
+import { n as resolveDocumentFormatOptions, t as prepareFormatting } from "../prepare-D65ZFJWl.mjs";
+import { loadProjectConfig, resolveProjectDocumentInput, resolveProjectReference } from "@weapp-vite/language-service/project";
+export { loadProjectConfig, prepareFormatting as prepareProjectFormatting, resolveDocumentFormatOptions, resolveProjectDocumentInput, resolveProjectReference };

package/dist/wxml/index.d.mts

@@ -0,0 +1,3 @@
+import { FormatConfig } from "vite-plus/fmt";
+/** 兼容原有 API：只重排标签，保留文本、表达式、属性原文和内联脚本。 */
+export declare function formatWxml(source: string, fileName?: string, options?: FormatConfig): Promise<string>;

package/dist/wxml/index.mjs

@@ -0,0 +1,11 @@
+import { t as formatOptions } from "../options-CitIeLO-.mjs";
+import { formatTemplate } from "@weapp-vite/language-service";
+// src/wxml/index.ts
+/** 兼容原有 API：只重排标签，保留文本、表达式、属性原文和内联脚本。 */
+async function formatWxml(source, fileName = "component.wxml", options = {}) {
+	return formatTemplate(source, fileName, {
+		...formatOptions,
+		...options
+	});
+}
+export { formatWxml };

package/package.json

@@ -1,6 +1,96 @@
 {
   "name": "@weapp-vite/oxfmt",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "type": "module",
+  "version": "0.0.0",
+  "description": "Oxfmt formatting preset for weapp-vite mini-program projects",
+  "license": "MIT",
+  "homepage": "https://vite.weapp.dev/packages/oxfmt",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/weapp-vite/weapp-vite.git",
+    "directory": "packages/oxfmt"
+  },
+  "bugs": {
+    "url": "https://github.com/weapp-vite/weapp-vite/issues"
+  },
+  "keywords": [
+    "weapp-vite",
+    "miniprogram",
+    "oxfmt",
+    "formatter"
+  ],
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    },
+    "./wxml": {
+      "types": "./dist/wxml/index.d.mts",
+      "import": "./dist/wxml/index.mjs"
+    },
+    "./languages": {
+      "types": "./dist/languages/index.d.mts",
+      "import": "./dist/languages/index.mjs"
+    },
+    "./project": {
+      "types": "./dist/project/public.d.mts",
+      "import": "./dist/project/public.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "bin": {
+    "weapp-vite-format": "./dist/cli.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": "^22.23.4 || ^24.22.1 || >=26.12.1"
+  },
+  "peerDependencies": {
+    "vite-plus": ">=1.2.0 <2"
+  },
+  "peerDependenciesMeta": {
+    "vite-plus": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@weapp-vite/language-service": "0.0.0",
+    "execa": "^10.2.1",
+    "picomatch": "^4.0.7"
+  },
+  "devDependencies": {
+    "@types/picomatch": "^4.0.3",
+    "postcss": "^8.5.32",
+    "postcss-value-parser": "4.2.0",
+    "typescript": "^6.0.3",
+    "vite-plus": "1.2.0",
+    "vitest": "^5.0.5"
+  },
+  "tsd": {
+    "compilerOptions": {
+      "module": "NodeNext",
+      "moduleResolution": "NodeNext",
+      "strict": true,
+      "skipLibCheck": false
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run --config ./vitest.config.ts",
+    "test:types": "pnpm build && pnpm run test:types:check",
+    "test:types:check": "tsd --files \"test-d/**/*.test-d.ts\"",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix"
+  }
 }