@shwfed/nuxt 0.1.47 → 0.1.49

package/dist/module.d.mts

@@ -58,6 +58,14 @@ interface ModuleOptions {
          */
         logoutUri?: string;
     }>;
+    profile: Readonly<{
+        /**
+         * 导航栏右侧显示的内容，可以使用 Markdown (DSL)
+         *
+         * @type Markdown
+         */
+        name: string;
+    }>;
 }
 interface Env {
     git: Readonly<{

package/dist/module.json

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

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

@@ -19,12 +19,84 @@ declare const _default: typeof __VLS_export;
 export default _default;
 declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     commands?: ReadonlyArray<Group>;
+    /**
+     * 应用的全局 DSL（CEL）执行上下文。传入一个 Effect，在应用启动时运行一次；
+     * 其解析结果（一个 record）会被永久设为全局上下文，供后续所有 CEL 求值（如 `$dsl.evaluate`）使用。
+     *
+     * 应用会等待该 effect 解析完成后才渲染；在整个应用生命周期内只会执行一次。
+     * 若未传入 `dsl`，全局上下文将被设为 `{}`。
+     *
+     * 适用于需要在首屏前就确定的、会话级稳定数据，例如：当前用户信息、用户所属组、
+     * 用户菜单列表、用户权限（或权限模块）等。此处加载的数据在整个应用内可通过 CEL 访问
+     *（如 `user`、`menu`、`permissions`）。强调「会话级」稳定即可，不必永久不变。
+     *
+     * 重要约束：
+     * - 加载时间至关重要：在该 effect 解析前，整应用不会加载，用户会看到白屏，因此必须保持非常快
+     *   （如减少请求、缓存或并行拉取）。
+     * - 这是有意为之的权衡：菜单、用户等关键数据必须在此加载，否则可能出现空菜单、无用户等异常表现。
+     * - 该 effect 不得抛错（类型为 `never`）：任何失败（如网络）应在 effect 内部处理，
+     *   返回空对象或安全默认值，保证应用仍能正常启动并得到一致的全局上下文。
+     *
+     * 返回的 `Record<string, unknown>` 会在通过 `$dsl.evaluate` 求值 CEL 表达式时，
+     * 与运行时上下文（如 `now`、`today` 及调用处传入的 context）合并使用。
+     *
+     * @example 最小示例：返回静态对象，键可在 CEL 中直接使用
+     * dsl: Effect.succeed({ hello: 'world' })
+     * // 之后在模板或逻辑中：$dsl.evaluate`hello`() 得到 'world'
+     *
+     * @example 实际场景：拉取会话数据（用户、菜单、权限）并返回，供 CEL 使用
+     * dsl: Effect.gen(function* () {
+     *   const [user, menu, permissions] = yield* Effect.all([
+     *     fetchUser().pipe(Effect.catchAll(() => Effect.succeed({ name: '', id: '' }))),
+     *     fetchMenu().pipe(Effect.catchAll(() => Effect.succeed([]))),
+     *     fetchPermissions().pipe(Effect.catchAll(() => Effect.succeed({ canEdit: false }))),
+     *   ])
+     *   return { user, menu, permissions }
+     * })
+     * // CEL 中可访问 user.name、permissions.canEdit 等；失败时在 effect 内兜底，不抛错
+     */
+    dsl?: Effect.Effect<Record<string, unknown>, never, Scope.Scope>;
 }, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{
     commands?: ReadonlyArray<Group>;
+    /**
+     * 应用的全局 DSL（CEL）执行上下文。传入一个 Effect，在应用启动时运行一次；
+     * 其解析结果（一个 record）会被永久设为全局上下文，供后续所有 CEL 求值（如 `$dsl.evaluate`）使用。
+     *
+     * 应用会等待该 effect 解析完成后才渲染；在整个应用生命周期内只会执行一次。
+     * 若未传入 `dsl`，全局上下文将被设为 `{}`。
+     *
+     * 适用于需要在首屏前就确定的、会话级稳定数据，例如：当前用户信息、用户所属组、
+     * 用户菜单列表、用户权限（或权限模块）等。此处加载的数据在整个应用内可通过 CEL 访问
+     *（如 `user`、`menu`、`permissions`）。强调「会话级」稳定即可，不必永久不变。
+     *
+     * 重要约束：
+     * - 加载时间至关重要：在该 effect 解析前，整应用不会加载，用户会看到白屏，因此必须保持非常快
+     *   （如减少请求、缓存或并行拉取）。
+     * - 这是有意为之的权衡：菜单、用户等关键数据必须在此加载，否则可能出现空菜单、无用户等异常表现。
+     * - 该 effect 不得抛错（类型为 `never`）：任何失败（如网络）应在 effect 内部处理，
+     *   返回空对象或安全默认值，保证应用仍能正常启动并得到一致的全局上下文。
+     *
+     * 返回的 `Record<string, unknown>` 会在通过 `$dsl.evaluate` 求值 CEL 表达式时，
+     * 与运行时上下文（如 `now`、`today` 及调用处传入的 context）合并使用。
+     *
+     * @example 最小示例：返回静态对象，键可在 CEL 中直接使用
+     * dsl: Effect.succeed({ hello: 'world' })
+     * // 之后在模板或逻辑中：$dsl.evaluate`hello`() 得到 'world'
+     *
+     * @example 实际场景：拉取会话数据（用户、菜单、权限）并返回，供 CEL 使用
+     * dsl: Effect.gen(function* () {
+     *   const [user, menu, permissions] = yield* Effect.all([
+     *     fetchUser().pipe(Effect.catchAll(() => Effect.succeed({ name: '', id: '' }))),
+     *     fetchMenu().pipe(Effect.catchAll(() => Effect.succeed([]))),
+     *     fetchPermissions().pipe(Effect.catchAll(() => Effect.succeed({ canEdit: false }))),
+     *   ])
+     *   return { user, menu, permissions }
+     * })
+     * // CEL 中可访问 user.name、permissions.canEdit 等；失败时在 effect 内兜底，不抛错
+     */
+    dsl?: Effect.Effect<Record<string, unknown>, never, Scope.Scope>;
 }> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
     menu?: (props: {}) => any;
-} & {
-    'dropdown-trigger'?: (props: {}) => any;
 } & {
     default?: (props: {}) => any;
 }>;

