@frigear-nu/admin 0.0.0-stage → 0.0.1

package/README.md

@@ -1,3 +1,5 @@
-# Temporary Holding Version
+# @frigear-nu/admin
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Generic admin area: an `admin` layout with a sidebar (the `admin.nav` menu), a guarded dashboard (the `admin.dashboard` widget area) and `<AdminPageHeader>`. Other modules register their admin pages and widgets into it.
+
+See the [documentation](../../apps/docs/content/4.modules/02.admin.md) for usage.

package/dist/module.d.mts

@@ -0,0 +1,37 @@
+import * as _nuxt_schema from '@nuxt/schema';
+
+type ModuleOptions = {
+    settings?: {
+        /** Path prefix of the admin area. Defaults to `/admin`. */
+        base?: string;
+        /**
+         * The dashboard page at `base`. `true`/omitted = on, `false` = off (modules' own pages still get the layout),
+         * or a custom path.
+         */
+        dashboard?: boolean | string;
+        /**
+         * Roles allowed into the admin area, applied as an `@frigear-nu/authorization` route rule on `<base>/**`
+         * (only when that module is installed). Defaults to `['admin']`. Pass `false` to set no rule and guard the area yourself.
+         */
+        roles?: string[] | false;
+        /** Applies the `admin` layout to every page under `base` that has no layout of its own. Defaults to `true`. */
+        layout?: boolean;
+    };
+};
+type PublicModuleOptions = {
+    base: string;
+    dashboard?: string;
+};
+
+declare module 'nuxt/schema' {
+    interface NuxtConfig {
+        admin?: ModuleOptions;
+    }
+    interface PublicRuntimeConfig {
+        admin?: PublicModuleOptions;
+    }
+}
+declare const _default: _nuxt_schema.NuxtModule<ModuleOptions, ModuleOptions, false>;
+
+export { _default as default };
+export type { ModuleOptions, PublicModuleOptions };

package/dist/module.json

@@ -0,0 +1,9 @@
+{
+  "name": "@frigear-nu/admin",
+  "configKey": "admin",
+  "version": "0.0.1",
+  "builder": {
+    "@nuxt/module-builder": "1.0.3",
+    "unbuild": "unknown"
+  }
+}

package/dist/module.mjs

