@decaf-ts/ui-decorators 0.6.7 → 0.6.8

package/lib/ui/DecafComponent.cjs

@@ -1,8 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DecafComponent = void 0;
+exports.DecafComponent = exports.isClassConstructor = void 0;
 const logging_1 = require("@decaf-ts/logging");
 const db_decorators_1 = require("@decaf-ts/db-decorators");
+const isClassConstructor = (value) => {
+    return typeof value === "function" && /^class\s/.test(String(value));
+};
+exports.isClassConstructor = isClassConstructor;
 /**
  * Base class for all Decaf UI components, providing common state management,
  * logging, localization, navigation hooks, CRUD context metadata, and
@@ -92,6 +96,7 @@ class DecafComponent extends logging_1.LoggedClass {
          * @default false
          */
         this.initialized = false;
+        this.events = {};
         this.handlers = {};
     }
     get repository() {
@@ -153,6 +158,61 @@ class DecafComponent extends logging_1.LoggedClass {
             .for(this.submit)
             .info(`submit for ${this.componentName} with ${JSON.stringify(args)}`);
     }
+    /**
+     * @description Normalizes handler definitions into executable functions.
+     * @summary Iterates through a handlers map and ensures each entry is stored as a callable
+     * function on the component. Plain functions are stored directly, while handler classes are
+     * instantiated so their `handle` method (or a keyed override) becomes the registered handler.
+     * This allows decorators to accept either inline functions or handler classes transparently.
+     * @template T Extends `DecafEventHandler` to constrain handler class types.
+     * @param handlers - Dictionary of handler names mapped to functions or handler constructors.
+     * @param instance - Optional target handler instance; defaults to the current component.
+     */
+    parseHandlers(handlers, instance) {
+        const result = {};
+        Object.entries(handlers).forEach(([key, fn]) => {
+            if ((0, exports.isClassConstructor)(fn)) {
+                const clazz = new fn();
+                const event = key in clazz ? clazz[key] : clazz.handle;
+                result[key] = event;
+                instance.handlers[key] = event;
+            }
+            else {
+                result[key] = fn;
+                instance.handlers[key] = fn;
+            }
+        });
+        return result;
+    }
+    /**
+     * @description Registers event callbacks on the component instance.
+     * @summary Processes an events map produced by decorators where each value can be a factory
+     * returning a function or a component constructor. When a constructor is returned, the method
+     * matching the event key is instantiated and stored; otherwise the produced function is
+     * assigned directly. This enables flexible event binding definitions for derived components.
+     * @template T Extends `DecafComponent<Model>` to scope acceptable event owners.
+     * @param events - Dictionary of event names mapped to function factories or component constructors.
+     * @param instance - Optional component instance to receive the events; defaults to `this`.
+     */
+    parseEvents(events, instance) {
+        const result = {};
+        Object.entries(events).forEach(([key, fn]) => {
+            const name = key;
+            const evt = fn();
+            if ((0, exports.isClassConstructor)(evt)) {
+                const fn = new evt()[key];
+                if (fn) {
+                    result[name] = fn;
+                    instance.events[name] = fn;
+                }
+            }
+            else {
+                result[name] = fn;
+                instance.events[name] = fn;
+            }
+        });
+        return result;
+    }
 }
 exports.DecafComponent = DecafComponent;
 //# sourceMappingURL=DecafComponent.js.map

package/lib/ui/DecafComponent.d.ts

@@ -1,8 +1,11 @@
 import { LoggedClass } from "@decaf-ts/logging";
-import { UIFunctionLike } from "./types";
+import { CrudOperationKeys, UIEventProperty, UIFunctionLike } from "./types";
 import { Model } from "@decaf-ts/decorator-validation";
 import { IRepository, OperationKeys } from "@decaf-ts/db-decorators";
+import { Constructor } from "@decaf-ts/decoration";
+import { DecafEventHandler } from "./DecafEventHandler";
 type PrimaryKeyType = string | number | bigint;
