@almadar/std 3.1.1 → 3.1.3

package/behaviors/exports/organisms/std-healthcare.orb

@@ -4675,5 +4675,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Healthcare organism. Composes molecules via compose: - stdList(Patient): patient registry with CRUD - stdList(Appointment): appointment management - stdWizard(IntakeForm): patient intake wizard - stdDetail(Prescription): prescription browse + view - stdDisplay(Dashboard): clinic dashboard KPIs Cross-orbital connections: - INTAKE_COMPLETE: IntakeFormWizard -> PatientBrowse - PRESCRIBE: AppointmentBrowse -> PrescriptionBrowse"
 }

package/behaviors/exports/organisms/std-helpdesk.orb

@@ -2560,5 +2560,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Helpdesk organism. Composes molecules via compose: - stdList(Ticket): CRUD list of support tickets - stdMessaging(Response): messaging thread for ticket responses - stdDisplay(SupportMetrics): read-only metrics dashboard Pages: /tickets (initial), /responses, /metrics Connections: ASSIGN (tickets->responses), RESOLVE (responses->metrics)"
 }

package/behaviors/exports/organisms/std-hr-portal.orb

@@ -4025,5 +4025,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "HR portal organism. Composes molecules via compose: - stdList(Employee): CRUD list of employees - stdWizard(Onboarding): multi-step onboarding wizard - stdList(TimeOff): CRUD list of time-off requests - stdDisplay(OrgChart): read-only org chart dashboard Pages: /employees (initial), /onboarding, /timeoff, /org-chart Connections: ONBOARD (employees->onboarding), APPROVE_LEAVE (timeoff->orgchart)"
 }

package/behaviors/exports/organisms/std-iot-dashboard.orb

@@ -2293,5 +2293,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "IoT dashboard organism. Composes: stdDisplay(SensorReading) + stdList(Device) + stdCircuitBreaker(DeviceAlert) Pages: /sensors (initial), /devices, /alerts"
 }

package/behaviors/exports/organisms/std-lms.orb

@@ -2850,5 +2850,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Learning management system organism. Composes molecules via compose: - stdList(Course): CRUD list of courses - stdWizard(Enrollment): multi-step enrollment wizard - stdDisplay(Progress): read-only progress dashboard Pages: /courses (initial), /enroll, /progress Connections: ENROLL (courses->enrollment), COMPLETE_LESSON (enrollment->progress)"
 }

package/behaviors/exports/organisms/std-logic-training.orb

@@ -594,5 +594,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Logic training organism. Composes: stdDebuggerGame(DebugChallenge) + stdNegotiatorGame(NegotiateChallenge)         + stdScoreBoard(TrainingScore) Pages: /debugger (initial), /negotiator, /scores"
 }

package/behaviors/exports/organisms/std-platformer-app.orb

@@ -1565,5 +1565,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Platformer game organism. Composes: stdPlatformerGame(PlatLevel) + stdScoreBoard(PlatScore) + stdInventory(Collectible) Pages: /game (initial), /scores, /collectibles"
 }

package/behaviors/exports/organisms/std-project-manager.orb

@@ -3017,5 +3017,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Project management organism. Composes molecules via compose: - stdList(Task): task management with CRUD - stdList(Sprint): sprint management with CRUD - stdDisplay(Burndown): burndown chart dashboard Cross-orbital connections: - ASSIGN_TASK: SprintBrowse -> TaskBrowse - COMPLETE_SPRINT: SprintBrowse -> BurndownDisplay"
 }

package/behaviors/exports/organisms/std-puzzle-app.orb

@@ -739,5 +739,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Puzzle game organism. Composes: stdPuzzleGame(PuzzleLevel) + stdScoreBoard(PuzzleScore) Pages: /puzzle (initial), /scores"
 }

package/behaviors/exports/organisms/std-realtime-chat.orb

@@ -2376,5 +2376,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Realtime chat organism. Composes: stdMessaging(ChatMessage) + stdList(Channel) + stdDisplay(OnlineUser) Pages: /chat (initial), /channels, /online"
 }

package/behaviors/exports/organisms/std-rpg-game.orb

