@almadar/std 1.0.0

package/LICENSE

@@ -0,0 +1,72 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             Almadar FZE
+Licensed Work:        KFlow Builder / Almadar
+                      The Licensed Work is (c) 2025-2026 Almadar FZE.
+Additional Use Grant: You may make production use of the Licensed Work for
+                      non-commercial purposes and for internal evaluation.
+                      Production use for commercial purposes requires a
+                      commercial license from the Licensor.
+Change Date:          2030-02-01
+Change License:       Apache License, Version 2.0
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+---
+
+License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+ADDITIONAL TERMS:
+
+Documentation (builder/packages/website/docs/) is licensed under CC BY 4.0.
+
+TRADEMARKS:
+
+"Orbital", "KFlow", "Almadar", and the Almadar logo are trademarks of
+Almadar FZE. You may not use these trademarks without prior written
+permission from Almadar FZE.
+
+For licensing inquiries: licensing@almadar.io

package/dist/behaviors/action-affinity.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Action-Component Affinity Rules
+ *
+ * Defines which actions are valid on which components in the Closed Circuit pattern.
+ * This enforces that behaviors only emit actions that make sense for their component context.
+ *
+ * The Closed Circuit pattern:
+ * Behavior → render_ui → Component → User Action → Event Bus → Behavior
+ *
+ * @packageDocumentation
+ */
+/**
+ * Action affinity definition for a component
+ */
+interface ActionAffinity {
+    /** Actions that are valid on this component */
+    valid: string[];
+    /** Actions that should NEVER appear on this component */
+    invalid: string[];
+}
+/**
+ * Action placement options
+ */
+type ActionPlacement = 'row' | 'bulk' | 'card' | 'footer' | 'header';
+/**
+ * Event naming convention for UI events
+ */
+interface UIEventInfo {
+    /** Event name (without UI: prefix) */
+    event: string;
+    /** Components that typically emit this event */
+    emittedBy: string[];
+    /** Expected payload shape */
+    payload: Record<string, string>;
+    /** Description of when this event is used */
+    description: string;
+}
+/**
+ * The action-component affinity matrix.
+ * This defines which actions belong on which components.
+ *
+ * CRITICAL: Not all actions belong on all components.
+ * The Closed Circuit pattern requires that actions match their component context.
+ */
+declare const ACTION_AFFINITY: Record<string, ActionAffinity>;
+/**
+ * Standard UI events and their metadata
+ */
+declare const UI_EVENTS: Record<string, UIEventInfo>;
+/**
+ * Check if an action is valid for a component
+ */
+declare function isActionValidForComponent(action: string, component: string): boolean;
+/**
+ * Check if an action is explicitly invalid for a component
+ */
+declare function isActionInvalidForComponent(action: string, component: string): boolean;
+/**
+ * Get valid actions for a component
+ */
+declare function getValidActionsForComponent(component: string): string[];
+/**
+ * Get invalid actions for a component
+ */
+declare function getInvalidActionsForComponent(component: string): string[];
+/**
+ * Get components that can emit a specific event
+ */
+declare function getComponentsForEvent(event: string): string[];
+/**
+ * Validate that a set of item actions are appropriate for a component
+ *
+ * @returns Array of validation errors (empty if valid)
+ */
+declare function validateActionsForComponent(actions: Array<{
+    event?: string;
+    label?: string;
+}>, component: string): string[];
+/**
+ * Get all known components in the affinity matrix
+ */
+declare function getAllKnownComponents(): string[];
+/**
+ * Get all components by category
+ */
+declare function getComponentsByCategory(): Record<string, string[]>;
+
+export { ACTION_AFFINITY, type ActionAffinity, type ActionPlacement, type UIEventInfo, UI_EVENTS, getAllKnownComponents, getComponentsByCategory, getComponentsForEvent, getInvalidActionsForComponent, getValidActionsForComponent, isActionInvalidForComponent, isActionValidForComponent, validateActionsForComponent };

package/dist/behaviors/action-affinity.js