+export declare const isClassConstructor: <C>(value: UIFunctionLike | Constructor<C>) => value is Constructor<C>;
 /**
  * Base class for all Decaf UI components, providing common state management,
  * logging, localization, navigation hooks, CRUD context metadata, and
@@ -27,6 +30,20 @@ export declare abstract class DecafComponent<M extends Model> extends LoggedClas
      * @type {PrimaryKeyType | PrimaryKeyType[]}
      */
     modelId?: PrimaryKeyType | PrimaryKeyType[];
+    /**
+     * @description Pre-built filtering expression applied to repository queries.
+     * @summary Supply a custom `AttributeOption` to control how records are constrained. When omitted,
+     * the directive derives a condition from `filterBy` or `pk`, comparing it against `modelId`.
+     * @type {any}
+     */
+    filter: any;
+    /**
+     * @description Model field used when generating the default condition.
+     * @summary Indicates which key should be compared to `modelId` when `filter` is not provided.
+     * Defaults to the configured primary key so overrides are only needed for custom lookups.
+     * @type {string}
+     */
+    filterBy: string;
     /**
      * @description The CRUD operation type to be performed on the model.
      * @summary Specifies which operation (Create, Read, Update, Delete) this component instance
@@ -77,10 +94,37 @@ export declare abstract class DecafComponent<M extends Model> extends LoggedClas
      * @summary Specifies which field in the model should be used as the primary key.
      * This is typically used for identifying unique records in operations like update and delete.
      * If not explicitly set, it defaults to the repository's configured primary key or 'id'.
-     * @type {keyof M | string}
-     * @default 'id'
+     * @type {string}
+  1   */
+    pk: string;
+    /**
+     * @description Angular change detection service for manual change detection control.
+     * @summary Injected service that provides manual control over change detection cycles.
+     * This is essential for ensuring that programmatic DOM changes (like setting accordion
+     * attributes) are properly reflected in the component's state and trigger appropriate
+     * view updates when modifications occur outside the normal Angular change detection flow.
+     * @protected
      */
-    pk: keyof M | string;
+    protected changeDetectorRef?: any;
+    /**
+     * @description Controls field visibility based on CRUD operations.
+     * @summary Can be a boolean or an array of operation keys where the field should be hidden.
+     * @type {boolean | CrudOperationKeys[]}
+     */
+    hidden?: boolean | CrudOperationKeys[];
+    /**
+     * @description Label for the file upload field.
+     * @summary Provides a user-friendly label for the file upload input.
+     *
+     * @type {string | undefined}
+     */
+    label?: string;
+    /**
+     * @description Whether the field is read-only.
+     * @type {boolean}
+     * @public
+     */
+    readonly?: boolean;
     /**
      * @description Flag to enable or disable dark mode support for the component.
      * @summary When enabled, the component will automatically detect the system's dark mode
@@ -216,8 +260,8 @@ export declare abstract class DecafComponent<M extends Model> extends LoggedClas
      * @default false
      */
     protected initialized: boolean;
-    protected events?: Record<keyof Pick<DecafComponent<M>, "render" | "initialize">, UIFunctionLike>;
-    protected handlers: Record<string, UIFunctionLike>;
+    protected events: UIEventProperty;
+    protected handlers: UIEventProperty;
     constructor();
     get repository(): IRepository<M>;
     set repository(repository: IRepository<M>);
@@ -238,7 +282,7 @@ export declare abstract class DecafComponent<M extends Model> extends LoggedClas
      * @param args - A variable number of arguments used for translation.
      * @returns A promise that resolves with the translation result.
      */
-    protected translate(...args: unknown[]): Promise<any>;
+    translate(...args: unknown[]): Promise<any>;
     preview(...args: unknown[]): Promise<void>;
     /**
      * Submits data or performs an action associated with the component.
@@ -247,5 +291,27 @@ export declare abstract class DecafComponent<M extends Model> extends LoggedClas
      * @returns A promise that resolves with the result of the submit operation.
      */
     submit(...args: unknown[]): Promise<any>;