@@ -2800,5 +2800,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "RPG game organism. Composes: stdTurnBasedBattle(BattleState) + stdOverworld(WorldZone)         + stdInventory(RpgItem) + stdQuest(Mission) Pages: /battle, /world (initial), /inventory, /quests Connections: ENCOUNTER_STARTED (world->battle), LOOT_DROPPED (battle->inventory),              QUEST_ACCEPTED (world->quests)"
 }

package/behaviors/exports/organisms/std-social-feed.orb

@@ -1217,5 +1217,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Social feed organism. Composes molecules via compose: - stdDetail(Post): browse + create + view posts - stdMessaging(Comment): messaging thread for comments Pages: /feed (initial), /messages Connections: COMMENT event wires posts to comments."
 }

package/behaviors/exports/organisms/std-stem-lab.orb

@@ -1206,5 +1206,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "STEM lab organism. Composes: stdSimulatorGame(Experiment) + stdClassifierGame(Classification)         + stdDisplay(LabResult) Pages: /simulator (initial), /classifier, /results"
 }

package/behaviors/exports/organisms/std-strategy-game.orb

@@ -1757,5 +1757,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Strategy game organism. Composes: stdTurnBasedBattle(ArmyBattle) + stdOverworld(Territory) + stdDisplay(Resource) Pages: /battle, /map (initial), /resources"
 }

package/behaviors/exports/organisms/std-trading-dashboard.orb

@@ -2213,5 +2213,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Trading dashboard organism. Composes: stdDisplay(Portfolio) + stdList(TradeOrder) + stdAsync(MarketFeed) Pages: /portfolio (initial), /orders, /market"
 }

package/behaviors/exports/validation-report.json

@@ -0,0 +1,18 @@
+[
+  {
+    "name": "std-list",
+    "errors": 0,
+    "warnings": 1,
+    "output": [
+      "Loaded 22 services from packages/almadar-patterns/src/services-registry.json",
+      "Validating schema: /home/osamah/kflow.ai.builder/packages/almadar-std/behaviors/exports/molecules/std-list.orb",
+      "Schema validation warnings:",
+      "  ⚠️  [CIRCUIT_MODAL_EXIT_INCOMPLETE] orbitals[0].traits[0].transitions[Single(\"deleting\")->CONFIRM_DELETE->browsing]: Transition Single(\"deleting\")--[CONFIRM_DELETE]-->browsing closes modal but doesn't re-render main slot. Main view will show stale content.",
+      "     💡 Add render-ui(\"main\", {...}) alongside render-ui(\"modal\", null) to refresh the main view after closing the modal",
+      "  ⚠️  [CIRCUIT_MODAL_EXIT_INCOMPLETE] orbitals[0].traits[0].transitions[Single(\"deleting\")->CANCEL->browsing]: Transition Single(\"deleting\")--[CANCEL]-->browsing closes modal but doesn't re-render main slot. Main view will show stale content.",
+      "     💡 Add render-ui(\"main\", {...}) alongside render-ui(\"modal\", null) to refresh the main view after closing the modal",
+      "  ⚠️  [CIRCUIT_MODAL_EXIT_INCOMPLETE] orbitals[0].traits[0].transitions[Single(\"deleting\")->CLOSE->browsing]: Transition Single(\"deleting\")--[CLOSE]-->browsing closes modal but doesn't re-render main slot. Main view will show stale content.",
+      "     💡 Add render-ui(\"main\", {...}) alongside render-ui(\"modal\", null) to refresh the main view after closing the modal"
+    ]
+  }
+]

package/dist/behaviors/exports/atoms/std-async.orb

@@ -416,5 +416,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Async operation behavior: idle, loading, success, error. Covers fetch, submit, retry, and polling patterns in one molecule. Pure function: params in, OrbitalDefinition out."
 }

package/dist/behaviors/exports/atoms/std-browse.orb

@@ -169,5 +169,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Data grid browsing atom. Renders a list of entities with configurable item actions. The browsing view that molecules compose with modal/confirmation atoms."
 }

package/dist/behaviors/exports/atoms/std-cache-aside.orb

