@zcomponent/core 1.29.0 → 2.0.0-alpha.2

package/lib/contexts/cookieconsentcontext.d.ts

@@ -1,30 +1,34 @@
-import { ContextManager, Context } from '../context';
+import { Context, ContextManager } from '../context';
 import { Observable } from '../observable';
+import { ValueOf } from '../types';
 /**
- * Enum representing the overall status of the cookie consent process: 'unknown', 'initializing', 'initialized'.
+ * Representing the overall status of the cookie consent process: 'unknown', 'initializing', 'initialized'.
  */
-export declare enum Status {
-    'unknown' = "unknown",
-    'initializing' = "initializing",
-    'initialized' = "initialized"
-}
+export declare const Status: {
+    readonly unknown: "unknown";
+    readonly initializing: "initializing";
+    readonly initialized: "initialized";
+};
+export type StatusValue = ValueOf<typeof Status>;
 /**
- * Enum representing the consent status for different types of cookies: 'unknown', 'granted', 'rejected'.
+ * Representing the consent status for different types of cookies: 'unknown', 'granted', 'rejected'.
  */
-export declare enum ConsentStatus {
-    'unknown' = "unknown",
-    'granted' = "granted",
-    'rejected' = "rejected"
-}
+export declare const ConsentStatus: {
+    readonly unknown: "unknown";
+    readonly granted: "granted";
+    readonly rejected: "rejected";
+};
+export type ConsentStatusValue = ValueOf<typeof ConsentStatus>;
 /**
- * Enum representing different types of cookies: 'essential', 'functional', 'performance', 'marketing'.
+ * Representing different types of cookies: 'essential', 'functional', 'performance', 'marketing'.
  */
-export declare enum CookieType {
-    'essential' = "essential",
-    'functional' = "functional",
-    'performance' = "performance",
-    'marketing' = "marketing"
-}
+export declare const CookieType: {
+    readonly essential: "essential";
+    readonly functional: "functional";
+    readonly performance: "performance";
+    readonly marketing: "marketing";
+};
+export type CookieTypeValue = ValueOf<typeof CookieType>;
 /**
  * Defines the structure of a vendor's information including name, description, and privacy policy URL.
  */
