@weapp-core/schematics 6.0.4 → 6.1.0

package/dist/index.cjs

@@ -16,15 +16,15 @@ var __copyProps = (to, from, except, desc) => {
 	}
 	return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
 	value: mod,
 	enumerable: true
 }) : target, mod));
 //#endregion
 let node_process = require("node:process");
-node_process = __toESM(node_process);
+node_process = __toESM(node_process, 1);
 let zod = require("zod");
-zod = __toESM(zod);
+zod = __toESM(zod, 1);
 //#region src/constants.ts
 const SCHEMA_BASE = (node_process.default.env.WEAPP_SCHEMA_BASE ?? "https://vite.icebreaker.top").replace(/\/$/, "");
 function schemaUrl(filename) {
@@ -142,7 +142,455 @@ function generateWxss$1() {
 	return "";
 }
 //#endregion
+//#region scripts/config/app.json
+var app_default = {
+	source: "https://developers.weixin.qq.com/miniprogram/dev/reference/configuration/app.html",
+	fields: {
+		"entryPagePath": {
+			"type": "string",
+			"description": "小程序默认启动首页。"
+		},
+		"pages": {
+			"type": "string[]",
+			"required": true,
+			"description": "页面路径列表。"
+		},
+		"window": {
+			"type": "object",
+			"description": "全局的默认窗口表现。"
+		},
+		"tabBar": {
+			"type": "object",
+			"description": "底部 tab 栏的表现。"
+		},
+		"networkTimeout": {
+			"type": "object",
+			"description": "网络超时时间。"
+		},
+		"debug": {
+			"type": "boolean",
+			"description": "是否开启 debug 模式。"
+		},
+		"functionalPages": {
+			"type": "boolean",
+			"description": "是否启用插件功能页。",
+			"x-wechat-min-version": "2.1.0"
+		},
+		"subpackages": {
+			"type": "object[]",
+			"description": "分包结构配置。",
+			"x-wechat-min-version": "1.7.3"
+		},
+		"workers": {
+			"type": "string | object",
+			"description": "Worker 代码放置的目录。"
+		},
+		"requiredBackgroundModes": {
+			"type": "string[]",
+			"description": "需要在后台使用的能力。"
+		},
+		"requiredPrivateInfos": {
+			"type": "string[]",
+			"description": "调用的地理位置相关隐私接口。"
+		},
+		"plugins": {
+			"type": "object",
+			"description": "使用到的插件。"
+		},
+		"preloadRule": {
+			"type": "object",
+			"description": "分包预下载规则。"
+		},
+		"resizable": {
+			"type": "boolean",
+			"description": "PC 小程序是否支持用户任意改变窗口大小（包括最大化窗口）；iPad 小程序是否支持屏幕旋转。默认关闭",
+			"x-wechat-min-version": "2.3.0"
+		},
+		"usingComponents": {
+			"type": "object",
+			"description": "全局自定义组件配置。"
+		},
+		"permission": {
+			"type": "object",
+			"description": "小程序接口权限相关设置。"
+		},
+		"sitemapLocation": {
+			"type": "string",
+			"description": "指明 sitemap.json 的位置。"
+		},
+		"style": {
+			"type": "string",
+			"description": "指定使用升级后的weui样式",
+			"x-wechat-min-version": "2.8.0"
+		},
+		"useExtendedLib": {
+			"type": "object",
+			"description": "指定需要引用的扩展库。"
+		},
+		"entranceDeclare": {
+			"type": "object",
+			"description": "微信消息用小程序打开。"
+		},
+		"darkmode": {
+			"type": "boolean",
+			"description": "小程序支持 DarkMode。"
+		},
+		"themeLocation": {
+			"type": "string",
+			"description": "指明 theme.json 的位置。"
+		},
+		"lazyCodeLoading": {
+			"type": "string",
+			"description": "配置自定义组件代码按需注入。"
+		},
+		"singlePage": {
+			"type": "object",
+			"description": "单页模式相关配置",
+			"x-wechat-min-version": "2.12.0"
+		},
+		"supportedMaterials": {
+			"type": "object",
+			"description": "聊天素材小程序打开相关配置。"
+		},
+		"serviceProviderTicket": {
+			"type": "string",
+			"description": "定制化型服务商票据"
+		},
+		"embeddedAppIdList": {
+			"type": "string[]",
+			"description": "半屏小程序 appId 列表。"
+		},
+		"halfPage": {
+			"type": "object",
+			"description": "视频号直播半屏场景设置。"
+		},
+		"debugOptions": {
+			"type": "object",
+			"description": "调试相关配置。"
+		},
+		"enablePassiveEvent": {
+			"type": "object | boolean",
+			"description": "touch 事件监听是否为 passive",
+			"x-wechat-min-version": "2.24.1"
+		},
+		"resolveAlias": {
+			"type": "object",
+			"description": "自定义模块映射规则。"
+		},
+		"renderer": {
+			"type": "string",
+			"description": "全局默认的渲染后端。",
+			"enum": ["webview", "skyline"]
+		},
+		"rendererOptions": {
+			"type": "object",
+			"description": "渲染后端选项。"
+		},
+		"componentFramework": {
+			"type": "string",
+			"description": "组件框架。"
+		},
+		"miniApp": {
+			"type": "object",
+			"description": "多端模式场景接入身份管理服务时开启小程序授权页相关配置，详见相关文档"
+		},
+		"static": {
+			"type": "object",
+			"description": "正常情况下默认所有资源文件都被打包发布到所有平台，可以通过 static 字段配置特定每个目录/文件只能发布到特定的平台(多端场景) 相关文档"
+		},
+		"convertRpxToVw": {
+			"type": "boolean",
+			"description": "是否将 rpx 单位转换为 vw 单位。"
+		},
+		"chatTools": {
+			"type": "object",
+			"description": "聊天工具分包配置",
+			"x-wechat-min-version": "3.7.8"
+		},
+		"subPackages": {
+			"type": "object[]",
+			"description": "分包结构配置（兼容别名）。"
+		},
+		"appBar": {
+			"type": "object",
+			"description": "AppBar 配置。"
+		}
+	}
+};
+//#endregion
+//#region scripts/config/component.json
+var component_default = {
+	source: "https://developers.weixin.qq.com/miniprogram/dev/framework/custom-component/",
+	fields: {
+		"component": {
+			"type": "boolean",
+			"default": true,
+			"description": "声明当前配置对应自定义组件。"
+		},
+		"styleIsolation": {
+			"type": "string",
+			"enum": [
+				"isolated",
+				"apply-shared",
+				"shared"
+			],
+			"default": "isolated",
+			"description": "组件样式隔离策略。"
+		},
+		"componentGenerics": {
+			"type": "object",
+			"description": "组件泛型配置。"
+		},
+		"componentPlaceholder": {
+			"type": "object",
+			"description": "组件占位配置。"
+		},
+		"componentFramework": {
+			"type": "string",
+			"description": "组件框架。"
+		},
+		"usingComponents": {
+			"type": "object",
+			"description": "组件依赖的自定义组件配置。"
+		}
+	}
+};
+//#endregion
+//#region scripts/config/page.json
+var page_default = {
+	source: "https://developers.weixin.qq.com/miniprogram/dev/reference/configuration/page.html",
+	fields: {
+		"navigationBarBackgroundColor": {
+			"type": "HexColor",
+			"default": "#000000",
+			"description": "导航栏背景颜色，如 #000000"
+		},
+		"navigationBarTextStyle": {
+			"type": "string",
+			"default": "white",
+			"description": "导航栏标题、状态栏颜色，仅支持 black / white"
+		},
+		"navigationBarTitleText": {
+			"type": "string",
+			"description": "导航栏标题文字内容"
+		},
+		"navigationStyle": {
+			"type": "string",
+			"default": "default",
+			"description": "导航栏样式，仅支持以下值：default 默认样式 custom 自定义导航栏，只保留右上角胶囊按钮。",
+			"x-wechat-min-version": "7.0.0"
+		},
+		"homeButton": {
+			"type": "boolean",
+			"default": "false",
+			"description": "在非首页、非页面栈最底层页面或非tabbar内页面中的导航栏展示home键",
+			"x-wechat-min-version": "8.0.24"
+		},
+		"backgroundColor": {
+			"type": "HexColor",
+			"default": "#ffffff",
+			"description": "窗口的背景色"
+		},
+		"backgroundColorContent": {
+			"type": "HexColor",
+			"default": "#RRGGBBAA",
+			"description": "页面容器背景色。"
+		},
+		"backgroundTextStyle": {
+			"type": "string",
+			"default": "dark",
+			"description": "下拉 loading 的样式，仅支持 dark / light"
+		},
+		"backgroundColorTop": {
+			"type": "string",
+			"default": "#ffffff",
+			"description": "顶部窗口的背景色，仅 iOS 支持",
+			"x-wechat-min-version": "6.5.16"
+		},
+		"backgroundColorBottom": {
+			"type": "string",
+			"default": "#ffffff",
+			"description": "底部窗口的背景色，仅 iOS 支持",
+			"x-wechat-min-version": "6.5.16"
+		},
+		"enablePullDownRefresh": {
+			"type": "boolean",
+			"default": "false",
+			"description": "是否开启当前页面下拉刷新。详见 Page.onPullDownRefresh"
+		},
+		"onReachBottomDistance": {
+			"type": "number",
+			"default": "50",
+			"description": "页面上拉触底事件触发时距页面底部距离，单位为px。详见 Page.onReachBottom"
+		},
+		"pageOrientation": {
+			"type": "string",
+			"default": "portrait",
+			"description": "屏幕旋转设置，支持 auto / portrait / landscape 详见 响应显示区域变化",
+			"x-wechat-min-version": "2.4.0"
+		},
+		"disableScroll": {
+			"type": "boolean",
+			"default": false,
+			"description": "设置为 true 时页面整体不能上下滚动。"
+		},
+		"usingComponents": {
+			"type": "object",
+			"description": "页面自定义组件配置。"
+		},
+		"initialRenderingCache": {
+			"type": "string",
+			"enum": [
+				"static",
+				"dynamic",
+				"capture"
+			],
+			"description": "页面初始渲染缓存配置。"
+		},
+		"style": {
+			"type": "string",
+			"default": "default",
+			"description": "启用新版的组件样式",
+			"x-wechat-min-version": "2.10.2"
+		},
+		"singlePage": {
+			"type": "object",
+			"default": "否",
+			"description": "单页模式相关配置",
+			"x-wechat-min-version": "2.12.0"
+		},
+		"restartStrategy": {
+			"type": "string",
+			"default": "homePage",
+			"description": "重新启动策略配置",
+			"x-wechat-min-version": "2.8.0"
+		},
+		"handleWebviewPreload": {
+			"type": "string",
+			"default": "static",
+			"description": "控制预加载下个页面的时机。支持 static / manual / auto",
+			"x-wechat-min-version": "2.15.0"
+		},
+		"visualEffectInBackground": {
+			"type": "string",
+			"default": "否",
+			"description": "切入系统后台时，隐藏页面内容，保护用户隐私。支持 hidden / none，若对页面单独设置则会覆盖全局的配置，详见 全局配置",
+			"x-wechat-min-version": "2.15.0"
+		},
+		"enablePassiveEvent": {
+			"type": "object | boolean",
+			"default": "否",
+			"description": "事件监听是否为 passive，若对页面单独设置则会覆盖全局的配置，详见 全局配置",
+			"x-wechat-min-version": "2.24.1"
+		},
+		"renderer": {
+			"type": "string",
+			"enum": ["webview", "skyline"],
+			"description": "页面渲染后端。"
+		},
+		"rendererOptions": {
+			"type": "object",
+			"default": "否",
+			"description": "渲染后端选项，详情相关文档",
+			"x-wechat-min-version": "3.1.0"
+		},
+		"componentFramework": {
+			"type": "string",
+			"description": "组件框架。"
+		},
+		"styleIsolation": {
+			"type": "string",
+			"enum": [
+				"page-isolated",
+				"page-apply-shared",
+				"page-shared"
+			],
+			"description": "页面样式隔离策略。"
+		}
+	}
+};
+//#endregion
+//#region scripts/config/plugin.json
+var plugin_default = {
+	source: "https://developers.weixin.qq.com/miniprogram/dev/framework/plugin/development.html",
+	fields: {
+		"publicComponents": {
+			"type": "object",
+			"description": "插件对外提供的自定义组件。"
+		},
+		"pages": {
+			"type": "object",
+			"description": "插件页面映射。"
+		},
+		"main": {
+			"type": "string",
+			"description": "插件主入口文件。"
+		}
+	}
+};
+//#endregion
+//#region scripts/config/sitemap.json
+var sitemap_default = {
+	source: "https://developers.weixin.qq.com/miniprogram/dev/framework/sitemap.html",
+	fields: { "rules": {
+		"type": "object[]",
+		"required": true,
+		"description": "sitemap 匹配规则列表。"
+	} }
+};
+//#endregion
+//#region scripts/config/theme.json
+var theme_default = {
+	source: "https://developers.weixin.qq.com/miniprogram/dev/framework/view/theme.html",
+	fields: {
+		"light": {
+			"type": "object",
+			"required": true,
+			"description": "浅色主题配置。"
+		},
+		"dark": {
+			"type": "object",
+			"required": true,
+			"description": "深色主题配置。"
+		}
+	}
+};
+//#endregion
 //#region scripts/json.ts
+function metadataProperty(type) {
+	const normalized = type.toLowerCase().replace(/\s+/g, "");
+	if (normalized.includes("|")) return { anyOf: normalized.split("|").map(metadataProperty) };
+	if (normalized.endsWith("[]")) return {
+		type: "array",
+		items: metadataProperty(normalized.slice(0, -2))
+	};
+	if (normalized === "boolean") return { type: "boolean" };
+	if (normalized === "number") return { type: "number" };
+	if (normalized === "hexcolor" || normalized === "string") return { type: "string" };
+	return {
+		type: "object",
+		additionalProperties: true
+	};
+}
+function enrichJsonSchema(schema, metadata) {
+	const properties = schema.properties ?? {};
+	for (const [name, field] of Object.entries(metadata.fields)) {
+		if (name.includes(".")) continue;
+		const property = properties[name] ?? metadataProperty(field.type);
+		if (field.description) property.description = field.description;
+		if (field.default !== void 0 && property.default === void 0) property.default = field.default;
+		if (field.enum?.length) property.enum = field.enum;
+		if (field["x-wechat-min-version"]) property["x-wechat-min-version"] = field["x-wechat-min-version"];
+		properties[name] = property;
+		if (field.required && !schema.required?.includes(name)) schema.required = [...schema.required ?? [], name];
+	}
+	schema.properties = properties;
+	schema["x-wechat-doc"] = metadata.source;
+	return schema;
+}
+function createJsonSchema(schema, metadata) {
+	return enrichJsonSchema(zod.toJSONSchema(schema), metadata);
+}
 const metaSchema = zod.object({ $schema: zod.string() }).partial();
 const sharedSchema = zod.object({
 	usingComponents: zod.record(zod.string(), zod.string()),
@@ -178,7 +626,11 @@ const windowSchema = zod.looseObject({
 		"landscape"
 	]).default("portrait"),
 	restartStrategy: zod.enum(["homePage", "homePageAndLatestPage"]).default("homePage"),
-	initialRenderingCache: zod.enum(["static", "dynamic"]),
+	initialRenderingCache: zod.enum([
+		"static",
+		"dynamic",
+		"capture"
+	]),
 	visualEffectInBackground: zod.enum(["none", "hidden"]).default("none"),
 	handleWebviewPreload: zod.enum([
 		"static",
@@ -257,7 +709,8 @@ const AppSchema = zod.looseObject({
 	miniApp: zod.looseObject({}),
 	static: zod.looseObject({}),
 	convertRpxToVw: zod.boolean(),
-	appBar: zod.looseObject({})
+	appBar: zod.looseObject({}),
+	chatTools: zod.looseObject({})
 }).partial().required({ pages: true }).extend(appAndPageSharedSchema.shape).describe("全局配置, 小程序根目录下的 app.json 文件用来对微信小程序进行全局配置。");
 const PageSchema = zod.looseObject({
 	backgroundColorContent: zod.string().default("#RRGGBBAA"),
@@ -277,9 +730,9 @@ const ComponentSchema = zod.looseObject({
 	]).default("isolated"),
 	componentGenerics: zod.looseObject({})
 }).partial().extend(pageAndComponentSharedSchema.shape).describe("自定义组件配置");
-const AppJsonSchema = zod.toJSONSchema(AppSchema);
-const PageJsonSchema = zod.toJSONSchema(PageSchema);
-const ComponentJsonSchema = zod.toJSONSchema(ComponentSchema);
+const AppJsonSchema = createJsonSchema(AppSchema, app_default);
+const PageJsonSchema = createJsonSchema(PageSchema, page_default);
+const ComponentJsonSchema = createJsonSchema(ComponentSchema, component_default);
 const ThemeSchema = zod.looseObject({
 	light: zod.looseObject({}),
 	dark: zod.looseObject({})
@@ -301,14 +754,13 @@ const SitemapSchema = zod.looseObject({ rules: zod.object({
 	matching: true,
 	priority: true
 }).array() }).extend(metaSchema.shape).describe("https://developers.weixin.qq.com/miniprogram/dev/reference/configuration/sitemap.html");
-const ThemeJsonSchema = zod.toJSONSchema(ThemeSchema);
-const SitemapJsonSchema = zod.toJSONSchema(SitemapSchema);
-const PluginSchema = zod.looseObject({
+const ThemeJsonSchema = createJsonSchema(ThemeSchema, theme_default);
+const SitemapJsonSchema = createJsonSchema(SitemapSchema, sitemap_default);
+const PluginJsonSchema = createJsonSchema(zod.looseObject({
 	publicComponents: zod.record(zod.string(), zod.string()),
 	pages: zod.record(zod.string(), zod.string()),
 	main: zod.string()
-}).partial().describe("https://developers.weixin.qq.com/miniprogram/dev/framework/plugin/development.html#%E6%8F%92%E4%BB%B6%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6");
-const PluginJsonSchema = zod.toJSONSchema(PluginSchema);
+}).partial().describe("https://developers.weixin.qq.com/miniprogram/dev/framework/plugin/development.html#%E6%8F%92%E4%BB%B6%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6"), plugin_default);
 //#endregion
 //#region src/json.ts
 /**