@@ -877,5 +877,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Cache management behavior: empty, cached, stale with fetch/invalidate cycle. Pure function: params in, OrbitalDefinition out."
 }

package/dist/behaviors/exports/atoms/std-circuit-breaker.orb

@@ -497,5 +497,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Circuit breaker pattern behavior: closed, open, halfOpen. Protects services from cascading failures with automatic recovery. Pure function: params in, OrbitalDefinition out."
 }

package/dist/behaviors/exports/atoms/std-collision.orb

@@ -612,5 +612,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Game collision detection parameterized for any domain. Provides idle and detecting states for checking collisions between game entities. Tracks collision targets via entity fields. The state machine structure is fixed. The caller controls data and presentation."
 }

package/dist/behaviors/exports/atoms/std-combat-log.orb

@@ -141,5 +141,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Scrollable combat event log atom using the `combat-log` pattern. Displays timestamped combat events with icons and colors. Supports appending new events and clearing the log."
 }

package/dist/behaviors/exports/atoms/std-combat.orb

@@ -406,5 +406,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Attack cycle behavior: ready, attacking, cooldown, defeated. Pure function: params in, OrbitalDefinition out."
 }

package/dist/behaviors/exports/atoms/std-confirmation.orb

@@ -278,5 +278,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Confirmation dialog behavior parameterized for any domain. Provides a two-step confirm/cancel flow before performing destructive actions. The caller handles the actual action via emits/listens. The state machine structure is fixed. The caller controls data and presentation."
 }

package/dist/behaviors/exports/atoms/std-dialogue-box.orb

@@ -234,5 +234,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "RPG dialogue atom using the `dialogue-box` pattern. Shows speaker, portrait, typewriter text, and choices."
 }

package/dist/behaviors/exports/atoms/std-display.orb

@@ -838,5 +838,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Read-only display molecule with loading/refresh. Single trait (display is self-contained, no modal atoms needed). Used for dashboards, stats panels, KPIs."
 }

package/dist/behaviors/exports/atoms/std-drawer.orb

@@ -312,5 +312,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Drawer behavior parameterized for any domain. Provides a slide-out drawer that displays entity detail. Two states: closed and open, with transitions to toggle visibility. Similar to std-modal but renders to a \"drawer\" slot concept."
 }

package/dist/behaviors/exports/atoms/std-filter.orb

@@ -438,5 +438,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Filter atom. Shows filter buttons per field with predefined values. Clicking a filter value transitions to filtered state. Clear resets."
 }

package/dist/behaviors/exports/atoms/std-game-audio.orb

@@ -109,5 +109,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Game audio provider atom using the `game-audio-provider` pattern. Wraps child content with an audio context, providing sound playback and mute toggling."
 }

package/dist/behaviors/exports/atoms/std-game-hud.orb

@@ -147,5 +147,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Heads-up display atom. Renders the `game-hud` pattern showing health, score, lives, and other stats."
 }

package/dist/behaviors/exports/atoms/std-game-menu.orb

@@ -207,5 +207,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Game main menu atom using the `game-menu` pattern. Shows title, subtitle, and menu options (Start, Options, Credits, etc.)."
 }

package/dist/behaviors/exports/atoms/std-game-over-screen.orb

@@ -191,5 +191,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Game over screen atom using the `game-over-screen` pattern. Shows final score, high score, and retry/quit actions."
 }

package/dist/behaviors/exports/atoms/std-gameflow.orb

@@ -314,5 +314,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Game state management behavior: menu, playing, paused, gameover. Uses game UI patterns per state:   menu     -> game-menu (title, subtitle, Start Game button)   playing  -> game-hud (score, level stats)   paused   -> game-menu in modal (Resume, Quit buttons)   gameover -> game-over-screen (score, Play Again, Main Menu) Pure function: params in, OrbitalDefinition out."
 }

package/dist/behaviors/exports/atoms/std-input.orb

@@ -625,5 +625,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Input state management parameterized for any domain. Provides idle, focused, and validating states with change tracking. The state machine structure is fixed. The caller controls data and presentation."
 }

