@dp-bohrium/widget-cli 0.5.0 → 0.5.1

package/AGENTS.md

@@ -61,7 +61,7 @@ bohr-widget help [<命令路径>]
 ## 执行顺序
 
 1. `create` 创建工程后检查返回的 `projectRoot`、`manifestPath`、`packagePath`、`profile`、`name` 和可选
-   `panelId`；工作区文件面板固定使用 `--panel-id workspace-files`，CLI 会补齐三项只读文件能力。
+   `panelId`。Panel ID 可自定义；如需文件浏览面板预设，可使用 `--panel-id workspace-files`，CLI 会补齐三项只读文件能力。
    `warnings` 说明目录名不是合法标识符时 `manifest.name` 已回退为 `widget-<hash>`。
    将 `widget-toolchain.json` 与包管理器 lockfile 一起提交；不手改 profile 绕过版本检查。
    `--extensions` 只用于 file-preview，填写不带前导点的小写扩展名；`--tool` 将默认激活信号替换为
@@ -140,8 +140,8 @@ bohr-widget help [<命令路径>]
 
 ## 在 Panel 中编辑工作区文件
 
-用户要在文件树面板里直接保存时，用 `create --template panel --panel-id workspace-files` 创建工程，
-再在作者 Manifest 的 `capabilities.files` 中加上 `write: true`（模板默认只有 list/metadata/read）。
+开发文件树面板时，可用 `create --template panel --panel-id workspace-files` 选择文件浏览预设。
+需要保存文件时，在作者 Manifest 的 `capabilities.files` 中加上 `write: true`（模板默认只有 list/metadata/read），并确认目标工作台支持写入。
 
 - 文件引用只取自 `content.data.root` 和 `files.list` 结果中 `kind: "file"` 的项；不拼路径，不自造 id。
 - 运行时没有 `files.write` grant 时保持只读并说明原因；较早的 Host 只向 file-preview 签发写权限。