@@ -45,12 +49,18 @@ export interface Vendor {
  * @zcontext
  */
 export declare class CookieConsentContext extends Context {
-    readonly status: Observable<Status, never>;
-    readonly functionalCookies: Observable<ConsentStatus, never>;
-    readonly performanceCookies: Observable<ConsentStatus, never>;
-    readonly marketingCookies: Observable<ConsentStatus, never>;
+    readonly status: Observable<StatusValue, never>;
+    readonly functionalCookies: Observable<ConsentStatusValue, never>;
+    readonly performanceCookies: Observable<ConsentStatusValue, never>;
+    readonly marketingCookies: Observable<ConsentStatusValue, never>;
     readonly showSettings: Observable<(() => void) | undefined, never>;
+    /**
+     * @default []
+     */
     readonly performanceVendors: Vendor[];
+    /**
+     * @default []
+     */
     readonly marketingVendors: Vendor[];
     /**
      * Registers a performance vendor.
@@ -66,25 +76,25 @@ export declare class CookieConsentContext extends Context {
  * @param {ContextManager} mgr The context manager instance.
  * @returns {Observable<ConsentStatus>} The observable representing the consent status of functional cookies.
  */
-export declare function useCookieConsentFunctional(mgr: ContextManager): Observable<ConsentStatus, never>;
+export declare function useCookieConsentFunctional(mgr: ContextManager): Observable<ConsentStatusValue, never>;
 /**
  * Retrieves the consent status for performance cookies.
  * @param {ContextManager} mgr The context manager instance.
  * @returns {Observable<ConsentStatus>} The observable representing the consent status of performance cookies.
  */
-export declare function useCookieConsentPerformance(mgr: ContextManager): Observable<ConsentStatus, never>;
+export declare function useCookieConsentPerformance(mgr: ContextManager): Observable<ConsentStatusValue, never>;
 /**
  * Retrieves the consent status for marketing cookies.
  * @param {ContextManager} mgr The context manager instance.
  * @returns {Observable<ConsentStatus>} The observable representing the consent status of marketing cookies.
  */
-export declare function useCookieConsentMarketing(mgr: ContextManager): Observable<ConsentStatus, never>;
+export declare function useCookieConsentMarketing(mgr: ContextManager): Observable<ConsentStatusValue, never>;
 /**
  * Retrieves the overall cookie consent status.
  * @param {ContextManager} mgr The context manager instance.
  * @returns {Observable<Status>} The observable representing the overall cookie consent status.
  */
-export declare function useCookieConsentStatus(mgr: ContextManager): Observable<Status, never>;
+export declare function useCookieConsentStatus(mgr: ContextManager): Observable<StatusValue, never>;
 /**
  * Registers a performance vendor in the `CookieConsentContext`.
  * @param {ContextManager} mgr The context manager instance.

package/lib/contexts/cookieconsentcontext.js

@@ -1,33 +1,33 @@
 import { Context } from '../context';
 import { Observable } from '../observable';
 /**
- * Enum representing the overall status of the cookie consent process: 'unknown', 'initializing', 'initialized'.
+ * Representing the overall status of the cookie consent process: 'unknown', 'initializing', 'initialized'.
  */
-export var Status;
-(function (Status) {
-    Status["unknown"] = "unknown";
-    Status["initializing"] = "initializing";
-    Status["initialized"] = "initialized";
-})(Status || (Status = {}));
+export const Status = {
+    unknown: 'unknown',
+    initializing: 'initializing',
+    initialized: 'initialized',
+};
+Object.freeze(Status);
 /**
- * Enum representing the consent status for different types of cookies: 'unknown', 'granted', 'rejected'.
+ * Representing the consent status for different types of cookies: 'unknown', 'granted', 'rejected'.
  */
-export var ConsentStatus;
-(function (ConsentStatus) {
-    ConsentStatus["unknown"] = "unknown";
-    ConsentStatus["granted"] = "granted";
-    ConsentStatus["rejected"] = "rejected";
-})(ConsentStatus || (ConsentStatus = {}));
+export const ConsentStatus = {
+    unknown: 'unknown',
+    granted: 'granted',
+    rejected: 'rejected',
+};
+Object.freeze(ConsentStatus);
 /**
- * Enum representing different types of cookies: 'essential', 'functional', 'performance', 'marketing'.
+ * Representing different types of cookies: 'essential', 'functional', 'performance', 'marketing'.
  */
-export var CookieType;
-(function (CookieType) {
-    CookieType["essential"] = "essential";
-    CookieType["functional"] = "functional";
-    CookieType["performance"] = "performance";
-    CookieType["marketing"] = "marketing";
-})(CookieType || (CookieType = {}));
+export const CookieType = {
+    essential: 'essential',
+    functional: 'functional',
+    performance: 'performance',
+    marketing: 'marketing',
+};
+Object.freeze(CookieType);
 /**
  * Manages the state and information related to cookie consent within a context.
  * - `status`: Observable representing the overall status of the cookie consent.
@@ -40,16 +40,19 @@ export var CookieType;
  * @zcontext
  */
 export class CookieConsentContext extends Context {
-    constructor() {
-        super(...arguments);
-        this.status = new Observable(Status.unknown);
-        this.functionalCookies = new Observable(ConsentStatus.unknown);
-        this.performanceCookies = new Observable(ConsentStatus.unknown);
-        this.marketingCookies = new Observable(ConsentStatus.unknown);
-        this.showSettings = new Observable(undefined);
-        this.performanceVendors = [];
-        this.marketingVendors = [];
-    }
+    status = new Observable(Status.unknown);
+    functionalCookies = new Observable(ConsentStatus.unknown);
+    performanceCookies = new Observable(ConsentStatus.unknown);
+    marketingCookies = new Observable(ConsentStatus.unknown);
+    showSettings = new Observable(undefined);
+    /**
+     * @default []
+     */
+    performanceVendors = [];
+    /**
+     * @default []
+     */
+    marketingVendors = [];
     /**
      * Registers a performance vendor.
      */

package/lib/contexts/documentflagmanager.js

@@ -2,20 +2,11 @@
  * Internal context that manages the document flags.
  */
 export class DocumentFlagManager {
+    _environmentContext;
+    _loadContext;
     constructor(_environmentContext, _loadContext) {
         this._environmentContext = _environmentContext;
         this._loadContext = _loadContext;
-        this._update = () => {
-            if (!document?.body)
-                return;
-            document.body.classList.toggle('zcomponent-designtime', this._environmentContext.designTime.value);
-            document.body.classList.toggle('zcomponent-runtime', this._environmentContext.runTime.value);
-            document.body.classList.toggle('zcomponent-development', this._environmentContext.developmentBuild.value);
-            document.body.classList.toggle('zcomponent-production', this._environmentContext.productionBuild.value);
-            document.body.classList.toggle('zcomponent-started', this._loadContext.isStarted.value);
-            document.body.classList.toggle('zcomponent-launched', this._loadContext.isLaunched.value);
-            document.body.classList.toggle('zcomponent-loaded', this._loadContext.isLoaded.value);
-        };
         this._update();
         this._environmentContext.designTime.addListener(this._update);
         this._environmentContext.runTime.addListener(this._update);
@@ -25,6 +16,19 @@ export class DocumentFlagManager {
         this._loadContext.isLaunched.addListener(this._update);
         this._loadContext.isLoaded.addListener(this._update);
     }
+    _update = () => {
+        if (typeof document === 'undefined')
+            return;
+        if (!document?.body)
+            return;
+        document.body.classList.toggle('zcomponent-designtime', this._environmentContext.designTime.value);
+        document.body.classList.toggle('zcomponent-runtime', this._environmentContext.runTime.value);
+        document.body.classList.toggle('zcomponent-development', this._environmentContext.developmentBuild.value);
+        document.body.classList.toggle('zcomponent-production', this._environmentContext.productionBuild.value);
+        document.body.classList.toggle('zcomponent-started', this._loadContext.isStarted.value);
+        document.body.classList.toggle('zcomponent-launched', this._loadContext.isLaunched.value);
+        document.body.classList.toggle('zcomponent-loaded', this._loadContext.isLoaded.value);
+    };
     dispose() {
         this._environmentContext.designTime.removeListener(this._update);
         this._environmentContext.runTime.removeListener(this._update);

package/lib/contexts/environmentcontext.d.ts

@@ -1,30 +1,26 @@
-import { ContextManager, Context } from '../context';
+import { Context, ContextManager } from '../context';
+import type { Entity } from '../entity';
 import { Observable } from '../observable';
 /** @zcontext */
 export declare class EnvironmentContext extends Context {
     /**
      * Observable indicating if the application is in design time.
-     * @zprop
      **/
     readonly designTime: Observable<boolean, never>;
     /**
      * Observable indicating if the application is in edit time.
-     * @zprop
      * */
     readonly editTime: Observable<boolean, never>;
     /**
      * Observable indicating if the application is in run time.
-     * @zprop
      **/
     readonly runTime: Observable<boolean, never>;
     /**
      * Observable indicating if the application is a development build.
-     * @zprop
      **/
     readonly developmentBuild: Observable<boolean, never>;
     /**
      * Observable indicating if the application is a production build.
-     * @zprop
      * */
     readonly productionBuild: Observable<boolean, never>;
     private readonly _documentFlagManager;
@@ -55,3 +51,23 @@ export declare function isDevelopmentBuild(ctx: ContextManager): boolean;
  * @returns {boolean} True if it's a production build, otherwise false.
  */
 export declare function isProductionBuild(ctx: ContextManager): boolean;
+/**
+ * A decorator that will permit its decorated function to be called only durning runtime (and not design or edit time). If execution is prevented, the function will return `undefined` to the caller.
+ */
+export declare function zOnlyRuntime<EntityType extends Entity>(): (originalMethod: (...args: any) => void, context: ClassMethodDecoratorContext<EntityType, (this: EntityType, ...args: any[]) => void>) => void;
+/**
+ * A decorator that will permit its decorated function to be called only durning edit time. If execution is prevented, the function will return `undefined` to the caller.
+ */
+export declare function zOnlyEditTime<EntityType extends Entity>(): (originalMethod: (...args: any) => void, context: ClassMethodDecoratorContext<EntityType, (this: EntityType, ...args: any[]) => void>) => void;
+/**
+ * A decorator that will permit its decorated function to be called only durning design time. If execution is prevented, the function will return `undefined` to the caller.
+ */
+export declare function zOnlyDesignTime<EntityType extends Entity>(): (originalMethod: (...args: any) => void, context: ClassMethodDecoratorContext<EntityType, (this: EntityType, ...args: any[]) => void>) => void;
+/**
+ * A decorator that will permit its decorated function to be called only in production builds. If execution is prevented, the function will return `undefined` to the caller.
+ */
+export declare function zOnlyProduction<EntityType extends Entity>(): (originalMethod: (...args: any) => void, context: ClassMethodDecoratorContext<EntityType, (this: EntityType, ...args: any[]) => void>) => void;
+/**
+ * A decorator that will permit its decorated function to be called only in development builds. If execution is prevented, the function will return `undefined` to the caller.
+ */
+export declare function zOnlyDevelopment<EntityType extends Entity>(): (originalMethod: (...args: any) => void, context: ClassMethodDecoratorContext<EntityType, (this: EntityType, ...args: any[]) => void>) => void;

package/lib/contexts/environmentcontext.js

@@ -1,44 +1,108 @@
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
 import { Context } from '../context';
+import { zUI } from '../decorators';
 import { Observable } from '../observable';
 import { DocumentFlagManager } from './documentflagmanager';
 import { LoadContext } from './loadcontext';
 /** @zcontext */
-export class EnvironmentContext extends Context {
-    constructor(contextManager, props) {
-        super(contextManager, props);
+let EnvironmentContext = (() => {
+    let _classSuper = Context;
+    let _designTime_decorators;
+    let _designTime_initializers = [];
+    let _designTime_extraInitializers = [];
+    let _editTime_decorators;
+    let _editTime_initializers = [];
+    let _editTime_extraInitializers = [];
+    let _runTime_decorators;
+    let _runTime_initializers = [];
+    let _runTime_extraInitializers = [];
+    let _developmentBuild_decorators;
+    let _developmentBuild_initializers = [];
+    let _developmentBuild_extraInitializers = [];
+    let _productionBuild_decorators;
+    let _productionBuild_initializers = [];
+    let _productionBuild_extraInitializers = [];
+    return class EnvironmentContext extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _designTime_decorators = [zUI()];
+            _editTime_decorators = [zUI()];
+            _runTime_decorators = [zUI()];
+            _developmentBuild_decorators = [zUI()];
+            _productionBuild_decorators = [zUI()];
+            __esDecorate(null, null, _designTime_decorators, { kind: "field", name: "designTime", static: false, private: false, access: { has: obj => "designTime" in obj, get: obj => obj.designTime, set: (obj, value) => { obj.designTime = value; } }, metadata: _metadata }, _designTime_initializers, _designTime_extraInitializers);
+            __esDecorate(null, null, _editTime_decorators, { kind: "field", name: "editTime", static: false, private: false, access: { has: obj => "editTime" in obj, get: obj => obj.editTime, set: (obj, value) => { obj.editTime = value; } }, metadata: _metadata }, _editTime_initializers, _editTime_extraInitializers);
+            __esDecorate(null, null, _runTime_decorators, { kind: "field", name: "runTime", static: false, private: false, access: { has: obj => "runTime" in obj, get: obj => obj.runTime, set: (obj, value) => { obj.runTime = value; } }, metadata: _metadata }, _runTime_initializers, _runTime_extraInitializers);
+            __esDecorate(null, null, _developmentBuild_decorators, { kind: "field", name: "developmentBuild", static: false, private: false, access: { has: obj => "developmentBuild" in obj, get: obj => obj.developmentBuild, set: (obj, value) => { obj.developmentBuild = value; } }, metadata: _metadata }, _developmentBuild_initializers, _developmentBuild_extraInitializers);
+            __esDecorate(null, null, _productionBuild_decorators, { kind: "field", name: "productionBuild", static: false, private: false, access: { has: obj => "productionBuild" in obj, get: obj => obj.productionBuild, set: (obj, value) => { obj.productionBuild = value; } }, metadata: _metadata }, _productionBuild_initializers, _productionBuild_extraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
         /**
          * Observable indicating if the application is in design time.
-         * @zprop
          **/
-        this.designTime = new Observable(false);
+        designTime = __runInitializers(this, _designTime_initializers, new Observable(false));
         /**
          * Observable indicating if the application is in edit time.
-         * @zprop
          * */
-        this.editTime = new Observable(false);
+        editTime = (__runInitializers(this, _designTime_extraInitializers), __runInitializers(this, _editTime_initializers, new Observable(false)));
         /**
          * Observable indicating if the application is in run time.
-         * @zprop
          **/
-        this.runTime = new Observable(true);
+        runTime = (__runInitializers(this, _editTime_extraInitializers), __runInitializers(this, _runTime_initializers, new Observable(true)));
         /**
          * Observable indicating if the application is a development build.
-         * @zprop
          **/
-        this.developmentBuild = new Observable(typeof process !== 'undefined' && process?.env?.NODE_ENV === 'development');
+        developmentBuild = (__runInitializers(this, _runTime_extraInitializers), __runInitializers(this, _developmentBuild_initializers, new Observable(typeof process !== 'undefined' && process?.env?.NODE_ENV === 'development')));
         /**
          * Observable indicating if the application is a production build.
-         * @zprop
          * */
-        this.productionBuild = new Observable(!this.developmentBuild.value);
-        const loadContext = this.contextManager.get(LoadContext);
-        this._documentFlagManager = new DocumentFlagManager(this, loadContext);
-    }
-    dispose() {
-        this._documentFlagManager.dispose();
-        return super.dispose();
-    }
-}
+        productionBuild = (__runInitializers(this, _developmentBuild_extraInitializers), __runInitializers(this, _productionBuild_initializers, new Observable(!this.developmentBuild.value)));
+        _documentFlagManager = __runInitializers(this, _productionBuild_extraInitializers);
+        constructor(contextManager, props) {
+            super(contextManager, props);
+            const loadContext = this.contextManager.get(LoadContext);
+            this._documentFlagManager = new DocumentFlagManager(this, loadContext);
+        }
+        dispose() {
+            this._documentFlagManager.dispose();
+            return super.dispose();
+        }
+    };
+})();
+export { EnvironmentContext };
 /**
  * Determines if the application is in design time.
  * @param ctx The context manager to query.
@@ -71,3 +135,53 @@ export function isDevelopmentBuild(ctx) {
 export function isProductionBuild(ctx) {
     return ctx.get(EnvironmentContext).productionBuild.value;
 }
+/**
+ * A decorator that will permit its decorated function to be called only durning runtime (and not design or edit time). If execution is prevented, the function will return `undefined` to the caller.
+ */
+export function zOnlyRuntime() {
+    return (originalMethod, context) => function (...args) {
+        if (isDesignTime(this.contextManager) || isEditTime(this.contextManager))
+            return;
+        originalMethod.call(this, ...args);
+    };
+}
+/**
+ * A decorator that will permit its decorated function to be called only durning edit time. If execution is prevented, the function will return `undefined` to the caller.
+ */
+export function zOnlyEditTime() {
+    return (originalMethod, context) => function (...args) {
+        if (!isEditTime(this.contextManager))
+            return;
+        originalMethod.call(this, ...args);
+    };
+}
+/**
+ * A decorator that will permit its decorated function to be called only durning design time. If execution is prevented, the function will return `undefined` to the caller.
+ */
+export function zOnlyDesignTime() {
+    return (originalMethod, context) => function (...args) {
+        if (!isDesignTime(this.contextManager))
+            return;
+        originalMethod.call(this, ...args);
+    };
+}
+/**
+ * A decorator that will permit its decorated function to be called only in production builds. If execution is prevented, the function will return `undefined` to the caller.
+ */
+export function zOnlyProduction() {
+    return (originalMethod, context) => function (...args) {
+        if (!isProductionBuild(this.contextManager))
+            return;
+        originalMethod.call(this, ...args);
+    };
+}
+/**
+ * A decorator that will permit its decorated function to be called only in development builds. If execution is prevented, the function will return `undefined` to the caller.
+ */
+export function zOnlyDevelopment() {
+    return (originalMethod, context) => function (...args) {
+        if (!isDevelopmentBuild(this.contextManager))
+            return;
+        originalMethod.call(this, ...args);
+    };
+}

package/lib/contexts/gamepadcontext.d.ts

@@ -1,36 +1,39 @@
 import { Context, ContextManager } from '../context';
 import { Event } from '../event';
+import { ValueOf } from '../types';
 /**
  * Represents the axes of a gamepad.
  */
-export declare enum GamepadAxis {
-    LeftStickHorizontal = "LeftStickHorizontal",
-    LeftStickVertical = "LeftStickVertical",
-    RightStickHorizontal = "RightStickHorizontal",
-    RightStickVertical = "RightStickVertical"
-}
+export declare const GamepadAxis: {
+    readonly LeftStickHorizontal: "LeftStickHorizontal";
+    readonly LeftStickVertical: "LeftStickVertical";
+    readonly RightStickHorizontal: "RightStickHorizontal";
+    readonly RightStickVertical: "RightStickVertical";
+};
+export type GamepadAxisValue = ValueOf<typeof GamepadAxis>;
 /**
  * Represents the buttons on a gamepad.
  */
-export declare enum GamepadButton {
-    South = "South",
-    East = "East",
-    West = "West",
-    North = "North",
-    ShoulderLeft = "ShoulderLeft",
-    ShoulderRight = "ShoulderRight",
-    TriggerLeft = "TriggerLeft",
-    TriggerRight = "TriggerRight",
-    Select = "Select",
-    Start = "Start",
-    StickLeft = "StickLeft",
-    StickRight = "StickRight",
-    DUp = "DUp",
-    DDown = "DDown",
-    DLeft = "DLeft",
-    DRight = "DRight",
-    Center = "Center"
-}
+export declare const GamepadButton: {
+    readonly South: "South";
+    readonly East: "East";
+    readonly West: "West";
+    readonly North: "North";
+    readonly ShoulderLeft: "ShoulderLeft";
+    readonly ShoulderRight: "ShoulderRight";
+    readonly TriggerLeft: "TriggerLeft";
+    readonly TriggerRight: "TriggerRight";
+    readonly Select: "Select";
+    readonly Start: "Start";
+    readonly StickLeft: "StickLeft";
+    readonly StickRight: "StickRight";
+    readonly DUp: "DUp";
+    readonly DDown: "DDown";
+    readonly DLeft: "DLeft";
+    readonly DRight: "DRight";
+    readonly Center: "Center";
+};
+export type GamepadButtonValue = ValueOf<typeof GamepadButton>;
 /**
  * Manages and tracks gamepad connections and states.
  * @zcontext
@@ -75,4 +78,4 @@ export declare class GamepadContext extends Context {
  * @param axis The gamepad axis to translate.
  * @returns The numeric representation of the gamepad axis.
  */
-export declare function translateGamepadAxis(axis: GamepadAxis): number;
+export declare function translateGamepadAxis(axis: GamepadAxisValue): number;