+    /**
+     * @description Normalizes handler definitions into executable functions.
+     * @summary Iterates through a handlers map and ensures each entry is stored as a callable
+     * function on the component. Plain functions are stored directly, while handler classes are
+     * instantiated so their `handle` method (or a keyed override) becomes the registered handler.
+     * This allows decorators to accept either inline functions or handler classes transparently.
+     * @template T Extends `DecafEventHandler` to constrain handler class types.
+     * @param handlers - Dictionary of handler names mapped to functions or handler constructors.
+     * @param instance - Optional target handler instance; defaults to the current component.
+     */
+    protected parseHandlers<T extends DecafEventHandler>(handlers: UIEventProperty, instance: T): UIEventProperty;
+    /**
+     * @description Registers event callbacks on the component instance.
+     * @summary Processes an events map produced by decorators where each value can be a factory
+     * returning a function or a component constructor. When a constructor is returned, the method
+     * matching the event key is instantiated and stored; otherwise the produced function is
+     * assigned directly. This enables flexible event binding definitions for derived components.
+     * @template T Extends `DecafComponent<Model>` to scope acceptable event owners.
+     * @param events - Dictionary of event names mapped to function factories or component constructors.
+     * @param instance - Optional component instance to receive the events; defaults to `this`.
+     */
+    protected parseEvents<T extends DecafComponent<Model>>(events: UIEventProperty, instance: T): UIEventProperty;
 }
 export {};

package/lib/ui/DecafComponent.js.map

@@ -1 +1 @@
-{"version":3,"file":"DecafComponent.js","sourceRoot":"","sources":["../../src/ui/DecafComponent.ts"],"names":[],"mappings":";;;AAAA,+CAAgD;AAGhD,2DAAqE;AAIrE;;;;GAIG;AACH,MAAsB,cAAgC,SAAQ,qBAAW;IA6OvE;QACE,KAAK,EAAE,CAAC;QA7JV;;;;;;;;;WASG;QACO,mBAAc,GAAY,IAAI,CAAC;QAEzC;;;;;;;;;WASG;QACO,eAAU,GAAY,KAAK,CAAC;QAYtC;;;;;;;;;WASG;QACH,SAAI,GAA4B,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;QAE5C;;;;;;;;;WASG;QACH,UAAK,GAA4B,EAAE,CAAC;QAEpC;;;;;;;WAOG;QACH,UAAK,GAAY,EAAE,CAAC;QAEpB;;;;;;;WAOG;QACH,YAAO,GAAY,KAAK,CAAC;QA6BzB;;;;;;;;WAQG;QACgB,kBAAa,GAAG,6BAAa,CAAC;QAyBjD;;;;;;;WAOG;QACO,gBAAW,GAAY,KAAK,CAAC;QAO7B,aAAQ,GAAmC,EAAE,CAAC;IAIxD,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAA6B,CAAC;IAC5C,CAAC;IAED,IAAI,UAAU,CAAC,UAA0B;QACvC,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAG,IAAe;QAC7B,IAAI,CAAC,GAAG;aACL,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;aAChB,IAAI,CAAC,cAAc,IAAI,CAAC,aAAa,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAG,IAAe;QAC9B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;;;;;OAMG;IACH,6DAA6D;IAC7D,KAAK,CAAC,UAAU,CAAC,GAAG,IAAe;QACjC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED;;;;;;OAMG;IACO,KAAK,CAAC,SAAS,CAAC,GAAG,IAAe;QAC1C,IAAI,CAAC,GAAG;aACL,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;aACnB,IAAI,CAAC,iBAAiB,IAAI,CAAC,aAAa,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAG,IAAe;QAC9B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,oDAAoD;IACpD,2EAA2E;IAC3E,IAAI;IAEJ,2DAA2D;IAC3D,aAAa;IACb,gCAAgC;IAChC,0DAA0D;IAC1D,IAAI;IAEJ;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CAAC,GAAG,IAAe;QAC7B,IAAI,CAAC,GAAG;aACL,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;aAChB,IAAI,CAAC,cAAc,IAAI,CAAC,aAAa,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;CACF;AArTD,wCAqTC"}
+{"version":3,"file":"DecafComponent.js","sourceRoot":"","sources":["../../src/ui/DecafComponent.ts"],"names":[],"mappings":"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"}