@@ -173,8 +173,8 @@ profile。`ready` 在此基础上还要求
 旧工程直接声明 contracts 或 CLI 时会失败；先在独立候选中改用 SDK 出口并移除旧包，
 重新安装、构建和验收。锁和 receipt 为 v2，integration 与 toolchain 为 v3；不自动回选旧执行器。
 保留已有作者源码、跨 profile 升级或准备候选工程时，先读[准备迁移候选](https://dev.dp.tech/bohrium-widget-sdk/guides/migration)，按指南完成候选审阅、plan/apply 和后续验收。
-Host 或控制面可使用 `@dp-bohrium/widget-contracts`，也可使用 SDK 的协议、Schema 和 conformance
-入口；固定与目标 SDK 配套的精确版本，不混用不同版本的协议资产。
+Host 或控制面统一使用 SDK 的 `/contracts`、Schema 和 conformance 入口；固定与目标 SDK 配套的
+精确版本，不混用不同版本的协议资产。
 
 ## 宿主兼容声明
 
@@ -227,6 +227,14 @@ SDK package.json 或 `unknown` 解释为线上平台已兼容。
 `/core` 是模板、compiler、校验和打包的底层 API；直接调用它时，调用方负责工程锁定、实际依赖
 和宿主兼容策略。完整预检由上述命令提供。`sdkVersion` 不能用来伪造另一代 compiler 的版本。
 
+仓库内部的工程发现、检查、资源收集、ZIP 与摘要实现在 `src/project/`，供命令、维护脚本和
+Demo 服务端复用；纯 Manifest 编译由 SDK 维护。Gallery 路由、展示状态和 Render 投影归 Demo，
+不进入通用工程模块；Demo 浏览器通过服务端导出 ZIP，不导入 Node 工程实现。
+
+仓库构建由中央准备器生成私有 SDK 工具输入和共享 Node 产物，再组装 CLI 的 `dist/assets`。
+CLI 完整构建不调用 SDK 完整构建，也不要求 SDK 最终 `dist` 已存在。SDK 内嵌命令与 CLI
+共用 Node 实现，但各自读取安装位置的工具链身份；私有 `.build` 不进入发布物。
+
 `--open` 优先协商 Widget Development Host v1，旧宿主才回落 legacy profile 并告警。
 legacy profile 已废弃，目标 Host 应升级到当前协议。
 descriptor、status、events、control、一次性 claim 和 session token 都通过命令返回的 URL

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # `@dp-bohrium/widget-cli` 变更记录
 
+## 0.5.1
+
+### Patch Changes
+
+- 75c4148: 创建 Panel 时不再将自定义 ID 作为警告，成功输出明确说明 ID 可自定义。同步帮助和 Agent 指引，将 `workspace-files` 说明为可选的文件浏览面板预设。
+- 0578f90: 破坏性变更：将独立 Contracts 包合入 SDK，统一通过 SDK 的 `/contracts`、`/schemas/*.json` 和
+  `/conformance/*` 入口提供协议类型、Schema 与校验语料，不再独立发行 Contracts。
+- 75c4148: 创建 Widget 工程时生成简短的 AGENTS.md，并在 README 与命令输出中直接提供固定 SDK 版本、公开文档、Agent 阅读入口和后续命令。开发前先确认目标工作台能力，安装依赖后使用工程内命令构建、校验和打包，再完成真实 Host 验收。
+
 ## 0.5.0
 
 ### Minor Changes

package/assets/toolchain.json

@@ -1,10 +1,10 @@
 {
   "formatVersion": 3,
   "packageName": "@dp-bohrium/widget-cli",
-  "cli": "0.5.0",
+  "cli": "0.5.1",
   "profile": {
-    "id": "widget-sdk-0.7.0",
-    "sdk": "0.7.0"
+    "id": "widget-sdk-0.8.0",
+    "sdk": "0.8.0"
   },
   "protocol": {
     "schemaVersion": 1,
@@ -20,9 +20,9 @@
     "llms": "https://dev.dp.tech/bohrium-widget-sdk/llms.txt"
   },
   "digests": {
-    "compiler": "sha256:6b6ac1585a3f2bc0f8b2717b2475584a502a9026045b840337547528b7a063b0",
-    "validators": "sha256:8712fb004d9decf1eeae56c1e7057092a8abc0eeae1093c29546bb56e3261922",
+    "compiler": "sha256:92822832e958aa5448312194de3d1d4e8515721be2862d978abaefe2143c9c71",
+    "validators": "sha256:47f6793e099e0b4c56da28f42e6ea0c79aecd9cc8915e1746fbd24f999bf05d9",
     "schemas": "sha256:ee3023e337559bbf83c096365fe1eb49ce6809a880a5e5d65e2a2f6fd53a7ddb",
-    "templates": "sha256:60f555788f33fb38d707525f571d13b6fa78875be7d2d87cb864db6926a52ccb"
+    "templates": "sha256:87cf4085fb2769b1b874e9f331258c024f5826c31d0937a6e046b5511b5567c9"
   }
 }

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as normalizeArchivePath, c as compileAuthorManifest, i as prepareWidgetPackage, n as scaffoldDshWidget, o as checkWidgetProject, s as resolveWidgetProjects, t as auditDshPlugin } from "./dsh-BkPMTfZ_.mjs";
+import { a as normalizeArchivePath, c as compileAuthorManifest, i as prepareWidgetPackage, n as scaffoldDshWidget, o as checkWidgetProject, s as resolveWidgetProjects, t as auditDshPlugin } from "./dsh-BlpXm2Bv.mjs";
 import { createHash, randomBytes, timingSafeEqual } from "node:crypto";
 import { constants, existsSync, lstatSync, readFileSync, readdirSync, realpathSync, statSync, watch } from "node:fs";
 import { chmod, lstat, mkdir, mkdtemp, open, readFile, readdir, realpath, rename, rm, rmdir, stat, writeFile } from "node:fs/promises";