package/dist/runtime/components/app.vue

@@ -9,11 +9,13 @@ import { useI18n } from "vue-i18n";
 import { Icon } from "@iconify/vue";
 import { Effect } from "effect";
 import { DropdownMenu, DropdownMenuContent, DropdownMenuTrigger, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuGroup, DropdownMenuLabel } from "./ui/dropdown-menu";
+import { setGlobalDslContext } from "../plugins/cel/context";
 </script>
 
 <script setup>
-defineProps({
-  commands: { type: Array, required: false }
+const props = defineProps({
+  commands: { type: Array, required: false },
+  dsl: { type: null, required: false }
 });
 const { t } = useI18n();
 useHead({
@@ -32,6 +34,7 @@ const { meta_k } = useMagicKeys();
 whenever(() => meta_k?.value, () => {
   isCommandOpen.value = !isCommandOpen.value;
 });
+setGlobalDslContext(await props.dsl?.pipe(Effect.scoped).pipe(Effect.runPromise) ?? {});
 </script>
 
 <template>
@@ -87,7 +90,7 @@ whenever(() => meta_k?.value, () => {
         </CommandList>
       </CommandDialog>
     </ClientOnly>
-    <main class="h-screen w-screen">
+    <main class="h-screen w-screen flex flex-col overflow-hidden">
       <header class="bg-(--primary) h-12 w-full flex items-center justify-between px-4 gap-4">
         <span class="flex items-center">
           <svg
@@ -169,7 +172,7 @@ whenever(() => meta_k?.value, () => {
     isDropdownOpen = true;
   }"
             >
-              <slot name="dropdown-trigger" />
+              {{ $md.inline`${$config.public.shwfed.profile.name}`() }}
             </button>
           </DropdownMenuTrigger>
           <DropdownMenuContent

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

@@ -19,12 +19,84 @@ declare const _default: typeof __VLS_export;
 export default _default;
 declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     commands?: ReadonlyArray<Group>;
+    /**
+     * 应用的全局 DSL（CEL）执行上下文。传入一个 Effect，在应用启动时运行一次；
+     * 其解析结果（一个 record）会被永久设为全局上下文，供后续所有 CEL 求值（如 `$dsl.evaluate`）使用。
+     *
+     * 应用会等待该 effect 解析完成后才渲染；在整个应用生命周期内只会执行一次。
+     * 若未传入 `dsl`，全局上下文将被设为 `{}`。
+     *
+     * 适用于需要在首屏前就确定的、会话级稳定数据，例如：当前用户信息、用户所属组、
+     * 用户菜单列表、用户权限（或权限模块）等。此处加载的数据在整个应用内可通过 CEL 访问
+     *（如 `user`、`menu`、`permissions`）。强调「会话级」稳定即可，不必永久不变。
+     *
+     * 重要约束：
+     * - 加载时间至关重要：在该 effect 解析前，整应用不会加载，用户会看到白屏，因此必须保持非常快
+     *   （如减少请求、缓存或并行拉取）。
+     * - 这是有意为之的权衡：菜单、用户等关键数据必须在此加载，否则可能出现空菜单、无用户等异常表现。
+     * - 该 effect 不得抛错（类型为 `never`）：任何失败（如网络）应在 effect 内部处理，
+     *   返回空对象或安全默认值，保证应用仍能正常启动并得到一致的全局上下文。
+     *
+     * 返回的 `Record<string, unknown>` 会在通过 `$dsl.evaluate` 求值 CEL 表达式时，
+     * 与运行时上下文（如 `now`、`today` 及调用处传入的 context）合并使用。
+     *
+     * @example 最小示例：返回静态对象，键可在 CEL 中直接使用
+     * dsl: Effect.succeed({ hello: 'world' })
+     * // 之后在模板或逻辑中：$dsl.evaluate`hello`() 得到 'world'
+     *
+     * @example 实际场景：拉取会话数据（用户、菜单、权限）并返回，供 CEL 使用
+     * dsl: Effect.gen(function* () {
+     *   const [user, menu, permissions] = yield* Effect.all([
+     *     fetchUser().pipe(Effect.catchAll(() => Effect.succeed({ name: '', id: '' }))),
+     *     fetchMenu().pipe(Effect.catchAll(() => Effect.succeed([]))),
+     *     fetchPermissions().pipe(Effect.catchAll(() => Effect.succeed({ canEdit: false }))),
+     *   ])
+     *   return { user, menu, permissions }
+     * })
+     * // CEL 中可访问 user.name、permissions.canEdit 等；失败时在 effect 内兜底，不抛错
+     */
+    dsl?: Effect.Effect<Record<string, unknown>, never, Scope.Scope>;
 }, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{
     commands?: ReadonlyArray<Group>;
+    /**
+     * 应用的全局 DSL（CEL）执行上下文。传入一个 Effect，在应用启动时运行一次；
+     * 其解析结果（一个 record）会被永久设为全局上下文，供后续所有 CEL 求值（如 `$dsl.evaluate`）使用。
+     *
+     * 应用会等待该 effect 解析完成后才渲染；在整个应用生命周期内只会执行一次。
+     * 若未传入 `dsl`，全局上下文将被设为 `{}`。
+     *
+     * 适用于需要在首屏前就确定的、会话级稳定数据，例如：当前用户信息、用户所属组、
+     * 用户菜单列表、用户权限（或权限模块）等。此处加载的数据在整个应用内可通过 CEL 访问
+     *（如 `user`、`menu`、`permissions`）。强调「会话级」稳定即可，不必永久不变。
+     *
+     * 重要约束：
+     * - 加载时间至关重要：在该 effect 解析前，整应用不会加载，用户会看到白屏，因此必须保持非常快
+     *   （如减少请求、缓存或并行拉取）。
+     * - 这是有意为之的权衡：菜单、用户等关键数据必须在此加载，否则可能出现空菜单、无用户等异常表现。
+     * - 该 effect 不得抛错（类型为 `never`）：任何失败（如网络）应在 effect 内部处理，
+     *   返回空对象或安全默认值，保证应用仍能正常启动并得到一致的全局上下文。
+     *
+     * 返回的 `Record<string, unknown>` 会在通过 `$dsl.evaluate` 求值 CEL 表达式时，
+     * 与运行时上下文（如 `now`、`today` 及调用处传入的 context）合并使用。
+     *
+     * @example 最小示例：返回静态对象，键可在 CEL 中直接使用
+     * dsl: Effect.succeed({ hello: 'world' })
+     * // 之后在模板或逻辑中：$dsl.evaluate`hello`() 得到 'world'
+     *
+     * @example 实际场景：拉取会话数据（用户、菜单、权限）并返回，供 CEL 使用
+     * dsl: Effect.gen(function* () {
+     *   const [user, menu, permissions] = yield* Effect.all([
+     *     fetchUser().pipe(Effect.catchAll(() => Effect.succeed({ name: '', id: '' }))),
+     *     fetchMenu().pipe(Effect.catchAll(() => Effect.succeed([]))),
+     *     fetchPermissions().pipe(Effect.catchAll(() => Effect.succeed({ canEdit: false }))),
+     *   ])
+     *   return { user, menu, permissions }
+     * })
+     * // CEL 中可访问 user.name、permissions.canEdit 等；失败时在 effect 内兜底，不抛错
+     */
+    dsl?: Effect.Effect<Record<string, unknown>, never, Scope.Scope>;
 }> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
     menu?: (props: {}) => any;
-} & {
-    'dropdown-trigger'?: (props: {}) => any;
 } & {
     default?: (props: {}) => any;
 }>;

package/dist/runtime/plugins/cel/context.d.ts

@@ -0,0 +1,2 @@
+export declare function setGlobalDslContext(context: Record<string, unknown>): void;
+export declare function getGlobalDslContext(): Record<string, unknown>;

package/dist/runtime/plugins/cel/context.js

@@ -0,0 +1,7 @@
+let globalDslContext = {};
+export function setGlobalDslContext(context) {
+  globalDslContext = context;
+}
+export function getGlobalDslContext() {
+  return globalDslContext;
+}

package/dist/runtime/plugins/cel/index.js

@@ -1,6 +1,7 @@
 import { defineNuxtPlugin, useRuntimeConfig } from "#app";
 import defu from "defu";
 import { createEnvironment } from "./env.js";
+import { getGlobalDslContext } from "./context.js";
 export default defineNuxtPlugin({
   name: "shwfed-nuxt:cel",
   setup: () => {
@@ -21,7 +22,7 @@ export default defineNuxtPlugin({
            * Will throw `TypeError` / `EvaluationError` on failure.
            */
           evaluate: (...args) => (context) => {
-            return env.evaluate(String.raw(...args), defu(context, {
+            return env.evaluate(String.raw(...args), defu({}, getGlobalDslContext(), context, {
               now: /* @__PURE__ */ new Date(),
               today: /* @__PURE__ */ new Date()
             }));

package/package.json

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