@@ -0,0 +1,83 @@
+import { defineNuxtModule, createResolver, addLayout, addComponent, hasNuxtModule, extendPages } from '@nuxt/kit';
+import { registerModule, registerTailwindSource, registerLocales } from '@frigear-nu/module-kit/utils';
+import { extendMenu } from '@frigear-nu/menu/utils';
+
+const trimSlash = (path) => path.length > 1 ? path.replace(/\/+$/, "") : path;
+const module$1 = defineNuxtModule({
+  meta: { name: "@frigear-nu/admin", configKey: "admin" },
+  defaults: {
+    settings: {}
+  },
+  moduleDependencies: {
+    "@frigear-nu/module-kit": { version: ">=0.0.0" },
+    // The signed-in user is shown in the header (`useUserSession`).
+    "nuxt-auth-utils": { version: ">=0.0.1" },
+    "@frigear-nu/menu": { version: ">=0.0.0" },
+    "@frigear-nu/widget": { version: ">=0.0.0" },
+    "@frigear-nu/authorization": { version: ">=0.0.0", optional: true }
+  },
+  setup(options, nuxt) {
+    registerModule("@frigear-nu/admin", nuxt);
+    const resolver = createResolver(import.meta.url);
+    registerTailwindSource(nuxt, resolver.resolve("./runtime/app"));
+    registerLocales(nuxt, resolver.resolve("./runtime/i18n/lang"));
+    const settings = options.settings ?? {};
+    const base = trimSlash(settings.base ?? "/admin");
+    const dashboardPath = settings.dashboard === false ? void 0 : typeof settings.dashboard === "string" ? settings.dashboard : base;
+    nuxt.options.runtimeConfig.public.admin = { base, dashboard: dashboardPath };
+    addLayout({ src: resolver.resolve("./runtime/app/layouts/admin.vue"), filename: "admin.vue" }, "admin");
+    for (const name of ["AdminPage", "AdminPageHeader", "AdminSection", "AdminToolbar", "AdminEmpty", "AdminTable", "AdminStatCard", "AdminKeyValue"]) {
+      addComponent({ name, filePath: resolver.resolve(`./runtime/app/components/${name}.vue`) });
+    }
+    const prefixes = ["", ...(nuxt.options.i18n?.locales ?? []).map((locale) => typeof locale === "string" ? locale : locale.code).map((code) => `/${code}`)];
+    const bases = prefixes.map((prefix) => `${prefix}${base}`);
+    if (settings.roles !== false) {
+      if (hasNuxtModule("@frigear-nu/authorization")) {
+        const rules = nuxt.options.routeRules ||= {};
+        for (const pattern of bases.map((prefixed) => `${prefixed}/**`)) {
+          rules[pattern] = { roles: settings.roles ?? ["admin"], ...rules[pattern] };
+        }
+      } else {
+        console.warn("[@frigear-nu/admin] @frigear-nu/authorization is not installed: the admin pages are not guarded on the client. Install it or set `admin.settings.roles: false` and guard the area yourself.");
+      }
+    }
+    if (settings.layout !== false) {
+      const rules = nuxt.options.routeRules ||= {};
+      for (const prefixed of bases) {
+        for (const pattern of [prefixed, `${prefixed}/**`]) {
+          rules[pattern] = { appLayout: "admin", ...rules[pattern] };
+        }
+      }
+    }
+    if (dashboardPath && settings.roles !== false) {
+      extendMenu(nuxt, "account.dropdown", {
+        id: "admin",
+        label: "Admin",
+        labelKey: "admin.menu.label",
+        description: "Administration",
+        descriptionKey: "admin.menu.description",
+        icon: "i-lucide-shield-check",
+        to: dashboardPath,
+        order: 90,
+        meta: { roles: settings.roles ?? ["admin"] }
+      });
+    }
+    if (dashboardPath) {
+      extendMenu(nuxt, "admin.nav", {
+        id: "admin-dashboard",
+        label: "Dashboard",
+        labelKey: "admin.dashboard.title",
+        icon: "i-lucide-layout-dashboard",
+        to: dashboardPath,
+        order: 0
+      });
+    }
+    extendPages((pages) => {
+      if (dashboardPath && !pages.some((page) => page.path === dashboardPath)) {
+        pages.push({ name: "admin-dashboard", path: dashboardPath, file: resolver.resolve("./runtime/app/pages/dashboard.vue") });
+      }
+    });
+  }
+});
+
+export { module$1 as default };

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

@@ -0,0 +1,18 @@
+type __VLS_Props = {
+    icon?: string;
+    title: string;
+    description?: string;
+};
+declare var __VLS_9: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_9) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/app/components/AdminEmpty.vue

@@ -0,0 +1,24 @@
+<script setup>
+defineProps({
+  icon: { type: String, required: false },
+  title: { type: String, required: true },
+  description: { type: String, required: false }
+});
+</script>
+
+<template>
+  <UEmpty
+    :icon="icon"
+    :title="title"
+    :description="description"
+    variant="naked"
+    class="py-10"
+  >
+    <template
+      v-if="$slots.default"
+      #actions
+    >
+      <slot />
+    </template>
+  </UEmpty>
+</template>

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