@@ -1269,13 +1269,14 @@ function commandTopics(context) {
 			options: [
 				"--template <模板>           panel 或 file-preview（默认 panel）",
 				"--ui <模式>                 vanilla 或 react（默认 vanilla）",
-				"--panel-id <id>             仅用于 panel；默认取规范化后的工程名",
+				"--panel-id <id>             自定义面板标识，仅用于 panel；默认取规范化后的工程名",
 				"--extensions <列表>         仅用于 file-preview；逗号分隔扩展名（默认 txt）",
 				"--tool <名称>               按指定工具成功结果激活，不注册工具卡片",
 				HOST_OPTION,
 				JSON_OPTION
 			],
 			examples: [
+				"bohr-widget create my-widget --ui react --panel-id my-widget",
 				"bohr-widget create workspace-browser --ui react --panel-id workspace-files",
 				"bohr-widget create text-preview --template file-preview --extensions txt,csv --ui vanilla --json",
 				"bohr-widget create search-panel --tool ScholarSearch --json"
@@ -1283,8 +1284,9 @@ function commandTopics(context) {
 			notes: [
 				`默认组合为 panel + vanilla；生成工程的构建环境要求 Node.js ${context.generatedProjectNode}。`,
 				"不会自动安装依赖；创建后进入目录，运行 pnpm install 或 npm install。",
-				"workspace-files 会补齐 files.list、files.metadata、files.read 和目录引用样例；文件树逻辑与夹具需自行实现。",
-				"其他 Panel id 需要 Host 预先注册和绑定；更改 id 不会自动接管宿主界面。",
+				"Panel ID 可自定义，用于工作台识别面板；打包后按目标工作台的安装流程加载。",
+				"workspace-files 是可选的文件浏览面板预设，会补齐 files.list、files.metadata、files.read 和目录引用样例；文件树界面与逻辑需自行实现。",
+				"生成 README.md 和 AGENTS.md；先读取项目指引与公开文档，再安装依赖和执行工程命令。",
 				"将 widget-toolchain.json 与包管理器 lockfile 一起保存。"
 			],
 			quickStart: true
@@ -1519,7 +1521,7 @@ SDK ${sdk}（协议与执行工具链均由 SDK 内置）
   CLI 要求 Node.js >=20；默认生成工程要求 Node.js ${generatedProjectNode}。
 
 典型开发流程：
-  pnpm dlx ${packageName} create my-widget --ui react --panel-id workspace-files
+  pnpm dlx ${packageName} create my-widget --template panel --ui react
   cd my-widget
   pnpm install
   pnpm exec bohr-widget build .
@@ -1554,7 +1556,7 @@ function renderHelp(path = [], context) {
 /**
 * 作者清单（VS Code 风格 `contributes` 清单）的本地静态检查。
 *
-* `@dp-bohrium/widget-contracts` 的 host schema 只在 `compileAuthorManifest` 之后生效，
+* SDK 的 host schema 只在 `compileAuthorManifest` 之后生效，
 * 而编译只保留宿主运行时需要的字段：作者的 `version`、`displayName` 和未知顶层键会被
 * 静默丢弃，于是"清单写错但 check 全绿"。这里只补下游永远看不到的作者侧约束，报错文案
 * 直接指向作者填的字段名。
@@ -1812,7 +1814,7 @@ async function validateProjectToolchain(projectRoot, toolchain, { requireInstall
 	]) for (const name of ["@dp-bohrium/widget-contracts", "@dp-bohrium/widget-cli"]) if (pkg[section]?.[name] !== void 0) throw failure("PROJECT_SDK_MISMATCH", "作者工程仍直接声明 contracts 或 CLI，需统一使用 SDK 入口", {
 		projectRoot: root,
 		package: name
-	}, ["作者工程统一依赖 SDK；独立 CLI 请在工具目录或通过 npx 使用，Contracts 独立包供 Host 等消费者使用。保留作者源码，在独立候选中移除重复依赖、重新安装和构建。"]);
+	}, ["作者工程统一依赖 SDK；协议从 SDK 的 /contracts 与 /schemas 出口读取。保留作者源码，在独立候选中移除重复依赖、重新安装和构建。"]);
 	const declared = {};
 	const installed = {};
 	for (const [key, name] of Object.entries(PACKAGES)) {
@@ -2413,11 +2415,35 @@ function projectPackage({ name, ui, sdkVersion }) {
 		}
 	};
 }
-function projectReadme({ name, template, ui, sourceFile, hostFile }) {
+function projectAgentGuide({ sdkVersion, sourceFile, hostFile, documentation, agentSetupUrl }) {
+	return `# 项目开发指引
+
+创建时 SDK：\`@dp-bohrium/widget-sdk@${sdkVersion}\`。
+
+以下路径均相对于本工程根目录：
+
+- \`${sourceFile}\`：本工程的 Widget 界面与业务逻辑，通常在这里修改功能。
+- \`${hostFile}\`：本工程的启动文件，调用 SDK 的 \`runWidgetHost\` 启动 Widget。
+- \`manifest.json\`：本工程的 Widget 声明。
+- \`samples/default.json\`：本工程的样例输入。
+
+本工程的依赖版本与工具链记录在 \`package.json\`、\`widget-toolchain.json\` 和包管理器 lockfile 中。
+
+阅读入口：
+
+- [README.md](./README.md)：本工程的环境、安装、命令和验收说明。
+- [开发 Agent 引导](${agentSetupUrl})：通用的能力选型与开发阅读路径。
+- [文档索引](${documentation.llms})：按当前任务查找指南、API 和示例。
+`;
+}
+function projectReadme({ name, template, ui, sourceFile, hostFile, sdkVersion, documentation, agentSetupUrl }) {
 	return `# ${name}
 
 Bohrium Widget ${template} 插件工程（${ui}）。
 
+创建时 SDK：\`@dp-bohrium/widget-sdk@${sdkVersion}\`。项目上下文与 Agent 阅读入口见 [AGENTS.md](./AGENTS.md)；安装依赖前即可读取[开发 Agent 引导](${agentSetupUrl})、[文档索引](${documentation.llms})和[快速开始](${documentation.quickStart})。
+文档独立更新；接口以本工程固定 SDK 和目标 Host 实际支持为准。
+
 默认构建器要求 Node.js \`${GENERATED_PROJECT_NODE}\`，高于执行器自身的 Node.js 20 要求。
 工程已经精确依赖提供命令的 \`${PROJECT_EXECUTOR_PACKAGE}\`；在本目录安装后使用本地命令，无需全局安装或源码仓库。
 
@@ -2431,7 +2457,7 @@ pnpm run widget:pack --json
 使用 npm 时，安装后可执行 \`npm run build\`、\`npm run check\`、\`npm run widget:pack\`；需要构建 receipt 时执行 \`npx --no-install bohr-widget build .\`。
 Widget ZIP 使用 \`pnpm run widget:pack\` 或 \`npm run widget:pack\`；\`pnpm pack\` 是制作 npm \`.tgz\` 包的内置命令。
 
-- 源码入口：${sourceFile}，由 ${hostFile} 调用 SDK 的 runWidgetHost 启动。
+- Widget 界面与业务逻辑在 ${sourceFile} 中；本工程的 ${hostFile} 调用 SDK 的 runWidgetHost 启动 Widget。
 - 高度链、布局与滚动策略直接写在 ${sourceFile} 中，样式随 activate 安装并在释放时清理；JSON 展示元素单独处理换行。
 - manifest.json 是作者清单，打包时由 CLI 编译为宿主清单。
 - 提交 widget-toolchain.json 与依赖 lockfile；dist/widget.js 与生成的 ZIP 不提交。
@@ -2983,6 +3009,17 @@ async function commandCreate(directory, options) {
 	await writeFile(join(root, "samples/default.json"), `${JSON.stringify(sample, null, 2)}\n`);
 	const sourceFile = options.ui === "react" ? "src/widget.tsx" : "src/widget.ts";
 	const hostFile = "src/widget-host.ts";
+	const documentation = getDocumentation();
+	const agentSetupUrl = new URL("agent-setup/prompt.md", documentation.url).href;
+	const projectGuidance = {
+		sdkVersion: sdkPackage.version,
+		sourceFile,
+		hostFile,
+		documentation,
+		agentSetupUrl
+	};
+	const readmePath = join(root, "README.md");
+	const agentGuidePath = join(root, "AGENTS.md");
 	const source = options.ui === "react" && template.reactSource ? template.reactSource({ name }) : typeof template.source === "function" ? template.source({
 		ui: options.ui,
 		name
@@ -2991,13 +3028,13 @@ async function commandCreate(directory, options) {
 	await writeFile(join(root, hostFile), template.hostSource({ sourceFile }));
 	await writeFile(join(root, "scripts/rename-iife.mjs"), `import { rename } from "node:fs/promises";\n\nawait rename("dist/widget.iife.js", "dist/widget.js");\n`);
 	await writeFile(join(root, ".gitignore"), "node_modules/\ndist/\n.artifacts/\n.widget-build-receipt.json\n*.zip\n");
-	await writeFile(join(root, "README.md"), projectReadme({
+	await writeFile(readmePath, projectReadme({
+		...projectGuidance,
 		name,
 		template: options.template,
-		ui: options.ui,
-		sourceFile,
-		hostFile
+		ui: options.ui
 	}));
+	await writeFile(agentGuidePath, projectAgentGuide(projectGuidance));
 	await writeFile(join(root, "tsconfig.json"), `${JSON.stringify({
 		compilerOptions: {
 			target: "ES2022",
@@ -3021,7 +3058,60 @@ async function commandCreate(directory, options) {
 	const warnings = [];
 	await writeProjectToolchain(root, toolchain);
 	if (name !== directoryName) warnings.push(`目录名 "${directoryName}" 不是合法标识符，manifest 的 name 已取 "${name}"；需要其他取值请直接编辑 manifest.json。`);
-	if (options.template === "panel" && panelId !== "workspace-files") warnings.push(`Panel id "${panelId}" 需要 Host 预先注册并绑定；工作区文件面板请使用 --panel-id workspace-files。`);
+	const nextSteps = [
+		{
+			cwd: root,
+			command: "pnpm",
+			args: ["install"]
+		},
+		{
+			cwd: root,
+			command: "pnpm",
+			args: [
+				"exec",
+				"bohr-widget",
+				"integration",
+				"--project",
+				".",
+				"--json"
+			]
+		},
+		{
+			cwd: root,
+			command: "pnpm",
+			args: [
+				"exec",
+				"bohr-widget",
+				"build",
+				".",
+				"--json"
+			]
+		},
+		{
+			cwd: root,
+			command: "pnpm",
+			args: [
+				"exec",
+				"bohr-widget",
+				"check",
+				".",
+				"--json"
+			]
+		},
+		{
+			cwd: root,
+			command: "pnpm",
+			args: [
+				"exec",
+				"bohr-widget",
+				"pack",
+				".",
+				"--out",
+				"artifacts/my-widget.zip",
+				"--json"
+			]
+		}
+	];
 	const result = {
 		ok: true,
 		command: "create",
@@ -3033,6 +3123,11 @@ async function commandCreate(directory, options) {
 		...panelId ? { panelId } : {},
 		manifestPath: join(root, "manifest.json"),
 		packagePath: join(root, "package.json"),
+		readmePath,
+		agentGuidePath,
+		documentation,
+		agentSetupUrl,
+		nextSteps,
 		profile: toolchain.profile,
 		hostCompatibility,
 		...warnings.length === 0 ? {} : { warnings }
@@ -3040,8 +3135,14 @@ async function commandCreate(directory, options) {
 	if (options.json) console.log(JSON.stringify(result, null, 2));
 	else {
 		console.log(`已创建 Widget 工程：${root}（manifest name: ${name}）`);
+		if (panelId) console.log(`Panel ID：${panelId}（可自定义）`);
+		console.log(`创建时 SDK：@dp-bohrium/widget-sdk@${sdkPackage.version}`);
+		console.log(`项目说明：${readmePath}\nAgent 指引：${agentGuidePath}`);
+		console.log(`文档站：${documentation.url}\nAgent 阅读入口：${agentSetupUrl}`);
+		console.log(`文档索引：${documentation.llms}`);
 		for (const warning of warnings) console.warn(`提示：${warning}`);
-		console.log(`下一步：cd ${JSON.stringify(root)}，执行 pnpm install，再执行 pnpm exec bohr-widget build . --json 和 pnpm exec bohr-widget check . --json。`);
+		console.log(`先读取项目指引和公开文档，再进入工程目录：${root}`);
+		console.log(`依次执行：\n${nextSteps.map((step) => [step.command, ...step.args].join(" ")).join("\n")}`);
 	}
 	return result;
 }

package/dist/core.d.mts

@@ -1,5 +1,5 @@
 import { Buffer } from "node:buffer";
-//#region ../contracts/dist/generated-runtime-contracts.d.ts
+//#region ../widget-sdk/src/protocol/generated-runtime-contracts.d.ts
 /**
  * 完整渲染请求联合：tool-result（内部）/ file-preview / panel。
  */
@@ -347,7 +347,7 @@ interface PanelContent {
   data: JsonValue;
 }
 //#endregion
-//#region ../contracts/dist/generated-manifest.d.ts
+//#region ../widget-sdk/src/protocol/generated-manifest.d.ts
 /** GENERATED FILE. Do not edit directly. */
 /**
  * 构建该 Widget 时使用的 SDK 精确 SemVer 版本，不接受范围。
@@ -538,7 +538,7 @@ interface RuntimeOptions$1 {
   webAssembly?: boolean;
 }
 //#endregion
-//#region ../contracts/dist/generated-plugin-manifest.d.ts
+//#region ../widget-sdk/src/protocol/generated-plugin-manifest.d.ts
 /** GENERATED FILE. Do not edit directly. */
 /**
  * Host 可用于启动 Widget 的公开激活信号。多个值表示任一信号命中即可激活；它们不授予 events.read 权限。工具名形式为 tool-call-<阶段>:<工具名>。
@@ -713,7 +713,7 @@ interface RuntimeOptions {
   webAssembly?: boolean;
 }
 //#endregion
-//#region ../contracts/dist/plugin-manifest.d.ts
+//#region ../widget-sdk/src/protocol/plugin-manifest.d.ts
 /** 工具调用事件阶段；用于拼出 `tool-call-<phase>:<toolName>` 形式的激活事件。 */
 type WidgetToolPhase = "generating" | "waiting" | "running" | "result" | "error";
 /**
@@ -734,7 +734,7 @@ type WidgetPluginManifest = Omit<WidgetPluginManifest$1, "activationEvents"> & {
   readonly activationEvents?: WidgetActivationEvents;
 };
 //#endregion
-//#region ../widget-project/src/project.d.mts
+//#region src/project/project.d.mts
 /** 工程检查摘要；Gallery 状态和终端输出只依赖这些字段。 */
 interface CheckResult {
   ok: boolean;
@@ -810,7 +810,17 @@ interface WidgetProjectCheckFailure extends WidgetProjectCheckDetails {
 }
 type WidgetProjectCheckResult = WidgetProjectCheckSuccess | WidgetProjectCheckFailure;
 //#endregion
-//#region ../widget-project/src/packaging.d.mts
+//#region src/project/check.d.mts
+declare function checkWidgetProject(projectRoot: string, options?: CheckWidgetProjectOptions): Promise<WidgetProjectCheckResult>;
+declare function resolveWidgetProjects(input: string, root?: string): string[];
+//#endregion
+//#region src/project/manifest.d.mts
+declare function compileAuthorManifest(manifest: unknown, options?: ManifestCompilerOptions & {
+  sdkVersion?: string;
+  compiler?: WidgetManifestCompiler;
+}): unknown;
+//#endregion
+//#region src/project/packaging.d.mts
 /** 打包只依赖工程位置与已编译清单，不依赖 Gallery 的路由或展示状态。 */
 interface WidgetPackageInput {
   projectRoot: string;
@@ -824,14 +834,6 @@ interface WidgetPackageOptions {
 /** 保留旧的同步 ZIP 返回值。 */
 declare function buildWidgetPackage(project: WidgetPackageInput, options?: WidgetPackageOptions): Buffer;
 //#endregion
-//#region ../widget-project/src/index.d.mts
-declare function compileAuthorManifest(manifest: unknown, options?: ManifestCompilerOptions & {
-  sdkVersion?: string;
-  compiler?: WidgetManifestCompiler;
-}): unknown;
-declare function checkWidgetProject(projectRoot: string, options?: CheckWidgetProjectOptions): Promise<WidgetProjectCheckResult>;
-declare function resolveWidgetProjects(input: string, root?: string): string[];
-//#endregion
 //#region src/core.d.mts
 interface WidgetTemplateContext {
   readonly name: string;

package/dist/core.mjs

@@ -1,4 +1,4 @@
-import { c as compileAuthorManifest, n as scaffoldDshWidget, o as checkWidgetProject, r as buildWidgetPackage, s as resolveWidgetProjects, t as auditDshPlugin } from "./dsh-BkPMTfZ_.mjs";
+import { c as compileAuthorManifest, n as scaffoldDshWidget, o as checkWidgetProject, r as buildWidgetPackage, s as resolveWidgetProjects, t as auditDshPlugin } from "./dsh-BlpXm2Bv.mjs";
 //#region src/core.mjs
 /** Validate a community template before registering it in a custom CLI. */
 function defineWidgetTemplate(template) {