@@ -0,0 +1,290 @@
+// behaviors/action-affinity.ts
+var ACTION_AFFINITY = {
+  // Display components - view data and trigger navigation/editing
+  "entity-table": {
+    valid: ["VIEW", "EDIT", "DELETE", "SELECT", "SORT", "PAGE"],
+    invalid: ["SAVE", "CANCEL", "SUBMIT", "CREATE", "CLOSE"]
+  },
+  "entity-list": {
+    valid: ["VIEW", "EDIT", "DELETE", "SELECT"],
+    invalid: ["SAVE", "CANCEL", "SUBMIT", "CREATE", "CLOSE"]
+  },
+  "entity-cards": {
+    valid: ["VIEW", "EDIT", "DELETE", "SELECT"],
+    invalid: ["SAVE", "CANCEL", "SUBMIT", "CREATE", "CLOSE"]
+  },
+  "card-grid": {
+    valid: ["VIEW", "EDIT", "DELETE", "SELECT"],
+    invalid: ["SAVE", "CANCEL", "SUBMIT", "CREATE", "CLOSE"]
+  },
+  // Header components - page-level actions
+  "page-header": {
+    valid: ["CREATE", "REFRESH", "EXPORT", "IMPORT", "BACK", "FILTER"],
+    invalid: ["SAVE", "VIEW", "EDIT", "DELETE", "SUBMIT"]
+  },
+  // Form components - data entry and submission
+  "form": {
+    valid: ["SAVE", "CANCEL", "SUBMIT", "CLOSE", "RESET", "FIELD_CHANGE", "FIELD_BLUR"],
+    invalid: ["VIEW", "DELETE", "CREATE", "SELECT", "EDIT"]
+  },
+  "form-section": {
+    valid: ["FIELD_CHANGE", "FIELD_BLUR"],
+    invalid: ["SAVE", "VIEW", "DELETE", "CREATE", "SELECT", "EDIT"]
+  },
+  "form-actions": {
+    valid: ["SAVE", "CANCEL", "SUBMIT", "RESET"],
+    invalid: ["VIEW", "DELETE", "CREATE", "SELECT", "EDIT"]
+  },
+  // Detail components - view single entity with edit/delete options
+  "detail-panel": {
+    valid: ["EDIT", "DELETE", "CLOSE", "BACK"],
+    invalid: ["SAVE", "CREATE", "SELECT", "SUBMIT"]
+  },
+  "entity-detail": {
+    valid: ["EDIT", "DELETE", "CLOSE", "BACK"],
+    invalid: ["SAVE", "CREATE", "SELECT", "SUBMIT"]
+  },
+  // Container components - open/close states
+  "modal": {
+    valid: ["CLOSE", "CONFIRM", "CANCEL"],
+    invalid: ["VIEW", "CREATE", "EDIT", "DELETE"]
+  },
+  "modal-container": {
+    valid: ["CLOSE", "CONFIRM", "CANCEL"],
+    invalid: ["VIEW", "CREATE", "EDIT", "DELETE"]
+  },
+  "drawer": {
+    valid: ["CLOSE"],
+    invalid: ["VIEW", "CREATE", "DELETE"]
+  },
+  // Navigation components
+  "tabs": {
+    valid: ["SELECT_TAB"],
+    invalid: ["SAVE", "CREATE", "DELETE", "VIEW", "EDIT"]
+  },
+  "tab-bar": {
+    valid: ["SELECT_TAB"],
+    invalid: ["SAVE", "CREATE", "DELETE", "VIEW", "EDIT"]
+  },
+  "wizard-navigation": {
+    valid: ["NEXT", "PREV", "GO_TO", "COMPLETE"],
+    invalid: ["SAVE", "CREATE", "DELETE", "VIEW", "EDIT"]
+  },
+  "wizard-progress": {
+    valid: ["GO_TO"],
+    invalid: ["SAVE", "CREATE", "DELETE", "VIEW", "EDIT", "NEXT", "PREV"]
+  },
+  // Filter components
+  "filter-group": {
+    valid: ["SET_FILTER", "CLEAR_FILTER", "CLEAR_ALL"],
+    invalid: ["SAVE", "CREATE", "DELETE", "VIEW", "EDIT"]
+  },
+  "search-bar": {
+    valid: ["SEARCH", "CLEAR_SEARCH"],
+    invalid: ["SAVE", "CREATE", "DELETE", "VIEW", "EDIT"]
+  },
+  "search-input": {
+    valid: ["SEARCH", "CLEAR_SEARCH"],
+    invalid: ["SAVE", "CREATE", "DELETE", "VIEW", "EDIT"]
+  },
+  // Pagination components
+  "pagination": {
+    valid: ["NEXT_PAGE", "PREV_PAGE", "GO_TO_PAGE", "SET_PAGE_SIZE"],
+    invalid: ["SAVE", "CREATE", "DELETE", "VIEW", "EDIT"]
+  },
+  // Confirmation components
+  "confirm-dialog": {
+    valid: ["CONFIRM", "CANCEL"],
+    invalid: ["VIEW", "CREATE", "EDIT", "DELETE", "SAVE"]
+  },
+  // Empty/Loading states - no actions
+  "empty-state": {
+    valid: ["CREATE"],
+    // Often has a "Create first item" CTA
+    invalid: ["SAVE", "VIEW", "EDIT", "DELETE", "CANCEL"]
+  },
+  "loading-state": {
+    valid: [],
+    invalid: ["SAVE", "VIEW", "EDIT", "DELETE", "CREATE", "CANCEL"]
+  },
+  // Stats/Dashboard - view only
+  "stats": {
+    valid: [],
+    invalid: ["SAVE", "VIEW", "EDIT", "DELETE", "CREATE", "CANCEL"]
+  },
+  // Game components
+  "game-canvas": {
+    valid: ["INPUT", "PAUSE", "UNPAUSE"],
+    invalid: ["SAVE", "CREATE", "DELETE"]
+  },
+  "game-hud": {
+    valid: ["PAUSE"],
+    invalid: ["SAVE", "CREATE", "DELETE", "VIEW", "EDIT"]
+  },
+  "game-controls": {
+    valid: ["INPUT", "ACTION"],
+    invalid: ["SAVE", "CREATE", "DELETE", "VIEW", "EDIT"]
+  },
+  "game-menu": {
+    valid: ["START", "OPTIONS", "QUIT", "SELECT"],
+    invalid: ["SAVE", "CREATE", "DELETE", "VIEW", "EDIT"]
+  },
+  "game-pause-overlay": {
+    valid: ["RESUME", "QUIT", "OPTIONS"],
+    invalid: ["SAVE", "CREATE", "DELETE", "VIEW", "EDIT"]
+  },
+  "game-over-screen": {
+    valid: ["RETRY", "QUIT", "MAIN_MENU"],
+    invalid: ["SAVE", "CREATE", "DELETE", "VIEW", "EDIT"]
+  }
+};
+var UI_EVENTS = {
+  VIEW: {
+    event: "VIEW",
+    emittedBy: ["entity-table", "entity-list", "entity-cards", "card-grid"],
+    payload: { row: "object", entity: "string" },
+    description: "View item detail"
+  },
+  EDIT: {
+    event: "EDIT",
+    emittedBy: ["entity-table", "entity-list", "entity-cards", "detail-panel"],
+    payload: { row: "object", entity: "string" },
+    description: "Edit item"
+  },
+  DELETE: {
+    event: "DELETE",
+    emittedBy: ["entity-table", "entity-list", "entity-cards", "detail-panel"],
+    payload: { row: "object", entity: "string" },
+    description: "Delete item"
+  },
+  CREATE: {
+    event: "CREATE",
+    emittedBy: ["page-header", "empty-state"],
+    payload: { entity: "string" },
+    description: "Create new item"
+  },
+  SAVE: {
+    event: "SAVE",
+    emittedBy: ["form", "form-actions"],
+    payload: { data: "object", entity: "string" },
+    description: "Save form data"
+  },
+  CANCEL: {
+    event: "CANCEL",
+    emittedBy: ["form", "form-actions", "modal", "confirm-dialog"],
+    payload: {},
+    description: "Cancel form/modal"
+  },
+  CLOSE: {
+    event: "CLOSE",
+    emittedBy: ["modal", "drawer", "detail-panel"],
+    payload: {},
+    description: "Close modal/drawer"
+  },
+  SELECT: {
+    event: "SELECT",
+    emittedBy: ["entity-table", "entity-list", "entity-cards"],
+    payload: { selectedIds: "string[]" },
+    description: "Selection change"
+  },
+  SEARCH: {
+    event: "SEARCH",
+    emittedBy: ["search-bar", "search-input"],
+    payload: { searchTerm: "string" },
+    description: "Search filter"
+  },
+  CONFIRM: {
+    event: "CONFIRM",
+    emittedBy: ["modal", "confirm-dialog"],
+    payload: {},
+    description: "Confirm action"
+  },
+  SELECT_TAB: {
+    event: "SELECT_TAB",
+    emittedBy: ["tabs", "tab-bar"],
+    payload: { tabId: "string" },
+    description: "Tab selection"
+  },
+  NEXT: {
+    event: "NEXT",
+    emittedBy: ["wizard-navigation"],
+    payload: {},
+    description: "Wizard next step"
+  },
+  PREV: {
+    event: "PREV",
+    emittedBy: ["wizard-navigation"],
+    payload: {},
+    description: "Wizard previous step"
+  }
+};
+function isActionValidForComponent(action, component) {
+  const affinity = ACTION_AFFINITY[component];
+  if (!affinity) {
+    return true;
+  }
+  return affinity.valid.includes(action) || !affinity.invalid.includes(action);
+}
+function isActionInvalidForComponent(action, component) {
+  const affinity = ACTION_AFFINITY[component];
+  if (!affinity) {
+    return false;
+  }
+  return affinity.invalid.includes(action);
+}
+function getValidActionsForComponent(component) {
+  const affinity = ACTION_AFFINITY[component];
+  return affinity?.valid ?? [];
+}
+function getInvalidActionsForComponent(component) {
+  const affinity = ACTION_AFFINITY[component];
+  return affinity?.invalid ?? [];
+}
+function getComponentsForEvent(event) {
+  return UI_EVENTS[event]?.emittedBy ?? [];
+}
+function validateActionsForComponent(actions, component) {
+  const errors = [];
+  const affinity = ACTION_AFFINITY[component];
+  if (!affinity) {
+    return errors;
+  }
+  for (const action of actions) {
+    if (action.event && affinity.invalid.includes(action.event)) {
+      errors.push(
+        `Action "${action.event}" is not valid on "${component}". Valid actions: ${affinity.valid.join(", ")}`
+      );
+    }
+  }
+  return errors;
+}
+function getAllKnownComponents() {
+  return Object.keys(ACTION_AFFINITY);
+}
+function getComponentsByCategory() {
+  return {
+    display: ["entity-table", "entity-list", "entity-cards", "card-grid"],
+    header: ["page-header"],
+    form: ["form", "form-section", "form-actions"],
+    detail: ["detail-panel", "entity-detail"],
+    container: ["modal", "modal-container", "drawer"],
+    navigation: ["tabs", "tab-bar", "wizard-navigation", "wizard-progress"],
+    filter: ["filter-group", "search-bar", "search-input"],
+    pagination: ["pagination"],
+    confirmation: ["confirm-dialog"],
+    state: ["empty-state", "loading-state"],
+    dashboard: ["stats"],
+    game: [
+      "game-canvas",
+      "game-hud",
+      "game-controls",
+      "game-menu",
+      "game-pause-overlay",
+      "game-over-screen"
+    ]
+  };
+}
+
+export { ACTION_AFFINITY, UI_EVENTS, getAllKnownComponents, getComponentsByCategory, getComponentsForEvent, getInvalidActionsForComponent, getValidActionsForComponent, isActionInvalidForComponent, isActionValidForComponent, validateActionsForComponent };
+//# sourceMappingURL=action-affinity.js.map
+//# sourceMappingURL=action-affinity.js.map