@@ -0,0 +1,18 @@
+type __VLS_Props = {
+    icon?: string;
+    title: string;
+    description?: string;
+};
+declare var __VLS_9: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_9) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -0,0 +1,24 @@
+export interface AdminKeyValueItem {
+    key: string;
+    label: string;
+    value?: string | number | null;
+}
+type __VLS_Props = {
+    items: AdminKeyValueItem[];
+    loading?: boolean;
+};
+declare var __VLS_7: string, __VLS_8: {
+    item: AdminKeyValueItem;
+};
+type __VLS_Slots = {} & {
+    [K in NonNullable<typeof __VLS_7>]?: (props: typeof __VLS_8) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/app/components/AdminKeyValue.vue

@@ -0,0 +1,32 @@
+<script setup>
+defineProps({
+  items: { type: Array, required: true },
+  loading: { type: Boolean, required: false }
+});
+</script>
+
+<template>
+  <dl class="grid grid-cols-[auto_1fr] items-center gap-x-6 gap-y-2 text-sm">
+    <template
+      v-for="item in items"
+      :key="item.key"
+    >
+      <dt class="text-muted">
+        {{ item.label }}
+      </dt>
+      <dd class="text-highlighted min-w-0 text-right wrap-break-word">
+        <USkeleton
+          v-if="loading"
+          class="ml-auto h-4 w-24"
+        />
+        <slot
+          v-else
+          :name="item.key"
+          :item="item"
+        >
+          {{ item.value ?? "\u2013" }}
+        </slot>
+      </dd>
+    </template>
+  </dl>
+</template>

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

@@ -0,0 +1,24 @@
+export interface AdminKeyValueItem {
+    key: string;
+    label: string;
+    value?: string | number | null;
+}
+type __VLS_Props = {
+    items: AdminKeyValueItem[];
+    loading?: boolean;
+};
+declare var __VLS_7: string, __VLS_8: {
+    item: AdminKeyValueItem;
+};
+type __VLS_Slots = {} & {
+    [K in NonNullable<typeof __VLS_7>]?: (props: typeof __VLS_8) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -0,0 +1,13 @@
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/app/components/AdminPage.vue

@@ -0,0 +1,5 @@
+<template>
+  <div class="space-y-6">
+    <slot />
+  </div>
+</template>

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

@@ -0,0 +1,13 @@
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -0,0 +1,31 @@
+type __VLS_Props = {
+    title?: string;
+    description?: string;
+    back?: {
+        label: string;
+        to: string;
+    };
+};
+declare var __VLS_9: {}, __VLS_17: {}, __VLS_20: {}, __VLS_23: {}, __VLS_25: {}, __VLS_27: {};
+type __VLS_Slots = {} & {
+    headline?: (props: typeof __VLS_9) => any;
+} & {
+    title?: (props: typeof __VLS_17) => any;
+} & {
+    description?: (props: typeof __VLS_20) => any;
+} & {
+    links?: (props: typeof __VLS_23) => any;
+} & {
+    actions?: (props: typeof __VLS_25) => any;
+} & {
+    default?: (props: typeof __VLS_27) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/app/components/AdminPageHeader.vue

@@ -0,0 +1,58 @@
+<script setup>
+defineProps({
+  title: { type: String, required: false },
+  description: { type: String, required: false },
+  back: { type: Object, required: false }
+});
+</script>
+
+<template>
+  <UPageHeader
+    :title="title"
+    :description="description"
+    :ui="{ root: 'pt-0 pb-6 mb-6', title: 'text-2xl sm:text-3xl' }"
+  >
+    <template
+      v-if="back || $slots.headline"
+      #headline
+    >
+      <slot name="headline">
+        <UButton
+          v-if="back"
+          class="p-0"
+          color="neutral"
+          variant="link"
+          size="sm"
+          icon="i-lucide-arrow-left"
+          :to="back.to"
+          :label="back.label"
+        />
+      </slot>
+    </template>
+
+    <template
+      v-if="$slots.title"
+      #title
+    >
+      <slot name="title" />
+    </template>
+
+    <template
+      v-if="$slots.description"
+      #description
+    >
+      <slot name="description" />
+    </template>
+
+    <template
+      v-if="$slots.links || $slots.actions"
+      #links
+    >
+      <slot name="links">
+        <slot name="actions" />
+      </slot>
+    </template>
+
+    <slot />
+  </UPageHeader>
+</template>

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

@@ -0,0 +1,31 @@
+type __VLS_Props = {
+    title?: string;
+    description?: string;
+    back?: {
+        label: string;
+        to: string;
+    };
+};
+declare var __VLS_9: {}, __VLS_17: {}, __VLS_20: {}, __VLS_23: {}, __VLS_25: {}, __VLS_27: {};
+type __VLS_Slots = {} & {
+    headline?: (props: typeof __VLS_9) => any;
+} & {
+    title?: (props: typeof __VLS_17) => any;
+} & {
+    description?: (props: typeof __VLS_20) => any;
+} & {
+    links?: (props: typeof __VLS_23) => any;
+} & {
+    actions?: (props: typeof __VLS_25) => any;
+} & {
+    default?: (props: typeof __VLS_27) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -0,0 +1,26 @@
+type __VLS_Props = {
+    title?: string;
+    description?: string;
+    loading?: boolean;
+};
+declare var __VLS_1: {}, __VLS_3: {}, __VLS_15: {}, __VLS_17: {}, __VLS_19: {};
+type __VLS_Slots = {} & {
+    header?: (props: typeof __VLS_1) => any;
+} & {
+    actions?: (props: typeof __VLS_3) => any;
+} & {
+    flush?: (props: typeof __VLS_15) => any;
+} & {
+    default?: (props: typeof __VLS_17) => any;
+} & {
+    footer?: (props: typeof __VLS_19) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/app/components/AdminSection.vue

@@ -0,0 +1,55 @@
+<script setup>
+defineProps({
+  title: { type: String, required: false },
+  description: { type: String, required: false },
+  loading: { type: Boolean, required: false }
+});
+</script>
+
+<template>
+  <section class="border-default overflow-hidden rounded-lg border">
+    <div
+      v-if="title || $slots.header || $slots.actions"
+      class="border-default flex flex-wrap items-center justify-between gap-3 border-b px-4 py-3"
+    >
+      <slot name="header">
+        <div class="min-w-0">
+          <h2 class="text-sm font-semibold">
+            {{ title }}
+          </h2>
+          <p
+            v-if="description"
+            class="text-muted text-sm"
+          >
+            {{ description }}
+          </p>
+        </div>
+      </slot>
+      <div
+        v-if="$slots.actions"
+        class="flex items-center gap-2"
+      >
+        <slot name="actions" />
+      </div>
+    </div>
+    <div :class="$slots.flush || loading ? '' : 'p-4'">
+      <div
+        v-if="loading"
+        class="space-y-2 p-4"
+      >
+        <USkeleton class="h-5 w-1/2" />
+        <USkeleton class="h-5 w-1/3" />
+      </div>
+      <template v-else>
+        <slot name="flush" />
+        <slot />
+      </template>
+    </div>
+    <div
+      v-if="$slots.footer"
+      class="border-default border-t px-4 py-3"
+    >
+      <slot name="footer" />
+    </div>
+  </section>
+</template>

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

@@ -0,0 +1,26 @@
+type __VLS_Props = {
+    title?: string;
+    description?: string;
+    loading?: boolean;
+};
+declare var __VLS_1: {}, __VLS_3: {}, __VLS_15: {}, __VLS_17: {}, __VLS_19: {};
+type __VLS_Slots = {} & {
+    header?: (props: typeof __VLS_1) => any;
+} & {
+    actions?: (props: typeof __VLS_3) => any;
+} & {
+    flush?: (props: typeof __VLS_15) => any;
+} & {
+    default?: (props: typeof __VLS_17) => any;
+} & {
+    footer?: (props: typeof __VLS_19) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -0,0 +1,18 @@
+type __VLS_Props = {
+    label: string;
+    loading?: boolean;
+    empty?: string;
+};
+declare var __VLS_11: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_11) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/app/components/AdminStatCard.vue

@@ -0,0 +1,34 @@
+<script setup>
+defineProps({
+  label: { type: String, required: true },
+  loading: { type: Boolean, required: false },
+  empty: { type: String, required: false }
+});
+</script>
+
+<template>
+  <section class="border-default flex h-full flex-col gap-2 overflow-hidden rounded-lg border p-4">
+    <h2 class="text-muted text-xs font-medium tracking-wide uppercase">
+      {{ label }}
+    </h2>
+    <div
+      v-if="loading"
+      class="space-y-2"
+    >
+      <USkeleton class="h-5 w-2/3" />
+      <USkeleton class="h-4 w-1/3" />
+    </div>
+    <div
+      v-else-if="$slots.default"
+      class="flex flex-wrap items-center gap-2 text-sm"
+    >
+      <slot />
+    </div>
+    <p
+      v-else
+      class="text-muted text-sm"
+    >
+      {{ empty }}
+    </p>
+  </section>
+</template>

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

@@ -0,0 +1,18 @@
+type __VLS_Props = {
+    label: string;
+    loading?: boolean;
+    empty?: string;
+};
+declare var __VLS_11: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_11) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -0,0 +1,28 @@
+import type { TableColumn, TableRow } from '@nuxt/ui';
+declare const __VLS_export: <T extends object>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: import("vue").PublicProps & __VLS_PrettifyLocal<{
+        data: T[];
+        columns: TableColumn<T>[];
+        loading?: boolean;
+        empty?: string;
+    } & {
+        onSelect?: ((e: Event, row: TableRow<T>) => any) | undefined;
+    }> & (typeof globalThis extends {
+        __VLS_PROPS_FALLBACK: infer P;
+    } ? P : {});
+    expose: (exposed: {}) => void;
+    attrs: any;
+    slots: {
+        [x: string]: ((props: any) => any) | undefined;
+    };
+    emit: (evt: "select", e: Event, row: TableRow<T>) => void;
+}>) => import("vue").VNode & {
+    __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
+};
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

package/dist/runtime/app/components/AdminTable.vue

@@ -0,0 +1,39 @@
+<script setup>
+defineProps({
+  data: { type: Array, required: true },
+  columns: { type: Array, required: true },
+  loading: { type: Boolean, required: false },
+  empty: { type: String, required: false }
+});
+const emit = defineEmits(["select"]);
+</script>
+
+<template>
+  <div class="border-default overflow-hidden rounded-lg border">
+    <UTable
+      :data="data"
+      :columns="columns"
+      :loading="loading"
+      @select="(e, row) => emit('select', e, row)"
+    >
+      <template
+        v-for="(_, name) in $slots"
+        #[name]="slotProps"
+      >
+        <slot
+          :name="name"
+          v-bind="slotProps ?? {}"
+        />
+      </template>
+      <template
+        v-if="empty && !$slots.empty"
+        #empty
+      >
+        <AdminEmpty
+          icon="i-lucide-inbox"
+          :title="empty"
+        />
+      </template>
+    </UTable>
+  </div>
+</template>

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

@@ -0,0 +1,28 @@
+import type { TableColumn, TableRow } from '@nuxt/ui';
+declare const __VLS_export: <T extends object>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: import("vue").PublicProps & __VLS_PrettifyLocal<{
+        data: T[];
+        columns: TableColumn<T>[];
+        loading?: boolean;
+        empty?: string;
+    } & {
+        onSelect?: ((e: Event, row: TableRow<T>) => any) | undefined;
+    }> & (typeof globalThis extends {
+        __VLS_PROPS_FALLBACK: infer P;
+    } ? P : {});
+    expose: (exposed: {}) => void;
+    attrs: any;
+    slots: {
+        [x: string]: ((props: any) => any) | undefined;
+    };
+    emit: (evt: "select", e: Event, row: TableRow<T>) => void;
+}>) => import("vue").VNode & {
+    __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
+};
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

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

