studiocms 0.1.0-beta.24 → 0.1.0-beta.26

package/dist/virtuals/i18n/v-files.js

@@ -0,0 +1,46 @@
+import { posix } from "node:path";
+import { fileURLToPath } from "node:url";
+import { readJson } from "@withstudiocms/internal_helpers/utils";
+import { glob } from "tinyglobby";
+const translationsDir = fileURLToPath(new URL("./translations/", import.meta.url));
+const availableTranslationFiles = await glob("**/*.json", { cwd: translationsDir });
+const availableTranslationFileKeys = availableTranslationFiles.map((file) => posix.normalize(file).replace(/\.json$/, "")).filter(Boolean);
+function checkStrings(record) {
+  if (typeof record !== "object" || record === null) return { count: 0, emptyStrings: 0 };
+  let count = 0;
+  let emptyStrings = 0;
+  for (const value of Object.values(record)) {
+    if (typeof value === "string") {
+      count++;
+      if (value.trim() === "") emptyStrings++;
+    } else if (typeof value === "object" && value !== null) {
+      const { count: c, emptyStrings: e } = checkStrings(value);
+      count += c;
+      emptyStrings += e;
+    }
+  }
+  return { count, emptyStrings };
+}
+const MISSING_RATIO_THRESHOLD = 0.1;
+function checkThreshold(opt) {
+  const threshold = MISSING_RATIO_THRESHOLD;
+  if (opt.count === 0) return false;
+  return opt.emptyStrings / opt.count <= threshold;
+}
+const availableTranslations = (() => {
+  const results = {};
+  const translationKeys = availableTranslationFileKeys.filter((key) => key !== "en");
+  for (const key of translationKeys) {
+    const translation = readJson(`${translationsDir + key}.json`);
+    const result = checkStrings(translation);
+    if (!checkThreshold(result)) {
+      continue;
+    }
+    results[key] = translation;
+  }
+  return results;
+})();
+export {
+  availableTranslationFileKeys,
+  availableTranslations
+};

package/dist/virtuals/lib/head.d.ts

@@ -0,0 +1 @@
+export * from '@withstudiocms/internal_helpers/headConfigSchema';

package/dist/virtuals/lib/head.js

@@ -0,0 +1 @@
+export * from "@withstudiocms/internal_helpers/headConfigSchema";

package/dist/{lib → virtuals/lib}/headDefaults.d.ts

@@ -12,7 +12,7 @@ import type { AstroGlobalPartial } from 'astro';
  * @returns
  */
 export declare const headDefaults: (title: string, description: string, lang: string, Astro: AstroGlobalPartial, favicon: string, ogImage: string | undefined, canonical: URL | undefined) => {
-    tag: "link" | "title" | "base" | "style" | "meta" | "script" | "noscript" | "template";
+    tag: "title" | "base" | "link" | "style" | "meta" | "script" | "noscript" | "template";
     attrs?: Record<string, string | boolean | undefined> | undefined;
     content?: string | undefined;
 }[];

package/dist/{lib → virtuals/lib}/headDefaults.js

@@ -1,7 +1,7 @@
 import { extname } from "node:path";
 import version from "studiocms:version";
 import { lookup } from "mrmime";
-import { StudioCMSCoreError } from "../errors.js";
+import { StudioCMSCoreError } from "../../errors.js";
 import { HeadConfigSchema } from "./head.js";
 const _schema = HeadConfigSchema;
 const faviconTypes = [".ico", ".gif", ".jpeg", ".jpg", ".png", ".svg"];

package/dist/{lib → virtuals/lib}/makeAPIRoute.d.ts

