create-windy 0.6.8 → 0.6.9

package/template/docs/operations/incremental-delivery.md

@@ -107,11 +107,11 @@ package `bin`，避免 fresh `bun install` 改写受管源码的 POSIX mode。
 
 ```bash
 sudo install -d -m 0755 /opt/windy/runtime /opt/windy/bin
-sudo cp -R ./packages/delivery /opt/windy/runtime/delivery-0.6.7.tmp
-sudo chmod 0555 /opt/windy/runtime/delivery-0.6.7.tmp/bin/windy-delivery
-sudo mv /opt/windy/runtime/delivery-0.6.7.tmp \
-  /opt/windy/runtime/delivery-0.6.7
-sudo ln -s /opt/windy/runtime/delivery-0.6.7/bin/windy-delivery \
+sudo cp -R ./packages/delivery /opt/windy/runtime/delivery-0.6.8.tmp
+sudo chmod 0555 /opt/windy/runtime/delivery-0.6.8.tmp/bin/windy-delivery
+sudo mv /opt/windy/runtime/delivery-0.6.8.tmp \
+  /opt/windy/runtime/delivery-0.6.8
+sudo ln -s /opt/windy/runtime/delivery-0.6.8/bin/windy-delivery \
   /opt/windy/bin/windy-delivery.next
 sudo mv -Tf /opt/windy/bin/windy-delivery.next \
   /opt/windy/bin/windy-delivery
@@ -175,10 +175,11 @@ resource fork 或 Finder metadata。路径组件以 `._` 开头时直接拒绝
 
 ## 构建与旧项目升级
 
-`create-windy@0.6.7` 候选把 `packages/delivery`、本说明和 `delivery:remote` 脚本加入
-受管 Starter。`0.6.6 -> 0.6.7` 通过连续 recipe 事务升级；现有 project-owned 发布脚本
-不会被覆盖。正式构建先准备一个完整 release 目录，其中 `images.tar` 必须是 OCI image
-layout（含 `oci-layout`、`index.json` 和 `blobs/sha256/*`），再运行：
+`packages/delivery`、本说明和 `delivery:remote` 脚本自 `create-windy@0.6.7` 起进入受管
+Starter；当前公开版为 `0.6.8`，最低支持基线 `0.6.6` 可通过连续 recipe 事务升级，现有
+project-owned 发布脚本不会被覆盖。正式构建先准备一个完整 release 目录，其中
+`images.tar` 必须是 OCI image layout（含 `oci-layout`、`index.json` 和
+`blobs/sha256/*`），再运行：
 
 ```bash
 bun run delivery:remote -- pack \

package/template/packages/modules/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@southwind-ai/modules",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "license": "UNLICENSED",
   "type": "module",
   "engines": {

package/template/packages/modules/src/system-admin-routes.ts

@@ -70,6 +70,14 @@ export const systemAdminRoutes: ModuleManifest["adminRoutes"] = [
     "system.feature.read",
     "system.feature",
   ),
+  route(
+    "system.ui-components",
+    "/ui/component",
+    "组件总览",
+    "sidebar",
+    "system.ui-components.read",
+    "system.ui-components",
+  ),
   // @windy-module system.notification begin
   route(
     "system.notification",

package/template/packages/modules/src/system-admin-ui-catalog.ts

@@ -2,7 +2,7 @@ import type { AdminUiManifest } from "./admin-ui-manifest.js";
 import { systemAdminRoutes } from "./system-admin-routes.js";
 
 const definitions = [
-  ["system", ["system.feature"]],
+  ["system", ["system.feature", "system.ui-components"]],
   [
     "system.identity",
     [

package/template/packages/modules/src/system-features.ts

@@ -37,6 +37,11 @@ export const systemFeatures: ModuleManifest["features"] = [
     "功能开关管理",
     "查看和恢复平台 Feature 状态的核心控制面能力。",
   ),
+  feature(
+    "system.ui-components",
+    "UI 组件总览",
+    "查看 Windy Web 已封装基础组件的真实主题与交互示例。",
+  ),
   feature(
     "system.user-directory",
     "业务用户目录",

package/template/packages/modules/src/system-module-catalog.ts

@@ -21,12 +21,13 @@ export const systemModuleDefinitions = [
     version: "0.1.0",
     label: "系统核心",
     description: "管理面准入、Feature 治理、数据库基线与审计动作目录。",
-    resources: ["admin", "runtime", "auth", "feature"],
+    resources: ["admin", "runtime", "auth", "feature", "ui-components"],
     featureKeys: [
       "system.admin",
       "system.runtime",
       "system.auth",
       "system.feature",
+      "system.ui-components",
       "system.ruoyi-compat",
     ],
   },

package/template/packages/modules/src/system-modules.ts

@@ -169,6 +169,17 @@ export function systemFoundationModule(): ModuleManifest {
             featureKey: "system.config",
           },
           // @windy-module system.configuration end
+          {
+            key: "system.ui-components",
+            title: "组件总览",
+            type: "menu",
+            order: 70,
+            visible: true,
+            path: "/ui/component",
+            icon: "blocks",
+            permissionKey: "system.ui-components.read",
+            featureKey: "system.ui-components",
+          },
         ],
       },
       {

package/template/packages/modules/src/system-permissions.ts

@@ -11,6 +11,7 @@ const systemResourceLabels = {
   menu: "菜单管理",
   dict: "字典管理",
   feature: "功能开关",
+  "ui-components": "UI 组件总览",
   search: "全局搜索",
   settings: "全局设置",
   config: "配置版本",
@@ -96,6 +97,7 @@ export const systemPermissions: ModuleManifest["permissions"] = [
   permission("dict", "manage"),
   permission("feature", "read"),
   permission("feature", "manage"),
+  permission("ui-components", "read"),
   // @windy-module system.search begin
   permission("search", "read"),
   permission("search", "manage"),

package/template/packages/modules/src/system-ui-components.test.ts

@@ -0,0 +1,36 @@
+import { describe, expect, test } from "bun:test";
+import { systemFoundationModule } from "./system-modules.js";
+
+describe("系统组件展厅能力注册", () => {
+  test("以同一能力 Key 注册 Feature、Permission、菜单和路由", () => {
+    const manifest = systemFoundationModule();
+    const menus = flattenMenus(manifest.menus);
+
+    expect(manifest.features).toContainEqual(
+      expect.objectContaining({ key: "system.ui-components" }),
+    );
+    expect(manifest.permissions).toContainEqual(
+      expect.objectContaining({ key: "system.ui-components.read" }),
+    );
+    expect(
+      menus.find(({ key }) => key === "system.ui-components"),
+    ).toMatchObject({
+      path: "/ui/component",
+      permissionKey: "system.ui-components.read",
+      featureKey: "system.ui-components",
+    });
+    expect(
+      manifest.adminRoutes.find(({ key }) => key === "system.ui-components"),
+    ).toMatchObject({
+      path: "/ui/component",
+      permissionKey: "system.ui-components.read",
+      featureKey: "system.ui-components",
+    });
+  });
+});
+
+function flattenMenus(
+  menus: ReturnType<typeof systemFoundationModule>["menus"],
+): ReturnType<typeof systemFoundationModule>["menus"] {
+  return menus.flatMap((menu) => [menu, ...flattenMenus(menu.children || [])]);
+}