@@ -0,0 +1,13 @@
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/app/components/AdminToolbar.vue

@@ -0,0 +1,5 @@
+<template>
+  <div class="flex flex-wrap items-center gap-3">
+    <slot />
+  </div>
+</template>

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

@@ -0,0 +1,13 @@
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/app/layouts/admin.d.vue.ts

@@ -0,0 +1,13 @@
+declare var __VLS_84: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_84) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/app/layouts/admin.vue

@@ -0,0 +1,105 @@
+<script setup>
+defineOptions({ name: "AdminLayout" });
+const t = useModuleT("admin");
+const route = useRoute();
+const config = useRuntimeConfig().public.admin;
+const LanguageSelect = resolveComponent("LanguageSelect");
+const AccountMenu = resolveComponent("AccountMenu");
+const optional = (component) => typeof component === "string" ? void 0 : component;
+const nuxtApp = useNuxtApp();
+const multiLocale = (nuxtApp.$i18n?.locales?.value?.length ?? 0) > 1;
+const { data: items } = await useMenu("admin.nav");
+const home = config?.dashboard ?? config?.base ?? "/admin";
+const stripLocale = (path) => {
+  const trimmed = path.length > 1 ? path.replace(/\/+$/, "") : path;
+  const first = trimmed.split("/")[1];
+  const codes = (nuxtApp.$i18n?.locales?.value ?? []).map((l) => typeof l === "string" ? l : l.code);
+  return first && codes.includes(first) ? trimmed.slice(first.length + 1) || "/" : trimmed;
+};
+const links = computed(() => (items.value ?? []).map((item) => ({
+  label: item.label,
+  icon: item.icon,
+  to: item.to,
+  external: item.external,
+  // The dashboard lives at the base itself, so it only matches exactly (ignoring a locale prefix).
+  active: !!item.to && (item.to === home ? stripLocale(route.path) === home : route.path === item.to || route.path.startsWith(`${item.to}/`))
+})));
+const title = computed(() => links.value.find((link) => link.active)?.label ?? t("title", "Administration"));
+const sidebarOpen = ref(false);
+watch(() => route.path, () => {
+  sidebarOpen.value = false;
+});
+</script>
+
+<template>
+  <div class="h-dvh w-full overflow-hidden bg-default">
+    <UDashboardGroup
+      unit="rem"
+      :ui="{ base: 'admin-group relative flex h-full w-full overflow-hidden' }"
+    >
+      <UDashboardSidebar
+        v-model:open="sidebarOpen"
+        :default-size="16"
+        :min-size="12"
+        :max-size="22"
+        :ui="{ root: 'min-h-0', footer: 'border-t border-default' }"
+      >
+        <template #header>
+          <NuxtLink
+            :to="home"
+            class="flex items-center gap-2 font-semibold"
+          >
+            <UIcon name="i-lucide-layout-dashboard" />
+            <span>{{ t("title", "Administration") }}</span>
+          </NuxtLink>
+        </template>
+
+        <UNavigationMenu
+          orientation="vertical"
+          :items="links"
+          :aria-label="t('nav.label', 'Admin navigation')"
+        />
+
+        <template #footer>
+          <UButton
+            to="/"
+            color="neutral"
+            variant="ghost"
+            icon="i-lucide-arrow-left"
+            :label="t('backToSite', 'Back to the site')"
+            block
+          />
+        </template>
+      </UDashboardSidebar>
+
+      <UDashboardPanel :ui="{ body: 'p-0 sm:p-0 gap-0' }">
+        <template #header>
+          <UDashboardNavbar :title="title">
+            <template #leading>
+              <UDashboardSidebarCollapse />
+            </template>
+            <template #right>
+              <component
+                :is="optional(LanguageSelect)"
+                v-if="optional(LanguageSelect) && multiLocale"
+              />
+              <UColorModeButton />
+              <component
+                :is="optional(AccountMenu)"
+                v-if="optional(AccountMenu)"
+              />
+            </template>
+          </UDashboardNavbar>
+        </template>
+
+        <template #body>
+          <UPage :ui="{ root: 'block', center: 'admin-content px-4 sm:px-6' }">
+            <UPageBody class="mt-0 pt-6 pb-12 space-y-0">
+              <slot />
+            </UPageBody>
+          </UPage>
+        </template>
+      </UDashboardPanel>
+    </UDashboardGroup>
+  </div>
+</template>