package/dist/behaviors/exports/atoms/std-inventory-panel.orb

@@ -251,5 +251,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Grid-based inventory atom using the `inventory-panel` pattern. Shows items in a grid with select, use, and drop actions."
 }

package/dist/behaviors/exports/atoms/std-isometric-canvas.orb

@@ -627,5 +627,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Isometric game renderer atom using the `isometric-canvas` pattern. Renders tiles, units, and features on an isometric grid. Handles tile clicks, unit clicks, and hover events."
 }

package/dist/behaviors/exports/atoms/std-loading.orb

@@ -507,5 +507,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Loading behavior parameterized for any domain. Provides a multi-state loading lifecycle: idle, loading, success, error. Tracks async operation status with appropriate UI for each state."
 }

package/dist/behaviors/exports/atoms/std-modal.orb

@@ -266,5 +266,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Modal overlay atom. Accepts content injection so molecules can control what renders inside the open state."
 }

package/dist/behaviors/exports/atoms/std-movement.orb

@@ -1033,5 +1033,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Entity movement behavior: idle, moving, collision detection and resolution. Pure function: params in, OrbitalDefinition out."
 }

package/dist/behaviors/exports/atoms/std-notification.orb

@@ -414,5 +414,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Notification behavior parameterized for any domain. Provides a show/hide notification display. The state machine structure is fixed. The caller controls data and presentation."
 }

package/dist/behaviors/exports/atoms/std-overworld.orb

@@ -479,5 +479,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Map/zone navigation behavior: exploring, transitioning, entered. Pure function: params in, OrbitalDefinition out."
 }

package/dist/behaviors/exports/atoms/std-pagination.orb

@@ -327,5 +327,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Pagination behavior parameterized for any domain. Provides page/pageSize controls that paginate entity data. Single idle state with a self-loop that re-renders with the new page applied."
 }

package/dist/behaviors/exports/atoms/std-physics2d.orb

@@ -415,5 +415,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "2D physics simulation parameterized for any domain. Provides idle and simulating states with force application and tick updates. Tracks position and velocity via entity fields. The state machine structure is fixed. The caller controls data and presentation."
 }

package/dist/behaviors/exports/atoms/std-platformer-canvas.orb

@@ -253,5 +253,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Side-scrolling platformer atom using the `platformer-canvas` pattern. Renders player, platforms, and handles movement events."
 }

package/dist/behaviors/exports/atoms/std-quest.orb

@@ -976,5 +976,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Quest/objective tracking behavior: available, active, complete, failed. Pure function: params in, OrbitalDefinition out."
 }

package/dist/behaviors/exports/atoms/std-rate-limiter.orb

@@ -634,5 +634,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Rate limiting parameterized for any domain. Provides open and throttled states for controlling request frequency. Tracks request count and throttle status via entity fields. The state machine structure is fixed. The caller controls data and presentation."
 }

package/dist/behaviors/exports/atoms/std-score-board.orb

@@ -234,5 +234,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Score display atom using the `score-board` pattern. Shows score, high score, combo, multiplier, level."
 }

package/dist/behaviors/exports/atoms/std-score.orb

@@ -462,5 +462,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Score tracking parameterized for any domain. Provides a single-state machine with self-loops for adding, subtracting, resetting, and applying combo multipliers to a score. The state machine structure is fixed. The caller controls data and presentation."
 }

package/dist/behaviors/exports/atoms/std-search.orb

@@ -369,5 +369,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Search behavior parameterized for any domain. Provides a search input that filters entity data by query string. The state machine structure is fixed. The caller controls data and presentation."
 }

package/dist/behaviors/exports/atoms/std-selection.orb

@@ -755,5 +755,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Selection behavior parameterized for any domain. Provides item selection from a list with confirm/deselect controls. Three states: idle, selecting, selected with transitions for the full lifecycle."
 }

package/dist/behaviors/exports/atoms/std-simulation-canvas.orb

@@ -179,5 +179,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "2D physics simulation renderer atom using the `simulation-canvas` pattern. Runs built-in Euler integration for educational presets (pendulum, spring, etc.). Supports start, stop, and reset controls."
 }