package/lib/ui/DecafEventHandler.cjs

@@ -32,6 +32,30 @@ class DecafEventHandler extends DecafComponent_1.DecafComponent {
             .for(this.handle)
             .info(`component ${this.componentName} handling ${JSON.stringify(args)}`);
     }
+    /**
+     * Handles an click event with the provided arguments.
+     * Logs the event handling process, including the component name and the arguments passed.
+     *
+     * @param args - The arguments for the event handler.
+     * @returns void
+     */
+    handleClick(...args) {
+        this.log
+            .for(this.handleClick)
+            .info(`component ${this.componentName} handling click ${JSON.stringify(args)}`);
+    }
+    /**
+     * Handles an click event with the provided arguments.
+     * Logs the event handling process, including the component name and the arguments passed.
+     *
+     * @param args - The arguments for the event handler.
+     * @returns void
+     */
+    handleAction(...args) {
+        this.log
+            .for(this.handleAction)
+            .info(`component ${this.componentName} handling action ${JSON.stringify(args)}`);
+    }
 }
 exports.DecafEventHandler = DecafEventHandler;
 //# sourceMappingURL=DecafEventHandler.js.map

package/lib/ui/DecafEventHandler.d.ts

@@ -24,4 +24,20 @@ export declare class DecafEventHandler extends DecafComponent<Model> {
      * @returns void
      */
     handle(...args: unknown[]): void;
+    /**
+     * Handles an click event with the provided arguments.
+     * Logs the event handling process, including the component name and the arguments passed.
+     *
+     * @param args - The arguments for the event handler.
+     * @returns void
+     */
+    handleClick(...args: unknown[]): void;
+    /**
+     * Handles an click event with the provided arguments.
+     * Logs the event handling process, including the component name and the arguments passed.
+     *
+     * @param args - The arguments for the event handler.
+     * @returns void
+     */
+    handleAction(...args: unknown[]): void;
 }

package/lib/ui/DecafEventHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"DecafEventHandler.js","sourceRoot":"","sources":["../../src/ui/DecafEventHandler.ts"],"names":[],"mappings":";;;AACA,yDAAkD;AAElD;;;;;;;GAOG;AACH,MAAa,iBAAkB,SAAQ,+BAAqB;IAC1D;;;;;OAKG;IACH;QACE,KAAK,EAAE,CAAC;IACV,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,IAAe;QACvB,IAAI,CAAC,GAAG;aACL,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;aAChB,IAAI,CAAC,aAAa,IAAI,CAAC,aAAa,aAAa,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9E,CAAC;CACF;AAvBD,8CAuBC"}
+{"version":3,"file":"DecafEventHandler.js","sourceRoot":"","sources":["../../src/ui/DecafEventHandler.ts"],"names":[],"mappings":";;;AACA,yDAAkD;AAElD;;;;;;;GAOG;AACH,MAAa,iBAAkB,SAAQ,+BAAqB;IAC1D;;;;;OAKG;IACH;QACE,KAAK,EAAE,CAAC;IACV,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,IAAe;QACvB,IAAI,CAAC,GAAG;aACL,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;aAChB,IAAI,CAAC,aAAa,IAAI,CAAC,aAAa,aAAa,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,GAAG,IAAe;QAC5B,IAAI,CAAC,GAAG;aACL,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC;aACrB,IAAI,CACH,aAAa,IAAI,CAAC,aAAa,mBAAmB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CACzE,CAAC;IACN,CAAC;IAED;;;;;;OAMG;IACH,YAAY,CAAC,GAAG,IAAe;QAC7B,IAAI,CAAC,GAAG;aACL,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC;aACtB,IAAI,CACH,aAAa,IAAI,CAAC,aAAa,oBAAoB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAC1E,CAAC;IACN,CAAC;CACF;AArDD,8CAqDC"}

package/lib/ui/constants.cjs