package/dist/runtime/app/layouts/admin.vue.d.ts

@@ -0,0 +1,13 @@
+declare var __VLS_84: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_84) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/app/pages/dashboard.d.vue.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/app/pages/dashboard.vue

@@ -0,0 +1,38 @@
+<script setup>
+defineOptions({ name: "AdminDashboardPage" });
+const t = useModuleT("admin");
+const { data: menu } = await useMenu("admin.nav");
+const items = computed(() => (menu.value ?? []).filter((item) => item.id !== "admin-dashboard"));
+</script>
+
+<template>
+  <AdminPage>
+    <AdminPageHeader
+      :title="t('dashboard.title', 'Dashboard')"
+      :description="t('dashboard.description', 'Overview and shortcuts for administrators.')"
+    />
+    <WidgetArea name="admin.dashboard">
+      <template #empty>
+        <div
+          v-if="items.length"
+          class="grid grid-cols-[repeat(auto-fill,minmax(16rem,1fr))] gap-4"
+        >
+          <UPageCard
+            v-for="item in items"
+            :key="item.id"
+            :title="item.label"
+            :description="item.description"
+            :icon="item.icon"
+            :to="item.to"
+          />
+        </div>
+        <p
+          v-else
+          class="text-muted"
+        >
+          {{ t("dashboard.empty", "Nothing here yet. Modules add their admin pages and widgets automatically.") }}
+        </p>
+      </template>
+    </WidgetArea>
+  </AdminPage>
+</template>

