@almadar/ui 5.164.0 → 5.166.0

package/dist/components/index.cjs

@@ -25657,6 +25657,8 @@ function FieldControl({
     control = /* @__PURE__ */ jsxRuntime.jsx(TextLikeControl, { field: name, numeric: true, value, onCommit: onChange });
   } else if (core.isSecretConfigType(decl.type)) {
     control = /* @__PURE__ */ jsxRuntime.jsx(TextLikeControl, { field: name, numeric: false, secret: true, value, onCommit: onChange });
+  } else if (decl.type === "event") {
+    control = /* @__PURE__ */ jsxRuntime.jsx(TextLikeControl, { field: name, numeric: false, value, onCommit: onChange });
   } else if (decl.type === "string") {
     control = /* @__PURE__ */ jsxRuntime.jsx(TextLikeControl, { field: name, numeric: false, value, onCommit: onChange });
   } else if (decl.type === "node") {
@@ -25696,7 +25698,7 @@ var init_PropertyInspector = __esm({
     init_JsonTreeEditor();
     init_NodeSlotEditor();
     TIER_ORDER = ["presentation", "domain", "policy", "infra", "internal"];
-    SCALAR_TYPES = /* @__PURE__ */ new Set(["string", "number", "boolean", "icon", "asset", "Asset", "secret"]);
+    SCALAR_TYPES = /* @__PURE__ */ new Set(["string", "number", "boolean", "icon", "asset", "Asset", "secret", "event"]);
     exports.PropertyInspector = ({
       config,
       values,

package/dist/components/index.d.cts

@@ -2377,7 +2377,7 @@ type MenuOption = EventPayload & {
     /** Display label */
     label: string;
     /** Event to emit on click */
-    event?: string;
+    event?: EventKey;
     /** Page to navigate to */
     navigatesTo?: string;
     /** Button variant */
@@ -2386,8 +2386,6 @@ type MenuOption = EventPayload & {
     disabled?: boolean;
     /** Sub-label or description */
     subLabel?: string;
-    /** Action identifier (alternative to event) */
-    action?: EventKey;
 };
 interface GameMenuProps {
     /** Menu title */
@@ -4144,7 +4142,7 @@ interface ActionButton {
     label: string;
     /** Action type - 'submit' renders as submit button, others render as button */
     actionType?: string;
-    event?: string;
+    event?: EventKey;
     navigatesTo?: string;
     /** Button variant - matches Button component variants. Accepts string for schema compatibility. */
     variant?: string;
@@ -4353,7 +4351,7 @@ interface FloatingAction {
      */
     onClick?: () => void;
     /** Event name to emit when clicked (for trait state machine integration) */
-    event?: string;
+    event?: EventKey;
     /**
      * Action variant
      */
@@ -4503,7 +4501,7 @@ interface MenuItem {
     /** Item click handler */
     onClick?: () => void;
     /** Event name for pattern compatibility */
-    event?: string;
+    event?: EventKey;
     /** File URL this item downloads on pick (gesture-driven, `DocumentViewer` precedent). The item's `event` still emits on the bus. */
     url?: string;
     /** Variant for styling (pattern compatibility) */
@@ -5039,7 +5037,7 @@ interface TabItem {
     /** Disable tab */
     disabled?: boolean;
     /** Event to emit when tab is clicked (for trait state machine integration) */
-    event?: string;
+    event?: EventKey;
     /** Whether this tab is currently active (for controlled tabs) */
     active?: boolean;
 }
@@ -5330,6 +5328,7 @@ type CodeLanguageLoader = (lang: string) => Promise<PrismLanguageGrammar | null>
 /** Wire up a dynamic language-grammar loader. Must be called from app source
  *  (not a pre-bundled dependency) so the bundler can split grammars into chunks. */
 declare function registerCodeLanguageLoader(loader: CodeLanguageLoader | null): void;
+
 /**
  * The set of languages with a registered PrismLight grammar (above) plus the
  * `.orb`/`.lolo` grammars from `@almadar/syntax`. Authoritative: an unregistered
@@ -5352,7 +5351,7 @@ interface DiffLine$1 {
 }
 interface CodeViewerAction {
     label: string;
-    event?: string;
+    event?: EventKey;
     navigatesTo?: string;
     variant?: 'primary' | 'secondary' | 'ghost';
 }
@@ -7949,7 +7948,7 @@ interface MeterThreshold {
 }
 interface MeterAction {
     label: string;
-    event?: string;
+    event?: EventKey;
     navigatesTo?: string;
     variant?: "primary" | "secondary" | "ghost";
 }
@@ -9401,7 +9400,7 @@ interface SchemaAction {
     /** Custom click handler */
     onClick?: () => void;
     /** Event to dispatch via event bus (for trait state machine integration) */
-    event?: string;
+    event?: EventKey;
     variant?: "primary" | "secondary" | "ghost" | "danger";
     icon?: IconInput;
     loading?: boolean;
@@ -10208,7 +10207,7 @@ interface ChartSeries {
 }
 interface ChartAction {
     label: string;
-    event?: string;
+    event?: EventKey;
     navigatesTo?: string;
     variant?: "primary" | "secondary" | "ghost";
 }
@@ -10325,7 +10324,7 @@ declare const SignaturePad: React__default.FC<SignaturePadProps>;
 type DocumentType = "pdf" | "text" | "html" | "markdown";
 interface DocumentAction {
     label: string;
-    event?: string;
+    event?: EventKey;
     navigatesTo?: string;
     variant?: "primary" | "secondary" | "ghost";
 }
@@ -10426,7 +10425,7 @@ interface GraphSimilarity {
 }
 interface GraphAction {
     label: string;
-    event?: string;
+    event?: EventKey;
     navigatesTo?: string;
     variant?: "primary" | "secondary" | "ghost";
 }
@@ -10786,11 +10785,11 @@ interface RowAction<T> {
     onClick?: (row: T) => void;
     variant?: "default" | "danger";
     show?: (row: T) => boolean;
-    event?: string;
+    event?: EventKey;
 }
 interface DataTableEmptyAction {
     label: string;
-    event?: string;
+    event?: EventKey;
 }
 interface DataTableProps<T extends EntityRow & {
     id: string | number;
@@ -10804,9 +10803,8 @@ interface DataTableProps<T extends EntityRow & {
     /** Item actions from generated code - maps to rowActions */
     itemActions?: readonly {
         label: string;
-        event?: string;
+        event?: EventKey;
         navigatesTo?: string;
-        action?: EventKey;
         placement?: "row" | "bulk" | string;
         icon?: IconInput;
         variant?: "default" | "primary" | "secondary" | "ghost" | "danger" | string;
@@ -10826,7 +10824,7 @@ interface DataTableProps<T extends EntityRow & {
         /** Optional when `event` is set — a bus-emitting onClick is synthesized. */
         onClick?: (selectedRows: T[]) => void;
         variant?: "default" | "danger";
-        event?: string;
+        event?: EventKey;
     }>;
     headerActions?: React__default.ReactNode;
     /** Show total count in pagination */
@@ -10936,8 +10934,11 @@ interface DetailPanelAction {
     label: string;
     icon?: IconInput;
     onClick?: () => void;
-    /** Event to emit via event bus */
-    event?: string;
+    /** Event to emit via event bus. `EventKey`, not `string`: the pattern
+     *  parser tags an array prop as `kind: "event-list"` only when its element
+     *  interface types the event field this way, and that tag is what makes an
+     *  authored `events { EDIT: X }` rename fold into these config literals. */
+    event?: EventKey;
     /** Navigation URL */
     navigatesTo?: string;
     /** Button variant (primary for main action, others for secondary) */
@@ -11288,8 +11289,6 @@ interface SchemaItemAction {
     navigatesTo?: string;
     /** Action placement - accepts all common placement values */
     placement?: "row" | "bulk" | "card" | "footer" | string;
-    /** Alternate event-dispatch field (same semantics as `event`) — generated code emits `UI:{action}` on click */
-    action?: EventKey;
     variant?: "primary" | "secondary" | "ghost" | "danger" | "default";
     /** Click handler from generated code */
     onClick?: (row: EntityRow) => void;
@@ -11348,8 +11347,6 @@ interface CardItemAction {
     navigatesTo?: string;
     /** Callback on click */
     onClick?: (item: EventPayload) => void;
-    /** Action used by generated code - alternative to event */
-    action?: EventKey;
     /** Action placement - accepts string for compatibility with generated code */
     placement?: 'card' | 'footer' | 'row' | string;
     /** Button variant - accepts string for compatibility with generated code */
@@ -12145,7 +12142,7 @@ type MediaItem = EntityRow & {
 };
 interface MediaGalleryAction {
     label: string;
-    event?: string;
+    event?: EventKey;
     navigatesTo?: string;
     variant?: "primary" | "secondary" | "ghost";
 }

package/dist/components/index.d.ts

@@ -2377,7 +2377,7 @@ type MenuOption = EventPayload & {
     /** Display label */
     label: string;
     /** Event to emit on click */
-    event?: string;
+    event?: EventKey;
     /** Page to navigate to */
     navigatesTo?: string;
     /** Button variant */
@@ -2386,8 +2386,6 @@ type MenuOption = EventPayload & {
     disabled?: boolean;
     /** Sub-label or description */
     subLabel?: string;
-    /** Action identifier (alternative to event) */
-    action?: EventKey;
 };
 interface GameMenuProps {
     /** Menu title */
@@ -4144,7 +4142,7 @@ interface ActionButton {
     label: string;
     /** Action type - 'submit' renders as submit button, others render as button */
     actionType?: string;
-    event?: string;
+    event?: EventKey;
     navigatesTo?: string;
     /** Button variant - matches Button component variants. Accepts string for schema compatibility. */
     variant?: string;
@@ -4353,7 +4351,7 @@ interface FloatingAction {
      */
     onClick?: () => void;
     /** Event name to emit when clicked (for trait state machine integration) */
-    event?: string;
+    event?: EventKey;
     /**
      * Action variant
      */
@@ -4503,7 +4501,7 @@ interface MenuItem {
     /** Item click handler */
     onClick?: () => void;
     /** Event name for pattern compatibility */
-    event?: string;
+    event?: EventKey;
     /** File URL this item downloads on pick (gesture-driven, `DocumentViewer` precedent). The item's `event` still emits on the bus. */
     url?: string;
     /** Variant for styling (pattern compatibility) */
@@ -5039,7 +5037,7 @@ interface TabItem {
     /** Disable tab */
     disabled?: boolean;
     /** Event to emit when tab is clicked (for trait state machine integration) */
-    event?: string;
+    event?: EventKey;
     /** Whether this tab is currently active (for controlled tabs) */
     active?: boolean;
 }
@@ -5330,6 +5328,7 @@ type CodeLanguageLoader = (lang: string) => Promise<PrismLanguageGrammar | null>
 /** Wire up a dynamic language-grammar loader. Must be called from app source
  *  (not a pre-bundled dependency) so the bundler can split grammars into chunks. */
 declare function registerCodeLanguageLoader(loader: CodeLanguageLoader | null): void;
+
 /**
  * The set of languages with a registered PrismLight grammar (above) plus the
  * `.orb`/`.lolo` grammars from `@almadar/syntax`. Authoritative: an unregistered
@@ -5352,7 +5351,7 @@ interface DiffLine$1 {
 }
 interface CodeViewerAction {
     label: string;
-    event?: string;
+    event?: EventKey;
     navigatesTo?: string;
     variant?: 'primary' | 'secondary' | 'ghost';
 }
@@ -7949,7 +7948,7 @@ interface MeterThreshold {
 }
 interface MeterAction {
     label: string;
-    event?: string;
+    event?: EventKey;
     navigatesTo?: string;
     variant?: "primary" | "secondary" | "ghost";
 }
@@ -9401,7 +9400,7 @@ interface SchemaAction {
     /** Custom click handler */
     onClick?: () => void;
     /** Event to dispatch via event bus (for trait state machine integration) */
-    event?: string;
+    event?: EventKey;
     variant?: "primary" | "secondary" | "ghost" | "danger";
     icon?: IconInput;
     loading?: boolean;
@@ -10208,7 +10207,7 @@ interface ChartSeries {
 }
 interface ChartAction {
     label: string;
-    event?: string;
+    event?: EventKey;
     navigatesTo?: string;
     variant?: "primary" | "secondary" | "ghost";
 }
@@ -10325,7 +10324,7 @@ declare const SignaturePad: React__default.FC<SignaturePadProps>;
 type DocumentType = "pdf" | "text" | "html" | "markdown";
 interface DocumentAction {
     label: string;
-    event?: string;
+    event?: EventKey;
     navigatesTo?: string;
     variant?: "primary" | "secondary" | "ghost";
 }
@@ -10426,7 +10425,7 @@ interface GraphSimilarity {
 }
 interface GraphAction {
     label: string;
-    event?: string;
+    event?: EventKey;
     navigatesTo?: string;
     variant?: "primary" | "secondary" | "ghost";
 }
@@ -10786,11 +10785,11 @@ interface RowAction<T> {
     onClick?: (row: T) => void;
     variant?: "default" | "danger";
     show?: (row: T) => boolean;
-    event?: string;
+    event?: EventKey;
 }
 interface DataTableEmptyAction {
     label: string;
-    event?: string;
+    event?: EventKey;
 }
 interface DataTableProps<T extends EntityRow & {
     id: string | number;
@@ -10804,9 +10803,8 @@ interface DataTableProps<T extends EntityRow & {
     /** Item actions from generated code - maps to rowActions */
     itemActions?: readonly {
         label: string;
-        event?: string;
+        event?: EventKey;
         navigatesTo?: string;
-        action?: EventKey;
         placement?: "row" | "bulk" | string;
         icon?: IconInput;
         variant?: "default" | "primary" | "secondary" | "ghost" | "danger" | string;
@@ -10826,7 +10824,7 @@ interface DataTableProps<T extends EntityRow & {
         /** Optional when `event` is set — a bus-emitting onClick is synthesized. */
         onClick?: (selectedRows: T[]) => void;
         variant?: "default" | "danger";
-        event?: string;
+        event?: EventKey;
     }>;
     headerActions?: React__default.ReactNode;
     /** Show total count in pagination */
@@ -10936,8 +10934,11 @@ interface DetailPanelAction {
     label: string;
     icon?: IconInput;
     onClick?: () => void;
-    /** Event to emit via event bus */
-    event?: string;
+    /** Event to emit via event bus. `EventKey`, not `string`: the pattern
+     *  parser tags an array prop as `kind: "event-list"` only when its element
+     *  interface types the event field this way, and that tag is what makes an
+     *  authored `events { EDIT: X }` rename fold into these config literals. */
+    event?: EventKey;
     /** Navigation URL */
     navigatesTo?: string;
     /** Button variant (primary for main action, others for secondary) */
@@ -11288,8 +11289,6 @@ interface SchemaItemAction {
     navigatesTo?: string;
     /** Action placement - accepts all common placement values */
     placement?: "row" | "bulk" | "card" | "footer" | string;
-    /** Alternate event-dispatch field (same semantics as `event`) — generated code emits `UI:{action}` on click */
-    action?: EventKey;
     variant?: "primary" | "secondary" | "ghost" | "danger" | "default";
     /** Click handler from generated code */
     onClick?: (row: EntityRow) => void;
@@ -11348,8 +11347,6 @@ interface CardItemAction {
     navigatesTo?: string;
     /** Callback on click */
     onClick?: (item: EventPayload) => void;
-    /** Action used by generated code - alternative to event */
-    action?: EventKey;
     /** Action placement - accepts string for compatibility with generated code */
     placement?: 'card' | 'footer' | 'row' | string;
     /** Button variant - accepts string for compatibility with generated code */
@@ -12145,7 +12142,7 @@ type MediaItem = EntityRow & {
 };
 interface MediaGalleryAction {
     label: string;
-    event?: string;
+    event?: EventKey;
     navigatesTo?: string;
     variant?: "primary" | "secondary" | "ghost";
 }

package/dist/components/index.js

@@ -25582,6 +25582,8 @@ function FieldControl({
     control = /* @__PURE__ */ jsx(TextLikeControl, { field: name, numeric: true, value, onCommit: onChange });
   } else if (isSecretConfigType(decl.type)) {
     control = /* @__PURE__ */ jsx(TextLikeControl, { field: name, numeric: false, secret: true, value, onCommit: onChange });
+  } else if (decl.type === "event") {
+    control = /* @__PURE__ */ jsx(TextLikeControl, { field: name, numeric: false, value, onCommit: onChange });
   } else if (decl.type === "string") {
     control = /* @__PURE__ */ jsx(TextLikeControl, { field: name, numeric: false, value, onCommit: onChange });
   } else if (decl.type === "node") {
@@ -25621,7 +25623,7 @@ var init_PropertyInspector = __esm({
     init_JsonTreeEditor();
     init_NodeSlotEditor();
     TIER_ORDER = ["presentation", "domain", "policy", "infra", "internal"];
-    SCALAR_TYPES = /* @__PURE__ */ new Set(["string", "number", "boolean", "icon", "asset", "Asset", "secret"]);
+    SCALAR_TYPES = /* @__PURE__ */ new Set(["string", "number", "boolean", "icon", "asset", "Asset", "secret", "event"]);
     PropertyInspector = ({
       config,
       values,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "5.164.0",
+  "version": "5.166.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "sideEffects": [
@@ -118,12 +118,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@almadar/core": "^10.74.0",
-    "@almadar/evaluator": "^2.42.0",
-    "@almadar/logger": "^1.11.0",
-    "@almadar/runtime": "^6.63.0",
-    "@almadar/std": "^16.193.0",
-    "@almadar/syntax": "^1.15.0",
+    "@almadar/core": "^10.76.0",
+    "@almadar/evaluator": "^2.43.0",
+    "@almadar/logger": "^1.12.0",
+    "@almadar/runtime": "^6.66.0",
+    "@almadar/std": "^16.196.0",
+    "@almadar/syntax": "^1.16.0",
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
@@ -173,7 +173,7 @@
     }
   },
   "devDependencies": {
-    "@almadar/eslint-plugin": "^2.16.0",
+    "@almadar/eslint-plugin": "^2.17.0",
     "@react-three/drei": "^10.7.7",
     "@react-three/fiber": "^9.6.0",
     "@react-three/postprocessing": "3.0.4",