package/dist/behaviors/exports/atoms/std-sort.orb

@@ -574,5 +574,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Sort atom. Shows sort-by buttons for each sortable field. Clicking a field name sorts by that field. Clicking again toggles direction."
 }

package/dist/behaviors/exports/atoms/std-sprite.orb

@@ -152,5 +152,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Sprite renderer atom using the `sprite` pattern. Renders a single frame from a spritesheet with position and scale. Handles frame changes and click events."
 }

package/dist/behaviors/exports/atoms/std-tabs.orb

@@ -270,5 +270,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Tab navigation atom. Uses the `tabs` pattern component with clickable tab headers. Each tab shows different entity data."
 }

package/dist/behaviors/exports/atoms/std-timer.orb

@@ -1026,5 +1026,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Timer behavior parameterized for any domain. Provides a countdown timer with start, pause, resume, and reset controls. The state machine structure is fixed. The caller controls data and presentation."
 }

package/dist/behaviors/exports/atoms/std-undo.orb

@@ -690,5 +690,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Undo/Redo atom using array operators as a stack. - PUSH: appends to undoStack, clears redoStack - UNDO: pops from undoStack, pushes to redoStack - REDO: pops from redoStack, pushes to undoStack - CLEAR: empties both stacks Entity fields: undoStack (array), redoStack (array), current (string)"
 }

package/dist/behaviors/exports/atoms/std-wizard.orb

@@ -662,5 +662,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Multi-step wizard behavior parameterized for any domain. Generates a dynamic number of steps based on the `steps` parameter, with a review screen and completion view. Pure function: params in, OrbitalDefinition out."
 }

package/dist/behaviors/exports/molecules/std-builder-game.orb

@@ -179,5 +179,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Educational game molecule: menu -> playing -> complete. Uses the `builder-board` pattern for the playing state."
 }

package/dist/behaviors/exports/molecules/std-cart.orb

@@ -587,5 +587,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Shopping cart molecule. Composes atoms: - Cart-specific browse trait (empty/hasItems/checkout states) - stdModal for the add-item form (responds to ADD_ITEM)"
 }

package/dist/behaviors/exports/molecules/std-classifier-game.orb

@@ -179,5 +179,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Educational game molecule: menu -> playing -> complete. Uses the `classifier-board` pattern for the playing state."
 }

package/dist/behaviors/exports/molecules/std-debugger-game.orb

@@ -179,5 +179,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Educational game molecule: menu -> playing -> complete. Uses the `debugger-board` pattern for the playing state."
 }

package/dist/behaviors/exports/molecules/std-detail.orb

@@ -585,5 +585,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Browse + Create + View molecule. Composes atoms: - stdBrowse: data-grid with View item action and Create header action - stdModal: create form (responds to CREATE) - stdModal: view detail (responds to VIEW) No edit/delete from list. Used for feeds, ledgers, galleries."
 }

package/dist/behaviors/exports/molecules/std-event-handler-game.orb

@@ -179,5 +179,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Educational game molecule: menu -> playing -> complete. Uses the `event-handler-board` pattern for the playing state."
 }

package/dist/behaviors/exports/molecules/std-geospatial.orb

@@ -645,5 +645,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Location selection molecule. Composes atoms via shared event bus: - stdBrowse: location list with \"Select\" item action (fires SELECT) - stdModal: select/view location detail (responds to SELECT) - stdConfirmation: confirm location selection (responds to CONFIRM_SELECT) No emits/listens wiring. Traits on the same page share the event bus. Only the trait with a matching transition from its current state responds."
 }

package/dist/behaviors/exports/molecules/std-inventory.orb

@@ -849,5 +849,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Item collection molecule. Composes atoms via shared event bus: - stdBrowse: data-grid with item actions (fires ADD_ITEM, USE_ITEM, DROP) - stdModal (add): create form for adding items (responds to ADD_ITEM) - stdModal (use): item detail for using items (responds to USE_ITEM) - stdConfirmation: drop confirmation (responds to DROP) No emits/listens wiring. Traits on the same page share the event bus. Only the trait with a matching transition from its current state responds."
 }