package/dist/runtime/app/pages/dashboard.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/i18n/lang/da.json

@@ -0,0 +1,18 @@
+{
+  "admin": {
+    "title": "Administration",
+    "nav": {
+      "label": "Admin-navigation"
+    },
+    "dashboard": {
+      "title": "Oversigt",
+      "description": "Overblik og genveje til administratorer.",
+      "empty": "Her er endnu intet. Moduler tilføjer deres admin-sider og widgets automatisk."
+    },
+    "backToSite": "Tilbage til siden",
+    "menu": {
+      "label": "Admin",
+      "description": "Administration"
+    }
+  }
+}

package/dist/runtime/i18n/lang/en.json

@@ -0,0 +1,18 @@
+{
+  "admin": {
+    "title": "Administration",
+    "nav": {
+      "label": "Admin navigation"
+    },
+    "dashboard": {
+      "title": "Dashboard",
+      "description": "Overview and shortcuts for administrators.",
+      "empty": "Nothing here yet. Modules add their admin pages and widgets automatically."
+    },
+    "backToSite": "Back to the site",
+    "menu": {
+      "label": "Admin",
+      "description": "Administration"
+    }
+  }
+}

package/dist/runtime/utils/index.d.ts

@@ -0,0 +1,14 @@
+import type { Nuxt } from '@nuxt/schema';
+import type { MenuItem } from '@frigear-nu/menu/utils';
+import type { WidgetDefinition } from '@frigear-nu/widget/utils';
+/**
+ * The path of an admin page below the configured admin base (`admin.settings.base`, `/admin` by default):
+ * `adminRoute(nuxt, 'events', ':id')` is `/admin/events/:id`. Module defaults use it so they follow the host's base.
+ */
+export declare const adminRoute: (nuxt: Nuxt, ...segments: string[]) => string;
+export declare const ADMIN_NAV_MENU = "admin.nav";
+export declare const ADMIN_DASHBOARD_AREA = "admin.dashboard";
+/** Adds entries to the admin sidebar (the `admin.nav` menu of `@frigear-nu/menu`). Call from a module's `setup()`. */
+export declare const extendAdminNav: (nuxt: Nuxt, items: MenuItem | MenuItem[]) => void;
+/** Adds widgets to the admin dashboard (the `admin.dashboard` area of `@frigear-nu/widget`). Call from a module's `setup()`. */
+export declare const extendAdminDashboard: (nuxt: Nuxt, widgets: WidgetDefinition | WidgetDefinition[]) => void;