@@ -1,4 +1,4 @@
-import type { CurrentRESTAPIVersions } from '../consts.js';
+import type { CurrentRESTAPIVersions } from '../../consts.js';
 /**
  * Creates a function that generates API route strings.
  *

package/dist/virtuals/lib/pathGenerators.d.ts

@@ -0,0 +1 @@
+export * from '@withstudiocms/internal_helpers/pathGenerators';

package/dist/virtuals/lib/pathGenerators.js

@@ -0,0 +1 @@
+export * from "@withstudiocms/internal_helpers/pathGenerators";

package/dist/{lib → virtuals/lib}/routeMap.d.ts

@@ -250,6 +250,10 @@ export declare const StudioCMSRoutes: {
          * SDK route for updating the latest version cache.
          */
         updateLatestVersionCache: string;
+        /**
+         * SDK route for the full changelog JSON.
+         */
+        changelog: string;
     };
     fts: {
         /**

package/dist/{lib → virtuals/lib}/routeMap.js

@@ -233,7 +233,11 @@ const StudioCMSRoutes = {
     /**
      * SDK route for updating the latest version cache.
      */
-    updateLatestVersionCache: sdkRoute("update-latest-version-cache")
+    updateLatestVersionCache: sdkRoute("update-latest-version-cache"),
+    /**
+     * SDK route for the full changelog JSON.
+     */
+    changelog: sdkRoute("full-changelog.json")
   },
   fts: {
     /**

package/dist/{lib → virtuals/lib}/urlGen.d.ts

@@ -1,3 +1,4 @@
+declare const urlGenFactory: (isDashboardRoute: boolean, path: string | undefined, DashboardRouteOverride?: string) => string;
 /**
  * # urlGenFactory Helper Function
  *
@@ -8,4 +9,4 @@
  * @param DashboardRouteOverride
  * @returns
  */
-export default function urlGenFactory(isDashboardRoute: boolean, path: string | undefined, DashboardRouteOverride?: string): string;
+export default urlGenFactory;

package/dist/virtuals/lib/urlGen.js

@@ -0,0 +1,6 @@
+import { createURLGenFactory } from "@withstudiocms/internal_helpers/urlGenFactory";
+const urlGenFactory = createURLGenFactory("dashboard");
+var urlGen_default = urlGenFactory;
+export {
+  urlGen_default as default
+};

package/dist/virtuals/mailer/index.d.ts

@@ -0,0 +1,64 @@
+import { Effect, Layer } from '../../effect.js';
+import { SMTPMailer } from '../../utils/effects/smtp.js';
+import type { ConfigFinal, StudioCMSMailerConfig } from '../sdk/modules/config.js';
+/**
+ * Interface representing the options for sending an email.
+ */
+export interface MailOptions {
+    /**
+     * The recipient(s) of the email. Can be a single email address or an array of email addresses.
+     */
+    to: string | string[];
+    /**
+     * The subject of the email.
+     */
+    subject: string;
+    /**
+     * The plain text content of the email. Optional.
+     */
+    text?: string | undefined;
+    /**
+     * The HTML content of the email. Optional.
+     */
+    html?: string | undefined;
+}
+/**
+ * Interface representing an error response from the mailer.
+ */
+export interface MailerErrorResponse {
+    error: string;
+}
+/**
+ * Interface representing a success response from the mailer.
+ */
+export interface MailerSuccessResponse {
+    message: string;
+}
+/**
+ * Interface representing the response from a mail verification operation.
+ */
+export type MailerResponse = MailerSuccessResponse | MailerErrorResponse;
+export declare const makeLogger: Effect.Effect<import("astro").AstroIntegrationLogger, never, never>;
+declare const Logger_base: import("effect/Context").TagClass<Logger, "studiocms/lib/mailer/Logger", import("astro").AstroIntegrationLogger> & Effect.Tag.Proxy<Logger, import("astro").AstroIntegrationLogger> & {
+    use: <X>(body: (_: import("astro").AstroIntegrationLogger) => X) => [X] extends [Effect.Effect<infer A, infer E, infer R>] ? Effect.Effect<A, E, Logger | R> : [X] extends [PromiseLike<infer A_1>] ? Effect.Effect<A_1, import("effect/Cause").UnknownException, Logger> : Effect.Effect<X, never, Logger>;
+};
+export declare class Logger extends Logger_base {
+    static Live: Effect.Effect<import("astro").AstroIntegrationLogger, never, never>;
+    static Layer: Layer.Layer<Logger, never, never>;
+}
+declare const Mailer_base: Effect.Service.Class<Mailer, "studiocms/lib/mailer/Mailer", {
+    readonly effect: Effect.Effect<{
+        getMailerConfigTable: Effect.Effect<import("../sdk/modules/config.js").DynamicConfigEntry<StudioCMSMailerConfig> | undefined, import("../sdk/effect/db.js").LibSQLDatabaseError, never>;
+        updateMailerConfigTable: (config: ConfigFinal<StudioCMSMailerConfig>) => Effect.Effect<MailerErrorResponse | MailerSuccessResponse, never, never>;
+        createMailerConfigTable: (config: ConfigFinal<StudioCMSMailerConfig>) => Effect.Effect<import("../sdk/modules/config.js").DynamicConfigEntry<StudioCMSMailerConfig>, import("../sdk/effect/db.js").LibSQLDatabaseError, never>;
+        sendMail: ({ subject, ...message }: MailOptions) => Effect.Effect<MailerErrorResponse | MailerSuccessResponse, Error, never>;
+        verifyMailConnection: Effect.Effect<MailerErrorResponse | MailerSuccessResponse, Error, never>;
+        isEnabled: Effect.Effect<boolean, import("../sdk/errors.js").SDKCoreError, never>;
+    }, never, SMTPMailer | Logger>;
+    readonly dependencies: readonly [Layer.Layer<Logger, never, never>, Layer.Layer<SMTPMailer, Error, never>];
+    readonly accessors: true;
+}>;
+export declare class Mailer extends Mailer_base {
+    static Provide: <A, E, R>(self: Effect.Effect<A, E, R>) => Effect.Effect<A, Error | E, Exclude<R, Mailer>>;
+}
+export {};

package/dist/{lib → virtuals}/mailer/index.js

@@ -1,13 +1,7 @@
-import { eq } from "astro:db";
 import { logger as _logger, isVerbose } from "studiocms:logger";
 import { SDKCoreJs as sdk } from "studiocms:sdk";
-import { asDrizzleTable } from "@astrojs/db/utils";
-import { Effect, Layer } from "effect";
-import { CMSMailerConfigId } from "../../consts.js";
-import { StudioCMSMailerConfig } from "../../db/tables.js";
-import { genLogger, pipeLogger } from "../effects/index.js";
-import { SMTPMailer } from "../effects/smtp.js";
-const tsMailerConfig = asDrizzleTable("StudioCMSMailerConfig", StudioCMSMailerConfig);
+import { Effect, genLogger, Layer, pipeLogger } from "../../effect.js";
+import { SMTPMailer } from "../../utils/effects/smtp.js";
 const forked = _logger.fork("studiocms:runtime/mailer");
 const makeLogger = Effect.succeed(forked);
 class Logger extends Effect.Tag("studiocms/lib/mailer/Logger")() {
@@ -27,14 +21,10 @@ class Mailer extends Effect.Service()("studiocms/lib/mailer/Mailer", {
       return data;
     };
     const getMailerConfigTable = pipeLogger("studiocms/lib/mailer/Mailer.getMailerConfigTable")(
-      sdk.dbService.execute(
-        (db) => db.select().from(tsMailerConfig).where(eq(tsMailerConfig.id, CMSMailerConfigId)).get()
-      )
+      sdk.CONFIG.mailerConfig.get()
     );
     const updateMailerConfigTable = (config) => genLogger("studiocms/lib/mailer/Mailer.updateMailerConfigTable")(function* () {
-      yield* sdk.dbService.execute(
-        (db) => db.update(tsMailerConfig).set(config).where(eq(tsMailerConfig.id, CMSMailerConfigId))
-      ).pipe(
+      yield* sdk.CONFIG.mailerConfig.update(config).pipe(
         Effect.catchAll(
           (e) => Effect.succeed(
             mailerResponse({ error: `Error updating mailer configuration: ${String(e)}` })
@@ -44,13 +34,7 @@ class Mailer extends Effect.Service()("studiocms/lib/mailer/Mailer", {
       return mailerResponse({ message: "Mailer configuration updated successfully" });
     });
     const createMailerConfigTable = (config) => pipeLogger("studiocms/lib/mailer/Mailer.createMailerConfigTable")(
-      sdk.dbService.execute(
-        (db) => db.insert(tsMailerConfig).values({ ...config, id: CMSMailerConfigId }).onConflictDoUpdate({
-          target: tsMailerConfig.id,
-          set: config,
-          where: eq(tsMailerConfig.id, CMSMailerConfigId)
-        }).returning().get()
-      )
+      sdk.CONFIG.mailerConfig.init(config)
     );
     const sendMail = ({ subject, ...message }) => genLogger("studiocms/lib/mailer/Mailer.sendMail")(function* () {
       const toSend = { subject };
@@ -66,7 +50,7 @@ class Mailer extends Effect.Service()("studiocms/lib/mailer/Mailer", {
     });
     const verifyMailConnection = genLogger("studiocms/lib/mailer/Mailer.verifyMailConnection")(
       function* () {
-        const result = yield* SMTP.verify();
+        const result = yield* SMTP.verifyTransport();
         if (result !== true) {
           return mailerResponse({ error: "Mail connection verification failed" });
         }
@@ -95,6 +79,5 @@ class Mailer extends Effect.Service()("studiocms/lib/mailer/Mailer", {
 export {
   Logger,
   Mailer,
-  makeLogger,
-  tsMailerConfig
+  makeLogger
 };

package/dist/{lib → virtuals}/notifier/index.d.ts

@@ -1,4 +1,4 @@
-import { Effect } from 'effect';
+import { Effect } from '../../effect.js';
 import type { UserNotificationOptions } from './client.js';
 /**
  * An object containing notification messages for user-related events.
@@ -64,14 +64,13 @@ export type AdminNotification = keyof AdminNotifications;
 export declare const makeLogger: Effect.Effect<import("astro").AstroIntegrationLogger, never, never>;
 declare const Notifications_base: Effect.Service.Class<Notifications, "studiocms/lib/notifier/Notifications", {
     readonly effect: Effect.Effect<{
-        sendUserNotification: <T extends UserNotification>(notification: T, userId: string) => Effect.Effect<void, import("../effects/smtp.js").SMTPError | import("../../sdk/errors.js").SDKCoreError, never>;
-        sendEditorNotification: <T extends EditorNotification, K extends Parameters<EditorNotifications[T]>[0]>(notification: T, data: K) => Effect.Effect<void, import("../effects/smtp.js").SMTPError | import("../../sdk/errors.js").SDKCoreError, never>;
-        sendAdminNotification: <T extends AdminNotification, K extends Parameters<AdminNotifications[T]>[0]>(notification: T, data: K) => Effect.Effect<void, import("../effects/smtp.js").SMTPError | import("../../sdk/errors.js").SDKCoreError, never>;
+        sendUserNotification: <T extends UserNotification>(notification: T, userId: string) => Effect.Effect<void, Error | import("../sdk/errors.js").SDKCoreError, never>;
+        sendEditorNotification: <T extends EditorNotification, K extends Parameters<EditorNotifications[T]>[0]>(notification: T, data: K) => Effect.Effect<void, Error | import("../sdk/errors.js").SDKCoreError, never>;
+        sendAdminNotification: <T extends AdminNotification, K extends Parameters<AdminNotifications[T]>[0]>(notification: T, data: K) => Effect.Effect<void, Error | import("../sdk/errors.js").SDKCoreError, never>;
     }, never, import("../mailer/index.js").Mailer>;
-    readonly dependencies: readonly [import("effect/Layer").Layer<import("../mailer/index.js").Mailer, import("../effects/smtp.js").SMTPError | import("effect/Cause").UnknownException, never>];
-    readonly accessors: true;
+    readonly dependencies: readonly [import("effect/Layer").Layer<import("../mailer/index.js").Mailer, Error, never>];
 }>;
 export declare class Notifications extends Notifications_base {
-    static Provide: <A, E, R>(self: Effect.Effect<A, E, R>) => Effect.Effect<A, import("../effects/smtp.js").SMTPError | import("effect/Cause").UnknownException | E, Exclude<R, Notifications>>;
+    static Provide: <A, E, R>(self: Effect.Effect<A, E, R>) => Effect.Effect<A, Error | E, Exclude<R, Notifications>>;
 }
 export {};

package/dist/{lib → virtuals}/notifier/index.js

@@ -2,8 +2,7 @@ import _logger from "studiocms:logger";
 import { Mailer } from "studiocms:mailer";
 import getTemplate from "studiocms:mailer/templates";
 import { SDKCoreJs as sdk } from "studiocms:sdk";
-import { Effect } from "effect";
-import { genLogger } from "../effects/index.js";
+import { Effect, genLogger } from "../../effect.js";
 const userNotifications = {
   account_updated: (name) => `Hello ${name}! There has been an update to your account. If you did not make this change, please contact a system administrator.`
 };
@@ -152,8 +151,7 @@ class Notifications extends Effect.Service()(
         sendAdminNotification
       };
     }),
-    dependencies: [Mailer.Default],
-    accessors: true
+    dependencies: [Mailer.Default]
   }
 ) {
   static Provide = Effect.provide(this.Default);

package/dist/virtuals/plugins/dashboard-pages.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Retrieves the dashboard pages for the plugins.
+ *
+ * @returns An object containing `userPages` and `adminPages`.
+ */
+export declare function getPluginDashboardPages(): {
+    userPages: ({
+        title: Record<string, string>;
+        description: string;
+        route: string;
+        pageBodyComponent: string;
+        slug: string;
+        components: {
+            PageBodyComponent: (_props: any) => any;
+            PageActionsComponent?: ((_props: any) => any) | undefined;
+            InnerSidebarComponent?: ((_props: any) => any) | undefined;
+        };
+        sidebar: "single";
+        icon?: string | undefined;
+        requiredPermissions?: "owner" | "admin" | "editor" | "visitor" | "none" | undefined;
+        pageActionsComponent?: string | undefined;
+    } | {
+        title: Record<string, string>;
+        description: string;
+        route: string;
+        pageBodyComponent: string;
+        slug: string;
+        components: {
+            PageBodyComponent: (_props: any) => any;
+            PageActionsComponent?: ((_props: any) => any) | undefined;
+            InnerSidebarComponent?: ((_props: any) => any) | undefined;
+        };
+        sidebar: "double";
+        innerSidebarComponent: string;
+        icon?: string | undefined;
+        requiredPermissions?: "owner" | "admin" | "editor" | "visitor" | "none" | undefined;
+        pageActionsComponent?: string | undefined;
+    })[];
+    adminPages: ({
+        title: Record<string, string>;
+        description: string;
+        route: string;
+        pageBodyComponent: string;
+        slug: string;
+        components: {
+            PageBodyComponent: (_props: any) => any;
+            PageActionsComponent?: ((_props: any) => any) | undefined;
+            InnerSidebarComponent?: ((_props: any) => any) | undefined;
+        };
+        sidebar: "single";
+        icon?: string | undefined;
+        requiredPermissions?: "owner" | "admin" | "editor" | "visitor" | "none" | undefined;
+        pageActionsComponent?: string | undefined;
+    } | {
+        title: Record<string, string>;
+        description: string;
+        route: string;
+        pageBodyComponent: string;
+        slug: string;
+        components: {
+            PageBodyComponent: (_props: any) => any;
+            PageActionsComponent?: ((_props: any) => any) | undefined;
+            InnerSidebarComponent?: ((_props: any) => any) | undefined;
+        };
+        sidebar: "double";
+        innerSidebarComponent: string;
+        icon?: string | undefined;
+        requiredPermissions?: "owner" | "admin" | "editor" | "visitor" | "none" | undefined;
+        pageActionsComponent?: string | undefined;
+    })[];
+};

package/dist/virtuals/scripts/user-quick-tools.d.ts

@@ -0,0 +1,91 @@
+interface UserData {
+    id: string;
+    name: string;
+    email: string | null;
+    avatar: string | null;
+    username: string;
+}
+interface Routes {
+    logout: string;
+    userProfile: string;
+    contentManagement: string;
+    dashboardIndex: string;
+}
+type PermissionLevel = 'editor' | 'visitor' | 'admin' | 'owner' | 'unknown';
+interface MenuItem {
+    name: string;
+    svg: string;
+    href: string;
+    permission: PermissionLevel;
+    cssClass: string;
+}
+interface GetSessionResponse {
+    isLoggedIn: boolean;
+    user: UserData;
+    permissionLevel: PermissionLevel;
+    routes: Routes;
+}
+declare const PERMISSION_HIERARCHY: Record<PermissionLevel, Set<PermissionLevel>>;
+declare const KNOWN_API_ROUTES: string[];
+declare const DEFAULT_AVATAR = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAADSklEQVR4AdSWS2xMYRTHjQXRRupRKVWrJhrxSCRigTQpYUHq0VYsarwi8RgJ0rCwFJEQEQ1psZFQXWgGRZB6NdFalkSFFRutV1UJNhLj9+dcOubeud8dC2lzfvd/7vedc77TO999DB/2n/+GZgOpVCoOSegx5K/N5WJGugIsNhHusNBZqIJiQ/455tqgiDFni9QAVZthIVyBBTAWJsBKeAOL4Tw4m3MD/GebqVoBV2Ox2ArohAHog1bGZ0MfLCJ2A+pkzg1QrRpkB3X4G5p4xdhOkOknkYYSpYE5Vu2pqZ/ctUFdDXOzS5QGvlkplxyXmJ/lnAOJfgSyMh0C0AbVVJcOLkRp4JQV3GeaJmy8SQzUg6xRBxecG2CTaaffpGgli12DeVAAhaDb8CFzhXCZ2Ouokzk3YNU2ordhGXTCALyDS6AH0C10CzhbpAb4z16DHjZxVtCivWgPJCHO3BJ4i+9skRrwqrJIE1TBZCiBGmjy5qNoTg1EWSAsNlIDbLZi2AEt0A2fDPkX8BOguyFs3d/zTg1QNB+OkPUcjkMNTIfRhvzV+CfgBbGHYBR+qIU2QCG97dqpVAcjoRuOgpqYggr5GnvCuWL2ou3kjkOzWtYGKFBAdgfoPfAR1S02iw1XB0l4achXgzOJ2QaKnYt2WA1cfwtsgETNtZA2FXR/l7LYaUhx7muag5NMloI+XKahzdSKob6mRXwnGEyA7nm949dQ+D3nTmax2hN6SC0lSVcOyTTfBuhYl36/hddS8IP5zmI56y3hADW1Ye30j/g2wLQ21Ri0i0JtaE5G7g0SH8N40PsCSbegBiot7J7pv4hXw6uZViuogRkWpdvP3JzFq6E7JKNIUAP63FbwJn67KsjTSRSUA/o2XGd5Xk07/SVBDei7/zshq0Bvun6KtcIeqIUKKAM9IfNQ+RrTnGL07dBvufrtVesM5xnm2wCbZyuRer9vR+/DCFgOh0FvPX18PsP/DF9AvsY0pxjFKke5up2LqLmLuAzzbUBRJOh7vxEt57wEVKABvQgPQO+Fr6iQrzHNKWY343pNl5PfAHqWMJRpgQ0MDqVAL9RDAqphPujJmI8K+RrTnGKOMa6PlcFlfH2nBnwzHQfDwn4AAAD//6qWhy8AAAAGSURBVAMAJXQ0UKI3Vu0AAAAASUVORK5CYII=";
+declare const COMPONENT_STYLES = "\n:host {\n    --border: hsl(240 5% 17%);\n    --background-base: hsl(0 0% 6%);\n    --background-step-1: hsl(0 0% 8%);\n    --background-step-2: hsl(0 0% 10%);\n    --background-step-3: hsl(0 0% 14%);\n    --primary-base: hsl(259 83% 73%);\n    --success-base: hsl(142 71% 46%);\n    --warning-base: hsl(48 96% 53%);\n    --danger-base: hsl(339 97% 31%);\n    --info-base: hsl(217 92% 52%);\n    --light: 70;\n    --threshold: 50;\n}\n\n[data-theme=\"light\"] {\n    --border: hsl(263 5% 68%);\n    --background-base: hsl(0 0% 97%);\n    --background-step-1: hsl(0 0% 90%);\n    --background-step-2: hsl(0 0% 85%);\n    --background-step-3: hsl(0 0% 80%);\n    --primary-base: hsl(259 85% 61%);\n    --success-base: hsl(142 59% 47%);\n    --warning-base: hsl(48 92% 46%);\n    --danger-base: hsl(339 97% 31%);\n    --info-base: hsl(217 92% 52%);\n}\n\n.menu_overlay {\n    position: fixed;\n    background: rgba(0,0,0,0.4);\n    inset: 0;\n    z-index: 500;\n    display: none;\n}\n\n.menu_overlay.menuOpened {\n    display: block;\n}\n\n.cornerMenu {\n    position: fixed;\n    right: 25px;\n    bottom: 25px;\n    width: 50px;\n    height: 50px;\n    background: var(--background-step-1);\n    box-shadow: 0 3px 7px rgba(0,0,0,0.3);\n    border-radius: 50%;\n    z-index: 600;\n    cursor: pointer;\n    transition: transform 0.3s ease;\n    display: flex;\n    align-items: center;\n    justify-content: center;\n}\n\n.avatar-container {\n    width: 100%;\n    height: 100%;\n    border-radius: 50%;\n    background: var(--background-step-1);\n    border: 1px solid var(--border);\n    object-fit: cover;\n    z-index: 700;\n    transition: transform 0.3s ease;\n    display: flex;\n    align-items: center;\n    justify-content: center;\n}\n\n.avatar {\n    width: 100%;\n    height: 100%;\n    background: var(--background-step-1);\n    border: 1px solid var(--border);\n    border-radius: 50%;\n    object-fit: cover;\n    transition: transform 0.3s ease;\n    display: flex;\n    align-items: center;\n    justify-content: center;\n}\n\n.avatar-error {\n    width: 100%;\n\theight: auto;\n\tmargin: 2.5rem;\n\tborder: none;\n}\n\n.cornerMenu.menuOpened .avatar-container {\n    transform: scale(1.5);\n    border: 1px solid var(--border);\n}\n\n.menu {\n    --switch: calc((var(--light) - var(--threshold)) * -100%);\n    position: absolute;\n    width: 32px;\n    height: 32px;\n    background: var(--background-step-2);\n    box-shadow: 0 3px 7px rgba(0,0,0,0.1);\n    border-radius: 50%;\n    border: 1px solid var(--border);\n    color: hsl(0, 0%, var(--switch));\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    padding: 8px;\n    top: -5px;\n    left: -5px;\n    opacity: 0;\n    z-index: 550;\n    pointer-events: none;\n    user-select: none;\n    transition: all 0.4s ease-in-out;\n    text-decoration: none;\n}\n\n.menu svg {\n    width: 24px;\n    height: 24px;\n}\n\n.cornerMenu.menuOpened .menu {\n    opacity: 1;\n    cursor: pointer;\n    transition: transform 0.3s ease, opacity 0.3s ease, background-color 0.15s ease;\n}\n\n.cornerMenu.menuOpened .menu:hover {\n    background: var(--background-step-3);\n}\n\n/* Click protection: Only enable pointer events when menu is ready */\n.cornerMenu.menu-ready .menu {\n    pointer-events: all;\n    box-shadow: 0 3px 7px rgba(0,0,0,0.1),\n                0 0 0 1px color-mix(in hsl, var(--primary-base) 20%, transparent);\n}\n\n.cornerMenu.menu-ready .menu:hover {\n    box-shadow: 0 3px 7px rgba(0,0,0,0.2),\n                0 0 0 2px color-mix(in hsl, var(--primary-base) 40%, transparent);\n}\n\n/* Visual feedback for ignored clicks */\n.menu.click-ignored {\n    animation: shake 0.3s ease-in-out;\n}\n\n@keyframes shake {\n    0%, 100% { transform: translateX(0) translateY(0); }\n    25% { transform: translateX(-2px) translateY(-1px); }\n    50% { transform: translateX(2px) translateY(1px); }\n    75% { transform: translateX(-1px) translateY(-2px); }\n}\n\n.cornerMenu.menuOpened .menu:nth-child(1) { transform: translate(-105px, 20px); transition-delay: 0s; }\n.cornerMenu.menuOpened .menu:nth-child(2) { transform: translate(-78px, -33px); transition-delay: 0.05s; }\n.cornerMenu.menuOpened .menu:nth-child(3) { transform: translate(-38px, -76px); transition-delay: 0.1s; }\n.cornerMenu.menuOpened .menu:nth-child(4) { transform: translate(18px, -99px); transition-delay: 0.15s; }\n\n.menu.logout { color: var(--danger-base); }\n.menu.profile { color: var(--primary-base); }\n.menu.dashboard { color: var(--success-base); }\n.menu.edit { color: var(--warning-base); }\n";
+/**
+ * Optimized permission verification with Set-based lookup
+ */
+declare function verifyUserPermissionLevel(userLevel: PermissionLevel, requiredLevel: PermissionLevel): boolean;
+/**
+ * Check if current path should skip rendering completely (no API calls)
+ */
+declare function shouldSkipRendering(pathname: string): boolean;
+/**
+ * Check if current path is dashboard (skip after API call)
+ */
+declare function isDashboardRoute(pathname: string, dashboardRoute: string): boolean;
+declare class UserQuickTools extends HTMLElement {
+    private sessionData;
+    private isMenuOpen;
+    private menuItemsReady;
+    private lastMenuToggleTime;
+    private readyTimeout;
+    private themeObserver;
+    private cornerMenu;
+    private menuOverlay;
+    private isInitialized;
+    private userInteractionListeners;
+    protected CLICK_PROTECTION_DURATION: number;
+    protected MENU_READY_DELAY: number;
+    private static readonly MENU_ITEMS;
+    constructor();
+    connectedCallback(): void;
+    initOnUserInteraction(): void;
+    private removeInteractionListeners;
+    scheduleInitialization(): void;
+    private initializeAsync;
+    private scheduleRender;
+    disconnectedCallback(): void;
+    private render;
+    private addMenuItems;
+    private createMenuElement;
+    private testAvatarURL;
+    private addUserAvatar;
+    private setupEventListeners;
+    private handleMenuToggle;
+    private handleOverlayClick;
+    private updateMenuState;
+    private setupThemeObserver;
+    private getSession;
+    private capitalizeFirst;
+    private cleanup;
+}
+interface UserQuickToolsConfig {
+    strategy: 'immediate' | 'idle' | 'interaction';
+    timeout?: number;
+    clickProtectionDuration?: number;
+    menuReadyDelay?: number;
+}
+declare class ConfigurableUserQuickTools extends UserQuickTools {
+    private config;
+    constructor();
+    connectedCallback(): void;
+}
+declare function initializeWhenReady(): void;