@@ -8,8 +8,9 @@
  * @memberOf module:ui-decorators
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HTML5CheckTypes = exports.HTML5InputTypes = exports.HTML5DateFormat = exports.ValidatableByAttribute = exports.ValidatableByType = exports.UIKeys = exports.UIMediaBreakPoints = void 0;
+exports.WindowColorSchemes = exports.ActionRoles = exports.LayoutGridGaps = exports.ElementPositions = exports.ElementSizes = exports.TransactionHooks = exports.ComponentEventNames = exports.HTML5CheckTypes = exports.HTML5InputTypes = exports.HTML5DateFormat = exports.ValidatableByAttribute = exports.ValidatableByType = exports.UIKeys = exports.UIMediaBreakPoints = void 0;
 const decorator_validation_1 = require("@decaf-ts/decorator-validation");
+const db_decorators_1 = require("@decaf-ts/db-decorators");
 var UIMediaBreakPoints;
 (function (UIMediaBreakPoints) {
     UIMediaBreakPoints["SMALL"] = "small";
@@ -255,4 +256,120 @@ exports.HTML5CheckTypes = [
     exports.HTML5InputTypes.CHECKBOX,
     exports.HTML5InputTypes.RADIO,
 ];
+/**
+ * @description Event name constants.
+ * @summary Contains constants for standardized event names used throughout the application.
+ * These constants ensure consistent event naming across components and make it easier to
+ * track and handle events. Each constant represents a specific application event type.
+ * @typedef {Object} ComponentEventNames
+ * @property {string} BackButtonClickEvent - Event fired when back button navigation ends
+ * @property {string} Render - Event after component initialize action occurs
+ * @property {string} Refresh - Event fired when a refresh action occurs
+ * @property {string} Click - Event fired when a click action occurs
+ * @property {string} Change - Event fired when a change action occurs
+ * @property {string} Submit - Event fired when a form submission occurs
+ * @property {string} ValidationError - Event fired when a validation error occurs
+ * @property {string} ThemeChange - Event fired when a theme change occurs
+ * @property {string} FormGroupLoaded - Event fired when a reactve form group is loaded
+ * @const ComponentEventNames
+ */
+exports.ComponentEventNames = {
+    Render: "render",
+    BackButtonClickEvent: "backButtonNavigationEndEvent",
+    Refresh: "RefreshEvent",
+    Click: "ClickEvent",
+    Change: "ChangeEvent",
+    Submit: "SubmitEvent",
+    ValidationError: "validationErrorEvent",
+    ThemeChange: "themeChangeEvent",
+    FormGroupLoaded: "formGroupLoadedEvent",
+};
+/**
+ * @description Lifecycle hook labels for repository transactions.
+ * @summary Provides canonical names for CRUD lifecycle callbacks so decorators and
+ * components can register work before or after repository operations in a consistent way.
+ * Each key maps to the string used when wiring transaction middleware.
+ * @const TransactionHooks
+ */
+exports.TransactionHooks = {
+    BeforeCreate: "beforeCreate",
+    AfterCreate: "afterCreate",
+    BeforeUpdate: "beforeUpdate",
+    AfterUpdate: "afterUpdate",
+    BeforeDelete: "beforeDelete",
+    AfterDelete: "afterDelete",
+};
+/**
+ * @description Standardized size tokens for UI elements.
+ * @summary Defines the semantic size keywords supported by layout and form decorators.
+ * These values feed rendering engines so components can express sizing in a uniform vocabulary.
+ * @const ElementSizes
+ */
+exports.ElementSizes = {
+    xsmall: "xsmall",
+    small: "small",
+    medium: "medium",
+    default: "default",
+    large: "large",
+    xLarge: "xlarge",
+    "2xLarge": "2xlarge",
+    auto: "auto",
+    expand: "expand",
+    block: "block",
+};
+/**
+ * @description Alignment keywords for element positioning.
+ * @summary Supplies canonical position values (horizontal and vertical) that decorators can
+ * use when aligning labels, controls, or helper text across components.
+ * @const ElementPositions
+ */
+exports.ElementPositions = {
+    left: "left",
+    center: "center",
+    right: "right",
+    top: "top",
+    bottom: "bottom",
+};
+/**
+ * @description Grid spacing presets for layout decorators.
+ * @summary Maps human-readable gap sizes to the tokens interpreted by the rendering engine
+ * when building CSS grid layouts, enabling predictable spacing across components.
+ * @const LayoutGridGaps
+ */
+exports.LayoutGridGaps = {
+    small: "small",
+    medium: "medium",
+    large: "large",
+    collapse: "collapse",
+    none: "",
+};
+/**
+ * @description Canonical action role identifiers for UI controls.
+ * @summary Enumerates the semantic roles a button or action may represent so decorators and
+ * renderers can attach consistent behaviors and styling (including CRUD verbs tied to
+ * `OperationKeys`).
+ * @const ActionRoles
+ */
+exports.ActionRoles = {
+    cancel: "cancel",
+    confirm: "confirm",
+    submit: "submit",
+    clear: "clear",
+    back: "back",
+    [db_decorators_1.OperationKeys.CREATE]: db_decorators_1.OperationKeys.CREATE,
+    [db_decorators_1.OperationKeys.READ]: db_decorators_1.OperationKeys.READ,
+    [db_decorators_1.OperationKeys.UPDATE]: db_decorators_1.OperationKeys.UPDATE,
+    [db_decorators_1.OperationKeys.DELETE]: db_decorators_1.OperationKeys.DELETE,
+};
+/**
+ * @description Allowed color scheme tokens for windowed surfaces.
+ * @summary Provides the supported theme identifiers exposed to consuming apps so they
+ * can target light, dark, or unset window color schemes in a predictable way.
+ * @const WindowColorSchemes
+ */
+exports.WindowColorSchemes = {
+    light: "light",
+    dark: "dark",
+    undefined: "undefined",
+};
 //# sourceMappingURL=constants.js.map

package/lib/ui/constants.d.ts

@@ -8,6 +8,7 @@
  */
 import { Validator } from "@decaf-ts/decorator-validation";
 import { Constructor } from "@decaf-ts/decoration";
+import { OperationKeys } from "@decaf-ts/db-decorators";
 export declare enum UIMediaBreakPoints {
     SMALL = "small",
     MEDIUM = "medium",
@@ -230,3 +231,119 @@ export declare const HTML5InputTypes: {
  * @memberOf module:ui-decorators
  */
 export declare const HTML5CheckTypes: string[];
+/**
+ * @description Event name constants.
+ * @summary Contains constants for standardized event names used throughout the application.
+ * These constants ensure consistent event naming across components and make it easier to
+ * track and handle events. Each constant represents a specific application event type.
+ * @typedef {Object} ComponentEventNames
+ * @property {string} BackButtonClickEvent - Event fired when back button navigation ends
+ * @property {string} Render - Event after component initialize action occurs
+ * @property {string} Refresh - Event fired when a refresh action occurs
+ * @property {string} Click - Event fired when a click action occurs
+ * @property {string} Change - Event fired when a change action occurs
+ * @property {string} Submit - Event fired when a form submission occurs
+ * @property {string} ValidationError - Event fired when a validation error occurs
+ * @property {string} ThemeChange - Event fired when a theme change occurs
+ * @property {string} FormGroupLoaded - Event fired when a reactve form group is loaded
+ * @const ComponentEventNames
+ */
+export declare const ComponentEventNames: {
+    readonly Render: "render";
+    readonly BackButtonClickEvent: "backButtonNavigationEndEvent";
+    readonly Refresh: "RefreshEvent";
+    readonly Click: "ClickEvent";
+    readonly Change: "ChangeEvent";
+    readonly Submit: "SubmitEvent";
+    readonly ValidationError: "validationErrorEvent";
+    readonly ThemeChange: "themeChangeEvent";
+    readonly FormGroupLoaded: "formGroupLoadedEvent";
+};
+/**
+ * @description Lifecycle hook labels for repository transactions.
+ * @summary Provides canonical names for CRUD lifecycle callbacks so decorators and
+ * components can register work before or after repository operations in a consistent way.
+ * Each key maps to the string used when wiring transaction middleware.
+ * @const TransactionHooks
+ */
+export declare const TransactionHooks: {
+    readonly BeforeCreate: "beforeCreate";
+    readonly AfterCreate: "afterCreate";
+    readonly BeforeUpdate: "beforeUpdate";
+    readonly AfterUpdate: "afterUpdate";
+    readonly BeforeDelete: "beforeDelete";
+    readonly AfterDelete: "afterDelete";
+};
+/**
+ * @description Standardized size tokens for UI elements.
+ * @summary Defines the semantic size keywords supported by layout and form decorators.
+ * These values feed rendering engines so components can express sizing in a uniform vocabulary.
+ * @const ElementSizes
+ */
+export declare const ElementSizes: {
+    readonly xsmall: "xsmall";
+    readonly small: "small";
+    readonly medium: "medium";
+    readonly default: "default";
+    readonly large: "large";
+    readonly xLarge: "xlarge";
+    readonly "2xLarge": "2xlarge";
+    readonly auto: "auto";
+    readonly expand: "expand";
+    readonly block: "block";
+};
+/**
+ * @description Alignment keywords for element positioning.
+ * @summary Supplies canonical position values (horizontal and vertical) that decorators can
+ * use when aligning labels, controls, or helper text across components.
+ * @const ElementPositions
+ */
+export declare const ElementPositions: {
+    readonly left: "left";
+    readonly center: "center";
+    readonly right: "right";
+    readonly top: "top";
+    readonly bottom: "bottom";
+};
+/**
+ * @description Grid spacing presets for layout decorators.
+ * @summary Maps human-readable gap sizes to the tokens interpreted by the rendering engine
+ * when building CSS grid layouts, enabling predictable spacing across components.
+ * @const LayoutGridGaps
+ */
+export declare const LayoutGridGaps: {
+    readonly small: "small";
+    readonly medium: "medium";
+    readonly large: "large";
+    readonly collapse: "collapse";
+    readonly none: "";
+};
+/**
+ * @description Canonical action role identifiers for UI controls.
+ * @summary Enumerates the semantic roles a button or action may represent so decorators and
+ * renderers can attach consistent behaviors and styling (including CRUD verbs tied to
+ * `OperationKeys`).
+ * @const ActionRoles
+ */
+export declare const ActionRoles: {
+    readonly cancel: "cancel";
+    readonly confirm: "confirm";
+    readonly submit: "submit";
+    readonly clear: "clear";
+    readonly back: "back";
+    readonly create: OperationKeys.CREATE;
+    readonly read: OperationKeys.READ;
+    readonly update: OperationKeys.UPDATE;
+    readonly delete: OperationKeys.DELETE;
+};
+/**
+ * @description Allowed color scheme tokens for windowed surfaces.
+ * @summary Provides the supported theme identifiers exposed to consuming apps so they
+ * can target light, dark, or unset window color schemes in a predictable way.
+ * @const WindowColorSchemes
+ */
+export declare const WindowColorSchemes: {
+    readonly light: "light";
+    readonly dark: "dark";
+    readonly undefined: "undefined";
+};

package/lib/ui/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/ui/constants.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/ui/constants.ts"],"names":[],"mappings":"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"}

package/lib/ui/decorators.cjs

@@ -10,6 +10,7 @@ exports.uilistprop = uilistprop;
 exports.uilayoutprop = uilayoutprop;
 exports.uipageprop = uipageprop;
 exports.uion = uion;
+exports.uionclick = uionclick;
 exports.uionrender = uionrender;
 exports.uitablecol = uitablecol;
 const constants_1 = require("./constants.cjs");
@@ -172,6 +173,10 @@ function hidden() {
  */
 function uielement(tag, props, serialize = false) {
     return (original, propertyKey) => {
+        if (typeof tag === "object") {
+            props = tag;
+            tag = "";
+        }
         const metadata = {
             tag: tag,
             serialize: serialize,
@@ -489,7 +494,7 @@ function uipageprop(page = 1) {
 /**
  * A decorator factory that binds a UI event to a specified handler function.
  * This is used to attach event handlers to specific lifecycle events of a `DecafComponent`,
- * such as `render` or `initialize`.
+ * such as `render` | `initialize` | `handleClick` | `refresh`
  *
  * @param event - The name of the lifecycle event to bind the handler to.
  *                Must be one of the keys in `Pick<DecafComponent, 'render' | 'initialize'>`.
@@ -508,10 +513,20 @@ function uipageprop(page = 1) {
 function uion(event, handler) {
     return function uion(original, propertyKey) {
         (0, decoration_1.propMetadata)((0, utils_1.getUIAttributeKey)(propertyKey, constants_1.UIKeys.EVENTS), {
-            [event]: handler,
+            ...(typeof event === "object" ? event : { [event]: handler }),
         })(original, propertyKey);
     };
 }
+/**
+ * A decorator function that associates a UI click handler with the 'handleClick' event.
+ *
+ * @param handler - A function that conforms to the `UIFunctionLike` type, which will be executed
+ *                  when the 'handleClick' event is triggered.
+ * @returns A decorated function that binds the handler to the 'handleClick' event.
+ */
+function uionclick(handler) {
+    return uion("handleClick", handler);
+}
 /**
  * A decorator function that associates a UI rendering handler with the 'render' event.
  *

package/lib/ui/decorators.d.ts

@@ -1,6 +1,4 @@
-import { CrudOperationKeys, UIFunctionLike, UILayoutCol } from "./types";
-import { DecafComponent } from "./DecafComponent";
-import { Model } from "@decaf-ts/decorator-validation";
+import { CrudOperationKeys, UIEventName, UIFunctionLike, UILayoutCol } from "./types";
 /**
  * @description Decorator that hides a property during specific CRUD operations
  * @summary Controls property visibility based on operation type
@@ -145,7 +143,7 @@ export declare function hidden(): (object: any, propertyKey?: any) => void;
  *   Model->>RenderingEngine: Return tag and props
  *   RenderingEngine->>UI: Render with specified element
  */
-export declare function uielement(tag: string, props?: Record<string, any>, serialize?: boolean): (original: any, propertyKey?: any) => void;
+export declare function uielement(tag: string | Record<string, any>, props?: Record<string, any>, serialize?: boolean): (original: any, propertyKey?: any) => void;
 /**
  * @description Decorator that maps a model property to a UI component property
  * @summary Specifies how a property should be passed to a UI component
@@ -410,7 +408,7 @@ export declare function uipageprop(page?: number): (original: any, propertyKey?:
 /**
  * A decorator factory that binds a UI event to a specified handler function.
  * This is used to attach event handlers to specific lifecycle events of a `DecafComponent`,
- * such as `render` or `initialize`.
+ * such as `render` | `initialize` | `handleClick` | `refresh`
  *
  * @param event - The name of the lifecycle event to bind the handler to.
  *                Must be one of the keys in `Pick<DecafComponent, 'render' | 'initialize'>`.
@@ -426,7 +424,15 @@ export declare function uipageprop(page?: number): (original: any, propertyKey?:
  * }
  * ```
  */
-export declare function uion(event: keyof Pick<DecafComponent<Model>, "render" | "initialize">, handler: UIFunctionLike): (original: object, propertyKey?: string) => void;
+export declare function uion(event: UIEventName | Record<string, UIFunctionLike>, handler: UIFunctionLike): (original: object, propertyKey?: string) => void;
+/**
+ * A decorator function that associates a UI click handler with the 'handleClick' event.
+ *
+ * @param handler - A function that conforms to the `UIFunctionLike` type, which will be executed
+ *                  when the 'handleClick' event is triggered.
+ * @returns A decorated function that binds the handler to the 'handleClick' event.
+ */
+export declare function uionclick(handler: UIFunctionLike): (original: object, propertyKey?: string) => void;
 /**
  * A decorator function that associates a UI rendering handler with the 'render' event.
  *