package/dist/runtime/utils/index.js

@@ -0,0 +1,10 @@
+import { extendMenu } from "@frigear-nu/menu/utils";
+import { extendWidgets } from "@frigear-nu/widget/utils";
+export const adminRoute = (nuxt, ...segments) => {
+  const base = nuxt.options.admin?.settings?.base ?? "/admin";
+  return [base.replace(/\/+$/, ""), ...segments].join("/");
+};
+export const ADMIN_NAV_MENU = "admin.nav";
+export const ADMIN_DASHBOARD_AREA = "admin.dashboard";
+export const extendAdminNav = (nuxt, items) => extendMenu(nuxt, ADMIN_NAV_MENU, items);
+export const extendAdminDashboard = (nuxt, widgets) => extendWidgets(nuxt, ADMIN_DASHBOARD_AREA, widgets);

package/dist/types.d.mts

@@ -0,0 +1,3 @@
+export { default } from './module.mjs'
+
+export { type ModuleOptions, type PublicModuleOptions } from './module.mjs'

package/package.json

@@ -1,6 +1,77 @@
 {
   "name": "@frigear-nu/admin",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.0.1",
+  "description": "Generic admin area: shell layout, guarded dashboard and navigation that other modules contribute to through @frigear-nu/menu and @frigear-nu/widget.",
+  "homepage": "https://docs.frigear.dev/modules/admin",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/frigear-nu/frigear-nu.git",
+    "directory": "packages/admin"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/module.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/types.d.mts",
+      "import": "./dist/module.mjs",
+      "default": "./dist/module.mjs"
+    },
+    "./utils": {
+      "types": "./dist/runtime/utils/index.d.ts",
+      "import": "./dist/runtime/utils/index.js",
+      "default": "./dist/runtime/utils/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "workspaces": [
+    "playground"
+  ],
+  "dependencies": {
+    "@frigear-nu/menu": "0.0.8",
+    "@frigear-nu/module-kit": "0.1.6",
+    "@frigear-nu/widget": "0.0.0",
+    "@nuxt/kit": "^4.6.0",
+    "nuxt-auth-utils": "^0.5.30"
+  },
+  "devDependencies": {
+    "@nuxt/devtools": "^3.4.2",
+    "@nuxt/eslint-config": "^1.17.0",
+    "@nuxt/module-builder": "^1.0.3",
+    "@nuxt/schema": "^4.6.0",
+    "@nuxt/test-utils": "^4.3.2",
+    "@nuxt/ui": "^4.11.0",
+    "@types/node": "latest",
+    "changelogen": "^0.6.2",
+    "eslint": "^10.10.0",
+    "nuxt": "^4.6.1",
+    "typescript": "^6.0.3",
+    "vitest": "^5.0.1",
+    "vue-tsc": "^3.3.11"
+  },
+  "peerDependencies": {
+    "@nuxt/ui": "^4.10.0"
+  },
+  "scripts": {
+    "postinstall": "nuxt-module-build build --stub && nuxt prepare",
+    "build": "nuxt-module-build build",
+    "dev": "npm run dev:prepare && nuxt dev playground",
+    "dev:build": "nuxt build playground",
+    "dev:prepare": "nuxt-module-build build --stub && nuxt-module-build prepare && nuxt prepare playground",
+    "release": "npm run lint && npm run test && npm run prepack && changelogen --release && npm publish && git push --follow-tags",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "test:types": "vue-tsc --noEmit && cd playground && vue-tsc --noEmit"
+  },
+  "typesVersions": {
+    "*": {
+      ".": [
+        "./dist/types.d.mts"
+      ]
+    }
+  }
 }