@shwfed/nuxt 0.1.55 → 0.1.57

package/dist/module.d.mts

@@ -62,10 +62,17 @@ interface ModuleOptions {
         /**
          * 导航栏右侧显示的内容，可以使用 Markdown (DSL)
          *
+         * 通常显示用户名
+         *
          * @type Markdown
          */
         name: string;
     }>;
+    /**
+     * 默认展示的应用标题
+     *
+     * 如果当前路由没有匹配到导航项，则显示该标题
+     */
     title: string;
 }
 interface Env {

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "@shwfed/nuxt",
   "configKey": "shwfed",
-  "version": "0.1.55",
+  "version": "0.1.57",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "3.6.1"

package/dist/runtime/components/app.d.vue.ts

@@ -2,10 +2,37 @@ import type { Scope } from 'effect';
 import { Effect } from 'effect';
 type Item = Readonly<{
     id: string;
+    /**
+     * 命令的标题
+     *
+     * 调用者处理 i18n
+     *
+     * @type string
+     */
     title: string;
+    /**
+     * 命令的图标
+     *
+     * @type string
+     */
     icon?: string;
+    /**
+     * 命令是否禁用
+     *
+     * @type DSL
+     */
     disabled?: boolean | string;
+    /**
+     * 命令是否隐藏
+     *
+     * @type DSL | boolean
+     */
     hidden?: boolean | string;
+    /**
+     * 命令的关键词
+     *
+     * @type string[]
+     */
     keywords?: ReadonlyArray<string>;
 }>;
 type CommandPosition = 'profile' | 'command-palette';
@@ -14,7 +41,17 @@ interface Command extends Item {
     effect: Effect.Effect<void, never, Scope.Scope>;
 }
 interface Navigation extends Item {
+    /**
+     * 导航项的跳转目标
+     *
+     * @type string
+     */
     target: string;
+    /**
+     * 导航项是否为外部链接
+     *
+     * @type DSL
+     */
     external: string;
 }
 type __VLS_Props = {
@@ -27,6 +64,12 @@ type __VLS_Props = {
         icon?: string;
         children: ReadonlyArray<Navigation>;
     }>>;
+    /**
+     * 应用内命令列表，用于命令面板（Cmd+K）和/或顶栏个人资料下拉菜单。
+     * 每项为「单个命令」或「分组」：单个命令含 positions、effect；分组含 id、title、可选 icon、children（Command 数组）。
+     * positions 控制展示位置：'command-palette' 出现在命令面板，'profile' 出现在个人资料菜单；可同时包含两者。
+     * 用户选择某命令时执行其 effect（带 Scope）。可选 disabled、hidden（CEL 表达式）、keywords 与导航等用法一致。
+     */
     commands?: ReadonlyArray<Command | Readonly<{
         id: string;
         title: string;

package/dist/runtime/components/app.vue

@@ -1,6 +1,6 @@
 <script setup>
-import { useHead, useNuxtApp, useRouter, useRuntimeConfig } from "#app";
-import { computed, ref } from "vue";
+import { useHead, useNuxtApp, useRoute, useRouter, useRuntimeConfig } from "#app";
+import { computed, onMounted, ref } from "vue";
 import { CommandDialog, CommandInput, CommandList, CommandGroup, CommandEmpty, CommandItem } from "./ui/command";
 import { TooltipProvider } from "./ui/tooltip";
 import { Toaster } from "vue-sonner";
@@ -14,7 +14,12 @@ import { Sidebar, SidebarContent, SidebarGroup, SidebarGroupLabel, SidebarMenu,
 import { Collapsible, CollapsibleContent, CollapsibleTrigger } from "./ui/collapsible";
 import Logo from "./logo.vue";
 const { $dsl } = useNuxtApp();
-const config = useRuntimeConfig().public.shwfed;
+const {
+  public: {
+    shwfed: config
+  },
+  app
+} = useRuntimeConfig();
 const props = defineProps({
   navigation: { type: Array, required: false },
   commands: { type: Array, required: false },
@@ -39,6 +44,7 @@ whenever(() => meta_k?.value, () => {
   isCommandOpen.value = !isCommandOpen.value;
 });
 const router = useRouter();
+const route = useRoute();
 setGlobalDslContext(await props.dsl?.pipe(Effect.scoped).pipe(Effect.runPromise) ?? {});
 function toNavigationKey(groupId, itemId) {
   return groupId ? `${groupId}::${itemId}` : `::${itemId}`;
@@ -62,6 +68,25 @@ function findNavigationByKey(navList, key) {
   }
   return void 0;
 }
+function normalizePathForMatch(p) {
+  const trimmed = p.replace(/\/$/, "");
+  return trimmed === "" ? "/" : trimmed;
+}
+function findNavigationKeyByPath(navList, path) {
+  const normalized = normalizePathForMatch(path);
+  for (const el of navList) {
+    if (el.type === "item") {
+      if (el.external === true) continue;
+      if (normalizePathForMatch(el.target) === normalized) return toNavigationKey("", el.id);
+    } else {
+      for (const child of el.children) {
+        if (child.external === true) continue;
+        if (normalizePathForMatch(child.target) === normalized) return toNavigationKey(el.id, child.id);
+      }
+    }
+  }
+  return void 0;
+}
 const palette = computed(() => {
   const items = [];
   for (const navigation2 of props.navigation ?? []) {
@@ -288,6 +313,24 @@ const tabs = useSessionStorage("navigation-tabs", /* @__PURE__ */ new Set(), {
 const activeTab = useSessionStorage("navigation-active-tab", void 0, {
   writeDefaults: false
 });
+onMounted(() => {
+  const baseRaw = app.baseURL ?? "/";
+  const base = baseRaw === "" || baseRaw === "/" ? "/" : baseRaw.replace(/\/*$/, "") + "/";
+  let pathToMatch;
+  if (base === "/") {
+    pathToMatch = route.path;
+  } else if (route.fullPath.startsWith(base)) {
+    const remainder = route.fullPath.slice(base.length) || "/";
+    pathToMatch = remainder.startsWith("/") ? remainder : `/${remainder}`;
+  } else {
+    pathToMatch = route.path;
+  }
+  const key = findNavigationKeyByPath(navigation.value, pathToMatch);
+  if (key !== void 0) {
+    tabs.value.add(key);
+    activeTab.value = key;
+  }
+});
 useHead({
   title: () => activeTab.value ? findNavigationByKey(navigation.value, activeTab.value)?.title ?? config.title : config.title
 });
@@ -649,6 +692,7 @@ useHead({
             >
               {{ findNavigationByKey(navigation, tab)?.title ?? tab ?? "Unknown" }}
               <button
+                v-if="tabs.size > 1"
                 type="button"
                 class="opacity-80 group-hover/tab:opacity-100 transition-opacity cursor-pointer text-zinc-500 hover:text-(--primary) duration-180"
                 @click.stop="() => {

package/dist/runtime/components/app.vue.d.ts

@@ -2,10 +2,37 @@ import type { Scope } from 'effect';
 import { Effect } from 'effect';
 type Item = Readonly<{
     id: string;
+    /**
+     * 命令的标题
+     *
+     * 调用者处理 i18n
+     *
+     * @type string
+     */
     title: string;
+    /**
+     * 命令的图标
+     *
+     * @type string
+     */
     icon?: string;
+    /**
+     * 命令是否禁用
+     *
+     * @type DSL
+     */
     disabled?: boolean | string;
+    /**
+     * 命令是否隐藏
+     *
+     * @type DSL | boolean
+     */
     hidden?: boolean | string;
+    /**
+     * 命令的关键词
+     *
+     * @type string[]
+     */
     keywords?: ReadonlyArray<string>;
 }>;
 type CommandPosition = 'profile' | 'command-palette';
@@ -14,7 +41,17 @@ interface Command extends Item {
     effect: Effect.Effect<void, never, Scope.Scope>;
 }
 interface Navigation extends Item {
+    /**
+     * 导航项的跳转目标
+     *
+     * @type string
+     */
     target: string;
+    /**
+     * 导航项是否为外部链接
+     *
+     * @type DSL
+     */
     external: string;
 }
 type __VLS_Props = {
@@ -27,6 +64,12 @@ type __VLS_Props = {
         icon?: string;
         children: ReadonlyArray<Navigation>;
     }>>;
+    /**
+     * 应用内命令列表，用于命令面板（Cmd+K）和/或顶栏个人资料下拉菜单。
+     * 每项为「单个命令」或「分组」：单个命令含 positions、effect；分组含 id、title、可选 icon、children（Command 数组）。
+     * positions 控制展示位置：'command-palette' 出现在命令面板，'profile' 出现在个人资料菜单；可同时包含两者。
+     * 用户选择某命令时执行其 effect（带 Scope）。可选 disabled、hidden（CEL 表达式）、keywords 与导航等用法一致。
+     */
     commands?: ReadonlyArray<Command | Readonly<{
         id: string;
         title: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shwfed/nuxt",
-  "version": "0.1.55",
+  "version": "0.1.57",
   "description": "",
   "license": "MIT",
   "type": "module",