create-windy 0.6.8 → 0.6.9

package/dist/cli.js

@@ -3480,7 +3480,8 @@ browser-safe \`./admin\` \u4E0E project-owned \u7684
 \`apps/web/src/app/web-composition.ts\` \u88C5\u914D\u9875\u9762\uFF0C\u4E0D\u590D\u5236\u7B2C\u4E8C\u4EFD Feature\u3001Permission
 \u6216\u8DEF\u7531\u6E05\u5355\u3002\u6574\u4E2A \`apps/web/src\` \u4E0E\u6574\u4E2A \`apps/server/src/app\` \u90FD\u662F
 project-owned\uFF0C\u5BA2\u6237\u53EF\u4EE5\u4FEE\u6539 Router\u3001layout\u3001\u9875\u9762\u3001Host \u548C Server \u7EC4\u5408\uFF1B\u666E\u901A
-\`windy update\` \u4E0D\u4F1A\u8986\u76D6\u6216\u4E09\u65B9\u5408\u5E76\u8FD9\u4E9B\u6587\u4EF6\u3002
+\`windy update\` \u4E0D\u4F1A\u6574\u6587\u4EF6\u8986\u76D6\u6216\u4E09\u65B9\u5408\u5E76\u8FD9\u4E9B\u6587\u4EF6\u3002\u7248\u672C recipe \u53EA\u6709\u5728\u663E\u5F0F\u767B\u8BB0
+path \u4E0E\u786E\u5B9A\u6027\u8BED\u4E49\u951A\u70B9\u540E\u624D\u80FD\u505A\u5E42\u7B49\u8FFD\u52A0\uFF1B\u951A\u70B9\u7F3A\u5931\u6216\u4E0D\u552F\u4E00\u65F6\u5FC5\u987B\u5728\u5199\u5165\u524D\u505C\u6B62\u3002
 
 \u7CBE\u786E\u751F\u6210\u6765\u6E90\u4FDD\u7559\u5728 \`.windy/generation.json\`\u3002\u5F53\u524D\u7248\u672C\u5DF2\u63D0\u4F9B\u53EF\u56DE\u6EDA\u7684
 \`windy update\` \u4E0E \`windy module list/enable/disable\`\u3002\u5F53\u524D\u5185\u7F6E\u6A21\u5757\u4ECD\u4F9D\u8D56
@@ -3514,7 +3515,8 @@ ${includeOxc ? "\u63D0\u4EA4\u65F6 Husky \u4F1A\u901A\u8FC7 lint-staged \u4E0E O
 \u66F4\u65B0\u524D\u65E0\u9700\u63D0\u4EA4\u3001\u6682\u5B58\u6216\u6E05\u7406\u4E1A\u52A1\u6539\u52A8\u3002\`--dry-run\` \u53EA\u751F\u6210\u8BA1\u5212\uFF0C\u4E0D\u5199\u9879\u76EE\uFF1B\u65E0\u5173 WIP
 \u4FDD\u6301\u539F\u6837\uFF0C\u547D\u4E2D\u540C\u4E00\u8DEF\u5F84\u65F6\u6309\u51BB\u7ED3\u5FEB\u7167\u4E0E\u4E09\u65B9\u5408\u5E76 fail closed\u3002\u6B63\u5F0F\u66F4\u65B0\u5148\u5907\u4EFD\uFF0C\u518D\u505A
 package \u5B57\u6BB5\u7EA7\u5408\u5E76\u3001\u5171\u4EAB\u811A\u624B\u67B6\u4E09\u65B9\u5408\u5E76\u4E0E\u5B8C\u6574\u9A8C\u8BC1\u3002\u6574\u4E2A \`apps/web/src\` \u548C
-\`apps/server/src/app\` \u4FDD\u6301\u9879\u76EE\u7248\u672C\u3002\u4EFB\u4F55\u51B2\u7A81\u90FD\u4F1A\u5728\u5199\u5165\u524D\u4E2D\u6B62\uFF0C\u6A21\u5757\u542F\u505C\u5728\u4EA4\u4E92
+\`apps/server/src/app\` \u9ED8\u8BA4\u4FDD\u6301\u9879\u76EE\u7248\u672C\uFF1B\u5DF2\u767B\u8BB0\u7248\u672C recipe \u53EA\u4FEE\u6539\u5176\u58F0\u660E\u7684\u7A84\u951A\u70B9\u3002
+\u4EFB\u4F55\u51B2\u7A81\u90FD\u4F1A\u5728\u5199\u5165\u524D\u4E2D\u6B62\uFF0C\u6A21\u5757\u542F\u505C\u5728\u4EA4\u4E92
 \u7EC8\u7AEF\u786E\u8BA4\uFF1BCI\u3001Agent \u6216\u5176\u5B83\u975E TTY \u73AF\u5883\u5FC5\u987B\u663E\u5F0F\u4F20\u5165 \`--yes\`\u3002
 \u65E0\u5E76\u53D1\u53D8\u5316\u7684\u9A8C\u8BC1\u5931\u8D25\u4F1A\u81EA\u52A8\u56DE\u6EDA\uFF1B\u4E2D\u65AD\u6062\u590D\u4F7F\u7528
 \`bun run windy doctor --repair\`\u3002\u8BE5\u547D\u4EE4\u5728\u63D0\u4EA4\u70B9\u524D\u4FDD\u7559\u5E76\u53D1\u7F16\u8F91\u5E76\u56DE\u6EDA\u5176\u4F59\u8DEF\u5F84\uFF0C
@@ -3694,6 +3696,7 @@ var templateDocumentationFiles = [
   "docs/development/custom-error-pages.md",
   "docs/development/custom-login-page.md",
   "docs/development/module-lifecycle.md",
+  "docs/development/ui-component-gallery.md",
   "docs/license/license-offline-activation-code.md",
   "docs/operations/observability.md",
   "docs/operations/incremental-delivery.md",
@@ -7727,6 +7730,11 @@ var recipes = [
     id: "starter-0.6.7-to-0.6.8",
     from: "0.6.7",
     to: "0.6.8"
+  },
+  {
+    id: "starter-0.6.8-to-0.6.9",
+    from: "0.6.8",
+    to: "0.6.9"
   }
 ];
 function resolveRecipeChain(sourceVersion, targetVersion) {
@@ -9088,8 +9096,123 @@ function conflict(path2, reason, expectedProjectContent) {
   };
 }
 
+// src/update/recipe-project-owned.ts
+var managedPathsByRecipe = {
+  "starter-0.6.8-to-0.6.9": [
+    "apps/web/src/router/index.ts",
+    "apps/web/src/router/platform-admin-route-bindings.ts"
+  ]
+};
+function recipeManagedProjectOwnedPaths(recipes2) {
+  return new Set(recipes2.flatMap((recipe) => managedPathsByRecipe[recipe] ?? []));
+}
+async function planRecipeProjectOwned(input) {
+  if (!input.ours) {
+    return conflict2(input, "\u7248\u672C recipe \u6240\u9700\u7684\u9879\u76EE\u951A\u70B9\u7F3A\u5931");
+  }
+  const source = new TextDecoder().decode(input.ours);
+  const transformed = transformProjectAdminAnchor(input.path, source);
+  if ("error" in transformed)
+    return conflict2(input, transformed.error);
+  if (transformed.content === source) {
+    return preserve(input, "\u5DF2\u5305\u542B\u7248\u672C recipe \u76EE\u6807\u5185\u5BB9");
+  }
+  return update(input, new TextEncoder().encode(transformed.content));
+}
+function transformProjectAdminAnchor(path2, source) {
+  if (path2 === "apps/web/src/router/index.ts") {
+    return addComponentPageLoader(source);
+  }
+  if (path2 === "apps/web/src/router/platform-admin-route-bindings.ts") {
+    return addComponentRouteBinding(source);
+  }
+  return { error: `\u7248\u672C recipe \u672A\u767B\u8BB0\u9879\u76EE\u951A\u70B9\uFF1A${path2}` };
+}
+function addComponentPageLoader(source) {
+  if (/^\s*"ui-components"\s*:/m.test(source))
+    return { content: source };
+  const declaration = source.indexOf("const platformAdminPageComponents");
+  const start = source.indexOf("= {", declaration);
+  const end = source.indexOf(`
+};`, start);
+  if (declaration < 0 || start < 0 || end < 0) {
+    return { error: "\u627E\u4E0D\u5230 platformAdminPageComponents \u9879\u76EE\u951A\u70B9" };
+  }
+  const block = source.slice(start, end);
+  const profiles = [...block.matchAll(/^(\s*)profile:\s*.*,$/gm)];
+  if (profiles.length !== 1) {
+    return { error: "platformAdminPageComponents profile \u951A\u70B9\u4E0D\u552F\u4E00" };
+  }
+  const profile = profiles[0];
+  const insertion = `${profile[0]}
+${profile[1]}"ui-components": () => import("@/pages/ui/UiComponentPage.vue"),`;
+  return {
+    content: source.slice(0, start) + block.replace(profile[0], insertion) + source.slice(end)
+  };
+}
+function addComponentRouteBinding(source) {
+  const unionStart = source.indexOf("export type PlatformAdminPageKey =");
+  const interfaceStart = source.indexOf("export interface PlatformAdminRouteBinding", unionStart);
+  if (unionStart < 0 || interfaceStart < 0) {
+    return { error: "\u627E\u4E0D\u5230 PlatformAdminPageKey \u9879\u76EE\u951A\u70B9" };
+  }
+  let content = source;
+  const union = content.slice(unionStart, interfaceStart);
+  if (!union.includes('"ui-components"')) {
+    const semicolon = content.lastIndexOf(";", interfaceStart);
+    if (semicolon < unionStart) {
+      return { error: "PlatformAdminPageKey \u7ED3\u675F\u951A\u70B9\u7F3A\u5931" };
+    }
+    content = `${content.slice(0, semicolon)}
+  | "ui-components"${content.slice(semicolon)}`;
+  }
+  if (content.includes('routeKey: "system.ui-components"')) {
+    return { content };
+  }
+  const features = [
+    ...content.matchAll(/^(\s*)\{ routeKey: "system\.feature", page: "resource", resourceKey: "features" \},$/gm)
+  ];
+  if (features.length !== 1) {
+    return { error: "system.feature Admin Route \u951A\u70B9\u4E0D\u552F\u4E00" };
+  }
+  const feature = features[0];
+  return {
+    content: content.replace(feature[0], `${feature[0]}
+${feature[1]}{ routeKey: "system.ui-components", page: "ui-components" },`)
+  };
+}
+function preserve(input, reason) {
+  return {
+    path: input.path,
+    ownership: "project-owned",
+    action: "preserve",
+    reason,
+    expectedProjectContent: input.expected
+  };
+}
+function update(input, content) {
+  return {
+    path: input.path,
+    ownership: "project-owned",
+    action: "update",
+    reason: "\u7248\u672C recipe \u66F4\u65B0\u9879\u76EE Admin \u6269\u5C55\u951A\u70B9",
+    expectedProjectContent: input.expected,
+    content
+  };
+}
+function conflict2(input, message) {
+  return {
+    path: input.path,
+    ownership: "project-owned",
+    action: "preserve",
+    reason: "\u5BA2\u6237\u5DF2\u4FEE\u6539",
+    expectedProjectContent: input.expected,
+    conflict: message
+  };
+}
+
 // src/update/planner-file.ts
-async function planFile(path2, baseRoot, targetRoot, source, target, ours, provenance, targetContentOverride, manageGeneratedProjectOwned = false, forcePlatformBaseline = false) {
+async function planFile(path2, baseRoot, targetRoot, source, target, ours, provenance, targetContentOverride, manageGeneratedProjectOwned = false, forcePlatformBaseline = false, manageRecipeProjectOwned = false) {
   const [base, theirs] = await Promise.all([
     readOptional(join23(baseRoot, path2)),
     targetContentOverride ? Promise.resolve(targetContentOverride) : readOptional(join23(targetRoot, path2))
@@ -9097,6 +9220,9 @@ async function planFile(path2, baseRoot, targetRoot, source, target, ours, prove
   const ownership = source?.ownership ?? target?.ownership ?? classifyOwnership(path2);
   const expected = expectationForSnapshot(ours);
   if (ownership === "project-owned") {
+    if (manageRecipeProjectOwned) {
+      return planRecipeProjectOwned({ path: path2, ours, expected });
+    }
     if (manageGeneratedProjectOwned) {
       return planGeneratedProjectOwned(path2, source, target, ours, theirs, expected);
     }
@@ -9104,26 +9230,26 @@ async function planFile(path2, baseRoot, targetRoot, source, target, ours, prove
   }
   if (path2.startsWith("packages/database/drizzle/") && path2.endsWith(".sql")) {
     if (source && !target) {
-      return conflict2(path2, ownership, "\u5DF2\u53D1\u5E03 migration \u4E0D\u53EF\u5220\u9664", expected);
+      return conflict3(path2, ownership, "\u5DF2\u53D1\u5E03 migration \u4E0D\u53EF\u5220\u9664", expected);
     }
     if (source && target && source.hash !== target.hash) {
-      return conflict2(path2, ownership, "\u5DF2\u53D1\u5E03 migration \u4E0D\u53EF\u6539\u5199\uFF0C\u53EA\u80FD\u8FFD\u52A0\u65B0\u6587\u4EF6", expected);
+      return conflict3(path2, ownership, "\u5DF2\u53D1\u5E03 migration \u4E0D\u53EF\u6539\u5199\uFF0C\u53EA\u80FD\u8FFD\u52A0\u65B0\u6587\u4EF6", expected);
     }
   }
   if (!source && target) {
     if (!ours) {
       return readyPlannedFile(path2, ownership, "create", "\u76EE\u6807\u7248\u672C\u65B0\u589E", expected, theirs);
     }
-    return theirs && hashContent(ours) === target.hash ? readyPlannedFile(path2, ownership, "preserve", "\u5DF2\u5305\u542B\u76EE\u6807\u5185\u5BB9", expected) : conflict2(path2, ownership, "\u76EE\u6807\u7248\u672C\u65B0\u589E\u8DEF\u5F84\u5DF2\u88AB\u9879\u76EE\u5360\u7528", expected);
+    return theirs && hashContent(ours) === target.hash ? readyPlannedFile(path2, ownership, "preserve", "\u5DF2\u5305\u542B\u76EE\u6807\u5185\u5BB9", expected) : conflict3(path2, ownership, "\u76EE\u6807\u7248\u672C\u65B0\u589E\u8DEF\u5F84\u5DF2\u88AB\u9879\u76EE\u5360\u7528", expected);
   }
   if (source && !target) {
     if (!ours) {
       return readyPlannedFile(path2, ownership, "preserve", "\u9879\u76EE\u5DF2\u5220\u9664", expected);
     }
-    return hashContent(ours) === source.hash ? readyPlannedFile(path2, ownership, "delete", "\u76EE\u6807\u7248\u672C\u5220\u9664", expected) : conflict2(path2, ownership, "\u5BA2\u6237\u4FEE\u6539\u540E Windy \u53C8\u5220\u9664", expected);
+    return hashContent(ours) === source.hash ? readyPlannedFile(path2, ownership, "delete", "\u76EE\u6807\u7248\u672C\u5220\u9664", expected) : conflict3(path2, ownership, "\u5BA2\u6237\u4FEE\u6539\u540E Windy \u53C8\u5220\u9664", expected);
   }
   if (!source || !target || !ours || !theirs) {
-    return conflict2(path2, ownership, "\u6587\u4EF6\u72B6\u6001\u4E0D\u5B8C\u6574\uFF0C\u4E0D\u80FD\u5B89\u5168\u63A8\u65AD", expected);
+    return conflict3(path2, ownership, "\u6587\u4EF6\u72B6\u6001\u4E0D\u5B8C\u6574\uFF0C\u4E0D\u80FD\u5B89\u5168\u63A8\u65AD", expected);
   }
   const oursChanged = hashContent(ours) !== source.hash;
   const sourceArtifactHash = artifactHashOf(source);
@@ -9137,7 +9263,7 @@ async function planFile(path2, baseRoot, targetRoot, source, target, ours, prove
   });
   if (forceTargetBaseline && path2.endsWith("package.json") && base) {
     const merged = mergePackageJson(base, ours, theirs);
-    return merged.content ? readyPlannedFile(path2, ownership, "update", "package.json \u5B57\u6BB5\u7EA7\u5408\u5E76", expected, merged.content) : conflict2(path2, ownership, `\u5B57\u6BB5\u51B2\u7A81\uFF1A${merged.conflicts.join("\u3001")}`, expected);
+    return merged.content ? readyPlannedFile(path2, ownership, "update", "package.json \u5B57\u6BB5\u7EA7\u5408\u5E76", expected, merged.content) : conflict3(path2, ownership, `\u5B57\u6BB5\u51B2\u7A81\uFF1A${merged.conflicts.join("\u3001")}`, expected);
   }
   if (forceTargetBaseline) {
     return readyPlannedFile(path2, ownership, "update", "\u5F3A\u5236\u91C7\u7528\u76EE\u6807\u5E73\u53F0\u57FA\u7EBF", expected, theirs);
@@ -9147,11 +9273,11 @@ async function planFile(path2, baseRoot, targetRoot, source, target, ours, prove
   }
   if (targetChanged && path2.endsWith("package.json") && base) {
     const merged = mergePackageJson(base, ours, theirs);
-    return merged.content ? readyPlannedFile(path2, ownership, "update", "package.json \u5B57\u6BB5\u7EA7\u5408\u5E76", expected, merged.content) : conflict2(path2, ownership, `\u5B57\u6BB5\u51B2\u7A81\uFF1A${merged.conflicts.join("\u3001")}`, expected);
+    return merged.content ? readyPlannedFile(path2, ownership, "update", "package.json \u5B57\u6BB5\u7EA7\u5408\u5E76", expected, merged.content) : conflict3(path2, ownership, `\u5B57\u6BB5\u51B2\u7A81\uFF1A${merged.conflicts.join("\u3001")}`, expected);
   }
   if (!oursChanged && targetChanged && adoptedProjectDelta && base) {
     const merged = await mergeTextFile(base, ours, theirs);
-    return merged.content ? readyPlannedFile(path2, ownership, "update", "\u4E09\u65B9\u5408\u5E76\u5DF2\u91C7\u7EB3\u9879\u76EE\u589E\u91CF", expected, merged.content) : conflict2(path2, ownership, merged.conflict || "\u4E09\u65B9\u5408\u5E76\u5931\u8D25", expected);
+    return merged.content ? readyPlannedFile(path2, ownership, "update", "\u4E09\u65B9\u5408\u5E76\u5DF2\u91C7\u7EB3\u9879\u76EE\u589E\u91CF", expected, merged.content) : conflict3(path2, ownership, merged.conflict || "\u4E09\u65B9\u5408\u5E76\u5931\u8D25", expected);
   }
   if (!oursChanged) {
     return readyPlannedFile(path2, ownership, "update", "\u4EC5 Windy \u4FEE\u6539", expected, theirs);
@@ -9164,9 +9290,9 @@ async function planFile(path2, baseRoot, targetRoot, source, target, ours, prove
   }
   if (base) {
     const merged = await mergeTextFile(base, ours, theirs);
-    return merged.content ? readyPlannedFile(path2, ownership, "update", "\u4E09\u65B9\u5408\u5E76", expected, merged.content) : conflict2(path2, ownership, merged.conflict || "\u4E09\u65B9\u5408\u5E76\u5931\u8D25", expected);
+    return merged.content ? readyPlannedFile(path2, ownership, "update", "\u4E09\u65B9\u5408\u5E76", expected, merged.content) : conflict3(path2, ownership, merged.conflict || "\u4E09\u65B9\u5408\u5E76\u5931\u8D25", expected);
   }
-  return conflict2(path2, ownership, "\u5BA2\u6237\u548C Windy \u5747\u5DF2\u4FEE\u6539", expected);
+  return conflict3(path2, ownership, "\u5BA2\u6237\u548C Windy \u5747\u5DF2\u4FEE\u6539", expected);
 }
 function shouldForcePlatformBaseline(input) {
   return input.forcePlatformBaseline && !input.oursChanged && input.base !== undefined && hashContent(input.base) !== input.sourceArtifactHash;
@@ -9187,7 +9313,7 @@ function readyPlannedFile(path2, ownership, action, reason, expectedProjectConte
 function expectationForSnapshot(content) {
   return content ? { kind: "hash", value: hashContent(content) } : { kind: "missing" };
 }
-function conflict2(path2, ownership, reason, expectedProjectContent) {
+function conflict3(path2, ownership, reason, expectedProjectContent) {
   return {
     path: path2,
     ownership,
@@ -9361,6 +9487,7 @@ async function createUpdatePlan(request, artifacts, dependencies = {}) {
   const versionRecipes = (dependencies.resolveVersionRecipes ?? resolveRecipeChain)(provenance.windyVersion, targetVersion);
   const moduleRecipes = resolveModuleRecipeIds(request);
   const recipes2 = [...versionRecipes.map(({ id }) => id), ...moduleRecipes];
+  const recipeProjectOwnedPaths = recipeManagedProjectOwnedPaths(recipes2);
   const [rawSourceManifest, rawTargetManifest] = await Promise.all([
     readManagedFilesManifest(request.projectDirectory),
     readManagedFilesManifest(artifactSet.targetDirectory)
@@ -9407,7 +9534,8 @@ async function createUpdatePlan(request, artifacts, dependencies = {}) {
     artifactSet,
     provenance,
     manageGeneratedProjectOwned: request.targetModules !== undefined,
-    forcePlatformBaseline: request.forcePlatformBaseline === true
+    forcePlatformBaseline: request.forcePlatformBaseline === true,
+    recipeProjectOwnedPaths
   });
   preserveTestsForExistingProjectOwnedSources(files, sourceEntries);
   await deriveDockerfilePlans(files, projectSnapshots, new Set([
@@ -9486,7 +9614,7 @@ async function planFiles(input) {
     } else if (forcedContent) {
       files.push(readyPlannedFile(path2, input.targetEntries.get(path2)?.ownership ?? input.sourceEntries.get(path2)?.ownership ?? classifyOwnership(path2), "update", "\u5408\u5E76\u5E73\u53F0\u4E0E\u4E0B\u6E38 migration \u5386\u53F2", expected, forcedContent));
     } else {
-      files.push(await planFile(path2, input.artifactSet.baseDirectory, input.artifactSet.targetDirectory, input.sourceEntries.get(path2), input.targetEntries.get(path2), ours, input.provenance, input.migrations.contentOverrides.get(path2), input.manageGeneratedProjectOwned, input.forcePlatformBaseline));
+      files.push(await planFile(path2, input.artifactSet.baseDirectory, input.artifactSet.targetDirectory, input.sourceEntries.get(path2), input.targetEntries.get(path2), ours, input.provenance, input.migrations.contentOverrides.get(path2), input.manageGeneratedProjectOwned, input.forcePlatformBaseline, input.recipeProjectOwnedPaths.has(path2)));
     }
   }
   return files;
@@ -10007,9 +10135,9 @@ function assertEnabledConflicts(target, catalog) {
   for (const [name, enabled] of target) {
     if (!enabled)
       continue;
-    const conflict3 = catalog.get(name).conflicts.find((candidate) => target.get(candidate));
-    if (conflict3)
-      throw new Error(`\u6A21\u5757\u51B2\u7A81\uFF1A${name} \u4E0E ${conflict3}`);
+    const conflict4 = catalog.get(name).conflicts.find((candidate) => target.get(candidate));
+    if (conflict4)
+      throw new Error(`\u6A21\u5757\u51B2\u7A81\uFF1A${name} \u4E0E ${conflict4}`);
   }
 }
 function assertCompatible(version, range, name) {
@@ -10024,7 +10152,7 @@ function reconcileProjectModuleRegistryPlan(plan, current, lifecycle) {
   if (!registryFile) {
     throw new Error("\u6A21\u5757\u751F\u547D\u5468\u671F\u8BA1\u5212\u7F3A\u5C11 project-owned \u88C5\u914D\u9009\u62E9");
   }
-  plan.conflicts = plan.conflicts.filter((conflict3) => !conflict3.startsWith(`${projectModuleRegistryPath}\uFF1A`));
+  plan.conflicts = plan.conflicts.filter((conflict4) => !conflict4.startsWith(`${projectModuleRegistryPath}\uFF1A`));
   delete registryFile.conflict;
   if (lifecycle.action === "update") {
     registryFile.action = "preserve";
@@ -10454,8 +10582,8 @@ function printModulePlan(plan, log) {
   for (const file of changed) {
     log(`  ${file.action.padEnd(6)} ${file.path}\uFF08${file.reason}\uFF09`);
   }
-  for (const conflict3 of plan.conflicts)
-    log(`  conflict ${conflict3}`);
+  for (const conflict4 of plan.conflicts)
+    log(`  conflict ${conflict4}`);
 }
 function hasChanges(lifecycle) {
   return lifecycle.addedModules.length > 0 || lifecycle.updatedModules.length > 0 || lifecycle.removedModules.length > 0;
@@ -10627,8 +10755,8 @@ function printPlan(plan) {
   console.log(`\u8BA1\u5212\u6539\u52A8\uFF1A${changed.length} \u4E2A\u6587\u4EF6\uFF1B\u51B2\u7A81\uFF1A${plan.conflicts.length}`);
   for (const file of changed)
     console.log(`  ${file.action.padEnd(6)} ${file.path}\uFF08${file.reason}\uFF09`);
-  for (const conflict3 of plan.conflicts)
-    console.log(`  conflict ${conflict3}`);
+  for (const conflict4 of plan.conflicts)
+    console.log(`  conflict ${conflict4}`);
   if (plan.detachedToolchain)
     console.log("Oxc\uFF1A\u68C0\u6D4B\u5230\u5BA2\u6237\u63A5\u7BA1\uFF0C\u76F8\u5173\u914D\u7F6E\u4FDD\u6301\u4E0D\u53D8");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-windy",
-  "version": "0.6.8",
+  "version": "0.6.9",
   "description": "创建单组织、单租户、私有部署优先的 Windy 企业 Dashboard Starter",
   "type": "module",
   "bin": {

package/template/.windy-template.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "templateCommit": "47527e1bb3a2848bbb7d27eef7132c83b81d714d",
-  "generatorVersion": "0.6.8",
+  "templateCommit": "9176c4dc2db60979b5ce7fd89639da90648c49b9",
+  "generatorVersion": "0.6.9",
   "modules": [
     {
       "name": "system",

package/template/README.md

@@ -132,7 +132,8 @@ browser-safe `./admin` 与 project-owned 的
 `apps/web/src/app/web-composition.ts` 装配页面，不复制第二份 Feature、Permission
 或路由清单。整个 `apps/web/src` 与整个 `apps/server/src/app` 都是
 project-owned，客户可以修改 Router、layout、页面、Host 和 Server 组合；普通
-`windy update` 不会覆盖或三方合并这些文件。
+`windy update` 不会整文件覆盖或三方合并这些文件。版本 recipe 只有在显式登记
+path 与确定性语义锚点后才能做幂等追加；锚点缺失或不唯一时必须在写入前停止。
 
 精确生成来源保留在 `.windy/generation.json`。当前版本已提供可回滚的
 `windy update` 与 `windy module list/enable/disable`。当前内置模块仍依赖
@@ -166,7 +167,8 @@ bun run format
 更新前无需提交、暂存或清理业务改动。`--dry-run` 只生成计划，不写项目；无关 WIP
 保持原样，命中同一路径时按冻结快照与三方合并 fail closed。正式更新先备份，再做
 package 字段级合并、共享脚手架三方合并与完整验证。整个 `apps/web/src` 和
-`apps/server/src/app` 保持项目版本。任何冲突都会在写入前中止，模块启停在交互
+`apps/server/src/app` 默认保持项目版本；已登记版本 recipe 只修改其声明的窄锚点。
+任何冲突都会在写入前中止，模块启停在交互
 终端确认；CI、Agent 或其它非 TTY 环境必须显式传入 `--yes`。
 无并发变化的验证失败会自动回滚；中断恢复使用
 `bun run windy doctor --repair`。该命令在提交点前保留并发编辑并回滚其余路径，

package/template/apps/server/src/runtime-development.ts

@@ -36,6 +36,7 @@ export function developmentAdminActor(): RequestActor {
       "system.dict.manage",
       "system.feature.read",
       "system.feature.manage",
+      "system.ui-components.read",
       "system.search.read",
       "system.search.manage",
       "system.settings.read",

package/template/apps/web/src/layout/AppSidebar.vue

@@ -52,6 +52,7 @@ interface NavigationGroup {
 const iconMap: Record<string, Component> = {
   activity: ActivityIcon,
   bell: BellIcon,
+  blocks: BlocksIcon,
   "layout-dashboard": LayoutDashboardIcon,
   "book-open": BookOpenIcon,
   "building-2": Building2Icon,

package/template/apps/web/src/pages/ui/UiComponentPage.vue

@@ -0,0 +1,7 @@
+<script setup lang="ts">
+import UiComponentGallery from "./components/UiComponentGallery.vue";
+</script>
+
+<template>
+  <UiComponentGallery />
+</template>

package/template/apps/web/src/pages/ui/UiComponentPage.webtest.ts

@@ -0,0 +1,94 @@
+import { afterEach, describe, expect, test } from "vitest";
+import { mount, type VueWrapper } from "@vue/test-utils";
+import { TooltipProvider } from "@/components/ui/tooltip";
+import { buildComponentCatalog, componentCatalog } from "./component-catalog";
+import UiComponentGallery from "./components/UiComponentGallery.vue";
+
+let wrapper: VueWrapper | undefined;
+
+afterEach(() => {
+  wrapper?.unmount();
+  wrapper = undefined;
+});
+
+describe("组件总览页", () => {
+  test("组件清单与 components/ui 实际目录保持一致", () => {
+    const componentDirectories = Object.keys(
+      import.meta.glob("../../components/ui/*/index.ts"),
+    )
+      .map((path) => path.split("/").at(-2))
+      .filter((name): name is string => Boolean(name))
+      .sort();
+
+    expect(componentCatalog.map(({ id }) => id).sort()).toEqual(
+      componentDirectories,
+    );
+  });
+
+  test("展示 components/ui 扫描到的全部组件族", () => {
+    wrapper = mountGallery();
+
+    expect(wrapper.findAll("[data-component-id]")).toHaveLength(
+      componentCatalog.length,
+    );
+    expect(
+      wrapper
+        .findAll("[data-component-id]")
+        .map((node) => node.attributes("data-component-id")),
+    ).toEqual(componentCatalog.map(({ id }) => id));
+  });
+
+  test("自动登记下游项目新增的组件入口与具名导出", () => {
+    const catalog = buildComponentCatalog({
+      "../../components/ui/button/index.ts": { Button: {} },
+      "../../components/ui/radio-group/index.ts": {
+        RadioGroup: {},
+        RadioGroupItem: {},
+      },
+      "../../components/ui/textarea/index.ts": { Textarea: {} },
+    });
+
+    expect(
+      catalog.map(({ id, category, exports }) => ({
+        id,
+        category,
+        exports,
+      })),
+    ).toEqual([
+      { id: "button", category: "foundation", exports: ["Button"] },
+      {
+        id: "radio-group",
+        category: "project",
+        exports: ["RadioGroup", "RadioGroupItem"],
+      },
+      { id: "textarea", category: "project", exports: ["Textarea"] },
+    ]);
+  });
+
+  test("支持按关键词和分类筛选", async () => {
+    wrapper = mountGallery();
+
+    await wrapper.get('input[aria-label="搜索组件"]').setValue("消息通知");
+    expect(wrapper.findAll("[data-component-id]")).toHaveLength(1);
+    expect(
+      wrapper.get("[data-component-id]").attributes("data-component-id"),
+    ).toBe("sonner");
+
+    await wrapper.get('input[aria-label="搜索组件"]').setValue("");
+    await wrapper.get('[data-category-id="foundation"]').trigger("click");
+    expect(wrapper.findAll("[data-component-id]")).toHaveLength(7);
+    expect(wrapper.text()).toContain(
+      `当前显示 7 / ${componentCatalog.length} 个组件族`,
+    );
+  });
+});
+
+function mountGallery() {
+  return mount(
+    {
+      components: { TooltipProvider, UiComponentGallery },
+      template: "<TooltipProvider><UiComponentGallery /></TooltipProvider>",
+    },
+    { attachTo: document.body },
+  );
+}