package/dist/behaviors/action-affinity.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../behaviors/action-affinity.ts"],"names":[],"mappings":"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","file":"action-affinity.js","sourcesContent":["/**\n * Action-Component Affinity Rules\n *\n * Defines which actions are valid on which components in the Closed Circuit pattern.\n * This enforces that behaviors only emit actions that make sense for their component context.\n *\n * The Closed Circuit pattern:\n * Behavior → render_ui → Component → User Action → Event Bus → Behavior\n *\n * @packageDocumentation\n */\n\n// ============================================================================\n// Action Affinity Types\n// ============================================================================\n\n/**\n * Action affinity definition for a component\n */\nexport interface ActionAffinity {\n  /** Actions that are valid on this component */\n  valid: string[];\n  /** Actions that should NEVER appear on this component */\n  invalid: string[];\n}\n\n/**\n * Action placement options\n */\nexport type ActionPlacement = 'row' | 'bulk' | 'card' | 'footer' | 'header';\n\n/**\n * Event naming convention for UI events\n */\nexport interface UIEventInfo {\n  /** Event name (without UI: prefix) */\n  event: string;\n  /** Components that typically emit this event */\n  emittedBy: string[];\n  /** Expected payload shape */\n  payload: Record<string, string>;\n  /** Description of when this event is used */\n  description: string;\n}\n\n// ============================================================================\n// Action-Component Affinity Matrix\n// ============================================================================\n\n/**\n * The action-component affinity matrix.\n * This defines which actions belong on which components.\n *\n * CRITICAL: Not all actions belong on all components.\n * The Closed Circuit pattern requires that actions match their component context.\n */\nexport const ACTION_AFFINITY: Record<string, ActionAffinity> = {\n  // Display components - view data and trigger navigation/editing\n  'entity-table': {\n    valid: ['VIEW', 'EDIT', 'DELETE', 'SELECT', 'SORT', 'PAGE'],\n    invalid: ['SAVE', 'CANCEL', 'SUBMIT', 'CREATE', 'CLOSE'],\n  },\n  'entity-list': {\n    valid: ['VIEW', 'EDIT', 'DELETE', 'SELECT'],\n    invalid: ['SAVE', 'CANCEL', 'SUBMIT', 'CREATE', 'CLOSE'],\n  },\n  'entity-cards': {\n    valid: ['VIEW', 'EDIT', 'DELETE', 'SELECT'],\n    invalid: ['SAVE', 'CANCEL', 'SUBMIT', 'CREATE', 'CLOSE'],\n  },\n  'card-grid': {\n    valid: ['VIEW', 'EDIT', 'DELETE', 'SELECT'],\n    invalid: ['SAVE', 'CANCEL', 'SUBMIT', 'CREATE', 'CLOSE'],\n  },\n\n  // Header components - page-level actions\n  'page-header': {\n    valid: ['CREATE', 'REFRESH', 'EXPORT', 'IMPORT', 'BACK', 'FILTER'],\n    invalid: ['SAVE', 'VIEW', 'EDIT', 'DELETE', 'SUBMIT'],\n  },\n\n  // Form components - data entry and submission\n  'form': {\n    valid: ['SAVE', 'CANCEL', 'SUBMIT', 'CLOSE', 'RESET', 'FIELD_CHANGE', 'FIELD_BLUR'],\n    invalid: ['VIEW', 'DELETE', 'CREATE', 'SELECT', 'EDIT'],\n  },\n  'form-section': {\n    valid: ['FIELD_CHANGE', 'FIELD_BLUR'],\n    invalid: ['SAVE', 'VIEW', 'DELETE', 'CREATE', 'SELECT', 'EDIT'],\n  },\n  'form-actions': {\n    valid: ['SAVE', 'CANCEL', 'SUBMIT', 'RESET'],\n    invalid: ['VIEW', 'DELETE', 'CREATE', 'SELECT', 'EDIT'],\n  },\n\n  // Detail components - view single entity with edit/delete options\n  'detail-panel': {\n    valid: ['EDIT', 'DELETE', 'CLOSE', 'BACK'],\n    invalid: ['SAVE', 'CREATE', 'SELECT', 'SUBMIT'],\n  },\n  'entity-detail': {\n    valid: ['EDIT', 'DELETE', 'CLOSE', 'BACK'],\n    invalid: ['SAVE', 'CREATE', 'SELECT', 'SUBMIT'],\n  },\n\n  // Container components - open/close states\n  'modal': {\n    valid: ['CLOSE', 'CONFIRM', 'CANCEL'],\n    invalid: ['VIEW', 'CREATE', 'EDIT', 'DELETE'],\n  },\n  'modal-container': {\n    valid: ['CLOSE', 'CONFIRM', 'CANCEL'],\n    invalid: ['VIEW', 'CREATE', 'EDIT', 'DELETE'],\n  },\n  'drawer': {\n    valid: ['CLOSE'],\n    invalid: ['VIEW', 'CREATE', 'DELETE'],\n  },\n\n  // Navigation components\n  'tabs': {\n    valid: ['SELECT_TAB'],\n    invalid: ['SAVE', 'CREATE', 'DELETE', 'VIEW', 'EDIT'],\n  },\n  'tab-bar': {\n    valid: ['SELECT_TAB'],\n    invalid: ['SAVE', 'CREATE', 'DELETE', 'VIEW', 'EDIT'],\n  },\n  'wizard-navigation': {\n    valid: ['NEXT', 'PREV', 'GO_TO', 'COMPLETE'],\n    invalid: ['SAVE', 'CREATE', 'DELETE', 'VIEW', 'EDIT'],\n  },\n  'wizard-progress': {\n    valid: ['GO_TO'],\n    invalid: ['SAVE', 'CREATE', 'DELETE', 'VIEW', 'EDIT', 'NEXT', 'PREV'],\n  },\n\n  // Filter components\n  'filter-group': {\n    valid: ['SET_FILTER', 'CLEAR_FILTER', 'CLEAR_ALL'],\n    invalid: ['SAVE', 'CREATE', 'DELETE', 'VIEW', 'EDIT'],\n  },\n  'search-bar': {\n    valid: ['SEARCH', 'CLEAR_SEARCH'],\n    invalid: ['SAVE', 'CREATE', 'DELETE', 'VIEW', 'EDIT'],\n  },\n  'search-input': {\n    valid: ['SEARCH', 'CLEAR_SEARCH'],\n    invalid: ['SAVE', 'CREATE', 'DELETE', 'VIEW', 'EDIT'],\n  },\n\n  // Pagination components\n  'pagination': {\n    valid: ['NEXT_PAGE', 'PREV_PAGE', 'GO_TO_PAGE', 'SET_PAGE_SIZE'],\n    invalid: ['SAVE', 'CREATE', 'DELETE', 'VIEW', 'EDIT'],\n  },\n\n  // Confirmation components\n  'confirm-dialog': {\n    valid: ['CONFIRM', 'CANCEL'],\n    invalid: ['VIEW', 'CREATE', 'EDIT', 'DELETE', 'SAVE'],\n  },\n\n  // Empty/Loading states - no actions\n  'empty-state': {\n    valid: ['CREATE'], // Often has a \"Create first item\" CTA\n    invalid: ['SAVE', 'VIEW', 'EDIT', 'DELETE', 'CANCEL'],\n  },\n  'loading-state': {\n    valid: [],\n    invalid: ['SAVE', 'VIEW', 'EDIT', 'DELETE', 'CREATE', 'CANCEL'],\n  },\n\n  // Stats/Dashboard - view only\n  'stats': {\n    valid: [],\n    invalid: ['SAVE', 'VIEW', 'EDIT', 'DELETE', 'CREATE', 'CANCEL'],\n  },\n\n  // Game components\n  'game-canvas': {\n    valid: ['INPUT', 'PAUSE', 'UNPAUSE'],\n    invalid: ['SAVE', 'CREATE', 'DELETE'],\n  },\n  'game-hud': {\n    valid: ['PAUSE'],\n    invalid: ['SAVE', 'CREATE', 'DELETE', 'VIEW', 'EDIT'],\n  },\n  'game-controls': {\n    valid: ['INPUT', 'ACTION'],\n    invalid: ['SAVE', 'CREATE', 'DELETE', 'VIEW', 'EDIT'],\n  },\n  'game-menu': {\n    valid: ['START', 'OPTIONS', 'QUIT', 'SELECT'],\n    invalid: ['SAVE', 'CREATE', 'DELETE', 'VIEW', 'EDIT'],\n  },\n  'game-pause-overlay': {\n    valid: ['RESUME', 'QUIT', 'OPTIONS'],\n    invalid: ['SAVE', 'CREATE', 'DELETE', 'VIEW', 'EDIT'],\n  },\n  'game-over-screen': {\n    valid: ['RETRY', 'QUIT', 'MAIN_MENU'],\n    invalid: ['SAVE', 'CREATE', 'DELETE', 'VIEW', 'EDIT'],\n  },\n};\n\n// ============================================================================\n// UI Event Definitions\n// ============================================================================\n\n/**\n * Standard UI events and their metadata\n */\nexport const UI_EVENTS: Record<string, UIEventInfo> = {\n  VIEW: {\n    event: 'VIEW',\n    emittedBy: ['entity-table', 'entity-list', 'entity-cards', 'card-grid'],\n    payload: { row: 'object', entity: 'string' },\n    description: 'View item detail',\n  },\n  EDIT: {\n    event: 'EDIT',\n    emittedBy: ['entity-table', 'entity-list', 'entity-cards', 'detail-panel'],\n    payload: { row: 'object', entity: 'string' },\n    description: 'Edit item',\n  },\n  DELETE: {\n    event: 'DELETE',\n    emittedBy: ['entity-table', 'entity-list', 'entity-cards', 'detail-panel'],\n    payload: { row: 'object', entity: 'string' },\n    description: 'Delete item',\n  },\n  CREATE: {\n    event: 'CREATE',\n    emittedBy: ['page-header', 'empty-state'],\n    payload: { entity: 'string' },\n    description: 'Create new item',\n  },\n  SAVE: {\n    event: 'SAVE',\n    emittedBy: ['form', 'form-actions'],\n    payload: { data: 'object', entity: 'string' },\n    description: 'Save form data',\n  },\n  CANCEL: {\n    event: 'CANCEL',\n    emittedBy: ['form', 'form-actions', 'modal', 'confirm-dialog'],\n    payload: {},\n    description: 'Cancel form/modal',\n  },\n  CLOSE: {\n    event: 'CLOSE',\n    emittedBy: ['modal', 'drawer', 'detail-panel'],\n    payload: {},\n    description: 'Close modal/drawer',\n  },\n  SELECT: {\n    event: 'SELECT',\n    emittedBy: ['entity-table', 'entity-list', 'entity-cards'],\n    payload: { selectedIds: 'string[]' },\n    description: 'Selection change',\n  },\n  SEARCH: {\n    event: 'SEARCH',\n    emittedBy: ['search-bar', 'search-input'],\n    payload: { searchTerm: 'string' },\n    description: 'Search filter',\n  },\n  CONFIRM: {\n    event: 'CONFIRM',\n    emittedBy: ['modal', 'confirm-dialog'],\n    payload: {},\n    description: 'Confirm action',\n  },\n  SELECT_TAB: {\n    event: 'SELECT_TAB',\n    emittedBy: ['tabs', 'tab-bar'],\n    payload: { tabId: 'string' },\n    description: 'Tab selection',\n  },\n  NEXT: {\n    event: 'NEXT',\n    emittedBy: ['wizard-navigation'],\n    payload: {},\n    description: 'Wizard next step',\n  },\n  PREV: {\n    event: 'PREV',\n    emittedBy: ['wizard-navigation'],\n    payload: {},\n    description: 'Wizard previous step',\n  },\n};\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Check if an action is valid for a component\n */\nexport function isActionValidForComponent(action: string, component: string): boolean {\n  const affinity = ACTION_AFFINITY[component];\n  if (!affinity) {\n    // Unknown component - allow by default but warn\n    return true;\n  }\n  return affinity.valid.includes(action) || !affinity.invalid.includes(action);\n}\n\n/**\n * Check if an action is explicitly invalid for a component\n */\nexport function isActionInvalidForComponent(action: string, component: string): boolean {\n  const affinity = ACTION_AFFINITY[component];\n  if (!affinity) {\n    return false;\n  }\n  return affinity.invalid.includes(action);\n}\n\n/**\n * Get valid actions for a component\n */\nexport function getValidActionsForComponent(component: string): string[] {\n  const affinity = ACTION_AFFINITY[component];\n  return affinity?.valid ?? [];\n}\n\n/**\n * Get invalid actions for a component\n */\nexport function getInvalidActionsForComponent(component: string): string[] {\n  const affinity = ACTION_AFFINITY[component];\n  return affinity?.invalid ?? [];\n}\n\n/**\n * Get components that can emit a specific event\n */\nexport function getComponentsForEvent(event: string): string[] {\n  return UI_EVENTS[event]?.emittedBy ?? [];\n}\n\n/**\n * Validate that a set of item actions are appropriate for a component\n *\n * @returns Array of validation errors (empty if valid)\n */\nexport function validateActionsForComponent(\n  actions: Array<{ event?: string; label?: string }>,\n  component: string\n): string[] {\n  const errors: string[] = [];\n  const affinity = ACTION_AFFINITY[component];\n\n  if (!affinity) {\n    // Unknown component - no validation\n    return errors;\n  }\n\n  for (const action of actions) {\n    if (action.event && affinity.invalid.includes(action.event)) {\n      errors.push(\n        `Action \"${action.event}\" is not valid on \"${component}\". ` +\n          `Valid actions: ${affinity.valid.join(', ')}`\n      );\n    }\n  }\n\n  return errors;\n}\n\n/**\n * Get all known components in the affinity matrix\n */\nexport function getAllKnownComponents(): string[] {\n  return Object.keys(ACTION_AFFINITY);\n}\n\n/**\n * Get all components by category\n */\nexport function getComponentsByCategory(): Record<string, string[]> {\n  return {\n    display: ['entity-table', 'entity-list', 'entity-cards', 'card-grid'],\n    header: ['page-header'],\n    form: ['form', 'form-section', 'form-actions'],\n    detail: ['detail-panel', 'entity-detail'],\n    container: ['modal', 'modal-container', 'drawer'],\n    navigation: ['tabs', 'tab-bar', 'wizard-navigation', 'wizard-progress'],\n    filter: ['filter-group', 'search-bar', 'search-input'],\n    pagination: ['pagination'],\n    confirmation: ['confirm-dialog'],\n    state: ['empty-state', 'loading-state'],\n    dashboard: ['stats'],\n    game: [\n      'game-canvas',\n      'game-hud',\n      'game-controls',\n      'game-menu',\n      'game-pause-overlay',\n      'game-over-screen',\n    ],\n  };\n}\n"]}

package/dist/behaviors/async.d.ts

@@ -0,0 +1,20 @@
+import { StandardBehavior } from './types.js';
+import '@almadar/core/types';
+
+/**
+ * Async Behaviors
+ *
+ * Standard behaviors for asynchronous operations like loading,
+ * fetching, submission, retry, and polling.
+ *
+ * @packageDocumentation
+ */
+
+declare const LOADING_BEHAVIOR: StandardBehavior;
+declare const FETCH_BEHAVIOR: StandardBehavior;
+declare const SUBMIT_BEHAVIOR: StandardBehavior;
+declare const RETRY_BEHAVIOR: StandardBehavior;
+declare const POLL_BEHAVIOR: StandardBehavior;
+declare const ASYNC_BEHAVIORS: StandardBehavior[];
+
+export { ASYNC_BEHAVIORS, FETCH_BEHAVIOR, LOADING_BEHAVIOR, POLL_BEHAVIOR, RETRY_BEHAVIOR, SUBMIT_BEHAVIOR };